安装 oh-my-openagent 前，最容易踩的坑不是命令输错，而是没有先选版本。官方文档现在把它分成两条线：OpenCode Ultimate 和 Codex Light。一个偏完整编排，一个偏 Codex CLI 的轻量规则包。入口看错，后面就会出现“装上了但不是我想要的那套能力”。

官方入口先看哪里

核入口时看两个地方就够：官方文档站 ohmyopenagent.com/docs，以及 GitHub 仓库 code-yeongyu/oh-my-openagent。文档页适合看快速安装和 CLI 参数，GitHub 的 installation.md 适合看版本定义、命令差异和文件落盘位置。第三方教程可以参考，但不要拿它当安装入口。

OpenCode Ultimate 是完整体验

官方 installation.md 里把 Ultimate 写成 omo for OpenCode。它包含更完整的 omo 体验，例如多学科 agent、生命周期 hooks、内置 MCP、slash command、Team Mode、ulw-loop 和 hashline edits。也就是说，它适合已经在用 OpenCode，并且想把 OpenCode 变成多 agent 编排工作台的人。

安装时，shared omo CLI 的默认平台是 opencode，也就是 Ultimate。常见命令是 bunx oh-my-openagent install。如果你机器上 OpenCode、provider、模型授权都还没准备好，直接上 Ultimate 反而会让排错面变大。

Codex Light 不是缩小版 Ultimate

Codex Light 面向 Codex CLI 的插件系统。官方文档写到，它会放入 rules、comment-checker、git-bash、lsp、ultrawork、ulw-loop、start-work-continuation、telemetry，以及若干 plugin-scoped MCP；但没有 agent orchestration、Team Mode、tools。它更像把稳定规则和工作流塞进 Codex，而不是复刻 OpenCode 的全套队伍。

Codex 线常见入口是 npx lazycodex-ai install。如果你只是用 Codex CLI 写代码、改 bug、续接任务，Light 更直接。若期待多 agent 队列、团队模式和 OpenCode 的完整插件能力，就不该把 Light 当 Ultimate 替代品。

命令不要混用

这里最容易错的是把 omo、oh-my-openagent、lazycodex-ai 当成同一个入口。按官方说明，shared omo CLI 省略平台时偏向 opencode，也就是 Ultimate；lazycodex-ai 则默认走 Codex Light。安装前先看命令到底落到 OpenCode 还是 Codex CLI，不要看到 “agent harness” 就一路回车。

失败场景很典型：本来只想给 Codex CLI 加轻量规则，却执行了 OpenCode 侧安装；或者想用 OpenCode 的多 agent 编排，却只装了 Codex Light。前者会让配置目录和当前工具对不上，后者会发现 Team Mode、agent orchestration 这些能力并没有出现。

怎么选版本

已经长期使用 OpenCode、需要多个专门 agent 参与复杂工程任务，选 OpenCode Ultimate。平时主要在 Codex CLI 里工作，只想要规则、工作流和轻量工具链，选 Codex Light。两边都用，就按官方的 --platform both 思路安装，但先确认每边的配置目录和凭据都能正常读取。

安装前的检查

先确认自己要装到哪里：OpenCode 还是 Codex CLI。再确认运行环境：Ultimate 依赖 OpenCode 侧配置，Light 走 Node/npm 的 lazycodex-ai。安装后不要只看命令成功，要看对应目录里是否生成配置，关键 workflow 能不能触发，agent 或规则有没有被当前 CLI 读到。

安装后怎么验收

Ultimate 的验收重点是 OpenCode 侧是否能看到 omo 配置、slash command 是否可用、Team Mode 或编排流程是否能被触发。Light 的验收重点是 Codex CLI 是否读到 rules 和 workflow，像 ultrawork、ulw-loop、start-work-continuation 这类规则是否进入当前项目。两边的成功标志不同，不能只用“命令退出码为 0”判断。

如果装完没有效果，先回到版本判断：当前 CLI 是 OpenCode 还是 Codex CLI，执行的是 shared omo 还是 lazycodex-ai，落盘目录是否匹配。这个顺序比反复重装更省时间，也能避免把 Ultimate 和 Light 的问题混在一起排。

我会这样判断：需要完整编排时走 Ultimate；只给 Codex CLI 补轻量能力时走 Light；看不懂两者差异时，先别用 both。先装错版本再回头排查，通常比重新读一遍 installation.md 更费时间。