📚AI 编程官方教程中文版
官方教程中文版扩展与自动化

配置 Subagents

用 Claude Code Subagents 隔离上下文、运行专用 worker,并控制工具和模型边界。

Subagent 是 Claude Code 里的专用 worker。它在独立上下文中完成任务,把摘要返回主会话。适合那些会产生大量中间信息、但主会话只需要结论的工作。

典型场景:

  • 只读探索大代码库。
  • 审查某个模块。
  • 搜索大量文件后总结关键点。
  • 并行验证不同假设。
  • 用更便宜或更快模型处理低风险子任务。

内置 subagents

官方文档列出几个内置 subagent:

  • Explore:快速只读探索,适合文件发现和代码搜索。
  • Plan:Plan mode 中用于研究上下文。
  • General-purpose:复杂多步任务,可以探索也可以修改。

它们的目的都是减少主会话上下文污染。探索过程不需要完整留在主会话里,最后返回结构化结论就够。

自定义 subagent

常用入口是:

/agents

你可以通过界面创建 Personal 或 Project subagent,也可以手写 Markdown 文件:

~/.claude/agents/<agent-name>.md
.claude/agents/<agent-name>.md

Project subagent 适合提交到 Git,让团队共享;User subagent 适合个人跨项目复用。

应该写清什么

一个好 subagent 至少写清:

  • 什么时候使用它。
  • 它负责什么,不负责什么。
  • 可以使用哪些工具。
  • 是否只读。
  • 使用哪个模型。
  • 输出应该是什么格式。

如果只是“帮我看看”,不需要自定义 subagent。只有当同类 worker 反复出现,才值得沉淀。

Subagent 和 Agent team

Subagent 运行在单个 Claude Code session 内,只向主会话汇报。Agent team 是多个独立 Claude Code session 之间协作,成员可以互相通信。

简单并行、只要结果摘要,用 Subagent。复杂协作、需要多个会话长期沟通,用 Agent team。

官方来源

On this page