Codex × Claude Bridge

把一个需求，变成有分工、有进度、有验收的 AI 协作任务。

第一次使用 · 最佳实践 · 功能与限制

这个项目有什么意义？

当你同时使用 Codex 和 Claude Code，常见的协作方式是：在一个窗口想方案，复制到另一个窗口执行，再把结果复制回来检查。本项目把这条沟通链接起来。

你告诉 Codex 目标、工作目录和验收条件，它就能向 Claude Code 下达任务，读取进度，安排审查，核对实际改动，并继续修复或完成交付。

执行模型默认沿用你当前的 Claude Code 配置。你可以结合 Codex 的规划能力与自己配置的执行模型；具体用量与成本需按实际运行观察，项目不承诺固定节省比例。

Related MCP server: codex-claude-subagent

没有 Orca，能不能用？

能。第一次使用建议直接选择普通终端，不需要安装 Orca。

插件会创建自己的 Claude Code 可见窗口。新实现任务使用独立 Git 工作树，你可以看到 Claude 工作，Codex 可以串联实现、审查、返工和验收合并。

“工作树”可以理解成同一仓库的另一个工作目录与分支：Claude 先在里面实现，验收通过后再合并回目标分支。详细实现范围

配图为 AI 生成的概念示意，不是实际软件截图。

Orca 是什么？为什么有人会安装它？

Orca 是一款面向 AI 编程代理的桌面工作台，将多个项目、终端、代码差异和 Git 工作树放在同一个界面中；可以在其中运行 Claude Code、Codex 等工具。官方终端说明

如果你经常开多个 AI 会话，或者已经在 Orca 里使用 Claude Code，它可以帮助你集中查看和管理这些窗口。本插件则通过 Orca 的 CLI 向其中的 Claude 终端发指令、读取结果。

Orca 是可选的工作台，不是模型，也不是本项目必须依赖的软件。

需要 Orca 时再从 官网 安装。它自身能管理工作树，不代表本插件的 Orca 后端已经接上所有协作能力。

现在能做到什么程度？

支持 Windows 与 macOS（Apple Silicon／Intel），同一源码包。当前提供25个工具；CI覆盖四个平台标签与Node 22／24，并运行真实PTY探针。Mac GUI、首次授权及你的模型需实机确认。Mac安装与验收 · 验证范围

让 Codex 把用量花在判断上

默认采用中频协作：Claude 按约定里程碑交付，Codex 再介入。你可以直接说：

这项任务改成低频：让 Claude 连续完成一批实现，再独立审查和验收。重复失败、求助或方向变化及时告诉你。

普通进展由本地观察器处理，无变化不启动模型。关键决策保持原思考等级；必要的轻量同步使用真实 low 参数和本地摘要。三档都保留异常升级。阶段材料保存到 Git 忽略的 .协作记录/，历史和实时正文仍可追溯。

档位控制介入边界，不能保证账单下降；上下文、缓存、全局技能与返工也影响用量。协作档位与用量

0.19 的协作修复

统一短进度摘要一次区分原生／Orca、会话、目录与交付快照。重复观察返回结束提示，用户主动查询仍可读取实时细节。审批升级记录保留，续接失败可查分类诊断；默认不限时，用户主动设置的执行预算排除明确等待。本次验证

0.19.1：人类插话后继续管理。 Codex 暂停写入并保持观察，人类任务完成后理解新增意图再接续；新增最新调度故障、观察心跳与通知回执诊断，修复 Windows 中文提醒和 Orca 旧输入重复识别。协同与排障

怎么开始？

先准备：Codex、Claude Code、Node.js 20+、Git。本文安装命令使用 Codex CLI；Windows 普通终端窗口还需要 Windows Terminal、PowerShell 7，Mac 使用系统 Terminal。Claude Code 必须已能使用你的当前登录或模型配置工作。

git clone https://github.com/lordfine/codex-claude-bridge.git
cd codex-claude-bridge
codex plugin marketplace add .
codex plugin add claude-code@codex-claude-bridge

安装后重新加载 Codex 插件／MCP 实例，让 Codex“检查 Claude 协作插件环境”。首次准备终端需要本机 npm 下载依赖。完整准备步骤与排查

第一次先做一个小任务：

工作区是〈一个已保存当前改动的 Git 仓库绝对路径〉。请通过普通终端让 Claude 只修改 README，补充项目环境准备说明。不要改业务代码。你检查改动并告诉我结果，先不要合并。

之后再尝试：

让 Claude 在独立工作树实现〈目标〉，安排独立审查，满足〈验收条件〉后合并。遇到业务取舍先问我。

你无需记住工具名称或编写 MCP 参数；插件技能指导 Codex 选择对应入口。

几条值得先记住的最佳实践

1. 任务写清楚：目标、允许修改的范围、验收条件，比一句“把它优化一下”更容易交付。

2. 先单任务，再并行：拆分能独立实现的工作；多人改同一文件时交替操作。

3. 先验证当前模型能独立工作：插件继承配置，不帮你切换 CCswitch 或修复供应商连接。

4. 检查实际改动：Claude 说完成、终端显示空闲，都不能代替验收。

5. 明确交付边界并开启事件续接：派发后让 Codex 结束当前轮，Claude 交付或求助再续接；减少反复询问“现在做完了吗”。

完整最佳实践与可复制任务模板

文档与反馈

问题与建议通过 Issues 提交，附版本与脱敏复现步骤。

独立维护，采用全新提交历史。沿用源码的版权与 MIT 许可 保留；见 项目来源。