安装并打开电脑端
从官网下载并运行 Windows 安装器，然后双击桌面上的 Woodox。
默认安装到当前 Windows 用户目录，不要求手动运行 PowerShell。从电脑端开始，三步连到手机
先装电脑端，再完成 Agent 设置，最后启动会话并连接手机。遇到不确定的按钮或错误信息，直接进入对应说明书章节。
完成 Agent 设置
选择 Codex、Kimi 或 Qwen，只处理页面顶部显示的下一步。已有 WSL、Ubuntu、Node.js、npm 和 CLI 会直接复用。
环境全部通过后，按对应 Agent 的官方流程登录或配置 API Key。启动会话并连接手机
概览页启动后台服务和 Agent 会话，再到手机连接页安装 APK、扫描配对二维码。
同一 Wi-Fi 可直接连接；第一次公网连接还要在设备管理中允许手机。环境检测规则
已有组件直接复用
检测到可用 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官方浏览器登录客户端不读取密码
Kimi CodeOAuth 或 Kimi Platform API KeyKimi Code OAuth 可能要求有效会员权益
Qwen Code在 TUI 输入 /auth选择 Coding Plan 或 API Key
账号资格、会员权益、模型用量与费用由对应服务商决定，不包含在 Woodox 中。
每一步都有说明
完整说明书逐项写明安装、环境检查、手机配对、公网设备确认、日常操作和常见错误。
打开使用文档