项目概览
Codex Plugin for Claude Code 是 OpenAI 官方推出的 Claude Code 插件，让用户可以在 Claude Code 工作流中直接调用 OpenAI Codex CLI，实现跨模型协作——用 Claude 做主力编程，用 Codex 做代码审查和任务委派。插件通过 Claude Code 的 Plugin System 注册自定义 Slash Commands、Hooks、Subagents 和 Skills，在命令触发时通过 Bash 调用本地 Codex CLI 的 App Server 接口。它提供六个 Slash Command，覆盖代码审查、对抗性审查、任务委派和任务管理；通过 SessionStart、SessionEnd、Stop 三种 Hook 实现生命周期管理和自动质量门控。其核心创新是 Review Gate，在 Claude Code 完成代码修改后自动触发 Codex 审查，审查结果为 ALLOW 则放行，BLOCK 则阻止 Stop 并让 Claude 继续修复，形成自动化的写代码、审查、修复循环。插件支持后台运行任务、灵活选择 Codex 模型，并自动读取现有 Codex 配置。
解决什么问题
在未使用此类插件前，用户只能在一个 AI 编程工具中工作，面临六大结构性缺陷：
- 模型偏见盲区：单个模型无法发现自己的系统性错误，需要第二双眼睛。
- 成本与能力的矛盾：Claude Opus 能力强但贵，Codex 中小模型便宜但能力弱，单一工具无法按任务类型自动选择性价比最高的模型。
- 审查反馈循环断裂：传统工作流中代码审查需人工或另开终端，在 AI 编程的秒级迭代节奏下严重拖慢开发速度。
- 模型锁定风险：深度绑定一个 AI 编程工具后，迁移成本极高。
- 长任务阻塞主会话：全量审查、复杂调试等耗时任务只能等待或另开终端。
- 工作流碎片化：在 Claude Code 中需要 Codex 特定能力时，需切换工具、复制上下文、手动同步。
传统替代方案也存在问题：手动开两个终端分别运行 Claude Code 和 Codex 时上下文不共享；写完代码后再用 Codex 单独审查耗时且反馈滞后；仅使用 Claude Code 内置审查缺少第二模型视角；使用第三方复合编排工具配置复杂且不稳定。
工作方式
插件通过 Claude Code 的 Plugin System 注册自定义 Slash Commands、Hooks、Subagents 和 Skills，在命令触发时通过 Bash 调用本地 Codex CLI 的 App Server 接口。核心模块包括：Commands（6 个 Slash 命令定义用户交互入口）、Subagent（Codex 任务委派子代理）、Hooks（SessionStart/SessionEnd/Stop 三个生命周期钩子）、Skills（codex-cli-runtime、codex-result-handling、gpt-5-4-prompting）、Scripts（核心运行时脚本）、Prompts（stop-review-gate 和 adversarial-review 提示词模板）、Schemas（review-output 的 JSON Schema 验证）。
六个 Slash Command 分为四类：审查类（/codex:review 标准审查、/codex:adversarial-review 对抗性审查）、委派类（/codex:rescue 任务委派）、管理类（/codex:status、/codex:result、/codex:cancel）、工具类（/codex:setup 环境检查和配置）。
三种 Hook 机制：SessionStart 在会话启动时初始化 Codex 环境、清理旧状态；SessionEnd 在会话结束时清理临时文件、归档任务记录；Stop 在 Claude Code 完成一轮回复时触发 Review Gate，用 Codex 审查刚才的代码修改。
核心能力
- 跨模型互审：Claude 写代码、Codex 审查，打破单模型盲区
- 官方出品：OpenAI 维护，和 Codex CLI 同步更新
- 轻量非侵入：不改变 Claude Code 的工作方式，只是叠加能力
- 异步支持：审查和委派任务支持后台运行，不阻塞主流程
- 灵活模型选择：可按需选择 Codex 模型（spark/mini/标准），控制成本
- Review Gate 创新：自动化的质量门控，双模型闭环审查
- 无缝会话迁移：Codex 审查结果可带 session ID，直接在 Codex CLI 中继续
- 配置共享：自动读取现有 Codex 配置，零额外配置成本
使用前需要了解
- AI 整理 · 本地测试，未经人工复核；依据历史报告节选，不代表当前产品状态。
-
- 需要额外安装 Codex CLI 和 OpenAI 账号，依赖 Codex CLI
- Codex 需要调用 OpenAI API，网络不通则无法使用
- 同时使用两个模型的 API，成本可能翻倍
- Review Gate 开启后可能形成无限循环（Claude 改 → Codex Block → Claude 再改），且会增加 Claude/Codex 循环次数，可能快速消耗用量配额
- 不能替代 Claude Code 的核心编程能力，只是辅助层
- Codex 不共享 Claude 的对话上下文，每次审查需要重新收集 diff
- 依赖 Claude Code 的 Plugin System，如果 Claude 更新了插件 API 可能需要适配
- 不支持直接在 Codex 和 Claude 之间共享对话历史
- 运行要求 Node.js ≥ 18.18 和 Codex CLI
- 前置条件还包括 Claude Code 已安装并可用
