Claude Code 子智能体是什么：每个 Subagent 一个独立上下文窗口
一句话结论：当探索代码、跑测试这类”过程噪音”会淹没主对话时，就该用 Claude Code 子智能体（Subagents）——它在自己的上下文窗口里干活，只把摘要交回来。这是 code.claude.com 官方文档给出的核心定位：保留主对话上下文、限制工具权限、按域专精、控制成本。
内置 Subagent：Explore 、 Plan 、 general-purpose
- Explore：只读的快速搜索代理，负责文件发现与代码库探索，不能 Write/Edit 。调用时还可指定 quick / medium / very thorough 三档彻底程度。
- Plan：Plan Mode 下自动接管代码库调研，让主对话保持只读，规划上下文与执行上下文分离。
- general-purpose：能探索也能改代码的通用代理，适合多步骤复杂任务。
自定义 Subagent 的三种创建方式
最省事的是在 Claude Code 里执行 /agents，用 “Generate with Claude” 描述职责后自动生成；也可以手写 Markdown 文件加 YAML frontmatter（name 、 description 、 tools 、 model 、 system prompt），或启动时用 --agents 传 JSON 做临时代理。
description 是 Claude 决定”何时委派”的唯一依据，写清楚触发场景比堆砌细节更重要；所有自定义描述合计超过 15000 token 会收到启动警告，把细节挪进 system prompt 里。
作用域优先级与模型路由
同名 subagent 按优先级覆盖：受管设置 > --agents CLI > 项目级 .claude/agents/ > 用户级 ~/.claude/agents/ > 插件。项目级适合签入版本控制给团队共用；用户级适合个人跨项目复用。 model 字段支持 sonnet/opus/haiku/inherit——把审查类任务路由到 Haiku 是最直接的省钱手段。
实战建议：什么时候值得拆 Subagent
我们的经验是三个信号：同一类工作反复出现、任务产出大量不再引用的中间内容、需要与主对话不同的权限边界。满足任意一条就值得拆。关于上下文窗口本身的治理，可以配合阅读站内的AI 编程上下文窗口管理实战；子智能体与编排架构的关系则在此前多智能体编排一文中有更宏观的讨论。
子智能体能嵌套调用其他子智能体吗
不能。官方明确 subagents 无法再产生 subagents，防止无限嵌套。需要并行多会话时应使用 background agents 或 agent teams 。
subagent 会继承主对话的 CLAUDE.md 吗
内置的 Explore 和 Plan 会跳过 CLAUDE.md 与主会话 git 状态以保持轻快；其余内置和自定义 subagent 都会加载。
怎么让 Claude 更主动地委派给某个 subagent
把 description 写成”何时必须使用”的自然语言描述，或在提问时直接点名：”用 code-reviewer 这个 subagent 检查最近的改动”。
评论 (0)