Home
avatar

麒麟剑

Claude Code实战教程(9):Subagents与多Agent并行——速度提升3倍的秘诀

《从零开始的 Claude Code 实战系列教程》第 9 篇 · 公众号「麒麟剑的AI自动化Lab」连载

Team collaboration and parallel work ▲ 多人协作比单人作战效率高得多,AI 也能并行工作


一、为什么需要 Subagents?

想象一下这个场景:你需要为一个大型项目进行技术调研,需要同时研究三个不同的方案。

传统方式

  • 一个一个研究,耗时 3 小时

Subagent 并行方式

  • 三个 Agent 同时研究,耗时 1 小时

这就是 Subagent 的核心价值:任务并行化


二、Subagent 的基本使用

基础语法

research three approaches for implementing user authentication:
JWT, session-based, and OAuth. Use separate subagents for each approach,
then compare and recommend.

输出格式

Claude 会:

  1. 创建多个子代理
  2. 并行执行研究任务
  3. 汇总结果
  4. 给出推荐建议

三、Fork Session:最强大的并行功能

什么是 Fork Session?

Fork Session 允许你在保持共享上下文的同时,创建独立的操作空间

主会话: claude
另一个终端: claude --fork-session

核心特性

特性说明
共享上下文两个会话都能看到相同的文件和历史
独立执行修改互不影响
并发运行可以同时进行不同的任务
最终合并可以将 fork 的修改合并回主会话

四、实战:Fork Session 完整流程

第一步:启动主会话

cd my-project
claude

第二步:启动 fork 会话

# 在另一个终端
claude --fork-session

第三步:分工协作

主会话任务:实现用户认证功能

实现 JWT 登录接口,包括注册和登录端点

Fork 会话任务:实现测试和文档

为认证功能编写单元测试

第四步:合并结果

当两个会话都完成后,在 Claude Code 中:

/fork-merge

或者手动合并:

git diff --check  # 检查冲突
git merge         # 合并修改

五、多 Agent 编排:复杂任务的最佳实践

场景:重构大型代码库

Step 1:规划阶段(主会话)

分析 src/auth/ 模块,列出所有需要重构的文件和大致方案

Step 2:分配任务(使用 Fork Session)

为以下三个模块分别创建 fork 会话:
1. src/auth/token.ts - 重构令牌生成逻辑
2. src/auth/middleware.ts - 优化中间件性能
3. src/auth/routes.ts - 统一错误处理

Step 3:并行执行

在三个 fork 会话中分别执行重构任务

Step 4:整合与验证

运行测试套件,确保重构没有破坏现有功能

六、Subagent 的实际应用场景

场景 1:并行技术调研

调研三种数据库解决方案:PostgreSQL、MongoDB、Redis。
为每个方案创建一个子代理,然后给出对比报告。

场景 2:多模块开发

同时开发以下三个模块:
- 用户管理模块
- 订单处理模块
- 支付集成模块

场景 3:测试与开发并行

主会话:实现新功能
Fork 会话:编写测试用例

场景 4:代码审查并行

为每个 PR 创建一个子代理进行独立审查,然后汇总报告。

七、性能优化技巧

1. 合理控制并行度

不建议同时 fork 超过 5 个会话

2. 任务隔离

确保每个 fork 会话专注于单一任务,避免上下文混乱。

3. 及时合并

完成 fork 任务后及时合并,避免冲突累积。


八、实战:并行开发一个完整功能

需求:实现用户管理系统

Step 1:创建主会话

claude

Step 2:规划架构

设计用户管理系统的整体架构,包括数据库 schema、API 接口、前端组件

Step 3:创建 Fork 会话

创建三个 fork 会话,分别实现:
1. 后端 API(用户 CRUD、认证、权限)
2. 前端页面(用户列表、详情、编辑)
3. 测试套件(单元测试、集成测试、E2E 测试)

Step 4:并行开发

在三个终端中分别启动 claude --fork-session,各自开发

Step 5:整合测试

运行完整的测试套件,确保各模块协同工作

九、本章小结

概念说明
Subagent并行执行任务的子代理
Fork Session共享上下文但独立操作的并行会话
触发方式claude --fork-session
合并方式/fork-merge 或 git merge
最佳实践任务隔离、合理控制并行度、及时合并

下期预告(第 10 篇):命令行与自动化——将Claude Code嵌入CI/CD流水线

关注本系列,从入门到专家,系统掌握 Claude Code 的全部技能。

Claude Code Subagent 多Agent 教程 Anthropic