这一页只讲怎么把 Codex CLI 装到电脑上。装完请回到 Codex CLI 配置 填写网关地址和 Key。

安装

macOS / Linux

打开终端，粘贴回车：

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

Windows（PowerShell）

按 Win 键搜索「PowerShell」打开，粘贴回车：

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

关于 -ExecutionPolicy ByPass

这是为了让 PowerShell 允许执行这个安装脚本。它只对这一次命令生效，不会永久降低你系统的安全设置。

其他安装方式

方式	命令	适合
Homebrew	brew install --cask codex	macOS 上习惯用 brew
npm	npm install -g @openai/codex	已有 Node.js 环境
直接下二进制	见下方	上面几种都不行时

如果官方安装脚本下载失败

chatgpt.com 在某些网络环境下会被拦截，报 403 或直接卡住。这不是你的问题，换下面任意一种方式：

方式一：npm（最省事，只要能装 Node.js）

npm install -g @openai/codex

方式二：直接下二进制

到 GitHub Releases 下载对应系统的包，解压后把可执行文件改名为 codex 放进 PATH：

系统	下载哪个
macOS（Apple 芯片）	codex-aarch64-apple-darwin.tar.gz
macOS（Intel）	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

GitHub 也可能慢

如果 GitHub 下载也慢，npm 方式通常最稳（国内有镜像源）。

不要用 sudo 装 npm 包

sudo npm install -g 会带来权限问题。遇到权限报错应该去修 npm 全局目录，而不是加 sudo。

验证装好了

codex --version

能打印出版本号就成功了。

⚠️ 关于「登录 ChatGPT 账号」

第一次运行 codex 时，它会引导你登录 ChatGPT 账号（Sign in with ChatGPT）。

接到我们这里之后不需要登录。

但要先把配置文件写好——Codex CLI 配置里的 model_provider 和 env_key 设好之后，它会用你的 API Key 走我们的网关，不再要求 ChatGPT 登录。

顺序很重要

先写配置，再运行 codex。 如果你先跑了 codex 并进了登录流程，它会打开浏览器让你登录 ChatGPT——那不是我们想要的。直接 Ctrl+C 退出，把配置写好再重来即可。

装不上的常见原因

报错	原因	怎么办
command not found: codex	安装目录不在 PATH 里	关掉终端重新开一个；还不行就重启
安装脚本返回 403	chatgpt.com 被你的网络拦截	改用 npm 或直接下二进制，见上方「如果官方安装脚本下载失败」
脚本下载失败 / 超时	网络原因	挂代理重试，或改用 npm
ExecutionPolicy 相关报错	用了 CMD 而不是 PowerShell	用 Win 键搜「PowerShell」打开正确的窗口
npm 装完但 codex 命令找不到	npm 全局 bin 目录不在 PATH	用 npm bin -g 查到路径后加进 PATH

装完下一步

回到 Codex CLI 配置，把 ~/.codex/config.toml 写好。

再提醒一次两个最容易错的点：

1. Base URL 是 https://api.wxiai.com/v1（要带 /v1，和 Claude Code 相反）
2. 配置必须放在用户级 ~/.codex/config.toml，放项目里会被忽略

相关页

• Codex CLI 配置 —— 写 config.toml
• 响应生成 —— Codex 走的就是这个接口