首页 / 开源热榜 / oh-my-claudecode / 使用教程

oh-my-claudecode 教程：先分清插件和 CLI

核对日期：2026-09-23 · 已读官方 release、README、REFERENCE 与 npm 页面，未安装或执行插件

oh-my-claudecode（OMC）给 Claude Code 增加 autopilot、team、ralph、ultrawork、deep-interview 等编排工作流，也能用 tmux 拉起 Claude、Codex、Gemini 或 Cursor worker。它不会赠送模型额度，也不会让多代理自动变便宜；每个 worker 都使用自己的上下文、认证和费用。

当前版本：v5.4.0 于 2026-09-11 发布。GitHub release 与 npm 的 latest 都是 5.4.0；不要在教程或生产配置中直接写 @latest。

1. 两条安装轨道不是二选一替代品

Claude Code marketplace plugin 提供会话内 skills、agents、commands 和 hooks；npm 包 oh-my-claude-sisyphus 提供 omc runtime。ask、CLI-backed team 等功能要用 npm CLI。官方 v5.4.0 release 明确要求分别更新你实际使用的轨道。

第一次只安装 plugin，先看内容和写入范围：

# 在 Claude Code 中逐条执行
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
/omc-setup
/omc-doctor

确认确实需要 CLI team 后，再安装同一个固定版本：

npm install -g oh-my-claude-sisyphus@5.4.0
omc --version
omc setup

验证边界：本站没有执行安装命令、hooks 或 team。上面是官方 v5.4.0 路径；安装前应在临时 Claude 配置中审阅 plugin 的 agents、skills、commands 与 hooks。

2. 先用只读任务检查行为

不要用 autopilot 作为第一次测试。先建一个无密钥、无未提交改动的小仓库，让 deep-interview 或单 worker 只读 README，并要求列出准备调用的工具。检查 git status、OMC 本地状态、Claude Code 权限提示和 provider 用量。

mkdir -p /tmp/omc-smoke && cd /tmp/omc-smoke
git init
printf 'test\n' > README.md
git add README.md && git commit -m init

通过只读测试后，再让一个 worker 修改一个文件并运行一条安全测试。这样能区分 Claude Code 本身、OMC hook、npm runtime 和模型的行为。

3. Team Mode 有两种运行方式

会话内 /team 使用 Claude Code 的实验性 agent teams；CLI 的 omc team 可以通过 tmux 启动外部 CLI worker。后者要求相应的 claude、codex、gemini 或 cursor-agent 已安装并登录。不同 provider 的权限、模型和费用不会因为经过 OMC 而统一。

首次 team 只开两个 worker，并把文件边界写清楚，例如一个只改测试、一个只改文档。native team worktree 仍在 opt-in/config gate 后，不能默认每个 worker 已经隔离。最终由 leader 检查 git status、完整 diff 和测试结果。

4. v5.4.0 的危险扫描只是提醒

新版本加入 autonomous run 的 pre-flight danger scan，但官方 release 明确写作 advisory。它能提前提示风险，不是操作系统沙箱，也不能保证拦住错误删除、密钥读取或不合适的网络请求。保留 Claude Code 权限确认，使用最小凭据，不启用 --dangerously-skip-permissions。

5. 多代理费用要按完整任务算

Anthropic 官方文档说明，agent teams 中每个 teammate 都是独立 Claude 实例，token 成本通常高于只返回摘要的 subagent。外部 Codex、Gemini 或 Cursor worker 也有自己的计费。比较时记录 worker 数、每个 provider、输入输出 token、重试次数和最终是否一次通过；只看墙钟时间会掩盖总费用。

6. 并行冲突和退出条件要提前写

多人同时修改同一文件会产生覆盖、反复重读和无效测试。给每个 worker 一个文件集合和验收命令，并规定失败几次后停止。autopilot、ralph 或 ultrawork 适合边界清楚的长任务；简单单文件修改直接用一个 Claude Code 会话更容易控制。

7. 更新和排错

marketplace 更新后要再次执行 setup 刷新配置；npm CLI 用固定版本升级。若两条轨道都装了，先核对它们是否同版，再用 /omc-doctor 检查旧缓存。不要为了消除 npm 的 prebuild-install@7.1.3 deprecation warning 随意 override，官方说明它来自 better-sqlite3 的上游依赖，并不代表安装失败。

8. 同类对比：OMC 与 Claude Code 原生 Agent Teams

相比 Claude Code 原生 agent teams，OMC 增加多阶段预设工作流、tmux 外部 provider worker、HUD、限流等待和通知；原生 teams 由宿主直接维护，配置面更小，也不用增加第三方 hooks/runtime。只需几个 Claude teammate 共享任务时先用原生功能；需要跨 CLI 或固定流程时再增加 OMC。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

近期变化与关注原因

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

适合谁用

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

采用建议

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

原教程未展开的系统信息

核心功能

预设编排模式
autopilot 负责端到端推进，team 将规划、执行、验证分给多个 worker，ralph 与 ultrawork 面向持续或并行任务，deep-interview 用于在动手前澄清约束。
状态、监控与通知
CLI 维护本地团队状态和 HUD，可等待限流、读取 provider 使用情况并接通知；v5.4.0 的危险扫描属于 advisory gate，不能替代宿主权限和人工复核。

架构与数据流

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 中读写，状态与结果回到编排层。多入口共享配置但不是同一个安装包，因此版本不一致会产生难查问题。

常见问题

只安装 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 或通知时再加插件。这样更容易判断是哪一层造成配置、费用或冲突问题。