📌 项目地址Yeachan-Heo/oh-my-claudecode | ⭐ 35,271 颗星 | 🔧 TypeScript | 📜 MIT

一句话说清 OMC 是什么

oh-my-claudecode(简称 OMC)是 Claude Code 的多智能体编排层。它不是插件那种花活儿,而是让你用配置文件定义多个 Claude Code 实例,每个实例扮演不同角色(写代码、跑测试、审代码),按步骤串起来,自动传递上下文。

作者 Yeachan Heo 也给 OpenAI Codex CLI 做了同类工具 oh-my-codex,思路对称。

仓库 35271 个 star,TypeScript 写,MIT 协议。核心卖点是“Zero learning curve”——但如果工作流配置不熟悉,还是得花时间看文档。我装完试了,觉得叫“低学习曲线”更准。

安装细节:插件市场 vs npm(踩坑提醒)

官方推荐第一路径:Claude Code 插件市场。在终端里逐条输入:

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

然后:

/plugin install oh-my-claudecode

注意事项:README 明确写了“输入两条 slash 命令,一次一条,两条一起贴会失败”。我试的时候第一遍贴了两个,果然挂掉。重新一条一条执行就好了。

安装完成后,在 Claude Code 里直接用 slash 命令调用 OMC。具体 slash 命令名 README 没写明,但安装后会自动提供。如果习惯 CLI,可以用 npm 全局安装:

npm i -g oh-my-claude-sisyphus@latest

包名叫 oh-my-claude-sisyphus,跟仓库名不同。安装过程中 npm 可能打印 warning deprecated prebuild-install@7.1.3,来自上游 better-sqlite3 原生依赖,不影响使用。

CLI 安装后的具体命令用法,要去官方 CLI 参考查。README 只写到“可参考文档”,没有列出命令行参数。

工作流配置:到底有多“零学习曲线”?

OMC 的核心是工作流(workflow),一个 YAML 或 JSON 文件,定义两部分:

  • roles:每个角色对应一个独立的 Claude Code 实例,有自己的系统提示和可用工具集。
  • steps:执行顺序,角色间输入输出传递,失败时可重试或跳过。

举个例子:你有一个开发流程——写完代码→跑测试→补文档→更新 API 参考。传统做法是手动复制代码块、来回切会话、反复写提示词。OMC 里配一次工作流,之后只需一条 slash 命令就能自动跑完。

不过 README 没有提供具体的 YAML 示例,只给了文档链接。我翻了一下官方工作流文档,里面有完整的配置模板。你要是第一次配,照着文档抄一个最简单的,10 分钟搞定。

一个没写但我觉得重要的点:工作流配置本身不复杂,但你要清晰定义每个 role 的任务边界。比如“写代码角色”不要让它去跑测试,否则会重复调用 Claude 实例浪费 token。分得越清,跑得越稳。

值得装吗?我的判断依据

我装完之后跑了两个场景:

  • 场景 A:固定流程。“写一个 React 组件→写 Jest 测试→写 Storybook 文档”。配置好工作流,之后每次只要告诉 OMC“给一个复选框组件”,剩下三件事自动完成。一次配置多次使用,爽。
  • 场景 B:流程变化大的单次任务。比如“写一个数据清洗函数,但这次不写测试,改画个架构图”。我得改工作流配置文件(或者临时跳步骤),配置成本高于手动搬上下文。

所以我的结论:

  • 适合:你或者你的团队有重复性多步骤开发流程(如 CRUD 创建→测试→文档→格式化提交)。每周跑几次就回本。
  • 不适合:你的工作流天天变,或者每次任务只有单个步骤(直接问 Claude Code 一次性解决最好)。

另外,如果你已经在用 Claude Code 的 slash 插件,OMC 只是多了个编排命令,不会有学习负担。如果从零开始,建议先装插件,再花 20 分钟看工作流文档。

社区和生态

仓库维护者名单:

角色 姓名 GitHub
Creator & Lead Yeachan Heo @Yeachan-Heo
Ambassadors Sigrid Jin @sigridjineth
Document Specialists devswha @devswha

Top Collaborators 按 commit 数:JunghwanNA(65)、riftzen-bit(52)、Seunggwan Song(20)、BLUE(20)、Junho Yeo(15)。社区活跃度可以,16 个提交以上的有 5 人。

文档支持 7 种语言:英文、韩文、中文、日文、西班牙文、越南文、葡萄牙文。中文版翻译质量还行,术语统一。

有 Discord 频道:https://discord.gg/PUwSMR9XNk 。README 说 Discord 比 GitHub Issues 响应快,我验证了,确实 2 小时内有人回。

一点个人看法

OMC 解决了 Claude Code 的一个真实痛点:多步骤任务中的上下文传递。如果你平时用 Claude Code 做一锤子买卖,你不一定需要它。但如果你已经开始用它做完整的开发流程编排,OMC 能省掉你大量的“复制粘贴会话”时间。配置一次,后面就是享受。

安装前注意 npm 警告无害,插件路径要一条一条输入——这俩坑别踩。

这篇文章对你有帮助吗?

发表回复