详情

首页手游攻略 oh-my-openagent 怎么安装?LazyCodex 官方入口与配置指南

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

佚名 2026-07-23 10:30:02

想在 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 官方文档安装区,展示 npx lazycodex-ai install 和 autonomous 安装命令
先看官方安装区:主命令是 npx lazycodex-ai install,不是全局 npm 安装。

安装前先确认环境

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

我会这样试:先运行 node -vnpm -vnpx -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 在你批准前不会运行。

LazyCodex 官方文档 Overview 页面,展示 commands、skills、hooks、MCP servers、model routing 和 agent roles
安装后接入的不只是一个命令,而是一组 commands、skills、hooks、MCP 和模型路由。

也可以从 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 等命令。

LazyCodex GitHub README 验证区,展示 npx lazycodex-ai doctor、uninstall 和 Commands 说明
验证时重点看 doctor 输出和 Codex 里的 $ 命令菜单,别只看安装命令有没有跑完。

首次配置建议

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

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

常见坑

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

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

点击查看更多
推荐专题
热门阅读