用 Claude Code 写完功能后,想让另一个模型再看一遍,过去通常要退出会话、另开终端、启动 Codex,再重复解释项目背景和修改原因。OpenAI 的 codex-plugin-cc 解决的是这段上下文搬运:在 Claude Code 中输入 /codex:review,本机已经安装并登录的 Codex CLI 就会接过 diff 审查。
这个插件没有把 Codex 模型塞进 Claude Code,也不是一个新的 IDE。它只是把本机 Codex CLI 接到 Claude Code 的命令面板上。模型、推理力度、base URL 和额度仍然沿用 Codex 的配置。

安装前确认三个条件
需要满足:
- ChatGPT 订阅(免费档也可以),或 OpenAI API key;用量计入 Codex 额度,不计入 Claude 额度;
- Node.js 18.18 或更高版本;
- 本机已安装并登录 Codex CLI。
没有安装 CLI,可以运行:
npm install -g @openai/codex
未登录时,可在 Claude Code 中运行:
!codex login
插件提供的安装流程是:
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup
/codex:setup 会检查 Codex 是否安装和登录;本机有 npm 但缺少 CLI 时,它也可以协助安装。
验收时检查两个位置:斜杠命令中能否看到 /codex:,以及 /agents 中是否出现 codex:codex-rescue 子代理。
八个命令分别做什么
插件命令可以按用途分成三组:
审查
/codex:review:标准审查,只读,不修改代码;/codex:adversarial-review:接受额外的关注点,针对指定实现和设计取舍提出质疑。
派活和迁移
/codex:rescue:将任务交给codex:codex-rescue子代理,可查 bug、尝试修复、继续之前的任务,或切换模型重跑;/codex:transfer:把当前 Claude Code 会话转换成一条可长期保留的 Codex 线程,并打印codex resume <session-id>命令。
任务管理
/codex:status:查看当前仓库正在运行和刚完成的任务;/codex:result:读取指定任务的最终输出;/codex:cancel:取消仍在后台运行的任务。
第八个是 /codex:setup,除初次安装外,它还负责 review gate 开关。
第一次试跑可以使用:
/codex:review --background
/codex:status
/codex:result
多文件审查通常较慢,--background 会将它放到后台,继续工作时用 /codex:status 查看进度,再用 /codex:result 取结果;需要等待时使用 --wait。审查也可以用 --base <ref> 指定对比基线。

两种 review 不要混用
/codex:review 不接受额外关注点,会按固定标准完成常规检查,结果相对稳定,但不一定覆盖你正在担心的具体问题。
/codex:adversarial-review 允许在 flag 后附加自由文本,会围绕指定问题质疑实现路线。
因此,想做常规体检时用前者,想让它专门盯着鉴权或迁移脚本等问题时用后者。两者都只读;需要真正修改代码,应使用 /codex:rescue。

rescue 是派活,transfer 是搬家
/codex:rescue 支持这些选项:--background、--wait、--resume、--fresh、--model 和 --effort。
- 不指定
--model和--effort时,使用 Codex 默认值;原文提到可以在请求中说spark,映射到gpt-5.3-codex-spark; --resume接着该仓库最近的 Codex 任务继续,--fresh则从干净状态开始。
/codex:transfer 是另一条路径:它迁移的是当前会话本身。源会话记录需要位于 ~/.claude/projects 下;如果 Codex 版本过旧、不支持会话导入,应先升级。
review gate 要临时使用
/codex:setup 提供两个开关:
/codex:setup --enable-review-gate
/codex:setup --disable-review-gate
开启后,Claude Code 每次准备结束一轮时,都会触发 Stop hook,让 Codex 对这一轮回答做定向审查。如果发现问题,这一轮会暂停,直到问题被处理。
官方明确警告,这可能导致 Claude 和 Codex 之间形成长循环,快速消耗额度,因此只建议在人能持续观察会话时启用。
实际循环可能是:Claude 收尾,Codex 审出问题;Claude 修改后再次收尾,Codex 又发现新的问题。两边都会继续消耗额度,没人叫停就不会自动结束。
更稳妥的用法是临时开启,跑完一段确实不放心的改动后立即关闭。不要把 review gate 当作常驻配置。

插件沿用 Codex 的运行时和配置
插件依赖本机全局 codex 二进制和 Codex app server。认证状态、配置和仓库 checkout 都沿用原来的设置。
配置分为两层:
- 用户级:
~/.codex/config.toml; - 项目级:项目根目录的
.codex/config.toml,只有在项目被信任时才生效。
例如修改模型和推理力度:
model = "gpt-5.4-mini"
model_reasoning_effort = "high"
已有的 API key 和自定义 base URL 也会继续生效。要把 OpenAI provider 指向其他地址,可以修改 Codex 配置中的 openai_base_url。
好处是不必重新登录,也不会多出一个账号;代价是原有 Codex 配置中的问题也会原样跟进 Claude Code。
使用时最容易踩的坑
- 多文件审查和 rescue 任务默认考虑使用
--background,避免前台阻塞整个会话; /codex:transfer在旧版本 Codex 上可能失败,先升级再排查;- 想指定关注点时不要使用
/codex:review,它不会读取你的额外说明; - review gate 开启后必须有人看着运行过程。
结论
这个插件真正节省的是重复交代上下文的时间。审查、派活和迁移都能在同一个终端完成,但它没有替你完成判断:Codex 提出的意见哪些值得改,哪些只是另一种写法偏好,仍然需要人决定。
如果每天在 Claude Code 中写业务代码,可以先只试 /codex:review --background,用几个真实 diff 检查结果是否符合自己的关注点,再尝试其他命令,先不要启用 review gate。
如果要给团队定工作流,应先讲清用户级与项目级配置的生效条件,也要说明额度记在个人 Codex 账号上。两个工具都在用的人,可以单独试一次 /codex:transfer,观察长任务跨工具迁移是否适合自己的流程。