本地桥 · Claude Code ⇄ Codex

多个 AI agent，会话内通信，
不再复制粘贴。

AgentBridge 是一个本地桥接工具，让 Claude Code 和 Codex 在同一个工作会话里实时协作：互相 review 对方的 diff、把任务拆给彼此、额度撞线时把活儿交给对方接力。

npm install -g @raysonmeng/agentbridge

MIT 开源·纯本地运行·零运行时依赖·1,700+ 测试·v0.1.25

这能换来什么

三种工作流

来自不同厂商的两个完整 agent 互相盯着对方干活，你只负责掌舵。悬停任意一张卡看完整例子。

会话内交叉 review

Codex 写实现，Claude 在同一个会话里实时 review 它的 diff，把修改意见直接推回 Codex 的 thread。两个厂商互相把关，不用复制粘贴。

交叉 review
codex  → 限流写完，改 3 个文件
claude → 正在 review diff…
claude → reply：重试没上限
codex  → 已修 — 封顶 5 次
交叉 review — 完整过程
你     → 让 Codex 给 API 客户端加限流
claude → 任务已经过桥发给 Codex
codex  → 令牌桶限流实现完毕 — 改动 3 个文件
claude → 会话内实时 review diff…
claude → reply：429 之后的重试循环没有上限；
         上游一抖动，这里就变成死循环
codex  → 好眼力 — 封顶 5 次，加指数退避
claude → 复审 ✓ 通过。两个厂商互相把关，零复制粘贴。

一句话就能拆分任务

让任意一方向另一方提出分工方案，两个 agent 先商量谁做什么，再动手写代码。你掌舵，它们协调。

任务拆分
你     → 重构怎么分工？
claude → 我做 token + 测试，
         Codex 做中间件，行吗？
codex  → 同意 — 这就开工
任务拆分 — 完整过程
你     → 就这个鉴权重构，和 Codex 商量个分工
claude → 方案：我做 token 模型 + 它的测试；
         Codex 重写中间件层。同意吗？
codex  → 同意 — 这就开始写中间件
claude → token 模型完成 — 接口说明已推给 Codex
codex  → 中间件完成；直接用了 Claude 的 TokenClaims 类型
claude → 两半合并。一句话，两个 agent，零搬运。

额度接力，通宵长任务不中断

当一方的订阅额度窗口跑空，它会在回合边界干净停下，把任务交接给另一方，长任务继续推进。

额度接力
codex  → 5 小时窗口告急
bridge → 检查点已写，
         交接给 Claude…
claude → 从检查点续跑
bridge → 稍后自动续 Codex
额度接力 — 完整过程
codex  → 5 小时窗口只剩 4% — 本轮干净收尾
bridge → 检查点已写入 → .agent/checkpoint.md
bridge → 任务交接给 Claude，上下文完整保留
claude → 从检查点续跑 — 继续做迁移
         ⏳ 两小时后 — 额度窗口刷新
bridge → Codex 额度已刷新 — 自动续跑已排队
codex  → 在原来的 TUI 里把任务捡回来接着干
claude → 通宵任务扛过两次额度撞墙。零人工干预。

多项目多开，天生支持

每个项目文件夹一对。同时干三个仓库？三座桥并排跑，端口按对自动分配，--pair <名字> 指定其中一对。

多开
~/work/shop   → pair 1  claude ⇄ codex  :4510
~/work/api    → pair 2  claude ⇄ codex  :4520
~/oss/bridge  → pair 3  claude ⇄ codex  :4530

额度接力

别的工具没有这一环

长任务不该因为某个 agent 半夜撞上 5 小时或每周订阅上限就断掉。AgentBridge 让它继续跑。

不在中途硬切

临近额度硬线时，配套的 agent-quota-guard 不会在工具调用中途拒绝。它让当前 turn 收尾，在回合边界干净停下，写入 .agent/checkpoint.md，并留下一条 bridge 能感知的 pending 记录。

自动续接

暂停一方的额度窗口刷新后，bridge 会在原来的交互式 TUI 里续接任务：Codex 通过排队的 turn/start 注入，Claude 通过它用 ack_resume 确认的 channel push。幂等墓碑保证每次续接最多注入一次。

两个窗口一眼看清

daemon 轮询两个 agent 账户级的 5 小时和每周额度。abg budget --json 打印实时快照：两个窗口、两侧的用量偏差、以及暂停状态。

可选功能。额度接力依赖配套的 agent-quota-guard，装上即启用。不装它，其余功能照常工作。

定位

为什么用 AgentBridge，而不是……

大家通常拿另外三种方式凑合，每一种都会把一部分活儿甩回给你手动做。

  AgentBridge 双开终端 + 复制粘贴 单向委派插件
（如 codex-plugin-cc）		 外部编排器
消息传递 自动，双向 你就是那根消息总线 请求进、响应出 每一跳都要写脚本
顶级 coding agent 的原生能力 完整保留：两边都是未经修改的原生 CLI 本体 保留：但靠你人肉当胶水 打折：被调方是一次性子进程 丢失：agent 被降级成被驱动的工人
两个 agent 都作为对等体在线 是：持久对等体 在，但彼此断开 否：一个宿主一个被调方 否：一个大脑 N 个工人
turn 进行中途推消息 可以：review 中途送达 靠手动，还得猜时机 只能在调用边界 只能在预定步骤
agent 自己提分工 可以：它们自己商量 不能 不能 不能：自上而下
扛得住额度撞线 行：检查点 + 自动续接 不行：得你手动重启 不行 看你脚本写得怎么样

快速开始

四步跑起一对 agent

daemon 需要时自动启动，重启后自动重连。

01

装 Bun（运行时，只有 Node 跑不起来）

curl -fsSL https://bun.sh/install | bash
02

装 CLI

postinstall 会尽力自动注册 Claude Code 插件市场并安装插件（需要本机已有 bun 和 claude）。

npm install -g @raysonmeng/agentbridge
03

启动带 AgentBridge channel 的 Claude Code

abg claude
04

另开一个终端，启动接入同一 bridge 的 Codex

abg codex

你的第一次协作：两边都跑起来后，对 Claude 说：「就 <某个任务> 和 Codex 商量个分工，然后让 Codex 实现它那部分，你来 review。」 你会看到分工方案流进 Codex 的会话、Codex 开始干活、干完后又推回 Claude 这边等 review，全程你不用手动搬运一句话。

abg 是 agentbridge 的短别名。两个 agent 默认以最高权限启动，好让无人值守的一对不必逐条问你。加 --safe 恢复正常权限提示。如果 abg 装好却跑不起来，看排错指南。

来历

AgentBridge 本身就是它自己的概念验证

我们没按常规方式写它。

这个工具很大程度上是 Claude Code（Anthropic）和 Codex（OpenAI）通过它自己协作写出来的，它们正是在用这座桥搭这座桥。其中一个 agent 写的每一个 PR，都由另一个 agent review。一位人类开发者掌舵：分派任务、审阅进度、指挥两边并行工作、互相把关。

来自两个不同厂商的 AI agent，实时相连，并肩写代码，还隔着这根线互相 review PR，提交历史里有实打实的记录。

路线图

Claude Code ↔ Codex 今天已可用。接下来是这些。

正在测试 · 已在分支

多机 agent 网络

不同机器上的 agent 通过局域网或 tailnet 加入同一个房间：口令门禁、成员在线状态、共享白板。真实三机跨网测试已经打通，实验命令 abg room / join / broker 已可用。

下一步 · 公开投票

更多 agent 上桥

OpenCode、Gemini CLI、openclaw、hermes，一次接一个，每个都是一等对等体。先接谁由你决定：去 issue #212 投票。

设计中

能力网格

从互发消息升级到互调能力：每个上桥的 agent 公开自己的 command、skill 和 MCP 工具，对方可以直接调用，默认自带权限门。聊天桥 → agent 总线。

持续

更精细的协作

更少噪声、更好的回合纪律、更丰富的协调策略，以及跨运行时更强的恢复语义。

常见问题

常见问题

abg 装好了却跑不起来？

大概率是没装 Bun。AgentBridge 的 daemon 和插件服务跑在 Bun 运行时上，只有 Node.js 不够。用 curl -fsSL https://bun.sh/install | bash 装好，再重新执行 abg claude。这是最常见的安装失败原因。

支持 Windows 吗？

暂未正式支持。目前跑在 macOS 和 Linux 上。WSL2 可能可用，但未经测试、不做支持。

安全吗？--safe 是干什么的？

默认 abg claude 带 --dangerously-skip-permissions、abg codex 带 --yolo 启动。这是有意为之：无人值守的一对 agent 没法逐条停下来问你权限。代价是两个 agent 可以不经确认执行命令、改文件，所以只在你信任的工作区里这么用。加 --safe（或设 AGENTBRIDGE_SAFE=1）恢复正常权限提示。它是本地开发工具，不是隔离不可信工具的安全边界。

额度接力到底怎么工作？

装上配套的 agent-quota-guard 后，daemon 轮询两个 agent 的 5 小时和每周订阅额度。临近上限时，guard 让当前 turn 收尾、在回合边界干净停下、写入 .agent/checkpoint.md、留下一条 pending 记录。等窗口刷新，bridge 在原来的交互式 TUI 里自动续接：Codex 靠排队的 turn/start，Claude 靠一条被确认的 channel push。

支持哪些 agent？

目前已上线的会话内集成连接的是 Claude Code 和 Codex。下一个接哪个由公开投票决定，见 issue #212（OpenCode、Gemini CLI 等都是候选）。

和 codex-plugin-cc 有什么区别？

openai/codex-plugin-cc 这类单向委派插件是宿主调用 Codex、拿一个结果回来：请求进、响应出，对面没有常驻对等体。AgentBridge 让两个 agent 都作为持久对等体在线，任意一方都能在对方 turn 进行中途推消息（review 意见能在对方还在干活时就送达），而不只是在调用边界。

用 AgentBridge 本身需要账号或 API key 吗？

不需要。它是本地工具，零运行时依赖，也没有任何托管服务。你用现成的 Claude Code 和 Codex 登录即可；AgentBridge 只在你机器上转发它们之间的消息，原始工作内容不出本机。

能同时跑多对吗？

能。每个项目目录一对 Claude+Codex，端口按 +10 步长从 4500 分配。在支持 pair 的命令上用 --pair <名字> 指定某一对。