【Claude】Claude Code 子代理（Subagents）完全指南：多 AI 编排与并行任务管理

【Claude】Claude Code 子代理（Subagents）完全指南：多 AI 编排与并行任务管理

前言

当你在 Claude Code 中处理一个大型任务——比如"重构整个认证模块并补充测试"——单个 Claude 实例往往力不从心：上下文越来越长、响应越来越慢、任务交织在一起难以追踪。

子代理（Subagents） 是 Claude Code 的并行化解决方案。它允许主代理将子任务分派给独立的 AI 实例处理，每个子代理拥有自己的上下文窗口、工具权限和会话状态，完成后将结果汇报给主代理。

本文基于 Claude Code v2.1+，全面讲解子代理的使用方法、内置类型、自定义配置以及多代理编排模式。

一、问题现象：单代理的瓶颈

1.1 单 Claude 实例的三大瓶颈

瓶颈一：上下文膨胀

任务：重构认证模块 + 补充测试 + 更新文档

单代理流程：
  读取 8 个源文件 → 修改代码 → 读取测试文件 → 写测试 → 读取文档 → 更新文档
  
  上下文不断增长，到第 6 个文件时：
  - 响应速度明显变慢
  - Claude 开始"忘记"前面的设计决策
  - Token 消耗指数增长

瓶颈二：任务交织

Claude 同时处理代码修改和测试编写：
  改了 auth.py → 开始写 test_auth.py → 发现需要再改 auth.py 
  → 回去改 auth.py → 测试又需要更新