Claude Code 所出的 subagents 功能，主要是通过 ​​/agents​​ 唤起并完成创建配置。核心特性是可以由主任务委托给子代理 agent 去执行某些定制化的工作项，其上下文是独立的。

A 社出了不少新的概念，除了前面提到的 SKILLS 外，还有 subagents。

虽然没有 SKILLS 传播面那么强，但是 subagents 依然有一定的实际价值：能做好上下文管理、约束选择合适的模型/工具。

毕竟有了他后，我们就可以自定义 Agent 工具了。今天我们一起学习一下他。

Subagents 是什么

在 Claude Code 中创建并使用定制化的 subagents，以适配特定任务的工作流，并优化上下文管理。

Subagents 是负责处理特定类型任务的专用 AI 助手。每个 subagent 都在独立的上下文窗口中运行，拥有自定义系统提示、专属工具调用权限与独立操作权限。

当 Claude 遇到与某个 subagent 任务描述匹配的工作时，会通过主任务 Agent 将该子任务委派给对应的 subagent，由其独立执行并返回结果。

有什么有用的特性

• 每个 subagent 拥有自己的独立上下文。关联关系是主任务 Agent 委托给 subagent 执行，各个 subagent 间无法直接通信。
• 每个 subagent 都有自己的单一职责，是专门应对某个事项的定制化行为。
• 每个 subagent 能够将任务路由到更合适（更快、更实惠）的模型，能够达到控制成本的诉求。
• 可以通过限制 subagent 可以使用的工具，来达到强制约束的诉求。
• 用户级 subagents，达到跨项目重用配置的诉求。

subagent 创建流程

我们打开终端后的 Claude，输入命令 /agents。就可以看到以下内容：

能看到你有什么 agents。也可以切换后创建新的 agent。

选择 Create new agent 后，我们需要先选择其作用的范围，选择是项目用的，还是个人（类似全局）的维度：

❯ 1. Project (.claude/agents/)                                                                                                                    │
│   2. Personal (~/.claude/agents/)                                                                                                                 │
╰───────────────────────────────────

选择后，会让你填写 agent 的功能描述，选择可用的工具，可使用的模型等：

根据自己的所需，选择和填写并保存后，就已经完成了一个新的 subagent 的创建，就可以使用了。

Claude /agents 流程所创建出来的，本质上也是配置文件。

最终类似于如下产物：

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

有需要的直接到所定义的 agents 目录下人工修改即可。

案例介绍

官方还给出了好几个 agents 例子，能给于大家学习和解读。

我从其中抽取两个较为常用的，大家一起学习。

代码审查者（code-reviewer）

这个案例是 code-reviewer agent，当主任务完成后，可以主动调用 code-reviewer agent 进行代码审查任务。

在调用过程中，主任务会将新编写/新修改的代码传递给 agent 去执行任务。其上下文是独立获取的。

---
name: code-reviewer
description: 资深代码审查专家。主动审查代码，以保障代码的质量、安全性和可维护性。在编写或修改代码后立即使用。
tools: Read, Grep, Glob, Bash
model: inherit
---

资深代码审查员：代码审查清单及反馈

你是一名资深代码审查员，负责确保代码质量与安全达到高标准。

调用时执行：

1. 执行 git diff 查看近期变更
2. 聚焦已修改的文件
3. 立即开始代码审查

审查清单：
- 代码清晰、可读性强
- 函数与变量命名规范合理
- 无重复代码
- 具备完善的错误处理
- 未暴露密钥、API 密钥等敏感信息
- 已实现输入校验
- 测试覆盖率良好
- 已考虑性能优化

按优先级整理反馈：
- 严重问题（必须修复）
- 警告问题（建议修复）
- 优化建议（可考虑改进）

反馈中需包含具体的修复示例。

调试器

---
name: debugger
description: 专门处理错误、测试失败和异常行为的调试专家。遇到任何问题时主动使用。
tools: Read, Edit, Bash, Grep, Glob
---

你是一名专注于根本原因分析的资深调试专家。

调用时执行：
1. 捕获错误信息和堆栈跟踪
2. 明确问题复现步骤
3. 定位故障位置
4. 实施最简修复方案
5. 验证解决方案有效

调试流程：
- 分析错误信息和日志
- 检查近期代码变更
- 提出并测试假设
- 添加针对性调试日志
- 检查变量状态

针对每个问题，请提供：
- 根本原因说明
- 支持诊断的证据
- 具体代码修复方案
- 测试方法
- 预防建议

重点修复根本问题，而非表面症状。

总结

Claude Code 所出的 subagents 功能，主要是通过 /agents 唤起并完成创建配置。核心特性是可以由主任务委托给子代理 agent 去执行某些定制化的工作项，其上下文是独立的。

各 subagent 间并不能通信，主要是父子代理的关联关系。如果有相对独立写作的委派型诉求，使用 subagent 是非常不错的。