第一次使用：按这 8 步操作
- 先理解 Agent 实际运行在哪里
阅读系统原理，确认手机只是远程界面，Agent、项目和登录状态都在电脑的 Ubuntu/WSL2 中。
- 在 Windows 电脑上安装客户端
运行官网提供的 Windows 安装器。安装完成后，双击桌面上的 “Woodox”。
- 打开环境搭建
在左侧进入 “环境搭建”，选择 Codex、Claude Code、Kimi 或 Qwen。
- 只处理页面顶部的下一步
客户端会复用已有的 WSL、Ubuntu、Node.js、npm 和 CLI。看到 “下一步：…” 时按提示操作；自动安装失败可照WSL/Ubuntu 说明书手工复现。
- 启动电脑端后台服务
全部就绪后进入 “全局概览”，点击 “启动后台服务”。
- 打开一个 Agent 会话
选择 Agent，点击 “新建并打开”，再选择代码项目文件夹。
- 接入公网中转服务
进入 “公网访问”，使用管理员提供的账户接入，或按照说明书配置自己的中转服务。等待状态明确显示已连接。
- 安装、绑定并允许手机
电脑端进入 “手机连接”，先安装 APK，再扫描连接二维码。新手机会等待确认，请在 “设备管理”核对并点击 “允许”。
按问题查找章节
系统原理
说明 Windows、WSL2、Ubuntu、后台服务、Android App 和公网中转服务之间的数据流。
阅读系统原理 →安装 Windows 与 Android
确认系统要求，并按顺序安装 Windows 客户端和 Android App。
查看安装步骤 →安装 WSL 与 Ubuntu
包含自动安装、管理员 PowerShell 手动安装、首次初始化、验收和错误代码恢复。
打开 WSL/Ubuntu 说明书 →处理环境搭建
黄色表示还需要完成配置，不等于客户端发生故障。
查看每个检查项 →连接 Android App
按公网中转服务、连接凭据和设备审批三层检查，不要把等待审批误认为网络故障。
查看连接步骤 →使用 Agent 会话
了解新建会话、继续历史、完整滚动、终端和附件的用法。
查看日常操作 →使用前需要知道的事
项目文件、CLI 进程、登录状态和计算都留在 Windows/WSL 电脑。手机负责显示和输入。
Android App 必须连接一台已经启动 Woodox 后台服务的电脑。
两个版本号可以不同。Windows 安装器会携带构建时验证过的 APK，Android 也可以单独更新。
Woodox 是第三方客户端，支持官方 Codex、Claude Code、Kimi Code 和 Qwen Code CLI，不支持 Qoder。
手机和电脑都主动连接 WSS 中转，并在中转之上建立 Noise 端到端加密会话。
云端只需公开 80/443；woodox-relayd 与账户服务监听回环地址，8787 始终留在用户电脑本机。
完整链接可以访问和操作指定 Agent 会话。不要把二维码或完整链接交给无关人员。