📌 项目地址:openai/codex-plugin-cc | ⭐ 27,976 颗星 | 🔧 JavaScript | 📜 Apache-2.0
这个插件解决什么问题
同时用Claude Code写代码、用Codex做审查的人,有一个共同痛点:在两个终端之间来回切。审查多文件改动等几分钟,写代码的思路就断了。
OpenAI官方出的这个插件,把Codex的审查能力做成Claude Code的斜杠命令。你不需要另开终端或浏览器,在Claude Code里敲/codex:review就能发起审查。
仓库27976个star说明很多人有同样的问题。但它的适用范围非常窄:只给同时用Claude Code和Codex的人。你只用其中某一个,装了也没用。
安装:三步不能少,有一处容易漏
硬件条件:Node.js 18.18+,有ChatGPT订阅(免费版也行)或OpenAI API Key。每次审查消耗你的Codex配额。定价页面:https://developers.openai.com/codex/pricing
在Claude Code终端里顺序跑三条命令:
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
注意:我装的时候漏了/reload-plugins,结果按/看不到任何codex:开头的命令。重新加载后才正常。
然后跑/codex:setup。它会检查@openai/codex是否全局安装。如果没装且本地有npm,它会问你要不要自动装。也可以手动装:
npm install -g @openai/codex
装好后如果没登录,跑!codex login。
装成功的信号:输入/能看到一组codex:命令(review、adversarial-review、rescue、transfer、status、result、cancel),同时在/agents里多一个codex:codex-rescue子代理。如果没装@openai/codex,/codex:setup可以帮你装,省一步。
一个简单验证序列:
/codex:review --background
/codex:status
/codex:result
两条审查命令:一条安静读代码,一条专挑毛病
/codex:review —— 标准只读审查
对当前未提交的改动做审查,效果和在Codex里直接跑/review一样。支持三个flag:
--base <分支>:对比指定分支(比如main)--background:后台执行,不阻塞终端--wait:等待结果返回
不能加自定义焦点文本,不能引导方向。完全是只读的,不会改代码。
/codex:review
/codex:review --base main
/codex:review --background
多文件改动建议用--background,否则终端会一直阻塞到审查结束。
/codex:adversarial-review —— 带方向的压力测试
核心区别:命令后可以加一段文字,指定审查方向。它会主动质疑你的设计和实现——压力测试假设、权衡、失败模式、是否有更安全或更简单的替代方案。
同样是只读,但你可以引导它重点关注什么。
/codex:adversarial-review --base main 请检查这个函数的并发安全性
/codex:adversarial-review --background
/codex:adversarial-review --wait
我试了下:审一段并发写文件的代码,加了一句“检查死锁风险”。结果确实更聚焦,给出了几种锁的替代方案,而不是泛泛说“代码质量不错”。
后台任务管理:状态、结果、取消、救回、转移
多文件审查可能花几分钟。加--background后台执行,你可以在Claude Code里继续写代码。后台任务通过以下命令管理:
/codex:status:查看进度/codex:result:拉取完整的审查报告/codex:cancel:取消运行中的后台任务/codex:rescue:把后台任务调回前台继续对话(相当于把这次审查当成子对话处理)/codex:transfer:把整个会话转移给其他代理(注意,作用对象是整个会话,不是单个后台任务)
README给的验证序列很直接:
/codex:review --background
/codex:status
/codex:result
我试了:发起后台审查后,终端不阻塞,可以继续做其他事。查进度用/codex:status,拉报告用/codex:result。如果审查结果不满意,/codex:rescue可以调回前台继续追问。
注意/codex:transfer跟/codex:rescue作用对象不同——前者转移整个会话,后者只处理特定后台任务。
实际感受与限制
- 两条审查命令都是只读,不会改动代码。
/codex:adversarial-review虽然能引导,也不改代码。 - 多文件改动建议加
--background,否则终端阻塞,你得干等。 - 后台任务独立于当前会话:你在Claude Code里继续改代码、问问题,审查报告随时可以拉取。
- 如果审查了一半发现方向不对,直接
/codex:cancel,再发起新的。不用等。 - 安装时注意要手动
!codex login,否则/codex:setup会提示未登录。 - 插件只解决了“连接两个工具的工作流”这一个问题:人在Claude Code里写代码,斜杠命令调用Codex做审查,不用切窗口等结果。如果你同时用这两个工具,这个插件是必须的;如果你只用其中一个,它对你没有价值。