首页 / CLI 与终端 / 安装 Codex CLI

Codex CLI 可以通过 npm、Homebrew、官方脚本或 GitHub Release 安装。日常推荐 npm 或 Homebrew。

安装 Codex CLI

CLI 适合 SSH、远程开发机、CI 和重度终端用户。下面四种方式按使用频率排序。

1. npm 全局安装

npm i -g @openai/codex
codex --version

需要本机有 Node.js。Node 版本要求请查 GitHub README。

2. Homebrew

brew install codex

历史版本曾用 brew install --cask codex，最终以官方文档为准。

3. 官方安装脚本

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

Windows PowerShell：

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

4. GitHub Release 二进制

适合离线环境、固定版本、CI 镜像。从 GitHub Release 下载对应平台二进制并放进 PATH。

更新 CLI

npm i -g @openai/codex@latest
codex --version

常见安装问题

  • PATH 未配置：检查 which codex 或 where codex。
  • npm 全局权限：避免直接 sudo，建议改 npm prefix 或使用 nvm。
  • 公司网络代理：设置 HTTPS_PROXY、npm config set proxy。
  • Windows 原生与 WSL2 取舍：自动化和 Linux 工具优先 WSL2。