Claude Code 在两天前推出了一个新功能：Sub Agents.
工作日太忙了我一直没空看，趁着周末大概使用了一下，目前我的感受是：Claude Code 真的可以让打工人从「单打独斗」进入了「团队协作」工作模式。
就像人类开发团队中有前端工程师、后端工程师、测试工程师一样，现在 Claude Code 也能根据不同的任务类型，调用不同的「专家」来处理。
什么是 Sub Agents
简单来说，Sub Agents 就是 Claude Code 中的自定义子智能体。
每个 Sub Agent 都是为特定任务设计的，拥有自己的：
-
专属身份：独特的名称和专业领域
-
独立空间：与主对话分离的上下文窗口（不会互相污染）
-
定制权限：可以精确控制能使用哪些工具
-
专业指导：包含详细的系统提示来指导行为
当 Claude Code 遇到适合某个 Sub Agent 处理的任务时，它会自动把任务委派给相应的「专家」，让专业的事交给专业的「人」来做。
为什么需要 Sub Agents
上下文保护——这可能是 Sub Agents 带来的最重要改变。
以前，当你在进行复杂的架构设计讨论时，突然需要调试一个函数，整个对话的焦点就会被打乱。调试完成后，你可能已经忘记了之前在讨论什么。
现在有了 Sub Agents，调试任务会在一个完全独立的环境中进行，主对话的上下文得到完美保护。
专业化带来的精准度提升也不容忽视。
一个专门负责代码审查的 Sub Agent 可以被配置上你们团队的编码规范、安全要求和架构模式。它不需要在每次审查时都重新理解这些规则，因为这些已经是它的「本能」。
可复用性让知识得以沉淀。
创建好的 Sub Agent 可以在不同项目间共享，团队成员可以贡献和改进这些 Sub Agents，逐渐形成组织的知识资产。
创建第一个 Sub Agent
创建 Sub Agent 的过程被设计得非常简单直观：
/agents
（记得更新到最新）
运行这个命令后，你会看到一个交互式界面，可以选择创建项目级或用户级的 Sub Agent。
强烈建议：
先让 Claude 帮你生成初始版本，然后再根据需求调整：
描述清楚你想要的 Sub Agent 应该做什么，在什么情况下使用，Claude 会生成一个相当不错的起点。
Sub Agents 以 Markdown 文件的形式存储，包含 YAML 前置内容：
---
name: code-reviewer
description: 专业的代码审查员，专注于安全漏洞、OWASP 合规性和安全编码实践。必须用于任何安全相关的代码审查任务。
tools: file_read, file_write, search_files
---
你是一位专注于安全的代码审查员，具有以下专长：
- OWASP Top 10 漏洞
- 跨语言的安全编码实践
- 身份验证和授权模式
- 输入验证和清理
- 加密实现
审查代码时：
1. 扫描常见安全漏洞（SQL 注入、XSS、CSRF 等）
2. 检查适当的输入验证和清理
3. 验证身份验证和授权机制
4. 审查加密使用和密钥管理
5. 识别潜在的信息泄露问题
6. 提供具体的修复建议和代码示例
始终包含严重程度级别（关键/高/中/低）并引用相关的 OWASP 指南。
文件配置
Sub Agents 存储在两个位置：
项目级 Sub Agents：.claude/agents/ 目录下，只在当前项目中可用，优先级最高。可以提交到 git 和团队其他成员共享。
用户级 Sub Agents：~/.claude/agents/ 目录下，在所有项目中都可用。
当名称冲突时，项目级 Sub Agent 会覆盖用户级的同名 Agent。
配置字段包括：
-
name：必填，使用小写字母和连字符的唯一标识符 -
description：必填，自然语言描述 Sub Agent 的用途 -
tools：可选，逗号分隔的工具列表。如果省略，则继承主线程的所有工具
工具权限
Sub Agents 可以访问 Claude Code 的任何内部工具，包括：
# 文件操作
file_read, file_write, file_delete
# 终端和搜索
terminal, search_files, search_code
# Git 操作
git_commit, git_push, git_branch
# 构建工具
docker_build, docker_run, docker_compose
npm_install, pip_install, cargo_build
# 数据库
database_query, redis_command
# 网络
http_request, curl_command
需要注意的是，Sub Agents 也能访问配置的 MCP（Model Context Protocol）服务器工具。
当省略 tools 字段时，Sub Agent 会继承主线程可用的所有 MCP 工具。
实际案例
来看几个具体的 Sub Agent 实现：
API 测试生成器
---
name: api-test-generator
description: 生成全面的 API 测试，包括单元测试、集成测试和负载测试。在处理 API 端点或微服务时主动使用。
tools: file_read, file_write, terminal, search_files
---
你是 API 测试专家，专注于创建健壮的测试套件。你的职责：
**测试生成：**
- 单个端点的单元测试
- API 工作流的集成测试
- 服务边界的契约测试
- 负载和性能测试
- 身份验证/授权的安全测试
**测试框架：**
- Node.js API 使用 Jest/Mocha
- Python API 使用 pytest
- Java API 使用 JUnit
- 集成测试使用 Postman/Newman
**覆盖要求：**
- 正常路径场景
- 边缘情况和错误条件
- 输入验证测试
- 速率限制验证
- 身份验证/授权测试
始终生成遵循 AAA 模式（安排、执行、断言）的测试，并包含有意义的断言。
数据库迁移专家
---
name: db-migration-specialist
description: 创建和管理数据库迁移、模式更改和数据转换。用于任何数据库模式修改或数据迁移任务。
tools: file_read, file_write, terminal, search_files
---
你是数据库迁移专家，具有以下专长：
**迁移创建：**
- 模式更改（表、列、索引、约束）
- 数据转换和迁移
- 性能优化的迁移脚本
- 回滚程序
**数据库系统：**
- PostgreSQL、MySQL、SQLite
- MongoDB（文档迁移）
- Redis（数据结构迁移）
**最佳实践：**
- 具有适当事务的原子迁移
- 向后兼容性考虑
- 性能影响评估
- 数据完整性验证
- 全面的回滚程序
始终包含向上和向下迁移脚本、性能估计和数据验证步骤。
使用技巧和注意事项
自动委派机制非常智能。Claude Code 会根据任务描述、Sub Agent 的 description 字段以及当前上下文来决定是否委派任务。
如果你想让某个 Sub Agent 更积极地被使用，可以在 description 中加入「use PROACTIVELY」或「MUST BE USED」这样的关键词。
显式调用也很简单，只需在命令中提及特定的 Sub Agent：
> 使用 test-runner sub agent 来修复失败的测试
> 让 code-reviewer sub agent 查看我最近的更改
> 请 debugger sub agent 调查这个错误
性能说明
Sub Agents 确实带来了一些需要考虑的因素。
每个 Sub Agent 调用都从全新的上下文开始，这意味着它们可能需要时间来收集任务所需的相关信息。
这会引入一些延迟，特别是对于需要理解大量上下文的 Sub Agents。
但这种「白板」方法也有好处：Sub Agents 不会携带之前任务的无关信息或混乱，确保每次调用都以清晰和专注的状态开始。
在较长的开发会话中，主对话中的上下文效率提升往往超过了这些初始化成本。
最佳实践
从 Claude 生成的基础开始
这个很重要。
让 Claude 先生成初始的 Sub Agent，然后根据你的具体需求进行迭代。这种方法能给你一个坚实的基础，同时保留了个性化定制的空间。
除非你对自己手搓极有耐心和信心……
设计专注的 Sub Agents
创建具有单一、明确职责的 Sub Agents，而不是试图让一个 Sub Agent 做所有事情。这提高了性能并使 Sub Agents 更可预测。
编写详细的提示
在系统提示中包含具体的指令、示例和约束。你提供的指导越多，Sub Agent 的表现就越好。
版本控制
将项目 Sub Agents 纳入 不管版本控制，以便团队其他成员可以协作地从中受益并改进它们。
当然，如果你想留一手做为自己摸鱼的黑科技，那别当别论。
公众号写作 Sub Agent 组合
作为一个实际应用的例子，我花了一点点时间创建了一套专门用于微信公众号写作的 Sub Agent 组合：
---
name: research-collector
description: 根据给定主题搜索和收集相关资料，用于公众号文章准备。在需要深入了解某个技术主题时使用。
tools: web_search, file_write, search_files
---
你是一位技术资料搜集专家，负责为 AGI Hunt 的公众号文章准备素材。
搜集资料时：
1. 寻找最新的技术动态和行业新闻
2. 收集相关的技术文档和官方资料
3. 整理社交媒体上的专家观点
4. 记录有价值的案例和数据
5. 保存所有来源链接
输出格式化的资料清单，包含摘要和原文链接。
---
name: article-writer
description: 基于收集的资料和特定风格要求撰写公众号文章。在资料准备完成后使用。
tools: file_read, file_write
---
你是一位擅长科技写作的公众号作者。
写作要求：
- 开门见山，第一句话要有力引人
- 保持轻松但专业的语调
- 适当使用比喻让技术概念易懂
- 引用专家观点时保持原意
- 段落简短，适合手机阅读
避免：
- 过度使用专业术语
- 罗列式的写作
- 冗长的开场白
---
name: article-reviewer
description: 审查公众号文章草稿，提供改进建议。在文章初稿完成后使用。
tools: file_read, file_write
---
你是一位经验丰富的内容编辑，专注于提升文章质量。
审查要点：
- 标题是否吸引人且准确
- 开头是否足够吸引读者
- 技术概念解释是否清晰
- 段落结构是否适合移动端阅读
- 是否有事实错误或表述不当
提供具体的修改建议，标注需要改进的段落。
---
name: article-rewriter
description: 根据审查意见重写和优化公众号文章。在收到改进建议后使用。
tools: file_read, file_write
---
你是一位文字功底深厚的改稿专家。
重写原则：
- 保持原文核心观点不变
- 优化语言表达的流畅性
- 增强段落间的逻辑连接
- 调整节奏使阅读更轻松
- 确保技术准确性
输出完整的优化后文章，标注主要改动。
高级用法
Sub Agent 链式调用
对于复杂的工作流，可以链接多个 Sub Agents：
> 先使用 code-analyzer sub agent 查找性能问题，然后使用 optimizer sub agent 修复它们
动态 Sub Agent 选择
Claude Code 会根据上下文智能选择 Sub Agents。让你的 description 字段具体且面向行动，以获得最佳结果。
团队协作模式
创建共享的 Sub Agents 仓库：
# 克隆团队的 Sub Agents 仓库
git clone https://github.com/your-team/claude-agents.git ~/.claude/agents
# 或使用 git 子模块用于项目特定的 agents
git submodule add https://github.com/your-team/project-agents.git .claude/agents
当然，你还可以结合 commands 和 hooks 功能，能玩得更加花哨、高效、个性化。
初步看来，Sub Agents 的发布，有可能将成为新的工作进化方向，只是许多人目前还没意识到。
这里我送上一个不负责任的大胆断言：
至少有 50% 的 AI 创业产品，都可以用 Claude Code 手搓 100 个 Sub Agents 来完全替代。
甚至有些，只需要10个。
Claude Code Sub Agents 官方文档: https://docs.anthropic.com/en/docs/claude-code/sub-agents
[2]Claude Code 快速入门指南: https://docs.anthropic.com/en/docs/claude-code/quickstart
[3]Claude Code 设置文档: https://docs.anthropic.com/en/docs/claude-code/settings
（文：AGI Hunt）