Claude Code 子代理横空出世，咱们 Cosplay 玩起来！？
Claude Code 近期推出的 Sub Agents（子代理） 功能，即是朝着这一方向迈出的重要一步。通过模块化、专业化的子代理，我们可以将大而全的单一代理拆解为小而专的团队成员，从而在保证上下文隔离的前提下，实现更可控、高效且安全的 AI 编程工作流。
本文将带你对 Claude Code 中的 Sub Agents 功能进行全面剖析，并通过实例展示如何在 VS Code 环境下快速上手，同时分享一些在多项目与团队协作中的最佳实践。最后，我们还会稍稍展望一下未来规范驱动开发（Spec-Driven AI Coding）的可能形态。
1. Sub Agents 的设计初衷与核心价值
1.1 专业化分工
单一代理往往需要兼顾代码审查、测试生成、PRD 编写、文档维护等多重职责，不仅上下文臃肿，还容易因一次对话的“跑题”而影响整体效率。Sub Agents 将这些职责拆分到不同的子代理，每个代理在自己的沙箱环境中运行，只关注特定任务：
- 代码审查专家：只做代码质量与潜在安全漏洞检测；
- 文档生成器：专注于基于规范快速输出 PRD、技术文档；
- 测试用例大师：负责自动化测试脚本与边缘场景覆盖。
这样的模块化设计，不仅让主对话的上下文更清晰，也让各子代理的提示词和工具调用范围更加纯粹。
1.2 上下文隔离与安全性提升
每个 Sub Agent 均在独立沙箱运行，拥有独立的上下文窗口， 有效防止了 “上下文污染” 和信息泄露：
- 独立上下文：子代理不会读到其它子代理或主代理中无关内容，降低错误推理的风险；
- 工具权限细分：可以为不同子代理赋予不同的工具调用权限，必要时禁用敏感 API，提升平台整体安全性；
- 版本可控：对每个子代理均可单独进行版本管理，回滚与迭代更为方便。
2. VS Code 中的快速上手示例
下面以一个简单的 代码审查子代理（Code Review Agent） 为例，演示如何在本地项目中创建、配置并调用 Sub Agent。
2.1 环境准备
确保已安装 Claude Code 最新版：
npm install -g claude-code@latest
在 VS Code 中，通过 ⌘+ESC 调出 Claude Code 插件。输入 /agents 即可进入 Sub Agents 管理界面。
2.2 创建子代理
- 在
/agents菜单中选择Create New Agent； - 选择 Project-scoped Agent；
- 选择 Manual Configuration；
- 填写基本信息：
- 名称：
Code Reviewer； - 描述：
负责对当前项目的 Python 代码进行安全与风格审查； - 默认颜色：可选；
- 名称：
- 在系统提示词中填入：
你是一位资深的代码审查专家，仅关注代码质量与潜在安全隐患。当被调用时，请运行 git diff 查看最近的更改。 - 选择允许调用的工具（如：Diff Viewer、Static Analyzer 等），保存。
2.3 调用与验证
在任意编辑器窗口，输入：
@agent Code Reviewer
Please review the current Python project code.
几秒钟后，你将看到子代理返回的审查报告，包括发现的关键问题和改进建议。与其一次性让单个大代理来回切换角色，不如让 Code Reviewer 专心做审查，其余任务交给其它 Sub Agents 各司其职。
3. 多项目复用与团队协作
- 跨项目共享：在全局配置中，可将成熟的 Sub Agents 导出为模板，团队成员一键导入，保证多项目间工作流一致；
- 版本管理与回滚：子代理的配置文件以 JSON 保存，纳入 Git 管理，可在提交中跟踪提示词与工具权限的演变；
- 定制化扩展：针对不同领域（前端、后端、测试、文档），可创建专属代理，并通过 CI/CD 自动化测试其输出质量。
你可以把 Sub Agents 想象成 AI 界的“八段锦”——各司其职，缺一不可，但不用担心他们互相抢功劳。
4. 探索规范驱动（Spec-Driven）AI 编程（参见上一篇亚马逊 Kiro ：新的花拳绣腿？ | lijianfei.com）
Sub Agents 为未来 规范驱动开发 打下了基础。设想下：
- 项目初始化 Agent：分析现有代码库，生成项目规范与文件模板；
- 规划 Agent：基于规范，拆解用户故事与技术任务；
- 设计 Agent：严格按照规范，一步步产出符合要求的代码和文档；
- 任务 Agent：对产出执行自动化测试及质量检查。
如此一来，从需求到交付，变成了一条闭环的高效流水线，不仅“人”少了，出错率也更低——真正实现“AI写代码，AI来把关”。
最后
Claude Code 的 Sub Agents 功能并非只是一个“增加新按钮”，而是标志着 AI 编程工具进入 多角色协同、模块化工作流 的新阶段。希望本文能为你在实际项目中落地 Sub Agents 提供思路，也欢迎在对话区和我分享你的最佳实践与使用心得。
小提示：如果你的团队还没用过 Sub Agents，强烈建议先从一个“单一职责”代理开始，然后逐步扩展到整条流水线。毕竟，一次性召唤太多 AI 助手，也许会让你怀疑人生。