Claude Code重大突破：Workflow功能完整实战教程

2601_96073073

4565人浏览 · 2026-05-28 16:10:38

2601_96073073 · 2026-05-28 16:10:38 发布

摘要： 本文通过Ai好记整理自 B 站技术博主@AI超元域关于 Claude Code Workflow 功能的实战演示视频，完整拆解了该功能的原理、用法和 6 种编排形态，手把手带你跑通第一个 Workflow。

Workflow 是什么？为什么说它是颠覆性创新
环境准备与启用方式
实战一：用 Workflow 做多 Agent PR Review
Workflow 最小化代码结构
Workflow vs Agent vs Skills：三者区别一览
实战二：构建可复用的 Deep Research 工作流
Workflow 支持的 6 种编排形态
脚本管理与持久化
适用场景速查表
常见问题与注意事项
参考来源

1. Workflow 是什么？为什么说它是颠覆性创新

Claude Code 在 V2.1.47 和 V2.1.48 版本中新增了 Workflow 功能。Anthropic 在 changelog 中提到了它，但随即删除了介绍——不过功能本身完整保留，当前可正常使用。

一句话定义： Workflow 把多 Agent 编排从"模型临场发挥"推进到了**“用 JS 脚本显式声明”**的阶段。

和之前 Claude Code 的 Agent、Agent Teams 相比，Workflow 的核心升级是：

维度	Agent（Subagent）	Agent Teams	Workflow
编排方式	自然语言临时派发	多角色并行，人工调度	JS 脚本显式声明
可复用性	❌ 每次重新描述	❌ 无法复用	✅ 脚本保存后直接复用
可观测性	有限	可查看	✅ 阶段/Agent 状态实时追踪
可控性	低	中	✅ 精准控制每个 Agent 的行为
质量门禁	❌	❌	✅ 支持校验阶段
版本管理	❌	❌	✅ 脚本可版本控制

本质上，Workflow = 把流程写成代码，而不是写成 prompt。

这意味着你可以把一个跑通的工作流保存为 JS 脚本，分享给团队，其他人直接复用，不需要重新描述一遍。

2. 环境准备与启用方式

版本要求： Claude Code V2.1.47 或以上（当前最新为 V2.1.48+）

启用步骤：

# 第一步：设置环境变量
export CLAUDE_CODE_ENABLE_WORKFLOW=true

# 第二步：启动 Claude Code
claude

# 第三步：在 Claude Code 中使用 workflow 关键字
workflow <你的任务描述>

注意： 输入 workflow 后，该关键字会变成彩色且有渐变效果，表示 Workflow 功能已激活。

3. 实战一：用 Workflow 做多 Agent PR Review

这是最经典的入门案例——让 Claude Code 通过 Workflow 对一个 PR 进行多维度审查。

操作步骤：

workflow 为当前的 PR 生成一个 agent 的 review workflow 并运行

Claude Code 执行流程：

生成 Workflow 描述文件 → 在项目路径下生成一个 .md 文件，定义工作流目标
编写 JS 脚本 → 自动生成一个约 300 行的 JavaScript 脚本，定义三个阶段：Review → Verify → Report
启动 Workflow → 并行运行多个专业审查 Agent
实时追踪 → 输入 /workflows 查看各 Agent 的运行状态、耗时、Token 消耗和调用的工具

实际运行效果：

启动了 6 个并行审查 Agent（分别审查代码安全、性能、可维护性等维度）
总计运行了 97 个 Agent 任务
最终输出一份完整的 PR Review 报告

你可以用键盘上下方向键选择某个 Agent，按 Enter 查看它的提示词和工具调用详情。按 Esc 退出查看，后台 Workflow 继续运行。

4. Workflow 最小化代码结构

一个合法的 Workflow 脚本必须包含三个要素：

// 最小化 Workflow 脚本
module.exports = {
  // ① 元数据（必填）
  meta: {
    name: "my-workflow",          // 工作流名称（必填）
    description: "工作流描述"      // 工作流描述（必填）
  },

  // ② agent() 方法（至少调用一次）
  async run(ctx) {
    const result = await ctx.agent({
      task: "执行某项任务",
      agentType: "general"
    });

    // ③ 必须返回结果
    return { output: result };
  }
};

三个必需要素：

要素	作用	要求
`meta`	定义工作流元信息	`name` 和 `description` 必填
`agent()`	调用子 Agent 执行任务	至少调用一次
`return`	将结果传递回调用方	必须存在

5. Workflow vs Agent vs Skills：三者区别一览

这三个概念经常被混淆，一张表说清楚：

特性	Agent（Subagent）	Skills	Workflow
本质	主 Agent 派生的子 Agent	封装某项技能的指令包	多 Agent 编排的 JS 脚本
启动方式	自然语言描述	模型自动发现并调用	`workflow` 关键字触发
编排方式	单个任务，无需编排	单项技能，无需编排	多阶段、多 Agent 显式编排
复用性	低	高（Skills 可复用）	高（脚本可复用）
控制精度	低	中	高（代码级控制）
适用场景	临时性单任务	常用技能封装	复杂多步骤工作流

简单类比：

Agent = 临时叫一个人干活
Skills = 给这个人培训一项技能，他以后自动用
Workflow = 写一份 SOP 流程图，规定谁先干、谁后干、干完怎么验收

6. 实战二：构建可复用的 Deep Research 工作流

下面演示一个生产级的 Deep Research Workflow。

脚本结构：

module.exports = {
  meta: {
    name: "deep-research",
    description: "多角度并行深度研究"
  },

  async run(ctx) {
    // 阶段一：并行搜索
    const searchResults = await Promise.all([
      ctx.agent({ task: "研究官方文档", agentType: "researcher" }),
      ctx.agent({ task: "研究学术论文", agentType: "researcher" }),
      ctx.agent({ task: "研究社区讨论", agentType: "researcher" }),
      ctx.agent({ task: "研究开源实现", agentType: "researcher" })
    ]);

    // 阶段二：验证交叉信息
    const verified = await ctx.agent({
      task: "交叉验证搜索结果的准确性",
      agentType: "verifier"
    });

    // 阶段三：合成报告
    const report = await ctx.agent({
      task: "基于验证结果生成中文研究报告",
      agentType: "writer"
    });

    return { report };
  }
};

复用方式：

# 直接调用已有脚本
workflow 调用 deep-research 脚本，深度研究 Harness

Claude Code 会直接读取已有的脚本，不需要重新编写，然后按照脚本定义的三个阶段（搜索 → 验证 → 合成）执行。

状态追踪：

输入 /workflows 可以看到：

搜索阶段：4 个 Agent 并行运行
验证阶段：1 个 Agent 交叉验证
合成阶段：1 个 Agent 生成报告

每个阶段的运行时长、Token 消耗、工具调用一目了然。

7. Workflow 支持的 6 种编排形态

Claude Code Workflow 支持 6 种编排模式，覆盖绝大多数复杂场景：

编排形态	说明	典型场景
Pipeline（流水线）	A → B → C 顺序执行	文档翻译、格式转换
ParallelBarrier（并行聚合）	多 Agent 并行，结果汇总	多维度代码审查、多源搜索
AdversarialVerify（对抗验证）	一个生成，一个挑刺	安全审计、方案评审
JudgePanel（评委制）	多 Agent 评分，取最优	设计方案对比、论文评审
Accumulative（累积式）	逐步叠加，逐轮完善	内容迭代、渐进式重构
Nested（嵌套式）	工作流中嵌套子工作流	大型项目的多阶段处理

8. 脚本管理与持久化

Claude Code 生成的 Workflow 脚本默认存储路径下，有效期只有 3 天，过期自动清理。

持久化方法：

# 在 Claude Code 中直接说：
把 deep-research 脚本复制到用户级路径

Claude Code 会自动将脚本复制到用户级目录，永久保留。

查看已有脚本：

# 让 Claude Code 列出可调用的 Workflow 脚本
列出可以调用的 workflow 脚本

9. 适用场景速查表

场景	推荐编排形态	说明
多维度代码审查	ParallelBarrier	安全、性能、可维护性并行审查
跨领域深度研究	Pipeline + ParallelBarrier	先并行搜索，再验证，再合成
设计方案探索	JudgePanel	多方案并行，评委打分选最优
Bug / 漏洞扫描	AdversarialVerify	扫描 + 对抗验证
跨文件大规模重构	Pipeline	分阶段逐步重构，每步有校验
文档生成 / 翻译	Pipeline	分段翻译，统一格式化

10. 常见问题与注意事项

Q：Workflow 功能官方还没正式发布，能用吗？
A：功能完整保留在代码中，V2.1.47 和 V2.1.48 均可正常使用。Anthropic 只是从文档中删除了说明，并未移除功能。

Q：脚本过期了怎么办？
A：默认 3 天清理。跑通后立即让 Claude Code 复制到用户级路径即可永久保存。

Q：Workflow 和 MCP 冲突吗？
A：不冲突。Workflow 负责编排 Agent 的执行流程，MCP 负责工具和数据的接入，两者可以配合使用。

Q：分享给团队的脚本，其他人怎么用？
A：将 .js 脚本文件放到对方 Claude Code 的工作流目录下，直接用 workflow 关键字调用即可。

11. 参考来源

Anthropic Claude Code 官方文档：https://docs.anthropic.com/en/docs/claude-code
Claude Code V2.1.47 / V2.1.48 Changelog（Workflow 功能说明已从 changelog 中移除，但功能保留）
B 站技术博主关于 Claude Code Workflow 功能的实战演示视频（本文实操内容基于该视频整理）
MCP（Model Context Protocol）官方规范：https://modelcontextprotocol.io

以上内容基于原视频博主对Claude Code V2.1.47 / V2.1.48 实测整理。视频转录用 Ai好记自动生成逐字稿和语义大纲，省去了大量手动整理时间——如果你也经常需要把技术视频拆成可复用的文档，它支持直接导出 Markdown，省下来的时间拿去跑代码验证更实在。觉得有用欢迎点赞收藏，有问题评论区交流。
在这里插入图片描述