/ 文档
进入控制台

UnifiedCode 使用指南

欢迎使用 UnifiedCode —— 企业级 AI 编码中转工作台。

什么是 UnifiedCode？

UnifiedCode 将 Claude Code、Codex 和 Gemini CLI 接入同一条稳定线路，提供统一的配置方式、计费视图与使用体验。

核心功能

🚀 统一中转

一个 API 地址，同时支持 Claude Code、Codex、Gemini CLI

💰 透明计费

每一次调用成本清晰可查

🖥️ 多平台支持

Windows / macOS / Linux 全覆盖

👥 团队协作

支持多用户、分组与订阅管理

快速开始

1. 注册账号

访问首页，点击「立即体验」完成注册。

2. 创建 API Key

登录后进入「API Keys」页面，创建一个新的 API Key。

3. 配置你的开发工具

将获取到的 API Key 和中转地址填入你的 IDE 或 CLI 工具中。详细教程请参考左侧导航中的各平台使用指南。

获取帮助

如有任何问题，请通过控制台中的联系方式联系客服。

常见问题

1. 分组卡片上的费率倍数 0.3X 是什么意思？

这是该分组的汇率，代表每消耗 1 美元官方额度，需要花费多少平台余额。

举例说明：

0.3x 表示：模型官方收费 $1 时，您只需消耗 0.3 平台余额（折合 ¥0.3）。按真实汇率约 7 计算，相当于约 0.43 折。倍数越低，使用成本越低。不同分组的费率倍数不同，请根据自身需求选择合适的分组。

2. 实际扣费怎么计算？

实际扣费公式为：

实际扣费 = 模型官方价格（美元） × 分组费率倍数

示例：某次调用模型官方计费 $0.50，所在分组费率为 0.3x，则：

实际扣费 = $0.50 × 0.3 = 0.15 平台余额

您可以在控制台的「使用记录」中查看每次调用的详细扣费明细。

3. 不同分组有什么区别？该怎么选？

不同分组的主要差异在于：

  • 费率倍数：费率倍数越低，使用成本越低
  • 支持的模型不同：部分分组可能仅支持特定模型
  • 稳定性和速度：不同分组可能有不同的并发限制和响应速度

一般建议：日常使用选推荐分组，对稳定性有高要求可选专用型分组。

4. 可以创建多个 Key 吗？

可以。您可以在「API Keys」页面创建多个 Key，用于区分不同项目或用途。每个 Key 独立管理，所有 Key 共享同一个账户余额。

5. 服务稳定性如何保障？

我们通过以下方式保障服务稳定性：

  • 持续监控：7×24 小时系统监控，及时发现并处理异常
  • 容量规划：根据使用量动态调整资源，避免过载
  • 故障恢复：完善的故障转移和自动恢复机制
  • 性能优化：核心能力面向高频开发场景持续优化

6. 如何进行购买？

目前仅支持卡券购买，操作步骤如下：

  • 打开购买页面：https://pay.ldxp.cn/shop/J9140VB6
  • 选择对应套餐，完成支付后获取兑换码（卡密）
  • 回到 UnifiedCode 网站，点击「兑换」
  • 输入卡密，余额即刻到账

如购买后遇到任何问题，支持联系客服协商退款，请放心购买。

7. 售后与客服

如在使用过程中遇到任何问题，欢迎扫码添加微信联系我们，我们会尽快为您处理：

Node.js 环境安装指南

Claude Code、Gemini CLI、Codex 等工具均依赖 Node.js 运行环境，请先完成此步骤。

Windows

方法一：官方下载（推荐）

前往 Node.js 官网 下载 LTS 版本，双击安装包按提示完成安装。

下载以后，一直下一步直到安装完成

方法二：使用 Chocolatey

choco install nodejs-lts

方法三：使用 Scoop

scoop install nodejs-lts

macOS

方法一：使用 Homebrew（推荐）

brew install node

方法二：官方下载

前往 Node.js 官网 下载 macOS 安装包。

Linux

Ubuntu / Debian

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS / RHEL

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

验证安装

node --version
npm --version

两个命令均输出版本号即表示安装成功。

切换 npm 镜像源（无科学上网环境）

如果安装依赖时速度较慢或超时，执行以下命令切换到国内镜像源：

npm config set registry https://registry.npmmirror.com

验证是否切换成功：

npm config get registry

输出 https://registry.npmmirror.com 即表示生效。

UnifiedCode 自动配置工具

这篇文档解决一件事：用一条命令把 Claude Code 或 Codex 安装并接到 UnifiedCode，即使你的机器还没有 Node.js，也可以继续走下去。

1. 推荐用法

macOS / Linux

直接执行：

curl -fsSL https://realclaw.cloud/auto-config/install.sh | bash

脚本会自动完成以下动作：

  • 检测当前系统是否已有可用的 Node.js
  • 如果没有，则在当前用户目录下安装本地 Node.js 运行时
  • 将 npm 镜像切到国内源，降低无代理环境下载失败率
  • 安装 Claude Code 和 Codex
  • 写入对应配置文件
  • 最后执行版本检查，确认命令可以运行

Windows PowerShell

irm https://realclaw.cloud/auto-config/install.ps1 | iex

2. 常用参数

如果你想完全非交互执行，可以直接把参数写进命令里。

只配置 Claude Code

macOS / Linux：

curl -fsSL https://realclaw.cloud/auto-config/install.sh | bash -s -- --api-key YOUR_API_KEY --tools claude

Windows PowerShell：

irm https://realclaw.cloud/auto-config/install.ps1 | iex --% --api-key YOUR_API_KEY --tools claude

只配置 Codex

macOS / Linux：

curl -fsSL https://realclaw.cloud/auto-config/install.sh | bash -s -- --api-key YOUR_API_KEY --tools codex

Windows PowerShell：

irm https://realclaw.cloud/auto-config/install.ps1 | iex --% --api-key YOUR_API_KEY --tools codex

自定义 API 地址

如果你部署了自定义域名，可以覆盖默认地址：

curl -fsSL https://realclaw.cloud/auto-config/install.sh | bash -s -- --api-key YOUR_API_KEY --base-url https://your-domain.example.com

3. 脚本会写哪些文件

Claude Code

脚本会写入：

~/.claude/settings.json

核心字段如下：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://realclaw.cloud",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Codex

脚本会写入：

~/.codex/auth.json

~/.codex/config.toml

auth.json：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

config.toml：

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://realclaw.cloud"
wire_api = "responses"
requires_openai_auth = true

4. 不需要管理员权限吗

默认不需要。

脚本优先使用系统已有的 Node.js；如果没有，就把 Node.js 安装到当前用户目录：

  • macOS / Linux：~/.dragoncode/node
  • Windows：%USERPROFILE%\.dragoncode\node

客户端包也会安装到当前用户目录，而不是系统全局目录。

5. 首次执行后要做什么

macOS / Linux

脚本结束后建议执行：

source ~/.zshrc

如果你不是 zsh，则按脚本最后输出的实际 profile 文件执行 source 。

Windows

重新打开一个 PowerShell 窗口即可。

6. 如何确认已经成功

Claude Code

claude --version

Codex

codex --version

只要命令能输出版本号，通常就说明安装链路已经打通。

7. 备份与回滚

如果你的机器上已经有旧配置，脚本会在首次覆盖前自动生成 .bak 备份，例如：

  • ~/.claude/settings.json.bak
  • ~/.codex/auth.json.bak
  • ~/.codex/config.toml.bak

如果需要回滚，直接把对应 .bak 文件恢复回来即可。

8. 常见问题

没有代理，脚本还能跑吗

脚本默认优先使用国内镜像：

  • Node.js 优先从 npmmirror 拉取
  • npm registry 默认切到 https://registry.npmmirror.com

如果镜像失败，脚本还会再尝试官方源。

我只想写配置，不想安装客户端

可以加上：

--skip-client-install

适合你已经装好 claude 或 codex，只想重新写配置文件的情况。

API 地址不是 https://realclaw.cloud

使用 --base-url 覆盖即可。

原来的配置被覆盖了怎么办

优先检查同目录下的 .bak 备份文件，脚本第一版已经为配置覆盖预留了回滚路径。

9. 下一步

想看手动安装与逐步解释：继续查看 Claude Code快速开始指南 和 Codex快速开始指南

还没准备好本地环境：查看 Node.js环境安装指南

遇到其他常见问题：查看 常见问题

UnifiedCode 快速开始指南

前置条件：安装 Node.js 环境

Claude Code 依赖 Node.js 运行环境，请先参考 Node.js 环境安装指南 完成安装并验证。

更省事的方式：自动配置

如果你不想手动安装和逐项写配置，推荐直接使用 自动配置工具。

macOS / Linux：

curl -fsSL https://realclaw.cloud/auto-config/install.sh | bash -s -- --tools claude

Windows PowerShell：

irm https://realclaw.cloud/auto-config/install.ps1 | iex --% --tools claude

1. 配置 Claude Code

第一步：安装 Claude Code

npm install -g @anthropic-ai/claude-code

macOS / Linux 遇到权限问题时加 sudo：

sudo npm install -g @anthropic-ai/claude-code

验证安装：

claude --version

第二步：创建 API Key

登录 UnifiedCode 控制台，进入 API 密钥 页面，点击 创建密钥。

填写密钥名称，选择分组（模型和倍率），按需配置 IP 限制、额度限制、速率限制和有效期。新手建议直接使用默认配置。

安全提示：API Key 等同于账号凭证，请妥善保管，切勿提交到代码仓库或公开分享。

第三步：导入密钥到 Claude Code

推荐使用 CC Switch 工具进行一键配置，也可手动设置环境变量。

方式一：CC Switch（推荐）

前往 CC Switch Release 下载安装后，点击 导入到 CCS 完成一键导入：

导入后点击 启用 即可。

方式二：手动配置环境变量

点击密钥旁的 复制 按钮获取 API Key。

需要设置以下两个环境变量：

变量名值
ANTHROPIC_BASE_URLhttps://realclaw.cloud
ANTHROPIC_AUTH_TOKEN您的 API Key

临时设置（当前终端会话有效）

Windows (PowerShell)：

$env:ANTHROPIC_BASE_URL = "https://realclaw.cloud"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"

macOS / Linux：

export ANTHROPIC_BASE_URL="https://realclaw.cloud"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

永久设置（重启后依然有效）

Windows (PowerShell)：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://realclaw.cloud", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [System.EnvironmentVariableTarget]::User)

macOS (Zsh)：

echo 'export ANTHROPIC_BASE_URL="https://realclaw.cloud"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Linux (Bash)：

echo 'export ANTHROPIC_BASE_URL="https://realclaw.cloud"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc

第四步：开始使用

进入任意项目目录，运行：

claude

Claude Code 会自动分析当前目录的代码并提供智能编程辅助。

常见问题（FAQ）

Q：运行 npm install -g 提示权限不足？

A：macOS / Linux 在命令前加 sudo；Windows 使用管理员权限运行 PowerShell。

Q：claude --version 提示命令不存在？

A：确认 npm 全局目录已加入系统 PATH，可运行 npm bin -g 查看路径并手动添加。

Q：连接失败或返回 401 错误？

A：检查 ANTHROPIC_BASE_URL 是否为 https://realclaw.cloud，以及 ANTHROPIC_AUTH_TOKEN 是否填写正确且未过期。

Q：如何切换不同模型或倍率？

A：在 UnifiedCode 控制台 创建不同分组的密钥，通过 CC Switch 在多个配置间快速切换。

UnifiedCode × Codex 快速开始指南

前置条件：安装 Node.js 环境

Codex 依赖 Node.js 运行环境，请先参考 Node.js 环境安装指南 完成安装并验证。

更省事的方式：自动配置

如果你不想手动安装和逐项写配置，推荐直接使用 自动配置工具。

macOS / Linux：

curl -fsSL https://realclaw.cloud/auto-config/install.sh | bash -s -- --tools codex

Windows PowerShell：

irm https://realclaw.cloud/auto-config/install.ps1 | iex --% --tools codex

1. 安装 Codex

# Windows
npm install -g @openai/codex@latest

# macOS / Linux
sudo npm install -g @openai/codex@latest

验证安装：

codex --version

输出版本号即表示安装成功。

2. 创建 API Key

登录 UnifiedCode 控制台，进入 API 密钥 页面，点击 创建密钥。

填写密钥名称，选择Codex分组（模型和倍率），按需配置 IP 限制、额度限制、速率限制和有效期。新手建议直接使用默认配置。

安全提示：API Key 等同于账号凭证，请妥善保管，切勿提交到代码仓库或公开分享。

3. 导入密钥到 Codex

推荐使用 CC Switch 工具进行一键配置，也可手动创建配置文件。

方式一：CC Switch（推荐）

前往 CC Switch Release 下载安装后，点击 导入到 CCS 完成一键导入：

导入后点击 启用 即可。

方式二：手动配置文件

创建配置目录
# Windows (PowerShell)
if (Test-Path "$env:USERPROFILE\.codex") { Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" }
mkdir "$env:USERPROFILE\.codex"

# macOS / Linux
rm -rf ~/.codex && mkdir -p ~/.codex
创建 config.toml

在 ~/.codex/（Windows 为 %USERPROFILE%\.codex\）目录下创建 config.toml：

model_provider = "dragoncode"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.dragoncode]
name = "dragoncode"
base_url = "https://realclaw.cloud"
wire_api = "responses"
requires_openai_auth = true
创建 auth.json

点击密钥旁的 复制 按钮获取 API Key：

在同一目录下创建 auth.json，将 YOUR_API_KEY 替换为你在控制台创建的密钥：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

4. 开始使用

进入任意项目目录，运行：

codex

Codex 会自动分析当前目录的代码并提供智能编程辅助。更多用法请参考 OpenAI 官方文档。

常见问题（FAQ）

Q：运行 npm install -g 提示权限不足？

A：macOS / Linux 在命令前加 sudo；Windows 使用管理员权限运行 PowerShell。

Q：codex --version 提示命令不存在？

A：确认 npm 全局目录已加入系统 PATH，可运行 npm bin -g 查看路径并手动添加。

Q：连接失败或返回 401 错误？

A：检查 config.toml 中 base_url 是否为 https://realclaw.cloud，以及 auth.json 中的 API Key 是否正确且未过期。

Q：如何切换不同模型或倍率？

A：在 UnifiedCode 控制台 创建不同分组的密钥，更新 auth.json 中的 Key，或通过 CC Switch 在多个配置间快速切换。

UnifiedCode × OpenClaw 快速开始指南

适用场景

这篇文档只解决一件事：把 OpenClaw 的模型服务接到 UnifiedCode，并完成一次可用性验证。

如果你还没安装 Node.js，请先参考 Node.js 环境安装指南。

1. 准备事项

开始前请先确认以下几点：

  • 你已经在 UnifiedCode 控制台 创建好一枚 API Key
  • 你知道要调用的实际模型名，例如 gpt-5.4
  • 你的运行环境满足 OpenClaw 官方要求：推荐 Node 24，兼容 Node 22.16+
  • Windows 用户建议优先使用 WSL2 + Ubuntu 安装和运行 OpenClaw

2. 推荐路径：使用 OpenClaw 向导接入

如果你只是想先打通 OpenClaw 和 UnifiedCode，最省事的方式是先跑 OpenClaw 自带向导，等浏览器控制台能正常回复后，再继续配置频道或后台常驻。

第一步：安装 OpenClaw

macOS / Linux / WSL2 可以直接执行官方安装脚本：

# 安装 openclaw 命令行工具，--no-onboard 表示安装后先不自动进入向导
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

安装完成后，可先验证命令是否可用：

openclaw --help

第二步：启动接入向导

openclaw onboard

第三步：在向导中选择自定义

第三步：在向导中选择自定义服务商

当向导进入模型和鉴权步骤时，选择 Custom provider，然后按下面的值填写：

字段填写值
兼容类型Anthropic-compatible 或者 OpenAI-compatible
基础地址https://realclaw.cloud
模型名claude-sonnet-4-6 或者 gpt-5.4
Provider IDdragoncode
API Key你创建的 UnifiedCode API Key

第四步：完成向导并验证

首次接入时，网关端口、绑定方式和后台常驻服务都可以先保留默认值。完成向导后，依次运行：

# 检查配置格式是否正确
openclaw doctor

# 查看当前状态和加载到的模型
openclaw status

# 打开本地控制台，发一条消息验证是否能正常回复
openclaw dashboard

如果控制台里发消息能收到模型回复，说明接入已经成功。

3. 脚本化接入

如果你要把 OpenClaw 初始化写进脚本、服务器部署流程或企业镜像，推荐使用非交互模式。

第一步：导出 API Key

# 先把 UnifiedCode API Key 写入环境变量
export CUSTOM_API_KEY="YOUR_UNIFIEDCODE_API_KEY"

第二步：执行非交互接入命令

# 非交互式接入：将 UnifiedCode 配置为自定义服务商
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://realclaw.cloud" \
  --custom-model-id "gpt-5.4" \
  --custom-provider-id "dragoncode" \
  --custom-compatibility openai \
  --secret-input-mode ref \
  --gateway-port 18789 \
  --gateway-bind loopback

第三步：确认环境变量名称

如果你使用了 --secret-input-mode ref，OpenClaw 当前版本通常会把 API Key 以环境变量引用方式保存。推荐直接使用上面的 CUSTOM_API_KEY，这样和官方自动化文档保持一致。

4. 手动检查或手动写入配置

如果你不想跑向导，也可以直接检查或编辑 ~/.openclaw/openclaw.json。

5. 成功标准

满足下面几项，基本就说明接入已经打通：

  • 基础地址填写的是 https://realclaw.cloud
  • API Key 仍然有效，未过期、未停用、未耗尽额度
  • 默认模型写成了 dragoncode/你的模型名
  • openclaw doctor 和 openclaw status 没有报配置错误
  • 浏览器控制台能正常发消息并收到回复

6. 常见问题

明明填了地址，还是连不上

优先检查基础地址是不是 https://realclaw.cloud。不要带 / 。

OpenClaw 能启动，但发消息时报模型不存在

通常先查这两项：你填写的模型名是否就是 UnifiedCode 当前实际开放的调用名；默认模型是否写成了 dragoncode/模型名，而不是只写模型名。

使用脚本化命令时提示 API Key 缺失

可以直接打开 ~/.openclaw/openclaw.json，确认 apiKey 字段引用的是哪个环境变量，然后在当前 shell 中补上对应变量。

我已经配好 OpenClaw，为什么还不能在 WhatsApp 或 Telegram 里用

这通常不是模型接入问题，而是频道还没有配置完成。本页只负责把 OpenClaw 和 UnifiedCode 之间的模型调用打通；频道配置请继续参考 OpenClaw 官方 Channels 文档。

7. 下一步

还没创建 Key：回到 UnifiedCode 控制台 先创建 API Key

想先配置其他开发工具：继续查看 Claude Code快速开始指南 和 Codex快速开始指南

需要安装运行环境：查看 Node.js 环境安装指南

遇到常见接入问题：查看 常见问题

UnifiedCode × Claude Code VS Code 图形化操作教程

前置条件

已完成 Node.js 环境安装

已安装 Claude Code（npm install -g @anthropic-ai/claude-code）

1. 安装 VS Code

前往 VS Code 官网 下载对应平台的安装包。

Mac 用户注意选择正确的芯片架构：

  • ARM64：M1 / M2 / M3 / M4 芯片
  • x64：Intel 芯片

2. 安装 Claude Code for VS Code 插件

打开 VS Code，点击左侧 扩展市场（Extensions），搜索 Claude Code for VS Code，认准发布者为 Anthropic，点击 安装。

安装完成后，打开任意项目，点击右上角的 Claude Code 图标 打开插件面板。

3. 创建 API Key

登录 UnifiedCode 控制台，进入 API 密钥 页面，点击 创建密钥。

填写密钥名称，选择分组（模型和倍率），按需配置 IP 限制、额度限制、速率限制和有效期。新手建议直接使用默认配置。

安全提示：API Key 等同于账号凭证，请妥善保管，切勿提交到代码仓库或公开分享。

4. 导入密钥

推荐使用 CC Switch 工具进行一键配置，也可手动设置环境变量。

方式一：CC Switch（推荐）

前往 CC Switch Release 下载安装后，点击 导入到 CCS 完成一键导入：

导入后点击 启用 即可。

方式二：手动配置环境变量

点击密钥旁的 复制 按钮获取 API Key。

需要设置以下两个环境变量：

变量名值
ANTHROPIC_BASE_URLhttps://realclaw.cloud
ANTHROPIC_AUTH_TOKEN您的 API Key

临时设置（当前终端会话有效）

Windows (PowerShell)：

$env:ANTHROPIC_BASE_URL = "https://realclaw.cloud"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"

macOS / Linux：

export ANTHROPIC_BASE_URL="https://realclaw.cloud"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

永久设置（重启后依然有效）

Windows (PowerShell)：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://realclaw.cloud", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [System.EnvironmentVariableTarget]::User)

macOS (Zsh)：

echo 'export ANTHROPIC_BASE_URL="https://realclaw.cloud"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Linux (Bash)：

echo 'export ANTHROPIC_BASE_URL="https://realclaw.cloud"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc

5. 跳过官方登录

首次打开插件可能出现 Anthropic 官方登录页面，显示三种登录方式。

不要选择任何一种——等待 3-5 秒页面会自动消失。如果已按上一步配置好环境变量，插件会自动使用 UnifiedCode 的 API Key，无需登录。

如果登录页面没有自动消失，左下角点击设置，然后搜索Claude code，勾选 Disable Login Prompt 手动关闭。

6. 开始使用

在输入框中用自然语言描述需求，通过对话形式与 Claude Code 交互，插件会自动读取和修改当前项目的代码。

7. 使用技巧

三种操作模式

左下角可切换操作模式：

1. Ask before edits（编辑前询问）

最保守的模式。Claude 每一次修改都会先展示变更内容，征求你的确认后才会写入文件。适合刚上手不熟悉工具时使用，或在修改关键代码时需要逐步把关的场景。

2. Edit automatically（自动编辑）

最高自动化的模式。Claude 会直接修改代码文件，不再逐步确认。适合需求已经明确、希望快速落地修改的场景。需要注意改动可能超出预期，建议事后检查 Git diff 确认变更范围。

3. Plan mode（规划模式）

不直接改代码，而是先扫描项目结构，给出完整的修改方案和执行步骤，等你确认后再执行。适合复杂任务，比如代码重构、多文件联动改动、架构调整等。先看方案再动手，避免大规模改动失控。

多窗口并行开发

点击右上角 + 号可开启多个 Claude Code 窗口，例如一个负责开发、一个负责测试。

引用项目文件

在输入框中输入 @ 后选择文件名，可将文件内容作为上下文传递给 Claude Code。

上传文件

输入 /attach file，从文件选择器中上传文件。

注意：右下角的附件图标是引用文件（添加上下文），不是上传文件，注意区分。

切换模型

输入 /model，选择 Switch Model，按需切换模型。

常见问题（FAQ）

Q：插件安装后找不到 Claude Code 图标？

A：确认插件已安装成功，尝试重启 VS Code。图标位于编辑器右上角工具栏。

Q：登录页面一直不消失？

A：在对话框输入 /config，勾选 Disable Login Prompt 关闭登录提示。

Q：插件提示连接失败或 401 错误？

A：检查 ANTHROPIC_BASE_URL 是否为 https://realclaw.cloud，以及 ANTHROPIC_AUTH_TOKEN 是否填写正确且未过期。

Q：如何切换不同模型或倍率？

A：在 UnifiedCode 控制台 创建不同分组的密钥，通过 CC Switch 在多个配置间快速切换。

Q：VS Code 应该选哪个版本？

A：Mac 用户根据芯片选择：M 系列芯片选 ARM64，Intel 芯片选 x64。Windows 用户直接下载默认版本即可。

Claude Code 与 Codex 协同开发指南

为什么要这样搭配？

一句话：让贵的模型动脑，让便宜的模型动手，账单不爆炸。

Claude 擅长理解需求、架构规划、复杂推理，但价格也摆在那——用它来写大量代码，Token 烧得飞快。Codex 的代码能力强、速度快，关键是价格便宜很多。

所以最合理的搭配是：

  • Claude 负责规划：理解你的需求，拆解任务，做架构决策，想清楚怎么做
  • Codex 负责执行：通过 /codex:rescue 接手具体的编码任务，写代码、修 bug、跑测试
  • Codex 负责审查：通过 /codex:review 给 Claude 的代码做 code review，充当第二双眼睛

这个搭配的核心逻辑是：Claude 的 Token 只花在「想清楚」上，具体的编码和审查交给更便宜的 Codex。对于每天高强度使用 Claude Code 的人来说，能显著降低整体开销。

本指南假设你已完成 Claude Code 和 Codex 的安装配置。如未完成，请先参考：

Claude Code 配置：UnifiedCode 快速开始指南

Codex 配置：UnifiedCode × Codex 快速开始指南

1. 安装 Codex 插件

两边都配好之后，在 Claude Code 里装一个插件就能串起来：

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

/codex:setup 会自动检测 Codex 是否安装、是否已认证。如果提示未登录，运行 !codex login 完成认证。

安装完成后，输入 /codex 即可看到新增的斜杠命令。

2. 核心命令

这个插件一共就三类能力：审查、委派任务、任务管理。

审查类（只读，不改代码）

命令作用
/codex:review让 Codex 审查当前未提交的改动，或对比分支
/codex:adversarial-review对抗性审查——不只是检查代码，而是主动质疑你的设计决策
# 审查未提交的改动
/codex:review

# 审查当前分支和 main 的差异
/codex:review --base main

# 后台运行，不阻塞当前对话
/codex:review --background

# 对抗性审查，指定关注方向
/codex:adversarial-review --background 检查是否有竞态条件，质疑缓存策略的选择

委派类（把任务交给 Codex 执行）

命令作用
/codex:rescue把一个具体任务交给 Codex 去做，Codex 会实际修改代码

这是实现「Claude 规划，Codex 执行」的核心命令。你可以把 Claude 规划好的任务，逐个交给 Codex 去实现：

# 让 Codex 去查 bug
/codex:rescue investigate why the tests started failing

# 让 Codex 去修 bug
/codex:rescue fix the failing test with the smallest safe patch

# 让 Codex 去实现一个功能
/codex:rescue 实现用户注册的表单验证逻辑

# 后台执行，适合耗时任务
/codex:rescue --background 重构数据库连接池

# 指定更便宜的模型，进一步省钱
/codex:rescue --model gpt-5.4-mini 写一组单元测试覆盖 utils.ts
/codex:rescue --model spark 快速修复这个 lint 错误

# 继续上次的任务
/codex:rescue --resume 把上次的修复方案应用上去

省钱技巧：--model gpt-5.4-mini 或 --model spark 可以用更便宜更快的模型执行简单任务。

任务管理类

命令作用
/codex:status查看正在运行和最近完成的 Codex 任务
/codex:result获取已完成任务的结果（含 session ID，可在 Codex 中继续）
/codex:cancel取消正在运行的后台任务

3. 推荐工作流：Claude 规划，Codex 执行

日常开发流程

你提需求 → Claude 分析拆解 → /codex:rescue 逐个执行 → /codex:review 审查 → 提交

用自然语言描述需求，让 Claude 理解你要什么

Claude 做规划：拆解任务、确定实现方案，理清先后顺序——这是 Claude 最擅长的

用 /codex:rescue 把具体编码任务交给 Codex：Claude 规划好了"要做 A、B、C 三件事"，你就用 rescue 一个个交给 Codex 去写

代码写完跑审查：/codex:review --background，让 Codex 做独立 code review

根据审查意见修复后提交

这个流程的好处是：Claude 的 Token 只花在规划和理解上，大量的编码工作走 Codex 的便宜额度。

高风险改动流程

涉及数据库迁移、认证授权、基础设施变更时，多加一层对抗性审查：

Claude 规划 → /codex:rescue 执行 → /codex:review → 修复 → /codex:adversarial-review → 再修复 → 提交

对抗性审查会主动质疑你的设计——比如"为什么选这个缓存策略""回滚方案考虑了吗""这里有没有竞态条件"。高风险改动需要这种压力测试。

Claude 卡住时

如果 Claude 在某个任务上反复尝试都不理想，直接换 Codex 来试：

/codex:rescue 用最小改动修复这个问题

换一个模型的思路，经常能突破僵局。

4. 后台运行（推荐）

审查和 rescue 任务都建议加 --background，不阻塞当前对话：

/codex:rescue --background 实现分页功能
# 继续和 Claude 聊别的事...
/codex:status          # 随时看进度
/codex:result          # 完成后取结果

/codex:result 会返回一个 session ID，你可以用 codex resume <session-id> 在 Codex 里继续这个任务。

5. 审查门禁（可选）

开启后，Claude Code 在完成任务前会自动触发一次 Codex 审查，发现问题则打断流程先修复：

/codex:setup --enable-review-gate    # 开启
/codex:setup --disable-review-gate   # 关闭

注意：审查门禁会显著增加 Token 消耗，可能造成 Claude 和 Codex 之间的长循环。建议仅在关键项目中使用，日常开发手动跑 /codex:review 即可。

6. Codex 模型配置

想改变 Codex 默认使用的模型或推理强度，可以在配置文件中设置。

用户级配置：~/.codex/config.toml

项目级配置：项目根目录下 .codex/config.toml

model = "gpt-5.4-mini"
model_reasoning_effort = "high"

也可以在每次调用时通过 --model 和 --effort 临时指定：

/codex:rescue --model spark --effort medium 快速修复 lint 错误

7. 什么时候不该用 Codex

场景原因
深度业务逻辑重构Codex 拿不到 Claude 对话中积累的完整上下文，生成的代码可能和项目风格不一致
需要跨文件深度理解的任务Codex rescue 是独立运行的，不共享 Claude 的对话历史
代码量很少的任务只有几行代码，没必要委派，直接让 Claude 写更快

8. 实用技巧

简单任务用便宜模型：--model spark 适合修 lint，写样板代码这种不需要深度推理的活

先 review 再 adversarial-review：不要上来就用对抗性审查，先用普通审查过一遍基础问题

善用 --resume：/codex:rescue --resume 可以继续上一次的 Codex 任务，不用从头开始

关注两边用量：虽然整体更省，但记得同时关注 Claude 和 OpenAI 两边的用量，避免某一边意外超支

Skill 冲突处理：如果你的自定义 Skill 和 Codex 插件有触发词冲突，在冲突 Skill 里加 priority: low

常见问题

Q：安装插件后没看到 /codex 命令？

A：执行 /reload-plugins 重新加载插件。

Q：/codex:review 报认证错误？

A：说明 Codex 的认证没配好。请参考 UnifiedCode × Codex 快速开始指南重新配置，或运行 !codex login 重新登录。

Q：/codex:rescue 和直接让 Claude 写代码有什么区别？

A：rescue 是把任务交给 Codex 独立执行，消耗的是 OpenAI 额度而不是 Claude Token。适合标准化编码任务。但 Codex 拿不到你和 Claude 的对话上下文，所以任务描述要写清楚。

Q：审查结果和 Claude 的判断矛盾怎么办？

A：这恰恰是双模型协作的价值。两边意见不一致时，你作为开发者来做最终决策。

Q：到底能省多少？

A：取决于你把多少编码工作交给 Codex。如果你的工作流中代码生成占比高（比如大量写测试，写 CRUD），把这些都 rescue 出去，Claude 的消耗可以大幅降低。