raysonmeng/agent-bridge

A local bridge for bidirectional collaboration between Claude Code and Codex. 连接 Claude Code 与 Codex 的本地实时协作桥接工具。

AgentBridge – 一个本地桥接工具，让 Claude Code 和 OpenAI Codex 实时互相通信

是什么 – AgentBridge 是一个开发者侧的实用工具，运行一个微型守护进程和一个命令行包装器（abg / agentbridge）。它连接两个 大型语言模型编程助手 – Claude Code（Anthropic）和 Codex（OpenAI），使它们能够交换消息、互相审查代码并交接任务，而无需你在终端之间复制文本。

为何重要 – 通常你需要运行两个独立的终端，复制粘贴代码，并在一方达到配额时手动切换。AgentBridge 自动化了“接力”过程：

每个代理作为持久对等节点保持活跃，
消息自动推送（带有备用队列），
一个 忙碌保护机制 防止重叠回复，
内置的看门狗可在订阅配额限制下通过将控制权交给另一方，让长时间任务持续运行。

核心功能（如 README 所述）

功能	你获得什么
双向 Claude ↔ Codex 消息传递	Claude 将 Codex 的 `agentMessage` 数据包作为频道通知接收；Codex 通过 `reply` 工具接收 Claude 的回复。
推送交付与备用队列	如果推送失败，守护进程会将消息存储在内存中，并通过 `get_messages` 重试。
回合协调	一个忙碌保护机制在对方处于活动回合时阻止回复；一个不活动看门狗会在沉默 5 分钟后强制完成回合。
多个配对并行运行	你可以在同一仓库中运行多个 Claude+Codex 配对；每个配对拥有自己的一组端口（从 4500 开始，每对递增 10）。
健壮的生命周期管理	守护进程可承受 Claude 重启，自动重连（带退避），清理孤儿进程，并提供 `abg doctor` 诊断功能。
线程自动恢复	`abg codex` 会自动重新打开上一个 Codex 线程；`abg resume` 会打印或执行双方所需的命令。
预算协调与自动恢复	当一方订阅配额到期时，桥梁会暂停该侧，让另一方继续运行，从而保持长时间任务存活。
过滤以保持上下文简洁	只有 `agentMessage` 数据包会跨过边界；其他工具调用的噪声会被丢弃。三级标记系统（`[IMPORTANT]`、`[STATUS]`、`[FYI]`）让你控制哪些内容被转发、缓冲或忽略。
跨网络协作（预览版）	v3 引入基于代理的“房间”，使配对可在不同机器上运行并仍能交换消息。

快速入门工作流（来自 README）

安装 Bun – 守护进程所需的运行时。
安装 CLI – npm install -g @raysonmeng/agentbridge（安装后注册 Claude Code 插件）。
初始化项目 – abg init 创建 .agentbridge/config.json 并检查依赖项。
启动 Claude – abg claude 启动启用桥接通道的 Claude Code。
启动 Codex – 在另一个终端中，abg codex 启动连接到同一桥接的 Codex TUI。

现在你可以让 Claude “为……提出与 Codex 的任务拆分方案”，并观察两个代理在无需手动复制粘贴的情况下协商、实现和审查代码。

内部工作原理

bridge.ts – 一个短生命周期的前台客户端，Claude 作为插件加载。它将 Claude 的 reply 调用转发给守护进程，并接收 Codex 消息以推回 Claude。
daemon.ts – 一个持久的后台进程，与 Codex 应用服务器（通过 WebSocket 或 Unix 套接字）通信，并持有配对的权威状态。
通信流程：
- Codex → daemon → bridge → Claude（频道通知）
- Claude → bridge → daemon → Codex（注入 turn/start）
每条消息都携带一个 source 字段，确保桥接不会将消息回传给其来源，防止循环。

安装与前置条件（如所列）

依赖项	推荐版本	安装命令
Bun	v1.3.11+	`curl -fsSL https://bun.sh/install
Claude Code	2.1.269	`npm install -g @anthropic-ai/claude-code@2.1.269`
Codex CLI	0.154.0	`npm install -g @openai/codex@0.154.0`

注意： CLI 默认启动 Claude 时使用 --dangerously-skip-permissions，Codex 使用 --yolo（即它们可以无提示地运行命令和编辑文件）。如果你需要正常的权限提示，请使用 --safe 或设置 AGENTBRIDGE_SAFE=1。

常见命令

命令	作用
`abg init`	检查依赖项，注册 Claude 插件，写入 `.agentbridge/config.json`
`abg claude [args]`	启动带桥接通道的 Claude Code（注入所需标志）
`abg codex [args]`	启动连接到桥接的 Codex TUI；`abg codex --new` 创建新线程
`abg resume`	打印或执行重新连接双方到上次会话所需的命令
`abg pairs`	列出、移除或修剪多个 Claude+Codex 配对
`abg doctor`	只读诊断（环境、守护进程健康状况、日志）
`abg budget`	显示每个代理的订阅配额状态
`abg kill`	优雅停止守护进程及任何托管的 Codex TUI
`abg dev`	供开发者使用 – 注册本地市场并强制插件同步

谁可能使用它

单人开发者，已拥有 Claude Code 和 Codex 访问权限，希望它们能自动协作。
研究人员，探索多代理编码工作流、任务拆分或不同 LLM 提供商之间的交叉审查。
团队，运行长时间的代码生成任务，需要一种方式在一方配额到期时仍能保持工作进行。

局限性（明确指出）

它是 仅限本地 的 – 不是托管的、多租户服务。
它仅支持两个特定代理（Claude Code 和 Codex）；它不是通用编排框架。
安全边界较弱 – 桥接假设你信任两个代理和工作区。

如何了解更多

网站与演示： https://raysonmeng.github.io/agent-bridge/（真实会话的动画回放）
文档：仓库中的 docs/ 文件夹 – 包含手册、故障排除指南以及跨网络“房间”功能的详细信息。
社区讨论： LINUX DO 开发者论坛（README 中的链接）。

TL;DR

AgentBridge 是一个基于 Bun 的轻量级守护进程加 CLI，让 Claude Code 和 OpenAI Codex 在单个开发会话内对话、拆分任务并互相审查输出，自动处理回合协调、配额交接和消息过滤。它面向希望两个 LLM 编程助手协作而无需手动复制粘贴的开发者。