Woodox电脑与手机协同客户端
首页使用文档
Woodox 使用文档

完成 Agent 设置

选择一个 Agent，然后只处理页面顶部显示的下一步。已安装的环境和 CLI 会被复用，不会因为切换页面而重复安装。

页面上的颜色是什么意思

已完成

检查通过，不需要操作。通过项默认收在“已通过 … 项环境检查”中。

待完成 / 待确认

这是正常配置步骤，例如登录 Kimi 或设置 Qwen 模型服务，不等于程序坏了。

等待前一步

先完成上面的依赖，再重新检查，后续按钮才会出现。

客户端依次检查什么

检查项实际作用
Windows 与 WSL没有 WSL/Ubuntu 时提供安装入口；已有环境时直接复用。
Linux 环境选择要运行 Agent 的 Ubuntu/WSL 发行版。多套环境时优先选择已经装有目标 CLI 的那一套。
WSL 2代码 Agent 需要 WSL 2；如果是 WSL 1，页面会提供升级操作。
Linux 账号Ubuntu 第一次启动需要创建 Linux 用户名和密码。这不是 ChatGPT、Kimi 或 Qwen 密码。
客户端文件确认 Ubuntu 可以访问 Windows 上的 Woodox 安装目录。
Linux 基础组件检查 curl、tmux；选择 Codex 时还会检查 bubblewrap。
Node.js 和 npm电脑端后台需要 Node.js 与 npm。当前最低要求为 Node.js 18；自动安装会安装并校验 Node.js 22。
Agent CLI检测到现有 CLI 时显示“跳过安装”，不会重装或升级。
登录/模型服务Codex 会检测登录状态；Kimi 与 Qwen 在各自官方 CLI 中完成账号或 API Key 配置。

没有 WSL 或 Ubuntu

下面是客户端内的简化流程。系统要求、自动安装实际执行的命令、微软标准手工流程、国内下载校验、首次初始化和错误代码恢复，见安装 WSL2 与 Ubuntu：从零到可验收。

  1. 点击安装 WSL 和 Ubuntu

    允许 Windows 管理员权限。下载速度取决于微软源或维护者配置的经过校验的镜像。

  2. 按提示重启

    如果 Windows 要求重启，保存其他工作后重启。再次打开 Woodox 会继续检查。

  3. 打开 Ubuntu 完成初始化

    按终端提示创建 Linux 用户名和密码。输入密码时终端不显示字符，这是 Linux 的正常行为。

  4. 回到 Agent 设置重新检查

    看到 Ubuntu 和 WSL 2 已通过后，再处理基础组件和 CLI。

Linux 基础组件

“自动安装基础组件”会在当前 Ubuntu 中安装 ca-certificates、curl、tmux、bubblewrap 和 xz-utils。

  • tmux：让电脑终端关闭后 Agent 会话仍然运行，并让手机接入同一个会话。
  • bubblewrap：当前只在选择 Codex 时列为必需项；选择 Kimi 或 Qwen 时缺少它不会阻止就绪。
  • curl / ca-certificates：用于安全下载和验证安装内容。

自动安装失败时，先保留错误文字，再前往 基础组件排查。

选择和登录 Agent

Codex

客户端使用官方 npm 包 @openai/codex。已安装时直接复用；未安装时需要当前 Ubuntu 中的 Node.js 和 npm 可用。

  1. 点击 “登录 ChatGPT”。
  2. 在 OpenAI 官方浏览器页面完成登录。
  3. 回到客户端点击 “重新检查”。

浏览器回调不可用时，可展开 “安装说明与登录兜底”，选择 “使用设备码登录”。登录由 Codex CLI 处理，Woodox 不读取密码。

OpenAI 官方 Codex CLI 文档 ↗

Kimi Code

客户端使用 Kimi Code 官方独立安装器。安装完成后点击 “登录 Kimi”，在官方终端中选择：

  • Kimi Code (OAuth)：使用 kimi.com 账号和对应会员权益。
  • Kimi Platform (API key · platform.kimi.com)：使用在该域名创建的 API Key。
  • Kimi Platform (API key · platform.kimi.ai)：使用在该域名创建的 API Key。

API Key 应选择它实际创建于哪个平台；两个入口不要混用。若 OAuth 提示无法验证 membership benefits，通常表示当前账号没有可用的 Kimi Code 会员权益，或权益暂时无法验证。可以开通相应权益，或改用自己的 Platform API Key。

Kimi Code 官方安装说明 ↗

Qwen Code

客户端使用 Qwen Code 官方独立安装器。点击 “打开 Qwen 配置”后：

  1. 在 Qwen 终端输入 /auth。
  2. 选择 Coding Plan 或 API Key。
  3. 完成后回到客户端继续使用。

Qwen Code 与 Qoder 是两个不同产品。当前客户端支持 Qwen Code，不宣称支持 Qoder。

Qwen Code 官方文档 ↗

全部完成后的操作

  1. 顶部显示“Agent 已可用”后，点击 “进入概览”。
  2. 如果后台尚未运行，点击 “启动后台服务”。
  3. 选择目标 Agent，点击 “新建并打开 Codex/Kimi/Qwen”。
  4. 在系统文件夹选择器中选择项目，再确认在此文件夹启动。