Source: https://aiprimetech.io/zh/claude-code/subagents/

[首页](/zh/) › [Claude Code](/claude-code/zh/) › 子智能体

[概览](/claude-code/zh/)[安装](/claude-code/zh/install/)[CLI 参考文档](/zh/claude-code/cli/)[定价与限制](/claude-code/zh/pricing/)[Agent SDK](/zh/claude-code/sdk/)[技能与插件](/zh/claude-code/skills/)[GitHub](/zh/claude-code/github/)[网页、桌面与 IDE](/zh/claude-code/web-and-desktop/)[模型](/zh/claude-code/models/)[错误](/zh/claude-code/errors/)[是否开源？](/zh/claude-code/open-source/)[教程](/claude-code/zh/tutorial/)[学生指南](/zh/claude-code/for-students/)[QA 自动化](/zh/claude-code/qa-automation/)[与 Cursor 对比](/zh/claude-code/vs-cursor/)[与 Codex 和 OpenCode 对比](/zh/claude-code/vs-codex/)[子智能体](/zh/claude-code/subagents/)[钩子](/zh/claude-code/hooks/)[MCP](/zh/claude-code/mcp/)[生态系统](/zh/claude-code/ecosystem/)[VS Code](/zh/claude-code/vscode/)[OpenRouter](/zh/claude-code/openrouter/)[速率限制](/zh/claude-code/rate-limits/)[中文指南](/claude-code/zh/)

最后更新：2026 年 11 月

# Claude Code 子智能体：工作原理、定义方法与智能体团队

子智能体是独立的 Claude Code 工作单元，拥有自己的系统提示、工具权限，以及最重要的——自己的上下文窗口。主会话将任务委派给它，接收返回的摘要，同时保持自身上下文简洁。合理使用子智能体，可以让会话从运行一小时后性能下降，变为持续运行一整天。

## TLDR
- 将其定义为以下目录中的 Markdown 文件： .claude/agents/ （项目级）或 ~/.claude/agents/ （用户）：前置元数据包含名称、描述、工具和模型；正文是系统提示。
- 当描述与任务匹配时，Claude 会自动委派任务；也可以通过点名智能体来显式委派。
- 每个子智能体都有自己的上下文，并单独计算 token 费用；结果会以摘要形式返回。
- /agents 用于创建和管理它们；智能体团队则将这一理念扩展到会话之间的协调。

## 定义子智能体 

```
# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews a diff for correctness, security and test coverage. Use after any non-trivial change.
tools: Read, Grep, Glob, Bash(git diff *)
model: sonnet
---
You are a senior reviewer. Read the staged diff, list concrete defects with file:line,
flag untested paths, and stop. Do not edit files.
```

name 决定你如何调用它； description 决定 Claude 如何自主选择调用它，因此应将其写成路由规则（“在任何非简单改动之后使用”），而不是职位名称。 tools 限制它可以做什么——无法编辑内容的审查智能体更安全。 model 指定模型档位： haiku 用于探索和分类， sonnet 用于大多数工作， opus 用于困难步骤，或者 inherit 沿用父会话的设置。 

## 项目智能体与用户智能体 

以下目录中的文件： .claude/agents/ 属于仓库并随仓库一起分发——提交它们后，每位团队成员都能获得相同的审查、测试编写和迁移智能体。以下目录中的文件： ~/.claude/agents/ 归你个人所有，可跨项目使用。发生名称冲突时，项目智能体优先。 /agents 可在会话中列出、创建和编辑这两类智能体，无需手动修改文件。 

## Claude 何时委派任务 

有两种方式。隐式委派：主智能体读取每个子智能体的描述，并在任务匹配时委派——如果描述已经说明何时使用，就无需明确说“对此运行 code-reviewer 子智能体”。显式委派：在提示中点名它。无论哪种方式，子智能体都会在自己的上下文中运行，只能看到收到的内容和自己读取的内容，并返回结果，由主会话将其概括后纳入自身历史。子智能体不会再启动子智能体；层级只有一层。 

## 为什么它们能降低会话成本 

Claude Code 的每一轮交互都会重新发送整个对话。子智能体读取四十个文件时，会在自己的上下文窗口中完成；父智能体只会收到一段总结。如果不使用子智能体，这四十个文件就会在会话剩余期间一直留在主上下文中，并在每一轮重新发送。因此，大型代码库的使用模式是：用 Haiku 子智能体探查，用 Sonnet 子智能体审查，把父智能体的上下文留给决策。每个子智能体的 token 都单独计费——并非免费，只是消耗被限定在各自的上下文内。 

## 并行运行与速率限制 

可以同时运行多个子智能体，每个子智能体都是一个并行的流式请求。这是触及任何端点并发请求上限的最快方式，因此，使用新的网关账户时，先从两个或三个并行运行开始，等有实际工作负载后再申请提高并发上限。错误指南介绍了否则会遇到的 429。 

## 智能体团队 

较新的 Claude Code 版本加入了智能体团队：不再由一个父智能体向短期运行的子智能体委派任务，而是由多个会话以具名队友的身份协作，共享任务列表并相互发送消息，让负责人可以分配工作、询问进度和停止某个队友。这是一项需要通过设置启用的实验性功能，会随版本变化——请查看 claude --help 以及更新日志，了解当前的启用标志，不要以博客文章为准。其理解方式与子智能体相同，只是增加了持久运行和通信能力；成本模型也相同，只是要乘以队友数量。 

## 在网关上使用 

子智能体和团队使用与父会话相同的端点和密钥，因此 ANTHROPIC_BASE_URL=https://aiprimetech.io 适用于它们全部。在固定价格的不限量套餐中，并行运行的问题变成了合理使用问题，而不是计费问题，这也是重度多智能体用户往往最终选择这类套餐的原因。 

 | 计划 | 时长 | 价格

 | 1 小时不限量 | 1 小时 | $1

 | 24 小时不限量 | 24 小时 | $10

 | 1 周不限量 | 1 周 | $49

 | 15 天不限量 | 15 天 | $89

[所有不限量套餐 →](/zh/plans/)

## 先免费试用

新账户可获得 $5 免费 API 额度 使用优惠码 CLAUDECODE — 足够用 Sonnet 运行 Claude Code 一晚，之后可获得面值 7.69231 倍的额度。

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[使用优惠码 CLAUDECODE 创建账户](/register?promo=CLAUDECODE)

## 常见问题

Claude Code 中的子智能体是什么？

子智能体是一个独立智能体，拥有自己的系统提示词、工具权限、模型选择和上下文窗口，通过 .claude/agents/ 中的 Markdown 文件定义，由主会话向其委派任务。Claude Code 子智能体文档在哪里？

官方参考文档位于 Anthropic 的 Claude Code 文档中的“子智能体”部分；本页是实用版，介绍文件格式、何时进行任务委派以及费用。子智能体会产生额外费用吗？

它们与任何请求一样，按各自的 token 用量计费。通过避免将大量读取内容放入父智能体的上下文，它们可以降低长会话的费用；如果在 Opus 上并行运行多个子智能体，费用则会增加。什么是智能体团队？

这是一项实验性扩展，多个 Claude Code 会话以具名队友的身份，通过消息和共享任务列表协作，而不是采用一个父智能体加短期助手的模式。

## 通过网关运行 Claude Code

相同的模型，两个环境变量，面值 7.69231 倍的额度，或固定费率不限量方案。 新账户：使用优惠码 CLAUDECODE 可获得 $5 免费 API 额度。[获取 API 密钥](/register?promo=CLAUDECODE) [查看不限量方案](/zh/plans/)

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据，且经常发生变化；本页面的价格和模型列表读取自此网关的实时设置。

## 更多 Claude Code 指南

[Claude Code：完整指南](/claude-code/zh/)[如何安装 Claude Code](/claude-code/zh/install/)[Claude Code CLI 文档：命令与参数](/zh/claude-code/cli/)[Claude Code 定价与限制详解](/claude-code/zh/pricing/)[Claude Code SDK，现已更名为 Claude Agent SDK](/zh/claude-code/sdk/)[Claude Code 技能与插件](/zh/claude-code/skills/)[在 GitHub 中使用 Claude Code：App、Action 和 @claude](/zh/claude-code/github/)[Claude Code 有网页界面吗？网页、桌面与 IDE 版本详解](/zh/claude-code/web-and-desktop/)[Claude Code 使用哪个模型，以及如何更改](/zh/claude-code/models/)[Claude Code 错误及修复方法](/zh/claude-code/errors/)[Claude Code 开源吗？](/zh/claude-code/open-source/)[Claude Code 教程：您的首次实际会话](/claude-code/zh/tutorial/)[学生使用 Claude：Claude Code、API，以及教育优惠实际提供什么](/zh/claude-code/for-students/)[如何使用 Claude Code 实现 QA 自动化](/zh/claude-code/qa-automation/)[Claude Code 与 Cursor 对比：如何选择、何时使用，以及如何同时使用两者](/zh/claude-code/vs-cursor/)[Claude Code、Codex 与 OpenCode：终端智能体对比](/zh/claude-code/vs-codex/)[Claude Code 钩子：以确定性方式控制智能体的行为](/zh/claude-code/hooks/)[Claude Code MCP：连接服务器、作用域、远程 MCP 与实际示例](/zh/claude-code/mcp/)[Claude Code 生态系统：路由器、框架、插件及收录它们的清单](/zh/claude-code/ecosystem/)[在 VS Code 中使用 Claude Code：扩展、终端方式与常见错误](/zh/claude-code/vscode/)[如何在 Claude Code 中使用 OpenRouter（以及何时不宜使用）](/zh/claude-code/openrouter/)[Claude 速率限制错误：“API error: rate limit reached”的含义与解决方法](/zh/claude-code/rate-limits/)[Claude Code 怎么用：从安装到日常使用](/claude-code/zh/)