在 Claude Code 里直接跑 Codex —— codex-plugin-cc 完整入门教程

一、这是什么

codex-plugin-cc 是 OpenAI 官方发布的 Claude Code 插件。装上之后，你不需要离开 Claude Code 终端，就能直接调用 OpenAI 的 Codex 来做：

代码审查（read-only，不改代码）
Bug 修复 / 任务委派（让 Codex 接手具体活儿）
对抗式 review（让 Codex 主动质疑你的设计选择）
后台长任务（一边让 Codex 跑，一边在 Claude Code 里继续干别的）

为什么这事有意思：Claude Code 用户基数已经不小，OpenAI 没去硬抢入口，而是直接发了一个插件——把 Codex 装进 Claude Code 里。对用户来说很方便：你可以在写作 / 架构阶段用 Claude Opus 的"细腻和审美"，到了具体写代码、查 Bug、做 review 时一行命令切到 Codex。

项目仓库：github.com/openai/codex-plugin-cc

二、前置准备

开始之前先确认这几样东西都齐了：

条件	说明	怎么检查
Claude Code 已安装并接好模型	这个插件运行在 Claude Code 里，所以 Claude Code 是前提；推荐通过 VibeAPI 接入 Claude，稳定且支持 Prompt Caching 省钱	终端运行 `claude --version`，能输出版本号即可
Node.js 推荐最新版本	Codex CLI 用 Node 跑，建议安装最新稳定版（至少 20.x 以上），更老的版本可能装不上或运行报错	`node -v`；低于 20.x 请先升级
API 服务（二选一）	推荐：VibeAPI 账号（OpenAI 兼容、国内直连、与 Claude Code 共用账单）；或者：OpenAI 官方账号 / API key	VibeAPI 注册即可拿 key；OpenAI 需要能正常访问 chatgpt.com

计费说明：Codex 调用产生的费用走你选的那一侧：用 VibeAPI 时按平台 GPT 系列倍率计费，与你 Claude Code 那边共用同一个账户；用 OpenAI 官方 ChatGPT 登录则消耗订阅额度；用 OpenAI API key 则按 OpenAI 官方 token 单价计费。三种方式之间相互独立，选一个用即可。

检查 Node 版本

# 在终端跑这条命令
node -v

# 期望输出：v20.x 或更高（推荐直接装最新 LTS），例如
v22.11.0

如果版本低于 20.x，推荐用 nvm（macOS / Linux）或 fnm（跨平台）切到最新 LTS 版。

关于 Claude Code 的模型接入：本教程的所有 / 命令都在 Claude Code 里执行，所以你的 Claude Code 必须先能正常工作。如果你还没接入 Claude 模型，推荐用 VibeAPI——直接给一个 Anthropic 兼容的 API endpoint，把它配置到 Claude Code 里即可，无需翻墙、稳定、支持缓存计费。

三、四步安装

整个安装就 4 条命令，全部在 Claude Code 会话里输入（不是普通终端）。先在终端执行 claude 启动 Claude Code，然后逐条运行下面的命令：

3.1 添加插件市场

/plugin marketplace add openai/codex-plugin-cc

这一步告诉 Claude Code："去 GitHub 上的 openai/codex-plugin-cc 这个仓库找插件清单。"

3.2 安装插件

/plugin install codex@openai-codex

从刚刚添加的市场里安装名为 codex 的插件（来自 openai-codex 这个 marketplace）。

3.3 重新加载插件

/reload-plugins

让 Claude Code 重新扫描已安装的插件，使新装的 codex:* 命令生效。

3.4 跑一次 setup

/codex:setup

这条命令会：检查本地是否已装 Codex CLI，没有的话自动通过 npm 帮你装上（执行 npm install -g @openai/codex），然后引导你完成登录。

如果 setup 自动安装失败（比如 npm 全局目录没权限），可以手动执行：

npm install -g @openai/codex

装好后再回到 Claude Code 里跑一次 /codex:setup 即可。

四、完成登录

setup 完成后，需要让 Codex 知道"用哪个服务、用谁的额度"。Codex CLI 支持两类来源：OpenAI 官方，或者任何 OpenAI 兼容的第三方端点。下面给两套方案，按需选一个即可。

方案 A：用 VibeAPI 接入（推荐）

VibeAPI 提供 OpenAI 兼容端点，全部 GPT / Codex 系列模型都已支持。好处：

不用单独开 OpenAI 账户、不用绑外卡，国内直连
与 Claude Code 主体共用同一个平台的账单（充值一次两边都能用）
价格按 OpenAI 官方倍率走，长对话场景享受平台缓存与故障转移

配置步骤：

1. 到 VibeAPI 控制台拿一个 API key。

2. 编辑 Codex 的配置文件 ~/.codex/config.toml（没有就新建），加入：

# ~/.codex/config.toml — 把 Codex 指向 VibeAPI
openai_base_url = "https://www.vibeapi.cn/v1"

# 可选：指定默认模型
model = "gpt-5.4-codex"
model_reasoning_effort = "high"

3. 通过环境变量提供 API key（最简单的方式）：

# macOS / Linux：写入 ~/.zshrc 或 ~/.bashrc
export OPENAI_API_KEY="sk-你的-vibeapi-key"

# Windows PowerShell：
$env:OPENAI_API_KEY = "sk-你的-vibeapi-key"

4. 回到 Claude Code，跑一个最简单的命令验证：

/codex:review

能看到 Codex 正常输出 review 结论就成功了。后续所有 /codex:* 命令都会自动走 VibeAPI。

为什么推荐这种方式：很多国内开发者卡在"Codex 登录"这一步——要么没 OpenAI 账号，要么用 ChatGPT 登录被风控，要么想精确控制成本却不想再开一个 OpenAI billing。走 VibeAPI 这条路一次解决全部问题，且与你 Claude Code 那边的账户体系打通。

方案 B：用 OpenAI 官方账号

如果你已经有 OpenAI 账号且能正常使用，也可以直接走官方登录。在 Claude Code 里输入：

!codex login

注意前面那个 ! 前缀——它告诉 Claude Code"这是 shell 命令，不是 Claude 指令"。执行后 Codex 会弹出两种选择：

登录方式	适合谁	计费
Sign in with ChatGPT	已有 ChatGPT 账号（含免费版）	消耗你的 ChatGPT 订阅额度
Use API key	有 OpenAI API key、想按 token 计费	按 token 走 OpenAI API 计费

选好后按提示完成认证，看到 Signed in as ... 字样即成功。

验证安装

无论选哪种方案，最终都在 Claude Code 里输入 /，能在自动补全里看到 /codex:review、/codex:rescue 等命令，说明插件已经就绪。

五、核心命令实操

插件提供的命令分为三类。下面每个都给具体用法和典型场景。

5.1 代码审查（Review）

这一类命令是 read-only 的——Codex 只看代码、给意见，不会动你的文件。

标准 review：

# 审查当前未提交的改动
/codex:review

# 审查当前分支相对于 main 的全部改动
/codex:review --base main

# 后台跑（适合改动量大、想等结果时去做别的）
/codex:review --base main --background

对抗式 review——Codex 会主动挑刺、质疑设计选择：

# 默认对抗式审查
/codex:adversarial-review

# 带 focus 提示，只关注某方面
/codex:adversarial-review --background look for race conditions

# 让它专挑安全问题
/codex:adversarial-review focus on input validation and injection risks

适用场景：提 PR 之前自己先过一遍。Claude Code 写完一段代码，紧接着 /codex:review，相当于让另一个顶级模型当 reviewer，能抓出不少 Claude 没注意到的边界问题。

5.2 委派任务（Rescue）

/codex:rescue 是真正"让 Codex 干活"的命令——你把任务描述给它，它会真的修改代码。

# 让 Codex 调查为什么测试挂了
/codex:rescue investigate why tests are failing

# 让 Codex 修一个 Bug，后台跑
/codex:rescue --background fix the off-by-one bug in src/parser.ts:142

# 接续上次的任务（resume 模式）
/codex:rescue --resume continue with the migration script

# 强制开新会话（--fresh），不继承之前上下文
/codex:rescue --fresh refactor the auth middleware

常见参数速查：

参数	作用
`--background`	后台执行，立刻返回任务 ID，你能继续做别的
`--wait`	同步等待结果（默认行为，明确写更清晰）
`--resume`	接续上一个 Codex 会话，保留之前的上下文
`--fresh`	强制开新会话，不带任何历史
`--model <name>`	指定 Codex 用的模型（如 `gpt-5.4-mini`、`spark`）
`--effort <level>`	思考深度：`low` / `medium` / `high`

5.3 任务管理（后台作业）

后台跑了任务之后，用这三条命令管理：

# 查看所有正在跑和最近完成的任务
/codex:status

# 查看指定任务的详细状态
/codex:status <task-id>

# 拿到任务的最终输出和 session ID
/codex:result <task-id>

# 取消还在跑的后台任务
/codex:cancel <task-id>

典型流程：

1. /codex:rescue --background <任务> → 拿到 task-id
2. 继续在 Claude Code 里做别的事
3. 隔一段时间 /codex:status 看进度
4. 完成后 /codex:result <task-id> 拿结果

六、进阶玩法

6.1 让 Claude 出方案，Codex 当评委

这是文章开头提到的"互相掐架"用法——很有用：

先在 Claude Code 里让 Claude（Opus）给出某个功能的实现方案
不立刻动手，先 /codex:adversarial-review 让 Codex 挑刺
把 Codex 的反对意见反馈给 Claude，让它改方案
反复几轮，直到两个模型都没新意见为止

对架构决策、API 设计、并发逻辑这类"想清楚比写出来更重要"的环节特别合适。

6.2 切换模型与思考强度

Codex 支持多种模型，可以按任务调：

# 用 mini 模型快速跑一遍 review，省 token
/codex:review --model gpt-5.4-mini

# 复杂 Bug，开 high effort 让模型多思考
/codex:rescue --model gpt-5.4 --effort high investigate this memory leak

# spark 是 codex 团队针对编码场景特调的模型
/codex:rescue --model spark refactor this service layer

6.3 项目级配置文件

不想每次都加 --model 参数，可以在项目根目录建一个 .codex/config.toml：

# 文件路径：<project-root>/.codex/config.toml
model = "gpt-5.4-mini"
model_reasoning_effort = "high"

这样这个项目里所有 /codex:* 命令都会用这套默认设置。也可以放到用户级（~/.codex/config.toml），全局生效。

优先级：命令行参数 > 项目级配置 > 用户级配置。项目级配置只在"受信项目"里生效（避免恶意仓库改你设置）。

6.4 Review Gate（自动审查门）

启用后，每当 Claude Code 给出代码改动响应，会自动让 Codex 做一次定向 review，如果发现严重问题会拦截响应。

# 启用
/codex:setup --enable-review-gate

# 关闭
/codex:setup --disable-review-gate

这功能对生产代码仓库挺有意义，但对快速实验项目会让节奏变慢，按需开启。

6.5 在 Codex 里继续会话

/codex:result 拿到的输出里会有一个 session ID。如果你想继续在 Codex 自己的 CLI 里接着跟它聊（比如换到 codex 原生的交互界面），可以：

codex resume <session-id>

七、常见问题

装好后输入 /codex:review 提示找不到命令？

八成是没跑 /reload-plugins。重新加载一次让插件命令注册到当前会话即可。如果还不行，退出 Claude Code 重新进一次。

!codex login 报错说找不到 codex 命令？

说明 Codex CLI 没装上，或者装了但没在 PATH 里。手动跑一次：

npm install -g @openai/codex

然后用 which codex（macOS / Linux）或 where codex（Windows）确认能找到。再回 Claude Code 里跑 /codex:setup 验证。

免费 ChatGPT 账号能用多久？

免费 ChatGPT 账号可以用，但 OpenAI 对免费用户有调用频率和总量限制——具体配额请以 OpenAI 官方说明为准。如果你高频使用建议升级到 Plus / Pro 或改用 API key 计费。

Codex 修改代码会不会乱改我的项目？

/codex:review 和 /codex:adversarial-review 是只读的，不会改文件。/codex:rescue 才会真正改代码——所以建议在干净的 git 状态下用，万一不满意 git restore . 回滚。重要分支上跑之前先 commit 一次更稳。

VibeAPI 能同时支持 Claude Code 主体和 Codex 插件吗？

可以。Claude Code 主体调用 Anthropic Messages API（接 VibeAPI 的 Anthropic 端点），/codex:* 走 OpenAI 兼容协议（接 VibeAPI 的 OpenAI 端点 https://www.vibeapi.cn/v1）。两侧的账单合并在同一个 VibeAPI 账户里，充值一次两边都能用，免去同时维护多家平台账户的麻烦。

不想用了怎么卸载？

在 Claude Code 里执行：

/plugin uninstall codex@openai-codex

如果还想清理掉 Codex CLI 本身：

npm uninstall -g @openai/codex

Windows 上能用吗？

能。本质上只要 Node.js + Claude Code 在 Windows 上能跑，这个插件就能用。建议在 Git Bash 或 WSL 里执行 shell 命令（如 !codex login），原生 cmd 偶尔会有 PATH 问题。

八、相关阅读

openai/codex-plugin-cc 官方仓库 — 最新命令、参数、变更日志以这里为准
openai/codex CLI 仓库 — Codex CLI 本体的文档
Claude 模型使用省钱小妙招 — Claude Code 侧的成本优化思路

一句话总结：把 Codex 装进 Claude Code，写作 / 架构阶段用 Claude 的细腻和审美，到具体写代码、查 Bug、做 review 时一行 /codex:* 切到 Codex——这套组合拳目前是开发场景下最舒服的 AI 编程方式之一。

Claude 和 Codex 两边都推荐通过 VibeAPI 接入：一个账户、一份额度、两端通用，国内直连无需翻墙，Claude 侧还能享受 Prompt Caching 显著降低长对话成本。