/文档

Claude Code 与 Codex 协同开发指南

为什么要这样搭配?

一句话:让贵的模型动脑,让便宜的模型动手,账单不爆炸。

Claude 擅长理解需求、架构规划、复杂推理,但价格也摆在那——用它来写大量代码,Token 烧得飞快。Codex 的代码能力强、速度快,关键是价格便宜很多。

所以最合理的搭配是:

Claude 负责规划:理解你的需求,拆解任务,做架构决策,想清楚怎么做

Codex 负责执行:通过 /codex:rescue 接手具体的编码任务,写代码、修 bug、跑测试

Codex 负责审查:通过 /codex:review 给 Claude 的代码做 code review,充当第二双眼睛

这个搭配的核心逻辑是:Claude 的 Token 只花在「想清楚」上,具体的编码和审查交给更便宜的 Codex。对于每天高强度使用 Claude Code 的人来说,能显著降低整体开销。

本指南假设你已完成 Claude Code 和 Codex 的安装配置。如未完成,请先参考:

Claude Code 配置:Big Router 快速开始指南

Codex 配置:Big Router × Codex 快速开始指南

1. 安装 Codex 插件

两边都配好之后,在 Claude Code 里装一个插件就能串起来:

/plugin marketplace add openai/codex-plugin-cc

/plugin install codex@openai-codex

/reload-plugins

/codex:setup

/codex:setup 会自动检测 Codex 是否安装、是否已认证。如果提示未登录,运行 !codex login 完成认证。

安装完成后,输入 /codex 即可看到新增的斜杠命令。

2. 核心命令

这个插件一共就三类能力:审查、委派任务、任务管理。

审查类(只读,不改代码)

命令 作用

/codex:review 让 Codex 审查当前未提交的改动,或对比分支

/codex:adversarial-review 对抗性审查——不只是检查代码,而是主动质疑你的设计决策

# 审查未提交的改动

/codex:review

# 审查当前分支和 main 的差异

/codex:review --base main

# 后台运行,不阻塞当前对话

/codex:review --background

# 对抗性审查,指定关注方向

/codex:adversarial-review --background 检查是否有竞态条件,质疑缓存策略的选择

委派类(把任务交给 Codex 执行)

命令 作用

/codex:rescue 把一个具体任务交给 Codex 去做,Codex 会实际修改代码

这是实现「Claude 规划,Codex 执行」的核心命令。你可以把 Claude 规划好的任务,逐个交给 Codex 去实现:

# 让 Codex 去查 bug

/codex:rescue investigate why the tests started failing

# 让 Codex 去修 bug

/codex:rescue fix the failing test with the smallest safe patch

# 让 Codex 去实现一个功能

/codex:rescue 实现用户注册的表单验证逻辑

# 后台执行,适合耗时任务

/codex:rescue --background 重构数据库连接池

# 指定更便宜的模型,进一步省钱

/codex:rescue --model gpt-5.4-mini 写一组单元测试覆盖 utils.ts

/codex:rescue --model spark 快速修复这个 lint 错误

# 继续上次的任务

/codex:rescue --resume 把上次的修复方案应用上去

💡 省钱技巧:--model gpt-5.4-mini 或 --model spark 可以用更便宜更快的模型执行简单任务。

任务管理类

命令 作用

/codex:status 查看正在运行和最近完成的 Codex 任务

/codex:result 获取已完成任务的结果(含 session ID,可在 Codex 中继续)

/codex:cancel 取消正在运行的后台任务

3. 推荐工作流:Claude 规划,Codex 执行

日常开发流程

你提需求 → Claude 分析拆解 → /codex:rescue 逐个执行 → /codex:review 审查 → 提交

用自然语言描述需求,让 Claude 理解你要什么

Claude 做规划:拆解任务、确定实现方案、理清先后顺序——这是 Claude 最擅长的

用 /codex:rescue 把具体编码任务交给 Codex:Claude 规划好了"要做 A、B、C 三件事",你就用 rescue 一个个交给 Codex 去写

代码写完跑审查:/codex:review --background,让 Codex 做独立 code review

根据审查意见修复后提交

这个流程的好处是:Claude 的 Token 只花在规划和理解上,大量的编码工作走 Codex 的便宜额度。

高风险改动流程

涉及数据库迁移、认证授权、基础设施变更时,多加一层对抗性审查:

Claude 规划 → /codex:rescue 执行 → /codex:review → 修复 → /codex:adversarial-review → 再修复 → 提交

对抗性审查会主动质疑你的设计——比如"为什么选这个缓存策略""回滚方案考虑了吗""这里有没有竞态条件"。高风险改动需要这种压力测试。

Claude 卡住时

如果 Claude 在某个任务上反复尝试都不理想,直接换 Codex 来试:

/codex:rescue 用最小改动修复这个问题

换一个模型的思路,经常能突破僵局。

4. 后台运行(推荐)

审查和 rescue 任务都建议加 --background,不阻塞当前对话:

/codex:rescue --background 实现分页功能

# 继续和 Claude 聊别的事...

/codex:status # 随时看进度

/codex:result # 完成后取结果

/codex:result 会返回一个 session ID,你可以用 codex resume <session-id> 在 Codex 里继续这个任务。

5. 审查门禁(可选)

开启后,Claude Code 在完成任务前会自动触发一次 Codex 审查,发现问题则打断流程先修复:

/codex:setup --enable-review-gate # 开启

/codex:setup --disable-review-gate # 关闭

⚠️ 注意:审查门禁会显著增加 Token 消耗,可能造成 Claude 和 Codex 之间的长循环。建议仅在关键项目中使用,日常开发手动跑 /codex:review 即可。

6. Codex 模型配置

想改变 Codex 默认使用的模型或推理强度,可以在配置文件中设置。

用户级配置:~/.codex/config.toml

项目级配置:项目根目录下 .codex/config.toml

model = "gpt-5.4-mini"

model_reasoning_effort = "high"

也可以在每次调用时通过 --model 和 --effort 临时指定:

/codex:rescue --model spark --effort medium 快速修复 lint 错误

7. 什么时候不该用 Codex

以下情况建议全程用 Claude:

场景 原因

深度业务逻辑重构 Codex 拿不到 Claude 对话中积累的完整上下文,生成的代码可能和项目风格不一致

需要跨文件深度理解的任务 Codex rescue 是独立运行的,不共享 Claude 的对话历史

代码量很少的任务 只有几行代码,没必要委派,直接让 Claude 写更快

8. 实用技巧

简单任务用便宜模型:--model spark 适合修 lint、写样板代码这种不需要深度推理的活

先 review 再 adversarial-review:不要上来就用对抗性审查,先用普通审查过一遍基础问题

善用 --resume:/codex:rescue --resume 可以继续上一次的 Codex 任务,不用从头开始

关注两边用量:虽然整体更省,但记得同时关注 Claude 和 OpenAI 两边的用量,避免某一边意外超支

Skill 冲突处理:如果你的自定义 Skill 和 Codex 插件有触发词冲突,在冲突 Skill 里加 priority: low

常见问题

Q:安装插件后没看到 /codex 命令?

A:执行 /reload-plugins 重新加载插件。

Q:/codex:review 报认证错误?

A:说明 Codex 的认证没配好。请参考 Big Router × Codex 快速开始指南 重新配置,或运行 !codex login 重新登录。

Q:/codex:rescue 和直接让 Claude 写代码有什么区别?

A:rescue 是把任务交给 Codex 独立执行,消耗的是 OpenAI 额度而不是 Claude Token。适合标准化编码任务。但 Codex 拿不到你和 Claude 的对话上下文,所以任务描述要写清楚。

Q:审查结果和 Claude 的判断矛盾怎么办?

A:这恰恰是双模型协作的价值。两边意见不一致时,你作为开发者来做最终决策。

Q:到底能省多少?

A:取决于你把多少编码工作交给 Codex。如果你的工作流中代码生成占比高(比如大量写测试、写 CRUD),把这些都 rescue 出去,Claude 的消耗可以大幅降低。