Codex / Claude Code · 进阶

Claude Code 用 Opus 4.7，Codex 用 GPT-5.5 协同完成项目

把 Claude Code 当成现场编辑、方案复核和体验检查，把 Codex 当成长任务执行、全仓库修改和构建验证，两边用任务卡交接。模型名不是流程核心，关键是角色分工和验收交接。

  • Claude Code
  • Codex
  • Opus 4.7
  • GPT-5.5
  • 协同
更新于 2026-05-17

一句话结论

Claude Code 负责看懂需求、拆方案、改小块和复核体验；Codex 负责跨文件落地、跑构建测试和部署验证，中间用一张任务卡交接就够了。

适用场景

  • 想让 Claude Code 和 Codex 一起完成一个网站、脚本、知识库或自动化项目
  • Claude Code 改得快但长任务容易散，Codex 能跑长任务但需要清楚边界
  • 希望一个 Agent 负责方案和体验，一个 Agent 负责工程落地和验证
  • 项目已经有线上站点或生产服务，不能让两个工具同时乱改

常见现象

  • 两个工具同时开，结果互相改同一批文件
  • Claude Code 说完成了，但没有 build、测试或线上验证
  • Codex 跑很久，却在做 Claude Code 已经做完的内容
  • 交接只写一句继续，下一位 Agent 不知道前面做过什么

原因解释

  • 两个 Agent 都有代码能力，但没有固定角色就会抢同一块工作
  • 模型越强越需要边界：文件范围、验收命令、禁止触碰区域都要写清楚
  • 协同的关键不是让两个模型同时发挥，而是让一个负责判断，一个负责落地，再互相复核
  • Opus 4.7 和 GPT-5.5 的名字按你本机可选模型写；如果客户端里名字不同，用同等级最强代码模型替换，流程不变

解决步骤

  1. 先定角色：Claude Code 用 Opus 4.7 做需求澄清、方案拆分、局部原型、UI/文案复核；Codex 用 GPT-5.5 做跨文件实现、批量重构、构建测试、部署验证。
  2. 第一轮只让 Claude Code 输出任务卡，不急着大改代码。任务卡必须包含目标、用户、路由、文件范围、不准碰的区域、验收命令。
  3. 把任务卡交给 Codex，要求它先读项目结构，再按文件范围实现，完成后必须运行 build、测试或线上检查。
  4. Codex 完成后输出四件事：改了哪些文件、验证命令结果、线上或本地地址、剩余风险。
  5. 把 Codex 的结果交回 Claude Code 做体验复核，重点看文案是否小白能懂、界面是否一致、是否有明显 AI 直出味。
  6. 最后只让一个 Agent 负责部署，另一个只做复核，避免两个 Agent 各自部署不同版本。

可复制命令

# 给 Claude Code 的首轮提示词
你是这个项目的产品和体验负责人。本轮先不要大面积改代码。

项目路径：<填项目路径>
目标用户：<填谁会用>
本轮目标：<填要做成什么>
模型：Opus 4.7（如果客户端名称不同，用 Claude Code 里最强代码模型）

请先完成：
1. 阅读项目结构、路由、数据源、构建方式。
2. 输出一张任务卡，写清要交给 Codex 的文件范围和验收命令。
3. 标出不准触碰的目录、线上服务、密钥和用户已有改动。
4. 给出小白能看懂的页面文案方向。

输出格式：
- 目标
- 要改的页面/路由
- 建议修改文件
- 禁止触碰区域
- 交给 Codex 的任务
- 验收命令
- 复核重点
# 给 Codex 的执行提示词
你是工程执行负责人。如客户端可选 GPT-5.5，就选 GPT-5.5；否则选当前最强/最稳代码模型。

请根据下面这张 Claude Code 任务卡落地实现：
<粘贴 Claude Code 任务卡>

要求：
1. 先完整检查项目结构、路由、数据源和构建脚本。
2. 只修改任务卡允许的文件，不要碰禁止区域。
3. 修改完成后运行验收命令，例如 npm run build / npm run test。
4. 如果是静态站，确认 dist 里对应路由 HTML 能直接搜到核心正文。
5. 如果需要部署，只部署指定项目，不要碰其他站点。

最后输出：
- 改了哪些文件
- 新增/修改了哪些路由
- build/test 是否通过
- 线上或本地验证结果
- 仍然需要 Claude Code 复核的点
# Claude Code 和 Codex 交接卡

## 本轮目标
<一句话写清楚>

## 已完成
- <文件/页面/功能>

## 已验证
- 命令：<npm run build 等>
- 结果：<通过/失败>
- 地址：<本地或线上 URL>

## 禁止触碰
- <生产服务、密钥、无关项目、用户已有改动>

## 下一位 Agent 要做
1. <继续项 1>
2. <继续项 2>

## 风险
- <还有什么不确定>
# 在 Claude Code 里安装 OpenAI Codex 插件
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

# 常用命令
/codex:review --background
/codex:adversarial-review --background 检查这个实现有没有隐藏风险
/codex:rescue --background 修复当前失败的测试
/codex:status
/codex:result
# 轻量版：每次 commit 后让 Codex 做一次独立 review
# 注意：不同 Codex CLI 版本命令可能不同，先用 codex --help 确认 review 子命令是否存在。
cat > .git/hooks/post-commit <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
mkdir -p /tmp/agent-reviews
codex review HEAD~1..HEAD --quiet > /tmp/agent-reviews/codex-review.md || true
EOF
chmod +x .git/hooks/post-commit
# AGENTS.md（两边共享的核心规则）

## 项目目标
这个项目要服务谁、解决什么问题。

## 常用命令
- 构建：npm run build
- 本地预览：npm run preview

## 禁止触碰
- 不要打印 token
- 不要改生产数据库
- 不要回滚用户已有改动

## 验收标准
- build 通过
- 关键路由能访问
- 主要正文能在 HTML 源码中搜到

# CLAUDE.md（Claude Code 专属薄壳）
@AGENTS.md

## Claude Code 专属
- 先做体验复核和任务拆分。
- 大范围修改交给 Codex 前，先输出任务卡。

仍然不行怎么办

  • 如果两个工具都在改同一批文件，先停一个，只让 Codex 做工程合并，Claude Code 做阅读复核。
  • 如果 Claude Code 和 Codex 给出相反方案，按真实验收命令和线上结果决定，不按谁说得更像专家决定。
  • 如果模型名在你的客户端里不可选，用同等级的最强代码模型替换，角色分工和交接方式不变。
  • 如果项目涉及生产部署、密钥、数据库或付费接口，先让一个 Agent 写风险清单，再决定是否执行。

推荐分工

  • Claude Code：适合做需求澄清、文件局部理解、UI/文案复核、调试解释、短回合迭代。
  • Codex：适合做跨文件实现、长任务执行、构建测试、批量重构、部署前检查。
  • Claude Code 不要长期独占工程执行，容易边聊边改散；Codex 不要在需求不清时硬跑，容易跑偏。
  • 真正稳的方式是：Claude Code 出任务卡，Codex 落地，Claude Code 再复核。
  • 如果安装了 openai/codex-plugin-cc，可以让 Claude Code 直接调用 Codex 做 review、adversarial review 和 rescue；如果你主用 Codex，也可以用类似 cc-plugin-codex 的反向方案让 Claude Code 做 review。

外部社区里最常见的 6 个共识

  • 插件路线正在成型：OpenAI 的 codex-plugin-cc 已经把 Codex review、adversarial-review、rescue、status、result 这类动作放进 Claude Code 工作流里。
  • 反向路线也有人做：在 Codex 里调用 Claude Code 做 review / rescue，适合主工作台是 Codex、但想借 Claude 复核的用户。
  • 共享规则文件很关键：AGENTS.md 放通用规则，CLAUDE.md 第一行引用 @AGENTS.md，再放 Claude Code 专属规则，可以减少两套文件漂移。
  • Git hook / Claude hook 是轻量联动：提交后自动跑 Codex review，把结果写到临时文件或 review 文件，让 Claude Code 下一步先读。
  • 长任务要用 manager-worker：一个工具当监工，另一个工具按 TODO 一轮一轮做；每轮新 session，避免上下文爆掉。
  • 多 Agent 不是越多越好：社区反馈里最稳的做法通常是一个主任务文件、一个共享规则文件、一个执行者、一个复核者。

三种可选协同架构

  • 插件架构：Claude Code 是主界面，Codex 通过 /codex:review、/codex:rescue 进入。适合你已经习惯 Claude Code，但希望 Codex 做第二意见和后台修复。
  • 双终端架构：Claude Code 和 Codex 各开一个终端，共享 AGENTS.md、CLAUDE.md、PLAN.md、TODO.md。适合中小项目，最容易排错。
  • 监工架构：Claude Code 只负责启动和观察 Codex CLI，让 Codex 每次执行 TODO 里的下一项，完成后写回进度。适合 4 小时以上的长任务，但必须有清晰 TODO 和停止条件。
  • 反向复核架构：Codex 是主执行者，Claude Code 通过插件或手动命令做设计挑战、边界检查、UI 文案复核。适合 Codex 跑得更顺的工程项目。

一次完整协作流程

  1. 人先写一句目标：我要做什么页面、工具、Bot 或自动化。
  2. Claude Code 用 Opus 4.7（或当前客户端最强模型）读项目，输出任务卡和验收标准。
  3. 人确认任务卡，删掉不该碰的范围。
  4. Codex 用 GPT-5.5（或当前可选最强代码模型）按任务卡执行，完成后运行 build/test。
  5. Claude Code 复核 Codex 的 diff、界面文案和用户路径。
  6. 人确认后由 Codex 或固定部署工具上线。
  7. 上线后把结果写入 Obsidian 或项目记忆，下一轮继续。

长任务监工模式

  1. 让 Codex 先生成 TODO.md，把任务切成 30-60 分钟能完成的小块。
  2. 在 AGENTS.md 里写清：看到 continue 时必须先读 TODO.md，完成一项后更新 TODO.md 和 progress.md。
  3. Claude Code 只负责启动 Codex：运行 codex exec "continue to next task"，观察是否完成，不直接改同一批文件。
  4. Codex 每轮结束必须写三件事：完成了哪项、改了哪些文件、下一项是什么。
  5. Claude Code 每轮只读摘要，不读完整日志，避免自己的上下文被 Codex 输出撑爆。
  6. 连续失败两轮就停下来让人看，不要无限自动重试。

什么时候用 review，什么时候用 rescue

  • review：只看不改，适合 Claude Code 刚完成一批修改后，请 Codex 独立检查 bug、遗漏测试、风险点。
  • adversarial-review：专门挑战方案，适合数据库迁移、鉴权、计费、部署、缓存、并发这类高风险改动。
  • rescue：允许 Codex 尝试修复，适合测试失败、类型报错、构建失败、回归 bug。
  • status / result：后台任务必须用这两个命令收尾，避免你以为它完成了，其实只是开始跑。

不要这样协同

  • 不要同时让两个 Agent 改同一个文件夹，尤其是 styles.css、data.ts、路由入口这类中心文件。
  • 不要让 Claude Code 直接接着 Codex 的一句完成继续做，必须先给它变更清单和验证结果。
  • 不要让两个 Agent 都去部署，线上只认最后一次部署，很容易覆盖掉刚刚验证过的版本。
  • 不要把 token、密码、生产数据库连接串贴给两个 Agent；用环境变量和脱敏日志。
  • 不要把 CLAUDE.md 和 AGENTS.md 写成两份完全不同的长文。越长越容易漂移，越难知道哪个规则正在生效。
  • 不要一上来开启 review gate 或自动钩子循环。它们很有用，但也可能烧额度、卡住会话或形成 Claude/Codex 来回互相改的循环。

验收清单

  • 项目目标是否已经变成用户能点击、能看到、能复制的页面或功能。
  • Claude Code 是否留下清楚任务卡，Codex 是否按任务卡执行。
  • Codex 是否运行了 build/test，并把结果写清楚。
  • Claude Code 是否复核了体验、文案、视觉和小白可读性。
  • 线上页面、sitemap、robots 或关键 API 是否已经验证。
  • 是否写入 Obsidian 或项目记忆，方便下一次 Agent 接续。

参考来源

  • OpenAI codex-plugin-cc：https://github.com/openai/codex-plugin-cc
  • Claude Code with Codex CLI guide：https://github.com/shakacode/claude-code-commands-skills-agents/blob/main/docs/claude-code-with-codex.md
  • Codex 中调用 Claude Code 的反向插件：https://github.com/sendbird/cc-plugin-codex
  • Anthropic Claude Code 关于 AGENTS.md / .agents/skills 的社区 issue：https://github.com/anthropics/claude-code/issues/31005
  • Reddit：Pointing CLAUDE.md to AGENTS.md：https://www.reddit.com/r/ClaudeCode/comments/1r9zx34/pointing_claudemd_to_agentsmd/
  • Reddit：Claude Code + Codex Workflow：https://www.reddit.com/r/ClaudeCode/comments/1sz3u7k/claude_code_codex_workflow/
  • X：Claude Code 监工 Codex 长任务思路：https://x.com/i/web/status/1972200355506135165
  • X：把 CLAUDE.md / MCP / skills 迁移到 Codex 的实践：https://x.com/i/web/status/2048004308793524392
  • X：共享 plan.md 的多代理工作流：https://x.com/i/web/status/2010056896682574065

相关问题

还卡着？

可以把截图、日志、需求单或当前页面链接发到 zhemuy@gmail.com。