Codex Plugin for Claude Code：让 Codex 当 Claude Code 的副驾驶

最近 GitHub Trending 上有一个项目悄悄爬到了榜首——openai/codex-plugin-cc。它做的事情其实很直白：在 Claude Code 里直接调用 OpenAI 的 Codex，让 Codex 帮 Claude Code 审代码、跑任务、甚至直接 delegate 一段活过去。这不是又一个新的 CLI，而是两个顶级 AI 编程工具之间的桥。

本文带你快速了解它能做什么、为什么值得关注、以及怎么用一条 Docker 命令跑起来。

背景：为什么需要这个桥

Claude Code 和 Codex 都是当下最火的 AI 编程 Agent。Claude Code 擅长长链路推理、复杂任务拆解；Codex 在代码生成、PR 审查、本地执行上有一手。日常开发里，我们经常会卡在一种情况：Claude Code 写完一段代码，想让另一个"局外人"再 review 一遍，或者把某个独立任务（比如生成单测、重构某个模块）扔给一个独立的 Agent 跑。

以前这种需求要么切窗口手动复制代码过去，要么写一堆脚本串 API。openai/codex-plugin-cc 直接把这步省了——在 Claude Code 里敲一条 slash 命令，就能拉 Codex 进来干活。

项目的描述写得很短："Use Codex from Claude Code to review code or delegate tasks." 一句话把动机讲清楚。

能做什么

根据 README 和 demo，codex-plugin-cc 主要支持四种用法：

1. 代码审查：让 Codex 看你当前的 diff，输出 review 意见。和普通 IDE 自带的 linter 不一样，它能给出语义层面的建议（命名、边界条件、潜在 bug）。
2. 任务委派：把一段明确的任务（比如"给这个函数写单元测试"）交给 Codex 在沙箱里跑，跑完把结果带回来。
3. 并行执行：Claude Code 处理主流程，遇到可以并行的子任务时直接派给 Codex，主线程不阻塞。
4. 多视角对比：同一个问题同时问 Claude Code 和 Codex，比较两边的回答，挑选最优解。

它本质上是 Claude Code 的一个 plugin，通过 MCP（Model Context Protocol）把 Codex 的能力挂到 Claude Code 的工具列表里。所以你不用离开 Claude Code 的界面，就能完成这些事。

为什么值得

把它放在今天 Trending 第一位不是没有原因：

• 降低切换成本：过去要在两个 CLI 之间反复粘贴代码，现在一站式搞定。对每天重度使用 Claude Code 的人来说，省下来的时间非常可观。
• 官方出品：仓库在 openai 组织下，意味着这是 OpenAI 官方维护的 plugin，不是社区野路子。后续跟 Claude Code 的兼容性会有保障。
• 刚好踩中趋势：AI Agent 之间的协作（Agent-to-Agent）这两年被反复提及，codex-plugin-cc 是少数真正落地的开源实现。
• 上手极简：plugin 安装命令两行，配置 API key 之后直接能用。对已经订阅 ChatGPT Plus / Codex 的用户来说，零额外成本。

当然它也有一些局限：目前只支持 Claude Code 作为宿主（不能反过来在 Codex 里调 Claude Code）；任务委派的上下文长度受 Codex 自身的窗口限制；大文件 review 的速度取决于网络。

快速上手

最简单的方式是通过 npm 全局安装 plugin，然后用 Claude Code 加载。

1. 安装 plugin

npm install -g @openai/codex-plugin-cc

2. 在 Claude Code 里注册

打开 ~/.claude/settings.json，加上：

{
  "plugins": [
    "@openai/codex-plugin-cc"
  ]
}

重启 Claude Code，让它加载新的 plugin。

3. 配置 API key

设置环境变量（也可以写到 .env）：

export OPENAI_API_KEY=sk-...
export CODEX_API_KEY=sk-...

> 注：Codex 现在走的是 ChatGPT 订阅体系，你需要在 OpenAI 账户里启用 Codex 才能拿到有效的 key。

4. 触发调用

在 Claude Code 的对话里，输入 slash 命令：

/codex-review

它会把当前文件或当前 git diff 喂给 Codex，输出审查意见。

如果想委派任务：

/codex-delegate Write unit tests for src/parser.ts using vitest.

任务会在 Codex 沙箱里独立跑完，结果回传到主对话。

用 Docker 隔离运行

如果你不想污染本地 Node 环境，可以直接用 Docker 起一个干净的容器：

docker run -it --rm \
  -e OPENAI_API_KEY=$OPENAI_API_KEY \
  -v $PWD:/workspace \
  -w /workspace \
  node:22 \
  bash -c "npm install -g @openai/codex-plugin-cc && /bin/bash"

容器起来后，你可以在里面手动跑 Claude Code，所有 plugin 自动可用。

实战示例

假设你在写一个 TypeScript 的 parser，已经实现了一段：

export function parseTokens(input: string): Token[] {
  const tokens: Token[] = [];
  // ... 业务逻辑
  return tokens;
}

在 Claude Code 里输入：

/codex-review Please review src/parser.ts and suggest edge cases I'm missing.

几秒钟后 Codex 会回一段类似下面的反馈：

- Empty string input 应当返回空数组，目前看起来是 OK 的，但建议加一个单元测试锁死行为。
没有处理 Unicode surrogate pair，遇到 emoji 切分可能会错位。
性能：当 input 长度超过 10MB 时，正则会回溯，建议改用状态机。

这种 review 比普通 linter 强得多，因为它读懂了代码的语义。

适合谁

• 每天重度用 Claude Code 的开发者：你已经在用 Claude Code 写项目，多一个 review 视角等于多一个资深同事帮你把关。
• Codex 订阅用户：你付了 ChatGPT Plus 的钱，但平时在 Claude Code 里待得多——这个 plugin 让你两边都不浪费。
• 想尝试 Agent 协作的小团队：可以拿它做 PoC，看看多 Agent 协作的工作流长什么样。
• AI 编程工具的早期采纳者：你想跟最新的 Agent-to-Agent 趋势保持同步，那这就是必装的工具。

反过来，如果你只是偶尔写几行脚本，或者只用 Codex 不碰 Claude Code，那这个 plugin 对你意义不大。

一些注意事项

1. API 配额：每次 /codex-review 都会消耗 Codex 的 token。建议对超大文件做局部 review，而不是整仓一把梭。
2. 上下文传递：委派任务时尽量把上下文写清楚（文件路径、入口函数、期望输出）。模糊的指令 Codex 跑出来的东西质量会明显下降。
3. 隐私：默认配置下，代码会被发送到 OpenAI 的服务端。如果你的代码涉及商业机密，先看下 OpenAI 的数据使用条款，或者用本地 self-hosted 的 Codex 替代方案（目前还在 preview）。
4. 版本兼容：Claude Code 本身迭代很快，plugin 偶尔会有滞后，遇到问题先 npm update -g @openai/codex-plugin-cc 再排查。

链接

• 仓库：https://github.com/openai/codex-plugin-cc
• Claude Code 官方文档：https://docs.claude.com/claude-code
• Codex 介绍：https://openai.com/codex
• MCP 协议规范：https://modelcontextprotocol.io

如果今天只让你装一个新工具试一下，这个 5 分钟就能跑起来的 plugin 是个不错的起点。

截图占位

下面两张图展示 Codex plugin 在 Claude Code 里的运行效果：