Subagent 子代理完整指南：官方 Subagents、Agent 委派与社区代理资源
输入“/”快速插入内容
Subagent 子代理完整指南：官方 Subagents、Agent 委派与社区代理资源
Subagent 子代理完整指南：官方 Subagents、Agent 委派与社区代理资源
用户6572用户657210月4日修改
2月12日创建
2613
4538
3
0
课程信息
•
作者：老金
•
•
公众号：老金带你玩AI
•
X（Twitter）：老金带你玩AI
•
•
预计学时：1-2小时
•
难度等级：⭐⭐⭐ 中级
•
更新日期：2026年10月3日
•
适用版本：Claude Code v2.1.270 为 2026-09-14 的历史参考；截至 2026-10-03 的新增行为按正文标注版本与官方文档
📚 本课学习目标
我把子代理当成分工工具，不当成神奇按钮；多开一个 agent 之前，先问清它到底负责什么。
2026-08-06 操作口径：v2.1.198 起 subagent 默认在后台运行（Explore agent 现继承主会话模型而非 haiku）；v2.1.219 起嵌套深度默认提升到 3 层（v2.1.217 曾临时回退到 0，v2.1.219 恢复到 3）；同时引入防失控上限——当时每会话 subagent 生成数默认 200、并发默认 20（累计生成数上限已在 v2.1.224 移除，见下文补录）（--max-budget-usd 达上限时会中止后台 subagent）。安全侧：v2.1.210 修复了 worktree 隔离 subagent 对主 checkout 做破坏性 git 操作的问题。v2.1.218 曾将 /code-review 和 /deep-research 改为后台子代理形态；后续 /code-review 又调整了实现，v2.1.274 起对没有专用调参的模型使用精简的内联审查提示词。不要据此假定每次代码审查都会启动多个子代理。演示时仍先讲「边界清晰的一层委派」，再讲多层；多层不要当成默认做法。
完成本课学习后，你将能够：
1.
理解子代理的概念：知道 Subagent 是什么、怎么工作的
2.
掌握官方子代理入口：知道 .claude/agents/、/agents、Agent 委派各自负责什么
3.
分清官方能力与社区资源：明确 VoltAgent 之类的第三方代理包不是 Claude Code 官方内置
4.
提升开发效率：在实际项目中合理使用多代理并行协作
术语表
术语 | 英文全称 | 通俗解释 |
Subagent | Sub-agent | 子代理，Claude Code 通过 Agent 工具启动的专业化 AI 代理 |
VoltAgent | - | 社区维护的 awesome-claude-code-subagents 开源项目 |
Agent Definition | - | .md 格式的代理定义文件，描述代理的角色、能力和行为规范 |
Agent 工具 | Agent Tool | Claude Code 内置工具，用于启动子代理执行独立任务；旧资料可能写作 Task |
并行调用 | Parallel Invocation | 同时启动多个子代理处理不同任务，提高效率 |
⚠️ 重要提醒：Token 消耗
使用多 Agent 并行调用的 token 消耗量巨大。每启动一个子代理都会消耗独立的上下文窗口。
建议按需调用，不要一次性启动太多代理。
第一部分：官方快速上手
🎯 官方主路径：先理解，再扩展
官方 Subagents 的最小闭环不是"先去装一个第三方代理包"，而是：
1.
知道 Claude Code 可以用 Agent 工具委派子任务
2.
知道项目级 / 用户级子代理定义文件放在哪里
3.
知道如何在当前项目里启用和查看它们
你需要记住的 3 个入口
入口 | 作用 | 什么时候用 |
Agent 工具 | 把一个子任务委派给独立上下文窗口 | 日常并行处理 |
.claude/agents/ | 项目级子代理定义目录 | 当前仓库专用代理 |
~/.claude/agents/ | 用户级子代理定义目录 | 跨项目复用代理 |
官方最小示例：创建并验证一位只读 reviewer