一句话定位：跑在本机的终端编码代理，直接用 ChatGPT 订阅登录。

云端 Agent 最大的问题是“代玛不在我机器上”。Codex CLI 走的是另一条路：一个跑在本地的终端 Agent，能直接读写当前仓库、执行命令、提交改动，而且不需要另买 API 额度——用你已有的 ChatGPT Plus / Pro / Business / Edu / Enterprise 订阅登录即可。仓库主语言是 Rust（codex-rs），Apache-2.0 许可，GitHub 约 134.5k 星、21.3k fork（以仓库实时显示为准）。需要注意的是：这个项目官方明确不接受外部 PR，只能在 Issue 里提 bug 和设计讨论。

核心能力

一、本地执行 + 多平台沙箱，不把仓库交出去
它不只是生成代玛，而是能在你的工作目录里读文件、改文件、跑命令。风险控制在沙箱层：macOS 走终端策略继承，Linux 用专用 helper 进程，Windows 用受限令牌 / 提权令牌并配 deny-read ACL 与只读例外目录，同时还有托管网络代理控制出网。想让它只能看当前仓库、不能乱读家目录时，这层是实打实的约束而不是提示词约束。

二、复用 ChatGPT 订阅，不用单独算 token 费
装完跑 codex，选 Sign in with ChatGPT，直接用你现有的 Plus / Pro / Business / Edu / Enterprise 套餐额度。也可以改走 API Key，但要额外配置。对已经在付 ChatGPT 订阅的人来说，这等于“不多花钱就多一个本地 Agent”；对团队采购来说，不用再单独申请一份 API 预算。

三、apply_patch 是一等工具，改代玛走补丁而不是重写整文件
它内置专门的 apply_patch 工具，并配一份独立的工具说明提示词。这件事在真实仓库里差别很大：模型直接重写整个文件，很容易把你没注意到的段落一并改掉；走补丁则是“只改这几行”，diff 干净、review 容易。

四、同一内核，四种形态：终端 / IDE / 桌面 / 云端
终端里是 codex；想在编辑器里用，可以装 VS Code / Cursor / Windsurf 的 IDE 扩展；想要桌面应用体验跑 codex app；纯云端则去 chatgpt.com/codex 用 Codex Web。四者共享同一套能力模型，你在终端里验证过的提示词和工作习惯，换形态不用重学。

五、Code Mode 与 TUI 细节，长活不容易断
默认启用 hosted mode（独立宿主进程运行，可 opt-out 退回进程内运行时），配统一 exec 生命周期事件，启动失败也会发 start/failure 事件供客户端感知。TUI 带 ChatComposer / PasteBurst 状态机，对不支持 bracketed paste 的终端（尤其 Windows）做了粘贴处理——贴一大段日志进去不会错行。这些都不性感，但是天天用得到。

使用上手

  1. 装：macOS / Linux 跑 curl -fsSL https://chatgpt.com/codex/install.sh | sh；Windows 跑 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"；也可以 npm install -g @openai/codex 或 brew install --cask codex。
  2. 登录：在项目目录下跑 codex，选 Sign in with ChatGPT，用订阅账号完成授权。
  3. 先只读试：让它“解释这个模块的数据流”，不改文件，确认它读到的路径和结构正确。
  4. 再派小改动：一次只让它做一件可验证的事（比如“给这个函数补参数校验并加一个单测”），改完先看 diff 再跑测试。
  5. 需要隔离时开沙箱：用 codex sandbox 相关子命令把执行环境限制住，特别是首次在陌生仓库里跑的时候。

优点与不足

优点：

  • 直接用 ChatGPT 订阅，不用另算 API 费用。
  • 本地执行 + 真沙箱，能干活也能限住范围。
  • apply_patch 让 diff 干净，review 成本低。
  • 终端 / IDE / 桌面 / 云端四形态同源，迁移无成本。

不足：

  • 不接受外部 PR，社区只能报 Issue，想改行为只能等官方。
  • 强绑定 OpenAI 账号体系，没用 ChatGPT 订阅的人性价比不高。
  • Rust + Bazel 构建链对想自己编译的人不友好。
  • Windows 沙箱依赖受限令牌机制，旧系统版本体验可能不一样。

适合谁

  • 已经在付 ChatGPT 订阅、想在终端里直接干活的开发者。
  • 习惯看 diff、不愿让 Agent 重写整文件的工程习惯。
  • 不适合：只用 Claude / Gemini、或者需要完全离线场景的人。

下载与访问

价格与授权

方案价格说明
ChatGPT Plus / Pro按现有订阅登录即用，额度随套餐
Business / Edu / Enterprise按现有订阅团队账号可直接用
API Key 模式按 token 计费需额外配置，适合无机订阅场景
开源许可Apache-2.0可商用可修改（但不接受外部 PR）
具体套餐价格与额度以 OpenAI 官网为准。

本文属于「编程」分类的 AI 资源专栏，更多评测见分类页。