CCB配置系统深度解析玩转.ccb/ccb.config与可视化Config UI控制面板【免费下载链接】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想快速上手 CCBclaude_codex_bridge多 Agent 工作台本文带你玩转 CCB 配置系统的两大核心项目配置文件.ccb/ccb.config和可视化 Config UI 控制面板。无需手写复杂 TOML点击鼠标就能编排 Codex、Claude、Gemini 等多个 AI 编码 Agent 的窗口布局、模型与 API 设置并支持校验、保存、热加载全流程。CCB 配置系统概览一个文件定义整个 Agent 工作台CCB 的核心思想是配置即布局你用一份文本文件描述哪些 Agent、用什么 provider、在屏幕上怎么分屏启动后 CCB 会在 tmux 中把这份配置变成真实的多面板工作台。配置文件只有三个来源优先级从高到低优先级文件位置说明1最高.ccb/ccb.config项目级配置跟随项目目录推荐日常使用2~/.ccb/ccb.config用户级配置仅在项目级缺失时生效3最低代码内置默认值只有一个demoagent自动选择本机可用的 provider需要注意的是CCB 不会跨层合并配置高优先级文件会整体替换低优先级文件同时 CCB 也不会自动改写.ccb/ccb.config——这是一份完全属于你的用户手写文件。这套规则定义在 ccb-config-layout-contract.md 契约文档中。5分钟看懂 ccb.config 布局语法;分栏、,堆叠.ccb/ccb.config的主格式是紧凑文本记住 3 个符号就够了agent:provider一个 Agent 叶子例如agent1:codex表示名叫 agent1、用 Codex 的 Agent;左右分栏水平切分,上下堆叠垂直切分(...)显式分组控制切分顺序N可选的分屏百分比提示如agent1:codex70占 70% 宽度几个由浅入深的例子直接可复制使用agent1:codex, agent2:claude两个 Agent 上下堆叠。agent1:codex; agent2:codex, agent3:claude左侧 Codex右侧上下两个 Agent——典型的一主两辅布局。main:codex, work worker1:codex(worktree), worker2:claude(worktree)加上version 2和[windows]表后可以声明多窗口拓扑每个窗口名对应一行布局(worktree)表示该 Agent 在独立 git worktree 中工作互不污染代码。例如A,B;C,D就是接近四宫格的布局。一键打开 Config UI 控制面板图形化编排 Agent 布局比起手写配置多数场景直接用可视化Config UI 控制面板更快。两种打开方式图形入口在 CCB sidebar 左上角点击⚙ 设置图标命令行入口在项目目录运行ccb config ui加--no-open可只起服务不弹浏览器面板始终只绑定本机 loopback 地址安全本地使用。界面分为四大区块源码见 assets/config_ui/index.html① 布局编辑器Configure 区Static V2 编辑器默认多窗口 侧边栏管理的正式配置路径。画布上用 Split LR / Split TB 按钮二分切分点击某个 pane 即可在右侧检查器中修改 Agent 名、provider、模型等Basic V1 编辑器单窗口预设使用同一套二分画布适合入门Workflow V3 预览面向动态角色的实验区② 校验与激活Review 区任何修改先经过 5 道闸门——预览 diff → 校验候选配置 → 备份并写入.ccb/ccb.config→ reload dry-run 评估影响 → 应用热加载或提示阻塞原因。改坏也不怕每一步都可回看。③ 会话存储维护Maintain 区扫描.ccb/agents历史按 7/30/90 天保留策略清理旧会话存储并自动保护当前挂载的 Agent。④ 外观与语言支持 System/Dark/Light 等多套主题和中英双语主题偏好会跨 Config UI、Rich 工作台和 sidebar 重启保持持久。常用配置项速查key/url、model、thinking 快捷字段在 Agent 表里可以写快捷字段免去繁琐的 provider 配置[agents.agent1] key sk-... # API Key仅 codex/claude/gemini 支持 url https://api.example.com # API Base URL model gpt-5 # 模型覆盖 thinking high # 推理强度provider 需支持key/url是用户友好糖CCB 会把它编译成该 provider 的 API 环境配置并自动关闭继承的全局认证保证显式配置优先。更完整的字段语义workspace_mode、Role 绑定、MCP 覆盖、[config_ui]端口与 token 等都写在 ccb-config-layout-contract.md 中。固化 Config UI 访问端口[config_ui] 配置默认情况下 Config UI 使用随机 token 临时端口。若想固定本地端口方便复用在.ccb/ccb.config中加入[config_ui] port 43123 token_env CCB_CONFIG_UI_TOKEN # 或改用文件方式token_file .ccb/config-ui.token⚠️ 注意只配置 token 的来源环境变量名或文件路径绝不要把 token 明文写进配置文件。CLI 也只输出 loopback 地址和 token 来源不会打印 token 值。相关实现见 config_ui_settings.py。保存后的热加载与验证改配置的正确姿势修改配置后推荐走这条安全链路在 Config UI 中Save自动备份 校验 写入点击Reload dry-runCCB 会先分类变更影响纯 UI 字段、maintenance_change、replace_agent、layout_change等不实际改动运行环境确认无误后应用受保护的热加载涉及 API 认证等启动级变更时CCB 会记录需要重启的意图在下一次ccb启动时生效绝不悄悄改变正在运行的 provider 进程命令行也可以随时体检ccb config validate校验当前项目配置ccb config approve-commands审批项目自定义命令。测试覆盖可在 test_config_ui.py 中查阅。总结三步玩转 CCB 配置零配置起步直接运行ccb内置默认demoagent 自动选择本机可用 provider图形化扩展打开 Config UI用二分画布拖出想要的多 Agent 布局设置模型与 API高级玩法手写.ccb/ccb.config使用[windows]多窗口拓扑、worktree 隔离和 Role 绑定让团队共享同一份配置即文档配置系统与工作台的关系一目了然更多实战细节可参考 README/zh.md 的中文文档。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考