团队优先的多 Agent 编排工具（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）。

note: 方式 B npm CLI（本环境实测）；国内必须带 npmmirror 镜像

# 来源: Trove 详细指南 · 验证于 2026-08-28
npm i -g oh-my-claude-sisyphus@5.0.0 --no-audit --no-fund --registry=https://registry.npmmirror.com
omc --version

预期输出: 5.0.0

CLI 形态三步冒烟：

# 来源: Trove 详细指南 · 验证于 2026-08-28
omc --version

预期输出: 5.0.0

# 来源: Trove 详细指南 · 验证于 2026-08-28
omc --help

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

# 来源: Trove 详细指南 · 验证于 2026-08-28
omc config

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

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

两种形态，机制不同：

• 方式 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 等）。

实测命令 = npm 全局安装（npmmirror，2026-08-27 本环境验证）；国外/可直连网络可去掉 --registry 参数（见指南安装段地区分支）；Claude Code 插件路径见指南方式 A

第 1 步：装 CLI（方式 B）

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

# 来源: Trove 详细指南 · 验证于 2026-08-28
npm i -g oh-my-claude-sisyphus@5.0.0 --no-audit --no-fund --registry=https://registry.npmmirror.com
omc --version

预期输出: 5.0.0

海外/可直连网络分支：

# 来源: Trove 详细指南 · 验证于 2026-08-28
npm i -g oh-my-claude-sisyphus@5.0.0 --no-audit --no-fund
omc --version

预期输出: 5.0.0

装好确认：

• omc --version 输出 5.0.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）按需再装。

# 来源: Trove 详细指南 · 验证于 2026-08-28
omc config

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

装好确认：

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

卡住怎么办：

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

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

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

# 来源: Trove 详细指南 · 验证于 2026-08-28
/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 登录与插件市场可达。

与工具页矩阵同源，共 19 对（1 实测兼容 / 12 推断可能兼容 / 6 推断可能冲突）；完整对子、状态与证据见 冲突对子（共装矩阵）。

• 症状：命令未找到（omc: command not found）
• 症状：钩子未执行（hook 不触发 / Windows hook 报错）
• 症状：智能体未自动委托（任务没被分发）
• 症状：更新 / 配置异常（omc-doctor 诊断）
• 症状：包名 / 插件名 / 命令名不一致
• 症状：Claude Code 本体环境类报错（OOM / Homebrew 冲突 / PowerShell 执行策略）

四段式全文（症状→原因→解法→验证证据）：站内文档

# 来源: Trove 详细指南 · 验证于 2026-08-28
npm rm -g oh-my-claude-sisyphus || true

note: 与安装一一对应：方式 B 用 npm 卸载；方式 A 在 Claude Code 内 /plugin remove；最后一行验证零残留

# 来源: Trove 详细指南 · 验证于 2026-08-28
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

• 运行环境预检（需 node >= 20；输出包含系统架构与 node 版本号即通过）
• 两条真实安装路径任选其一（方式 B = npm CLI，本环境实测通过；方式 A = Claude Code 插件市场，官方推荐但本环境未实测）；最后一步为验证命令
• 每条操作 = 一个命令块 + 预期输出；会话内技能需方式 A 安装后可用
• 与安装一一对应：方式 B 安装的用 npm 卸载；方式 A 安装的在 Claude Code 内 /plugin remove；最后一行验证零残留

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

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

• 条目签名：Yeachan-Heo/oh-my-claudecode（MIT，原样收录 v5.0.0）

• 实测：实测记录（本地留存）（2026-08-27，npm 安装 + version/help/config 冒烟）；实测记录（本地留存）（与 agt/deepcode 共存，CLI 层）。
• 未实测：方式 A Claude Code 插件与会话内技能（未登录环境）——命令来自官方文档，如实标注。