用过 Claude Code 的人都知道,它很强。 但强归强,用起来有不少痛点:Token 烧得快、任务动不动崩溃、复杂项目搞不定。 Oh-My-ClaudeCode(OMC)就是来治这些病的。

一、为什么需要 OMC?
原生 Claude Code 的三大痛点
痛点 1:Token 消耗高
Claude Code 默认用最贵的模型处理所有任务。 不管你是改一行注释,还是重构整个模块,它都上 Opus。 结果?一个月 Token 账单看得你心疼。
更烦的是,它经常重复试错。 同一个问题试了 3 次,每次都消耗大量 Token。 效率没提高,钱花了不少。
痛点 2:任务容易中途崩溃
你让 Claude Code 跑一个复杂任务。 跑了一半,报错了。 或者超时了。 或者因为速率限制被中断了。
最气人的是什么? 它不会自动恢复。 你得从头再来。 时间浪费了,Token 也浪费了。
痛点 3:模型调度粗糙
原生 Claude Code 只有一个模型在工作。 它不会根据任务难度选择合适的模型。 简单的格式化,用 Opus 杀鸡用牛刀。 复杂的架构设计,它又可能用 Haiku 敷衍你。
而且,复杂任务它串行处理。 一个一个来。 不能并行。 大项目等得你心焦。
OMC 怎么解决这些问题?
| 痛点 | OMC 的解法 |
|---|---|
| Token 消耗高 | MSE 智能模型路由:简单任务用 Haiku,复杂推理用 Opus,自动节省 30-50% Token |
| 任务中途崩溃 | 持久化执行(Ralph 模式):中断自动恢复,断点续传,不死不休 |
| 模型调度粗糙 | 32 个专业智能体 + 自动委派:每个任务匹配最合适的 Agent |
一句话总结:OMC 给 Claude Code 装了个智能大脑。
二、OMC 是什么?
项目简介
Oh-My-ClaudeCode(简称 OMC)是一个开源免费的 Claude Code 增强插件。
- GitHub 6000+ 星标
- 作者:Yeachan-Heo
- 协议:MIT
- 官方文档:yeachan-heo.github.io/oh-my-claud...
核心理念就一句话:
不用学 Claude Code,直接用 OMC 就行。
核心能力一览
1. 多智能体协作(Team Mode)
这是 OMC 最核心的能力。
你可以同时启动多个 Agent,它们分工合作:
- 一个做架构设计
- 一个写代码
- 一个跑测试
- 一个做代码审查
它们共享一个任务列表,实时通信,自动协调。
启动方式:
bash
/team 3:executor "fix all TypeScript errors"
Team 按流水线运行:
perl
team-plan → team-prd → team-exec → team-verify → team-fix(循环)
还可以跨模型协作:
bash
/omc-teams 2:codex "review auth module" # Codex 做代码审查
/omc-teams 2:gemini "redesign UI" # Gemini 做 UI 设计
/ccg Review this PR # 三模型并行
2. 智能成本优化
OMC 内置 MSE(Model-Smart-Economy)智能模型路由。
工作原理:
- 简单任务(格式化、小修改)→ 自动用 Haiku,省钱
- 中等任务(功能开发、bug 修复)→ 自动用 Sonnet,平衡
- 复杂任务(架构设计、深度推理)→ 自动用 Opus,保质量
实测效果:Token 消耗降低 30-50%。
另外,OMC 还有经验复用机制。 遇到类似问题,直接复用之前的解决方案。 不重复踩坑,不重复消耗 Token。
3. 持久化执行(Ralph 模式)
Ralph 模式 = 不达目的不罢休。
arduino
ralph: refactor the authentication module
启动后,Ralph 会:
- 持续工作直到任务完成
- 遇到错误自动重试
- 中断后自动恢复
- 完成后自动验证
最多循环 100 次(可配置)。 中间不会半途而废。
4. 实时监控(HUD 状态栏)
OMC 在 Claude Code 底部显示一个 HUD 状态栏。
你可以实时看到:
- 当前活跃的 Agent 数量
- Token 消耗情况
- 任务执行进度
- 模型选择情况
不用猜,不用等,一目了然。
5. 更多执行模式
除了上面四个核心能力,OMC 还提供多种执行模式:
| 模式 | 特点 | 适用场景 |
|---|---|---|
| Team(推荐) | 阶段化流水线 | 多 Agent 协作 |
| Autopilot | 全自主执行 | 端到端功能开发 |
| Ralph | 持久模式 | 必须完成的任务 |
| Ultrawork | 最大并行 | 并行修复/重构 |
| Pipeline | 顺序处理 | 多阶段转换 |
| Deep-Interview | 苏格拉底提问 | 需求不明确时 |
魔法关键词(可选,自然语言也行):
| 关键词 | 效果 |
|---|---|
team |
Team 编排 |
autopilot |
全自动执行 |
ralph |
持久模式 |
ulw |
最大并行 |
plan |
规划访谈 |
ralplan |
迭代规划共识 |
6. 技能学习与复用
OMC 会从你的开发过程中提取可复用的技能。
比如你解决了一个 proxy 崩溃问题。 OMC 自动生成技能文件:
bash
# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
在 server.py:42 的处理程序外包裹 try/except ClientDisconnectedError...
下次遇到类似问题,自动加载这个技能。 不用重复踩坑。
三、安装配置(保姆级)
前置要求
| 要求 | 说明 |
|---|---|
| Claude Code | 已安装并能正常使用 |
| Node.js | 18+ 版本 |
| 订阅 | Claude Max / Pro,或 Anthropic API Key |
可选(进阶功能需要):
| 工具 | 安装命令 | 用途 |
|---|---|---|
| tmux | 系统包管理器安装 | omc-teams 多窗口协作 |
| Codex CLI | npm install -g @openai/codex |
代码审查交叉验证 |
| Gemini CLI | npm install -g @google/gemini-cli |
UI/设计审查(1M 上下文) |
一键安装
在 Claude Code 中运行两条命令:
bash
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
第一条添加 OMC 到插件市场。 第二条安装插件。
就这么简单。
基础配置
安装完后,运行配置向导:
arduino
/omc-setup
配置过程约 10-15 分钟。
向导会自动完成:
- 生成 CLAUDE.md 配置文件
- 配置 MCP 服务器(Context7、Exa 搜索、GitHub 等)
- 设置 HUD 状态栏
- 安装 CLI 分析工具
- 启用 Claude Code 原生团队功能
配置完成后你会看到:
arduino
● OMC 设置完成!
您不需要学习任何命令。我现在具有自动激活的智能行为。
自动发生的事情:
- 复杂任务 → 我会并行化并委托给专家
- "计划这个" → 我开始规划访谈
- "不要停止直到完成" → 我会持续工作直到验证完成
- "停止"或"取消" → 我会智能地停止当前操作
可选配置:项目级 vs 全局
- 全局配置:所有项目生效,配置文件在
~/.claude/CLAUDE.md - 项目级配置:只对当前项目生效,配置文件在
./.claude/CLAUDE.md
项目级配置优先级高于全局。
如果只想在当前项目使用 OMC:
bash
/omc-setup --local
验证安装成功
方法 1:看 HUD 状态栏
重启 Claude Code,底部应该出现 OMC 状态栏。
方法 2:运行 CLI 工具
bash
omc stats # 查看 Token 使用和成本
omc agents # 按 Agent 查看消耗
omc tui # 启动交互式仪表板
方法 3:试一个简单任务
yaml
autopilot: build a hello world API
如果 OMC 正常工作,你会看到:
- HUD 显示任务进度
- 多个 Agent 自动分工
- 任务流水线执行
更新 OMC
bash
/plugin marketplace update omc
/omc-setup
注意: 更新后必须重新运行 /omc-setup,否则配置可能不同步。
如果更新后遇到问题,清除缓存:
bash
/omc-doctor
卸载 OMC
bash
curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/scripts/uninstall.sh | bash
(未完待续:四、核心功能详解 → 五、实战案例 → 六、进阶配置 → 七、对比 → 八、FAQ → 九、总结)
点点赞和关注不迷路,后续还会分享更多 AI 效率工具。
👨💻 H先生出品 | 专注 AI 工具与效率提升