Codex 怎么安装：npm、Homebrew、脚本与手动下载
Codex CLI 是运行在本机的编程代理，可按系统选一条安装路径。
npm 官方包页面显示，@openai/codex 的 0.142.0 版本发布于 2026-06-21。官方安装方式也已形成脚本、npm、Homebrew 和手动下载四条路径；现在值得重新梳理，是因为不同方式对系统、现有工具链和下载来源的要求不同，装错入口后还可能出现命令找不到、升级来源不一致等问题。
以下步骤以 OpenAI Codex 官方仓库 README 为准。事实均来自官方原文；涉及安装路径选择的判断已单独说明。
动手前准备：先确定你要装哪一种
先区分三个容易混淆的入口：
- Codex CLI：在终端里运行的本地编程代理。
- Codex IDE 扩展：面向 VS Code、Cursor、Windsurf 的编辑器入口，官方 README 将其指向 IDE 安装流程。
- Codex Web：浏览器中的云端代理，入口是 chatgpt.com/codex。
本文只处理 Codex CLI。动手前完成这三项：
- 打开终端，确认系统为 macOS、Linux 或 Windows；Windows 建议使用 PowerShell。
- 准备登录 Codex 的 ChatGPT 账号。官方 README 写明，运行
codex后选择 Sign in with ChatGPT，并推荐 Plus、Pro、Business、Edu 或 Enterprise 计划用户采用该方式。 - 按安装方式准备对应工具：选择 npm 就准备 Node.js 与 npm，选择 Homebrew 就准备 Homebrew；选择脚本或手动下载则不依赖包管理器。
本地安装完成后，调用 Codex 是否包含在所用计划内，要以该计划当时提供的权益为准；安装命令本身没有列出额外的软件购买步骤。
四种安装方式，按系统和工具链选择
| 安装方式 | 适合系统 | 开始前需要什么 | 安装后的入口 | 适合谁 |
|---|---|---|---|---|
| npm | macOS、Linux、Windows | Node.js、npm | codex |
已经用 npm 管理开发工具的人 |
| Homebrew | macOS | Homebrew | codex |
习惯用 Homebrew 管理应用的人 |
| 官方脚本 | macOS、Linux、Windows | 终端、PowerShell | codex |
想一步完成安装的人 |
| 手动下载 | macOS、Linux | 压缩包解压工具 | codex |
无法使用脚本或包管理器的人 |
这不是四种互斥产品，而是同一套 Codex CLI 的不同分发方式。若电脑里已经有 Node.js 和 npm，优先使用 npm；macOS 用户如果已经在维护 Homebrew cask，选 Homebrew 更顺手；其余情况用官方脚本。没有管理员权限或公司电脑禁止全局安装时，手动下载更可控。
npm 与 Homebrew：适合已有工具链的人
使用 npm 安装
官方仓库给出的完整命令是：
npm install -g @openai/codex-g 表示全局安装，安装完成后终端可以在当前项目的任意目录调用 codex。如果你在 npm 官方包页面 核对包信息，页面记录的 0.142.0 版本发布日期为 2026-06-21。
使用 Homebrew 安装
macOS 用户可以执行：
brew install --cask codexHomebrew 路径更贴合已经使用 brew upgrade 管理工具的电脑。与之相比，npm 方案依赖 Node.js 工具链，但跨平台命令行环境中的使用方式更统一。不要为了一个 CLI 安装同时配置 npm 和 Homebrew；选现有工具链中更稳定的一套即可。
两种方式完成后，都运行：
codex官方 README 对包管理器安装后的下一步就是运行 codex 启动。首次进入后，选择 Sign in with ChatGPT，再按浏览器提示完成登录。
官方安装脚本：一次完成下载与安装
macOS 与 Linux
官方 README 当前提供的脚本命令是：
curl -fsSL https://chatgpt.com/codex/install.sh | sh脚本默认从 OpenAI Releases 下载独立安装包；如果元数据或资源下载不可用，会回退到 GitHub Releases。
需要强制使用 GitHub Releases 时，官方给出的命令是：
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false shWindows PowerShell
Windows 使用官方提供的安装脚本：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"如果要让 PowerShell 安装器也强制走 GitHub Releases，官方 README 给出的写法是：
$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iex脚本方案的优点是命令短；代价是它会直接执行网络脚本。对代码审计有严格限制的团队，先固定下载来源，再决定是否执行，比直接粘贴更稳妥。官方支持通过 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false 强制 GitHub Releases，这正是处理下载源差异的明确开关。
手动下载：无法运行脚本时的可控路径
在 OpenAI Codex 官方仓库 的 Releases 页面找到适用于当前系统的压缩包。官方 README 列出了这些常用文件：
macOS
Apple Silicon/arm64: codex-aarch64-apple-darwin.tar.gz
x86_64 (older Mac hardware): codex-x86_64-apple-darwin.tar.gz
Linux
x86_64: codex-x86_64-unknown-linux-musl.tar.gz
arm64: codex-aarch64-unknown-linux-musl.tar.gz解压后，压缩包中的可执行文件名带着平台和架构信息。官方明确要求将其重命名为 codex。例如 Apple Silicon macOS 文件应命名为：
codex随后从包含该文件的目录运行：
codex手动下载方案需要自行管理升级和文件位置。它适合无管理员权限、脚本被安全策略拦截，或者需要在受限电脑上部署的情况；如果能正常使用 npm 或 Homebrew，没有必要额外维护一份手动安装。
常见卡点：把下载、路径和版本问题分开处理
安装器无法取得元数据或资源
官方 README 对应的原始条件是：安装器在 metadata or asset download is unavailable 时，会回退到 GitHub Releases。若希望明确绕过 OpenAI 下载源，直接使用前面给出的 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false 命令，不要反复重试同一条默认命令。
解压后终端找不到 codex
手动下载时，官方要求把解压出的平台专用文件重命名为 codex。文件名如果仍是 codex-aarch64-apple-darwin 一类长名称，或文件所在目录没有加入终端搜索路径，codex 就无法作为普通命令直接调用。重新按官方文件名规则重命名，并把该文件放进系统能够找到可执行文件的目录。
已经装过旧版本，不确定当前入口来自哪里
先不要重复叠加 npm、Homebrew 和脚本安装。官方仓库首页会持续更新安装说明与发布记录；从 Codex 官方仓库 的 README 和 Releases 对照当前文件。若后续需要桌面应用体验，官方还提供 codex app 命令：
codex app这条命令启动桌面应用入口，与在终端中直接运行 codex 不是同一种体验。
怎么算安装成功：看到启动界面和登录选项
成功标志不是“安装命令没有报错”这一项，而是三个连续结果：
- 执行
codex后，终端出现 Codex CLI 的交互界面。 - 首次使用时出现 Sign in with ChatGPT，浏览器登录可以正常完成。
- 回到终端后，可以进入项目目录并开始交互。
如果只是想体验桌面版，则执行 codex app 后应出现桌面应用；如果目标是云端版本，则直接打开 chatgpt.com/codex，不要继续排查本地 CLI。
安装入口与后续排错
常用入口集中在三处：OpenAI Codex 官方仓库 查看 README、源码和 Releases；npm 官方包页面 查看 npm 发布信息；OpenAI Releases 提供脚本默认使用的独立安装包。
判断安装方式是否合适，只需问三个问题：电脑是否已有 Node.js 或 Homebrew，终端是否允许执行官方脚本，是否需要手动管理升级目录。选完一条路径执行到底，并用 codex 和登录选项完成验证，比同时保留多套安装方式更容易排查问题。
参考来源
评论区
登录后可评论。