Codex

Codex 适合代码生成、仓库分析、自动化修改和命令行工作流。XNova 的 OpenAI 分组支持 Codex 使用的 Responses 格式（/v1/responses）。

如果你用的是 Codex 桌面应用，想用图形界面切换供应商，可以看 Codex++。

选择分组

创建 API Key 时选择 OpenAI 分组，例如「ChatGPT Pro」或「ChatGPT 特惠 Pro」。各分组倍率以创建 Key 页面显示为准。

配置 config.toml

编辑 ~/.codex/config.toml（Windows 在 %USERPROFILE%\.codex\config.toml）：

toml

model = "gpt-6.1-sol"
model_provider = "xnova"

[model_providers.xnova]
name = "XNova"
base_url = "https://api.xnova.online/v1"
env_key = "XNOVA_API_KEY"
wire_api = "responses"

然后把 Key 放进环境变量：

bash

export XNOVA_API_KEY="sk-你的XNova密钥"
codex

Windows PowerShell 用 $env:XNOVA_API_KEY = "sk-你的XNova密钥"。

常用模型

txt

gpt-6.1-sol
gpt-6-astra
gpt-6-sol
gpt-5.6-sol

模型名需要和主站模型广场一致。

验证

bash

curl https://api.xnova.online/v1/models \
  -H "Authorization: Bearer sk-你的XNova密钥"

排查

模型不存在：同步模型列表，或手动填写正确的模型名。
401：检查环境变量名是否和 env_key 一致，Key 是否完整；仍不行就重新创建一个 Key。
请求慢：换用海外优化节点 https://cf-api.xnova.online/v1，并检查客户端超时设置。

Codex ​

选择分组 ​

配置 config.toml ​

常用模型 ​

验证 ​

排查 ​

Codex

选择分组

配置 config.toml

常用模型

验证

排查