安装前准备
- 一台 64 位 Windows 10 或 Windows 11 电脑，并支持 WSL 2。
- 一个可以安装 WSL/Ubuntu 的 Windows 管理员账号；已有环境时通常不需要重复安装。
- 一台 Android 手机。第一次测试时，让手机和电脑连接同一个 Wi-Fi。
- Codex、Kimi Code 或 Qwen Code 账号/密钥至少一种。账号费用和资格由对应服务商管理。
- 预留一次 Windows 重启的时间。只有新装或更新 WSL 时才可能需要重启。
不确定 WSL2、Ubuntu 和 Linux 用户环境分别是什么时，先阅读系统原理。需要手工安装、验收或处理错误代码时，使用WSL 与 Ubuntu 完整说明书。
一、安装 Windows 客户端
- 从下载中心取得安装器
文件名类似
Woodox-Desktop-Setup-v版本号.exe。只使用官网或维护者明确发送的当前版本。 - 可选：核对 SHA256
在安装器所在文件夹打开 PowerShell，运行：
Get-FileHash .\Woodox-Desktop-Setup-v版本号.exe -Algorithm SHA256输出应与下载页公布的值完全相同。
- 双击安装器
按安装向导选择目录并完成安装。新安装默认位于当前 Windows 用户的
%LOCALAPPDATA%\Woodox；从旧版升级时会继续使用原目录并保留本机数据。 - 打开桌面快捷方式
安装完成后双击 “Woodox”。第一次打开会进入或提示进入 “Agent 设置”。
二、第一次打开电脑端
左侧菜单应包含：“概览”、“Agent 设置”、“手机连接”、“设备管理”、“公网访问”、“诊断”和“设置”。
- 进入 “Agent 设置”。
- 选择 Codex、Kimi 或 Qwen。
- 按页面顶部的 “下一步”完成环境检查和登录。
- 显示“Agent 已可用”后，进入 “概览”。
三、安装 Android App
可以直接从官网下载安装包，也可以在电脑端服务启动后进入 “手机连接”，扫描“第 1 步：手机下载 APK”的二维码。
- 下载 APK
当前官网下载文件名为
Woodox-Android-v0.9.09.apk。Android 与 Windows 的版本号不需要相同。 - 允许本次安装
Android 可能要求允许浏览器或文件管理器“安装未知应用”。只对用于下载官网 APK 的应用临时授权。
- 打开 Woodox
首页应看到 “扫码连接”、“粘贴连接链接”以及连接历史、更新和设置入口。
- 先不要随便填写地址
回到电脑端 “手机连接”，使用第二步生成的连接二维码或完整连接链接。
怎样算安装成功
这些都正常后，继续完成 Agent 设置。