产品与定位
Codex CLI 是 OpenAI 官方的编码 Agent，在你自己的电脑上本地运行 —— 这是它与站内 OpenAI Codex（云端版） 最本质的区别：云端 Codex 在隔离沙箱里跑任务并提 PR，Codex CLI 则在你的终端里直接读写本地仓库。
OpenAI 目前把 Codex 拆成几条产品线，选型时容易混淆：
| 形态 | 说明 |
|---|---|
| Codex CLI | 本地终端 Agent，本文介绍的对象 |
| Codex Web | 云端 Agent，即 OpenAI Codex |
| IDE 扩展 | VS Code / Cursor / Windsurf 内使用 |
| Codex App | 桌面应用体验，codex app 启动 |
仓库 openai/codex 采用 Apache-2.0 许可，这一点与多数闭源商业编码 Agent 不同。
功能速览
| 功能 | 说明 |
|---|---|
| 本地执行 | 直接操作你本机的代码仓库，无需上传 |
| ChatGPT 订阅登录 | Sign in with ChatGPT，Plus / Pro / Business / Edu / Enterprise 计划均可使用 |
| API Key 模式 | 也可用 API Key，但需额外配置 |
| IDE 集成 | 提供 VS Code、Cursor、Windsurf 扩展 |
| 桌面应用 | codex app 打开桌面端体验 |
| 多平台 | macOS（arm64 / x86_64）、Linux（x86_64 / arm64）、Windows |
| 多安装方式 | 官方安装脚本、npm、Homebrew、独立二进制 |
| 沙箱与审查 | 审查模式下逐条确认工具调用，也支持更自主的运行方式 |
调用与兼容性
# macOS / Linux 官方安装脚本
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
# npm
npm install -g @openai/codex
# Homebrew
brew install --cask codex
# 启动
codex也可以在 GitHub Releases 下载对应平台的独立二进制（如 codex-aarch64-apple-darwin.tar.gz、codex-x86_64-unknown-linux-musl.tar.gz）。
安装源说明：独立安装器默认从 https://releases.openai.com/codex 下载，失败时回退到 GitHub Releases。想让安装器强制走 GitHub Releases，可设置 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false。
版本与更新注意
- 仓库
openai/codex，Apache-2.0 许可 —— 在官方商业编码 Agent 中比较少见，便于审计与二次开发。 - 模型命名持续演进：Codex 相关模型已出现
GPT-5.3-Codex等专门针对编码的版本，云端 Codex 侧则由 GPT-5.6 驱动。引用具体模型名时请以官方文档为准，避免沿用旧名。 - 不要与云端版混淆：
openai/codex仓库面向的是本地 Codex CLI；云端 Agent 在chatgpt.com/codex。本站两者分列条目。 - Windows 用户可通过 PowerShell 脚本安装；安装器会在多个下载源之间回退，内网环境需自行处理出网策略。
- 使用 API Key 而非 ChatGPT 登录时功能与配额规则不同，需按官方 auth 文档额外配置。
选型建议
- 已是 ChatGPT Plus / Pro / Business 订阅用户 → 直接登录即可用，边际成本最低。
- 需要在本地仓库上深度操作、且希望用官方 OpenAI 模型 → Codex CLI 是最直接的选择。
- 需要云端隔离执行、并行跑多个任务并自动提 PR → 用 OpenAI Codex（云端版）。
- 需要开源许可、可自由 fork 的编码 Agent → Codex CLI 的 Apache-2.0 满足要求，但若要求完全离线或自托管模型，应选 OpenCode 或 Cline。
- 想要在终端里跨多家模型自由切换 → Crush 或 Oh My Pi 覆盖更广。