Claude Code 子代理 —— frontmatter 字段和官方内置代理类型。
| ← 返回 Claude Code 最佳实践 |  |
| 字段 | 类型 | 必需 | 说明 |
|---|---|---|---|
name |
string | 是 | 使用小写字母和连字符的唯一标识符 |
description |
string | 是 | 何时调用。使用 "PROACTIVELY" 以使 Claude 自动调用 |
tools |
string/list | 否 | 逗号分隔的允许工具列表（例如 Read, Write, Edit, Bash）。如果省略则继承所有工具。支持 Agent(agent_type) 语法以限制可生成的子代理；旧的 Task(agent_type) 别名仍然有效 |
disallowedTools |
string/list | 否 | 要拒绝的工具，从继承或指定的列表中移除 |
model |
string | 否 | 要使用的模型：sonnet、opus、haiku、完整模型 ID（例如 claude-opus-4-6）或 inherit（默认：inherit） |
permissionMode |
string | 否 | 权限模式：default、acceptEdits、auto、dontAsk、bypassPermissions 或 plan |
maxTurns |
integer | 否 | 子代理停止前的最大代理轮次数 |
skills |
list | 否 | 在代理启动时预加载到代理上下文中的技能名称（完整内容注入，不仅仅是使其可用） |
mcpServers |
list | 否 | 此子代理的 MCP 服务器 —— 服务器名称字符串或内联 {name: config} 对象 |
hooks |
object | 否 | 作用于此子代理的生命周期 Hook。支持所有 Hook 事件；PreToolUse、PostToolUse 和 Stop 是最常见的 |
memory |
string | 否 | 持久记忆范围：user、project 或 local |
background |
boolean | 否 | 设置为 true 以始终作为后台任务运行（默认：false） |
effort |
string | 否 | 此子代理激活时的努力级别覆盖：low、medium、high、max（仅 Opus 4.6）。默认：从会话继承 |
isolation |
string | 否 | 设置为 "worktree" 以在临时 git worktree 中运行（如果没有更改则自动清理） |
initialPrompt |
string | 否 | 当此代理作为主会话代理运行（通过 --agent 或 agent 设置）时自动作为第一条用户消息提交。处理命令和技能。前置到任何用户提供的提示 |
color |
string | 否 | 任务列表和转录中子代理的显示颜色：red、blue、green、yellow、purple、orange、pink 或 cyan |
| # | 代理 | 模型 | 工具 | 说明 |
|---|---|---|---|---|
| 1 | general-purpose |
inherit | All | 复杂的多步骤任务 —— 研究、代码搜索和自主工作的默认代理类型 |
| 2 | Explore |
haiku | 只读（无 Write、Edit） | 快速的代码库搜索和探索 —— 优化用于查找文件、搜索代码和回答代码库问题 |
| 3 | Plan |
inherit | 只读（无 Write、Edit） | 计划模式中的预规划研究 —— 在编写代码之前探索代码库并设计实现方法 |
| 4 | statusline-setup |
sonnet | Read, Edit | 配置用户的 Claude Code 状态栏设置 |
| 5 | claude-code-guide |
haiku | Glob, Grep, Read, WebFetch, WebSearch | 回答关于 Claude Code 功能、Agent SDK 和 Claude API 的问题 |