多 AI 协作学习总结
日期：2026-03-11 参考文章：Claude多智能体协作实战教程
一、核心概念
1.1 为什么要多 AI 协作
单模型有局限：Claude 推理强但贵、Codex 代码执行能力强、Gemini 擅长长上下文和多模态。多模型协作的本质是让高成本模型负责决策，执行型模型负责落地，可降低 Claude Token 消耗 70-90%。
1.2 角色分工模型
| 角色 | 模型 | 职责 |
|---|---|---|
| 管理者 | Claude | 规划、审查、验收（不写代码） |
| 执行者 | Codex / Gemini | 编码、测试、实现 |
1.3 核心工具链（三层架构）
第一层：CLAUDE.md（规则层）→ 定义协作规范和角色分工
第二层：Superpowers（能力层）→ 标准化的规划、审查、调试流程
第三层：CCB（通信层）→ /ask、/pend、/ping 实现模型间通信
二、CCB（Claude Code Bridge）
2.1 是什么
CCB 是社区开源的多模型桥接工具（非 Claude 官方），基于 tmux 分屏实现多个 AI CLI 之间的异步通信。当前版本 v5.2.6。
2.2 核心命令
| 命令 | 作用 | 示例 |
|---|---|---|
/cping <provider> | 检查连通性 | /cping codex |
/ask <provider> "..." | 异步委托任务 | /ask codex "实现用户注册 API" |
/pend <provider> | 查看最新结果 | /pend codex |
2.3 支持的 Provider
codex、gemini、opencode、claude、droid — 固定集合，不支持同名 provider 重复注册。
三、我的实际配置
3.1 环境现状
- 可用模型：Claude Code + Codex（无 Gemini）
- 方案选择：单 Codex 串行执行（方案 A）
- CCB 安装位置：
~/.local/share/codex-dual/ - CCB 二进制：
~/.local/bin/ccb（符号链接） - tmux：已安装（
/opt/homebrew/bin/tmux）
3.2 工作流设计
Claude（管理者）
├── 分析需求，拆分为后端 + 前端任务
├── /ask codex "后端任务..." → 先做后端
├── /pend codex → 验收后端
├── /ask codex "前端任务..." → 再做前端
├── /pend codex → 验收前端
└── Claude 做代码审查 + 最终验收
先后端后前端的串行好处：前端任务可以直接引用后端已完成的接口定义，不会出现前后端不对齐。
3.3 CLAUDE.md 配置要点
- Claude 定位：架构师/项目经理，绝不亲自写代码
- Codex 定位：全栈开发（后端优先）
- 降级策略：Codex 不可用则暂停，不勉强
四、关于"两个 Codex"的探索
4.1 想法
希望两个 Codex 实例分别负责前端和后端，实现并行开发。
4.2 结论：CCB 原生不支持
源码中有两个限制：
_ALLOWED_PROVIDERS是固定集合- 同名 provider 会被去重（
if token in seen: continue）
4.3 替代方案
| 方案 | 可行性 | 推荐度 |
|---|---|---|
| A. 单 Codex 串行 | ✅ 零成本 | ⭐⭐⭐⭐⭐ |
| B. Codex + OpenCode 双执行者 | ✅ 需额外安装 | ⭐⭐⭐ |
| C. 魔改 CCB 支持别名 | ✅ 工作量大 | ⭐⭐ |
五、踩过的坑
5.1 ccb 命令找不到
~/.local/bin 不在 PATH 中，需要手动添加：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
5.2 CCB 必须在 tmux 内运行
直接在普通终端跑 ccb 会报错 CCB must run inside tmux or WezTerm。正确步骤：
tmux # 先进 tmux
cd /Users/xhy/xhycode/xhy # 进项目目录
ccb codex claude # 启动协作
5.3 残留进程冲突
每个目录只允许一个 ccb 实例，旧进程未清理会报 Another ccb instance is already running。解决：
kill <pid> # 杀掉残留进程
tmux kill-server # 清理旧 tmux 会话
5.4 Cursor 内置终端 vs 外部终端
CCB 协作必须在 macOS Terminal / iTerm2 等外部终端的 tmux 中运行，Cursor 的 Shell 环境是非交互式的，无法运行 tmux。
六、对原文的评价
| 维度 | 评分 | 说明 |
|---|---|---|
| 实用性 | ★★★★☆ | 流程清晰，可直接参考落地 |
| 深度 | ★★★☆☆ | 偏入门，缺少深层问题讨论 |
| 准确性 | ★★★★☆ | 技术描述准确，成本数据缺乏支撑 |
| 完整性 | ★★★★☆ | 环境搭建详尽，缺实际踩坑经验 |
主要不足：
- CCB 是社区项目这一点不够醒目，容易误解为官方功能
- 多模型上下文同步和接口对齐的协调成本被低估
- "Claude 绝不写代码"对小项目过于教条
- 实战案例只展示命令格式，缺少真实执行结果和问题处理
七、下一步计划
- 在外部终端成功启动
ccb codex claude - 用一个小功能（如用户注册）跑通完整协作流程
- 体验
/ask→/pend→ 审查 的完整闭环 - 评估单 Codex 串行的实际效率，决定是否引入 OpenCode 做第二执行者
