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