oh-my-openagent 官方入口：Codex/OpenCode 编程 Agent 安装教程

oh-my-openagent 官方入口是 GitHub 仓库 code-yeongyu/oh-my-openagent，官网文档入口会跳到 omo.dev/docs。核验日期：2026-07-07。它不是单一模型，而是给 OpenCode 和 Codex 准备的编程 Agent harness：OpenCode 走 Ultimate edition，Codex CLI 走 Light edition。别看到名字里有 openagent 就随便搜第三方下载包，安装命令要按官方 README 和安装指南来。

Codex 和 OpenCode 分别怎么安装

只装 Codex Light，用 npx lazycodex-ai install；想让它写入推荐的自主权限，再用 npx lazycodex-ai install --no-tui --codex-autonomous。OpenCode Ultimate 才用 bunx oh-my-openagent install。如果两边都要装，官方示例是 bunx oh-my-openagent install --no-tui --platform=both --claude=yes --gemini=no --copilot=no --codex-autonomous。这一步别混：lazycodex-ai 是 Codex Light 安装器，Codex marketplace 里看到的是 sisyphuslabs/omo。安装前先关掉正在跑的 Agent 会话，免得配置写入后旧进程还读旧状态。

安装前检查什么

• Codex Light 需要 Node/npm，不需要 Bun。

• OpenCode 版先确认 opencode --version，官方验证项写的是 1.4.0 或更高。

• Provider 认证按安装器询问走，Anthropic、Gemini、Copilot、OpenAI、Z.ai 等不要写进业务项目 .env。

安装后文件会写到哪里

Codex Light 会写入 ~/.codex/plugins/cache/sisyphuslabs/omo/、~/.codex/config.toml 和 ~/.codex/agents/，还会把组件 CLI 链到 ~/.local/bin 或 $CODEX_LOCAL_BIN_DIR。OpenCode 版会注册 opencode.json 的 plugin，并生成 ~/.config/opencode/oh-my-openagent.jsonc。项目内也可能有 .opencode/oh-my-openagent.jsonc，离当前目录更近的配置优先。不要手动删除 .codex、.opencode，先备份再改。

怎么验收安装成功

Codex 里先跑一个小任务，不要直接交给它大改仓库。看 ~/.codex/config.toml 是否出现 omo@sisyphuslabs，再用 Git Diff 检查它改了哪些文件。OpenCode 侧可以看 opencode.json 是否含 oh-my-openagent，再跑 bunx oh-my-openagent doctor。如果团队已有 CLAUDE.md、AGENTS.md 或 AI 编程规范，先让它只做 review 或 comment checker，别一上来开 team mode。第一次试跑建议用只读分析任务，确认模型、权限、MCP 都正常后再放写代码任务。

适合谁，不适合谁

它适合已经在用 Codex 或 OpenCode、想把规则、检索、LSP、comment checker 这类能力打包进 Agent 流程的人。不适合只想装一个聊天插件的新手，也不适合没有权限审查流程的生产仓库。先在小仓库试，确认回滚方式，再接主项目。

常见问题

1. 为什么名字不一致？官方处在 rename transition，oh-my-opencode、oh-my-openagent 和 lazycodex-ai 会同时出现。

2. Codex 要不要 Bun？官方说明 Light edition 不需要 Bun。

3. 能用镜像站吗？不要，只用 GitHub、官方文档或官方 release。

安装成功检查清单

• 官方仓库确认是 code-yeongyu/oh-my-openagent。

• Codex 用 npx lazycodex-ai install。

• OpenCode 用 bunx oh-my-openagent install。

• 配置文件、插件名和 Git Diff 都核过一遍。