⚠️ 免责声明：本工具依赖境外公开数据源（OpenAI Codex / Claude Code），部分平台在中国大陆需合规网络环境。本文仅作技术介绍，不构成任何投资建议或购买引导。

每日开源 · 086

2026-07-07

codex-plugin-cc

OpenAI 官方出品
让 Claude Code 和 Codex 在同一工作流里协作

7 个核心命令 · 对抗性审查 · 会话转移 · 后台并行 · Apache 2.0 开源

📦 项目速览

项目名　codex-plugin-cc

出品方　OpenAI 官方

定位　Claude Code 插件，桥接 Codex 能力

语言　JavaScript / TypeScript

许可证　Apache 2.0

版本　v1.0.5（2026-06-24）

Stars　26.4k+ · 今日 +906 🔥

GitHubopenai/codex-plugin-cc

🤔 它能解决什么问题？

如果你是重度 AI 编程用户，大概率同时用过 Claude Code 和 OpenAI Codex。Claude Code 以强大的上下文理解与复杂推理著称，Codex 在代码生成速度和审查质量上有独特优势。

但一直以来，这两个工具各干各的——你在 Claude Code 里写完代码，想让 Codex 审查，就得：

❌ 切到另一个终端窗口

❌ 重新上传代码、重新解释背景

❌ 手动搬运上下文信息

❌ 两个 agent 之间零协作

codex-plugin-cc 的出现彻底改变了这个局面——它就像在两个 AI 助手之间架起了一座桥梁，让你在 Claude Code 里就能直接调用 Codex 的能力。

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

✨ 核心亮点

1️⃣ 7 个核心命令，覆盖三大场景

插件提供了 7 个 slash 命令，分属代码审查、任务委派和任务管理三大类：

# 代码审查类
/codex:review　　　　　　　　　— 标准代码审查（只读）
/codex:adversarial-review　　— 对抗性审查（挑战设计决策）

# 任务委派类
/codex:rescue　　　　　　　　　— 把任务交给 Codex 执行
/codex:transfer　　　　　　　　— 会话转移，上下文接力

# 任务管理类
/codex:status　　　　　　　　　— 查看后台任务进度
/codex:result　　　　　　　　　— 获取已完成任务结果
/codex:cancel　　　　　　　　　— 取消正在运行的任务

# 环境配置
/codex:setup　　　　　　　　　— 检查 Codex 安装与认证

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

2️⃣ 对抗性审查——不只是找 bug，而是挑战方向

普通审查回答"代码有没有 bug"，对抗性审查回答**“这个方向对不对、这个设计会不会在三个月后成为技术债”**。

两种审查的核心区别：

标准审查：关注代码细节、规范性 → 不可引导、不接受自定义焦点

对抗性审查：挑战设计决策、架构权衡 → 可接受焦点文本、可定向

你可以把特定关注点传给它：

# 基础对抗性审查
/codex:adversarial-review

# 针对特定风险点
/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

适用场景：上线前压力测试、安全敏感代码审查（认证/授权/数据丢失风险）、性能关键路径的方案评估。

3️⃣ 后台并行——审查不阻塞工作流

代码审查是耗时操作，尤其是多文件改动。插件所有命令都支持 –background 参数，让 Codex 在后台运行，你可以继续和 Claude 对话：

# 后台启动审查
/codex:review --background
/codex:rescue --background investigate the regression

# 继续工作…然后查看状态
/codex:status

# 任务完成后获取结果
/codex:result

这意味着双 agent 真并行——Claude 继续帮你推理和编码，Codex 同时在后台跑审查或修复任务。

4️⃣ 会话转移——上下文无缝接力

v1.0.5 新增的 /codex:transfer 是最值得关注的功能。它把当前 Claude Code 会话的完整上下文导出为 Codex 可恢复的线程：

/codex:transfer

# 输出：
codex resume

# 拿着这个命令在终端里继续执行
# Codex 会接收完整的会话历史

适合场景：Claude Code 已经帮你调查清楚了问题，下一步是让 Codex 独立执行一个耗时任务——不再需要重新解释一遍背景。

5️⃣ 零摩擦集成——共享认证和配置

插件不使用单独的 Codex 运行时，而是通过本地 Codex CLI 和 App Server 委派。这意味着：

✅ 使用与你直接使用 Codex 相同的本地认证

✅ 使用相同的仓库 checkout 和机器本地环境

✅ 拾取你已有的 Codex 配置（~/.codex/config.toml）

✅ 现有的 API key 和 base URL 设置仍然适用

配置按优先级加载：用户级 ~/.codex/config.toml → 项目级 .codex/config.toml。如果在此机器上已登录 Codex，直接可用——不需要单独注册账户。

6️⃣ Review Gate——发布前的强制门控

Review Gate 是这个插件最激进的功能——通过 Claude Code 的 Stop Hook 机制实现：

工作流程：

Claude 完成分析 → Stop Hook 触发 → Review Gate 运行 Codex 审查

→ 如果发现问题：阻断 Stop Hook，Claude 必须先处理才能回应

→ 如果没有问题：正常放行

⚠️ **官方警告：**Review Gate 可能创建长时间运行的 Claude/Codex 循环，并可能快速消耗用量限制。仅在计划主动监控会话时启用，日常开发代价太高。

启用方式：

/codex:setup --enable-review-gate# 启用
/codex:setup --disable-review-gate# 关闭

7️⃣ 架构解析——四个核心子系统

插件采用分层架构，由四个核心子系统组成：

① Dispatcher（codex-companion.mjs）

CLI 参数解析与子命令路由，所有插件操作的入口

② Broker（app-server-broker.mjs）

持久化 Codex app-server 会话管理，避免反复启动开销，通过 JSON-RPC 协议通信

③ State Manager（state.mjs + tracked-jobs.mjs）

任务状态持久化（jobId/日志/进度/结果），支持 /codex:status 和 /codex:result 查询

④ Subagent（codex:codex-rescue）

注册在 /agents 目录下的 Claude 子代理，专用于将任务委托给 Codex 执行

还通过 Hook 集成与 Claude Code 生命周期绑定：

• SessionStart：准备 Codex 运行环境，设置 SESSION_ID_ENV 变量

• SessionEnd：清理资源（teardownBrokerSession + cleanupSessionJobs）

• Stop：可触发 Review Gate，审查通过才放行

🎯 实战场景展示

场景一：发布前的代码审查

你刚完成一个复杂功能的开发，准备提交 PR。在 Claude Code 里直接审查：

/codex:review --base main --background

# 继续在 Claude Code 里工作…
/codex:status
# 审查完成后获取结果
/codex:result

Codex 审查你的改动与 main 分支的差异，找出潜在问题。不切换终端、不丢失上下文。

场景二：架构决策的压力测试

你准备上线一个关键功能，想确认缓存策略和重试设计是否靠谱：

/codex:adversarial-review --base main challenge whether this was the right caching and retry design

Codex 会质疑你的设计选择：缓存策略是否有竞态条件？重试逻辑是否会导致雪崩？有没有更安全的替代方案？

场景三：调查 bug + 快速修复

Claude Code 调查了一个问题但需要更深入的执行，直接委派给 Codex：

# 用 spark 快速模型试一下
/codex:rescue --model spark investigate the flaky test

# 用最小安全补丁修复
/codex:rescue fix the failing test with the smallest safe patch

# 续接上次任务
/codex:rescue --resume apply the top fix from the last run

spark 自动映射为 gpt-5.3-codex-spark（快速模型），你也可以指定 gpt-5.4-mini 或 gpt-5.4，根据任务复杂度灵活选择。

场景四：上下文接力——Claude 调查完，Codex 来执行

你在 Claude Code 里花了 20 分钟调查一个数据库连接泄漏问题，调查完毕但修复工作量大。直接把上下文转移给 Codex：

/codex:transfer

# 输出：
codex resume abc-123-session-id

# 在终端里继续执行
# Codex 会接收完整会话历史，不再需要重新解释背景

上下文零丢失——Codex 拿到了你 20 分钟积累的全部推理过程，直接开始执行。

🛠️ 上手指南

前置条件

• Node.js 18.18 或更高版本

• ChatGPT 订阅（免费版就行）或 OpenAI API Key

Step 1：安装 Codex CLI

npm install -g @openai/codex

# 登录认证
codex login

Step 2：添加插件源

/plugin marketplace add openai/codex-plugin-cc

Step 3：安装插件

/plugin install codex@openai-codex

Step 4：重载并验证

/reload-plugins
/codex:setup

/codex:setup 会自动检测 Codex CLI 安装状态和认证有效性。一切正常的话，你就可以看到所有 slash 命令和 codex:codex-rescue 子代理。

⚡ 首次体验（30 秒上手）

/codex:review --background
# 继续工作…
/codex:status
/codex:result

自定义配置

在项目根目录的 .codex/config.toml 中设置默认模型和推理强度：

# .codex/config.toml
model = “gpt-5.4-mini”
model_reasoning_effort = “high”

如需指向自定义 API 端点，在 Codex config 中设置 openai_base_url。

模型快捷名称速查

spark → gpt-5.3-codex-spark（快速模型，适合简单任务）

gpt-5.4-mini → 轻量推理，平衡速度和质量

gpt-5.4 → 高质量推理，适合复杂任务

–effort 参数：medium / high，控制推理强度

❓ 常见问题

需要单独的 Codex 账户吗？

不需要。使用本地 Codex CLI 认证——如果已在此机器上登录 Codex，直接可用。

会使用单独的 Codex 运行时吗？

不会。通过本地 Codex CLI 和 App Server 委派，同一机器同一环境。

会拾取我已有的 Codex 配置吗？

是的。配置优先级：用户级 ~/.codex/config.toml → 项目级 .codex/config.toml。

能保留现有的 API key 和 base URL 设置吗？

可以。因为使用本地 Codex CLI，现有登录方式和配置完全兼容，包括自定义 openai_base_url。

📝 今日总结

codex-plugin-cc 解决的核心问题是多 agent 工作流的切换成本：

• 审查（review / adversarial-review）：不打断工作流，临时引入第二视角

• 委托（rescue）：把任务真正交出去，后台并行执行

• 转移（transfer）：把完整上下文带走，在另一个 agent 里继续

更重要的是，OpenAI 官方维护一个让用户从 Claude Code 里调用 Codex 的插件，暗示至少在工具层面，AI coding agents 正在走向跨厂商协作而非封闭生态——这个信号意义远大于技术实现本身。

💬 你同时用 Claude Code 和 Codex 吗？

体验过两个 agent 协作的工作节奏后，欢迎分享你的感受。

明日早间篇，继续为你挖掘前沿开源项目 🌅

⚠️ 免责声明：codex-plugin-cc 依赖 OpenAI Codex 和 Anthropic Claude Code 服务，部分平台在中国大陆需合规网络环境。本文仅作技术介绍，不构成任何投资建议或购买引导。

每日开源 · 086 · 2026-07-07 · 早间篇
项目地址：github.com/openai/codex-plugin-cc
许可证：Apache 2.0 · 开源无门槛