项目简介
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"] }
基本使用流程
- 启动管理者会话: 在Claude Code中配置并启用claude-team MCP服务器
工作模式示例
基础使用
- "生成一个新的Claude会话在/path/to/frontend"
- "向worker-1发送消息:审查React组件"
- "检查worker-1的工作进度"
并行工作分发
- 创建多个工作者会话处理不同模块
- 同时向各会话分配任务
- 等待并收集所有工作者的响应
协调工作流
- 先生成后端工作者创建API端点
- 等待响应后,生成前端工作者对接新接口
- 最后生成测试工作者编写集成测试
核心优势
- 透明度: 使用真实的Claude Code会话,用户可以实时监控、干预或接管工作
信息
分类
开发者工具