引言

“Use Codex from Claude Code to review code or delegate tasks.”

这是「每日一个开源项目」系列的第 151 篇。今天的项目是 codex-plugin-cc —— 一款让你在 Claude Code 工作流里直接呼叫 OpenAI Codex 的官方插件。

这件事本身就值得说一说：这是 OpenAI 官方为 Anthropic 的 Claude Code 写的插件。两家公司在模型层面是直接竞争对手，但在 agent 层面，这个插件的存在暗示了一个新的趋势 —— AI coding agents 正在走向跨厂商协作而非封闭生态。

24,582 颗 Star，项目创建于 2026 年 3 月，距今不过几个月。

你会学到什么

• 7 条核心命令的具体作用及适用场景
• 对抗性审查（/codex:adversarial-review）的独特价值
• Review Gate：Stop Hook 拦截机制的工作原理与风险
• 后台任务管理：background 模式与状态追踪
• 会话转移：把 Claude Code 的上下文带入 Codex 继续执行

前提知识

• 使用过 Claude Code 的基本命令
• 了解 Claude Code 的插件/技能机制
• 基本了解 OpenAI Codex CLI

---

项目背景

概述

codex-plugin-cc 是 OpenAI 官方发布的 Claude Code 插件，桥接 Claude Code 和本地安装的 Codex CLI（@openai/codex）。

安装后，用户可以直接在 Claude Code 会话里输入 /codex:review、/codex:rescue 等命令，把代码审查或任务执行委托给 Codex 完成 —— 而不需要离开当前终端窗口，不需要切换工具，也不需要把上下文复制粘贴给另一个 agent。

插件使用与 Claude Code 相同的本地认证（ChatGPT 账号或 OpenAI API Key），配置通过 TOML 文件管理（~/.codex/config.toml 用户级，.codex/config.toml 项目级）。

项目信息

• 作者/组织: OpenAI
• 主语言: JavaScript
• 许可证: Apache 2.0
• 版本: 1.0.5

项目数据

• ⭐ GitHub Stars: 24,582+
• 🍴 Forks: 1,487+
• 📄 许可证: Apache 2.0
• 📅 创建时间: 2026-03-30

---

功能特性

安装

# 第一步：从插件市场添加
/plugin marketplace add openai/codex-plugin-cc

# 第二步：安装
/plugin install codex@openai-codex

# 第三步：重载
/reload-plugins

# 第四步：检查环境（验证 Codex 安装 + 认证状态）
/codex:setup

7 条核心命令

/codex:review — 标准代码审查

只读模式。Codex 审查你尚未提交的改动，或指定 base branch 的 diff。

/codex:review
/codex:review --base main
/codex:review --background    # 后台运行，不阻塞 Claude 会话

不可干预 —— 触发后 Codex 按标准流程运行，输出审查意见。

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

这是插件里最有意思的命令。它不是简单的代码审查，而是对决策本身发起质疑：

• 挑战设计选择
• 质问权衡取舍
• 追问假设前提
• 找出失败模式

而且它是可定向的（steerable）——可以把关注点传给它：

/codex:adversarial-review focus on our error handling assumptions
/codex:adversarial-review question whether this abstraction is premature
/codex:adversarial-review --background

对抗性审查和普通审查的区别：普通审查回答「代码有没有 bug」，对抗性审查回答「这个方向对不对、这个设计会不会在三个月后成为技术债」。

/codex:rescue — 把任务委托给 Codex

这是最重量级的命令。把一个任务整体交给 Codex 执行 —— Codex 在本地独立调查、写代码、尝试修复。

/codex:rescue investigate this bug and try a fix
/codex:rescue continue what you were doing last time
/codex:rescue --model spark          # 使用 gpt-5.3-codex-spark（快速模型）
/codex:rescue --model gpt-5.4        # 使用更强模型
/codex:rescue --effort high          # 提高推理力度
/codex:rescue --background           # 后台执行，Claude 继续工作
/codex:rescue --resume               # 续接上一个 Codex 任务
/codex:rescue --fresh                # 强制新建任务（忽略历史状态）

--background 是关键参数：Codex 在后台运行，Claude Code 不阻塞，你可以继续和 Claude 对话，等 Codex 完成后用 /codex:result 查看结果。

模型快捷名称：spark 映射到 gpt-5.3-codex-spark（快速）；也可直接用 gpt-5.4-mini、gpt-5.4。

/codex:transfer — 会话转移

把当前 Claude Code 会话的完整上下文导出为 Codex 的持久线程：

/codex:transfer

执行后输出：

codex resume <session-id>

你可以拿着这个命令在终端里继续执行，Codex 会接收完整的会话历史。适合场景：Claude Code 已经帮你调查清楚了问题，下一步是让 Codex 独立执行一个耗时任务，不想继续占用 Claude Code 的上下文窗口。

状态管理三件套

/codex:status    # 查看当前 repo 的所有运行中/最近的 Codex 任务
/codex:result    # 查看已完成任务的最终输出（含 Codex session ID，可用来 resume）
/codex:cancel    # 取消当前活跃的后台任务

---

深度解析

Review Gate：Stop Hook 拦截机制

Review Gate 是这个插件最激进的功能 —— 也是风险最高的功能。

工作原理：

Claude 完成分析，准备输出响应
    ↓
Stop Hook 触发
    ↓
Review Gate 运行针对性的 Codex 审查
    ↓
如果 Codex 发现问题：
    阻断 Stop Hook → Claude 无法响应 → 被迫处理问题
如果没有问题：
    正常放行 → Claude 输出响应

本质上，Review Gate 把 Codex 变成了 Claude 回应前的强制门控。Claude 不能「先说、后改」—— 它必须先把 Codex 发现的问题处理掉，才能完成这轮回应。

启用方式：

/codex:setup    # 安装时会询问是否启用 Review Gate

README 的明确警告：

WARNING: This can create long-running loops. It can also drain your usage limits. Use it with caution and monitor the results carefully.

两个真实风险：

1. 死循环：Codex 挑出问题 → Claude 修改 → Codex 审查新代码 → 再挑问题 → 循环。
2. 用量消耗：每次 Claude 回应前都额外运行一次 Codex，成本翻倍甚至更高。

Review Gate 适合高风险变更（core logic 修改、涉及安全的代码）。日常开发开着它，代价太高。

架构细节

codex-plugin-cc 的工作流程：

用户输入 /codex:rescue
    │
    ▼
Claude Code 插件层接收命令
    │
    ├── 读取项目配置（.codex/config.toml）
    │
    ├── 启动本地 Codex CLI（@openai/codex）
    │   或调用 Codex app server
    │
    ├── 使用本地认证（ChatGPT 账号 / OpenAI API Key）
    │
    └── 后台任务 → 按 repo 追踪状态
                ↓
        /codex:status 查询
        /codex:result 获取输出
        /codex:cancel 取消

codex:codex-rescue 被注册为 /agents 目录下的子 agent，会话导入通过 Codex 的 external-agent session importer 实现。

两种使用模式对比

场景	推荐命令	说明
快速检查改动有没有明显问题	/codex:review	只读，快速
质疑架构决策、压力测试设计	/codex:adversarial-review	可定向，挑战性
把一个耗时任务交给另一个 agent	/codex:rescue --background	非阻塞，并行执行
Claude 调查完毕，Codex 来执行	/codex:transfer	上下文接力
高风险代码的质量门控	Review Gate	谨慎使用

跨厂商协作的信号意义

这个插件的技术实现并不复杂 —— 本质上是 Claude Code 插件包装了 Codex CLI 调用。它的意义更多在于它存在本身：

OpenAI 官方维护一个让用户从 Claude Code 里调用 Codex 的插件，意味着至少在工具层面，两家公司认为用户会同时使用两个系统，跨系统协作是值得投资的用例。

Claude Code 的插件/技能系统提供了一个开放接口 —— 任何第三方（包括竞争对手）都可以在上面构建 integration。这个插件的出现，加上 caveman（#150 期）等社区工具，正在形成一个跨 agent 工具生态。

---

参考资源

官方链接

• 🌟 GitHub: openai/codex-plugin-cc
• 📦 Codex CLI: @openai/codex (本地 agent 本体)

---

总结

codex-plugin-cc 解决的核心问题是多 agent 工作流的切换成本：你在 Claude Code 里工作，需要第二个 agent 的视角或执行能力，但切换工具意味着重新建立上下文、打开新窗口、手动搬运信息。

7 条命令覆盖了三种典型场景：

• 审查（/codex:review、/codex:adversarial-review）：不打断工作流，临时引入第二视角
• 委托（/codex:rescue）：把任务真正交出去，后台并行执行
• 转移（/codex:transfer）：把完整上下文带走，在另一个 agent 里继续

其中 /codex:adversarial-review 是最有差异化价值的命令 —— 它不是在找 bug，而是在质疑决策本身。当你对自己的架构选择产生怀疑，或者需要一个「唱反调的声音」来压力测试你的方案时，这条命令直接提供了这个功能。

Review Gate 功能对于高风险代码变更有价值，但 README 的警告是认真的 —— 开启前明确知道你在接受什么代价。

如果你的日常工作流里已经同时用着 Claude Code 和 Codex，这个插件值得装上用几天，感受一下两个 agent 协作的工作节奏和边界在哪里。

---

探索 PrimeSkills —— 精选 AI agent 和技能工具，每一个都经过真实工作流验证。没有炒作，只有真正好用的工具。

访问我的个人主页，获取更多见解和有趣的产品。