subagents 是什么

subagent 具备这些特点：

• 有自己的角色定位
• 有自己的上下文窗口
• 可以限制可用工具
• 可以使用单独的 system prompt
• 适合做任务拆分和专业分工

它不是简单的“再开一个对话”，而是 Claude Code 的正式能力机制。

---

subagents 和 Agent Teams 区别

• subagents：主 Claude 委派一个边界清晰的子任务，等它把结果带回来
• Agent Teams：多个 Claude Code 实例协作，彼此有独立上下文窗口，还能直接通信

对绝大多数中国小白用户来说，先掌握 subagents 就足够了。
Agent Teams 依然是实验性能力，更适合复杂协作场景，细节放在 09-advanced-features 里看。

---

subagents 的核心价值

价值	说明
上下文隔离	避免主对话被复杂细节污染
专业分工	不同 agent 做不同任务
工具隔离	可以限制某个 agent 能做什么
可复用	适合团队共享常用角色

---

文件放哪里

类型	路径	作用域
项目级	.claude/agents/	当前项目
用户级	~/.claude/agents/	所有项目
plugin 自带	plugin 的 agents/ 目录	随 plugin 启用

---

agent 定义优先级

上游这次修正了一个容易写反的点：当同名 agent 同时出现在多个位置时，优先级是：

1. CLI 临时定义：--agents
2. 项目级：.claude/agents/
3. 用户级：~/.claude/agents/

也就是说：

• --agents 只影响当前 session，优先级最高
• 项目级 agent 会覆盖同名用户级 agent
• 用户级 agent 适合放个人长期习惯，不适合压过项目团队约定

如果你在团队项目里发现“明明本机有一个同名 agent，但项目里表现不一样”，优先检查 .claude/agents/ 是否覆盖了它。

---

Claude Code 包括几个内置 subagents，如 Explore、Plan 和 general-purpose。

如何安装

mkdir -p .claude/agents
cp test-engineer.md .claude/agents/

或者安装单个：

cp test-engineer.md .claude/agents/

如何使用