codex-plugin-cc

图1：OpenAI 官方开源项目

项目概述

想象一下这个场景：你正在 Claude Code 中调试一个棘手的 bug，写了半天的代码，忽然发现有个逻辑漏洞。传统做法是自己来回翻代码、查文档、试方案。但如果你能把这个问题"甩"给 OpenAI 的 Codex，让它同时做代码审查和问题调查呢？

codex-plugin-cc 正是这样一座桥梁——它把 OpenAI Codex 无缝嵌入 Claude Code，让两个顶级 AI 编程工具协同工作。你可以在 Claude Code 里直接调用 /codex:review 让 Codex 做深度代码审查，也可以用 /codex:rescue 把任务委托给 Codex 后台执行，自己继续手头工作。

这个插件的作者是 OpenAI 官方团队（@openai），项目采用 Apache-2.0 开源协议，当前版本 1.0.5，是 OpenAI 官方发布的 Claude Code 插件生态中的第一个插件。

核心功能详解

1. 代码审查系列命令

/codex:review — 常规代码审查

这是插件最基础的功能。它调用 Codex 对当前 Git 工作状态进行只读的代码审查。审查范围可以是未提交的改动（working tree），也可以是基于某个基准分支（如 main）的分支差异。

使用方式非常简洁：

/codex:review              # 审查当前未提交的改动
/codex:review --base main  # 审查 main 分支以来的所有变更
/codex:review --background # 后台运行，不阻塞你的工作流

审查是纯只读的，不会修改任何代码。当在后台运行时，你可以随时用 /codex:status 查看进度，/codex:cancel 取消任务。

/codex:adversarial-review — 对抗性审查

这是比常规审查更"刁钻"的版本。与其验证代码"对不对"，它更关注"方向对不对"——质疑设计选择、挑战实现假设、寻找隐藏的 trade-off。

适用场景非常具体：发版前的最后一轮"压力测试"，特别是涉及认证逻辑、数据丢失风险、回滚机制、并发问题或可靠性设计时。

/codex:adversarial-review --base main challenge whether this was the right caching and retry design
/codex:adversarial-review --background look for race conditions and question the chosen approach

这个功能体现了 OpenAI 对 AI 辅助编程的深度理解——好的代码审查不仅是找 bug，还要挑战"为什么要这么做"这个更根本的问题。

2. 任务委托系列命令

/codex:rescue — 委托调查/修复任务

这是插件最强大的功能。它通过 codex:codex-rescue 子代理，将任务委托给 Codex 在后台执行。你可以委托代码调查、bug 修复、甚至是继续之前未完成的工作。

支持丰富的控制参数：

• --resume：继续上一个 rescue 线程
• --fresh：从头开始新任务
• --model：选择模型（如 gpt-5.4-mini、spark）
• --effort：控制推理投入（none/minimal/low/medium/high/xhigh）
• --background：后台运行，避免长时间阻塞

比如：

/codex:rescue investigate why the build is failing in CI
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky test
/codex:rescue --background investigate the regression

/codex:transfer — 会话迁移

当你已经在 Claude Code 里进行了一段调试或实现对话，想把这个上下文直接迁移到 Codex 继续时，/codex:transfer 就派上用场了。它从当前 Claude Code 会话创建一个可恢复的 Codex 线程，打印出 codex resume <session-id> 命令，让你无缝衔接。

/codex:status 和 /codex:result

这两个命令用来管理后台任务：/codex:status 显示运行和最近的任务状态，/codex:result 查看已完成任务的最终输出（包含可恢复的 Codex session ID）。

3. Review Gate（审查门控）

这是一个实验性安全机制。通过 /codex:setup --enable-review-gate 启用后，Claude Code 每次提交改动前都会自动触发一次针对性的 Codex 审查。如果 Codex 发现问题，提交会被阻止，让 Claude 有机会先处理这些问题。

⚠️ 这个功能可能产生较长的 Claude/Codex 循环，并快速消耗 API 限额，建议仅在需要主动监控会话时启用。

技术架构解析

插件系统设计

codex-plugin-cc 采用了标准的 Claude Code 插件结构，核心文件组织如下：

plugins/codex/
  commands/      # 各 slash command 定义（review.md、rescue.md 等）
  agents/        # 子代理定义（codex-rescue.md）
  hooks/         # Claude Code 生命周期钩子（如 Stop 钩子用于 review gate）
  prompts/       # 提示词模板（对抗性审查提示、stop-gate 审查提示）
  schemas/       # 结构化输出 schema（JSON Schema）
  scripts/       # 核心脚本（codex-companion.mjs）
  skills/        # 技能定义目录

所有命令都通过 ${CLAUDE_PLUGIN_ROOT}/scripts/codex-companion.mjs 这个核心 Node.js 脚本执行。

codex-companion.mjs 核心引擎

这是一个约 30,000 字的 Node.js 脚本，导出了大量子模块：

• args.mjs：命令行参数解析（parseArgs、splitRawArgumentString）
• codex.mjs：Codex app-server 通信核心（runAppServerTurn、runAppServerReview、importExternalAgentSession）
• claude-session-transfer.mjs：Claude 会话迁移（resolveClaudeSessionPath）
• git.mjs：Git 上下文收集（collectReviewContext、resolveReviewTarget、ensureGitRepository）
• job-control.mjs：后台任务管理（createJobRecord、readStoredJob、resolveResultJob）
• tracked-jobs.mjs：任务追踪（runTrackedJob、createProgressReporter）
• render.mjs：终端输出渲染（renderReviewResult、renderTaskResult 等）
• state.mjs：持久化状态（upsertJob、writeJobFile、getConfig）
• prompts.mjs：提示词模板加载与插值

核心流程是：Claude Code slash command → codex-companion.mjs 解析参数 → 通过 Codex app-server API 发起请求 → 收集 Git 上下文 → 渲染结果回到终端。

Codex App Server 集成

插件通过 OpenAI Codex 的 app-server 接口与 Codex 通信。这是一个标准化的 HTTP API，允许外部工具调用 Codex 的推理能力。插件生成 TypeScript 类型定义（prebuild 脚本中的 codex app-server generate-ts）来确保类型安全。

提示词工程

插件的审查质量直接由提示词决定。adversarial-review.md 中的提示词明确指示 Codex"要打破自信，而非验证变更"，并提供了详细的审查框架，包括实现方法质疑、风险点识别、替代方案对比等维度。stop-review-gate.md 则限制了审查范围——仅审查上一次 Claude 改动的代码，避免上下文混乱。

状态管理

插件在本地维护任务状态（~/.claude/codex-jobs/），每个任务有独立的 JSON 记录文件和日志文件。状态文件包含任务 ID、状态（pending/running/completed/cancelled）、结果输出等。这使得任务可以在 Claude Code 重启后继续查询。

上手体验

安装门槛

安装过程对 Claude Code 用户来说非常友好：

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

前提是你已有 Node.js >= 18.18、npm，以及 ChatGPT 订阅或 OpenAI API Key（Codex 通过 ChatGPT 订阅免费提供，或通过 API key 付费使用）。

实际工作流

以一个典型的 bug 调查场景为例：

1. 你在 Claude Code 里发现某个测试忽然失败了
2. 输入 /codex:rescue --background investigate why the tests started failing
3. 继续在 Claude Code 做其他工作，同时 Codex 在后台调查
4. 稍后用 /codex:status 查看进度
5. 有了结果后，用 /codex:result 查看输出
6. 如果需要，可以 codex resume <session-id> 直接在 Codex 里继续

整个过程不需要切换应用，不需要复制粘贴上下文——两个 AI 在同一个终端里无缝协作。

局限性与争议

1. 强依赖 Claude Code 生态

这是一个"专为 Claude Code 用户准备"的插件。如果你用其他编辑器或 AI 编程工具，这个插件完全无法使用。这种深度绑定既是优势（能复用 Claude Code 的上下文和会话管理），也是局限（无法独立使用）。

2. Codex 与 Claude 的同质化问题

OpenAI 的 Codex 和 Anthropic 的 Claude 都具备强大的代码理解和生成能力。codex-plugin-cc 让两者协同工作，但本质上是在"用 Claude 调度 Codex"——Claude Code 是主控制器，Codex 是执行者。对于已经熟悉 Claude Code 的用户来说，这种调度的必要性值得思考：Claude Code 本身已具备代码审查和问题解决能力，为何还要引入 Codex？

OpenAI 的答案是：Codex 的审查视角与 Claude 不同，特别是对抗性审查（adversarial-review）提供了独特的"挑战者"视角，而不是验证者视角。这种"第二意见"在关键发版节点可能很有价值。

3. 后台任务的管理复杂度

当多个后台任务同时运行时（review、rescue、review-gate），状态管理和结果追踪可能变得复杂。用户需要记住不同的命令来查询不同类型的任务。

4. Review Gate 的风险

自动触发审查门控虽然理念先进，但"Claude 修改代码 → Codex 审查 → 发现问题阻止提交 → Claude 再次修改 → Codex 再次审查"的循环可能导致：API 消耗快速增加，以及循环难以退出的风险。插件自己也明确警告了这一点。

行业意义

AI 编程工具的"工具链整合"趋势

codex-plugin-cc 代表着 AI 编程工具从"单打独斗"走向"协同工作"的阶段。2025 年下半年开始，AI 编程工具的竞争已从"模型能力"扩展到"生态整合能力"——谁能更好地融入开发者的现有工作流，谁就更有优势。OpenAI 选择 Claude Code 作为插件宿主，Anthropic 则通过 MCP（Model Context Protocol）构建工具生态，两者代表了不同的整合思路。

"人类在中间"模式的演变

传统开发流程中，人类工程师是各种工具的协调者。codex-plugin-cc 尝试让 Claude（作为人类代理）来协调 Codex，形成一种"AI 在中间"的新模式。这种模式的有效性取决于：Claude 是否总能做出正确的调度决策，以及两个模型的推理方向是否真的互补。

开源插件生态的示范

这是 OpenAI 官方发布的第一个 Claude Code 插件，为社区树立了插件开发的范本。插件质量很高：完整的 TypeScript 构建、自动化测试（10+ 个测试文件）、清晰的命令定义格式、标准化的提示词模板。它的出现可能激励更多工具厂商开发 Claude Code 插件。

截至目前，项目在 GitHub 上已获得超过 26,000 颗星，保持着活跃的维护状态（最新版本 1.0.5），对于一个相对小众的 Claude Code + Codex 双工具用户群体来说，这是一个相当可观的社区认可度。

---

本报告由 PIFS 项目情报系统自动生成，分析时间：2026-07-08。数据来源：GitHub API（仓库信息、文件结构、代码内容）。