动态工作流（Dynamic Workflows）

用 Claude Code 的动态工作流编排数十到上百个后台子代理，做全仓评审、迁移与调研 — 通过 QCode 即可使用

需要 API Key？ 前往注册 →·端点与 Base URL →

子代理已经能帮你"派出一个分身"去并行调查某件事。但当一个任务大到需要"派出一支队伍"——比如把整个仓库扫一遍、给每个模块都写一份评审，单个子代理就不够看了。这时候就轮到动态工作流（Dynamic Workflows）登场。

动态工作流让 Claude Code 一次性编排数十到上百个后台子代理，各自领一块活儿并行干，你则继续做自己的事。它运行在 Claude Code 当前配置的模型上——所以只要把 Claude Code 指向 QCode，工作流就直接能用。

它解决什么问题¶

普通子代理适合"少量、可控"的并行：派 2~3 个分身分别查 API、查 schema、查测试覆盖率。但有些任务的并行度天然很高：

• 给一个有 200 个文件的仓库逐文件做安全/质量评审
• 把一套旧 API 调用在整个代码库里批量迁移到新写法
• 围绕一个主题，对几十个目录分别做调研并汇总

如果用串行方式，你得等 Claude 一个一个慢慢过；如果手动开几十个子代理，你又得自己拆任务、自己盯进度。动态工作流把"拆分 → 分发 → 后台执行 → 汇总"这一整套都交给 Claude Code 自己编排。

如何触发¶

动态工作流不需要额外安装，触发方式很轻量：

• 在你的提示里包含关键词 ultracode；或
• 直接让它"跑一个工作流（run a workflow）"。

Claude Code 识别到意图后，会自行规划要派多少个后台子代理、每个负责哪一块，然后开始并行执行。

> ultracode 把 src/ 下每个子模块都做一次代码评审，重点看错误处理和输入校验，
> 每个模块输出一份简短报告，最后汇总成一个总览。

或者用自然语言：

> 帮我跑一个工作流：扫描整个仓库里所有调用旧版 httpClient 的地方，
> 评估迁移到新版 fetch 封装的改动量，按目录分组汇总。

用 /workflows 查看运行¶

工作流派出的子代理会在后台持续运行，不会卡住你的主会话——你可以继续问别的问题、继续写代码。想查看当前有哪些工作流在跑、进度如何，用：

/workflows

它会列出正在运行和已完成的工作流运行（runs），方便你跟踪整体进度、查看各子代理的产出。

后台执行意味着大任务不再阻塞交互。你抛出指令后可以去做别的事，回头用 /workflows 收结果。

什么时候用工作流，什么时候用单个子代理¶

两者是同一套"并行委派"思路的不同规模，选择标准很简单：看并行度和是否需要后台化。

经验法则：

• 子任务只有几个、你想立刻拿到结果 → 用子代理。
• 子任务几十上百个、可以放后台慢慢跑 → 用动态工作流。

动态工作流本质上就是子代理的"规模化"版本。先把子代理的概念吃透，再上工作流会更顺手。

通过 QCode 使用¶

动态工作流跑在 Claude Code 当前所连的模型上，本身不依赖任何特定供应商。也就是说，只要你把 Claude Code 指向 QCode，工作流派出的所有后台子代理都会走 QCode 的接入点——同一把 cr_ 开头的 API Key 全程通用。

最小配置（Anthropic 协议）：

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_你的密钥"

# 国内用户优先用 asia 接入点
# export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"

BASE_URL 末尾不要带斜杠。直接访问该地址返回 401 属于正常现象——说明路径正确，只是缺少鉴权。

配好之后，正常启动 Claude Code，再用 ultracode 触发工作流即可。完整的接入点说明、三个域名（api / asia / us）与各协议路径，见接入点与 API 格式。

工作流里每个后台子代理消耗的 token 都按你在 QCode 选用的模型计费。大规模工作流会同时跑很多个子代理，token 消耗也会相应放大——大任务前不妨先用旗舰模型（如 claude-opus-5，$5/$25 每百万 token、1M 上下文）跑一个小范围试点，确认产出质量后再全量铺开。

实战示例¶

示例 1：全仓代码评审¶

让工作流给仓库里每个主要模块都出一份评审，关注点统一、产出统一，最后汇总：

> ultracode 对 packages/ 下每个子包做一次独立代码评审。
> 每份评审覆盖：错误处理、边界条件、是否有未处理的 Promise、命名一致性。
> 每个子包输出不超过 20 行的要点清单，最后汇总成一份按严重程度排序的总表。

派出去之后，你可以继续做别的事，过一会儿用 /workflows 看进度，等所有子代理跑完再统一看汇总表。

示例 2：大规模 API 迁移调研¶

在动手改之前，先用工作流摸清改动面：

> 帮我跑一个工作流：在整个代码库里找出所有直接使用 axios 的地方，
> 按目录分组，评估改成项目内 httpClient 封装的工作量和风险，
> 输出一张"目录 / 出现次数 / 迁移难度 / 注意事项"的表格。

得到全景之后，你就能基于真实数据决定迁移顺序，而不是凭感觉。

小贴士与注意事项¶

• 先小后大：第一次跑工作流，先把范围圈在一个目录或一个包上，验证产出格式和质量符合预期，再扩到全仓。
• 统一产出格式：在提示里明确每个子代理"输出什么、多长、如何排序"，汇总时会省很多事。
• 后台不等于无人值守：工作流跑着的时候你可以做别的，但记得回头用 /workflows 收尾确认。
• 关于图像：动态工作流处理的是文本/代码任务。如果你要让 Claude Code 读图（截图、架构图、错误截图），那是视觉输入能力，与工作流无关；如果你要生成图像，请用 gpt-image-2 图像生成。
• 想把工作流接进 CI/脚本，可结合无头模式与结构化输出，见自动化与 CI/CD。

触发方式与关键配置项¶

截至 2026-10-15，据 Claude Code 官方的动态工作流文档：

在 /workflows 里选中一次运行后按 s，可以把它的脚本保存成自己的命令：存到项目的 .claude/workflows/ 会随仓库共享，存到 ~/.claude/workflows/ 则只有你自己能用。

通过 QCode 跑工作流的注意点¶

• 并发与限流：工作流默认可同时跑 16 个 agent，而 QCode 个人套餐和按量包都是每个 API Key 并发 5（尊享版 10；见 常见问题 FAQ）。如果大批量运行时被限流（常见表现为 429）或个别 agent 失败，建议先把 CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS 调到与套餐并发相当的数值再试。
• 成本：所有 agent 的 token 都按你选的模型计费，QCode 按 token 计费，各模型单价见 qcode.cc/models。官方文档说明，当一次运行排了超过 25 个 agent、或预估总 token 超过 150 万时，任务面板会出现 Large workflow 警告；它只是提示，不会暂停任务。先用一个目录或一个窄问题试跑，是最稳妥的办法。
• 模型：没有另外指定时，agent 用会话当前的模型。轻量阶段可以在描述任务时要求使用 claude-haiku-5-5 之类更轻的型号。

常见报错与排查¶

常见问题¶

退出会话后还能接着跑吗？¶

同一会话里可以：让 Claude 重新启动同一工作流，已完成的 agent 直接返回保存的结果，失败的和之后启动的会重跑。退出后用 claude --resume 回到该会话，也能重放；全新开的会话没有上次的运行记录。

一次最多能派多少个 agent？¶

官方限制是单次运行共 1,000 个，默认同时最多 16 个。这些限制是 Claude Code 自身的，QCode 的并发上限另算，见上文。

工作流会很贵吗？¶

会比在对话里一步步做同样的事用掉更多 token。先在小范围试跑，用 /workflows 查看每个 agent 的 token 用量，必要时随时停止。

工作流里的 agent 是否沿用我的权限设置？¶

是的。官方文档写明，agent 的工具调用与你会话里的任何工具调用一样，要经过同样的权限检查和沙箱；ultracode 关键词只决定任务的组织方式。

想让团队复用同一个工作流怎么办？¶

在 /workflows 里选中那次运行按 s，存到项目的 .claude/workflows/，随仓库分享给所有人。

想用旗舰模型跑大规模工作流，又关心成本？看看 QCode 定价，同一把 API Key 即可在所有接入点畅用。

企业团队版 →