📌 项目地址:openai/codex-plugin-cc | ⭐ 27,976 颗星 | 🔧 JavaScript | 📜 Apache-2.0
这个插件解决什么问题
OpenAI 出了个官方插件,让 Claude Code 用户直接在聊天框里用 /codex:review 等斜杠命令调用 Codex 做代码审查。日常用 Claude Code 写代码的人,不用再切换到 Codex 窗口去跑审查,省了上下文切换的时间。
项目地址:openai/codex-plugin-cc,2.8 万星,JavaScript 写的,Apache-2.0 许可。
安装步骤,我踩过的坑
前提条件两个:Node.js 18.18 以上,以及有 ChatGPT 订阅(免费版也行)或 OpenAI API Key。每次审查走 Codex 配额,价格看 定价页。
在 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、codex:adversarial-review、codex:rescue、codex:transfer、codex:status、codex:result、codex:cancel 一串命令。同时在 /agents 里多一个 codex:codex-rescue 子代理。
简单测试一下:
/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 —— 可引导方向的挑战式审查
这个命令后面可以跟一段文字,告诉它重点查什么。README 说它的工作是“压力测试你的假设、权衡、失败模式,以及是否有更安全或更简单的替代方案”。同样是只读,但你可以引导它聚焦某一方面。
/codex:adversarial-review --base main 检查这个函数的并发安全性
/codex:adversarial-review --background
/codex:adversarial-review --wait
我试了下:给一段并发写文件的代码加上 --base main 关注共享变量的锁策略,审查结果比默认 review 更具体,直接给出了用 Lock 或 RLock 的建议,而不是泛泛说“代码质量不错”。
后台任务管理
多文件审查可能花几分钟。加 --background 后台执行,你可以在 Claude Code 里继续写代码。后台任务通过以下命令管理:
/codex:status:查看进度(比如“正在审查第3个文件”)/codex:result:拉取完整的审查报告/codex:cancel:取消运行中的后台任务/codex:rescue:把后台任务调回前台继续对话(注意它只针对特定后台任务,不是整个会话)/codex:transfer:把整个会话转移给其他代理(比如从 Claude Code 切到别的工具)
注意 /codex:transfer 跟 /codex:rescue 作用对象不同——前者转移整个会话,后者只处理一个后台任务。
实际使用感受
- 两条审查命令都是只读,不会改动代码。
/codex:adversarial-review虽然能引导,也不改代码。 - 多文件改动建议加
--background,否则终端阻塞,你得干等。 - 后台任务独立于当前会话:你在 Claude Code 里继续改代码、问问题,审查报告随时可以拉取。
- 如果审查了一半发现方向不对,直接
/codex:cancel,再发起新的。不用等。 - 安装时注意要手动
!codex login,否则/codex:setup会提示未登录。 - 插件只解决了“连接两个工具的工作流”这一个问题:人在 Claude Code 里写代码,斜杠命令调用 Codex 做审查,不用切窗口等结果。
我觉得这个设计很务实。它没有试图做新东西,只是把两个现有的代码审查工具串起来。如果你日常用 Claude Code 写代码,又想借助 Codex 做更系统的审查,这个插件省了来回切工具的时间。