定义子智能体
# .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 |
先免费试用
新账户可获得 $5 免费 API 额度 使用优惠码 CLAUDECODE — 足够用 Sonnet 运行 Claude Code 一晚,之后可获得面值 7.69231 倍的额度。
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key常见问题
Claude Code 中的子智能体是什么?
子智能体是一个独立智能体,拥有自己的系统提示词、工具权限、模型选择和上下文窗口,通过 .claude/agents/ 中的 Markdown 文件定义,由主会话向其委派任务。
Claude Code 子智能体文档在哪里?
官方参考文档位于 Anthropic 的 Claude Code 文档中的“子智能体”部分;本页是实用版,介绍文件格式、何时进行任务委派以及费用。
子智能体会产生额外费用吗?
它们与任何请求一样,按各自的 token 用量计费。通过避免将大量读取内容放入父智能体的上下文,它们可以降低长会话的费用;如果在 Opus 上并行运行多个子智能体,费用则会增加。
什么是智能体团队?
这是一项实验性扩展,多个 Claude Code 会话以具名队友的身份,通过消息和共享任务列表协作,而不是采用一个父智能体加短期助手的模式。
通过网关运行 Claude Code
相同的模型,两个环境变量,面值 7.69231 倍的额度,或固定费率不限量方案。 新账户:使用优惠码 CLAUDECODE 可获得 $5 免费 API 额度。
获取 API 密钥 查看不限量方案AI Prime Tech 是独立的 API 网关,与 Anthropic 无关联,也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据,且经常发生变化;本页面的价格和模型列表读取自此网关的实时设置。