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

你会遇到什么

装完后 omc 报 command not found；或 /omc-setup 后 CLI 仍不可用。装了却找不到命令，常见原因有三个，按下面排查。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

“命令找不到”的本质是shell 解析链问题：你输入 omc，shell 按 PATH 环境变量依次查找可执行文件，全路径都找不到就报 command not found。

所以三个常见原因对应三个不同的断点：装错形态——OMC 有两种安装形态（Claude Code 插件 vs npm CLI），插件形态不会生成 omc 命令，只有跑 /omc-setup 才会生成 CLI 入口（断点在“命令根本不存在”）；

装到别处——npm 全局 bin 目录（$(npm prefix -g)/bin）不在 PATH 里，命令存在但 shell 找不到（断点在“查找路径”）；

装了一半——安装中途失败，bin 链接没生成（断点在“安装完整性”）。排查顺序固定：先 npm ls -g 确认包在不在（排除“没装”）→ 重跑 setup 或重装（补全缺失环节）→ 最后 command -v omc 查 PATH（确认查找链）。三层都过了，命令必在。

一步步来

1. 确认安装 — 必做

npm ls -g oh-my-claude-sisyphus

2. 重跑 /omc-setup（插件形态）或重装 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。

怎么确认修好了

命令面就位（实测输出形态）：

command -v omc
→ /usr/local/bin/omc（隔离 HOME 下实测）

omc --version 正常输出版本。

其它环境的表现

症状

装完后 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。