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

完成环境搭建

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

检查状态

已完成

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

待完成 / 待确认

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

等待前一步

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

检查项目

检查项实际作用
Windows 与 WSL没有 WSL/Ubuntu 时提供安装入口；已有环境时直接复用。
Linux 环境选择要运行 Agent 的 Ubuntu/WSL 发行版。多套环境时优先选择已经装有目标 CLI 的那一套。
WSL 2代码 Agent 需要 WSL 2；如果是 WSL 1，页面会提供升级操作。
Linux 账号Ubuntu 第一次启动需要创建 Linux 用户名和密码。这不是 ChatGPT、Claude、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 会检测登录状态；Claude Code、Kimi 与 Qwen 在各自官方 CLI 中完成账号或 API Key 配置。

没有 WSL 或 Ubuntu

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

  1. 点击安装 WSL 和 Ubuntu

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

  2. 按提示重启

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

  3. 打开 Ubuntu 完成初始化

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

  4. 回到环境搭建重新检查

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

Linux 基础组件

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

  • tmux：让电脑终端关闭后 Agent 会话仍然运行，并让手机接入同一个会话。
  • bubblewrap：当前只在选择 Codex 时列为必需项；选择 Claude Code、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 文档 ↗

Claude Code

客户端优先使用 Anthropic 当前推荐的 WSL/Linux 原生安装器，将 claude 安装到当前 Ubuntu 用户的 ~/.local/bin；如果原生下载不可用且系统已有 npm，会自动改用 Anthropic 官方 npm 包兜底。

  1. 在环境搭建页选择 “Claude Code”。
  2. 安装完成后打开 claude 官方终端，按 Anthropic 提示登录。
  3. 回到客户端重新检查，然后可以新建或续接 Claude Code 会话。

Woodox 不读取 Claude 账号密码、API Key 或官方 CLI 登录凭据。

Anthropic 官方 Claude Code 安装文档 ↗

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/Claude Code/Kimi/Qwen”。
  4. 在系统文件夹选择器中选择项目，再确认在此文件夹启动。