官方教程中文版扩展与自动化
配置 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>.mdProject subagent 适合提交到 Git,让团队共享;User subagent 适合个人跨项目复用。
应该写清什么
一个好 subagent 至少写清:
- 什么时候使用它。
- 它负责什么,不负责什么。
- 可以使用哪些工具。
- 是否只读。
- 使用哪个模型。
- 输出应该是什么格式。
如果只是“帮我看看”,不需要自定义 subagent。只有当同类 worker 反复出现,才值得沉淀。
Subagent 和 Agent team
Subagent 运行在单个 Claude Code session 内,只向主会话汇报。Agent team 是多个独立 Claude Code session 之间协作,成员可以互相通信。
简单并行、只要结果摘要,用 Subagent。复杂协作、需要多个会话长期沟通,用 Agent team。