安装教程

指导你在 Windows、macOS 与 Linux 上安装 Node.js 与 Codex CLI，并正确配置环境变量。

Windows 安装步骤

1. 安装 Node.js

推荐从 nodejs.org 下载 LTS 版本（.msi 安装包），按向导安装。

安装完成后，打开 PowerShell 检查版本：

node -v
npm -v

2. 安装 Codex CLI

使用 npm 全局安装：

npm install -g @openai/codex

验证安装：

codex --version

3. 配置环境变量

若你使用 OpenAI API Key 计费（可选），请设置 OPENAI_API_KEY：

$env:OPENAI_API_KEY = "你的API密钥"  # 当前会话有效
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY","你的API密钥","User")  # 永久生效（用户级）

如果 codex 命令未找到，请确认 npm 全局路径已加入 PATH。默认位于 %AppData%\\npm 或 C:\\Users\\<用户名>\\AppData\\Roaming\\npm。

4. 登录或使用 API Key

运行：

codex

选择 “Sign in with ChatGPT”。若不使用账号，也可直接用 API Key 运行。

macOS 安装步骤

1. 安装 Node.js

推荐使用 Homebrew 安装：

brew install node

或前往 nodejs.org 下载 LTS 安装包。

node -v
npm -v

2. 安装 Codex CLI

npm install -g @openai/codex  # 或 brew install codex

codex --version

3. 配置环境变量

使用 API Key 计费（可选）：将以下内容加入 Shell 配置（以 zsh 为例）：

echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

若提示 codex: command not found，请确认 npm 全局目录在 PATH 中：npm config get prefix 通常是 /opt/homebrew 或 /usr/local 下的 /bin。

4. 登录或使用 API Key

codex

选择 ChatGPT 登录，或直接使用 API Key。

Linux 安装步骤

1. 安装 Node.js

使用发行版包管理器或 nvm：

# Debian/Ubuntu
sudo apt-get update && sudo apt-get install -y nodejs npm
# 或使用 nvm（推荐可控版本）
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc  # 或 ~/.zshrc
nvm install --lts
node -v && npm -v

2. 安装 Codex CLI

npm install -g @openai/codex

codex --version

3. 配置环境变量

如果使用 API Key 计费（可选），将密钥写入 Shell 配置：

echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

4. 登录或使用 API Key

codex

选择 ChatGPT 登录，或直接使用 API Key。

小贴士：若你在服务器或无图形界面的环境登录，可通过 SSH 端口转发完成浏览器登录：

ssh -L 1455:localhost:1455 <user>@<remote-host>