进阶
用 Claude Code Dynamic Workflows 一条指令并行调度百个后台 Agent
如果你用过 Claude Code 做编程 Agent，大概都遇到过这种窘境：要让它扫描整个代码库的 Bug、批量迁移 500 个文件、或者做需要多来源交叉核验的深度研究——逐轮对话太慢，一个 Agent 又"装不下"。Claude Code 的 Dynamic Workflows（动态工作流）就是解药：你只下一句话，它自己写出一段调度脚本，在后台并行跑几十到几百个 Agent，你的主会话全程不被占用，跑完再把最终报告交还给你。本教程基于官方文档，给出从触发到监控、从保存到复用的完整实操。
⚡ 本教程适合：已经会用 Claude Code 做基础开发（详见本中心《Claude Code 实战：全栈开发》），想把它用到"大规模并行任务"的开发者。需要 Claude Code v2.1.154 及以上版本。
先搞懂：Workflow、子 Agent、Agent 团队 三者的区别
很多人分不清这三个概念，先一句话厘清：
| 概念 | 一句话 | 适合 |
|---|---|---|
| 子 Agent（Sub-Agent） | 你手动派一个小弟去干一件具体事 | 单个明确子任务 |
| Agent 团队 | 几个角色分工协作完成一件事 | 中等复杂度协作 |
| Dynamic Workflow | AI 自己写调度脚本，批量并行跑 N 个 Agent | 海量同类 / 跨文件 / 深度研究 |
Dynamic Workflows 的核心妙处：中间结果存在"脚本变量"里，而不是你的对话上下文窗口里。所以即使并行跑几百个 Agent，你的主会话也不会被海量中间信息淹没，最后只收到一份精炼报告。
Step 1：确认版本并打开一个项目
1 版本要对，环境要对
1. 终端检查版本：
claude --version
→ 需 ≥ 2.1.154（2026-05-28 起支持 Dynamic Workflows）
老版本先升级：claude update
2. 进入你的项目目录并启动：
cd /your/project
claude💡 不确定版本？在 Claude Code 里输入
/status 也能看到当前版本号。Step 2：用一句话触发一个 Workflow
2 别写脚本，描述目标即可
Dynamic Workflows 的精髓是"你描述意图，Claude 自己写调度脚本"。试试这个经典场景：
对 Claude Code 说：
"扫描整个 src 目录，找出所有潜在的空指针 / 类型错误，
每个文件单独分析，最后汇总成一份带文件定位和修复建议的报告。"
Claude 会：
1. 自动枚举 src 下的文件
2. 写一段 JS 调度脚本，每个文件派一个后台 Agent
3. 并行执行，进度实时显示在侧边
4. 全部完成后，把结果聚合成一份报告返回给你你没写一行调度代码。Claude 自己判断"该拆成多少个 Agent、怎么并行、结果怎么聚合"。这就是 Dynamic 的含义——脚本是它现场生成的，不是你预设的。
Step 3：理解并看懂生成的调度脚本
3 它会把"计划"写成可复用代码
Claude 不会只把任务拆给你"看"，而是把整个编排计划写成一段可复用的 JavaScript 脚本交给运行时执行。你可以随时检视：
在 Claude 输出里，你会看到类似：
- 生成的 workflow 脚本（.js）
- 每个并行任务的输入 / 输出变量名
- 聚合逻辑（如何把 N 份结果合并成报告）
建议：第一次跑，先让它"只列计划、不执行"，
你确认拆分合理后再说"执行"。🔑 关键技巧：把"规划"和"执行"分开。先要计划，人工过一眼拆分粒度（是 500 个文件拆 500 个 Agent，还是按模块拆 20 个？），满意了再执行，省 token 也省时间。
Step 4：监控并行进度，不被卡住
4 主会话不阻塞，随时看进展
运行时你能看到：
- 侧边/状态栏显示「N / M 个任务完成」
- 单个 Agent 失败不会中断整体（默认隔离）
- 你的主会话仍可继续做别的事，或新开指令
如果某个任务卡死：
- 可单独重跑该子任务
- 或调整脚本里的超时/重试参数后整体重跑这就是它比"逐轮对话"强的地方：传统方式你要一个个等结果；Dynamic Workflows 是"发射后不管"，几百个 Agent 并行，你只等最终汇总。适合任何"一个 Agent 装不下、逐轮太慢"的任务。
Step 5：保存脚本，下次一键复用
5 把一次性的活变成可复用的资产
生成的调度脚本是有价值的资产，记得存下来：
1. 让 Claude 把 workflow 脚本保存到项目里，例如：
workflows/scan-bugs.js
2. 下次直接说："用 workflows/scan-bugs.js 跑一遍新分支"
3. 或做成定时任务 / CI 步骤，每次提交自动扫描💡 进阶：把它接进 CI/CD（详见本中心《CI/CD 自动化 Agent》教程），每次 PR 自动并行跑代码审查、测试、安全扫描，发布不再心跳加速。
Step 6：5 个最实用的提示词模板
6 直接复制改改就能用
① 全库 Bug 扫描
"扫描整个 src，逐文件查潜在空指针/类型错误，汇总带定位的报告。"
② 批量文件迁移
"把 src/legacy 下 500 个文件从 V1 API 迁移到 V2，每个文件独立 Agent，最后给兼容性清单。"
③ 深度交叉研究
"就『XX 技术趋势』，分 8 个子课题并行调研多来源，交叉核验后出一份综述。"
④ 多语言 i18n 补全
"扫描所有 .tsx，找出缺失的中文/英文文案，按语言分 Agent 补全并出 PR。"
⑤ 测试覆盖补齐
"统计未被单测覆盖的函数，按模块并行生成测试用例，汇总覆盖率提升报告。"🎉 恭喜！你已经掌握用一句话驱动"百个后台 Agent"并行作战的能力。它的本质是"把编排权交给 AI"——你定目标，它定计划、调度、聚合。
常见问题速查
| 你遇到的现象 | 大概率原因 & 解决 |
|---|---|
| Claude 说不支持 workflow | 版本低于 2.1.154，先 claude update 升级 |
| 拆分粒度太细/太粗 | 先要"计划"人工确认，再调粒度后执行 |
| 部分子任务失败拖慢整体 | 确认重试/隔离参数，单独重跑失败项 |
| 结果聚合报告太啰嗦 | 指令里加"只输出结论 + 关键定位，不超过 N 条" |