子代理架构(Sub-Agent)#
子代理是 Cursor/Claude Code 主代理可以将任务委派给的专业化 AI 助手。每个子代理都在自己的上下文窗口中运行,处理特定类型的工作,并将结果返回给父代理。使用子代理可以拆解复杂任务、并行开展工作,并在主对话中保留上下文。
Subagents 是处理特定类型任务的专门 AI 助手。每个 subagent 在自己的上下文窗口中运行,具有自定义系统提示、特定的工具访问权限和独立的权限。当 Claude 遇到与 subagent 描述相匹配的任务时,它会委托给该 subagent,该 subagent 独立工作并返回结果。
子代理架构则换了一个思路:既然一个模型的上下文有限,那就让多个模型分工合作,每个模型只需要关注自己负责的那部分上下文,即分而治之。详见 《上下文设计哲学》· 子代理架构(Sub-Agent) 。
subagents 的价值是“换脑子”:把某类任务的角色、目标、输出格式与权限边界隔离出来,让它像专职同事一样稳定完成长链路工作。
为什么使用 Subagents#
Subagents 帮助你:
- 保留上下文 - 将探索和实现保留在独立上下文中,不污染主对话
- 强制约束 - 限制 Subagent 可使用的工具
- 复用配置 - 用户级 Subagent 跨项目可用
- 专业化行为 - 使用专注的系统提示处理特定领域
- 控制成本 - 将任务路由到更快、更便宜的模型如 Haiku
内置 Subagents#
Claude Code 包含以下内置 Subagent,Claude 会在适当时自动使用:
Explore#
快速、只读的代理,优化用于搜索和分析代码库。
模型:Haiku(快速、低延迟) 工具:只读工具(禁止 Write 和 Edit) 用途:文件发现、代码搜索、代码库探索
Claude 在需要搜索或理解代码库但不做修改时委托给 Explore。
Plan#
计划模式下使用的研究代理,在呈现计划之前收集上下文。
模型:继承主对话模型 工具:只读工具 用途:规划阶段的代码库研究
general-purpose#
通用代理,处理需要探索和操作的复杂多步任务。
一句话定位#
subagents 负责回答:这件事需要换角色/隔离权限/治理过程,让输出更稳定。
适用场景#
- 需要专职角色:架构评审、代码审查、安全审计、复杂排障、发布把关。
- 链路长/步骤多:需要更强的过程治理(阶段划分、停顿点、验收项)。
- 需要权限隔离:例如只允许做只读分析,或所有写入/执行都需要二次确认。
- 需要降低上下文污染:把子任务从主对话拆出去。
快速决策#
一个好用的区分法是:
- skills 改变的是“知道什么”(SOP/清单/方法论)。
- subagent 改变的是“谁在干活”(角色/权限/工作流/输出契约)。
当你遇到以下信号,优先 subagent:
- 需要做方案权衡,并给出取舍理由。
- 需要做审查/把关(质量、安全、边界、兼容性)。
- 需要做复杂排障(多轮假设验证、反复收集证据)。
- 需要严格的输入/输出格式,否则无法落地。
- 需要权限隔离:例如只读分析/禁止写入/外部请求需确认。
- 主对话上下文容易被污染:需要把子任务拆出去并行探索。
配置截图#
