lazycodex

给 Codex 装上记忆和规划，复杂代码库也能一次搞定。

lazycodex 是一个面向复杂代码库的智能体编排工具，专为 OpenAI Codex 设计，提供项目记忆、规划、执行和验证完成的全流程管理。它解决了在大型项目中直接使用 Codex 时缺乏上下文持久性和任务分解能力的问题。核心能力包括：持久化项目记忆以跨会话保留关键信息，自动生成任务规划并逐步执行，以及通过测试或构建验证确保代码修改的正确性。它作为 CLI 工具运行，与 Codex 深度集成，帮助开发者更系统、可靠地完成大型编码任务。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3612

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队code-yeongyu

所属国家

官网地址https://lazycodex.ai

GitHubhttps://github.com/code-yeongyu/lazycodex

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,ai-agents,claude,claude-code,cli,codex,developer-tools,lazy,lazycodex,oh-my-openagent,omo,openai,orchestration,typescript

GitHub 星标★ 3612

30天Star增速

HF 下载量

上线时间2026-05-25 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

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

安装与启动步骤

1确认前置环境

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

官方主推方式，不带全局安装。该命令等价于 npx --yes --package oh-my-openagent omo install --platform=codex。
```
npx lazycodex-ai install
```
3无人值守安装

需要完全自主、无 TUI 交互时使用，会显式开启 Codex 自主模式。
```
npx lazycodex-ai install --no-tui --codex-autonomous
```
4市场方式安装

实验性替代方案：在 Codex 里输入 /plugins 打开 Add Marketplace 填入仓库地址，或直接用下面的 CLI 命令。
```
codex plugin marketplace add https://github.com/code-yeongyu/lazycodex
codex plugin add omo@sisyphuslabs
```
5批准 hooks 并重启

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

使用市场方式安装后，用此命令升级；下次启动审查会把 hooks 显示为 Modified，属预期，需重新批准。
```
codex plugin marketplace upgrade sisyphuslabs
```
7诊断异常

当安装或运行状态看起来待处理、降级时，运行 doctor 查看原因。
```
npx lazycodex-ai doctor
```
8卸载

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

关键配置

配置项	必填	说明	示例
`~/.codex/config.toml`	否	Codex 主配置，安装器会写入受管段落；卸载时这些受管段落会被移除	`~/.codex/config.toml`
`--codex-autonomous`	否	安装参数，显式开启 Codex 自主模式（不修改 Codex 权限设置，仅市场安装路径不涉及）	`npx lazycodex-ai install --no-tui --codex-autonomous`

如何确认成功

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

常见问题

Q：需要 npm install -g 全局安装吗？

A：不需要。README 明确强调不做全局安装、不用 npm i -g，始终通过 npx 运行。

Q：安装后 hooks 没有执行怎么办？

A：hooks 在 Codex 启动审查通过前不会运行，必须在下次启动时批准 omo hooks，之后重启会话。

Q：如何启用完全自主模式？

A：使用 npx lazycodex-ai install --no-tui --codex-autonomous，自主模式是显式选择，市场安装路径不会改动 Codex 权限设置。

Q：升级后 hooks 显示 Modified 是出错了吗？

A：不是。每次升级后下次启动审查都会把 hooks 显示为 Modified，属预期行为，重新批准后下一次会话会在新版本上重跑 bootstrap。

Q：安装状态看起来异常怎么排查？

A：运行 npx lazycodex-ai doctor，它会说明哪些状态待处理或降级及原因；详细文档见 lazycodex.ai/docs。

注意事项

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

核心亮点

内置项目记忆机制，跨会话保持上下文，避免重复解释需求
自动规划任务并逐步执行，适合多文件、多步骤的复杂改动
提供验证完成机制，确保代码修改通过测试或构建检查

不足之处

依赖 Codex 生态，对非 OpenAI 模型支持有限
文档/社区待观察

适用场景

大型代码库中跨模块重构，需要保持全局一致性
多步骤功能开发，需要自动拆解和跟踪任务进度
团队协作时，通过项目记忆共享上下文，减少沟通成本

替代项目

Claude Code、Aider、OpenHands

项目介绍

lazycodex 是智能体领域的开源项目，由 code-yeongyu 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,612）位列前 30%，在智能体分类的 2,499 个项目里位列前 12%。

近 45 天，它的 GitHub 星标从 3,162 增加到 3,612，净增 450。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：大型代码库中跨模块重构，需要保持全局一致性。同类可对比的替代方案包括 Claude Code、Aider、OpenHands。

上一篇：animaworks

下一篇：AgentPipe