lazycodex

环境要求

• 已安装 Node.js 与 npx（安装全程使用 npx，无需全局安装）
• 已安装并可使用 OpenAI Codex CLI（LazyCodex 深度集成 Codex）
• 可访问 npm 源与 GitHub（市场安装方式需拉取 Git 仓库）
• 存在 Codex 配置目录（安装器会写入 ~/.codex/config.toml 的受管段落）

安装与启动步骤

1. 1确认前置环境

   确保本机有 Node.js/npx 和 Codex CLI，因为安装通过 npx 执行、运行时集成在 Codex 内。

2. 2一键安装

   官方主推方式，不带全局安装。该命令等价于 npx --yes --package oh-my-openagent omo install --platform=codex。

   npx lazycodex-ai install

   复制

3. 3无人值守安装

   需要完全自主、无 TUI 交互时使用，会显式开启 Codex 自主模式。

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

   复制

4. 4市场方式安装

   实验性替代方案：在 Codex 里输入 /plugins 打开 Add Marketplace 填入仓库地址，或直接用下面的 CLI 命令。

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

   复制

5. 5批准 hooks 并重启

   下次启动 Codex 时在启动审查中批准 omo hooks，未批准前 hooks 不会运行；首会话会打印 bootstrap 后台运行提示，完成后重启会话。

6. 6升级插件

   使用市场方式安装后，用此命令升级；下次启动审查会把 hooks 显示为 Modified，属预期，需重新批准。

   codex plugin marketplace upgrade sisyphuslabs

   复制

7. 7诊断异常

   当安装或运行状态看起来待处理、降级时，运行 doctor 查看原因。

   npx lazycodex-ai doctor

   复制

8. 8卸载

   移除插件缓存、bin 链接、agent 角色以及 ~/.codex/config.toml 中的受管段落。

   npx lazycodex-ai uninstall

   复制

关键配置

如何确认成功

首次批准 hooks 后，会话会打印 “LazyCodex bootstrap running in background — restart the session when it completes”，后台 bootstrap 完成后重

常见问题

注意事项

• 主推安装方式是 npx，README 明确不建议全局安装。
• 市场安装（/plugins 或 codex plugin 命令）目前标注为实验性替代路径。
• 升级后 hooks 会显示为 Modified，需重新批准，属于正常现象。
• npx lazycodex-ai doctor 可用于排查待处理或降级状态。