Codex CLI 配置教程

Codex CLI 是 OpenAI 官方推出的命令行 AI 编程助手。本教程将指导您如何配置 Codex CLI 使用 XueXin API。

💡 前提条件

确保您已经在 XueXin 控制台注册账号并获取了 API Key，且您的套餐包含 GPT 系列模型。

选择您的操作系统

安装 Node.js

Codex CLI 需要 Node.js 22 或更高版本。

方式一：官网下载

访问 nodejs.org 下载 LTS 版本安装包。

方式二：使用 winget

powershellwinget install OpenJS.NodeJS.LTS

安装 Codex CLI

powershellnpm install -g @openai/codex

配置环境变量

在 PowerShell 中设置环境变量：

powershell# 临时设置（当前会话有效）
$env:OPENAI_API_KEY = "你的API密钥"
$env:OPENAI_BASE_URL = "https://api.xuexin.xyz/v1"

# 永久设置（需要管理员权限）
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的API密钥", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.xuexin.xyz/v1", "User")

启动 Codex

powershellcodex

安装 Node.js

方式一：使用 Homebrew（推荐）

bashbrew install node@22

方式二：使用 nvm

bashcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22

安装 Codex CLI

bashnpm install -g @openai/codex

配置环境变量

编辑 ~/.zshrc 或 ~/.bashrc：

bashexport OPENAI_API_KEY="你的API密钥"
export OPENAI_BASE_URL="https://api.xuexin.xyz/v1"

使配置生效：

bashsource ~/.zshrc

启动 Codex

bashcodex

安装 Node.js

Ubuntu/Debian：

bashcurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL：

bashcurl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install -y nodejs

安装 Codex CLI

bashnpm install -g @openai/codex

配置环境变量

编辑 ~/.bashrc 或 ~/.zshrc：

bashexport OPENAI_API_KEY="你的API密钥"
export OPENAI_BASE_URL="https://api.xuexin.xyz/v1"

使配置生效：

bashsource ~/.bashrc

启动 Codex

bashcodex

⚠️ 重要

请将 你的API密钥 替换为您在 XueXin 控制台获取的真实 API Key（格式：sk-xxxx）。

可用模型

XueXin 的 GPT Pack 包含以下 Codex 专用模型：

gpt-5.4 - 最新的 GPT-5.4 模型
gpt-5.4-mini - 轻量版，速度更快
gpt-5.3-codex - Codex 专用模型
gpt-5.2-codex - Codex 专用模型
gpt-5.1-codex-max - Codex 高性能版
gpt-5.1-codex-mini - Codex 轻量版

常见问题

Q: 出现 "Invalid API Key" 错误

请检查：

API Key 格式是否正确（以 sk- 开头）
环境变量是否正确设置（运行 echo $OPENAI_API_KEY 确认）
Base URL 是否正确（应为 https://api.xuexin.xyz/v1）

Q: 出现 "model not found" 错误

您的套餐可能不包含 GPT 模型。请前往控制台查看您的套餐，或联系客服获取 GPT Pack。

Q: 如何切换模型？

在 Codex 交互界面中输入 /model gpt-5.3-codex 即可切换模型。