CCB 多智能体协作实战教程 - claude_codex_bridge

CCBClaude Code Bridge让多个 AI CLI 互相通信核心命令/ping、/ask、/pendClaude 做管理规划 验收Codex/Gemini 做执行注意CCB 社区扩展项目不是 Claude Code 官方内置功能。/ping、/ask、/pend是 CCB 提供的自定义命令。为什么需要多 AI 协作单个 AI 模型有局限Claude Opus → 推理最强但贵、慢 Claude Sonnet → 平衡日常首选 Codex → 代码执行能力强 Gemini → 长上下文、多模态多 AI 协作的核心思路让高成本模型负责决策让执行型模型负责落地。成本对比模式Claude Token 消耗总成本适用场景纯 Claude100%高简单任务Claude Codex30-40%中前后端分离Claude Codex Gemini10-30%低大型项目Claude 的 Token 消耗可降低 70-90%因为重执行任务交给了成本更低的模型。架构概览Claude管理者 ├── 分析需求制定计划 ├── /ask codex后端任务...→ Codex 执行 ├── /ask gemini前端任务...→ Gemini 执行 ├── /pend codex → 回收结果 ├── /pend gemini → 回收结果 └── 交叉审计 最终验收角色分工角色模型职责擅长管理者Claude规划、审查、验收推理、决策、质量把控后端执行Codex实现、测试代码生成、命令执行前端执行Gemini实现、联调长上下文、多模态理解核心命令/ping codex /ping gemini /ask codex实现用户登录后端输出 changedFiles/diffSummary/ask gemini完成前端登录页面输出 changedFiles/diffSummary/pend codex /pend gemini命令详解命令作用返回/ping provider检查连通性在线 / 离线状态/ask provider ...异步委托任务任务 ID/pend provider查看最新结果执行结果完整协作流程Step 1连通检查/ping codex /ping geminiStep 2需求分析与任务拆分 我需要实现一个用户注册功能包含 - 后端注册 API、邮箱验证、密码加密 - 前端注册表单、表单验证、成功页面 - 数据库users 表 migration 请拆分任务并分配给 Codex 和 GeminiStep 3委托执行/ask codex实现用户注册后端 1. POST /api/auth/register 接口 2. 密码用 bcrypt 加密 3. 邮箱唯一性检查 4. users 表 migration 5. 单元测试 输出格式changedFiles/diffSummary/testResults/ask gemini实现用户注册前端 1. 注册表单组件邮箱、密码、确认密码 2. 客户端表单验证 3. 调用 POST /api/auth/register 4. 成功/失败提示 输出格式changedFiles/diffSummaryStep 4回收结果/pend codex /pend geminiStep 5交叉审计/ask codex 审查前端注册组件的代码质量和安全性 /ask gemini 审查后端注册 API 的接口设计和错误处理Step 6最终验收汇总 Codex 和 Gemini 的实现结果和交叉审计意见做最终验收。检查1. 前后端接口是否对齐2. 是否有安全风险3. 测试是否充分实战案例案例 1全栈功能开发需求实现商品搜索功能支持关键词搜索和筛选 /ask codex实现搜索后端 - GET /api/products/search?qxxxcategoryxxx - 支持分页 - 用 Elasticsearch 或数据库 LIKE 查询 - 性能要求200ms 内返回/ask gemini实现搜索前端 - 搜索框组件支持防抖 - 筛选面板分类、价格区间 - 搜索结果列表支持无限滚动 - 加载状态和空结果提示/pend codex /pend gemini检查前后端接口是否对齐合并代码案例 2大型重构把项目从 REST API 迁移到 GraphQL /ask codexPhase 1搭建 GraphQL schema 和 resolver - 定义 User、Product、Order 类型 - 实现基本的 Query 和 Mutation - 保留原有 REST API双轨运行/ask geminiPhase 1前端适配 GraphQL - 安装 Apollo Client - 把 fetch 调用改为 GraphQL query - 先改首页和商品列表页案例 3Bug 修复 回归测试用户反馈登录后偶尔会被踢出 /ask codex修复 token 刷新逻辑 - 检查 src/auth/token.ts 的刷新时机 - 修复竞态条件 - 添加重试机制 - 写回归测试/ask gemini验证修复效果 - 模拟高并发登录场景 - 检查 token 过期边界情况 - 验证前端 token 刷新拦截器降级策略必须有降级方案不能因为某个模型不可用就卡住模型不可用/ask codexGemini 不可用请同时完成前后端任务Codex 离线我来直接实现后端逻辑结论冲突Codex 和 Gemini 对缓存策略有分歧。请分别用两种方案跑基准测试以 p99 延迟和内存占用为标准选择。超时处理Codex 执行超时改为 Claude 直接实现环境搭建从零开始以下是完整的搭建步骤按顺序执行即可。Step 0Windows 用户先装 WSLtmux 和 CCB 在 Linux 环境下兼容性最好Windows 用户建议先装 WSLwsl--installmacOS / Linux 用户跳过此步。Step 1验证三件套确保 Claude Code、Codex CLI、Gemini CLI 都已安装npminstall-ganthropic-ai/claude-codenpminstall-gopenai/codexnpminstall-ggoogle/gemini-cli claude--versioncodex--versiongemini--version任何一个报错的先装好再继续。Step 2安装 tmuxCCB 依赖终端复用器 tmux 实现多模型之间的通信必装brewinstalltmuxsudoaptupdatesudoaptinstall-ytmuxsudoyuminstall-ytmux tmux-VStep 3编写 CLAUDE.md在~/.claude/CLAUDE.md写好协作规范Claude 启动时自动读取。以下是完整模板# Claude Code 核心规范 ## 工作模式Superpowers AI 协作 ### 角色分工 **Claude我——架构师 / 项目经理** - 需求分析、架构设计、任务拆分 - 使用 Superpowers 进行规划、审查、调试 - 代码审核、最终验收、Git 提交管理 - **绝对不亲自编写代码**所有编码任务必须委派给 Codex 或 Gemini **Codex——后端开发** - 服务端代码、API、数据库、Migration - 单元测试、集成测试 - 通过 /ask codex ... 调用 **Gemini——前端开发** - 前端组件、页面、样式、交互逻辑 - 代码审查、安全审计 - 通过 /ask gemini ... 调用 ### 降级机制 当某个 AI 提供者不可用时按以下规则降级 Codex 不可用 → Gemini 接管后端任务 Gemini 不可用 → Codex 接管前端任务 两者都不可用 → 暂停编码等待恢复Claude 不代写代码 降级时在任务描述中注明降级接管便于后续追溯。 ### 协作方式 **使用 Superpowers skills 进行** - 规划superpowers:writing-plans - 执行superpowers:executing-plans - 审查superpowers:requesting-code-review - 调试superpowers:systematic-debugging - 完成superpowers:finishing-a-development-branch **调用 AI 提供者执行代码任务** # 指派 Codex 实现后端 /ask codex 实现 XXX 后端功能涉及文件... # 指派 Gemini 实现前端 /ask gemini 实现 XXX 前端功能涉及文件... # 查看执行结果 /pend codex /pend gemini --- ## Linus 三问决策前必问 1. **这是现实问题还是想象问题** → 拒绝过度设计 2. **有没有更简单的做法** → 始终寻找最简方案 3. **会破坏什么** → 向后兼容是铁律 --- ## Git 规范 - 功能开发在 feature/task-name 分支 - 提交前必须通过代码审查 - 提交信息类型: 描述中文 - 类型feat / fix / docs / refactor / chore - **禁止**force push、修改已 push 历史把规则写好Claude 就会严格按照规则执行不需要每次手动告诉它。Step 4安装 Superpowers 插件[非必须]启动 Claude Code 后在 REPL 中执行/plugin marketplaceaddhttps://github.com/obra/superpowers-marketplace /plugininstallsuperpowerssuperpowers-marketplace出现successfully就证明安装成功。安装完成后 Claude 就具备了标准化的规划、审查、调试能力。Step 5安装 CCBClaude Code BridgeCCB 是让三个 AI 互相通信的桥接器。社区开源项目python3--versiongitclone https://github.com/bfly123/claude_code_bridge.gitcdclaude_code_bridge# 安装bashinstall.shinstall安装过程中CCB 会自动配置通信组件并在~/.claude/CLAUDE.md里注册/ask、/pend、/ping命令。Step 6启动协作系统ccbccb新版本不支持携带参数ccb codex claude 需要在项目下的 .ccb/ccb.config 文件中定义agent工具链层级关系理解三层工具链的先后关系第一层CLAUDE.md规则层 → Claude 启动时自动读取定义协作规范和角色分工 第二层Superpowers能力层 → 提供标准化的规划、审查、调试流程 第三层CCB通信层 → 让 Claude 通过 /ask、/pend、/ping 指挥 Codex 和 Gemini搭建步骤速查1.[Windows]安装 WSL → wsl--install2. 验证三件套 → claude/codex/gemini--version3. 安装 tmux →aptinstalltmux / brewinstalltmux4. 编写 ~/.claude/CLAUDE.md → 定义协作规则5. 安装 Superpowers6. 安装 CCB →gitclone bashinstall.shinstall7. 启动协作 → ccb codex gemini claude最佳实践1. 任务拆分原则好的拆分 - 前端 vs 后端天然隔离 - 不同模块用户模块 vs 订单模块 - 实现 vs 测试可并行 不好的拆分 - 同一个文件的不同部分会冲突 - 有强依赖的任务必须串行 - 需要频繁沟通的任务协调成本高. 交叉审计让模型互相审查比自己审查自己更有效Codex 写的代码 → Gemini 审查 Gemini 写的代码 → Codex 审查 最终结果 → Claude 验收自定义agent在项目下新建.ccb文件夹mkdir.ccb新建配置文件 .ccb.configvimccb.config内容根据实际修改version2default_agents[claude,codex,opencode,ccb_self][agents.claude]providerclaudetarget.workspace_modeinplaceruntime_modepane-backedpermissionmanualrestoreautoqueue_policyserial-per-agent[agents.codex]providercodextarget.workspace_modeinplaceruntime_modepane-backedpermissionmanualrestoreautoqueue_policyserial-per-agent[agents.opencode]provideropencodetarget.workspace_modeinplaceruntime_modepane-backedpermissionmanualrestoreautoqueue_policyserial-per-agent[agents.ccb_self]providerclaudetarget.workspace_modeinplaceruntime_modepane-backedpermissionmanualrestoreautoqueue_policyserial-per-agent