开源 Claude Code 编程宝藏搭档 Oh My Claude Code 完整上手攻略

在上一篇关于 OpenCode 的文章中，我们介绍了它的搭档 Oh My OpenCode。这一篇，我们来看看另一个开源项目 Oh My Claude Code。它是一组构建在 Claude Code 之上的插件集合，定位也类似于 Oh My Zsh 之于 Zsh，做的也是同一类事情。

如果你用过一段时间 Claude Code，应该很熟悉这个流程：写提示词、等回复，必要时再手动调用子智能体，如此反复。这个流程本身没问题，但在实现复杂功能时，效率并不高。Oh My Claude Code（简称 OMC）正是为了解决这个问题而出现的。

接下来，我会拆解 OMC 的工作方式，实际测试它的执行模式，并看看它是否真的让多智能体编排变得更容易上手。

Oh My Claude Code 快速入门

什么是 Oh My Claude Code

Oh My Claude Code 是一套构建在 Claude Code 之上的插件和智能体集合。它融合了多个开源项目的思路（oh-my-opencode^[1]、claude-hud^[2]、Superpowers^[3]、everything-claude-code^[4]），把原本偏单点交互的 Claude Code，扩展成一个可用的多智能体编排系统，用来处理更复杂的任务。

简单来说，它提供了三样东西：

• • 多种执行模式，用来适配不同规模和复杂度的任务
• • 一组分工明确的专业智能体，覆盖常见开发角色
• • 尽量减少配置和学习成本，让你可以直接上手使用

核心能力：

• • 5 种执行模式：Autopilot、Ultrapilot（3–5 倍并行）、Swarm、Pipeline、Ecomode
• • 32 个专业智能体：从架构设计、编码实现到数据分析
• • 自动模型路由：简单任务用 Haiku，常规工作用 Sonnet，复杂推理交给 Opus
• • 自然语言控制：不需要记命令，直接描述你要做什么

它的理念很简单：你不需要花时间去学会 Claude Code，而是可以直接把 OMC 当成入口来用。

安装与配置

快速安装

安装 Oh My Claude Code 很简单，不需要额外的配置，也没有复杂的依赖。

整个过程在 Claude Code 里完成，只要两步。

步骤一：把插件加入市场

在 Claude Code 的终端中执行：

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

步骤二：安装插件

/plugin install oh-my-claudecode

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

/oh-my-claudecode:omc-setup

根据提示完成操作。

自动配置了什么？

运行设置向导后，OMC 会在后台帮你把一堆原本需要手动处理的东西一次性配好，包括：

• • 32 个专业智能体：每个智能体都有明确分工，以及对应的工具和模型配置
• • 40 个技能：覆盖编排、Git 操作、前端、架构等常见开发场景
• • 任务委托规则：根据你的输入，把任务自动分配给合适的智能体
• • 模型路由机制：在 Haiku、Sonnet 和 Opus 之间自动选择合适的模型
• • 关键词触发：通过自然语言切换不同的执行模式

这些配置会写入你的 .claude 目录下的 CLAUDE.md 文件。

配置完成后，终端里会看到一条提示，表示 OMC 已成功安装。

验证插件已启用

/plugin list

查看输出，确认插件已经启用。

项目级 vs 全局配置

OMC 支持两种配置方式，可以根据你的使用场景选择。

项目级配置（推荐）

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

该命令会在当前项目下生成 .claude/CLAUDE.md，配置只对这个仓库生效。

全局配置：

/oh-my-claudecode:omc-setup

这会在 ~/.claude/CLAUDE.md 中生成配置，对所有 Claude Code 会话生效。

如果同时存在项目级和全局配置，Claude Code 会优先使用项目级配置。

快速验证

配置完成后，可以用一个简单示例确认 OMC 是否正常工作。

autopilot: create a simple hello world function

如果一切配置正确，Claude 会提示类似：

这说明 OMC 已经接管了执行流程。

你也可以通过下面这个命令，查看当前可用的智能体和能力：

/oh-my-claudecode:help

执行后可以看到下面的结果。

五大执行模式详解

OMC 提供五种执行模式，每种模式都有自己的适用场景——从完全自主开发功能，到在 token 预算紧张时的轻量执行。

接下来，我们逐一看看它们各自的特点，以及什么时候该用哪种模式。

1. Autopilot — 完全自主执行模式

Autopilot 是 OMC 的旗舰模式。你只需要告诉它你想要做什么，OMC 会负责从规划、实施到测试的整个流程。

autopilot: build a REST API for managing tasks

它会做什么：

• • 自动规划需求和收集信息
• • 调用专业智能体并行执行任务
• • 持续进行验证和测试
• • 自我纠正直到任务完成

这一模式把 ralph（持久性）、ultrawork（并行性）和 plan（战略思维）等功能整合在一起，形成一个简化、流畅的自动化体验。

适用场景：

• • 构建完整功能模块或小型应用
• • 需要从头到尾覆盖整个开发流程
• • 希望尽量减少人工干预，让系统全程自动完成任务

2. Ultrapilot — 并行加速模式（3–5 倍提速）

Ultrapilot 可以看作是 Autopilot 的加速版。它在同样自动化流程的基础上，引入了最多 5 个并行工作者，用来同时推进多个子任务

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

核心特性：

• • 自动把任务拆分成可以并行执行的子任务
• • 协调文件所有权，避免多个智能体同时修改同一部分代码
• • 在多组件项目中，整体执行速度可提升约 3–5 倍

相比 Autopilot，Ultrapilot 更强调并行效率，尤其适合任务本身就可以拆开的场景。

适用场景：

• • 大规模代码重构
• • 包含多个模块或服务的系统
• • 希望尽可能缩短整体开发时间的复杂项目

3. Swarm — 协作团队模式

Swarm 模式会生成一组智能体，让它们从一个共享的任务池中协作完成工作。每个智能体会主动认领一个最小粒度的任务，完成后标记为已处理，然后继续领取下一个。

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

核心特性：

• • 任务以原子级别拆分，避免重复处理
• • 每个任务都有 5 分钟超时，超时后自动释放，防止卡死
• • 支持 2 到 10 个并行工作者
• • 当任务池清空后，流程会自然结束

可以把它理解成一支开发团队围着一个看板，各自领取任务、完成后再拿下一个。

适用场景：

• • 修复大量彼此独立的问题（比如一堆 TypeScript 报错）
• • 批量、重复性的代码修改
• • 需要多名执行者同时推进的一组任务

4. Pipeline — 流水线模式

Pipeline 模式把多个智能体按固定顺序串联起来，前一个阶段的输出会直接作为下一个阶段的输入。它非常适合那些必须按步骤推进的工作流程。

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

内置流水线：

• • review — explore → architect → critic → executor
• • implement — planner → executor → tdd-guide
• • debug — explore → architect → build-fixer
• • refactor — explore → architect-medium → executor-high → qa-tester

这些预设覆盖了常见的开发流程，你也可以根据自己的需求，组合出专门的流水线。

适用场景：

• • 需要标准化步骤的代码审查
• • 对执行顺序要求严格的开发流程
• • 包含多个阶段的任务（探索 → 设计 → 实现 → 验证）

5. Ecomode — 经济模式

Ecomode 的目标很简单：在不明显牺牲效率的前提下，把 token 消耗压下来。它同样支持并行执行，但会通过模型自动分配，尽量用更便宜的模型完成任务。

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

它是怎么省 token 的：

• • 简单、机械性的任务 → 用 Haiku
• • 一般开发工作 → 用 Sonnet
• • 真正需要复杂推理时 → 才上 Opus

这个模式对 Pro 用户尤其友好：既能保持不错的执行速度，又不会很快把配额烧光。

适用场景：

• • 对成本比较敏感的项目
• • 希望并行执行，但不追求极限智能
• • 大型重构、日常维护、长期运行的代码库整理

魔法关键词与智能委托

OMC 最方便的一点是：你基本不用去记各种命令。

大多数时候，你只需要用自然语言描述想做什么，OMC 会自动识别你的意图，并选择合适的执行模式和智能体来完成任务。

当然，如果你希望更精确地控制执行流程，也可以使用魔法关键词来显式指定模式和行为，让系统严格按你的预期运行。

魔法关键词参考

你可以把多个关键词组合起来，让 OMC 执行更复杂的任务：

ralph ulw: migrate the entire database

• • ralph → 启用持久性，保证任务不中途停止
• • ulw → 启用 Ultrapilot 的并行能力，加快执行速度

通过这种方式，你可以自由组合不同能力，让 OMC 按你的需求调度智能体和模式。

自然语言检测

即使你不使用魔法关键词，OMC 也能从自然语言中理解你的意图：

智能模型路由

OMC 会根据任务复杂度自动选择合适的模型：

这样既能节省 token，又能保证执行质量：简单任务不用占用 Opus，复杂任务则会获得它们所需的计算和推理能力。

32 个专业智能体生态

OMC 不只是按任务复杂度选择模型，还会根据问题类型进行分工。

系统内置了一组按职责划分的智能体，例如：

分析与架构

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

执行

• • executor-high (Opus) ：复杂重构
• • executor (Sonnet)：功能实现
• • executor-low (Haiku)：简单代码修改

搜索与探索

• • explore-high (Opus)：架构级搜索
• • explore-medium (Sonnet)：深入代码查找
• • explore (Haiku)：快速定位

前端与设计

• • designer-high (Opus)：复杂 UI 系统
• • designer (Sonnet)：组件级 UI
• • designer-low (Haiku)：简单样式调整

其他角色

• • planner (Opus)：任务与方案规划
• • critic (Opus)：方案审查
• • researcher (Sonnet)：文档与资料查找
• • writer (Haiku)：技术文档
• • qa-tester (Sonnet)：CLI 测试
• • scientist (Sonnet)：数据分析
• • vision (Sonnet)：图像相关任务

当你说「修复 UI 颜色」时，任务会被分配给设计相关的智能体；当你问「这个崩溃怎么来的」，系统会转到架构和调试方向

整个过程都是自动完成的，不需要手动指定。

总结与展望

Oh My Claude Code 的上手成本很低。基本不需要额外学习，安装、简单配置之后，就可以直接开始使用多智能体流程。对于中小规模的功能或应用，它能把从规划、实现到验证的流程串起来。前端、架构、测试、文档各有对应的智能体，任务也会自动分配给更合适的模型处理。

OMC 本身带着一套对 Claude Code 的使用理念。如果你习惯所有步骤都自己掌控，这种自动化程度可能会让你有点不适应。

如果你希望 Claude Code 不只是偶尔写几段代码，而是真正参与到日常开发流程中，OMC 会是一个不错的选择。

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

引用链接

[1] oh-my-opencode: https://github.com/code-yeongyu/oh-my-opencode[2] claude-hud: https://github.com/jarrodwatts/claude-hud[3] Superpowers: https://github.com/NexTechFusion/Superpowers[4] everything-claude-code: https://github.com/affaan-m/everything-claude-code