oh-my-openagent 怎么安装？LazyCodex 官方入口与配置指南

想在 Codex 里用 oh-my-openagent，最容易混淆的是名字：OmO 是 oh-my-openagent 这套 agent harness，LazyCodex 是它面向 Codex 的安装入口。你如果只是想给 Codex 加上项目记忆、规划、执行、验证、技能和 hooks，应该从 LazyCodex 开始，而不是照着 OpenCode 版配置硬装。

我会这样判断入口：用 Codex，就看 LazyCodex；用 OpenCode，再看 OmO/oh-my-openagent 的完整文档。本文只讲 Codex 方向，也就是 LazyCodex 官方入口和基础配置。

安装前先确认环境

LazyCodex 官方文档要求先有 Node.js/npm，因为安装走 npx；还要有 Codex App 或 Codex CLI，并且 Codex 已经登录。它运行在 Codex 里面，没有单独的 LazyCodex 登录命令。

我会这样试：先运行 node -v、npm -v、npx -v。如果这三个命令都正常，再打开你要工作的项目。首次使用建议用 Codex App，比纯 CLI 更容易看到 hooks 审核和命令菜单。

用官方一行命令安装

常规安装命令很短：

npx lazycodex-ai install

官方说明里也写清楚了，这等价于通过 oh-my-openagent 包调用 omo install --platform=codex。如果你想跳过 TUI，做更自动化的 Codex agent 设置，可以用：

npx lazycodex-ai install --no-tui --codex-autonomous

这一步会把命令、skills、hooks、模型路由和验证默认项接进 Codex 配置。安装后重新打开 Codex，会看到 omo hooks 的启动审核。不要跳过这个细节：hooks 在你批准前不会运行。

也可以从 Codex 插件市场安装

官方把 marketplace 路径标成实验性替代方案。你可以在 Codex 里输入 /plugins，打开 Add Marketplace，填入 https://github.com/code-yeongyu/lazycodex，再安装 omo@sisyphuslabs。CLI 方式则是：

codex plugin marketplace add https://github.com/code-yeongyu/lazycodex

codex plugin add omo@sisyphuslabs

我会这样选：第一次安装优先用 npx lazycodex-ai install，因为这是文档里的主路径；如果你已经熟悉 Codex 插件市场，再尝试 marketplace。两条路不要混着反复装，出问题先跑 doctor。

安装后怎么验证

验证命令是：

npx lazycodex-ai doctor

doctor 会检查插件缓存、hooks、MCP servers、agents 和配置状态。进入 Codex 后，也可以在输入框里敲 $，看是否出现 $init-deep、$ulw-plan、$start-work、$ulw-loop 等命令。

首次配置建议

装好以后，第一步可以运行 $init-deep，让 LazyCodex 为项目生成层级化 AGENTS.md 上下文。复杂任务先用 $ulw-plan 写计划，再用 $start-work 执行；如果是需要一直推进到证据充分的任务，再用 $ulw-loop。

我会这样用：不要一装好就把所有任务都交给 ultrawork。先在一个真实项目里跑 $init-deep，看它是否能正确理解目录、测试命令和关键模块。确认它没有走偏，再让它处理长期任务。

常见坑

第一，不要用 npm install -g 或 bun add -g 安装 LazyCodex，官方明确建议走 npx。第二，安装后要重开 Codex 并批准 hooks。第三，如果命令菜单没有出现，先跑 npx lazycodex-ai doctor，不要直接删配置。第四，LazyCodex 不是省 token 工具，它是把规划、执行和验证做得更像工程流程；小问题直接用裸 Codex 反而更轻。

收尾检查看 4 件事：Codex 已登录，Node/npm/npx 可用，hooks 已批准，$ 菜单能看到 LazyCodex 命令。四项都过，再开始让它接复杂代码库的活。