Claude Code Dynamic Workflows 完整指南：用脚本编排上百个 Subagents

Claude Code 新增的 Dynamic Workflows 是一个研究预览能力：让 Claude 为你的任务写一段 JavaScript 工作流脚本，然后由运行时在后台执行，批量编排大量 subagents。

它适合的不只是“多开几个 Agent”，而是把复杂任务的计划、循环、分支和中间结果放进脚本里，让流程可读、可复跑、可保存。

Dynamic Workflow 是什么？#

官方定义：Dynamic workflow 是一个 JavaScript script，用来大规模编排 subagents。

你描述任务，Claude 写脚本，运行时在后台执行。主会话保持响应，不需要把每个 subagent 的中间结果都塞进当前上下文窗口。

要求：

• Claude Code v2.1.154 或更高版本
• 付费计划可用
• Pro 用户需要在 /config 中开启 Dynamic workflows
• 支持 Anthropic API、Bedrock、Vertex AI、Microsoft Foundry

什么时候该用 Workflow？#

官方对比了 subagents、skills、agent teams 和 workflows。核心区别是：谁持有计划。

• Subagents：Claude 每轮决定派谁做什么
• Skills：Claude 按说明执行
• Agent teams：team lead 管理多个 peer sessions
• Workflows：脚本持有计划，runtime 执行

所以 workflows 适合：

• 代码库级 bug sweep
• 500 文件迁移
• 多来源交叉验证研究
• 需要多角度独立方案再投票的规划
• 需要可重复运行的质量流程

如果只是派一个 Agent 读一个文件，不需要 workflow。

内置工作流：/deep-research#

Claude Code 内置了一个 workflow：

/deep-research What changed in the Node.js permission model between v20 and v22?

它会：

1. 从多个角度分发 web search
2. 抓取来源
3. 交叉检查 claims
4. 投票过滤不可靠结论
5. 输出带引用的研究报告

这是理解 workflows 的最好入口：你能看到它如何把“搜索、验证、综合”拆成多个阶段，而不是让单个对话顺序执行。

如何监控运行？#

工作流在后台运行。你可以打开：

/workflows

进度视图会显示每个 phase 的：

• agent 数量
• token 总量
• elapsed time
• 每个 agent 的 prompt、工具调用和结果

快捷键包括：

• Enter / →：进入 phase 或 agent 详情
• p：暂停/恢复
• x：停止 agent 或整个 workflow
• r：重启选中的 running agent
• s：把脚本保存为命令

为什么它比普通 Subagents 更强？#

普通 subagent 的结果最终回到 Claude 的上下文窗口。任务规模越大，上下文越容易被压满。

Workflow 则把中间状态放进脚本变量里，Claude 主要读取最终结果。这带来三个好处：

• 可以跑几十到上百个 agents
• 中间结果不会污染主上下文
• 成功的 orchestration 可以保存和复用

这让它更像“可执行研究/审查程序”，而不是一次性的聊天指挥。

最佳实践#

• 先让 Claude 解释 workflow 计划，再批准运行
• 大规模任务设置明确阶段和停止条件
• 对重要结论做交叉验证，而不是只汇总
• 成功后用 s 保存为自定义命令
• 对高成本 workflow 先小样本试跑
• 让 workflow 输出结构化报告，方便二次处理

来源：Claude Code 官方文档 - Dynamic Workflows | 整理：ClaudeEagle