Circus Chief 完全指南：从浏览器控制面板管理多个 AI 编码 Agent
你有没有遇到过这种情况：桌面上同时开着三个终端窗口——一个在跑 Claude Code 改后端逻辑，一个在跑 Codex 写前端组件，还有一个 Gemini CLI 在做代码审查——你要不断在窗口间切换查看进度、检查输出、决定下一步。如果还能在手机上看一眼状态、在出门前启动一个自动化流水线就更好了。
Circus Chief 正是为了解决这个场景而生。它是开源的（Apache-2.0）、面向移动端优化的 AI 编码 Agent 控制面板，让你在浏览器或手机上统一管理 Claude Code、OpenAI Codex 和 Google Gemini CLI 的会话。
为什么需要 Agent 控制面板？
单个 Agent 很好用，但当你同时在多个项目中运行多个 Agent 时，问题就出现了：
- 窗口管理混乱：每个 Agent 一个终端标签页，切换全靠眼神
- 缺乏可见性：不知道哪个 Agent 跑完了、哪个卡住了、哪个需要你输入
- 没有协作：Agent A 改完代码，Agent B 去审查，但没有机制串联
- 没法远程：离开电脑就失去了对所有 Agent 的掌控
Circus Chief 把所有这些放到一个 Web 控制面板里。安装只需一行命令：
npx circuschief
默认启动在 http://localhost:5000，浏览器打开就能看到仪表盘。
核心功能详解
1. 统一会话管理
从仪表盘可以启动任意类型的 Agent 会话：Claude Code、Codex、Gemini CLI。每个会话都有独立的运行环境（通过 git worktree 隔离），互不干扰。
你可以在同一个工作树的不同分支上并发运行 Agent，也可以为每个会话创建全新的 worktree——这样即使一个 Agent 改了代码，也不会影响其他 Agent 的工作。
2. 链式模板（Pipeline）
这是 Circus Chief 最强大的功能。你可以定义模板（template），每个模板包含提示词和会话设置，模板之间可以自动串联：
template:
- name: plan
prompt: "分析项目结构，制定重构方案"
next: review_plan
- name: review_plan
prompt: "审查上一个方案的可行性"
next: implement
- name: implement
prompt: "按照审查通过的方案实现代码变更"
next: review_impl
- name: review_impl
prompt: "检查实现代码的安全性、性能和风格"
next: open_pr
- name: open_pr
prompt: "生成 PR 描述并提交"
模板支持递归调用——启动一个模板时，它会逐个执行每一步，每一步结束后自动进入下一步。对于常见的开发工作流（方案 → 审查 → 实现 → 审查 → PR），一次配置，后续一键运行。
3. 定时调度与会话恢复
你可以提前安排 Agent 会话在指定时间运行：
如果会话因为 Token 耗尽或 Provider 故障中断，开启”自动重试”后，它会自动重新调度并从中断处恢复——半夜跑的任务，早上醒来已经完成了。
4. 手机端控制
这是真正让它与众不同的功能。仪表盘是移动端友好的，在手机浏览器上打开 http://你电脑IP:5000，就能看到所有 Agent 的状态：
- 查看会话日志和 AI 生成的摘要
- 启动新的 Agent 会话
- 查看会话的共享画布（shared canvas）
- 执行项目命令（测试、lint、构建）
想象一下：你在地铁上打开手机，看到 CI 失败了，直接点一下”重新运行”，跟买杯咖啡一样简单。
5. 共享画布（Shared Canvas）
Agent 和人类可以在同一个画布上协作编辑。支持 Markdown、JSON、代码、图片。所有人（和 Agent）看到的是同一份内容，修改历史可追溯。
6. AI 摘要
每个会话结束后，Circus Chief 会自动生成一个摘要，告诉你这个 Agent 做了什么、当前进度是什么。你再也不需要翻完整篇对话记录来”补课”。
安装与配置
先决条件：
- macOS 或 Linux
- Node.js 20+
- 已安装 Claude Code、Codex CLI 或 Gemini CLI（至少一个）
npx circuschief npx circuschief -p 8080 npx circuschief --no-analytics
首次打开仪表盘后，你需要在”Provider Settings”中配置 API Key 或选择订阅方式。支持：
- Claude Code：Anthropic 原生或兼容端点
- Codex：OpenAI 原生或兼容端点
- Gemini CLI：Google 原生
每个会话都可以独立选择不同的 Provider，灵活度极高。
实战场景
场景一：并行重构 + 测试
场景二：夜间自动化流水线
配置一个模板链：方案 → 代码审查 → 实现 → 测试 → PR，安排为定时任务。第二天醒来，桌面上已经有一个审查完毕、CI 通过的 PR 等着你合并。
场景三：远程审查与执行
你在外面用手机打开 Circus Chief，看到 Agent A 完成的代码变更。通过共享画布浏览变更摘要，觉得没问题，点一下”合并 PR”。全程不需要打开笔记本。
与其他方案的对比
| 功能 | Circus Chief | NodeCartel | 各自 CLI + 终端 |
|---|---|---|---|
| Agent 类型 | Claude Code / Codex / Gemini | 通用脚本 | 只看你自己装的 |
| 控制面板 | 自带 Web UI（移动端适配） | 云端管理 | 无 |
| 工作树隔离 | 每个会话独立 worktree | 跨主机隔离 | 手动管理 |
| 模板链 | ✅ 支持链式 Pipeline | 无 | 无 |
| 定时调度 | ✅ 内置 | 无 | 需要 cron |
| 手机控制 | ✅ 响应式 UI | 云端控制台 | 无 |
| 开源/自托管 | ✅ Apache-2.0 | 免费层 + SaaS | 不适用 |
| 安装复杂度 | 一行命令 | curl 管道 | 各 CLI 分别装 |
注意事项
- 安全：仪表盘默认绑定 localhost:5000，不要直接暴露到公网。如果需要远程访问，建议用 SSH 隧道或 Tailscale 等网络层保护：
“`bash
ssh -L 5000:localhost:5000 your-server
“`
- Worktree 管理：每个会话创建独立 worktree，使用后建议定期清理：
git worktree prune
- Provider 用量：并发运行多个 Agent 会同时消耗多个 Provider 的限额。注意你的订阅套餐的 Token 上限。
- GitHub PR 集成：需要安装
ghCLI 并登录，PR 链接和 CI 状态才会自动显示。
总结
Circus Chief 并不是要取代 Claude Code 或 Codex——它是在这些工具之上加了一层统一的”指挥层”。当你的 Agent 从一个变成两个、三个、十个时，这个控制面板的价值会指数级增长。
安装只需一行命令，你不需要任何基础设施就能获得：
- 统一的会话管理
- 链式自动化流水线
- 移动端控制
- 工作树隔离的并发运行
在 AI 编码 Agent 越来越多、越来越强的今天，管理 Agent 的能力本身正在成为一项重要的开发者技能。Circus Chief 是这条路上一个值得关注的开源解决方案。
GitHub: github.com/ferrislucas/Circus-Chief 安装:
npx circuschief许可证: Apache-2.0