本指南介绍 Claude Code 的子代理机制。子代理是可被委派任务的专用 AI 助手，各自拥有独立上下文窗口、可配置工具与自定义系统提示。核心价值在于上下文卫生：把冗长的工具输出（git status、构建日志、部署输出等）隔离在子代理上下文中，主会话仅接收摘要，从而显著节省上下文。
内置子代理有三种：Explore（Haiku 模型，严格只读，支持 quick/medium/very thorough 三种彻底程度，用于代码库探索）；Plan（Sonnet，只读研究，计划模式下自动调用）；general-purpose（Sonnet，可读写，适合复杂多步任务）。
自定义代理以带 YAML frontmatter 的 Markdown 文件编写，可放在 .claude/agents/（项目级）、~/.claude/agents/（用户级）或用 CLI --agents '{...}' 指定；名称冲突时项目级优先。字段包括 name、description（必填）、tools、model（sonnet/opus/haiku/inherit）、permissionMode、skills、hooks。注意：代理仅在会话启动时加载，新建文件后必须重启会话才生效。若要从子代理访问 MCP 工具，必须完全省略 tools 字段；写任何工具都会变成白名单，且“*”非通配符。子代理不会继承父级 skills。
文件创建代理若不需要执行命令，建议移除 Bash 以避免每次 heredoc 都触发审批；关键指令应放在 frontmatter 之后最前面。可用 /agents 交互管理，或在 settings.json 的 permissions.deny 中禁用 Task(Explore) 等。
编排：给代理加上 Task 工具即可生成其他子代理，实现并行或链式工作流；建议嵌套最多两层。子代理可被恢复（通过返回的 agentId）继续先前上下文。模型选择上默认推荐 Sonnet 以保证质量，Haiku 仅用于质量无关的简单脚本。
资料未提供的部分：具体价格与收费、实际使用效果数据、安装命令等暂未提供。