在 Claude Code 中，你可以创建 专门的 AI 子代理（Subagent） ，用于处理特定类型的任务，从而获得更好的上下文管理、更强的约束控制和更高的执行效率。
子代理 是运行在 独立上下文窗口 中的专用 AI 助手。
每个子代理都可以拥有：
当 Claude 判断你的请求 符合某个子代理的描述（description） 时，就会自动将任务委托给该子代理，由它独立完成并返回结果。
为什么要使用子代理？
子代理的核心价值在于 隔离 + 专业化 。
它可以帮助你：
保留主对话上下文
强制执行约束
跨项目复用
行为专业化
控制成本
一句话总结：
子代理 = 专门干某一类事的 AI 工具人
Claude Code 内置的子代理
Claude Code 已内置多种子代理，通常会自动使用，你不需要手动配置。
1、Explore（探索代理）
用途： 只读搜索与分析代码库
场景：
Claude 会在需要看代码但不改代码时自动使用 Explore。
支持不同探索深度： quick / medium / very thorough 。
2、Plan（规划代理）
用途： 计划模式下的代码库研究
它的作用是：
在不产生嵌套代理的前提下，安全收集规划所需信息
3、General-purpose（通用代理）
用途： 复杂、多步骤任务
4、其他内部代理（无需手动使用）
快速入门：创建你的第一个子代理
推荐方式：使用 /agents 命令
1、打开子代理管理界面
/agents
2、创建用户级子代理
3、使用 Claude 自动生成
示例描述：
Claude 会生成系统提示和初始配置，你可以按 e 手动编辑。
4、选择工具权限
5、选择模型
推荐： Sonnet
6、保存并使用
使用 code - improver 子代理为此项目提出改进建议
子代理会独立运行并返回结果。
子代理的作用范围
子代理本质是 带 YAML frontmatter 的 Markdown 文件 ，不同位置代表不同作用范围。
使用建议
项目子代理
用户子代理
CLI 子代理
子代理配置文件结构
--- name: code-reviewer description: Reviews code for quality and best practices tools: Read, Grep, Glob model: sonnet permissionMode: default --- You are a senior code reviewer. Analyze code and provide actionable feedback.
必填字段
常用字段说明
权限模式（务必理解）
⚠️ bypassPermissions 只适合完全可信的子代理
如何使用子代理
自动委托
Claude 会根据你的描述自动判断：
让 code-reviewer 子代理检查最近的改动
前台 vs 后台
快捷键：
典型使用模式
1、隔离高输出任务
使用子代理运行测试，只返回失败的测试
2、并行研究
并行使用子代理分析认证、数据库和 API 模块
3、串联子代理
先用 code - reviewer 找问题， 再用 optimizer 修复问题
子代理上下文与恢复
继续刚才的 code - reviewer 分析，重点看授权逻辑
存储位置示例：
~/.claude/projects/{project}/{sessionId}/subagents/
什么时候该用子代理？
用主对话，当：
用子代理，当：
子代理不能再创建子代理
子代理不能再创建子代理需要嵌套 → 用 技能（Skills）
