用途：这是 Claude Code 子代理（Subagent）的参考文档。子代理是在独立上下文窗口中运行的专用 AI 助手，拥有自定义系统提示、特定工具访问权限和独立权限，适合处理会淹没主对话且无需再次引用的任务，只返回摘要。
主要能力：保留主对话上下文；通过限制工具使用来约束行为；用用户级子代理跨项目复用配置；将任务路由到更快更便宜的模型（如 Haiku）以控制成本。默认支持最多三层嵌套子代理，可用 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 调整，设为 1 禁用嵌套；fork 不能再派生 fork。内置子代理包括 Explore、Plan、general-purpose、statusline-setup、claude-code-guide。
使用方式：子代理是带 YAML frontmatter 的 Markdown 文件，按优先级存放于托管设置、--agents CLI 标志、.claude/agents/、~/.claude/agents/、插件 agents/ 目录。项目、用户和托管代理需 name 与 description，其余字段可选，包括 tools、disallowedTools、model、permissionMode、maxTurns、skills、mcpServers、hooks、memory、background、omitClaudeMd、effort、isolation、color、initialPrompt 等。插件代理忽略 hooks、mcpServers、permissionMode，且不支持 initialPrompt。调用方式有自然语言、@-mention（插件用 @agent- 加作用域名）和会话级 claude --agent code-reviewer；也可在 .claude/settings.json 设默认。子代理在会话启动时加载，直接改磁盘文件需重启会话，通过 /agents 界面创建则立即生效。
限制：AskUserQuestion、EnterPlanMode、ExitPlanMode（除非 permissionMode: plan）、ScheduleWakeup、WaitForMcpServers 等工具对子代理不可用。相关环境变量包括 CLAUDE_CODE_SUBAGENT_MODEL、CLAUDE_CODE_SUBAGENT_MODEL_FORCE、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS、TASK_MAX_OUTPUT_LENGTH 等。