Codex 接入 CodingPlanX 自定义模型

使用 CodingPlanX.ai API 密钥配置 OpenAI Codex CLI

Codex 集成配置指南

CodingPlanX.ai 不仅支持 Claude Code，还支持 OpenAI Codex CLI。购买套餐后，Claude Code 与 Codex 共享套餐配额，让你可以灵活选择使用哪个工具。

安装 Codex CLI

npm install -g @openai/codex

验证安装：

codex --version

最新版本：v0.114.0（2026-03-11），支持 Skills 系统、Hooks 引擎等新功能。

可用模型

通过 CodingPlanX.ai 可使用以下 Codex/GPT 模型：

所有模型与 Claude Code 共享 CodingPlanX.ai 套餐配额。

配置概述

Codex CLI 需要配置两个文件：

• ~/.codex/config.toml - 服务配置
• ~/.codex/auth.json - 认证配置

---

Windows 配置

步骤 1：创建配置目录

mkdir %HOMEPATH%\.codex

步骤 2：创建 config.toml

在 ~/.codex/config.toml 创建配置文件：

model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

步骤 3：创建 auth.json

在 ~/.codex/auth.json 创建认证文件：

{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}

将 cr_xxxxxxxxxx 替换为你的 CodingPlanX.ai API 密钥。

步骤 4：设置环境变量（可选）

如果你更喜欢通过环境变量提供密钥：

# 临时设置
$env:CRS_OAI_KEY = "cr_xxxxxxxxxx"

# 永久设置
[System.Environment]::SetEnvironmentVariable("CRS_OAI_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)

然后将 auth.json 中的 OPENAI_API_KEY 设为 null。

---

macOS 配置

步骤 1：创建配置目录

mkdir -p ~/.codex

步骤 2：创建 config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

步骤 3：创建 auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

将 cr_xxxxxxxxxx 替换为你的 CodingPlanX.ai API 密钥。

步骤 4：设置环境变量（可选）

如果你更喜欢通过环境变量提供密钥：

# 临时设置
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# 永久设置
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

然后将 auth.json 中的 OPENAI_API_KEY 设为 null。

---

Linux 配置

步骤 1：创建配置目录

mkdir -p ~/.codex

步骤 2：创建 config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

步骤 3：创建 auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

将 cr_xxxxxxxxxx 替换为你的 CodingPlanX.ai API 密钥。

步骤 4：设置环境变量（可选）

如果你更喜欢通过环境变量提供密钥：

# 临时设置
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# 永久设置（Bash）
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

# 永久设置（Zsh）
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

然后将 auth.json 中的 OPENAI_API_KEY 设为 null。

---

验证配置

配置完成后，运行 Codex CLI 验证：

codex

成功标识

• Codex 可以正常启动并连接到服务
• 可以正常生成代码和获得 AI 响应
• 网络请求通过 CodingPlanX.ai 代理服务

常见问题

配置文件未找到

问题：Codex 提示找不到配置文件

解决：

1. 检查配置文件路径是否正确
2. 确认 ~/.codex/ 目录存在
3. 确认 config.toml 和 auth.json 文件存在

API 密钥认证失败

问题：环境变量无效或 API 密钥错误

解决：

1. 检查环境变量 CRS_OAI_KEY 是否正确设置
2. 验证 API 密钥格式是否正确（cr_ 开头）
3. 确认密钥未过期，访问 控制台 验证

网络连接问题

问题：无法连接到 CodingPlanX.ai 服务

解决：

1. 检查网络连接是否正常
2. 验证 base_url 配置是否为 https://api.codingplanx.ai