oh-my-claudecode 是什么?

oh-my-claudecode(OMC)是 Claude Code 的第三方多代理编排插件与 npm CLI。它提供 autopilot、team、ralph、ultrawork、deep-interview 等工作流,也能通过 tmux 启动 Claude、Codex、Gemini 或 Cursor worker。它不包含模型额度;每个 worker 仍消耗对应服务的订阅或 API 用量。

⭐ 37,053 Stars 🍴 3,345 Forks TypeScript — 作者: Yeachan-Heo
来源:github.com/Yeachan-Heo/oh-my-claudecode;https://github.com/Yeachan-He… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

官方于 2026-09-11 发布 v5.4.0,加入 autonomous run 启动前危险扫描、agent 文档纪律、外部 issue/PR intake gate,并修复 provider 启动和清理。

来源:github.com/Yeachan-Heo/oh-my-claudecode/releases/tag/v5.4.0;https://w…

核心功能

预设编排模式

autopilot 负责端到端推进,team 将规划、执行、验证分给多个 worker,ralph 与 ultrawork 面向持续或并行任务,deep-interview 用于在动手前澄清约束。

来源:github.com/Yeachan-Heo/oh-my-claudecode/blob/main/README.md;https://g…
插件与 CLI 两条安装轨道

Claude Code marketplace 提供会话内 skills/agents/hooks;npm 包 oh-my-claude-sisyphus 提供 omc runtime。部分功能只装插件还不够,两条轨道需分别更新。

来源:github.com/Yeachan-Heo/oh-my-claudecode/releases/tag/v5.4.0;https://w…
外部 CLI worker

omc team 可用 tmux 启动 Claude、Codex、Gemini 与 Cursor worker;前提是相应 CLI 已安装并完成认证,模型、权限和费用仍归各 provider 管理。

来源:github.com/Yeachan-Heo/oh-my-claudecode/blob/main/README.md
状态、监控与通知

CLI 维护本地团队状态和 HUD,可等待限流、读取 provider 使用情况并接通知;v5.4.0 的危险扫描属于 advisory gate,不能替代宿主权限和人工复核。

来源:github.com/Yeachan-Heo/oh-my-claudecode/releases/tag/v5.4.0;https://g…

技术架构

Claude Code plugin 加载 skills、agents、commands 与 hooks;omc CLI 负责 setup、状态、tmux worker 和本地 better-sqlite3 数据。会话内 /team 可调用 Claude Code 实验性 agent teams,CLI team 则启动独立 provider 进程。leader 分派任务,worker 在同一仓库或可选 worktree 中读写,状态与结果回到编排层。多入口共享配置但不是同一个安装包,因此版本不一致会产生难查问题。

来源:github.com/Yeachan-Heo/oh-my-claudecode/blob/main/README.md;https://g…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Claude Code 为主要宿主;插件安装与 npm CLI 是独立轨道Claude Code 为… CLI team 需要 tmux 及对应 claude/codex/gemini/cursor-agent 可执行文件CLI team 需要… 每个 provider 要单独认证,worker 会产生额外 token、订阅或 API 用量每个 provider… 预设编排模式 插件与 CLI 两条安装轨道插件与 CLI 两条安装轨… 外部 CLI worker 状态、监控与通知 oh-my-claudecode 项目本体 核心功能 关键依赖

技术栈

语言TypeScript/Node.js CLI、Claude Code plugin、Markdown skills 与 hooks框架npm runtime、tmux external workers、better-sqlite3 本地状态、Claude Code agent teams
Claude Code 为主要宿主;插件安装与 npm CLI 是独立轨道CLI team 需要 tmux 及对应 claude/codex/ge…每个 provider 要单独认证,worker 会产生额外 token…
本地进程、tmux、Git/worktree 与 provider 网络连接;MIT 许可;没有项目方 credits 或付费解锁
来源:github.com/Yeachan-Heo/oh-my-claudecode/blob/main/package.json;https:…

快速上手

固定 v5.4.0,不用 @latest。先在一次性 Claude Code 配置与干净测试仓库安装 marketplace plugin,执行 /omc-setup 和 /omc-doctor;只有明确需要 CLI-backed team/ask 时再安装同版本 npm 包。先用 deep-interview 或单 worker 做只读任务,再用两个 worker 修改互不重叠的文件。不要启用跳过权限,也不要把 advisory danger scan 当作执行沙箱。
来源:github.com/Yeachan-Heo/oh-my-claudecode/releases/tag/v5.4.0;https://w…

使用场景

适合已经稳定使用 Claude Code、需要固定规划/执行/验证流程,或需要多个 CLI worker 并行处理独立子任务的人。简单单文件修改、上下文强耦合任务和预算严格场景通常不需要多代理;官方 Claude Code 原生 agent teams 已能覆盖基础协作,安装 OMC 前应先确认额外流程是否值得增加 hooks 和配置复杂度。

来源:github.com/Yeachan-Heo/oh-my-claudecode/blob/main/README.md;https://c…

优势与局限

优势

  • 把需求澄清、规划、执行、验证和修复组织成可重复工作流
  • 既能使用 Claude Code 会话内 teams,也能通过 tmux 接多家 CLI worker
  • 提供 doctor、HUD、限流等待、通知和本地状态等配套工具
  • v5.4.0 增加危险预检与文档 review gate,并修复 worker 生命周期问题

局限

  • 插件可加载 hooks、skills 与 agents,npm CLI 还能启动子进程;安装前要审阅权限和自动触发条件
  • 危险预检是 advisory,不能保证阻止 destructive 命令、越权网络请求或错误修改
  • 多 worker 各自使用上下文和模型额度,Anthropic 官方也说明 agent teams 的 token 成本通常高于 subagent
  • marketplace plugin 与 npm runtime 分开发布和更新,版本错位可能导致技能、配置和 CLI 行为不一致
  • native team worktree 仍在 opt-in/config gate 后,默认同仓并行时要避免多个 worker 修改同一文件
  • 项目依赖 Claude Code 及外部 provider,但本身没有订阅、充值、credits 或账号转售漏斗
来源:github.com/Yeachan-Heo/oh-my-claudecode/releases/tag/v5.4.0;https://g…

最新版本

最新稳定版是 v5.4.0,GitHub 于 2026-09-11 发布。该版新增 advisory danger scan、agent-doc-discipline、harbor intake gate 和可配置的 SessionStart context budget,并修复 provider launch、cleanup 与 worktree 探测。

来源:github.com/Yeachan-Heo/oh-my-claudecode/releases/tag/v5.4.0;https://w…

实测与证据

status: docs_and_source_checked_not_executed  |  checked_at: 2026-09-23  |  environment: 核对官方 GitHub README、v5.4.0 release、REFERENCE、package、MIT LICENSE、npm 版本页与 Anthropic 官方 agent teams/权限资料;未安装插件或 npm 包。  |  limitations: 没有验证 setup、doctor、hooks、SQLite 状态、tmux、worktree、provider 登录、危险预检、通知、并行冲突、token 用量或卸载清理。  |  observed_output: GitHub 与 npm 都把 5.4.0 标为当前稳定版本;release 明确说明插件和 CLI 是独立安装轨道。npm 包名仍为 oh-my-claude-sisyphus,并暴露 omc 与 oh-my-claudecode 命令。

来源:github.com/Yeachan-Heo/oh-my-claudecode/releases/tag/v5.4.0;https://w…

同类项目对比

相比 Claude Code 原生 agent teams,OMC 增加 autopilot、ralph、ultrawork、deep-interview、tmux 外部 provider worker、HUD 与通知;原生 teams 由 Claude Code 自身维护,配置面更小,也避免再安装第三方 hooks/runtime。只需几个 Claude teammate 共享任务时先用原生 teams;需要固定多阶段流程或跨 CLI worker 时再评估 OMC。

来源:github.com/Yeachan-Heo/oh-my-claudecode/blob/main/README.md;https://c…

总结评价

oh-my-claudecode 可保留。它没有项目方付费漏斗,热度来自开源仓库与 npm,但本站尚无搜索记录。推荐固定 v5.4.0,在临时 Claude 配置和测试仓库只装 plugin,先做只读单 worker 验证;确实需要跨 CLI team 时再加同版本 runtime,并明确 worker 数、预算、文件归属与停止条件。

来源:github.com/Yeachan-Heo/oh-my-claudecode/releases/tag/v5.4.0;https://g…

常见问题

只安装 Claude Code 插件够不够?

会话内 skills 和 agents 可以从 marketplace plugin 获得,但 ask、CLI-backed team 等路径还需要 npm 包提供的 omc runtime。两条轨道独立更新,使用哪条就固定并核对哪条版本。

OMC 会降低 Claude Code 的模型费用吗?

不会自动降低。每个 Claude、Codex、Gemini 或 Cursor worker 都会使用自己的上下文与额度,多代理通常增加总 token。先限制 worker 数、任务范围和停止条件,再比较完成一次任务的总费用。

v5.4.0 的 danger scan 能保证安全吗?

不能。官方 release 把它写成 advisory pre-flight scan;它是提醒层,不是沙箱。宿主权限、Git 隔离、命令确认、密钥范围和人工 diff 仍然必须保留。

team 模式会自动隔离每个 worker 的文件吗?

不能默认这样理解。native team worktree 仍在 opt-in/config gate 后,其他路径可能共享同一工作树。首次并行任务应分配互不重叠的文件,并在提交前检查 git status 和 diff。

OMC 与 Claude Code 原生 agent teams 怎么选?

只需 Claude teammate 共享任务与通信时,先用原生 teams;需要 OMC 的多阶段工作流、外部 CLI worker、HUD 或通知时再加插件。这样更容易判断是哪一层造成配置、费用或冲突问题。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件