CCB（Claude Codex Bridge）完全指南：一个终端如何指挥17个AI编码智能体协同工作-育师

CCB（Claude Codex Bridge）完全指南：一个终端如何指挥17个AI编码智能体协同工作

【免费下载链接】claude_codex_bridgeVisible multi-agent CLI workspace for mixing Codex, Claude, Gemini, Kimi, Qwen, Cursor, Copilot, Pi, OpenCode, and other AI coding agents项目地址: https://gitcode.com/gh_mirrors/cl/claude_codex_bridge

CCB（Claude Codex Bridge）是一个开源的多智能体终端工作台，让你在一个终端里同时指挥 Codex、Claude、Gemini、Kimi、Qwen、Cursor、Copilot、OpenCode 等 17 家 AI 编码智能体。它把各家 CLI Agent 放进可见的 tmux 窗口中，支持跨 Agent 消息通信、排队、协作编排，并提供手机端远程控制和富媒体文件预览。本文将带你从安装到进阶，完整跑通这个多 Agent 协作环境。

CCB 是什么？为什么需要它？

单独使用一个 AI 编码工具时，你只能"一对一"对话；而真实开发常常需要分工：一个 Agent 写代码、一个 Agent 做架构审查、一个 Agent 跑测试。CCB 解决的核心问题就是——让多个 AI 编码智能体在同一个终端里可见、可控、可接管地协同工作🚀

它的核心能力包括：

多 Provider 并存：一个命令同时并发运行多家 CLI Provider（Hub 能力），Codex 与 Claude 可以并行工作
稳定通信：支持A -> B -> C、A,B -> C、A -> B,C等复杂协作关系，人与 Agent、Agent 与 Agent 都走有序消息队列
后台常驻：ccbd守护进程持续运行，关掉前台界面项目状态依然保留
直接接管：每个 Agent 都是完整原生终端，随时可以切过去手动操作
手机遥控：跨 Provider 语音操控、文件传输、远程终端访问

完整能力介绍见官方首页 README.md 与中文版 README/zh.md。

三分钟安装：CCB 快速安装步骤

CCB 支持 Linux、macOS、WSL，Windows 原生版为 beta。推荐 npm 一键安装：

npm install -g @seemseam/ccb@latest

如果偏好源码安装，也可以克隆仓库后运行安装脚本：

git clone https://gitcode.com/gh_mirrors/cl/claude_codex_bridge cd claude_codex_bridge ./install.sh install

安装后，后续升级只需一条事务式更新命令：

ccb update

它还会顺带检查已安装的各家 Provider CLI 并提示可安全管理的更新，且不会自动重启正在工作的 Agent 窗口。

工作区界面速览：认识 CCB 终端布局

在工作目录执行ccb即可启动。空白项目默认轻量启动：打开一个main窗口，并创建一个名为demo的 Agent（自动选择本机可用的首个 CLI，优先级为 Codex、Claude、Gemini）。

界面可以分成 5 个区域，逐个认识：

区域	作用
① Agent 侧边栏	列出所有窗口与 Agent，点击即可切换
② 主任务窗口	当前输入的 Agent 所在 pane
③ 协作 Agent 窗口	其他常驻 Agent，各自运行独立 CLI 会话
④ Comms 通讯区	各 Agent 的 ask/job 状态动态
⑤ 项目状态栏	项目名、CCB 版本、时间与快捷提示

关键的一点：每个 pane 都是一个真实 CLI 会话。键盘聚焦在哪个窗口，就直接和哪个 Agent 对话；任何时候都可以夺回控制权，而不是隔着 API 看黑盒。

如何配置多Agent团队：可视化 Control Panel 教程

默认单 Agent 不够用？点击侧边栏左上角的⚙ Settings图标（或在项目目录运行ccb config ui），打开可视化配置控制面：

控制面可以配置：

窗口与 pane 拆分：左右分栏 / 上下堆叠，支持多窗口
Provider 与模型：为每个 Agent 指定 Codex、Claude、Gemini 等后端及模型、Thinking 等级
Workspace：默认目录、git worktree 或外部路径
Rich 模式与侧边栏样式

保存前会先校验配置，并支持 dry-run 和受保护的热加载。保存后生成.ccb/ccb.config，把拓扑固定为该项目配置。一个典型的"两工人一审查"团队配置：

version = 2 [windows] main = "main:codex" work = "worker1:codex(worktree), worker2:claude(worktree)" review = "reviewer:claude, qa:gemini"

其中(worktree)表示该 Agent 在独立的 git worktree 中工作，多个 Agent 互不干扰地改代码。验证并启动：

ccb config validate ccb

跨Agent协作实战：/ask 指令与消息队列

配置好团队后，在任意 Agent 窗口输入/ask就能把任务派给其他 Agent：

/ask reviewer review the latest parser changes and list blocking issues.

Agent 之间：ask（请求）与back（结果）在目标 Agent 上共用一条按时间排序的 FIFO 队列，前一条处理完才投递下一条，不同 Agent 仍可并行
人和 Agent 之间：你在编辑草稿时，Agent 消息会先排队等待，避免打断输入或把你的草稿误发出去
持久协调：跨 Agent 的长期约定写入项目共享记忆 .ccb/ccb_memory.md

Agent 卡住了怎么办？运行$ccb_diagnose <agentname>可联合 daemon、队列、inbox、trace 与实时 Pane 证据做诊断，并在安全时执行受限恢复。更多命令参考用户手册 docs/manuals/user-guide/。

进阶玩法：Rich 富媒体终端模式

纯文本终端看文件不够直观？启用 Rich 模式后，可在终端内浏览文件树、预览和编辑文档：

ccb update rich

启用后普通ccb会自动打开富媒体 WezTerm 启动器；想退回普通终端模式，运行ccb uninstall rich即可。新版还支持点击文件直接用系统默认应用打开（macOS/Linux/WSL 均适配）。

手机远程遥控 CCB

CCB 内置 Flutter 手机 App（Android），通过ccb update mobile一条命令引导完成安装与配置。手机可以接入服务器上的所有 CCB 项目：查看 Agent 对话、发送指令、打开远程终端、上传下载文件，还支持语音输入。网关默认只绑定回环地址，远程走 Tailscale 或经验证的局域网地址，配对采用最小权限 scope，安全边界清晰。源码位于 mobile/ 目录，服务端网关在 lib/mobile_gateway/。

Agentic Loop Workflow：从"人工调度"到"自动闭环"

CCB 还在推进一条更深层的自动化路线——Agentic Loop Workflow：让 Frontdesk（前台入口）、Planner（全局计划）、Orchestrator（语义编排）与多组 Worker + Reviewer（执行与审查）自动形成闭环，Git 集成与根验证由程序裁决，做到可见、可审查、可恢复。

这条路线的完整架构说明见 docs/agentic-loop-workflow-architecture.zh.md。

常见问题（FAQ）

问：CCB 支持哪些平台？答：Linux、macOS、WSL 为正式版；原生 Windows x64 为 beta（需要 WezTerm、Git Bash 与 Herdr 0.8.0+）。

问：没有某个 AI 工具的 API Key 能用吗？答：可以。CCB 按 Agent 配置 Provider，缺哪个就少挂哪个 Agent，互不影响。

问：关闭 CCB 界面后 Agent 会停止吗？答：不会。后台ccbd守护进程持续运行，项目状态、队列和会话都保留，重新 attach 即可继续。

问：如何回滚版本？答：使用同一事务式更新器安装旧版本即可，例如ccb update 8.1.3；更新失败会自动恢复本地前缀。

总结

CCB 把"多个 AI 编码智能体如何协同"这件复杂的事，收敛成了一个简单的终端界面：npm 一键安装 → 可视化配置团队 →/ask派活 → 手机随时接管。无论你是想给 Codex 配一个 Claude 审查员，还是搭建自动化的多工作组流水线，这份完全指南涉及的每一步都能在项目里找到对应实现，完整变更记录见 CHANGELOG.md。动手试试吧！🎯

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考