📌 项目地址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做审查,不用切窗口等结果。如果你同时用这两个工具,这个插件是必须的;如果你只用其中一个,它对你没有价值。
这篇文章对你有帮助吗?

发表回复