安装教程
指导你在 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>