多智能体编排 · session · 验证于 2026-08-28 ✓ 实测验证

oh-my-claudecode

已验证 2026-08-27插件安装与编排冒烟实测通过；团队优先多 Agent 编排（Claude Code 生态）。

团队优先的多 Agent 编排工具（Claude Code 插件形态）：角色分工、并行任务，适合团队共享 Claude Code 工作流

详细版 → 所属问题域：多智能体编排 遇到问题？去问题空间 →

你会遇到什么

你在 Claude Code 里做多 Agent 协作：一个目标要拆计划、要自动执行、要拉几个 Agent 分头干活——手写提示词又乱又累。omc（oh-my-claudecode）就是在 Claude Code 之上加的一层编排：/plan 出执行计划、/autopilot 自动执行目标、/team 团队编排。它有两条安装路径：npm CLI（方式 B，本环境实测）和 Claude Code 插件（方式 A，官方推荐但需要登录环境，本环境未实测）——先分清你要哪条，别装错形态。 什么时候用：

  • 你在 Claude Code 会话里要 plan/autopilot/team 这类编排能力；
  • 你要 CLI 管理面（launch/interop/ask/config）；
  • 你要团队协作式的多 Agent 工作流。

什么时候别用：单会话单任务、不需要编排层时；或你的环境不是 Claude Code 系（会话内技能依赖方式 A 插件）。 和相邻工具的边界：与 agt/deepcode CLI 形态实测可共存（实测记录（本地留存））；Claude 插件形态与 ruflo 共享 .claude/ 注册面（未实测，判定 possible-conflict）。

本文路径：快速修复（30 秒一段命令）→ 一步步来（可跳读）→ 怎么确认修好了（成功判据）。赶时间直接跳到「快速修复」。

为什么会这样

两种形态，机制不同：

  • 方式 B（npm CLI）：全局命令 omc（本环境实测），命令面 launch / interop / ask / config——纯命令行管理；
  • 方式 A（Claude Code 插件）：官方推荐，/plugin install 后获得 /plan、/autopilot、/team 会话内技能——编排能力在会话里，靠 Claude Code 插件注册面（~/.claude.json 等）挂载。

关键概念：

  • /plan：目标 → 执行计划；
  • /autopilot：目标 → 自动执行；
  • /team：团队编排模式。

装完它动哪里：方式 B 写 npm 全局目录；方式 A 写 Claude Code 插件注册面（~/.claude.json 等）。

快速修复（不想看讲解，直接跑）

note: 方式 B npm CLI（本环境实测）；国内必须带 npmmirror 镜像
npm i -g oh-my-claude-sisyphus@5.1.0 --no-audit --no-fund --registry=https://registry.npmmirror.com
omc --version

预期输出: 5.1.0

一步步来

第 1 步：装 CLI（方式 B）

讲解：npm 全局安装 oh-my-claude-sisyphus（命令名 omc）。国内 npm 官方源直连超时，实测命令带 npmmirror 镜像；海外直连环境去掉 registry 参数即可。

npm i -g oh-my-claude-sisyphus@5.1.0 --no-audit --no-fund --registry=https://registry.npmmirror.com
omc --version

预期输出: 5.1.0

海外/可直连网络分支：

npm i -g oh-my-claude-sisyphus@5.1.0 --no-audit --no-fund
omc --version

预期输出: 5.1.0

装好确认：

  • omc --version 输出 5.1.0；
  • omc --help 有 launch/interop/ask/config 命令。

卡住怎么办：

  • npm 慢/超时 → 确认命令带 --registry=https://registry.npmmirror.com；
  • node 版本 → 确认 >= 20；
  • 命令找不到 → 检查 npm 全局 bin 在 PATH。

第 2 步：看配置（CLI 面）

讲解：omc config 查看当前配置（JSON 或初始化引导提示）。CLI 面先跑通，会话内技能（方式 A）按需再装。

omc config

预期输出: 当前配置内容（JSON 或初始化引导提示）

装好确认：

  • 有配置输出或初始化引导，无报错。

卡住怎么办：

  • 配置报错 → 看提示初始化，或检查环境。

第 3 步：会话内编排技能（方式 A，官方推荐）

讲解：方式 A 装 Claude Code 插件，会话内用 /plan /autopilot /team。命令来自官方文档，本环境未实测（未登录 Claude Code）。

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

预期输出: 插件列表出现 oh-my-claudecode；omc-setup 完成初始化

装好确认：

  • 插件列表出现 oh-my-claudecode；
  • /plan 等命令可唤起。

卡住怎么办：

  • 插件装不上 → 确认 Claude Code 登录与插件市场可达。

怎么确认修好了

CLI 形态三步冒烟：

omc --version

预期输出: 5.1.0

omc --help

预期输出: 以 Usage: omc [options] [command] 开头，含 launch/interop/ask/config 等命令

omc config

预期输出: 当前配置内容（JSON 或初始化引导提示）

  • CLI 装好：version/help/config 都能跑（2026-08-27 实测）；
  • 插件形态（方式 A）：/plugin list 能看到 oh-my-claudecode，/plan 能唤起（需登录环境，未实测）。

其它环境的表现（常见变体）

  • 海外直连网络：npm 命令去掉 --registry 参数即可。
  • 纯 CLI 环境：用方式 B，会话内技能用不了（那是方式 A 的能力）。
  • 与 agt/deepcode 共装：CLI 形态实测共存（实测记录（本地留存））。
  • 与 ruflo 共装：插件形态共享 .claude/ 注册面，判定 possible-conflict（未实测）。
  • Node 版本：>= 20（CLI 形态实测要求）。

常用场景（按用户目标）

场景按「你要做什么」组织，不是按命令面；命令均与上文一步步/冒烟同源。

场景 1：会话内编排任务（核心用法）

给 Claude Code 会话加编排能力：拆解目标、自动执行、多角色协作（需要方式 A 插件形态，Claude Code 会话内）：

/plan "要做的目标"
/autopilot "自动执行的目标"
/team

预期输出: plan 输出执行计划；autopilot 开始执行；team 进入团队编排

场景 2：CLI 快速确认与配置（方式 B）

不在会话里时，用 CLI 确认装好/看配置（三连冒烟 = 装好判断）：

omc --version

预期输出: 5.1.0

omc --help

预期输出: 以 Usage: omc [options] [command] 开头，含 launch/interop/ask/config 等命令

omc config

预期输出: 当前配置内容（JSON 或初始化引导提示）

数据与目录

  • 方式 B：npm 全局目录；
  • 方式 A：Claude Code 插件注册面（~/.claude.json / ~/.claude/plugins/）。

卸载与清理

note: 与安装一一对应：方式 B 用 npm 卸载；方式 A 在 Claude Code 内 /plugin remove；最后一行验证零残留
npm rm -g oh-my-claude-sisyphus || true
command -v omc >/dev/null 2>&1 && echo "omc 仍存在（方式 A 安装请执行 /plugin remove oh-my-claudecode）" || echo "omc removed: OK"

预期输出: omc removed: OK

依赖警告

  • 版本：[5.1.0, 5.1.0] 锁定（2026-08-31 隔离实测升级确认）。
  • 环境：Node >= 20（CLI 形态）；方式 A 需 Claude Code 登录环境。
  • 网络：npm 官方源直连超时（实测），必须 npmmirror 镜像。
  • 写面：方式 B npm 全局；方式 A Claude Code 插件注册面。
  • 共装：CLI 形态与 agt/deepcode 实测共存（实测记录（本地留存））；与 ruflo 的插件形态共享 .claude/ 与 ~/.claude/CLAUDE.md 未实测，判定 possible-conflict。

FAQ（常见问题）

  • 问：安装后 omc 命令找不到？答：检查 node 版本 >= 20 与 npm 全局 bin 路径；国内网络确认使用安装段方式 B 的国内分支命令。
  • 问：卸载后还有残留吗？答：npm 方式卸载后验证命令输出 omc removed: OK 即零残留；Claude Code 插件方式需额外执行 /plugin remove。
  • 问：会话内技能（/plan 等）不可用？答：会话内技能需要方式 A（Claude Code 插件）安装，CLI 方式不带会话内技能。
  • 问：使用问题向谁反馈？答：本市场安装/卸载问题走条目反馈入口（usage-report 模板）；项目自身问题请向作者仓库反馈。
验证证据

本站实测记录（2026-08-27）

  • 未实测：方式 A Claude Code 插件与会话内技能（未登录环境）——命令来自官方文档，如实标注。

引用：oh-my-claudecode · 验证于 2026-08-28 · v5.1.0~5.1.0

相关问题（问题域）

出问题了？排障方案

排障手册：oh-my-claudecode（L34 批次 1）

症状 → 原因 → 解法 → 验证证据 四段结构。
素材来源：L33 分源记录（CSDN/掘金）+ 国外信号（L32：GitHub Issue #30、多 fork 同名）+ 本市场实测（2026-08-27/28 隔离 HOME 安装/卸载闭环）。
采集纪律：零账号匿名检索；不破解反爬；未碰 GitHub。check-words HARD 0。

基本信息

  • 条目名称：oh-my-claudecode（Yeachan-Heo/oh-my-claudecode，MIT，v5.0.0 收录）
  • L33 分源信号：CSDN=2 强+3 弱 / 掘金=1 / 知乎=0 / B站=0（中强）
  • §14 角色：core；分类：session
  • 定位：团队优先的多 Agent 编排工具（Claude Code 生态插件形态 + npm CLI + MCP bridge + 31 skills）
  • 本市场安装路径：npm CLI（omc）+ Claude Code 插件形态（方式 A）
  • 主要安装形态：Claude Code 插件（/plugin install + /omc-setup）/ npm 全局 / 源码（node bin/oh-my-claudecode.js）

症状 → 原因 → 解法 → 验证证据

1. 命令未找到（omc: command not found）

症状

装完后 omc 报 command not found；或 /omc-setup 后 CLI 仍不可用。

原因

  1. npm 全局 bin 目录不在 PATH（npm prefix 自定义场景）；
  2. 装的是 Claude Code 插件形态，没跑 /omc-setup 生成 CLI 入口；
  3. 安装中途失败（网络/依赖）。

解法

  1. 确认安装：npm ls -g oh-my-claude-sisyphus。
  2. 重跑 /omc-setup（Claude Code 插件形态）；或重装 CLI：npm i -g oh-my-claude-sisyphus@5.0.0（国内加 --registry=https://registry.npmmirror.com）。
  3. PATH 检查：command -v omc；npm prefix 自定义时把 $(npm prefix -g)/bin 加入 PATH。

验证证据

  • 网页案例：CSDN OMC 教程常见问题（命令未找到 → omc-setup，2026-03）。

本站实测记录

2. 钩子未执行（hook 不触发 / Windows hook 报错）

症状

Agent 会话里 OMC 的 hook 不触发；Windows 上安装后报 UserPromptSubmit/Stop hook error（Issue #30 场景）。

原因

  1. hook 脚本无执行权限（~/.claude/hooks/**/*.sh 缺 +x）；
  2. Windows 下 shell 路径/转义差异，hook 脚本调用失败；
  3. 插件重装后旧 hook 残留。

解法

  1. 补执行权限：chmod +x ~/.claude/hooks/**/*.sh（find ~/.claude/hooks -name '*.sh' -exec chmod +x {} +）。
  2. Windows：用 Git Bash/WSL 兼容环境跑 hook；确认脚本行尾为 LF（避免 CRLF 执行错误）。
  3. 重装插件后如果还报错，先 /plugin remove oh-my-claudecode 再重装。

验证证据

  • 网页案例：CSDN（钩子未执行 → chmod +x hooks，2026-03）；GitHub Issue #30（Windows hook error）。
  • 本市场未实测 Claude Code 插件形态（无登录态），如实标注。

3. 智能体未自动委托（任务没被分发）

症状

配置了多 Agent，但会话里任务没有被自动委托/认领。

原因

Claude Code 没加载 OMC 的 CLAUDE.md（委托规则在 CLAUDE.md 里）；或插件装到了别的项目目录。

解法

  1. 检查 CLAUDE.md 是否加载：会话里问/看 /context 是否包含 OMC 委托规则。
  2. 在正确的项目根目录重跑 /omc-setup（CLAUDE.md 按项目生成）。
  3. 确认委托规则写法与 v5 文档一致（guidance schema contract，见 AGENTS.md）。

验证证据

  • 网页案例：CSDN（智能体未自动委托 → CLAUDE.md 未加载检查，2026-03）。
  • 本市场实测：CLI 形态不依赖 CLAUDE.md（纯命令面，）；插件形态需 Claude Code 会话，未实测。

4. 更新 / 配置异常（omc-doctor 诊断）

症状

升级后行为异常、配置冲突、命令报错。

原因

版本间配置/迁移差异；旧配置残留。

解法

  1. 跑 omc-doctor（内置诊断）看问题点。
  2. 按诊断结果修配置；必要时 npm i -g oh-my-claude-sisyphus@5.0.0 重装对齐版本。
  3. 保留 omc-doctor 输出再反馈问题（含版本号与 node 版本）。

验证证据

  • 网页案例：CSDN（OMC 安装与实践全指南：更新/配置异常 → omc-doctor 诊断，2026-04）。
  • 本市场实测：CLI 面 omc --help 命令表含 launch 等；omc-doctor 为配置面命令，需插件环境未实测。

5. 包名 / 插件名 / 命令名不一致

症状

按插件名 "oh-my-claudecode" 去 npm 搜装不到；卸载时不知道包名。

原因

三套名字不一致：npm 包 = oh-my-claude-sisyphus，Claude Code 插件 = oh-my-claudecode，CLI 命令 = omc。

解法

  1. 安装/卸载用 npm 包名：npm i -g oh-my-claude-sisyphus / npm rm -g oh-my-claude-sisyphus。
  2. 日常使用命令 omc；插件操作在 Claude Code 内用 oh-my-claudecode。

验证证据

  • L33 记录：包名与插件名不一致（oh-my-claude-sisyphus vs omc）。
  • 本市场实测：manifest install.cmd 用 npm 包名 + omc --version 验证（闭环日志 step 1：5.0.0）。

6. Claude Code 本体环境类报错（OOM / Homebrew 冲突 / PowerShell 执行策略）

症状

安装 OMC 过程中 Claude Code 本体出问题：OOM Killed、Homebrew 与 npm 冲突、Windows 提示"禁止运行脚本"。

原因

不是 OMC 自身问题，是 Claude Code 安装环境的常见坑（内存不足、包管理器冲突、PowerShell 默认执行策略）。

解法

  1. OOM：加大内存/关闭多余进程后重试（/omc-setup 依赖 Claude Code 本体）。
  2. Homebrew 冲突：统一用 npm 路径装 CLI（本市场路径 B），避免 brew 与 npm 双写。
  3. PowerShell：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned（按需）后再跑脚本。

验证证据

  • 网页案例：CSDN（Claude Code 安装找不到命令/代理配置：OOM Killed/Homebrew 冲突；PowerShell 禁止运行脚本，2026-03；均为 Claude Code 本体弱相关）。
  • 本市场实测：WSL 环境 npm CLI 形态无此问题（闭环日志）。

7. 同名 fork 项目混淆

症状

搜 "oh-my-claudecode" 找到多个同名/近似项目，装错版本。

原因

上游存在多个 fork/同名仓库（如 AustinElite 等 fork 系），名字接近。

解法

  1. 认准原仓库：Yeachan-Heo/oh-my-claudecode；npm 包名 oh-my-claude-sisyphus。
  2. 版本对齐 v5.0.0（2026-08-24 release）；装前看包信息（npm view oh-my-claude-sisyphus version）。

验证证据

  • 国外信号（L32）：多 fork 同名（AustinElite 等）——名称混淆风险点名。
  • 本市场实测：收录签名 = Yeachan-Heo/oh-my-claudecode v5.0.0（manifest signature）。

本市场实测安装 / 卸载（2026-08-28）

安装（manifest install.cmd，隔离 HOME=/tmp/l34-omc/home）：

# 来源: Trove 排障手册 · 验证于 2026-08-28
[install] 执行: npm i -g oh-my-claude-sisyphus@5.0.0 --no-audit --no-fund --registry=https://registry.npmmirror.com && omc --version
added 149 packages in 1m
5.0.0
[install] exit=0

卸载（manifest uninstall.cmd + verify）：

# 来源: Trove 排障手册 · 验证于 2026-08-28
[uninstall] 执行: npm rm -g oh-my-claude-sisyphus
removed 149 packages in 156ms
[uninstall] 验证: omc removed: OK（fresh shell，verify exit=0）
  • 完整日志：实测记录（本地留存）。
  • CLI 冒烟：实测记录（本地留存）（omc --version 5.0.0；usage 输出）。
  • 连通性：实测记录（本地留存）。
  • 未能实测：Claude Code 插件形态（/plugin install + /omc-setup 需登录会话）、MCP bridge 实跑、多 Agent 实排。

冲突标注

  • possible-conflict（推断态）：agent-governance-toolkit / ruflo / code-review-graph / cc-switch / claude-mem / skilldock——共享 ~/.claude.json 注册段 / Claude 插件注册面（详见矩阵对子证据）。
  • possible-compatible（推断态）：claude-code-router / deepcode / superpowers 等（CLI 面隔离，矩阵对子）。
  • 形态提醒：npm CLI 形态写面最小；Claude Code 插件形态写 ~/.claude 注册面，多插件共装时注意。

名称混淆

  • 三套名字：npm 包 oh-my-claude-sisyphus / 插件 oh-my-claudecode / 命令 omc（见症状 5）。
  • 同名 fork 项目（AustinElite 等）与上游 Yeachan-Heo 区分（见症状 7）。

判据（验证状态）

  • 症状清单：
  • [x] 命令未找到 → 重跑 omc-setup（CSDN 2026-03；本市场 PATH 实测）
  • [x] 钩子未执行 → chmod +x hooks（CSDN 2026-03；Issue #30 Windows hook error）
  • [x] 智能体未自动委托 → CLAUDE.md 加载检查（CSDN 2026-03）
  • [x] 更新/配置异常 → omc-doctor 诊断（CSDN 2026-04）
  • [x] 包名/插件名/命令名不一致（L33 记录 + 本市场实测）
  • [x] Claude Code 本体环境类：OOM/Homebrew/ExecutionPolicy（CSDN 弱相关）
  • [x] 同名 fork 混淆（L32 国外信号）
  • 实测步骤：

本站实测记录

  • [x] 卸载验证（manifest uninstall.cmd：npm rm 149 包 → verify 零残留 exit 0）
  • [x] 网络/镜像场景（npmmirror 1m 安装；）
  • [x] 未能实测项：Claude Code 插件形态（/omc-setup 交互）、MCP bridge 实跑

验收

  • [x] 症状 → 原因 → 解法 → 验证证据 四段齐全（7 症状）
  • [x] 名称混淆已点名（三套名字不一致；fork 同名）
  • [x] check-words HARD 0
  • [x] validate 通过
  • [x] 未碰 GitHub / 未用任何账号

矩阵暂无该工具对子。

← 返回工具货架 ｜ 遇到其它问题？去 问题空间 提交求助卡 ｜ 预检与证据记录由维护流程本地留存，仅公开结论与来源