博客 · 编程 agent

Claude Code 和 Codex 怎么一起用

可以,Claude Code 和 Codex 配合得很好:让它们各用同一个仓库的一个 git worktree,给两者同一份 AGENTS.md,一个写代码,另一个审查。想要更紧的联动,OpenAI 发布了官方插件,让 Claude Code 能调用 Codex 做审查,也能把任务交给它。这篇指南讲大家把两者组合起来的五种方式、按官方文档命令走一遍的分步设置、两个 agent 怎么互相沟通、同时运行时要留意什么,以及能编排它们的工具。更新于 2026 年 11 月 20 日。

Claude Code 和 Codex 一起用的五种方式

多数人会把其中两三种组合起来用。如果你还在两个 agent 之间犹豫,先看 Claude Code 和 Codex 对比。

方式怎么做适用场景
1. 共用指令一份两个 agent 都读的 AGENTS.md;CLAUDE.md 导入它任何时候都该做。成本最低,还能避免两个 agent 遵守不同的规则
2. 各自的 worktree每个 agent 在同一仓库的独立 git worktree 和分支里工作两个 agent 同时改代码
3. 一个写,一个审Claude Code 写,codex review 检查分支,或者反过来想让第二个模型抓出第一个漏掉的问题
4. 在 Claude Code 里用 CodexOpenAI 的 codex-plugin-cc 给 Claude Code 加上 /codex:review、/codex:rescue 等命令你主要待在 Claude Code 里,想一条命令就用上 Codex
5. 编排工具用看板或应用(Claude Squad、Conductor、Orca、Vibe Kanban、Crewmark)启动并跟踪两者每天都跑好几个 agent,终端多到记不清

1. 给两个 agent 同一份指令

Codex 读 AGENTS.md:先读 ~/.codex 里的一份全局文件,再读从项目根目录一路到当前文件夹的每个 AGENTS.md,同一目录里 AGENTS.override.md 优先。默认累计到 32 KiB 就不再加载更多文件(project_doc_max_bytes)。详见我们的 Codex AGENTS.md 指南。

Claude Code 从 v2.1.277 起也能读 AGENTS.md,但默认只有在当前文件夹及其上级没有 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md 时才会读。如果你的仓库有 CLAUDE.md,就把 @AGENTS.md 放在它的开头,让 Claude 先读共享文件,再在下面加 Claude 专用的规则。符号链接(ln -s AGENTS.md CLAUDE.md)也行,但团队里有人用 Windows 的话,文档推荐用导入。其余内容见 CLAUDE.md 指南。

  • 把构建、测试和 lint 命令、代码风格和“不要碰”的规则写进 AGENTS.md,这样两个 agent 跑同样的检查。
  • 别把某个 agent 专用的内容放进去:Claude 专用规则写在 CLAUDE.md 的导入语句下面,Codex 专用设置放在 ~/.codex/config.toml。
  • Claude Code 会忽略 AGENTS.override.md 和 AGENTS.local.md,所以别把共享规则放在那里。

2. 让它们在各自的 worktree 里运行

两个 agent 改同一个 checkout 会互相覆盖;Claude Code 自己的文档也警告,两个 agent 改同一个文件会导致覆盖。git worktree 是第二个工作目录,有自己的文件和分支,同时共用仓库历史,所以每个 agent 都能在自己的副本里改。

Claude Code 用 claude --worktree <name> 帮你在 .claude/worktrees/ 下创建一个。Codex CLI 有 --worktree 参数,可以在新的受管理 worktree 里启动会话或运行 codex exec,Codex 桌面应用也会为它的任务管理 worktree。两个 agent 都可以直接用 git worktree add。我们的 Claude Code worktree 指南讲了清理、给 .env 文件用的 .worktreeinclude,以及基础分支。

3. 一个写,另一个审

大多数人说“一起用”,指的就是这个模式。来自另一家厂商的第二个 agent 读 diff 时没有第一个 agent 的先入之见,所以能抓到作者漏掉的问题。

  • Codex 审查 Claude:codex review --base main 把分支和 main 对比审查;--uncommitted 审查已暂存、未暂存和未跟踪的改动;--commit <SHA> 审查单个提交。
  • Claude 审查 Codex:把 diff 通过管道交给非交互模式的 claude -p。Claude Code 文档里有同样的思路,写成构建脚本,用 git diff main | claude -p 当审查员。
  • 把审查发现交回给写代码的那个 agent 去修;别让审查者也去改这个分支。

4. 在 Claude Code 里调用 Codex(官方插件)

OpenAI 发布了 codex-plugin-cc,一个 Apache-2.0 协议的 Claude Code 插件,用来“在 Claude Code 里使用 Codex 审查代码或委派任务”。它用的是你机器上已有的 codex CLI,同一个登录、同一份配置、同一个 checkout。你需要一个 ChatGPT 套餐(Free 也算)或 OpenAI API key,以及 Node.js 18.18 或更高版本。用量计入你的 Codex 用量限制。

在 Claude Code 里依次运行 /plugin marketplace add openai/codex-plugin-cc、/plugin install codex@openai-codex、/reload-plugins 和 /codex:setup 即可安装。

  • /codex:review:让 Codex 对未提交的改动做只读审查,加 --base main 则审查整个分支。README 说它等同于在 Codex 里直接运行 /review。
  • /codex:adversarial-review:可以引导方向的只读审查,针对设计选择、取舍和高风险区域。
  • /codex:rescue:通过一个 subagent 把任务交给 Codex,比如排查 bug 或尝试修复;长任务加 --background,用 /codex:status 和 /codex:result 查看。
  • /codex:transfer:把当前的 Claude Code 对话变成一个 Codex 线程,并打印 codex resume 命令,方便在那边继续。
  • 可选的审查关卡(/codex:setup --enable-review-gate)会在 Claude 每次想停下时运行一次 Codex 审查,发现问题就阻止停止。README 警告它可能循环很久,并很快耗尽用量限制,所以只在你盯着的时候打开。

分步设置:worktree、共用指令和审查循环

这是最常见的设置:Claude Code 和 Codex 各在自己的 worktree 里,按同一份 AGENTS.md 开发,合并前互相审查对方的分支。每条命令都来自 Claude Code 文档、Codex CLI 参考或插件 README;审查提示词只是示例。

  1. 写一份 AGENTS.md,并在 CLAUDE.md 里导入

    把共享规则写进仓库根目录的 AGENTS.md。Codex 直接读它。如果你还有 CLAUDE.md,就以导入语句开头,让 Claude Code 读同一个文件。

    # CLAUDE.md:Claude Code 先读 AGENTS.md,再读其余内容
    @AGENTS.md
    
    ## Claude Code
    Use plan mode for changes under src/billing/.
  2. 让 Claude Code 在自己的 worktree 里启动

    Claude Code 会创建 worktree 和对应的分支。它是全新的 checkout,所以要在 worktree 里安装依赖。

    # Claude Code 在自己的 worktree 里:.claude/worktrees/feature-auth,分支 worktree-feature-auth
    claude --worktree feature-auth
    
    # 让 worktree 不出现在 git status 里
    echo ".claude/worktrees/" >> .gitignore
  3. 让 Codex 在第二个 worktree 里启动

    用 git 创建一个 worktree,再用 --cd 让 Codex 指向它,或者用 --worktree 让 Codex 创建受管理的 worktree。

    # Codex 在第二个 worktree 里,用自己的分支
    git worktree add ../project-feature-a -b feature-a
    codex --cd ../project-feature-a
    
    # 或者让 Codex 为一次性任务创建受管理的 worktree
    codex exec --worktree "implement the next step"
  4. 让 Codex 审查 Claude 的分支

    Claude Code 完成后,在 Claude 的 worktree 里对 main 运行一次 Codex 审查;如果装了插件,也可以在 Claude Code 里运行。把审查发现贴回 Claude Code 去修。

    # Codex 审查 Claude 的分支(在 Claude 的 worktree 里运行)
    codex review --base main
    
    # 或者在 Claude Code 里,用 OpenAI 的插件
    /codex:review --base main
  5. 让 Claude Code 审查 Codex 的分支

    把 Codex 的 diff 通过管道交给 Claude Code 的非交互模式,再把审查发现交回给 Codex。

    # Claude Code 审查 Codex 的分支(在 Codex 的 worktree 里运行)
    git diff main | claude -p "Review this diff for bugs and missing tests. List each issue with file:line."
  6. 合并,然后删除 worktree

    照常合并每个分支(或开 PR),再删除不再需要的 worktree。退出会话时,Claude Code 会提示清理它自己的 worktree。

    git worktree list
    git worktree remove ../project-feature-a

Claude Code 和 Codex 能互相沟通吗?

不能像聊天那样直接沟通。两个 agent 都没有通向对方厂商 agent 的内置通道,所以它们通过双方都够得着的东西交流:仓库里的文件和 git 历史、一方在另一方 CLI 里运行的命令,或者两边都读的看板。

  • 通过 CLI:Claude Code 可以把 codex exec 或 codex review 当 shell 命令运行,Codex 也可以运行 claude -p。各自拿到对方的回答作为命令输出。
  • 通过插件:在 Claude Code 里,/codex:rescue 和 /codex:review 把工作交给 Codex,并把结果带回对话。插件由 OpenAI 维护。
  • 通过 MCP:这条路基本已经关上了。Codex 以前可以用 codex mcp-server 作为 MCP 服务器运行;OpenAI 在 Codex rust-v0.154.0 里移除了它,并让集成方改用实验性的 Codex app server,它使用自己的 JSON-RPC 协议。反方向上,claude mcp serve 会把 Claude Code 变成 MCP 服务器,但它暴露的是 Claude Code 的工具(读、改、shell),不是第二个 Claude agent。
  • 通过共享看板:编排工具或 issue 看板保存任务、评论和状态,各个 agent 在那里读写。
  • 跨不了厂商的部分:Claude Code 的 agent teams 和跨会话消息只连接 Claude Code 会话。Codex 会话不能当队友。

Claude Code 和 Codex 能同时运行吗?

能。它们是独立的程序,登录也各自独立,所以可以在同一台机器、同一个仓库里同时运行。Claude Code 用你的 Claude 套餐或 API key;Codex 用你的 ChatGPT 套餐或 OpenAI API key。你要管的是文件和用量。

  • 文件:给每个 agent 各自的 worktree。两个 agent 在同一个 checkout 里会改同样的文件,互相覆盖。
  • 用量:每个 agent 消耗各自的额度。通过 Claude Code 插件交给 Codex 的工作,计入你的 Codex 用量限制。
  • 循环:自动审查循环(比如插件的审查关卡)可能让两个 agent 忙很久,并很快耗尽额度。请在你盯着的时候运行。
  • Claude 这边的并行成本更高:Anthropic 说 agent teams 比单个会话多用不少 token,而且每多一个队友成本就继续增加。

能编排 Claude Code 和 Codex 的工具

如果你每天要启动好几个 agent,一个能帮你创建 worktree、打开终端、展示 diff 的工具能省下很多切换。下面这些都能运行 Claude Code 和 Codex;更全面的对比见 Vibe Kanban 替代方案。

工具功能隔离方式运行在许可证 / 状态
Claude Squad管理 Claude Code、Codex、OpenCode、Amp 等 agent 的终端应用;用 cs -p "codex" 运行 Codex每个 agent 一个 tmux 会话和 git worktree终端(用 Homebrew 安装)开源,AGPL-3.0
Conductor并行运行 Claude Code、Codex、Cursor 和 OpenCode;审查 diff、开 PR、合并每个任务一个工作区和分支Mac桌面应用
Orca运行一整队终端 agent,包括 Claude Code 和 Codex,用你自己的订阅每个 agent 一个 git worktreemacOS、Windows、Linux开源,MIT
Vibe Kanban看板,为每个 issue 用 Claude Code、Codex、Gemini CLI 等启动一个工作区每个工作区一个 git worktree浏览器,或通过 npx vibe-kanban 用桌面应用开源,Apache-2.0;bloop 于 2026 年 4 月停服后由社区维护
Crewmark把 Claude Code 和 Codex 当作长期运行、有角色的 AI 员工,在共享的 issue 看板上协作每个员工是你机器上的独立会话你自己的机器见下文

Crewmark:让 Claude Code 和 Codex 在一块看板上组成团队

上面的工具都围绕一次一个任务设计:启动 agent、审查 diff、合并。如果你想让 Claude Code 和 Codex 连着好几天一起工作,各管一个角色,Crewmark 是另一个选择。

在 Crewmark 里,每个 agent 是一名 AI 员工:一个有角色、长期运行的会话,运行在你自己的机器上。Claude Code 和 Codex 员工原生运行;其他 agent,比如 OpenCode、DeepSeek Harness 和 Gemini,通过 ACP(acpx)连接。工作在共享的 issue 看板上流转,你和员工们可以在上面分配 issue、评论、互相 @ 提及、修改状态。Claude Code 员工就是这样把审查交给 Codex 员工的:在 issue 上 @ 它。员工会按计划(心跳)以及被提及时醒来,所以审查不用你转交就会开始。

它不会取代上面的 worktree 和审查命令;你的员工照样用它们。它加的是围绕这些命令的角色、看板和唤醒机制。背后的思路见多 Agent Harness。

常见问题

Claude Code 和 Codex 能一起工作吗?

能。常见的设置是共用一份 AGENTS.md,每个 agent 各用一个 git worktree,再加一个一个写、一个跑审查的循环。OpenAI 还发布了官方的 Claude Code 插件 codex-plugin-cc,让 Claude Code 能调用 Codex。

Claude Code 和 Codex 一起用,最好的方式是什么?

一个写,一个审。用 Claude Code 在自己的 worktree 里开发,然后运行 codex review --base main(或在 Claude Code 里用 /codex:review),再把审查发现交回去。Codex 写代码时就交换角色。

Claude Code 和 Codex 能互相沟通吗?

只能间接沟通。各自可以运行对方的 CLI(codex exec、codex review、claude -p)并读取输出,Codex 插件在 Claude Code 里传递任务和结果,共享看板也可以承载对话。Claude Code 的 agent teams 和跨会话消息只连接 Claude Code 会话。

我能同时运行 Claude Code 和 Codex 吗?

能,在同一台机器、同一个仓库里都行。给每个 agent 各自的 worktree,免得互相覆盖文件。各自使用自己的套餐或 API key,通过插件交给 Codex 的工作计入你的 Codex 限额。

能在 Claude Code 里把 Codex 当 MCP 服务器用吗?

现在不行了。codex mcp-server 在 Codex rust-v0.154.0 里被移除;OpenAI 现在指向 Codex app server,它不是 MCP。要在 Claude Code 里用 Codex,请改装 OpenAI 的 codex-plugin-cc。

Claude Code 和 Codex 共用 AGENTS.md 吗?

可以共用。Codex 默认读 AGENTS.md。Claude Code 在仓库没有 CLAUDE.md 时会读它(v2.1.277 及以后);如果你有 CLAUDE.md,就以 @AGENTS.md 开头,让两个 agent 遵循同一个文件。

Codex 能当 Claude Code agent teams 里的队友吗?

不能。Agent teams 由 Claude Code 实例组成:一个负责人加若干队友,共享任务列表和邮箱。想把 Codex 带进同一项工作,用 Codex 插件、审查循环,或者能同时运行两者的看板。

哪些工具能让 Claude Code 和 Codex 并排运行?

Claude Squad、Conductor、Orca 和 Vibe Kanban 会在隔离的 worktree 或工作区里启动两个 agent。Crewmark 则把它们当作长期运行的 AI 员工,放在共享的 issue 看板上。

命令和功能已于 2026 年 11 月 20 日对照 Claude Code 文档、Codex 文档和 CLI 参考,以及 codex-plugin-cc 的 README 核对。

让 Claude Code 和 Codex 在同一个团队里。

Crewmark 给每个 agent 一个角色、一块共享的 issue 看板和定时唤醒,它们之间交接工作,不用你在终端之间复制粘贴。

Crewmark 是开源的:去 GitHub 点个 Star