简体中文 · English
Claude 来做，Codex 验收。
你在 Codex 里提需求。Claude 在副本里动手。
Codex 验收后才交给你。
macOS · Codex 桌面端 · 本机 Claude Code
开始使用 ·
使用示例 ·
反馈问题
同时用 Codex 和 Claude，常要在两个窗口之间搬需求、代码和审查意见。这个插件让你只待在 Codex 里。你说目标，Codex 把你的原话、相关文件和它的理解分开交给本机 Claude Code。Claude 交回报告和改动，Codex 验收。
你提需求 → Claude 动手 → Codex 验收 → 交给你
| 功能 | 说明 |
|---|---|
| 写代码 | Claude 在副本里改，自己跑测试 |
| 审查评估 | 先给结论，再给依据 |
| 中途沟通 | Claude 有问题当场问，Codex 能答就答 |
| 看进度 | 工作台里随时看做到哪 |
| 接着改 | 在原对话补充，下一轮接着做 |
- Codex 桌面端：已登录，版本支持插件。安装说明
- Claude Code：已装在本机，能登录，有额度。插件直接用你本机这份 Claude Code，不另外下载、更新或切换版本。安装和登录说明
- uv：插件用它准备运行环境。安装说明
面向 macOS。每个任务都要用 macOS 自带的 sandbox-exec 保护你的项目目录。它不可用时（不是 macOS，或 Codex 运行在另一层沙箱里），插件会拒绝开工并说明原因。Intel Mac 尚未单独验证。
在终端里依次执行：
codex plugin marketplace add https://github.com/BryanYue/codex-claude-orchestrator.git --ref v1.1.1
codex plugin add codex-claude-orchestrator@codex-claude-team第一条添加插件来源，第二条安装插件。仓库公开，不需要 GitHub 邀请或登录。旧版本标签保持冻结。固定 ref 不会自动升级，切换版本请按版本切换步骤操作。
首次安装还要准备依赖，再打开新的 Codex 任务。 如果你不熟悉终端、遇到 codex: command not found，或以前装过本地版本，请按一步一步的安装指南操作。
在 Codex 中打开你的项目，新建任务，发送下面这段话。把文件名换成项目里的实际文件：
用 Codex–Claude 协作插件，让 Claude 看看 README.md 的安装步骤，新手最容易卡在哪里？先不要改文件，你核对它的结论后告诉我。
这会真实调用 Claude，用的是你的 Claude 额度。你会看到执行进度、Claude 的报告和 Codex 的验收结论。Claude 交回报告不等于完成，Codex 验收后才算。
按计划写
按 docs/plan.md 第二阶段，让 Claude 实现导出改异步。完成后你检查改动、跑测试，没问题再应用到项目里。
问个问题
让 Claude 评估一下把会话存储换成 SQLite 是否可行，重点看并发和迁移成本。先给结论。
审查改动
让 Claude 审查当前未提交的改动，只看错误处理和测试覆盖，在副本里复现它怀疑的问题。
运行中沟通
Claude 中途问到的不影响主流程的事你直接定，涉及需求取舍的再问我。
告诉正在做的 Claude：导出的文件名改用日期开头，不用等它做完。
Claude 遇到不先确认就会做错的问题，会停下来等回答。Codex 在你已经给的授权内直接回答；涉及核心需求、验收冲突或超出授权的，才转给你。你的回答原样交给 Claude，并标明是你说的。不影响继续工作的说明，Claude 留下后接着做。任务还在跑时，你也可以随时补充信息或让它改方向。
纠正方向
这里理解错了：保留原来的登录流程，只修改错误提示。让 Claude 在上一轮的基础上改。
看进度
打开这次任务的工作台。
文件名和任务内容只是示例，换成你自己的即可。
- 任务书：最前面是你的原话，一字不改。后面依次是附件（规格、计划等）、Codex 的说明、约束和完成标准。Codex 的说明会标明“可能有误”。每条约束都标明来自你、附件还是 Codex。任务书写明冲突时谁优先。下一轮会原样追加你的新原话，并带上 Codex 的修正和逐项验收。Claude 实际收到的任务书，可以在工作台里逐字查看。是否先列计划由 Claude 按任务复杂度决定，不需要开工确认。
- 工具：两种模式下 Claude 都能用 Claude Code 自带的全部工具，权限模式为 auto。插件不设工具白名单或黑名单。保护你的项目靠 macOS 写保护，不靠藏起工具。
- 副本模式（默认，Git 项目）：Claude 在你项目的独立 Git 副本里工作。副本取自项目当前状态，含未提交改动。Claude 可以编辑、运行命令和测试。原仓库、它的
.git和插件的运行记录由 macOS 拒写。网络、凭证和其他本机路径不隔离。.env、.claude、.codex、.ssh等敏感的未跟踪文件不会复制进副本。 - 只读模式：Claude 直接在原目录里工作。原目录（Git 项目含
.git）和插件的运行记录由 macOS 拒写，写入会失败。Claude 可以读文件、搜索、运行只读命令。报告通过结构化结果交回。适合普通文档目录，或需要直接在原目录分析时。 - 写保护是前提：两种模式都要 macOS
sandbox-exec真正可用。不可用时插件拒绝开工，不会退回到只靠任务书提醒的保护。 - 联网：经你同意才联网。这是写在任务书里的授权：没同意时，任务书要求 Claude 不联网，但插件不在技术上断网。
- Claude 配置：Claude 照常加载你的全局和项目
CLAUDE.md、rules、hooks、MCP 服务器和技能，以及组织设置。插件会列出本次加载的指令文件和 hooks。任务书里写明：与任务书冲突时，以任务书为准。
- 每个 Codex 对话一个工作台页面。本对话的任务和每一轮都在这一页里切换。同一个任务接着做的各轮放在同一张卡里，包括从 1.0.x 接着做的早先轮次；同名但不是接着做的任务分开显示。
- 对话里第一次派单时，页面自动打开一次。之后重新连接、对话压缩、开新一轮或链接变了，都不会再自动打开。要看时说“打开工作台”，或点击 Codex 给出的链接。插件只保证自己最多自动请求一次；Codex 实际开了几个标签页，插件无法确认。
- 任务名是 Codex 写的一句短话，不再照搬你原话的开头。每一轮另有一句话说明这一轮做什么。你的原话仍逐字保存在任务书里。1.0.x 留下的轮次保持原来的标题，但这个标题不会沿用到新一轮：从 1.0.x 接着做时，Codex 应在第一次续接时补一个短标题，没补的话新一轮显示任务编号。
- 列表和详情分开显示项目、任务、第几轮（含这一轮的说明）和状态。
- Claude 在等回答时，「Claude 在等回答」提示排在最上面，任务卡片显示「等回答」。回答要在 Codex 对话里给，页面不能回复。
- 顶部一句话说明现状，例如「Codex 验收：改后通过，下一步：再做一轮」或「Claude 正在做 · 已用 3 分钟」。
- 运行结束后仍有要你决定的问题时，蓝色框「Claude 有问题问你」排在最上面。
- 下面分三块：运行情况（进程怎么结束）、Claude 自评（它说做完没有）、Codex 验收（通过、改后通过或退回，以及下一步）。
- 提醒用中文写明，例如改动碰了受保护路径。技术细节默认折叠。
- 详细资料有报告、本轮改动和过程记录。过程记录列出 Claude 用了哪些工具、读写了哪些文件、中途的问答，以及 Codex 中途发的补充和打断：显示正文和来源（Codex 协调者或用户原话）。任务书、你的原话等放在「更多」里。
- 页面只用来看。回答 Claude、补充要求、纠正方向和继续任务，都在 Codex 对话里进行。Codex 面板较窄时，任务列表收进左上角「任务」按钮。
花谁的额度？
需要你自己的 Codex 和 Claude Code 使用权限。插件不提供、也不共享账号。Claude 实际执行和在线检查，用的是你的 Claude 额度。只查看本地状态，不会发起模型请求。
代码会发到哪里？
交给 Claude 的任务书和它读取的文件，会通过你的 Claude Code 配置发给相应的模型服务。工作台和运行记录保存在你的电脑上（默认 ~/.codex/claude-orchestrator/v1），运行中的问答和回执也在本机（默认 ~/.codex/claude-orchestrator/v2）。哪些文件可以交给模型，请按项目要求决定。
会改我的项目吗？
不会直接改。Claude 只改副本。插件整理好改动，Codex 验收后用 git apply 应用到你的项目。插件不自动合并、提交或发布。
做的时候我能改项目吗？
可以。副本模式下 Claude 不在你的项目目录里工作。如果期间项目有变化，结果里会提示。Codex 应用改动前，会先检查改动能否无冲突地应用。
Claude 中途提问时会怎样？
Claude 停下来等回答，这次执行的其他进程也一起暂停。Codex 能在授权内判断的直接回答，其余转给你。等你回答期间 Claude 一直暂停；到任务时限仍没回答，这一轮按超时结束，未回答的问题会列在结果里。
两个 Codex 对话会互相干扰吗？
不会。每个对话有自己的工作台页面。两个对话即使用了相同的任务名，查询、回答、取消和验收也只作用在自己的任务上。
Codex 重启了怎么办？
正在跑的任务会继续运行。重新连接后，用原来的任务编号查询即可。如果负责监督的进程意外退出，插件会停掉残留的 Claude 进程，把这一轮记为「失联」，并收回已经写下的报告和改动。
工作台链接会变。Codex 或插件重启后，工作台换了新的端口和访问令牌，已经打开的旧页面连不上，会一直显示「暂时连不上，正在重试」。这时在 Codex 里说“打开工作台”，或点击 Codex 回复里的新链接。插件不会自动再打开页面，旧页面也不能自己换成新链接。只是短暂断线的话，旧页面会自己恢复。
费用怎么算？
工作台上显示为「约 $X（Claude 估算）」。这是 Claude 客户端的估算，不是实际扣费，也不是订阅剩余额度。它是整个 Claude 会话的累计值，包含子代理。续接的轮次可能把之前轮次也算进去。
从 1.0.x 升级要注意什么？
1.0.x 开始的任务可以在 1.1 里接着做，只是这些旧轮次没有运行中沟通。升级后，每个对话第一次收到 1.1 的回复时，工作台可能自动打开一次。
从 0.7 升级要注意什么？
1.0 起不兼容 0.7 的旧任务。旧的运行记录留在原目录供查阅，但不能续接。项目采用、自动选择执行者和协作说明在线管理已移除。详见更新记录。
| 想看什么 | 去哪里看 |
|---|---|
| 安装入门 | 中文指南 · English guide |
| 更新回退 | Git marketplace 说明（英文） · 安装与恢复 |
| 进阶用法 | 进阶说明（中文） |
| 版本记录 | 更新记录（中文） · 验证记录（英文） |
当前版本：v1.1.1。
1.1.1 修复了等待后台 Bash/Monitor 结果时过早收口的问题，并已在当前 Codex 安装后通过原生验收。1.1 系列支持：
- Claude 有严重问题时当场问，执行暂停到 Codex 回答。Codex 能答的直接答，涉及核心需求或超出授权的才问你。
- 任务还在跑时，Codex 可以补充信息，或打断当前这一步改方向。每条回复都有回执。
- 每个 Codex 对话一个工作台页面，只自动打开一次。
- 任务有 Codex 写的短标题，每一轮有一句说明。
- Claude 使用 Claude Code 自带的全部工具，两种模式都靠 macOS 写保护保护你的项目。
- 是否先列计划按任务复杂度决定，不再一律确认。
1.1.1 能接着做 1.0.x 开始的任务。本版不包括 Go 重写、迁移到 Agent SDK、新的认证或计费方式和分布式调度。
v1.0.1（2026-10-15）改进了工作台：
- Codex 面板较窄时，任务列表收进「任务」按钮，详情占满宽度。
- 顶部一句话说明现状，文案全部改成日常说法。
- 过程记录列出 Claude 每一步用了什么工具、读写了哪些文件。
v1.0.0（2026-10-08）是一次断代重构：
- 任务书改为按角色写的 Markdown，你的原话逐字直达 Claude。
- 实现任务改到独立副本里执行，交回改动。
- 插件只报告事实和警告，不再替 Codex 判定失败。
具体变化见更新记录。已执行的验证和未验证的范围，见验证记录。
由 BryanYue 维护的社区项目，与 OpenAI、Anthropic 无官方隶属关系。当前未指定开源许可证。欢迎通过 Issues 反馈体验或提出建议。