2026年【Claude Code系列教程】构建Subagents

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

在 Claude Code 中创建并使用专用的 AI subagent，以支持任务特定的工作流并提升上下文管理能力。

Claude Code 中的自定义 subagent 是专门的 AI 助手，可用于处理特定类型的任务。通过为任务提供定制的系统提示词、工具权限和独立的上下文窗口，subagent 能实现更高效的问题解决。

subagent 是 Claude Code 可委托任务的预配置 AI 角色。每个 subagent 具有以下特性：

当 Claude Code 遇到与某个 subagent 的专业领域相匹配的任务时，可以将该任务委托给对应的 subagent，由其独立执行并返回结果。

每个 subagent 在其独立的上下文中运行，避免污染主会话内容，使主线程保持专注于高层目标。

subagent 可根据具体领域进行详细配置，从而提升在特定任务上的成功率。

创建完成后，subagent 可在多个项目中复用，也可与团队成员共享，实现工作流标准化。

每个 subagent 可配置不同的工具权限，从而对关键工具进行权限管理和风险控制。

运行以下命令：

选择创建项目级或用户级的 subagent。

推荐做法：先由 Claude 自动生成，再在此基础上进行个性化调整。

你的 subagent 创建完成后即自动可用。Claude 会在合适时自动使用，也可以通过指令显式调用：

subagent 以带有 YAML frontmatter 的 Markdown 文件形式保存，可能存在于以下两个位置之一：

类型位置作用域优先级项目级 subagent 当前项目内可用高用户级 subagent 所有项目通用低

当存在同名 subagent 时，优先使用项目级的配置。

每个 subagent 定义为一个 Markdown 文件，格式如下：

字段是否必填描述是子代理的唯一标识符，使用小写字母和连字符是自然语言描述该 subagent 的使用场景和目标否逗号分隔的工具列表，留空则默认继承所有主线程工具

subagent 可访问 Claude Code 的所有内置工具。详见工具文档。

推荐： 使用命令配置工具访问权限，该命令提供交互界面，展示所有可用工具，包括 MCP 服务工具，便于选择所需权限。

工具配置有两种方式：

MCP 工具说明： subagent 可访问配置好的 MCP 服务中的工具。省略 tools 字段时将默认继承主线程的所有 MCP 工具。

命令提供完整的 subagent 管理界面：

该命令将打开交互菜单，你可以：

你也可以手动创建和管理 subagent 文件，例如：

Claude Code 会根据以下因素判断是否自动调用 subagent：

建议： 在中使用如 “use PROACTIVELY” 或 “MUST BE USED” 的措辞可提升自动调用概率。

你可以通过明确指定 subagent 来手动调用：

以下是完整的 Subagent 示例 模块内容翻译，未做缩略，并保留所有代码与提示词：

对于复杂流程，可顺序调用多个 subagent：

Claude Code 会根据上下文自动匹配 subagent。建议在字段中明确行为方式和使用场景。

2026年【Claude Code系列教程】 构建Subagents