本文作者:sitin(@sitinme)。版权归作者所有,未经授权禁止转载。


用 Claude Code 写完一段功能,想换个模型再看一遍,过去这事挺折腾。

退出会话,另开一个终端,起 Codex,把项目背景、改了哪几个文件、为什么这么改,重新交代一遍。代码一行没多写,上下文讲了两遍。

OpenAI 官方开源了一个插件,codex-plugin-cc,就是冲这一段来的,装完之后在 Claude Code 里敲一句 /codex:review,本机的 Codex 直接接过 diff 开始审。

一句话概括这个插件:它没有把 Codex 模型塞进 Claude Code,而是把本机那个已经装好、已经登录的 Codex CLI,接到了 Claude Code 的命令面板上。

这个区别很实在,模型、推理力度、base URL、额度,全都还是走原来那套 Codex 配置。

Article image

装之前,先确认你能不能用

两个硬条件。

一个是账号,ChatGPT 订阅就行,免费档也算,或者用 OpenAI API key,用掉的量记在你的 Codex 额度上,不是 Claude 那边的额度。

另一个是 Node.js 18.18 或更高版本。

本机还得有 Codex 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 装没装、登没登。缺 CLI 而本机又有 npm 的时候,它可以顺手帮你装上。

装完验收看两个地方:斜杠命令里能不能敲出 /codex:,以及 /agents 里有没有多出来一个叫 codex:codex-rescue 的子代理,两样都在,就算成了。

装完多了 8 个命令

八个,按用途分三拨。

审查这一拨两个。/codex:review 是标准审查,只读,不改代码。/codex:adversarial-review 是能带话的那种,你在 flag 后面接一段文字说明重点看哪里,它会顺着这段话去质疑你的实现方式和设计取舍。

派活这一拨两个。/codex:rescue 把任务丢给那个 codex:codex-rescue 子代理,查 bug、试着修、接着上次的活儿继续干,或者换个便宜点的模型重跑。/codex:transfer 是把当前这个 Claude Code 会话搬成一条能长期留着的 Codex 线程,搬完它给你打印一条 codex resume <session-id>,拿着这条命令在 Codex 里接着聊。

管任务这一拨三个。/codex:status 看这个仓库下正在跑和刚跑完的任务,/codex:result 取某个任务的最终输出,/codex:cancel 掐掉还在后台跑的那个。后两个都能带任务 ID。

剩下一个就是 /codex:setup,除了装完那一次,它还管着一个开关,待会儿单说。

官方给的第一次试跑顺序是这三条:

/codex:review --background /codex:status /codex:result

--background 这个 flag 值得单拎出来。多文件的审查本来就慢,不加它你就得盯着终端干等;加上它,审查丢到后台,你继续在 Claude Code 里干别的,回头用 /codex:status 看进度、/codex:result 取结果。非要等就用 --wait。

审查还能指定基准,--base <ref>,拿某个分支当对比基线。

Article image

两种 review,别用混

这俩命令长得像,用法完全不一样。

/codex:review 不接受你的关注点。你没法告诉它重点看鉴权、重点看那个迁移脚本,它按自己那套标准走一遍。好处是稳定,坏处是你心里那个具体的担心,它不一定看得到。

/codex:adversarial-review 正好相反,flag 后面可以跟自由文本,它会带着这段话去质疑你选的实现路线。

所以选哪个,取决于你是想要一次常规体检,还是想找人专门盯着某处抬杠。

有一点两个是一样的:都只读,不动代码,想让它真的改,得走 /codex:rescue。

Article image

rescue 是派活,transfer 是搬家

/codex:rescue 的 flag 比别的命令都多:--background、--wait、--resume、--fresh、--model、--effort。

--model 和 --effort 不写就用 Codex 自己的默认值。想省点额度,可以在话里说 spark,它会映射到 gpt-5.3-codex-spark。

--resume 和 --fresh 是一对。前者接着这个仓库最近那条 Codex 任务往下干,后者从干净状态重新开始。上下文该续还是该断,你自己拿主意。

/codex:transfer 是另一回事。它把当前会话转成一条能长期留着的 Codex 线程,再给你一条 codex resume 命令接上。有个前置条件容易忘:源头那份会话记录得在 ~/.claude/projects 底下。另外 Codex 版本太老、不支持会话导入的,先升级再说。

review gate:最该谨慎的那个开关

/codex:setup 带两个 flag:

/codex:setup --enable-review-gate /codex:setup --disable-review-gate

打开之后,Claude Code 每次准备收尾,都会触发一个 Stop hook,让 Codex 针对 Claude 这一轮的回答做一次定向审查,审出问题来,这一轮就停不下来,得先把问题处理掉。

听着挺美,白捡一道自动质检。

官方自己在文档里给这个功能挂了警告,说它可能造成 Claude 和 Codex 之间的长循环,额度掉得很快,建议只在你人盯着会话的时候开。

这个警告不是客套。想一下这个环:Claude 收尾,Codex 审出问题,不让停,Claude 去改,改完又要收尾,Codex 再审改完的东西,又审出点新的。每一轮两边都在烧额度,而且没人叫停它就不会自己停。

所以这个开关的正确用法是临时开:跑一段你确实不放心的改动,开着,人在旁边看着,跑完就关。把它当常驻配置,很容易某天回来发现额度没了,还想不起来是怎么没的。

Article image

它没有自己的运行时

这是最容易理解错的一点。插件不是第三个 Agent,也不是新的 IDE,它就是个转接头。

跑起来靠的是你本机那个全局 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。

Article image

几个容易踩的地方

多文件审查慢,默认加 --background,别在那干等。重活派给 rescue 也一样,前台跑容易把整个会话卡住。

/codex:transfer 在老版本 Codex 上会直接失败,看到报错先去升级,别怀疑人生。

想让审查盯着某个具体问题,别用 /codex:review,那条命令不吃你的关注点,写了也白写。

review gate 开了就别撒手不管。

写在最后

这个插件真正省掉的,是那段重复交代上下文的时间。审查、派活、把会话整个搬走,几条路都在同一个终端里,不用来回切窗口,它没解决的是判断。Codex 提的意见里哪些值得改、哪些只是另一种写法偏好,这一步还是你的活儿。

天天在 Claude Code 里写业务代码的: 先只用 /codex:review --background,拿几个真实 diff 跑一跑,看它报的东西跟你关心的对不对得上。对得上再往下试别的命令,review gate 先别碰。

给团队定工作流的: 重点看配置那两层。项目级 .codex/config.toml 只在项目被信任时生效,这条不提前讲清楚,团队里会有一半人的配置默默不起作用。另外额度是记在个人 Codex 账号上的,也得说明白。

两个工具都在用的:/codex:transfer 值得单独试一次。长任务在 Claude Code 里开的头,中途想换到 Codex 接着干,这条路比复制粘贴上下文干净太多。

至于 review gate,它是这个插件里最像自动化的功能,也是最容易让你额度莫名其妙少一半的功能。要开可以,人得在旁边。

参考来源:OpenAI Codex Plugin for Claude Code 官方仓库:https://github.com/openai/codex-plugin-ccOpenAI Codex CLI 官方文档:https://learn.chatgpt.com/docs/codex/cli

最近发现一个好用的 AI 生图工具,分享一下。

写文章、做 PPT、搞 README 配图的时候经常需要快速出一张图,HiAPI.ai 直接输入描述就能出图,也支持生视频,响应很快,出图质量也不错。

新注册用户送 50 张 GPT Image 2 免费额度,不用绑卡,需要快速出图的可以试试。

👉 HiAPI.ai(直达链接:https://www.hiapi.ai/invite/QwfK)

想了解更多可以加我 vx: 257735 聊。

Article image