你还在一个人死磕代码?隔壁用 oh-my-claudecode 的工程师,已经让 32 个 AI 智能体同时帮他干活了。
写在前面:一个 GitHub 项目,三个星期狂揽 32000 星
2025 年下半年,AI 编程工具圈发生了一件大事。
一个叫 oh-my-claudecode(简称 OMC) 的开源插件,在没有任何商业推广的情况下,三周内在 GitHub 狂揽 32000 颗星,成为当年增长最快的 AI 开发工具插件之一。
它做到了一件很多人觉得"不可能"的事:
让一个人,拥有一支 32 人 AI 开发团队的战斗力。
你可以只说一句话 —— 比如「帮我做一个任务管理 REST API」,然后去泡杯咖啡。回来的时候,架构设计、代码实现、测试验证,全部完成。
这不是科幻,这是 2025 年正在发生的现实。
今天这篇文章,我会把 OMC 的核心机制、安装方式、使用技巧,一次性全部讲透。全文超过 8000 字,建议收藏后慢慢看。
一、先讲故事:这个项目是怎么诞生的?
故事要从 oh-my-opencode 说起。
2025 年初,一个叫 oh-my-opencode 的项目横空出世。它基于开源的 OpenCode 编辑器,给它加上了「多智能体并行执行」能力和一个叫 Ultrawork 的超级工作模式。用户纷纷表示:「我已经取消 Cursor 订阅了,完全用不上了。」
这个项目有多猛?一位量化研究员 B 说了这样一句话:
「如果 Claude Code 做 7 天,能完成人类 3 个月的工作,那 Sisyphus(oh-my-opencode 的核心智能体)做 1 小时,就能完成 3 个月的工作。它就是不停干,直到任务完成为止。」
但好景不长。Anthropic 以违反服务条款为由,封锁了 OpenCode 对 Claude 订阅账号的 OAuth 调用。oh-my-opencode 的核心功能受到影响。
就在这个时候,oh-my-claudecode 诞生了。
它的作者 Yeachan Heo 选择了完全不同的路:不做任何 ToS 违规的事,完全基于 Claude Code 的官方 Hooks 机制构建。没有偷用 OAuth,没有绕过任何限制,一切都在官方许可范围之内。
开发者们迅速迁移过来。毕竟,谁也不想被封号。
从此,oh-my-claudecode 成为了 Claude Code 插件生态里的「第一插件」,也是目前最完整的多智能体编排框架。
二、核心理念:「不要学 Claude Code,直接用 OMC」
这是 oh-my-claudecode 官方文档第一句话。
听起来很狂,但这句话背后有非常扎实的逻辑。
Claude Code 是个强大的底层引擎,但它的原始用法需要你不断地切换思路、手动协调不同角色(架构师、开发者、测试员)、管理上下文。对于复杂任务,你得当「总指挥」,这很累。
OMC 的核心设计哲学是:把「总指挥」的工作也自动化掉。
你只需要用自然语言描述你想要什么,OMC 会自动判断:
这个任务需要哪些专业智能体来协作? 各个阶段的产出如何传递给下一个阶段? 哪些步骤可以并行处理,哪些需要串行等待? 用什么级别的模型来处理(便宜的 Haiku 还是强大的 Opus)?
这套自动决策机制,就是 OMC 的灵魂。
三、快速开始:30 秒完成安装
好,理念讲完,直接上干货。
安装方式一:插件市场(推荐)
在 Claude Code 的对话框里,逐行输入以下命令(注意:不能两行一起粘贴):
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
等第一条执行完后,再输入:
/plugin install oh-my-claudecode
安装方式二:npm 直装
如果你熟悉命令行,也可以直接用 npm 安装(注意 npm 包名和项目名不同):
npm i -g oh-my-claude-sisyphus@latest
⚠️ 特别提示:项目名叫 oh-my-claudecode,但 npm 包名是 oh-my-claude-sisyphus,不要搞混。
初始化配置
安装完成后,在 Claude Code 里运行:
/omc-setup
或者在终端里运行:
omc setup
就这三步,完成。
安装完毕后,所有 / 命令和魔法关键词立即生效,无需额外配置。这就是 OMC 最吸引人的地方之一:零配置,装完即用。
Windows 用户特别说明
OMC 依赖 tmux 来实现多进程并行。Linux 和 macOS 可以直接通过包管理器安装 tmux。Windows 用户推荐安装 psmux(一个原生 Windows 版 tmux 实现),它无需 WSL2 即可运行 OMC 的全部功能。
四、Team 模式:五阶段流水线,这才是 OMC 的真正王炸
从 v4.1.7 版本开始,Team 模式已经成为 OMC 的默认核心编排方式。
什么是 Team 模式?
简单说,就是把一个复杂的开发任务,拆解成五个阶段,每个阶段由专门的智能体负责,前一阶段的输出作为后一阶段的输入,形成一条完整的流水线:
[需求分析] → [PRD 文档] → [并行实现] → [质量验证] → [问题修复]
让我逐个阶段讲清楚:
第一阶段:team-plan(需求分析)
这个阶段由「架构师」和「规划师」两个智能体协作。
它们会接收你的原始需求,分析任务范围,识别所有涉及的文件和模块,并构建依赖关系图。这就像一个真实的技术 Lead 在接到需求后,先拉通所有人理解边界再动手。
第二阶段:team-prd(产品需求文档)
基于第一阶段的规划结果,「写作者」和「设计师」智能体生成一份完整的 PRD(产品需求文档)。
这份文档会被注入到后续所有阶段的上下文里,确保所有智能体在同一个理解框架下工作。这是 OMC 解决「AI 失忆」问题的关键设计之一。
第三阶段:team-exec(并行实现)
这是最核心的阶段。多个智能体根据 PRD 并行实现代码。
在这个阶段,tmux CLI Workers 登场了(后面会详细讲)。不同的工程师型智能体可以同时处理不同模块,速度提升显著。
第四阶段:team-verify(质量验证)
实现完成后,验证型智能体接管,对代码质量、测试覆盖率、架构一致性进行全面检查。
这个阶段通过了,任务完成。没通过,进入第五阶段。
第五阶段:team-fix(问题修复)
修复阶段完成后,重新回到验证阶段。这个「验证 → 修复 → 验证」的循环会一直持续,直到代码真正通过验证为止。
这就是为什么很多用户说 OMC 「就是不停干,直到完成」。因为它的设计本身就包含了这个持久执行循环。
如何触发 Team 模式
启动前,需要在 Claude Code 配置里启用实验性功能(Team 模式依赖 Anthropic 官方的 Agent Teams 特性):
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
然后在 Claude Code 里直接说:
/team 帮我实现一个支持 JWT 认证的用户管理系统
或者使用自然语言(搭配魔法关键词,见下一章)。
五、omc-teams CLI 工作者:让 tmux 跑起来真实的 AI 进程
这是 OMC 最酷的功能之一,很多人不知道。
/omc-teams 命令可以在 tmux 的分屏里,启动真实的 CLI 进程——不仅是 Claude,还可以是 Codex 和 Gemini。
什么意思?
打开终端,你可以看到屏幕被分成三格:
左边:Claude 正在实现支付流程 右上:Codex 正在做认证模块的安全审查 右下:Gemini 正在优化 UI 组件的可访问性
三个 AI 进程,真正并行执行,互不干扰。
使用方式
/omc-teams 2:codex "审查认证模块的安全漏洞"
/omc-teams 2:gemini "重新设计 UI 组件的可访问性"
/omc-teams 1:claude "实现支付流程"
语法格式是 数量:模型 "任务描述"。
跨模型混合工作:/ccg 命令
如果你想在一条命令里同时调用 Codex 和 Gemini,用 /ccg:
/ccg 审查这个 PR —— 架构部分用 Codex,UI 组件用 Gemini
OMC 会自动分配任务,由 Claude 综合两者的结果。
关键特性
工作者按需生成,任务完成即销毁,不会占用闲置资源。这意味着你不用担心一堆后台进程偷偷吃掉系统资源。
前提条件:需要安装 codex / gemini CLI,以及一个活跃的 tmux 会话。
六、执行模式大全:不同场景,选择不同武器
OMC 提供了多种执行模式,适配不同类型的任务。别被这些名字搞晕,我来帮你把每个模式的适用场景说清楚。
🚀 Autopilot 模式(自动驾驶)
适用场景:需求明确,可以端到端完成,不需要太多人工干预。
这个模式下,一个 Lead Agent 全权负责,从设计到实现,自主完成整个任务,无需流水线协作。
触发方式:
autopilot: 帮我做一个任务管理 REST API
或者:
ap 为所有测试文件添加类型注解
⚡ Ultrawork 模式(极速工作)
适用场景:大规模、重复性的任务,比如清理 8000 条 ESLint 警告、批量添加类型注解。
Ultrawork 的核心是并行执行,把大任务拆成多个并行子任务,3-5 倍速度提升。
触发方式:
ulw 重构项目里所有的 API 调用,统一使用 axios
🔄 Ralph 模式(死磕模式)
适用场景:必须 100% 完成、不能有任何「部分完成」的任务。
Ralph 模式 = Ultrawork 的并行能力 + 验证/修复循环。执行路径是:
执行 → 验证 → 修复 → 验证(直到通过)
如果你发现 Claude 经常「看起来做完了但其实没验证」,Ralph 是解决方案。
触发方式:
ralph: 重构认证模块,确保所有测试通过
🏗️ Ultrapilot 模式(旗舰模式)
适用场景:最复杂的任务,3-5 个智能体并行,完整的规划→执行→验证流水线。
这是性能最强但 Token 消耗也最高的模式,适合大型功能开发。
🌊 Swarm 模式(已升级)
注意:从 v4.1.7 开始,Swarm 模式已被 Team 模式取代,Swarm 关键词现在会在内部路由到 Team 模式。保留这个名字只是为了向后兼容。
💡 Ecomode 模式(省钱模式)
适用场景:Token 预算有限,但任务本身不需要太强的推理能力。
OMC 会自动用更便宜的 Haiku 处理简单任务,用 Opus 处理复杂推理,实现 30-50% 的 Token 节省。
七、32 个专业智能体:你的 AI 开发团队花名册
这是 OMC 最让人震撼的地方——32 个专业化的智能体,覆盖软件开发的完整链路。
别担心,你不需要手动管理这些智能体。OMC 会根据任务自动委派给最合适的智能体。但了解他们的存在,会让你更好地利用这套系统。
这些智能体大致分为以下几个领域:
架构与规划类
Architect(架构师):负责技术架构设计和大局决策 Planner(规划师):任务拆解和工作流设计 Designer(设计师):系统设计和模块边界定义
工程实现类
Backend Engineer(后端工程师):API、数据库、服务端逻辑 Frontend Engineer(前端工程师):UI 组件、交互逻辑 Data Engineer(数据工程师):数据管道、ETL 流程 DevOps Engineer(运维工程师):CI/CD、容器化、部署
质量保障类
QA Engineer(测试工程师):测试策略、自动化测试 Security Reviewer(安全审查员):代码安全漏洞检查 Code Reviewer(代码审查员):代码质量和最佳实践
研究与分析类
Researcher(研究员):技术调研和方案评估 Analyst(分析师):需求分析和业务逻辑梳理 Oracle(知识顾问):领域知识查询
写作与文档类
Writer(技术写作者):文档、注释、README PRD Writer(需求文档编写):专门负责生成 PRD
还有更多专注于特定技术栈的智能体,比如 React 专家、Python 专家、Rust 专家等。
每个智能体都有对应的模型层级路由:简单任务用 Haiku,复杂推理用 Opus,平衡任务用 Sonnet。这套自动路由系统让你在享受高质量输出的同时,不会把钱烧在不必要的高级模型上。
八、魔法关键词:你真正需要记住的就这几个
这是 OMC 最贴心的设计之一。
你不需要记住复杂的命令语法。只要在你的自然语言请求里,加入这些魔法关键词,OMC 就会自动触发对应的执行模式:
ralph | ralph: 重构认证系统,确保所有测试通过 | |
ulw | ulw 清理所有 TypeScript 类型错误 | |
apautopilot | ap 实现用户注册和登录功能 | |
ralplan | ralplan 设计并实现新的缓存系统 |
关于 Team 模式:Team 模式需要显式调用 /team 命令,没有对应的自然语言魔法词。这是故意设计的——Team 模式消耗资源最多,需要你明确决策。
实际使用示例
你可以非常自然地在句子里使用这些关键词:
ralph, 把这个项目的 auth 模块整个重构一遍,我要所有单元测试都跑绿
ulw 把所有 console.log 清理掉,顺便加上 proper 的 logging
ap 帮我写一个爬取 Hacker News 首页的脚本,存到 SQLite 里
就这么简单。 不需要记忆复杂的斜杠命令,不需要理解底层机制,用你最习惯的方式说话就行。
九、自定义技能:把你的最佳实践沉淀下来
这个功能决定了 OMC 对团队的长期价值。
什么是技能(Skills)?
OMC 的技能系统允许你把项目特定的模式和最佳实践,以 Markdown 文件的形式保存下来,让所有智能体在工作时自动参考。
技能文件存放在 .omc/skills/ 目录下。
一个实际例子
假设你的团队有统一的 API 设计规范——所有接口都必须返回标准的 { code, message, data } 结构,错误处理必须使用统一的 ErrorClass。
你可以创建一个技能文件 .omc/skills/api-conventions.md:
# API 设计规范
所有 REST API 接口必须遵循以下约定:
## 响应格式
所有接口统一返回以下结构:
{ "code": 0, "message": "success", "data": {} }
## 错误处理
使用 AppError 类统一处理异常...
之后,当 OMC 的智能体实现任何 API 时,都会自动遵循这个规范。
技能的三个层级
OMC 的技能系统有三个层级,优先级从高到低:
项目级( .omc/skills/):仅对当前项目生效用户级( ~/.claude/skills/):对你的所有项目生效OMC 内置级:OMC 自带的通用最佳实践
技能学习:让 AI 从你的工作中自动提取规律
OMC 还有一个更厉害的功能——自动技能提取。
在一个 Team 模式的工作流完成后,你可以让 OMC 自动分析这次任务里解决了哪些有价值的模式,并提取成可复用的技能。
这意味着随着使用时间的增加,OMC 会越来越了解你的项目和你的工作风格,越来越「顺手」。
十、HUD 状态栏:实时看清你的 AI 团队在干什么
这是一个让很多用户感到「爽感」的功能。
HUD(Heads-Up Display)状态栏会实时显示你的 AI 团队的工作状态:
当前活跃的智能体是谁 任务进行到哪个阶段了 已消耗的 Token 数量 各工作者的状态
当你使用 omc-teams 命令,在 tmux 里跑多个并行进程时,你可以在分屏里直观地看到每个工作者的进展。这种「指挥中心」式的视觉体验,和传统的单线程 AI 对话完全不同。
查看 HUD 状态
在终端里运行:
omc hud
查看特定团队状态
omc team status <team-name>
配套的监控功能
OMC 还提供了完整的性能监控工具:
# 查看 Agent 回放日志
tail -20 .omc/state/agent-replay-*.jsonl
# 查看会话状态文件
ls .omc/sessions/*.json
此外,OMC 还支持通过 Telegram 和 Discord 发送任务通知。当一个长时间运行的任务完成时,你会直接收到消息推送,不用守在电脑前盯着。
十一、三层记忆系统:解决 AI「长会话失忆」问题
这是一个很多人没注意到但极其重要的设计。
长时间使用 AI 编程工具的人都遇到过这个痛点:会话越来越长,AI 开始忘事了。它可能忘记你早期做的架构决策,或者开始重复造轮子。
OMC 用三层记忆系统来解决这个问题:
第一层:Priority Memory(优先记忆)
类似于 CLAUDE.md 的作用,但由 OMC 自动维护,并且跨智能体共享。你不需要手动管理,OMC 会自动把最重要的上下文放在这里。
第二层:Working Memory(工作记忆)
在 Team 模式每完成一个阶段后,自动更新。下一个阶段的智能体进来时,会自动读取这份工作记忆,知道前面的阶段做了哪些决策。
这就解决了一个常见问题:规划阶段决定「用 PostgreSQL」,但执行阶段的智能体又开始问「用什么数据库?」
第三层:Skill Memory(技能记忆)
就是上一章讲的自定义技能系统,把跨项目的最佳实践持久化保存下来。
三层记忆协同工作,让 OMC 在处理超长任务时依然能保持上下文一致性。
十二、速率限制自动恢复:让 AI 不眠不休地工作
Claude Code 有 API 速率限制。遇到限制时,你要么等,要么手动重启会话。
OMC 把这个问题也解决了。
omc wait 命令会监控速率限制状态,并在限制解除后自动恢复会话:
omc wait# 查看当前状态和恢复指引
omc wait --start # 启动自动恢复守护进程
omc wait --stop # 停止守护进程
启动守护进程后,你可以放心离开电脑。速率限制解除后,OMC 会自动继续工作,并通过你配置的 Telegram/Discord 通知你。
这让超长任务(比如大型代码库重构)的执行变得可行——你甚至可以让它跑一整夜。
十三、Deep Interview 模式:先想清楚,再动手
这是一个反直觉但非常有价值的功能。
大部分人用 AI 工具的方式是:有了想法 → 立刻让 AI 执行。
但这往往导致一个问题:执行到一半发现需求没想清楚,推翻重来,浪费了大量 Token 和时间。
Deep Interview 模式解决这个问题。当你的需求还不够清晰时,运行:
/deep-interview "我想做一个任务管理应用"
OMC 会用苏格拉底式的追问,帮你厘清:
目标用户是谁? 技术栈偏好是什么? 有哪些隐藏的假设和约束? 各种功能的优先级排序?
它会跨多个维度评估你的需求清晰度,并生成一份完整的需求文档,然后才开始执行。
对于复杂项目,这个「先问清楚再动手」的环节,能节省大量返工成本。
十四、ccg 三模型咨询:关键决策,让三个 AI 投票
这是 OMC 里一个非常有意思的功能。
对于重要的技术决策(比如「选 Redis 还是 Memcached?」、「这个架构设计有什么潜在风险?」),你可以用 /ccg 命令,同时咨询 Claude、Codex 和 Gemini 三个模型,然后由 Claude 综合三者的观点给出最终建议:
/ccg 我们的支付系统应该用微服务还是单体架构?请从不同角度分析
这是一种「通过共识降低决策错误率」的机制。单个 AI 的观点可能有偏见,三个不同架构的模型同时给出意见,再综合对比,得到的结论往往更全面、更可靠。
十五、完整命令速查表
这里是 OMC 最常用命令的完整清单,建议截图保存:
安装与配置
# 安装(在 Claude Code 里逐行输入)
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
# 初始化
/omc-setup
# npm 安装(终端)
npm i -g oh-my-claude-sisyphus@latest
# 更新
/plugin marketplace update omc
/omc-setup
执行模式
# Team 模式(推荐用于复杂任务)
/team 实现用户认证系统
# Autopilot
ap 做一个文件上传功能
/autopilot "构建 REST API"
# Ultrawork
ulw 清理所有 TypeScript 错误
# Ralph
ralph: 重构认证模块,直到所有测试通过
# 深度访谈(需求不清楚时用)
/deep-interview "我想做一个电商平台"
tmux 工作者
# 在 tmux 分屏里启动 CLI 工作者
/omc-teams 2:codex "安全审查"
/omc-teams 2:gemini "UI 优化"
/omc-teams 1:claude "实现核心功能"
# 三模型混合咨询
/ccg 评估这个架构设计的优劣
# 查看团队状态
omc team status <team-name>
监控与调试
# HUD 状态栏
omc hud
# 速率限制自动恢复
omc wait
omc wait --start
omc wait --stop
十六、什么时候用 OMC,什么时候不用
诚实地说,OMC 不是银弹,它也有适合和不适合的场景。
强烈推荐使用 OMC 的场景
多模块任务:同时需要修改前端、后端、测试代码 长时间会话:超过 2 小时、上下文容易丢失的任务 规划密集型工作:大型架构变更、全面重构 模拟团队工作流:你一个人,但需要「架构师→开发者→审查员」的完整流程 Token 敏感任务:需要优化成本,靠智能路由省钱
不适合用 OMC(直接用原版 Claude Code 更合适)
简单任务:改一个函数、修一个 bug,Team 模式流水线完全是杀鸡用牛刀 一次性小脚本:写个快速工具脚本,autopilot 就够了,甚至不需要 OMC
十七、费用参考:用多少钱能玩转这套系统?
很多人担心多智能体会烧很多钱。这里给一个参考数据。
根据 OMC 官方文档:
仅使用 Claude:Claude Max 订阅(约 $100/月)即可使用全部 OMC 功能 Claude + Codex + Gemini 三模型全开:三个 Pro 订阅(Claude + Gemini + ChatGPT),约 $60/月 覆盖全部需求
OMC 的智能路由系统会自动把简单任务路由给便宜的 Haiku,复杂任务才用 Opus,实测可以节省 30-50% 的 Token 消耗。
对于重度使用 AI 编程工具的开发者来说,这个成本远低于订阅多个专业工具(比如 Cursor Pro + GitHub Copilot Enterprise)。
结语:我们正在进入「AI 原生」开发时代
写到这里,我想说说我对这件事更深层的看法。
oh-my-claudecode 的出现,不只是「一个好用的插件」这么简单。它代表的是一种开发范式的转变。
过去,「程序员」这个职业的核心价值是:你懂代码,你能写代码。
现在,这个价值正在被重新定义:你懂系统,你能指挥一支 AI 团队把系统做出来。
就像管理学上的一个经典比喻:最优秀的建筑师,不是那个砌砖最快的人,而是那个最清楚地知道整栋楼应该长什么样的人。
OMC 做的事,就是让「砌砖」变得极其高效——而你只需要专注于「这栋楼应该长什么样」。
这不是威胁,这是机遇。
那些能用好这些工具的工程师,生产力将是传统方式的 5-10 倍。而那些拒绝拥抱这些工具的人,可能会在下一轮技术迭代里被远远甩开。
现在装上 OMC,今天就开始。30 秒安装,立即上手。
参考资源
GitHub 主仓库: https://github.com/Yeachan-Heo/oh-my-claudecode官方文档: https://omc.vibetip.help/docsnpm 包(CLI 工具): oh-my-claude-sisyphusoh-my-opencode(OpenCode 版): https://github.com/opensoft/oh-my-opencodeClaude 官方 Agent Teams 文档: https://code.claude.com/docs/en/agent-teams
觉得有用?转发给你的开发者朋友,一起提效。
有问题或者想聊更多 AI 开发工具的使用技巧?欢迎留言,我会认真回复每一条。
本文基于 oh-my-claudecode v4.x 版本,部分细节可能随版本更新而变化,请以 GitHub 仓库最新文档为准。
夜雨聆风