Codex 下载与安装教学
OpenAI Codex CLI 在 Windows、macOS、Linux 上的完整安装、登录与更新流程。
Codex CLI 是 OpenAI 官方的命令行编程助手，直接跑在你自己的终端里，可以读代码、改代码、执行命令。它支持 Windows、macOS、Linux 三个平台，安装方式主要有三种：官方安装脚本、npm 全局安装、Homebrew（仅 macOS）。
本文把三种方式和三个平台都写清楚，你按自己的环境挑一种即可，不用全装。
一、准备工作
- 需要一个 OpenAI 账号。登录方式二选一：ChatGPT 账号（Plus / Pro / Team / Edu / Enterprise 套餐）或 OpenAI API Key。
- 如果走 npm 方式安装，需要先装好 Node.js 18 或更高版本。其它两种方式不依赖 Node.js。
- 确认网络能正常访问 OpenAI 相关地址。
检查 Node.js 是否装好（走 npm 方式才需要）：
node -v
npm -v能打印出版本号就没问题。
二、安装 Codex CLI
⚠️ 常见坑：npm 安装时包名一定要带
@openai/前缀，写成npm i -g codex（少了前缀）会装到一个完全无关的包。请照下面的命令原样复制。
方式 1：官方安装脚本（推荐，不依赖 Node.js）
macOS / Linux，在终端执行：
curl -fsSL https://chatgpt.com/codex/install.sh | shWindows，用 PowerShell 执行：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"方式 2：npm 全局安装（三平台通用）
装好 Node.js 18+ 后，任意平台执行：
npm install -g @openai/codexWindows 上用 npm 安装偶尔会遇到运行时报错
Missing optional dependency @openai/codex-win32-x64。如果碰到，建议改用上面的官方安装脚本，或直接下载 GitHub Release 二进制。
方式 3：Homebrew（仅 macOS）
brew install --cask codex注意 --cask 不能省，它装的是预编译好的程序包，而不是从源码编译。
方式 4：GitHub Release 二进制（手动，进阶）
如果上面的方式都不方便，可以到 Codex 的 GitHub Release 页面，按平台下载对应压缩包：
| 平台 | 文件名 |
|---|---|
| macOS Apple 芯片（arm64） | codex-aarch64-apple-darwin.tar.gz |
| macOS Intel 芯片（x86_64） | codex-x86_64-apple-darwin.tar.gz |
| Linux x86_64 | codex-x86_64-unknown-linux-musl.tar.gz |
| Linux arm64 | codex-aarch64-unknown-linux-musl.tar.gz |
解压后里面是一个带平台后缀的可执行文件（如 codex-x86_64-unknown-linux-musl），把它重命名为 codex，再放到系统 PATH 目录里即可。
三、验证安装
打开一个新的终端窗口（让 PATH 生效），执行：
codex --version能看到版本号，就说明装成功了。
四、首次登录
在项目目录里直接运行：
codex第一次启动会进入交互式界面并提示登录，按提示二选一：
- 用 ChatGPT 账号登录：会打开浏览器完成授权，适合有 Plus / Pro / Team 等套餐的用户。
- 用 OpenAI API Key：适合走 API 计费的用户，把 Key 填进去即可。
登录一次之后，之后再运行 codex 就不用重复登录了。
五、更新与卸载
推荐用内置的自更新命令：
codex update或者按你当初的安装渠道来更新（同一台机器建议只用一种渠道，别混着来）：
# npm 渠道
npm update -g @openai/codex
# Homebrew 渠道
brew upgrade --cask codex六、常见问题
codex: command not found（命令找不到）
多半是安装本身成功了，只是 npm 的全局 bin 目录没加进 PATH。解决办法：先关掉再重开一个终端；如果还不行，把 npm 全局 bin 目录（npm bin -g 能看到路径）加进系统环境变量 PATH，或者干脆改用官方安装脚本。
Windows 上 npm 装完运行报缺少依赖
见上文，改用官方安装脚本或 GitHub Release 二进制更稳。Windows 也可以用 WSL2 跑一个 Linux 环境，再在里面用脚本安装。
PowerShell 提示脚本被禁止执行
上面的安装命令已经带了 -ExecutionPolicy ByPass，一般不会拦。如果是手动跑其它脚本被拦，可以先执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser