Subagent 设计模式
阅读提示:Subagent 是 Claude Code 的"专业分工"机制,用对场景才能发挥最大价值。本文基于官方文档和 100+ 社区 Subagent 实践总结。
9.1 什么是 Subagent
Subagent(子代理)是在独立上下文窗口中运行的专门 AI 助手,具有:
- 自定义系统提示
- 特定的工具访问权限
- 独立的权限控制
当 Claude 遇到匹配 Subagent description 的任务时,会自动委托给它处理。
为什么需要 Subagent
| 问题 | Subagent 的解决方案 |
|---|---|
| 上下文污染 | 隔离探索和实现,保持主对话清爽 |
| 权限失控 | 限制特定任务只能使用特定工具 |
| 重复配置 | 跨项目复用用户级 Subagent |
| 专业需求 | 针对特定领域的专属提示词 |
| 成本控制 | 将任务路由到更便宜的模型(如 Haiku) |
9.2 内置 Subagent 类型
Explore(探索型)
模型: Haiku(快速、低延迟)
工具: 只读工具(无 Write/Edit)
用途: 文件发现、代码搜索、代码库探索
使用场景:Claude 需要搜索或理解代码库但不需要修改时,自动委托给 Explore。
彻底性级别:
quick:针对性查找medium:平衡探索very thorough:全面分析
Plan(规划型)
模型: 继承主会话
工具: 只读工具
用途: Plan 模式下的代码库研究
使用场景:在 Plan 模式下,当 Claude 需要理解代码库时委托给 Plan Subagent。这防止了无限嵌套(Subagent 不能生成其他 Subagent)。
General-purpose(通用型)
模型: 继承主会话
工具: 所有工具
用途: 复杂研究、多步骤操作、代码修改
使用场景:当任务需要同时探索和修改,或需要复杂推理,或多个依赖步骤时使用。
AI 编程知识库会员专享内容
开通后解锁「Subagent 设计模式」全文,AI 编程知识库全年访问
扫码添加企业微信,找大熊掌门开通会员

添加后说明想开通的会员类型即可