单元二和 AI 第一次合作 · 第 5 课

安装 Codex

Codex 是这门课的主线工具。这一课只做一件事：把它装好，并且确认终端能找到它。

本课目标

在终端里安装软件，通常就是运行一条命令：它从网上下载安装脚本，再由脚本把程序放到合适的位置，并加进 PATH（第 4 课讲过）。

安装命令要从官方网站复制。不要运行来路不明的安装命令，它和来路不明的安装包一样危险。本页的命令来自 OpenAI 官方的 Codex 安装说明。

Codex 也有桌面 App，但这门课统一使用终端里的 Codex（也叫 Codex CLI），因为后面登录云主机时，你面对的也只有终端。

打开 PowerShell（提示符以 PS 开头），粘贴下面这行，回车：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

打开终端，粘贴下面这行，回车：

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

安装结束后，关掉终端，重新打开一个，然后输入：

codex --version

终端显示一行版本号，类似：

codex-cli 0.160.0

数字不一样没关系，能显示版本号就说明安装成功了。

先不要直接运行 codex。还没告诉它用哪个 API 地址和 Key，它会让你登录 ChatGPT 账号。下一课再配置。如果已经运行了，按 Ctrl + C 退出即可。

安装命令需要访问 chatgpt.com。如果长时间没反应，或者报“无法连接”“超时”之类的错误，可以改用 npm 安装。npm 是 Node.js 自带的软件下载工具，国内可以用镜像加速。

第一步：安装 Node.js。 打开 Node.js 官网下载页，下载 LTS（长期支持）版的安装包，一路“下一步”装好。Windows 也可以在 PowerShell 里运行：

winget install --id OpenJS.NodeJS.LTS -e

装好后重开终端，输入 node --version，能看到版本号即可。

第二步：Windows 用户先允许运行脚本。 npm 在 PowerShell 里是以脚本形式运行的，而 Windows 默认禁止运行脚本，会报“因为在此系统上禁止运行脚本”。运行下面这行，看到提示后输入 Y 回车：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

这个设置只对你自己的账号生效，允许运行本机脚本和有签名的网上脚本，是微软推荐的常用设置。

第三步：用国内镜像安装 Codex。

npm install -g @openai/codex --registry=https://registry.npmmirror.com

装好后同样重开终端，运行 codex --version 检查。

提示“找不到命令”？ 先关掉终端重新打开。还不行，按第 4 课“找不到命令怎么办”的步骤排查。

提示“拒绝访问”“需要管理员权限”？ 官方安装命令不需要管理员权限。安装 Node.js 时，系统弹窗要求确认或输入开机密码是正常的。如果是在公司电脑上安装，公司的安全软件可能会拦截。

macOS 上 npm 安装报 EACCES 权限错误？ 这是因为 npm 默认把全局软件装到系统目录。不要加 sudo，改成装到你自己的目录：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc

然后重开终端，再运行一次 npm 安装命令。

以后怎么升级？ 用哪种方式装的，就用哪种方式再装一遍：重新运行安装命令，或者再运行一次 npm install -g @openai/codex。

想了解 Codex 的更多入口和用法，可以看 Codex 专题。这门课里你只需要跟着做。