Codex 怎么装怎么选：CLI、IDE、桌面版、Web 四个入口

Codex 是运行在本机上的编程 agent（能自己读写文件、执行命令的 AI 程序，不是只回代码的聊天框），本文列出四个入口和四种安装方式，选一个装完就能用。

现在值得看的原因：官方 README 中，独立安装脚本已改用 https://chatgpt.com/codex/install.sh，安装包默认从 releases.openai.com/codex 下载，GitHub Releases 只作为备用；照着旧教程去 Release 页面翻压缩包，会多走一步。

一、先选入口：四个 Codex，装法完全不同

README 第一段就把 Codex 拆成四种形态，而搜「Codex 安装」的人常默认它只有一个。四种形态是终端里的 CLI、编辑器扩展、桌面 App、云端 Codex Web，进入方式各不相同。装错入口是最常见的浪费，因为四个形态的「安装」根本不是一个动作。

一个容易漏掉的细节：桌面版没有单独安装包。README 的原话是「想要桌面 App 体验，运行 codex app」，也就是说桌面版由 CLI 提供加载入口——得先把 CLI 装好才能起。表里桌面版那行标「本机」，是我按 codex app 这条命令推的：它从本地 CLI 拉起，所以不会跳到云端跑。

二、三条前置条件：系统、Node、ChatGPT 账号

1. 确认系统和架构。macOS 或 Linux 打开终端执行 uname -m，看到 arm64 或 x86_64 就记下来，后面选二进制包要用。Apple Silicon 的 Mac 是 arm64，老 Intel Mac 是 x86_64。Windows 不用判断架构，直接用 PowerShell 那条一行命令。
2. 确认是否走 npm。执行 node -v，有版本号输出才走 npm 路径；没有就用官方脚本，别为了装一个 CLI 先折腾 Node 环境。
3. 确认 ChatGPT 账号状态。README 推荐的登录方式是运行 codex 后选 Sign in with ChatGPT，走你已有的 Plus、Pro、Business、Edu 或 Enterprise 套餐。这一步决定你后面会不会卡在登录环节。

三、四种装法，按机器对号入座

README 给的四条路，差别不在功能，在「谁来管这个二进制文件」：

# macOS / Linux：官方安装脚本
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# npm
npm install -g @openai/codex

# Homebrew
brew install --cask codex

# Windows：官方安装脚本
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

二进制这条要多说两句。macOS 对应 codex-aarch64-apple-darwin.tar.gz（Apple Silicon）和 codex-x86_64-apple-darwin.tar.gz（Intel）；Linux 是 codex-x86_64-unknown-linux-musl.tar.gz 和 codex-aarch64-unknown-linux-musl.tar.gz。musl 是另一种 C 标准库，Alpine 这类精简系统用它；README 的 Linux 清单只给了 musl 包，没给 glibc 版。README 明写：每个包里只有一个带平台后缀的可执行文件，解压后建议改名成 codex。照着做就是三行（macOS Apple Silicon 举例，其它平台换文件名）：

tar -xzf codex-aarch64-apple-darwin.tar.gz
mkdir -p ~/.local/bin && mv codex-aarch64-apple-darwin ~/.local/bin/codex
codex --version   # 能打印版本就说明进 PATH 了；报 command not found 就换你 PATH 里的目录重放

四条路怎么选 —— 官方不替你选路，下面是我的经验：macOS 上已经在用 brew 的走 brew，升级和卸载跟你机器上其它命令行工具一条命令对齐；需要固定版本、或者在 CI 里复现的走 npm；只装一次试试的用官方脚本最省事，代价是版本管理交给了下载器。

四、装完第一件事：跑 codex，选 Sign in with ChatGPT

装完不用先配密钥。README 的下一步只有一句：运行 codex。首次启动会让你选登录方式，推荐的是 Sign in with ChatGPT，意义在于把 Codex 的用量挂到你已有的 ChatGPT 套餐上，而不是另起一套计费。

成功标志有三个：

• 终端执行 codex 能起来，并出现 Sign in with ChatGPT 这个选项；
• 选完能回到会话，而不是反复要求重新登录；
• 顺手验证桌面入口：执行 codex app 能拉起桌面窗口。README 只说明桌面体验用这条命令启动、没写会出现什么界面，所以窗口拉起来就算通过。

五、三个卡点，按现象对号

下面三条不靠报错文案判断，对上现象就照右边做。

卡点一：脚本停在下载阶段。 独立安装器默认去 releases.openai.com/codex 拉包，那个域名不通就会一直等。README 给了开关，能强制切到 GitHub Releases，值写 false、0、no 都认：

macOS / Linux：

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh

Windows PowerShell：

$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iex

卡点二：二进制装完敲 codex 没这个名字。 解压后得到的是一个带平台后缀的文件，比如 codex-aarch64-apple-darwin，README 明写每个包只有这一个文件、建议改名成 codex。不改名，PATH 里就不存在 codex 这个命令名，只有那一长串文件名。

卡点三：把 IDE 扩展当成另一个产品去找独立安装包。 README 把 IDE 和 CLI 并列成两个入口，没写必须先装 CLI——所以扩展可以单独装。宿主是三个：VS Code、Cursor、Windsurf，在对应编辑器的扩展入口里搜 Codex 即可。README 把两者并排列出、没有写依赖顺序 —— 扩展可单独装是按这个排布推断的。

六、和 Cursor、Claude Code 一起怎么摆

把这道题问成「Codex 还是 Cursor」的人，多半没注意 README 里这句：想在编辑器里用 Codex，就去 VS Code、Cursor、Windsurf 里装扩展。也就是说 Codex 的 IDE 形态本来就运行在 Cursor 里面，两者不是互斥的软件。一部分人的实际配置就是 Cursor 当编辑器、Codex 接任务。

真正的分界在「谁动手」。Cursor 这类 IDE 是你在看代码时帮你补全和改写；Codex 是 agent，你把任务交出去，它在本地读写文件、执行命令。这不是能力高低之分，是交互方式不同。

至于 Claude Code，这篇不给结论，因为手上只有 OpenAI 这份官方 README 是一手材料。能给的是判断顺序：先看订阅载体。据至顶网 2026-08-13 的对比文章，两家基础版都是每月 20 美元——这是媒体说法，不是任何一方的官方价目表，下单前自己去账号页核一遍。你已经在付 ChatGPT 的账，Codex 的边际成本最低；团队工具链和账单已经落在 Claude 那一侧，我的经验是：换工具要付出的成本通常比模型差异更值得计算。

还有一个结构性差异：Codex CLI 仓库是 Apache-2.0，脚本、安装器、agent 本体都在里面，能检查也能自己编译。对需要审查依赖来源的团队，这一点比参数对比更能决定选型。

七、参考来源

• OpenAI Codex 官方仓库与 README

• Codex Web / App 入口

• 独立安装包默认下载源：releases.openai.com/codex（安装脚本自动请求的下载端点，不是浏览页 —— 浏览器直接打开会 403，属预期）

• GitHub Releases（安装器备选下载源）

• 至顶网《Claude Code 与 Codex 深度对比》（中文社区视角，2026-08-13）

• Codex vs Claude Code：两大 AI 编程助手对比

• Codex 与 Cursor 有什么区别？AI 编程工具优缺点对比与选择建议