Subagent 子代理完整指南：官方 Subagents、Task 委派与社区代理资源#

课程信息

预计学时：1-2小时

难度等级：⭐⭐⭐ 中级

更新日期：2026年4月

适用版本：Claude Code v2.1.133（验证于 2026-05-08）

📚 本课学习目标#

术语表#

⚠️ 重要提醒：Token 消耗#

使用多 Agent 并行调用的 token 消耗量巨大。每启动一个子代理都会消耗独立的上下文窗口。
建议按需调用，不要一次性启动太多代理。

第一部分：官方快速上手#

🎯 官方主路径：先理解，再扩展#

你需要记住的 3 个入口#

官方最小示例#

请开一个 reviewer 子代理，检查这次改动的回归风险和缺失测试。

并行开两个子代理：
1. 一个检查后端接口变更
2. 一个检查前端样式回归

查看与管理#

第二部分：社区代理资源（VoltAgent 等）#

这一部分讲的是第三方社区资源，不是 Claude Code 官方内置目录。

方法一：交互式脚本安装（社区方案）#

方法二：独立快捷安装（社区方案）#

方法三：手动安装（社区方案）#

💡 使用小贴士#

第三部分：VoltAgent 代理目录总览#

以下目录是 VoltAgent 提供的社区代理集合，适合“缺能力再补能力”，不建议当成官方默认菜单来理解。

1. 核心开发 (Core Development)#

2. 语言专家 (Language Specialists)#

3. 基础设施 (Infrastructure)#

4. 质量与安全 (Quality & Security)#

5. 数据与人工智能 (Data & AI)#

6. 开发者体验 (Developer Experience)#

7. 专业领域 (Specialized Domains)#

8. 业务与产品 (Business & Product)#

9. 元数据与编排 (Meta & Orchestration)#

10. 研究与分析 (Research & Analysis)#

第四部分：Agent Teams 多代理团队协作 🆕#

实验性功能：Agent Teams 当前仍需显式开启实验开关后再使用，不应默认视为稳定主路径。

开启方式：设置环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1，然后再进入相关工作流。

核心概念#

与普通 Subagent/Task 的区别#

典型使用场景#

快速示例#

# 在 Claude Code 中，使用自然语言请求创建团队
You: 帮我组建一个团队，并行处理以下任务：
     1. 重构用户认证模块
     2. 编写 API 集成测试
     3. 更新相关文档

💡 何时用哪个？

简单独立任务（翻译文件、生成测试）→ 普通 Subagent/Task，更轻量

复杂协作项目（多模块重构、全栈开发）→ Agent Teams，但前提是你愿意接受实验性行为和额外编排成本

v2.1.133 重要变更：worktree.baseRef 和子代理环境#

worktree.baseRef（v2.1.133）#

// .claude/settings.json
{
  "worktree.baseRef": "head"
}

CLAUDE_CODE_FORK_SUBAGENT（v2.1.132+）#

子代理 Skill 发现修复#

下一步学习：想深入了解如何自定义代理定义文件？请参考 07-Skills定制完整指南 中关于 Agent 配置的部分。