Claude Code Agent Teams 协作指南
Claude Code Agent Teams 让多个 Claude 实例并行协作完成复杂工程任务。一个 Lead Agent 统筹全局，多个 Teammate Agent 并行执行子任务，效率提升 3-5x。
Agent Teams vs 子代理（Subagents）
两种多 Agent 模式，适用不同场景——了解何时选择 Agent Teams，何时使用轻量子代理。
| 维度 | Agent Teams | 子代理（Subagents） |
|---|---|---|
| 协作模式 | 多会话并行，Lead 统筹 | 同会话串行调用 |
| 适用规模 | 大型项目（>1000 行变更） | 中小任务，快速委派 |
| 通信方式 | 共享任务列表 + 信箱消息 | 直接函数调用 |
| 模型要求 | Lead 需 Opus 4.6+ | 任意模型 |
协作架构
Lead Agent 作为项目经理，负责任务拆解与结果整合；Teammate Agents 并行执行具体子任务。
Lead（统筹）
Lead Agent (Opus 4.7)
共享任务列表
所有 Agent 读写
信箱（Mailbox）
Agent 间消息传递
Teammate 1
前端任务
Teammate 2
后端任务
Teammate 3
测试任务
Lead Agent
整个团队的「项目经理」，使用 Opus 4.7 模型，负责理解需求、拆解任务、分配给 Teammates 并汇总结果。
Teammate Agent
执行具体子任务的专责 Agent，可使用 Sonnet 4.6 节省成本，完成后将结果写入共享任务列表。
共享任务列表
所有 Agent 共享的结构化任务清单，Lead 创建任务，Teammate 领取并更新状态，实现协调无冲突。
信箱通信
Agent 间的异步消息系统，用于传递复杂上下文、请求澄清或汇报阶段性成果，避免直接调用的耦合。
启用与配置
在 CLAUDE.md 中声明 Agent Teams 工作模式，Claude Code 将自动在合适场景启用多 Agent 协作。
前置要求
- Claude Code v2.1.32 或更高版本
- Lead Agent 使用 claude-opus-4-7 模型
- QCode.cc API Key（支持 Opus 4.7）
通过 QCode.cc 使用
QCode.cc 完整支持 Agent Teams 所需的所有模型（Opus 4.7 / Sonnet 4.6），多会话并行请求不受限制。
CLAUDE.md 配置示例
# CLAUDE.md — 启用 Agent Teams 模式
# 告知 Claude 允许启动多 Agent 协作
## Agent Teams 配置
- 复杂任务自动拆解为子任务
- 最多 5 个并行 Teammate Agent
- Lead Agent 使用 claude-opus-4-7
- Teammate Agent 使用 claude-sonnet-4-6
## 任务分配原则
- 前端/后端/测试可并行执行
- 需要共享上下文时通过 mailbox 通信
- 每个 Teammate 完成后更新共享任务列表Custom Subagents（@ mention）
Claude Code v2.1.32+ 支持通过 @ 语法定义并调用专家子代理，每类任务都有专属 AI 处理。
什么是 Custom Subagent
在 `.claude/agents/` 目录下创建 Markdown 文件，定义专属角色、能力边界与行为规范。@ 召唤时，该子代理以专属身份处理特定类型任务，输出更聚焦、更专业。
使用示例
@security-auditor
专注安全漏洞审计
@perf-optimizer
性能瓶颈分析与优化
@doc-writer
API 文档与注释生成
定义自定义子代理
# .claude/agents/security-auditor.md
---
name: security-auditor
description: 专职安全审计 Agent，分析代码漏洞
model: claude-opus-4-7
tools: [read_file, bash]
---
你是一名资深安全工程师，专注于：
- OWASP Top 10 漏洞检测
- SQL 注入与 XSS 防护
- 认证与授权逻辑审查
- 依赖库安全扫描
收到代码后，输出结构化的漏洞报告。