第10课：Agent 体系，认识你的 AI 团队成员

阅读时长：约25分钟 难度：★★★☆☆ 适合人群：已掌握核心技能篇，准备解锁 Claude Code 更深层能力的开发者 学完之后：你会知道 Claude Code 里有哪些"专业角色"可以调用、每种角色擅长什么、怎么调用

进阶能力篇正式开始

核心技能篇教你"怎么写好 prompt"——目标型思维、并行策略、验证体系、CLAUDE.md、模板库。这些是你用好 Claude Code 的基本功。

但你有没有注意到一个问题？

你一直在跟"一个 Claude"对话。不管是写代码、审查代码、修 Bug 还是写文档，都是同一个 Claude 在干。

这就像你雇了一个人，让他同时当程序员、测试员、安全专家、文档写手。他确实都能做，但每样都不是最优的。

实际上，Claude Code 里不只有"一个 Claude"。它有一套完整的 Agent 体系——8种专门角色，每种针对特定任务优化。你可以同时调动多个 Agent 并行工作，就像你有一个分工明确的开发团队。

这就是从"用一个助手"升级到"指挥一个团队"的关键。

什么是 Agent

在 Claude Code 里，Agent 是一个专门的子流程。它有几个特点：

• 独立运行：每个 Agent 有自己的上下文，不会互相干扰
• 专业分工：不同类型的 Agent 针对不同任务优化
• 可以并行：多个 Agent 可以同时工作
• 汇总结果：所有 Agent 的输出最终汇报给主对话

打个比方：你是项目经理（导演），Claude 的主对话是你的助理，Agent 们是你的团队成员。你跟助理说"安排三个人同时做这三件事"，助理就会派出三个 Agent，做完之后把结果汇总给你。

Task Tool：调用 Agent 的方式

你通过 Task Tool 来启动 Agent。语法很简单：

Task({
  subagent_type: "Explore",           // 必填：Agent 类型
  model: "haiku",                      // 可选：使用什么模型
  prompt: "你的任务描述",               // 必填：让 Agent 做什么
  run_in_background: false             // 可选：是否后台执行
})

四个参数：

subagent_type  → 派谁去做（哪种 Agent）
model          → 给他什么级别的"脑力"（haiku/sonnet/opus）
prompt         → 让他做什么（任务描述）
run_in_background → 是等他做完，还是让他在后台做

你不需要手动写这个语法。 你只需要用自然语言告诉 Claude 你要做什么，Claude 会自动判断该派哪种 Agent、用什么模型。但理解这个语法能帮你在需要精确控制时知道怎么指定。

8种 Agent：你的团队花名册

我用一个开发团队的类比来帮你记住这8种 Agent。

┌─────────────────────────────────────────────────────────┐
│                  你的 AI 开发团队                         │
│                                                         │
│  🔍 情报兵（Explore）        快速扫描代码库，收集情报     │
│  🔧 主力工程师（general-purpose）  写代码、改代码、复杂任务 │
│  📋 代码审查员（code-reviewer）     审查代码质量和模式     │
│  🛡️ 安全专家（security-auditor）   找漏洞、查风险        │
│  🧪 测试工程师（test-runner）       跑测试、分析覆盖率     │
│  🔬 故障侦探（debugger）           追踪 Bug 根因         │
│  🧹 重构专家（refactor-assistant）  整理和优化代码        │
│  📝 文档写手（doc-writer）          写文档、更新文档       │
│                                                         │
└─────────────────────────────────────────────────────────┘

下面逐个介绍。每种 Agent 我会告诉你：它擅长什么、什么时候用、怎么调用、用什么模型。

🔍 Explore Agent —— 情报兵

角色定位：快速扫描代码库，收集你需要的信息。不写代码，不改文件，只看和分析。

擅长的事：

• 在大型项目中快速找到某个功能的相关文件
• 理解一个模块的结构和依赖关系
• 搜索代码中的特定模式（比如"所有用了 JWT 的地方"）
• 分析最近的代码变更

调用示例：

Task({
  subagent_type: "Explore",
  model: "haiku",
  prompt: "Explore 用户认证模块 (thoroughness: medium). 找到所有 JWT 相关的函数和它们的调用关系。"
})

独有特性——thoroughness（彻底程度）：

Explore Agent 有三个搜索深度，你可以根据需要选择：

thoroughness: quick     → 10-30秒，快速定位特定文件或函数
thoroughness: medium    → 30-60秒，理解一个模块的完整结构（推荐）
thoroughness: very thorough → 60-120秒，深度分析完整的调用链和数据流

为什么 Explore 比你手动翻代码快？

手动翻代码：你需要一个文件一个文件打开、搜索关键字、跳转到引用、再搜索下一层……5步操作，每步10-15秒，总共1分钟以上。

Explore Agent：一个 prompt 发出去，它同时做所有这些搜索，30秒返回结果。

而且它可以启动多个： 5个 Explore Agent 同时从5个方向搜索，30秒内获得全方位的代码地图。这是第11课会详细讲的"分析群集"模式。

推荐模型：Haiku（快+便宜，Explore 就是要快）