📌 项目地址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:reviewcodex:adversarial-reviewcodex:rescuecodex:transfercodex:statuscodex:resultcodex: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 更具体,直接给出了用 LockRLock 的建议,而不是泛泛说“代码质量不错”。

后台任务管理

多文件审查可能花几分钟。加 --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 做更系统的审查,这个插件省了来回切工具的时间。

这篇文章对你有帮助吗?

发表回复