项目简介

Claude Team是一个创新的MCP服务器,专门设计用于协调多个Claude Code会话的并行工作。它利用iTerm2的Python API创建新的终端窗口或分割面板,并在其中启动Claude Code,使一个"管理者"Claude会话能够控制和指导多个"工作者"会话。

主要功能

会话管理

  • 创建会话: 在新的iTerm2窗口或分割面板中生成Claude Code会话
  • 团队布局: 支持垂直、水平、四象限和三重垂直等多种布局
  • 状态监控: 实时查看各会话的工作状态(空闲、处理中、等待输入)
  • 会话发现: 自动扫描并识别iTerm2中已运行的Claude Code会话
  • 智能颜色: 为每个会话生成独特的标签颜色以便视觉区分

消息通信

  • 单点发送: 向特定工作者会话发送指令
  • 广播消息: 同时向多个会话发送相同消息

任务完成检测

  • 约定标记: 检测TASK_COMPLETE、TASK_FAILED等完成标记
  • Git提交检测: 通过git提交记录判断任务进度
  • Beads集成: 与轻量级问题追踪工具Beads无缝集成
  • 多策略检测: 结合对话分析、屏幕内容解析和空闲检测

安装步骤

前置要求

  • macOS操作系统
  • iTerm2(已启用Python API:Preferences → General → Magic → Enable Python API)
  • Python 3.11+ 和 uv包管理器

配置方法

在Claude Code的MCP设置中添加以下配置:

全局配置 ('~/.claude/settings.json')

{
  "mcpServers": {
    "claude-team": {
      "command": "uvx",
      "args": ["--from", "claude-team-mcp", "claude-team"]
}

基本使用流程

  1. 启动管理者会话: 在Claude Code中配置并启用claude-team MCP服务器

工作模式示例

基础使用

  • "生成一个新的Claude会话在/path/to/frontend"
  • "向worker-1发送消息:审查React组件"
  • "检查worker-1的工作进度"

并行工作分发

  • 创建多个工作者会话处理不同模块
  • 同时向各会话分配任务
  • 等待并收集所有工作者的响应

协调工作流

  • 先生成后端工作者创建API端点
  • 等待响应后,生成前端工作者对接新接口
  • 最后生成测试工作者编写集成测试

核心优势

  • 透明度: 使用真实的Claude Code会话,用户可以实时监控、干预或接管工作

信息

分类

开发者工具