Claude Code Subagents

它做什么

• 每个子代理在自己的上下文窗口里运行，有自定义 system prompt、指定工具权限与独立许可——只有摘要会回到主线程
• 靠描述自动委派：Claude 读每个子代理的 description 决定何时交活；非内置描述合计超过 15,000 token 时启动时会告警
• 用 /agents 创建——Claude 起草子代理文件（name、description、tools、model、system prompt）写进 ~/.claude/agents/，首次使用前由你审核
• 文档化模式齐全：显式调用、前台与后台运行、子代理再派生子代理、输出扫描，以及并发子代理上限
• 作用域指引：子代理只在单个会话内生效——页面会把并行独立会话导向 background agents、消息互通导向 cross-session messaging、受监督团队导向 agent teams

什么时候用

会淹没主对话的高量副业——大范围调研、日志排查、重度文件浏览；以及任何你总用同一套指令重复召唤的工种。把窄任务路由给 Haiku 这类更快的模型，也是文档写明的成本控制手段。

如何上手

无需安装——这是一个文档页。在交互式 Claude Code 会话里运行 /agents，描述你想要的子代理及其保存位置；Claude 会写好文件，首次使用前由你审核 frontmatter（name、description、tools、model）。

注意事项

子代理的请求与主对话共享同一份用量限额，其 description 本身也消耗上下文——描述要短，细节放进 system prompt。子代理只在单会话内生效：要并行跑多个独立会话得用 background agents，要协同团队则用 agent teams。