用途：让多个 Claude CLI 进程通过基于文件系统的协调协议共同完成共享工作。每个队友作为独立的 claude 进程运行在 tmux 窗格中，通过受 fcntl 锁保护的 JSON 文件通信，无需数据库、守护进程或网络层。
主要能力：团队配置与成员管理、任务依赖图（blocks/blocked_by）、收件箱消息协调、角色划分（implementer、researcher、tester、reviewer、architect）、团队规模规则（简单 1、中等 2-4、复杂 5-7、关键 5-10，上限 10）、心跳与停滞检测（每 60s 轮询，两阶段检测）、优雅关闭。
使用方式：先验证环境，claude --version、tmux -V，并设置 export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。团队数据位于 ~/.claude/teams/<team-name>/（config.json、inboxes/）与 ~/.claude/tasks/<team-name>/。通过带身份标志的 claude 命令启动队友，例如 claude --agent-id "backend@my-team" --agent-name "backend" --team-name "my-team" --agent-color "#FF6B6B" --parent-session-id "$SESSION_ID" --agent-type "general-purpose" --model sonnet。任务与消息以 JSON 文件形式创建和交换。
适用场景：跨多文件或模块的并行实现、多智能体代码审查、大型重构、天然可并行且需要协调发现的任务。
限制：单文件或小任务不适用；需要紧密顺序推理的任务不适用；需 claude CLI 与 tmux。文件系统时间戳精度有限，快速消息突发需用编号或 UUID 文件名。崩溃可能残留 .lock 文件或孤立任务。企业提供商上旧版本（2.1.39 前）可能出现模型标识错误。Claude Code 2.1.49+ 可用 isolation: worktree 作为替代隔离方案。