创建你的第一个 Claude Code 子智能体

子智能体（subagent）是 Claude Code 可以把某个子任务交出去处理的专门助手。它运行在自己独立的上下文窗口中，拥有自己的系统提示词和自己的一套工具，完成后只把一份结果摘要返回给你。

这种隔离正是关键所在。当 Claude 把工作委派给子智能体时，那些冗长的内容——搜索结果、日志、你再也不会回头看的文件内容——都留在子智能体的上下文里，而不会涌入你的主对话。你的主会话因此保持专注、清爽。

当一个任务相对自成一体、而你只关心结果、不关心中间那些嘈杂的过程时，就该考虑子智能体。根据官方文档，子智能体可以帮你：

• 保护上下文——把探索和大量输出挡在主对话之外。
• 施加约束——限制子智能体可以使用哪些工具（例如一个只读的审查者，不带 Write 或 Edit）。
• 复用配置——把一个工作者定义一次，便可在各个项目中重复使用。
• 专注行为——给它一段聚焦于某一领域的系统提示词。

一个经验法则：需要频繁来回、迭代修改的快速改动，留在主对话里做；而当工作会产生你不需要保留的冗长输出、或你希望施加特定的工具限制时，用子智能体。

创建和管理子智能体的推荐方式是 /agents 命令。在 Claude Code 会话中运行：

/agents

这会打开一个分页界面。切换到 Library（库）标签页，选择 Create new agent（新建智能体），然后选择一个作用范围：

• Personal（个人）会把它保存到 ~/.claude/agents/，从而在你的所有项目中都可用。
• Project（项目）会把它保存到当前仓库的 .claude/agents/，这样你就能把它纳入版本控制并与团队共享。

随后 Claude 可以根据你用自然语言写的描述，为你生成标识符、描述和系统提示词，接着你再选择该子智能体应使用的工具和模型。保存之后，子智能体立即可用。

在底层，每个子智能体其实就是一个带 YAML frontmatter 的 Markdown 文件。其中只有 name 和 description 是必填的；正文部分会成为子智能体的系统提示词。下面是官方的 code-reviewer（代码审查者）示例——一个无法修改你文件的只读审查者：

---
name: code-reviewer
description: Expert code review specialist. Use immediately after writing or modifying code.
tools: Read, Grep, Glob, Bash
model: inherit
---

You are a senior code reviewer ensuring high standards of
code quality and security.

When invoked:
1. Run git diff to see recent changes
2. Focus on modified files
3. Begin review immediately

有几点值得了解：

• tools 是可选的——省略它，子智能体便会从主对话继承全部工具；像上面那样列出工具，则会把它限制为仅这些。
• model 默认为 inherit（与你的会话使用同一模型）。你也可以设为 sonnet、opus 或 haiku。
• description 决定了 Claude 何时去委派任务。加上 “use proactively”（主动使用）会鼓励它自行调用该子智能体。

子智能体一旦存在，Claude 往往会根据它的 description 自动委派任务。你也可以显式调用——只需用自然语言点名它：

用 code-reviewer 子智能体看看我最近的改动

要确保某个特定的子智能体被运行，可以用 @ 提及它（输入 @，再从列表中选择，就像 @ 文件一样）。Claude 会进行委派，子智能体在隔离环境中完成工作，最后只把摘要返回给你。