openai/codex

开发工具

OpenAI 的终端编程 Agent:用一句话让它读仓库、改文件、跑命令。

131,390
20,748
Rust
Apache-2.0
创建于 1 年前

如果你已经在用 ChatGPT 订阅并习惯在终端里工作,Codex CLI 值得花一个下午试试;如果更看重后台进程控制、可插拔模型或干净的卸载,先把它当成需要核实的候选。

解决什么问题

过去要改本地仓库里的一个测试或加一个接口,通常是在编辑器里翻文件、把上下文贴进聊天窗口、再把补丁粘回来。Codex CLI 把这条链路收进终端:你描述任务,Agent 直接面对当前 checkout 读代码、改文件、执行命令,你审阅改动的结果和命令输出。变化发生在“读代码—提问—应用补丁”这几步被合并成一次交互,省掉的是来回搬运上下文。

有什么不同

这是 OpenAI 自己的本地 Agent,不是套一层 API 的壳,用 Rust 写成一个独立可执行文件,同时提供 npm、Homebrew 和 GitHub Release 下载等安装方式。对不想装 Node 运行时、或者想在服务器或虚拟机上放单个二进制的用户来说,这一点有实际意义。Agent 跑在本机,操作的是你当前的工作树,而不是远端副本。

真正的分水岭在账号。README 推荐用 ChatGPT 账号登录,作为 Plus、Pro、Business、Edu 或 Enterprise 套餐的一部分使用 套餐说明;API key 也支持,但需要额外配置 认证文档。所以它的成本和可用性绑在 OpenAI 的订阅体系上,不是一个可以随便换模型的通用 harness。

讨论里最具体的取舍是后台守护进程。Hacker News 上一个高热度帖子标题就是关于 Codex CLI 默认安装常驻、自更新的后台守护进程 讨论帖。有评论者给出通过 feature flag 关闭自动启动的路径,并提到启动时会在 ~/.codex 下写文件 评论;另一位回复称,在基于守护进程服务构建应用时它有用 回复。还有评论者报告旧版本在磁盘上堆积,估计总量约 12 GB 评论。这些都是 2026-10-12 的用户报告,不是维护者声明,部分可能针对旧版本,应当对照你安装的版本核实,而不是当作已确定的产品事实。

谁值得试

适合:已经在符合条件的 ChatGPT 套餐里、工作流以终端为主,想要一个能直接读写本地 checkout 的 Agent,尤其是 macOS 或 Linux 上用一行脚本就能装好的开发者。不太适合:需要可换模型 harness、不接受常驻自更新进程,或环境禁止从外网拉安装脚本的情况。后一种情况下,手动下载 Release 二进制是文档里给出的替代安装路径 发布页,但它不会改变需要 OpenAI 账号这一前提。

使用条件与边界

安装面向 macOS、Linux、Windows,可用 shell 或 PowerShell 脚本、npm、Homebrew,也可以下载发布包;README 另有 安装文档 说明从源码构建。账号方面需要 ChatGPT 套餐,或按认证文档额外配置 API key。上面提到的守护进程行为是最需要长期关注的部分:是否自动启动、状态写在哪里、旧版本怎么清理,都要按你的版本确认。README 本身对守护进程、磁盘占用和卸载着墨很少,这些判断只能依赖外部文档和 issue 报告。

HotRepo 点评

日榜样本太稀疏,不足以判断趋势:2026-08-22 到 2026-10-28 之间只有 4 个观测日,最近一次是 131,379 stars、当日 +308 项目。关注度显然很大,但能否持续无法从这几个快照判断。采用前,先核实你安装的版本里守护进程和自动更新的实际行为,以及关闭它们是否符合你的管理要求。

本文由 AI 根据项目 README 生成,更新于 2026年10月28日,以项目官方文档为准。

Hacker News 讨论

Codex CLI installs a persistent, self-updating background daemon by default
▲ 610 · 294 条评论 · 2026年10月12日
OpenAI Codex CLI: Lightweight coding agent that runs in your terminal
▲ 516 · 289 条评论 · 2025年4月16日
Codex logging bug may write TBs to local SSDs
▲ 510 · 271 条评论 · 2026年6月22日