一、什么是 SubAgent
SubAgent 是 Claude 在运行时创建的独立实例。每个 SubAgent 拥有自己完整的上下文窗口（和主对话一样大）、独立的工具权限、独立的任务——接到指令，执行完毕，把结果返回主对话，然后销毁。可以理解为 Claude 创造了一个"分身"，但这个分身有完全独立的工作空间。
不需要任何配置。Claude 自动判断当前任务是否需要拆分、拆成几路、每路负责什么。你也可以在提示中明确要求拆分方式。
SubAgent 解决的根本问题不只是"快"——串行处理有三个结构性瓶颈：
- 上下文污染：让 Claude 在主对话里做大量探索，所有搜索结果、文件内容、中间推理都堆进同一个上下文窗口。即使这些信息对后续任务毫无用处，它们也会一直占据空间。SubAgent 把探索过程隔离在独立窗口中，只把结论返回主对话。
- 注意力衰减：上下文窗口虽然容量很大，但 LLM 的有效注意力并非均匀分布——越靠后进入窗口的信息，被关注的概率越低。SubAgent 让每个任务都在干净的、完整注意力的环境中执行。
- 缺乏专精：一个实例同时处理代码审查、安全检测、性能分析，每个维度都只能浅尝辄止。多个 SubAgent 各管一个维度，每个都能深入。
二、为什么需要它
你在写文献综述，需要分析 5 篇核心论文。每篇都要整理：研究方法、核心发现、局限性、与你课题的关联、引用价值。
逐篇串行分析时：
Claude 从第一篇开始，逐篇读。每分析完一篇，之前的结果占据注意力空间，留给后面的空间越来越少。前两篇分析详尽，后面几篇开始粗糙——局限性漏提、关联分析笼统。
用 SubAgent 并行分析时：
Claude 创建 5 个分身，每个只看一篇论文，独立工作。每路都有完整的注意力空间，不会因为前几篇的内容而分心。
| 逐篇串行 | SubAgent 并行 | |
|---|---|---|
| 时间 | ~25 分钟 | ~5 分钟 |
| 质量 | 后期明显下降 | 每篇同等深度 |
| 注意力 | 被前序分析挤占 | 各自独立，互不干扰 |
SubAgent 最擅长这类多角度分析和大规模并行。如果任务本身是线性的——必须先做 A 再做 B——SubAgent 帮不上忙。
三、怎么触发
Claude 自主判断： 当任务足够复杂时，Claude 会自行决定创建 SubAgent。你不需要做任何事——描述任务即可，Claude 判断是否拆分。
自然语言请求： 在对话中明确表达并行/拆分意图，Claude 使用 SubAgent 的概率会显著提高：
"帮我从多个角度分析这份材料"
"请使用 SubAgent 并行处理这几个任务"
"分几个部分同时做，做完汇总给我"
自定义 Agent + @ 调用： 你可以在 .claude/agents/ 目录下定义专门的 Agent——指定它的角色、工具权限和工作方式。定义后在对话中输入 @ 即可从列表中选择调用，这是唯一保证触发的方式。自定义 Agent 适合反复出现的特定任务类型（如代码审查、文档翻译），相当于预设好身份和职责的 SubAgent。
可以在 CLAUDE.md 中写入工作指令，比如"遇到多维度分析任务时，优先使用 SubAgent 并行处理"。这样 Claude 在每次会话中都会倾向于使用 SubAgent。