不少人是冲着”终端里的编程智能体”这名头来装 Codex 的，结果第一步就卡住：搜出来的教程清一色让你 npm install -g @openai/codex，装完一跑，版本不对、更新也不灵。其实官方 README 早就把最顺的路铺好了，只是很多人没翻到。

先说结论：现在的 Codex CLI 有官方独立安装器，一条命令搞定，npm 只是其中一种选择，而且不一定是最省心的那种。

四种安装方式，按平台对号入座

Mac 和 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），或者 Mac 上用 Homebrew（brew install --cask codex）。装完在任意目录敲 codex，就能进交互界面。

独立安装器有个细节值得知道：它默认从 releases.openai.com 下载版本元数据和安装包，如果元数据拿不到或者校验失败，会自动回退到 GitHub Releases。想强制走 GitHub，设置环境变量 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false 就行——下载慢的时候这个开关很管用。

装完之后：登录和三种使用形态

第一次运行 codex，选 Sign in with ChatGPT 登录。官方建议直接用 ChatGPT 账号走订阅额度，Plus、Pro、Business、Edu、Enterprise 套餐都包含 Codex 的使用量。也可以改用 API Key，但那需要额外的配置步骤，新手先别碰。

登录成功后，Codex 其实有三种形态可选：终端里直接跑是 CLI；想要桌面体验，运行 codex app 或者去 Codex App 页面下载客户端；还有跑在云端的 Codex Web，地址在 chatgpt.com/codex，适合不想在本机装任何东西的场景。编辑器党也有份——VS Code、Cursor、Windsurf 都有对应的 Codex IDE 扩展可以装。

两个常见坑

一是别去 GitHub Releases 手动翻二进制文件，除非你明确要某个旧版本——每个 Release 里塞了十几个平台的压缩包，Mac 用户要在 aarch64 和 x86_64 之间选对架构，解压后还得自己改名，麻烦。

二是 Windows 用户注意，官方对 Windows 11 的支持走的是 PowerShell 安装器这条路，系统版本太老的话先升级再装，别硬来。

整体来说，现在的安装体验比早期版本友好太多了。如果你之前被 npm 那套劝退过，建议用官方安装脚本重装一次，再去教程区看看进阶配置，基本一次就通。