codex-plugin-cc：在 Claude Code 里调用 Codex 做代码审查和任务接力

Mon, 06 Jul 2026 07:30:09 +0800

OpenAI 的 codex-plugin-cc 是一个给 Claude Code 使用的插件。它的目标很直接：如果你平时主要在 Claude Code 里开发，但又想让 Codex 参与代码审查、问题排查或长任务接力，就可以通过这个插件把 Codex 接进现有工作流。

它不是另一个独立的代码编辑器，也不是重新实现一套 Codex。它调用的是本机已经安装并登录的 Codex CLI 和 Codex app server，所以账号、配置、仓库目录和本地环境都沿用你机器上的 Codex 状态。

适合谁用

这个插件适合几类人：

日常主要使用 Claude Code，但也想用 Codex 做独立代码审查；
希望在提交前让另一个 Agent 挑问题、质疑设计或检查风险；
想把某个 bug、测试失败或重构任务交给 Codex 在后台跑；
已经配置好 Codex，希望 Claude Code 和 Codex 可以在同一个仓库里顺手协作；
想把 Claude Code 当前会话转成 Codex 可继续接手的 thread。

如果你只使用 Codex，不使用 Claude Code，这个插件意义不大。它的价值就在于把两个工具之间的切换成本压低。

前置要求

官方 README 给出的要求很少：

ChatGPT 订阅，包括 Free，或 OpenAI API key；
Node.js 18.18 或更高版本；
本机能安装并运行 Codex CLI。

需要注意的是，通过这个插件调用 Codex 仍然会计入你的 Codex usage limits。它不是绕过额度的入口，只是把 Codex 放进 Claude Code 的命令体系里。

如果 Codex 还没安装，可以后面让 /codex:setup 引导安装，也可以自己先装：

`1`	`npm install -g @openai/codex`

如果 Codex 已经安装但还没登录，在 Claude Code 里可以运行：

`1`	`!codex login`

安装方法

在 Claude Code 里先添加插件 marketplace：

`1`	`/plugin marketplace add openai/codex-plugin-cc`

然后安装插件：

`1`	`/plugin install codex@openai-codex`

重新加载插件：

`1`	`/reload-plugins`

最后运行初始化检查：

`1`	`/codex:setup`

/codex:setup 会检查 Codex 是否可用。如果 Codex 缺失，并且当前环境可以使用 npm，它会提示你安装 Codex。安装完成后，Claude Code 里应该能看到一组 /codex:* slash commands，并且在 /agents 中看到 codex:codex-rescue subagent。

一个最小的首次测试流程是：

1
2
3

/codex:review --background
/codex:status
/codex:result

主要命令

`/codex:review`

/codex:review 用来让 Codex 对当前改动做普通代码审查。它是只读命令，不会修改代码。

常见用法：

1
2
3

/codex:review
/codex:review --base main
/codex:review --background

如果当前改动比较多，建议加 --background。多文件审查可能会跑一段时间，放到后台后可以用 /codex:status 查看进度，用 /codex:result 读取结果。

这个命令适合检查：

当前未提交改动有没有明显 bug；
分支相对 main 的改动是否有风险；
提交前是否遗漏了测试、边界条件或兼容性问题。

它不接受自定义审查焦点。如果你想让 Codex 专门挑战某个设计选择，应该用 /codex:adversarial-review。

`/codex:adversarial-review`

/codex:adversarial-review 是可引导的挑战式审查。它同样只读，不会修代码，但会更强调质疑实现方向、设计取舍和隐藏假设。

示例：

1
2
3

/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

它适合在这些场景使用：

缓存、重试、权限、数据删除等高风险改动；
你已经有一个实现，但想确认方向是否太复杂；
想让另一个模型从反方视角看设计是否站得住。

`/codex:rescue`

/codex:rescue 会把一个任务交给 codex:codex-rescue subagent。它更像“把问题交给 Codex 跑一轮”，可以用于 bug 排查、修测试、继续上一次 Codex 任务，或者用较小模型做一个更快的尝试。

示例：

/codex:rescue investigate why the tests started failing
/codex:rescue fix the failing test with the smallest safe patch
/codex:rescue --resume apply the top fix from the last run
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky integration test
/codex:rescue --model spark fix the issue quickly
/codex:rescue --background investigate the regression

也可以用自然语言让 Claude Code 把任务委托给 Codex：

`1`	`Ask Codex to redesign the database connection to be more resilient.`

几个细节要记住：

不传 --model 或 --effort 时，Codex 会自己选择默认值；
spark 会映射到 gpt-5.3-codex-spark；
不传 --resume 和 --fresh 时，插件可以提示是否继续当前仓库里最近的 rescue thread；
复杂任务建议配合 --background，否则容易卡住当前工作节奏。

`/codex:transfer`

/codex:transfer 是 v1.0.5 中值得注意的新功能。它可以把当前 Claude Code 会话转成一个持久的 Codex thread，并输出 codex resume <session-id> 命令。

示例：

1
2

/codex:transfer
/codex:transfer --source ~/.claude/projects/-Users-me-repo/<session-id>.jsonl

这个命令适合用在“我已经和 Claude Code 讨论了很多上下文，但后面想交给 Codex 继续”的场景。插件会使用 Claude Code 的 SessionStart hook 找到当前 transcript path；--source 则可以手动指定来源。

限制也要注意：

source 必须位于 ~/.claude/projects 下；
依赖 Codex 的 external-agent session importer；
老版本 Codex 如果没有 session import 能力，需要先升级。

`/codex:status`、`/codex:result` 和 `/codex:cancel`

这三个命令负责管理后台任务。

查看任务状态：

1
2

/codex:status
/codex:status task-abc123

读取任务结果：

1
2

/codex:result
/codex:result task-abc123

取消任务：

1
2

/codex:cancel
/codex:cancel task-abc123

如果任务结果里包含 Codex session ID，你还可以用 codex resume <session-id> 在 Codex 里继续那个任务。

可选的 review gate

/codex:setup 还可以管理一个可选的 review gate：

1
2

/codex:setup --enable-review-gate
/codex:setup --disable-review-gate

启用后，插件会通过 Claude Code 的 Stop hook 触发一次有针对性的 Codex review。如果 Codex 找到问题，这次停止会被阻止，让 Claude Code 先处理反馈。

这个功能听起来很诱人，但要谨慎开。官方也提醒，它可能形成 Claude 和 Codex 之间的长循环，并快速消耗 usage limits。更适合在你盯着看的关键任务中临时开启，而不是长期默认打开。

配置怎么继承

codex-plugin-cc 使用本机全局 codex binary，因此会沿用你的 Codex 配置。

如果想给某个项目指定默认模型和推理强度，可以在项目根目录的 .codex/config.toml 中写：

1
2

model = "gpt-5.4-mini"
model_reasoning_effort = "high"

配置读取顺序主要包括：

用户级配置：~/.codex/config.toml；
项目级配置：.codex/config.toml；
项目级配置只会在项目被 Codex trust 后加载。

如果你已经用 API key、base URL 或其他 Codex 配置跑通了工作流，插件会继续使用这些配置。需要改 OpenAI provider endpoint 时，可以在 Codex 配置里设置 openai_base_url。

常见工作流

提交前审查

1
2
3

/codex:review --background
/codex:status
/codex:result

适合在准备 commit 前跑一遍。它不会帮你自动修，但能用 Codex 的视角指出 bug、测试缺口和风险。

挑战设计

`1`	`/codex:adversarial-review --background look for auth bypass and rollback risks`

适合权限、数据迁移、缓存失效、重试策略这类“代码能跑，但设计可能埋雷”的改动。

把问题交给 Codex 跑

`1`	`/codex:rescue --background investigate why the build is failing in CI`

适合你不想中断当前 Claude Code 对话，但又希望 Codex 在后台独立排查。

从 Claude Code 转到 Codex

`1`	`/codex:transfer`

当 Claude Code 里已经积累了足够上下文，但你想在 Codex App 或 TUI 继续，就用这个命令生成可恢复的 Codex thread。

使用建议

我的建议是先把它当成“第二审查者”和“后台救援通道”，不要一上来就把 review gate 打开。

比较稳的顺序是：

先跑 /codex:setup，确认 Codex 安装、登录和 Claude Code 插件都正常；
用 /codex:review --background 做一次只读审查；
需要挑战设计时再用 /codex:adversarial-review；
确认后台任务管理顺手后，再尝试 /codex:rescue；
只有在明确需要跨工具延续上下文时，再用 /codex:transfer。

这样用下来，codex-plugin-cc 的定位会比较清楚：Claude Code 继续做主工作台，Codex 负责独立审查、后台排查和必要时接手上下文。对已经在两个工具之间来回切的人来说，这个插件能少掉不少手工复制上下文和重新解释任务的时间。

代码审查 on KnightLi的博客