通过分屏终端实现 Claude、Codex、Gemini、OpenCode、Droid 多 AI 实时协作的命令行工具,支持持久化上下文、统一命令系统与最小化 token 开销。
Claude Code Bridge (CCB) 是一个实时多 AI 协作工具,通过分屏终端实现多个 AI 模型的协同工作。
核心特性#
- 🖥️ 可视化与可控:多 AI 模型在分屏 CLI 中运行,所有交互可见且可控
- 🧠 持久化上下文:每个 AI 维护独立记忆,支持
-r标志随时关闭和恢复会话 - 📉 Token 节省:发送轻量级提示而非完整文件历史
- 🪟 原生工作流:直接集成 WezTerm(推荐)或 tmux,无需复杂服务器
支持的 AI Providers#
Claude, Codex, Gemini, OpenCode, Droid
统一命令系统#
| 命令 | 功能 |
|---|---|
ask <provider> <message> | 统一请求命令(默认后台模式) |
ccb-ping <provider> | 统一连通性测试 |
pend <provider> [N] | 统一回复获取 |
技能系统#
/ask <provider> <message>- 请求技能/cping <provider>- 连通性测试技能/pend <provider>- 回复获取技能/all-plan- 多 AI 协作设计与头脑风暴
邮件系统集成#
支持通过邮件与 AI providers 交互,实现远程访问:
- 支持邮箱:Gmail / Outlook / QQ Mail / 163 Mail / 自定义 IMAP/SMTP
- 邮件正文使用前缀指定 provider(如
CLAUDE:,CODEX:,GEMINI:)
架构设计#
项目采用 Memory-First AI Agent Architecture(内存优先的 AI 代理架构):
- Memory = Kernel:内存是系统核心,而非模型的附属工具
- Models = CPU:模型是无状态执行单元,即插即用
- Database = Motherboard:数据库连接感知、内存和执行
三层存储架构#
| 层级 | 数据类型 | 技术栈 |
|---|---|---|
| L1: Hot | 当前会话、临时变量 | Redis / Memcached |
| L2: Warm | 任务状态和实体关系 | SQLite / Postgres |
| L3: Cold | 历史日志、文档块 | Pgvector / Chroma / LanceDB |
快速开始#
前置要求#
- Python 3.10+
- 终端: WezTerm(强烈推荐)或 tmux
安装#
Linux / macOS / WSL:
git clone https://github.com/bfly123/claude_code_bridge.git
cd claude_code_bridge
./install.sh install
Windows Native: 使用 install.ps1 或 install.cmd
运行示例#
ccb # 从 ccb.config 启动所有 providers
ccb codex gemini # 启动指定 providers
ccb -r codex gemini # 恢复上次会话
ccb -a codex gemini opencode # 自动批准模式
配置文件#
查找顺序:
.ccb/ccb.config(项目级)~/.ccb/ccb.config(全局级)
简单格式:
codex,gemini,opencode,claude
高级 JSON 格式:
{
"providers": ["codex", "gemini", "opencode", "claude"],
"cmd": { "enabled": true, "title": "CCB-Cmd", "start_cmd": "bash" },
"flags": { "auto": false, "resume": false }
}
CLI 命令标志#
| 标志 | 描述 |
|---|---|
-r | 恢复上次会话上下文 |
-a | 自动模式,跳过权限提示 |
-h | 显示帮助信息 |
-v | 显示版本并检查更新 |
更新与卸载#
ccb update # 更新到最新版本
ccb update 4 # 更新到最高 v4.x.x
ccb uninstall # 卸载并清理配置
ccb reinstall # 清理后重新安装
典型应用场景#
| 场景 | 描述 |
|---|---|
| 代码审查 | 让 Codex 审查 main.py 中的更改 |
| 第二意见 | 向 Gemini 询问替代实现方案 |
| 结对编程 | Codex 编写后端逻辑,开发者处理前端 |
| 架构设计 | 多 AI 协作进行头脑风暴与模块设计 |
| 远程交互 | 通过邮件系统远程与 AI 交互 |
目录结构#
claude_code_bridge/
├── bin/ # 可执行脚本
├── lib/ # 核心库代码
├── claude_skills/ # Claude 技能定义
├── codex_skills/ # Codex 技能定义
├── droid_skills/ # Droid 技能定义
├── config/ # 配置文件
├── docs/ # 文档(含架构设计文档)
├── mcp/ccb-delegation # MCP 集成
└── test/ # 测试代码
联系方式#
- 📧 Email: bfly123@126.com
- 💬 WeChat: seemseam-com