安装并打开电脑端
从官网下载并运行 Windows 安装器，然后双击桌面上的 Woodox。
手机端不能单独使用。请先把电脑端和代码 Agent 准备好。三步完成安装和设备绑定
先安装 Windows 客户端并完成环境搭建，再接入公网中转服务并绑定 Android App。项目和 Agent 仍在电脑运行。
完成环境搭建
选择 Codex、Claude Code、Kimi Code 或 Qwen Code，只处理页面顶部显示的下一步。已有 WSL、Ubuntu、Node.js、npm 和 CLI 会直接复用。
环境全部通过后，按对应 Agent 的官方流程登录或配置 API Key。接入中转并绑定手机
启动后台服务和 Agent 会话，确认公网中转服务已连接，再用 Android App 扫描电脑端生成的连接二维码。
第一次连接会等待电脑批准；请在设备管理中核对并允许这台手机。环境检测规则
已有组件直接复用
检测到可用 Ubuntu 后不会再安装 WSL。客户端会在当前 Ubuntu 中检查 Node.js、npm、tmux、所选 Agent CLI；选择 Codex 时还会检查 bubblewrap。
- 已有 CLI：显示安装位置并跳过安装
- Node.js 18+ 且 npm 可运行：环境检查通过
- 缺少组件：显示当前操作和重新检查入口
检测顺序
WSL / Ubuntu可用
Node.js / npm复用
Agent CLI需要安装
官方登录手动完成
Agent 账号
登录在对应官方 CLI 中完成
Agent登录方式注意事项
Codex官方浏览器登录客户端不读取密码
Claude Code在官方 CLI 中登录客户端不读取密码
Kimi CodeOAuth 或 Kimi Platform API KeyKimi Code OAuth 可能要求有效会员权益
Qwen Code在 TUI 输入 /auth选择 Coding Plan 或 API Key
账号资格、会员权益、模型用量与费用由对应服务商决定，不包含在 Woodox 中。
查看完整使用文档
文档包含安装、环境检查、公网中转服务接入、设备批准、会话操作和问题排查。
打开使用文档