Claude Code Dynamic Workflow 使用注意的问题

Claude Code 的 Dynamic Workflow 能编排数十到数百个子 agent 并行工作。功能强大，但有几个坑需要提前知道。

目录

1. 什么是 Dynamic Workflow
2. 开启与关闭
3. 触发方式
4. 关键词高亮与取消
5. 权限配置
6. 费用与 Token 消耗
7. Ultracode 模式
8. 管理运行：/workflows
9. 保存为命令复用
10. 恢复与限制
11. 完整速查表

什么是 Dynamic Workflow

Dynamic Workflow 是一段 JavaScript 脚本，由 Claude 编写，运行时在后台编排多个子 agent 执行任务。

✅ 适合场景：大规模代码审计、500 文件迁移、多源交叉验证研究、多角度方案对比。

❌ 不适合：简单问答、几个子任务（直接用 subagent）、有固定指令的重复操作（用 skill）。

开启与关闭

检查是否开启

/config   # 打开配置界面，查看 Dynamic Workflows 状态

关闭方式（三选一）

重新开启

反向操作即可。关掉后：

• /deep-research 等内置命令不可用
• workflow 关键词不再触发
• /effort 菜单移除 ultracode 选项

触发方式

方式一：关键词触发

在 prompt 中包含 workflow 关键词：

Run a workflow to audit every API endpoint for missing auth checks

Claude Code 会高亮 workflow 这个词，表示识别到触发意图。

方式二：Ultracode 自动触发

设置 /effort ultracode，Claude 自动为每个实质性任务规划 workflow。

方式三：保存的命令

保存过的 workflow 变成 /<name> 命令，直接调用。内置的有 /deep-research。

关键词高亮与取消

当你的 prompt 包含 workflow 时，Claude Code 高亮显示该词，表示即将触发 dynamic workflow。

不想触发怎么办？

按 Alt+W 取消高亮，该次 prompt 退回普通对话模式。

⚠️ 重点：部分终端会拦截 Alt 组合键，需要额外配置才能让 Alt+W 生效。

终端配置

🟣 Ghostty

在 ~/.config/ghostty/config 中添加：

macos-option-as-alt = true

🔵 iTerm2

Preferences → Profiles → Keys → Left Option Key: 设为 Esc+

🟢 Kitty

一般默认支持，如不行在 kitty.conf 加：

macos_option_as_alt yes

🟠 WezTerm

在配置中：

config.keys = {
  { key = "w", mods = "ALT", action = wezterm.action.SendKey({ key = "w", mods = "ALT" }) },
}

改完重启终端生效。

权限配置

核心规则

启动确认（按权限模式）

⚠️ 长运行前必须做的事

提前把需要的命令加到 allowlist，否则 workflow 中途弹窗卡住！

方式一：直接告诉 Claude：

允许 git 和 npm 命令不弹窗

方式二：手动编辑 settings.json：

{
  "permissions": {
    "allow": [
      "Bash(git *)",
      "Bash(npm *)",
      "WebSearch",
      "WebFetch"
    ]
  }
}

配置文件位置：

费用与 Token 消耗

成本特点

• 单次 workflow spawn 大量 agent，token 消耗远大于普通对话
• 所有 agent 默认使用当前 session 模型
• 计入 plan 用量和速率限制

💰 省钱技巧

模型成本对比（粗略）

Haiku  <  Sonnet  <  Opus
💰便宜      💰💰中等      💰💰💰贵

workflow 脚本中可为不同阶段指定不同模型：

agent('简单分类任务', { model: 'haiku' })
agent('复杂推理任务', { model: 'opus' })

Ultracode 模式

是什么

Ultracode = xhigh 推理深度 + 自动 workflow 编排

开启

/effort ultracode

行为

• 每个实质性任务自动规划成 workflow
• 可能一个请求触发多个 workflow 串行：understand → design → implement → verify
• auto 权限模式下跳过启动确认

代价

• 🔴 token 消耗极大，每个任务可能 spawn 几十上百 agent
• 🟡 耗时更长，但结果更全面可信
• 🔵 仅当次 session 有效

退出

/effort high    # 降回普通高档
/effort medium  # 降回中档

适用判断

管理运行：/workflows

/workflows

打开 workflow 管理界面，查看运行中和已完成的 workflow。

⌨️ 操作快捷键

进度信息

每个阶段显示：

• agent 数量
• token 消耗
• 已用时间

保存为命令复用

保存方法

1. /workflows → 选中满意的运行
2. 按 s
3. Tab 切换保存位置
4. Enter 确认

保存位置

使用

保存后变成 /<name> 命令：

/my-audit          # 直接调用

出现在 / 自动补全列表中，与内置命令（如 /deep-research）并列。

优先级

同名时，📦 项目级 > 👤 个人级。

恢复与限制

恢复运行

• 暂停后可在同一 session 恢复
• 已完成的 agent 返回缓存结果，不重新跑
• 恢复方式：/workflows → p，或让 Claude 用同一脚本重新启动

⚠️ 跨 session 不保留

退出 Claude Code 后 workflow 不保留。 下次 session 需重新运行。但保存过的命令脚本还在，可以重跑。

运行时限制

需要阶段签字确认？

拆成多个独立 workflow，每个跑完审查后再跑下一个。

完整速查表

# 🔄 开启/关闭
/effort ultracode          # 开启 ultracode（xhigh + 自动 workflow）
/effort high               # 退出 ultracode
/config                    # 关闭 Dynamic Workflows 开关

# 🚀 触发
prompt 中包含 "workflow"    # 关键词触发
/<saved-name>              # 调用保存的命令
/deep-research <question>  # 内置命令

# 📋 管理
/workflows                 # 打开管理界面
Alt+W                      # 取消关键词高亮（不触发 workflow）

# ⌨️ 管理界面内操作
p = 暂停/恢复
x = 停止
s = 保存为命令
Enter = 查看详情
Esc = 返回

# 🔐 权限
直接说 "允许 git 命令不弹窗" → Claude 帮你改 allowlist
或手动编辑 settings.json 的 permissions.allow 数组

# 💰 省钱
/model                     # 检查当前模型
简单阶段指定 haiku          # 脚本内 { model: 'haiku' }
/workflows → x             # 及时停止不需要的运行

基于 Claude Code 官方文档整理，最后更新：2026-05-30