Codex CLI 零基础安装与使用

1. 按 Win + X。
2. 打开终端或Windows PowerShell。
3. 运行下面的安装命令。

winget install OpenJS.NodeJS.LTS

安装结束后关闭终端并重新打开，然后验证：

node --version
npm --version

两条命令都显示版本号就说明成功。没有 winget 时，请从 Node.js 官网下载 LTS 安装包并保持默认选项。

刚入门时使用上面的 PowerShell 方式最简单。项目已经放在 Linux 环境中时，可以用管理员 PowerShell 安装 WSL2：

wsl --install

完成后重启电脑，打开 Ubuntu，再按照下面的 Linux 步骤操作。Windows 的 C 盘在 WSL 中通常位于 /mnt/c/。

打开终端 Terminal。先按 Homebrew 官网说明安装 Homebrew，再运行：

brew install node
node --version
npm --version

sudo apt update
sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node --version
npm --version

最后两条命令都显示版本号即可继续。

[Environment]::SetEnvironmentVariable("ALIVEAI_API_KEY", "sk-你的令牌", "User")
$env:ALIVEAI_API_KEY = "sk-你的令牌"

第一行让以后新开的终端也能读取令牌；第二行让当前窗口立即生效。

echo 'export ALIVEAI_API_KEY="sk-你的令牌"' >> ~/.zshrc
source ~/.zshrc

echo 'export ALIVEAI_API_KEY="sk-你的令牌"' >> ~/.bashrc
source ~/.bashrc

在 PowerShell 中运行：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"

记事本打开后，粘贴下面内容并按 Ctrl + S：

[model_providers.aliveai]
name = "AliveAI"
base_url = "https://api.aliveai.asia/v1"
env_key = "ALIVEAI_API_KEY"
wire_api = "responses"

关闭记事本，再打开第二个文件：

notepad "$env:USERPROFILE\.codex\aliveai.config.toml"

粘贴并保存：

model_provider = "aliveai"
model = "gpt-5.4"
model_reasoning_effort = "high"

mkdir -p ~/.codex
touch ~/.codex/config.toml ~/.codex/aliveai.config.toml
open -e ~/.codex/config.toml

在第一个文件中粘贴：

[model_providers.aliveai]
name = "AliveAI"
base_url = "https://api.aliveai.asia/v1"
env_key = "ALIVEAI_API_KEY"
wire_api = "responses"

保存后打开第二个文件：

open -e ~/.codex/aliveai.config.toml

粘贴并保存：

model_provider = "aliveai"
model = "gpt-5.4"
model_reasoning_effort = "high"

mkdir -p ~/.codex
nano ~/.codex/config.toml

粘贴主配置：

[model_providers.aliveai]
name = "AliveAI"
base_url = "https://api.aliveai.asia/v1"
env_key = "ALIVEAI_API_KEY"
wire_api = "responses"

按 Ctrl + O、Enter 保存，按 Ctrl + X 退出。再运行：

nano ~/.codex/aliveai.config.toml

粘贴下面内容，用相同方式保存：

model_provider = "aliveai"
model = "gpt-5.4"
model_reasoning_effort = "high"

Node.js 没安装成功，或者安装后没有重新打开终端。关闭所有终端，重新打开后检查：

node --version
npm --version

仍然失败时重新安装 Node.js LTS。

先确认 npm 全局安装位置和 Codex 包：

npm config get prefix
npm list --global @openai/codex

Windows 可以尝试：

codex.cmd --version

如果 codex.cmd 能运行，但 codex 被 PowerShell 的脚本策略拦截，可以设置当前用户范围的执行策略：

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

关闭并重新打开 PowerShell 后再试。

不要输出完整 Key，只检查当前终端是否读取到环境变量。

PowerShell：

if ($env:ALIVEAI_API_KEY) { "已读取 API Key，长度：$($env:ALIVEAI_API_KEY.Length)" } else { "未读取 API Key" }

macOS / Linux：

if [ -n "$ALIVEAI_API_KEY" ]; then echo "已读取 API Key"; else echo "未读取 API Key"; fi

如果未读取，重新执行第 4 步并新开终端。令牌已经泄露时，在控制台删除旧令牌并创建新的。

打开控制台查看账户可用模型，把 aliveai.config.toml 中的模型改成实际可用名称，保存后重新启动 Codex：

model = "gpt-5.4"

检查 config.toml 中的两项：

base_url = "https://api.aliveai.asia/v1"
wire_api = "responses"

地址末尾要有 /v1，协议是 https，wire_api 是 responses。

持久环境变量只会自动进入新开的程序。关闭所有 Codex 和终端窗口，重新打开终端后再测试。

• 使用英文半角双引号，不要使用中文引号。
• 每个配置项单独占一行。
• 文件后缀是 .toml，不是 .toml.txt。
• config.toml 中不要保留旧的 [profiles.aliveai]。
• 运行 codex doctor 查看详细诊断。

先在浏览器打开 AliveAI 控制台。网页也打不开时检查本地网络、代理或防火墙；网页正常但 Codex 仍超时时，稍后重试并保留错误时间和请求 ID。