ccteam 详细部署教程

ccteam 是一个开源工具，它能将你已有的多个 AI 编程助手（如 Claude Code、Codex、Grok、Kimi 等）编成一支可协作的团队。你可以通过 Telegram、Lark 或浏览器统一指挥，在任何会话中向任何厂商的模型分配任务并收集结果。

本教程将引导你完成安装、配置和使用。

1. 重要前提

在安装 ccteam 之前，请确保满足以下条件：

要求 说明
操作系统 macOS、Linux，或 Windows (通过 WSL)
编程助手 至少安装并认证一个支持的 CLI 助手
网络 各个组件需要在同一网络或通过卫星模式连接

1.1 安装并认证至少一个编程助手

ccteam 是连接桥梁，本身不包含 AI 能力。你需要先安装并登录至少一个支持的 CLI 工具（选择其一即可）：

助手 安装参考 认证命令
Claude Code 参考其官方文档 claude auth login
Codex 参考其官方文档 codex login
Grok Build `curl -fsSL https://x.ai/cli/install.sh bash`
OpenCode 参考其官方文档 opencode auth login
Kimi Code 参考其官方文档 kimi login
DeepSeek Harness (DSH) npm i -g @deepseek-ai/dsh 设置 DEEPSEEK_API_KEY 或在 DSH 设置中配置
Pi npm install -g @earendil-works/pi-coding-agent pi auth check --provider <provider>

2. 安装 ccteam

提供了多种安装方式，可按需选择。

方式一：一键安装脚本（推荐）

这是最简单的方式，会安装一个静态二进制文件到 ~/.local/bin：

1
curl -sSL https://raw.githubusercontent.com/firstintent/ccteam/main/install.sh | sh

安装完成后，ccteam 命令即可用。

方式二：通过 DeepSeek Harness 安装（适合 DSH 用户）

如果你已使用 DeepSeek Harness，可以通过其插件系统安装，引擎会随之自动安装并管理：

1
dsh plugin --profile web add @ccteam/ccteam-ui

之后重启 dsh web 即可。

方式三：从源码构建（开发者）

需要 Rust 和 Node.js 环境：

1
2
3
git clone https://github.com/firstintent/ccteam.git
cd ccteam
make install

方式四：让已有的 AI 助手帮你安装

直接向你已经安装的任何编程助手发送指令：

“Install https://github.com/firstintent/ccteam — follow INSTALL.md in the repo.”

3. 启动与初始配置

3.1 启动 ccteam 后台守护进程

安装完成后，启动 daemon（它会常驻后台，终端关闭不影响）：

1
ccteam start
  • 此命令会输出一个 Web 控制台的访问链接，如 http://<lan-ip>:7331/?token=...。
  • 它是幂等的，重复执行不会启动多个实例。

3.2 管理守护进程

命令 作用
ccteam daemon status 查看 daemon 是否运行及版本
ccteam daemon restart 重启 daemon
ccteam stop 停止 daemon（会话状态会保留，下次启动恢复）
ccteam daemon logs -f 实时查看日志

3.3 在浏览器中进行核心配置

  1. 打开 ccteam start 输出的 Web 链接。
  2. 创建项目：点击“创建项目”，这对应你本地的代码仓库目录。
  3. 配置访问与集成：
    • Settings → Access：配置 Telegram/Lark 机器人令牌，或生成卫星（satellite）连接令牌（让其他机器加入）。
    • Settings → Hosts：查看本机已安装的 Vendor（如 Claude Code）及其认证状态。可以在这里一键将 ccteam 的 MCP 工具注册到这些 CLI 中，使它们获得协作能力。

4. 核心概念与使用

4.1 团队协作的基本模式

  1. 即时通讯控制：向配置好的 Telegram/Lark 机器人发送指令。例如：

    • /cd demo：切换到 demo 项目
    • /new codex effort=high：新建一个 Codex 会话
    • @s2 run the test suite：向特定会话（s2）发送任务
    • /status：查看所有会话状态和成本

  2. Web 控制台：浏览器中是一个聊天式界面，可以：

    • 选择项目、Vendor 和模型，直接输入任务。
    • 使用编队剧本（如指挥官+船员、交叉评审等）快速预设一组会话。
    • 查看团队拓扑图，了解各会话间的父子委托关系。

  3. 从会话内委托：在任何一个 ccteam 管理的会话中，直接用自然语言描述，它就能调用其他助手。例如：

    “Spawn a codex session, have it implement RFC-12 and run the tests; report back when green.”

    这会触发 session_spawn、dispatch、collect 等底层 MCP 工具。

4.2 多机协作（卫星模式）

  1. 在主 ccteam 控制台的 Settings → Access 中生成一个“卫星加入令牌”（join token）。

  2. 在另一台机器（如笔记本电脑）上安装 ccteam，然后运行：

    1
    ccteam satellite join <主控IP>:7331 <令牌>

    该机器会主动连接到主控，之后你就可以在主控制台的项目中选择该机器作为运行主机。

5. 更新与卸载

更新

1
ccteam update

这会原地更新二进制文件并重启 daemon。通过 DSH 插件安装的，可在插件设置的 Engine 部分点击“Update engine”。

卸载

1
2
curl -sSL https://raw.githubusercontent.com/firstintent/ccteam/main/install.sh | sh -s -- --uninstall
rm -rf ~/.ccteam        # 删除状态和密钥

对于单个项目，删除其目录下的 .ccteam/ 文件夹即可。

6. 故障排除

问题 可能原因与解决方法
ccteam 命令未找到 确保 ~/.local/bin 在你的 PATH 环境变量中。可重新打开终端或手动添加。
Web 控制台无法访问 检查防火墙是否允许 7331 端口。ccteam 绑定在 0.0.0.0，确保访问设备与主机在同一 LAN。
无法创建某 Vendor 的会话 1. 确认该 Vendor CLI 已安装。2. 确认已通过其官方命令完成登录认证。3. 在 Settings → Hosts 中查看其“就绪”状态。
跨机器（卫星）连接失败 确认主控 IP 和端口可达，卫星端网络能连通主控。检查主控防火墙。
成本或会话数据异常 可以查看 ccteam daemon logs -f 获取详细日志。会话状态以文件形式保存在项目目录的 .ccteam/ 中。

7. 总结

ccteam 通过提供统一的身份、路由、交付和成本核算层，将独立的 AI 编程助手整合成一个可编排的团队。它的部署相对简单，核心在于先准备好至少一个你喜欢的 CLI 助手，然后通过一条命令安装 ccteam 即可。

重要资源：