← 全部开发指南

Claude Code 接入 Codex 官方插件,先把 review gate 关掉

用 Claude Code 写完功能后,想让另一个模型再看一遍,过去通常要退出会话、另开终端、启动 Codex,再重复解释项目背景和修改原因。OpenAI 的 codex-plugin-cc 解决的是这段上下文搬运:在 Claude Code 中输入 /codex:review,本机已经安装并登录的 Codex CLI

更新于 2026/9/20

用 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 的配置。

插件原文配图 1

安装前确认三个条件

需要满足:

  • 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> 指定对比基线。

插件原文配图 2

两种 review 不要混用

/codex:review 不接受额外关注点,会按固定标准完成常规检查,结果相对稳定,但不一定覆盖你正在担心的具体问题。

/codex:adversarial-review 允许在 flag 后附加自由文本,会围绕指定问题质疑实现路线。

因此,想做常规体检时用前者,想让它专门盯着鉴权或迁移脚本等问题时用后者。两者都只读;需要真正修改代码,应使用 /codex:rescue

插件原文配图 3

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 当作常驻配置。

插件原文配图 4

插件沿用 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,观察长任务跨工具迁移是否适合自己的流程。

参考来源

AIGoCode · 面向开发者的实践与指南
Claude Code 接入 Codex 官方插件,先把 review gate 关掉