Get the latest on AI, LLMs & developer tools
New MCP servers, model updates, and guides like this one — delivered weekly.
发布内容
2026 年 5 月 28 日，Claude 推出了 Claude Code 中的动态工作流。官方发布文章将其描述为长时间运行的并行任务，Claude 在其中编写编排代码，将工作分发给多个子代理，并在汇报结果前检查执行情况。经过验证的 ClaudeDevs 帖子更直接地概括了产品行为：在提示词中使用 workflow 即可开始。
Claude Code 新功能（研究预览版）：动态工作流。
— ClaudeDevs (@ClaudeDevs)2026 年 5 月 28 日
理解此次发布的有效方式是：工作流并非另一种提示词模板。它们是 Claude Code 内部的一种全新编排路径，适用于超出单次对话循环范围的任务：代码库审计、全服务范围的 Bug 搜寻、大规模迁移、交叉验证研究，以及在您采纳之前需要从多个角度进行攻克的计划。
The workflow shape: Your prompt -> Claude writes workflow JavaScript -> Runtime starts background phases -> Subagents investigate, edit, test, or review -> Results are cross-checked -> One coordinated answer returns to the session
定义
Claude Code 动态工作流是一种 JavaScript 编排脚本，由 Claude 为您的任务编写，随后在后台通过独立的运行时执行。Agent 负责实际的阅读、编写、Shell 操作、研究和审查工作。脚本负责协调运行过程，并将中间结果存储在主聊天上下文之外。
这种区别正是该功能的核心所在。在常规聊天中，Claude 逐轮决定下一步操作，且每个结果都必须塞回对话中。而在工作流中，计划、循环、分支和中间值都存在于工作流脚本中。主会话保持响应状态，并接收协调后的结果。
要求与可用性
运营层面的事实来源是 Claude Code 工作流文档。文档指出，动态工作流目前处于研究预览阶段，需要 Claude Code v2.1.154 或更高版本，并可在付费方案以及受支持的 API/提供商部署中使用。发布博客和 ClaudeDevs 讨论帖还列出了 Claude Code CLI、Desktop、VS Code、Claude API、Amazon Bedrock、Google Cloud Vertex AI 和 Microsoft Foundry。
| 要求 | 检查项 | 命令或位置 |
|---|---|---|
| Claude Code 版本 | 使用 v2.1.154 或更高版本以支持工作流。 | claude --version |
| 功能启用 | Pro 用户可能需要在设置中启用 Dynamic workflows 选项。 | /config |
| 方案或提供商 | 使用付费方案或受支持的提供商路径。 | Claude 账户、API、Bedrock、Vertex AI、Foundry |
| 工具 | /deep-research 需要网络搜索访问权限。 | 工具设置和权限白名单 |
# Check your version claude --version # Update if needed claude update # Inside Claude Code, open settings and confirm Dynamic workflows /config
发布首日有一个细微差别：博客和 X 讨论帖强调了 Max、Team 和 Enterprise 的可用性，而文档目前给出了更具体的付费方案设置说明，并提到了通过以下方式启用 Pro： /config。如需进行实际设置，请遵循文档页面和您账户的设置界面。
心智模型：子智能体 (Subagents)、技能 (Skills) 和工作流 (Workflows)
Claude Code 已经具备多种并行或复用工作的方式。动态工作流 (Dynamic workflows) 位于子智能体之上：它们使用子智能体，但协调逻辑被移入脚本中。这就是该功能适用于可重复的扇出 (fan-out) 和验证模式的原因。
| 功能 | 计划由什么承载？ | 最佳用途 | 规模 |
|---|---|---|---|
| 子智能体 (Subagent) | Claude 逐轮进行决策。 | 会占用上下文的单一辅助任务。 | 每轮委派少量任务。 |
| 技能 (Skill) | Claude 遵循的可复用指令。 | 可重复的程序或领域规则。 | 类似于常规/子智能体的工作。 |
| 动态工作流 (Dynamic workflow) | 由工作流脚本决定各个阶段。 | 审计、迁移、研究、对抗性审查。 | 每次运行涉及数十到数百个智能体。 |
当你需要进行一两次独立的调查时，请使用子智能体。当知识需要复用时，请使用技能。当编排本身需要可重复时，请使用工作流：例如扇出、比较结果、重启失败的智能体、保存成功的运行记录，并将其作为命令复用。
快速入门：运行内置工作流 (Built-In Workflow)
最快且安全的测试方式是 /deep-research，这是 Claude Code 文档中记录的内置工作流。它会从多个角度展开搜索、获取来源、交叉验证声明，并最终返回一份带有引用的报告。建议先选择一个范围明确的问题，以便在尝试大规模迁移之前先了解其用法和行为。
第 1 步：在项目中启动 Claude Code
cd /path/to/your/project claude
第 2 步：运行一个范围明确的研究工作流
/deep-research What changed in the Node.js permission model between v20 and v22?
第 3 步：批准工作流
Claude Code 会在运行前展示计划好的工作流。如果阶段符合你的预期，请选择 Yes, run it。如果你想检查生成的编排逻辑，请选择 View raw script。如果提示词范围太广，请取消并缩小范围。
第 4 步：通过以下方式观察 /workflows
/workflows
工作流视图会显示各个阶段、Agent 数量、Token 总数和耗时。深入查看某个阶段，可以检查每个 Agent 的提示词、最近的工具调用及其结果。运行结束后，Claude 会将报告插入到你当前的会话中。
通过一个提示词创建自定义工作流
若要将你自己的任务作为工作流运行而不改变整个会话，请在提示词中包含 workflow 。Claude Code 会高亮显示该词，并将任务引导至工作流创建流程。
Run a workflow to audit every API endpoint under src/routes for missing auth checks. Scope: - read-only first pass - group findings by endpoint - verify each finding with an independent reviewer agent - return only confirmed issues - do not edit files unless I approve a follow-up workflow
文档中提到了一个小小的“逃生舱”：如果 Claude Code 高亮显示了 workflow而你并非有意触发此功能，请按 alt+w 以忽略该提示词的此项功能。
提示词模式
| 提示词部分 | 为什么这很重要 | 示例 |
|---|---|---|
| 范围 | 控制 Token 使用量和影响范围（blast radius）。 | under src/routes only |
| 输出契约 | 防止产生大量原始的 Agent 笔记。 | return confirmed issues with file paths |
| 验证规则 | 使用 workflows 进行交叉检查，而不仅仅是简单的任务分发（fan-out）。 | independent reviewer agent must confirm |
| 编辑策略 | 避免在执行广泛任务时出现意外的文件更改。 | read-only unless I approve edits |
当你需要 Claude 自行决策时，请使用 Ultracode
ultracode 这不是常规的模型工作级别。模型配置文档将其定义为 Claude Code 会话设置：它使用 xhigh reasoning effort，并额外让 Claude 为实质性任务编排动态 workflows。
# Turn on automatic workflow orchestration for this session /effort ultracode # Return to normal high effort for routine work /effort high
当会话中的大多数任务规模较大、模糊或高风险时，请使用 ultracode：例如迁移、深度审计、设计压力测试或全仓库清理。不要在进行常规编辑时开启它。工作流文档指出，ultracode 适用于会话中的每个实质性任务，会消耗更多 Token，耗时更长，并在开启新会话时重置。
审批流程：运行前请阅读
CLI 审批提示会显示计划的阶段并提供四种操作。请将其视为运行前的最后一道检查点，以防产生大量使用消耗或通过 Agent 进行已批准的文件编辑。
| 操作 | 使用场景 |
|---|---|
| 是，运行它 | 阶段范围已明确，且权限在可接受范围内。 |
| 是的，且不再询问 | 您信任此项目路径下保存的 workflow。 |
| 查看原始脚本 | 您希望在批准前检查 JavaScript 编排逻辑。 |
| 否 | 任务范围过大、阶段划分有误，或工具存在风险。 |
有两个键盘操作细节需要注意。 Ctrl+G 在您的 IDE 中打开生成的脚本。 Tab 允许您在运行开始前调整提示词。在桌面端，相同的决策会以批准卡片的形式出现，并包含 仅一次， 总是，以及 拒绝 操作。
将 Workflow 保存为斜杠命令 (Slash Command)
当某个 workflow 产生了可重复使用的有效流程时，请将其保存。保存后的 workflow 将变为斜杠命令，并出现在 / 自动补全列表中，就像内置命令一样。
/workflows # Select the completed run # Press s # Choose project or user location # Press Enter to save # Later: /api-auth-audit
| 位置 | 谁可以访问？ | 适用场景 |
|---|---|---|
.claude/workflows/ | 适用于所有克隆该仓库的用户。 | 团队工作流：发布审计、分支审查、迁移检查器。 |
~/.claude/workflows/ | 仅限个人，跨项目使用。 | 个人研究、私有审查风格、本地维护任务。 |
如果项目工作流与个人工作流重名，则优先使用项目工作流。这是确保团队一致性的正确默认设置，但也意味着工作流名称应具有唯一性。
监控、暂停、恢复、重启和停止运行
工作流在后台运行。使用 /workflows 来查看实时和已完成的运行，然后使用页脚中显示的按键。输入框下方的任务面板也会在运行期间显示单行进度摘要。
| 按键 | 操作 |
|---|---|
Up / Down | 选择一个阶段或 Agent。 |
Enter 或 Right | 打开一个阶段，然后打开 Agent 详情视图。 |
Esc | 返回上一级。 |
j / k | 在长 Agent 详情中滚动。 |
p | 暂停或恢复运行。 |
x | 根据当前焦点，停止单个 Agent 或整个工作流。 |
r | 重启选中的运行中 Agent。 |
s | 将运行脚本保存为命令。 |
恢复（Resume）功能的作用域仅限于当前会话。如果您暂停或停止了运行，在同一个 Claude Code 会话中恢复时，已完成的 Agent 可以返回缓存结果，而剩余的 Agent 可以继续实时运行。如果您在工作流运行期间退出 Claude Code，下一次会话将重新启动该工作流。
运行时行为与限制
工作流运行时与对话是隔离的。工作流脚本负责协调 Agent；由 Agent 执行文件、Shell、Web 和 MCP 相关工作。文档中列出了具体的限制，以便用户评估资源使用情况。
| 限制 | 实际含义 |
|---|---|
| 运行期间不支持用户输入 | 将需要频繁确认的流程拆分为独立的工作流。 |
| 工作流脚本无法直接访问文件系统或 Shell | 这些操作由 Agent 执行；脚本仅负责协调。 |
| 最多支持 16 个并发 Agent | 大规模运行仍受限于本地资源。 |
| 每次运行总计最多 1,000 个 Agent | 失控循环会受到限制。 |
成本与使用量控制
文档和 ClaudeDevs 讨论帖均提醒，工作流的消耗量可能远高于普通的 Claude Code 对话。一个工作流可以启动多个 Agent，且每个 Agent 都会使用您会话中的模型，除非脚本将某个阶段路由到其他模型。
# Before a large workflow /model /usage # In your prompt Use a smaller model for indexing and low-risk classification phases. Use the strongest model only for final verification and architectural judgment.
- 从局部运行开始，不要直接针对整个 monorepo。
- 在启动高成本任务前，请先执行
/model检查。 - 使用
/usage来查看当前会话的使用量以及计划限制的影响。 - 在适当的情况下，让 Claude 将低风险阶段路由至较小的模型。
- 防止失控或范围界定错误的运行
/workflows. - 仅在大多数任务都需要工作流编排的会话中保留 ultracode。
权限与安全详情
您的权限模式控制工作流启动提示，但并非每个子智能体（subagent）的操作都表现得与您的主回合一致。文档指出，工作流子智能体在 acceptEdits 模式下运行，并继承您的工具允许列表（allowlist）。文件编辑会自动批准。Shell 命令、网络抓取以及允许列表之外的 MCP 工具在运行过程中仍可能触发提示。
| 风险 | 控制 |
|---|---|
| 来自模糊工作流的广泛编辑 | 从只读提示或路径受限的范围开始。 |
| 工具提示导致的长时间运行阻塞 | 先将所需的命令和 MCP 工具添加到允许列表中。 |
| Headless 模式没有人工提示 | 在使用 claude -p 或 Agent SDK 之前配置权限规则。 |
| 工作流写入过多 | 使用 git 分支/工作树，并在提交前检查 /diff 。 |
对于高风险工作，请使用两阶段模式：第一个工作流仅生成确认后的发现结果；第二个工作流应用已批准的更改。这符合文档中关于工作流在运行过程中不接受任意用户输入的说明。
关闭 Workflows
可以在用户或组织级别禁用动态 workflows。禁用后，捆绑的 workflow 命令将不可用， workflow 关键字将不再触发运行，并且 ultracode 将从 /effort菜单中移除。
# Option 1: interactive setting
/config
# Toggle Dynamic workflows off
# Option 2: user settings
{
"disableWorkflows": true
}
# Option 3: environment variable, read at startup
CLAUDE_CODE_DISABLE_WORKFLOWS=1 claude组织管理员也可以在托管设置中设置 "disableWorkflows": true 或使用 Claude Code 管理设置页面。在需要对多智能体（multi-agent）令牌使用或自动批准文件编辑进行集中策略管理的场景下，请使用此功能。
可供参考的 Workflow 示例
Anthropic 的发布文章列举了早期 workflow 的应用场景，包括全代码库 Bug 查找、基于分析器的优化、安全审计、迁移、现代化改造以及高风险的双重检查。同一篇文章还引用了将 Bun 从 Zig 移植到 Rust 的大规模示例，并特别说明该示例在发布时尚未投入生产环境。
示例 1：API Auth Audit
Run a workflow to audit src/routes and src/api for missing authentication checks. Rules: - read files only - group endpoints by auth pattern - have one agent find issues and another verify them - exclude test fixtures and generated files - return confirmed findings with file paths and suggested fixes
示例 2：编辑前的迁移计划
Run a workflow to plan the migration from the old payments client to the new billing SDK. Do not edit files. Map every call site, classify risk, propose phases, and have reviewer agents challenge the plan. Return a phased migration plan with test commands for each phase.
示例 3：交叉验证研究
/deep-research Compare the official migration paths for React 19 Server Actions and Next.js 16 forms. Focus on official docs. Return only claims that are supported by source links.
示例 4：保存团队评审命令
Run a workflow to review this branch for correctness bugs. Scope: - current git diff only - no style-only feedback - verify each finding against code - include test commands that would catch the bug # After the run succeeds: /workflows # press s and save to .claude/workflows/branch-correctness-review
常见错误
| 错误 | 失败原因 | 更好的模式 |
|---|---|---|
Run a workflow to improve the app | 范围过于宽泛，导致使用和编辑难以控制。 | 限制路径、输出和编辑策略。 |
| 将 workflows 用于单文件编辑 | 编排带来的额外开销并没有带来多少实质收益。 | 请使用普通聊天模式或单个子智能体（subagent）。 |
| 全天候开启 ultracode | 每一个实质性任务都可能导致运行负载加重。 | 仅在专注工作时开启，之后请切回 /effort high。 |
| 在未阅读阶段详情的情况下直接批准 | 生成的计划可能与您的实际风险边界不符。 | 请检查阶段列表和原始脚本，以识别高风险任务。 |
| 在没有权限规则的情况下以无头模式（headless）运行 | 此时无人监督，无法批准意外的工具调用。 | 请在进行 claude -p 或使用 SDK 之前，先配置好允许/拒绝规则。 |
启动检查清单
- 确认
claude --version版本至少为v2.1.154。 - 打开
/config并确认已启用 Dynamic workflows。 - 运行一个小型的
/deep-research在代码编辑前执行 workflow。 - 使用
/workflows来检查阶段、Token 总量以及 agent 输出。 - 对于自定义 workflows，请包含路径范围 (path scope)、输出格式、验证规则和编辑策略。
- 仅在大多数任务都有必要的情况下使用
/effort ultracode。 - 将可重复使用的 workflows 保存到
.claude/workflows/以供团队指令使用。 - 使用
/usage、/model以及小模型路由来进行成本控制。 - 当策略要求时，通过
/config、设置、环境变量或托管设置来禁用 workflows。
FAQ
Claude Code 中的动态工作流（dynamic workflows）是什么？
动态工作流是 Claude 为特定任务编写的 JavaScript 编排脚本。工作流运行时（workflow runtime）会在后台运行多个 Claude 子代理，将中间状态保存在脚本变量中，并最终返回一个协调后的结果。
如何启动 Claude Code 工作流？
运行内置的 /deep-research 工作流，在提示词中包含 workflow 一词，运行已保存的工作流命令，或者启用 /effort ultracode，让 Claude 自行决定何时将实质性任务转变为工作流。
工作流需要什么版本的 Claude Code？
工作流文档指出，动态工作流需要 Claude Code v2.1.154 或更高版本。在依赖此功能前，请运行 claude --version 检查您的安装版本并进行更新。
什么是 ultracode？
Ultracode 是 Claude Code 的会话设置。它使用 xhigh 推理强度，并允许 Claude 在该会话中自动为实质性任务规划动态工作流。
我可以将工作流保存为可重用的命令吗？
可以。打开 /workflows，选择对应的运行记录，按下 s 键，然后选择 .claude/workflows/（项目共享命令）或 ~/.claude/workflows/（个人命令）。
动态工作流的成本高吗？
可能会很高。官方文档和 ClaudeDevs 讨论帖都提醒，工作流可能会消耗大量额度，因为单次运行可能会生成多个代理。建议从范围明确的任务开始，检查 /usage，并在必要时通过 /workflows 停止运行。
管理员可以禁用工作流吗？
可以。个人用户可以在 /config 中关闭动态工作流，在 settings.json 中设置 disableWorkflows，或设置 CLAUDE_CODE_DISABLE_WORKFLOWS=1。组织可以通过托管设置或 Claude Code 管理设置来禁用工作流。
术语表
| 术语 | 含义 |
|---|---|
| 动态 workflow (Dynamic workflow) | 由 workflow 运行时执行的、由 Claude 编写的编排脚本。 |
| 子代理 (Subagent) | 一个拥有独立任务上下文的、被委派的 Claude 工作单元。 |
| 工作流运行时 | 执行编排脚本的隔离运行环境。 |
/deep-research | 用于交叉验证研究的打包工作流。 |
/workflows | 运行中及已完成工作流的进度视图。 |
| Ultracode | 一种仅限会话的设置，使用 xhigh 算力和自动化工作流。 |
| 接受编辑 | 在此模式下，文件编辑无需逐个确认即可直接应用。 |
| 工具白名单 | 由您的设置所允许的命令、网页抓取和 MCP 工具集合。 |
| 托管设置 | 由组织控制且用户无法覆盖的 Claude Code 设置。 |
| 已保存的工作流 | 存储为可复用斜杠命令的工作流脚本。 |
官方来源
本文仅使用 Claude、Claude Code、Anthropic 官方及经过验证的 ClaudeDevs 来源。
- Claude 博客：Claude Code 动态工作流介绍
- Claude Code 文档：利用动态工作流大规模编排子智能体
- ClaudeDevs 官方 X 帖子：动态工作流发布
- Claude Code 文档：命令
- Claude Code 文档：并行运行 Agent
- Claude Code 文档：模型配置与任务难度级别
- Claude Code 文档：设置
- Claude Code 文档：有效管理成本
- Claude Code 文档：快速入门
相关内容： Opus 4.8 正式发布详解 以及 Opus 4.8 API 迁移指南。