Vibe Coding - Oh My Claude Code：把 Claude Code 变成“多智能体开发助手”的完整实战指南

文章目录

• [一、先搞清楚：OMC 到底解决什么问题？](#一、先搞清楚：OMC 到底解决什么问题？)
• [二、OMC 是什么：站在多智能体视角看 Claude Code](#二、OMC 是什么：站在多智能体视角看 Claude Code)
• • [2.1 核心理念](#2.1 核心理念)
  • [2.2 功能一览（从"工具箱视角"看）](#2.2 功能一览（从“工具箱视角”看）)
• 三、从零开始：安装、配置到首次跑通
• • [3.1 两步完成安装](#3.1 两步完成安装)
  • [3.2 向导背后帮你做了什么？](#3.2 向导背后帮你做了什么？)
  • [3.3 项目级 vs 全局配置](#3.3 项目级 vs 全局配置)
  • [3.4 如何确认安装生效？](#3.4 如何确认安装生效？)
• 四、五大执行模式：什么时候用哪一个？
• • [4.1 Autopilot：全自动执行模式](#4.1 Autopilot：全自动执行模式)
  • [4.2 Ultrapilot：并行加速版（3--5 倍）](#4.2 Ultrapilot：并行加速版（3–5 倍）)
  • [4.3 Swarm：类似"多人领任务"的协作模式](#4.3 Swarm：类似“多人领任务”的协作模式)
  • [4.4 Pipeline：按步骤来的流水线模式](#4.4 Pipeline：按步骤来的流水线模式)
  • [4.5 Ecomode：省钱省配额的经济模式](#4.5 Ecomode：省钱省配额的经济模式)
• 五、用"魔法关键词"精细控制行为
• • [5.1 关键词组合示例](#5.1 关键词组合示例)
  • [5.2 自然语言检测：不记命令也能用](#5.2 自然语言检测：不记命令也能用)
• [六、32 个专业智能体：一支虚拟开发团队长啥样？](#六、32 个专业智能体：一支虚拟开发团队长啥样？)
• • [6.1 分工一：分析与架构](#6.1 分工一：分析与架构)
  • [6.2 分工二：执行（写代码的工人）](#6.2 分工二：执行（写代码的工人）)
  • [6.3 分工三：搜索与探索](#6.3 分工三：搜索与探索)
  • [6.4 分工四：前端与设计](#6.4 分工四：前端与设计)
  • [6.5 其他关键角色](#6.5 其他关键角色)
• 七、把这些能力用在真实项目里：几个实战思路
• • [7.1 新项目从零起步](#7.1 新项目从零起步)
  • [7.2 老项目的大规模重构](#7.2 老项目的大规模重构)
  • [7.3 长期演进项目的"省钱用法"](#7.3 长期演进项目的“省钱用法”)
• 八、体验与限制：这类多智能体工具适合谁？
• • [8.1 使用体验的几个亮点](#8.1 使用体验的几个亮点)
  • [8.2 可能不太适合的情况](#8.2 可能不太适合的情况)
• [九、结语：把 Claude Code 真正变成你的"工程团队"](#九、结语：把 Claude Code 真正变成你的“工程团队”)

一、先搞清楚：OMC 到底解决什么问题？

很多人用 Claude Code 的日常流程大概是这样：

• 写一段提示词
• 等回复
• 不够就补充上下文
• 偶尔手动切换子智能体或模型

这个流程做简单需求还行，一旦要实现复杂功能，就会出现几个典型痛点：

• 需要你反复手动拆任务
• 哪个子智能体更适合要你自己判断
• 需要并行处理时，手动来回切很费劲
• 模型选择（Haiku / Sonnet / Opus）也要自己拿捏

Oh My Claude Code（OMC） 就是为解决这些问题，把 Claude Code 从"一个聪明的 AI 搭档"，升级成"一个有多角色团队、能自动调度的开发系统"。

简单一句话概括：

你负责说目标，OMC 负责拆任务、分工、选模型、并行执行、验证和收尾。

---

二、OMC 是什么：站在多智能体视角看 Claude Code

2.1 核心理念

OMC 是构建在 Claude Code 之上的一套插件 + 智能体生态，它吸收了 oh-my-opencode、claude-hud、Superpowers、everything-claude-code 等多个开源项目的实践，把这些"零散能力"整合成一个完整的多智能体编排系统。

它重点提供三件事：

• 多种执行模式：针对不同规模、复杂度的任务选合适的"工作模式"
• 专业智能体团队：把常见开发角色（架构、执行、探索、测试、文档等）全部拆成专门智能体
• 降低心智负担：安装完几乎就能用，不要求你先读一堆文档或写一份长配置文件

2.2 功能一览（从"工具箱视角"看）

从功能清单看，OMC 主要具备这些能力：

• 5 种执行模式

  • Autopilot
  • Ultrapilot（强调并行，速度可提升 3--5 倍）
  • Swarm
  • Pipeline
  • Ecomode

• 32 个专业智能体

  • 覆盖：架构设计、编码实现、前端 UI、调试、数据分析、文档撰写、测试等角色。

• 自动模型路由

  • 简单任务用 Haiku
  • 常规开发用 Sonnet
  • 真正复杂推理才交给 Opus。

• 自然语言控制

  • 日常使用时基本不用记命令，你就像和"项目总监"说话一样说明需求，剩下的交给它。
  • 需要精细控制时，可以用"魔法关键词"组合精确"调度方式"。

---

三、从零开始：安装、配置到首次跑通

这一块对实际落地很关键，我按"能最快跑起来"的顺序讲一遍。

3.1 两步完成安装

所有操作都在 Claude Code 里完成：

步骤一：把插件源加入 marketplace

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

步骤二：安装插件

/plugin install oh-my-claudecode

安装完成后，运行设置向导：

/oh-my-claudecode:omc-setup

照提示走即可，不需要额外依赖或复杂配置。

3.2 向导背后帮你做了什么？

向导执行完，其实帮你自动铺好了很多"本该手动写配置"的东西，包括：

• 32 个专业智能体：带好角色定义、工具和模型配置
• 40 个技能：覆盖编排、Git 操作、前端、架构等常见场景
• 任务委托规则：根据你的自然语言，把任务派给合适智能体
• 模型路由：在 Haiku、Sonnet、Opus 之间自动选择
• 关键词触发：支持用自然语言切换执行模式

这些内容会被写入 .claude/CLAUDE.md（或全局 ~/.claude/CLAUDE.md）。

3.3 项目级 vs 全局配置

OMC 支持两种粒度的配置：

• 项目级（推荐）：

  /oh-my-claudecode:omc-setup --local

  会在当前项目生成 .claude/CLAUDE.md，只对当前仓库生效。

• 全局配置：

  /oh-my-claudecode:omc-setup

  在 ~/.claude/CLAUDE.md 创建配置，对所有会话生效。

如果两者同时存在，项目级优先。这一点对于多项目不同规范的团队非常有用，比如：

• A 项目偏前端，优先加强 UI 类智能体
• B 项目偏数据，优先强化分析和科学计算相关智能体

3.4 如何确认安装生效？

两个简单检查方式：

1. 看插件列表：

   /plugin list

   确认列表里有 oh-my-claudecode 且状态为启用。

2. 用一个最小示例跑一遍：

   autopilot: create a simple hello world function

   如果 OMC 正常接管，你会看到控制台里出现类似"自动规划、执行和验证"的流程提示。

也可以看看帮助信息：

/oh-my-claudecode:help

这里会列出当前可用模式、智能体和一些示例用法。

---

四、五大执行模式：什么时候用哪一个？

这一节可以理解为"选模式指南"，关乎你每天怎么和 OMC 相处。

4.1 Autopilot：全自动执行模式

定位：你只给目标，它负责从规划到收尾的全流程。适合"我要一个功能"，不想管细节的场景。

示例指令：

autopilot: build a REST API for managing tasks

它会自动做的事情包括：

• 分析需求，整理信息
• 调用合适智能体执行（有一定并行）
• 写完代码后自检、自测
• 如果发现问题，会自行调整直到任务收尾

Autopilot 背后融合了 ralph（持久）、ultrawork（并行）和 plan（规划）等能力，对你来说就一个感受：说完需求，稍等一会看结果。

适合用在：

• 构建独立功能模块或小应用
• 希望覆盖"分析 → 编码 → 测试"的完整流程
• 不想频繁中途打断、人工干预

4.2 Ultrapilot：并行加速版（3--5 倍）

Ultrapilot 可以看成 Autopilot 的"进阶加速版"，区别在于更强调并行：一次最多可以拉起 5 个并行"工人"，尤其适合可拆分的复杂任务。

示例指令：

/oh-my-claudecode:ultrapilot "build a fullstack todo app"

它的特点主要有：

• 自动把大任务拆成多个可并行子任务
• 处理文件所有权，避免"两个智能体同时改一个文件"的冲突
• 在多模块项目中整体执行速度有明显提升（实践中约 3--5 倍）

适合用在：

• 大规模代码重构
• 多模块/多服务系统开发
• 希望明显缩短总开发时长的复杂项目

4.3 Swarm：类似"多人领任务"的协作模式

Swarm 模式更像一支开发小分队，围着一个任务池轮流领活干。

示例指令：

/oh-my-claudecode:swarm 5:executor "fix all TypeScript errors"

这里的意思是：拉 5 个执行智能体，并行去任务池中"抢" TypeScript 报错的修复任务。

它的机制特点：

• 把任务拆成原子级小任务，完成即打勾
• 每个任务默认有 5 分钟超时，防止卡死
• 并行工人数可以在 2--10 之间调整
• 任务池清空后流程自动结束

非常适合：

• 一堆互不关联的问题（例如：大量类型报错、lint 问题）
• 大量重复、简单但耗时的修改
• 你只想丢给"机器人团队"去清 backlog

4.4 Pipeline：按步骤来的流水线模式

Pipeline 模式是把几个智能体按固定顺序串起来，用在"必须按阶段推进"的场景。

基本用法示例：

/oh-my-claudecode:pipeline explore:haiku -> architect:opus -> executor:sonnet

内置的几条典型流水线：

• review：explore → architect → critic → executor（适合代码评审）
• implement：planner → executor → tdd-guide（按 TDD 思路实现）
• debug：explore → architect → build-fixer（专门走调试链路）
• refactor：explore → architect-medium → executor-high → qa-tester（重构 + 测试）

你也可以根据团队流程自定义，比如"探索 → 方案评审 → 实现 → 性能测试"。

适合用在：

• 有固定步骤的代码审查
• 对执行顺序有严格要求的工作流
• 想把"探索 → 设计 → 实现 → 验证"规整成一套可复用的流程

4.5 Ecomode：省钱省配额的经济模式

Ecomode 的目标很直接：在不明显拖慢效率的前提下，尽量省 token。

示例指令：

/oh-my-claudecode:ecomode "refactor the authentication system"

它具体怎么省：

• 简单、机械工作 → Haiku
• 一般开发任务 → Sonnet
• 确实需要复杂推理 → 才上 Opus

这对用 Pro 账号、又有成本敏感项目的人很实用：你既能保证"够用的智能"，又不会每次改点小东西就吃掉大量配额。

适合用在：

• 长期维护的项目
• 大型重构但预算有限的团队
• 日常工程卫生、代码库整理

---

五、用"魔法关键词"精细控制行为

默认情况下，你只要用自然语言说事，OMC 就能判断该用什么模式、哪个智能体。

但如果你想更"手动挡"，就可以用"关键词组合"来精确控制。

5.1 关键词组合示例

例子：

ralph ulw: migrate the entire database

这行的意思是：

• ralph：启用持久执行，长任务不容易中途停
• ulw：启用 Ultrapilot 并行能力，加快整体迁移速度

你可以把它理解成是几个"开关"的组合：

• 是否需要长时间挂着跑？
• 是否要尽量并行？
• 是否偏省钱？

5.2 自然语言检测：不记命令也能用

即便你一个关键词都不记，直接说：

"帮我把这个项目所有 TypeScript 报错修完，再顺便把重复代码重构一下。"

OMC 也会尝试从这句话判断：

• 这是批量修复 + 重构
• 适合用 Swarm 或 Ultrapilot
• 需要调用执行类 + 探索类智能体。

你只管说"我要什么"，它来决定"怎么干活"。

---

六、32 个专业智能体：一支虚拟开发团队长啥样？

OMC 的智能体不是"随便起了 32 个名字"，而是按职责分工来设计的。

6.1 分工一：分析与架构

• architect (Opus)：做复杂系统设计和疑难调试
• architect-medium (Sonnet)：常规问题分析
• architect-low (Haiku)：快速定位简单问题

理解方式：

• 线上复杂故障 → architect (Opus)
• 日常需求评审 → architect-medium
• "这个地方报错源头在哪" → architect-low 快速扫一遍。

6.2 分工二：执行（写代码的工人）

• executor-high (Opus)：复杂重构、大型改动
• executor (Sonnet)：日常功能开发
• executor-low (Haiku)：小修小补

你可以把它看成"高级工程师 / 中级 / 初级"三档，按任务难度自动分配。

6.3 分工三：搜索与探索

• explore-high (Opus)：需要跨模块、跨层级的架构级搜索
• explore-medium (Sonnet)：深入单模块查找逻辑
• explore (Haiku)：快速定位某段代码、某个调用链入口

适合用在：

• 新接手的项目，先跑一遍探索了解结构
• 找某个 bug 的影响范围
• 搜一个改动会影响到哪里。

6.4 分工四：前端与设计

• designer-high (Opus)：负责复杂、整体性的 UI 系统
• designer (Sonnet)：组件级 UI 实现
• designer-low (Haiku)：简单样式调整、颜色修改

比如你说"把这个页面的按钮风格统一成某种视觉规范"，大概率会走到 designer 相关智能体，而不是直接交给通用 executor。

6.5 其他关键角色

还有一些偏"辅助"但非常实用的角色：

• planner (Opus)：任务规划、方案拆解
• critic (Opus)：方案审查、找漏洞
• researcher (Sonnet)：查文档、查资料
• writer (Haiku)：写技术文档、README
• qa-tester (Sonnet)：命令行层面的测试
• scientist (Sonnet)：数据分析相关任务
• vision (Sonnet)：图像相关任务

配合前面五大模式，基本可以覆盖开发全流程：

需求 → 方案 → 实现 → 测试 → 文档 → 数据分析。

---

七、把这些能力用在真实项目里：几个实战思路

下面给几个典型项目场景，用来帮你脑补 OMC 在日常开发中的落地方式。

7.1 新项目从零起步

目标：做一个简单但完整的任务管理 Web 应用。

一个可能的流程是：

1. 用 Autopilot 起步：

   autopilot: build a REST API for managing tasks with user auth

2. 完成后，用 Pipeline 做一轮 review：

   /oh-my-claudecode:pipeline review

3. 最后用 writer 生成初版文档，再由你手工微调。

这样一轮下来，你几乎是站在"架构师 + 工程团队"的肩膀上，从 Day 1 就有完整的代码 + 文档 + 基本测试。

7.2 老项目的大规模重构

场景：几万行 TypeScript，历史包袱重、报错一堆。

一个高效组合是：

• 先用 Swarm 清除所有 TypeScript 错误：

  /oh-my-claudecode:swarm 8:executor "fix all TypeScript errors"

• 然后用 Ultrapilot 处理跨模块重构：

  /oh-my-claudecode:ultrapilot "refactor the legacy auth and routing system"

• 最后跑一次 refactor 流水线，对关键模块做有计划的重构 + QA 测试。

7.3 长期演进项目的"省钱用法"

如果你在一个长期维护的项目上，每天都有小需求、小 bug，Ecomode 很适合做"日常辅助手"：

/oh-my-claudecode:ecomode "update the logging system and remove dead code"

它会尽量用 Haiku 和 Sonnet 扛住绝大部分工作，只有遇到复杂逻辑才拉 Opus，避免你在一些"没必要用大模型的地方"浪费成本。

---

八、体验与限制：这类多智能体工具适合谁？

8.1 使用体验的几个亮点

总结来看，OMC 有几个明显优点：

• 上手门槛低：装好、跑一遍向导，你几乎不用额外学习就能开始用
• 角色齐全：前端、架构、测试、文档都有对应智能体
• 自动分配合理：通常能把任务派给合适的模型和角色
• 更适合"把 Claude Code 融入日常开发"，而不是偶尔玩玩写几段代码。

8.2 可能不太适合的情况

但也不是所有人都会立刻爱上这套模式：

• 如果你很在意"每一步都自己掌控"，高度自动化可能会让你觉得不踏实
• 如果团队代码规范、测试体系还比较薄弱，直接上自动化大改动，反而容易出问题

比较合理的策略是：

• 从辅助性任务开始（修报错、写测试、写文档）
• 慢慢再把"核心业务实现"交给 Autopilot / Ultrapilot，自己做最后一层 review。

---

九、结语：把 Claude Code 真正变成你的"工程团队"

Oh My Claude Code 做的一件事，可以总结成：

它不是再给你一个"更聪明的对话机器人"，而是帮你组了一支结构完整的虚拟开发团队，并且把调度这支团队的复杂性封装在背后。

从安装、配置，到五种模式、32 个智能体，再到流水线、经济模式，它事实上给出了"多智能体 + 开发工作流"的一个较完整实践模板。

如果你已经在用 Claude Code，又常常觉得：

• 明明模型很强，但用起来碎片化
• 自己一直在当"调度员"和"翻译"，效率不成正比

那么可以尝试用 OMC 做一个小项目，亲身体验一下从"单点对话"到"多智能体协作"的差别。

项目地址：

• GitHub：https://github.com/Yeachan-Heo/oh-my-claudecode