OpenAI Codex CLI 配置教程
通过 YourAgent 使用 Codex 5.3/5.2 High，省 96%

⏱️ 预计 10 分钟 🖥️ Windows / macOS / Linux 📅 更新于 2026-03-05

💡 官方价格 $100 → YourAgent 仅需 $4（等值 5000 万 Tokens，省 96%）

📋 前置要求

YourAgent API Key（以 sk- 开头）— 联系管理员获取
Node.js 22+（注意：不是 18+，必须是 22 或更高）

⚠️ 注意：Codex CLI 要求 Node.js 22+，比 Claude Code 要求更高。请确认你的 Node.js 版本：node --version

1安装 Node.js 22+

# Homebrew（推荐）
brew install node@22

# 或 nvm
nvm install 22
nvm use 22

从 nodejs.org 下载 Current 版本（22.x+），双击安装。

# 或 WinGet
winget install OpenJS.NodeJS

# 或 nvm-windows
nvm install 22
nvm use 22

# nvm（推荐）
nvm install 22
nvm use 22

# 或包管理器
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

验证版本：

node --version
# 应显示 v22.x.x 或更高

2安装 Codex CLI

npm install -g @openai/codex

验证安装：

codex --version

3设置 API Key 环境变量

# 编辑 ~/.zshrc（或 ~/.bashrc）
echo 'export CRS_OAI_KEY=sk-xxx' >> ~/.zshrc
source ~/.zshrc

# PowerShell（管理员）
[System.Environment]::SetEnvironmentVariable("CRS_OAI_KEY", "sk-xxx", "User")

设置后重新打开终端生效。

4创建配置文件

config.toml

一键创建（macOS / Linux）：

mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model = "codex-5.3"
model_provider = "crs"

[model_providers.crs]
name = "crs"
base_url = "https://your-agent.cc/api/v1"
wire_api = "responses"
requires_openai_auth = false
env_key = "CRS_OAI_KEY"
EOF

auth.json

禁用默认的 OpenAI 认证：

cat > ~/.codex/auth.json << 'EOF'
{
  "openai_api_key": null
}
EOF

💡 说明：auth.json 中设置为 null 是为了禁用默认的 OpenAI 认证，让 Codex 使用 config.toml 中配置的 env_key 来获取 API 密钥。

5启动 Codex

# 进入项目目录
cd ~/your-project

# 启动 Codex
codex

# 指定模型
codex --model codex-5.3

# 全自动模式
codex --approval-mode full-auto

🎛️ 运行模式

Suggest（默认）— 只建议修改，不执行。适合初次使用
Auto Edit— 自动编辑文件，命令需确认。适合日常开发
Full Auto— 全自动执行所有操作。适合测试项目

❓ 常见问题

Q: Node.js 版本不够？

Codex 严格要求 22+，运行 nvm install 22 && nvm use 22 升级。

Q: 提示认证错误？

检查 ~/.codex/auth.json 是否设置了 "openai_api_key": null，以及 CRS_OAI_KEY 环境变量是否正确。

OpenAI Codex CLI 配置教程通过 YourAgent 使用 Codex 5.3/5.2 High，省 96%