Claude Code: Sub Agent 实践记录

Claude Code 的 Sub Agent 功能是近期新上线的，我之前在研究 kiro Spec 在 Claude Code 的应用时，就注意到Sub Agent。但直到今天，我才真正开始动手尝试，并完成了第一轮验证。

这次我主要参考了官方描述、两篇 Reddit 上讨论热度非常高的帖子，以及几个社区开源项目。文末我也整理了所有参考资料，方便你深入查阅。

下面我会从 Sub Agent 的官方定义讲起，逐步介绍它的能力、使用方式，以及我在搭建个人 AI 协作团队过程中的实践体验。

Kiro Spec 的使用迁移

前段时间我还在将 kiro Spec 放在 Claude Code 的 Command 模式中使用，效果整体不错。但在 Sub Agent 功能推出之后，我逐渐意识到：相比于命令式交互，Agent 更适合承载结构化协作流程，尤其是在上下文隔离方面优势非常明显。

所以我后续会逐步把 Kiro Spec 驱动的开发模式，从命令迁移到 Agent 模式，尝试构建一个更稳定、高效的 AI 子代理团队，完成我的个人项目协作需求。

这里也留一个小问题： 为什么以前放在 Command 里的 kiro Spec，现在在有了 Agent 之后就不太合适了？ 欢迎你提前思考一下，后续我也会整理自己的结论。

Sub Agent 是什么

Sub Agent 是 Claude Code 中一个非常关键的新机制。它允许你创建多个具有独立任务、工具权限和上下文的子代理，并让这些代理各司其职、互不干扰。

每一个 Sub Agent 实际上就是一个具备自定义系统提示（Prompt）、工具绑定和上下文空间的“虚拟协作者”。

它的核心特点包括：

• 拥有独立的上下文（不与主对话串台）
• 可以指定工具（比如：Bash、Grep、LS、Read、WebFetch等）
• 可以设定系统提示来定义它的行为
• 可以反复复用，也可以为不同项目创建不同版本

为什么值得用 Sub Agent

Sub Agent 最大的价值，不仅仅是“多开几个助手”，而是帮助你实现真正意义上的 AI 协作：

• 避免主会话上下文污染
• 每个角色专注自己的职责，准确率提升明显
• 配置好之后可以长期复用，适用于多个项目
• 工具权限受控，使用更安全、更精准

尤其当你在做需求分析、代码实现、测试验证等任务时，能明显感觉到每一个 Sub Agent 的独立性带来的效率提升。

如何创建第一个 Sub Agent

第一步：进入 Claude Code 主界面

如果你还没安装，可以后续参考我整理的部署文档。Claude Code 本身价格偏高，但现在也有很多成熟的平替开源方案可以用。

在命令行输入：claude

你将进入 Claude Code 的主界面：

第二步：进入 Agent 管理界面

输入：/agents

会打开 Agent 管理界面

第三步：新建子代理

选择“创建新代理”，可选“项目级”或“用户级”。项目级只在当前项目可用，用户级是全局通用的

第四步：填写子代理配置（推荐自动生成）

Claude 会根据你的输入描述，自动生成完整配置模板。你可以设定：

• 功能描述
• 工具权限
• 背景颜色
• 名称与用途

示例截图如下：

• 输入描述

  
  
  
  

• 绑定工具权限

  

  
  

• 背景颜色自定义

  

  
  

• 最终配置文件可在 vim 模式中编辑

  

  
  

打造一个 AI 团队的起点（任务分阶段 + 角色分工）

Sub Agent 的强大之处，在于它不仅是“多角色”，而是可以模拟真实项目的协作机制。

如果你希望 AI 真正帮你做事，而不是“问一句答一句”，推荐你参考以下流程和分工结构：

如果你刚开始用 Claude Code，可以只配 3~5 个角色：

• PM Agent：规划节奏、定义目标
• UI/UX Agent：设计页面结构
• 开发执行者 + 测试助手：实现功能、保障质量
• 验收官：整体收尾与验收

这已经是一个完整闭环的小型 AI 协作团队。

未来打算

我这次只是初步完成了从 0 到 1 的探索。下一步我会尝试构建更完整的链路，包括：

• 如何提高每个具体的流程的成功率
•  多Agent 之间的联动、如何并行异步执行
• 输出触发下一步输入的流程编排
• 如何做到一个整个团队，在为我干活，我只负责需求和设计风格，其他全部让AI团队帮我搞定