在 Claude Code 里调用 Codex：openai/codex-plugin-cc 的用法与边界
该插件允许 Claude Code 将存储库任务发送到 Codex 进行实施或进行第二次代码审查。
秒懂
- 它是什么？
- 这个插件把 Codex 的代码审查和任务执行能力塞进 Claude Code 的斜杠命令里。它解决的是工具切换成本，但代价是依赖 ChatGPT 订阅或 OpenAI API key，以及后台任务管理的额外复杂度。
- 适合谁用？
- 适合已经在 Claude Code 里工作、又想偶尔借用 Codex 审查能力或把冗长任务甩给另一个模型的人。不适合那些希望完全脱离 ChatGPT 计费体系、或者需要审查结果与 Claude 上下文深度绑定的团队。
- 能商用吗？
- 可以。Apache-2.0 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库最近一次提交在 70 天前。
- 用什么语言写的？
- 主要是 JavaScript（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。
开源项目深度解析
它解决的是工具切换，不是审查质量
这个插件解决的是一个很具体的问题：你已经在 Claude Code 里写代码，但想用 Codex 来审查或执行任务，又不想切到另一个终端。它把 Codex 的能力包装成六个斜杠命令，让你在 Claude Code 的对话流里直接触发 Codex。注意，它不改变 Codex 本身的审查质量，只是把入口搬了个位置。文档明确说 /codex:review 给出的是“和直接在 Codex 里运行 /review 相同的审查质量”。所以它的价值在于流程整合，而不是算法增强。目标用户是那些已经在用 Claude Code、又愿意为 Codex 单独付费的人。
六个命令，三种用途
插件提供六个斜杠命令，可以按用途分成三组。第一组是审查：/codex:review 做常规只读审查，/codex:adversarial-review 做可引导的挑战式审查，后者接受额外的焦点文本，比如“challenge whether this was the right caching and retry design”。第二组是任务委托：/codex:rescue 把调查 bug、修测试这类任务交给 Codex，/codex:transfer 把当前 Claude Code 会话转成一个持久的 Codex 线程，并输出 codex resume <session-id> 命令。第三组是任务管理：/codex:status 查看后台任务状态，/codex:result 获取最终输出，/codex:cancel 取消任务。注意 /codex:review 和 /codex:adversarial-review 都是只读的，不会改代码。而 /codex:rescue 会实际执行修复，需要你明确授权。
后台任务机制：从触发到取结果
后台任务是这个插件的核心机制。文档建议多文件审查用 --background 标志，因为审查可能很慢。触发后，任务在后台运行，你可以继续在 Claude Code 里做别的事。用 /codex:status 查看进度，用 /codex:result 取最终输出。结果里会包含 Codex session ID，你可以用 codex resume <session-id> 在 Codex 里重新打开那次运行。这个设计很实在：它承认了长任务会阻塞对话，所以把任务生命周期独立出来。但这也意味着你需要手动管理任务状态，而不是在 Claude 对话里直接看到结果。如果你忘了查状态，后台任务可能一直挂着。文档提到 /codex:cancel 可以取消活动任务，但没说取消后是否清理资源。
安装与初始化：依赖 npm 和 Codex 登录
安装步骤很直接。在 Claude Code 里执行 /plugin marketplace add openai/codex-plugin-cc，然后 /plugin install codex@openai-codex，再 /reload-plugins。之后运行 /codex:setup 检查 Codex 是否就绪。如果 Codex 缺失且 npm 可用，setup 可以帮你安装。你也可以手动装：npm install -g @openai/codex。如果 Codex 装了但没登录，需要运行 !codex login。这里有个关键依赖：插件要求 Node.js 18.18 或更高，而且必须有 ChatGPT 订阅或 OpenAI API key。文档明确说使用会消耗你的 Codex 用量限额。所以这不是一个免费工具，你的 Codex 配额决定了你能用多久。
审查模式的选择：常规还是对抗式
两个审查命令的差异值得注意。/codex:review 是常规审查，不可引导，不接受自定义焦点文本。它适合快速检查未提交改动或对比分支，用 --base <ref> 指定基准分支。/codex:adversarial-review 则接受焦点文本，你可以指定风险区域，比如“look for race conditions and question the chosen approach”。文档说它用于“质疑所选实现和设计”，而不是单纯找代码细节问题。这意味着如果你想审查缓存重试设计是否合理，应该用对抗式。但对抗式审查同样只读，不会修复问题。如果你希望 Codex 直接改代码，那是 /codex:rescue 的活。选择哪个命令取决于你是要“找错”还是“挑战决策”。
任务委托与模型选择：spark 映射的细节
/codex:rescue 是唯一会实际改动代码的命令。它通过 codex:codex-rescue 子代理把任务交给 Codex。你可以传 --model 和 --effort 参数，比如 --model gpt-5.4-mini --effort medium 或 --model spark。文档特别说明，spark 会被映射到 gpt-5.3-codex-spark。如果你不传模型，Codex 自己选默认值。这个设计给了你控制权，但也暴露了插件对 Codex 版本和模型名的依赖。文档还提到，如果你不传 --resume 或 --fresh，插件可能会建议继续该仓库上一次的 rescue 线程。这意味着插件维护了任务历史，但你需要理解 resume 的语义，否则可能意外延续旧任务。
会话转移：从 Claude 到 Codex 的桥
/codex:transfer 是一个独特的命令，它把当前 Claude Code 会话转成 Codex 线程。插件利用 SessionStart 钩子自动获取当前 transcript 路径，你也可以用 --source 手动指定。但文档有一个限制：源文件必须位于 ~/.claude/projects 下。这意味着你只能转移 Claude Code 生成的会话文件，不能随便指向任意路径。转移使用 Codex 的外部代理会话导入器，转换规则与 Codex App 导入 Claude 历史相同。这功能适合调试到一半想换工具的场景，但有一个硬性前提：旧版 Codex 不暴露会话导入接口，必须升级。如果你用的 Codex 版本较老，这个命令会直接失败，文档没有给出具体版本号。
审查门控与维护成本
插件还提供一个可选功能：审查门控。用 /codex:setup --enable-review-gate 启用，--disable-review-gate 禁用。文档没有详细说明门控的具体行为，但从命名推断，它可能在某个流程节点强制要求 Codex 审查。这是唯一一个涉及工作流策略的功能，但文档信息很少，你需要自己实验。维护成本方面，插件最近更新到 v1.0.6，说明还在活跃维护。但注意，插件依赖 Codex CLI 和 Claude Code 两边的 API，任何一边变化都可能破坏功能。许可证是 Apache-2.0，你可以自由使用和修改，但需要保留版权声明。安装后你需要定期更新插件，因为 Codex 的会话导入和模型映射可能随版本变化。
编辑结论
适合已经在 Claude Code 里工作、又想偶尔借用 Codex 审查能力或把冗长任务甩给另一个模型的人。不适合那些希望完全脱离 ChatGPT 计费体系、或者需要审查结果与 Claude 上下文深度绑定的团队。安装前先确认 Node.js 18.18+ 和 Codex 登录状态，用 /codex:setup 验证。第一次使用建议跑 /codex:review --background，然后 /codex:status 和 /codex:result 观察任务生命周期。如果审查必须可定制焦点，直接用 /codex:adversarial-review，它接受自由文本参数，而 /codex:review 不支持。若你只是想要一个独立的审查工具，不依赖 Claude Code，直接装 @openai/codex 用 /review 命令更省事。
社区笔记