Codex 配置第三方 API：config.toml 与 auth.json 完整教程

准备：拿到 OpenAI 分组的 API Key

先在 GPT.COM.SE 注册并新建一把「OpenAI」分组的 API Key，Codex 靠它调用模型。API Key 是一串以 sk- 开头的密钥，相当于账号的调用密码；分组决定这把 Key 能调哪类模型。

1. 打开 注册页，用邮箱注册，收验证码完成登录。用纯数字 QQ 邮箱（如 123456789@qq.com）注册的新用户送 5 美元体验额度，英文别名的 QQ 邮箱不送，活动仅限中国用户。
2. 体验额度用完后到「充值」页面充值，支持微信、支付宝。充值 1 元人民币得 1 美元站内额度，按量计费，用多少扣多少。
3. 进「API 密钥」页面点新建，分组选「OpenAI」。复制出来的 sk-xxxxxxxx 就是你的 Key。

第一步：安装 Codex

在终端运行 npm i -g @openai/codex 就能装好 Codex。npm 是 Node.js 自带的安装工具，所以要先装 Node.js，建议 22 及以上版本。

macOS、Linux、WSL2 安装 Node.js

curl -fsSL https://fnm.vercel.app/install | bash
fnm install 22
fnm use 22
node -v   # 看到 v22.x.x 就对了

Windows 安装 Node.js

到 Node.js 下载页下载 LTS 22.x，一路下一步；装完打开 PowerShell 输入 node -v 验证。建议装 WSL2：在 PowerShell 里运行 wsl --install，重启后在 Ubuntu 里操作，体验接近 Mac。

安装 Codex

npm i -g @openai/codex

配置目录：Mac 和 Linux 是 ~/.codex，Windows 是 %USERPROFILE%\.codex。目录里没有 config.toml 和 auth.json 就手动新建。

第二步：编辑 config.toml（base_url 与 wire_api）

把下面这段原样写进 ~/.codex/config.toml，最关键的是 base_url = "https://gpt.com.se" 和 wire_api = "responses" 两行。config.toml 是 Codex 的配置文件，大部分行是「名称 = 值」的格式，方括号那一行开始一段接口配置。

model_provider = "gptse"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"

[model_providers.gptse]
name = "GPT.COM.SE"
base_url = "https://gpt.com.se"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

Base URL 就是接口地址，Codex 把请求发到这里。Codex 填不带 /v1 的根地址 https://gpt.com.se，它会自己拼接后面的路径；Cursor、Cherry Studio、OpenAI SDK 等工具填带 /v1 的 https://gpt.com.se/v1。两种地址别混用，填错会报 404 或连不上。

第三步：编辑 auth.json（填 Key）

在 ~/.codex/auth.json 里填入你的 Key，字段名必须是 OPENAI_API_KEY。

{
  "OPENAI_API_KEY": "sk-你的Key"
}

把 sk-你的Key 换成控制台复制的完整 Key，前后不要留空格。改完后桌面端重启会自动读新配置；命令行版进入项目目录直接运行 codex。

• config.toml 里 base_url 是 https://gpt.com.se，末尾没有 /v1。
• config.toml 里 wire_api 是 responses。
• auth.json 里的 Key 属于「OpenAI」分组，账户里还有余额。
• 改完配置后，桌面端已重启，命令行版已重开终端。

换模型：Codex 自定义模型怎么填

换模型只改 config.toml 里的 model 一行，模型名按下表原样填写。比如想用 GPT-6 旗舰，就把那一行改成：

model = "gpt-6-astra"

token 是模型计量文字的单位，输入和输出都按 token 数计费；缓存读指重复发送的相同内容命中缓存的部分，单价更低。上下文是模型一次能读进去的内容总量，gpt-6-astra 的上下文是 1.05M token。

怎么选：写代码、跑 Agent 优先 gpt-6-astra；Codex 日常用 gpt-5.5；想用最新一代 GPT-5.6 填 gpt-5.6-sol；跑量大又简单的活用 gpt-5.6-luna 省钱。本站暂未提供 gpt-6-luna 和 gpt-6.1-sol，填这两个名字会直接报错。更多型号对比见 全部 GPT 模型与选型。

费用算例：一次 Codex 任务花多少钱

按本站实付价算，假设一次任务读入 20 万 token（其中 15 万命中缓存）、输出 2 万 token，各模型的花费如下。

算法：用量（百万 token）乘以单价，三项相加。实际 token 数以控制台用量明细为准，完整价格见 GPT API 价格。

Codex 接入第三方 API 常见报错排查表

Codex 报错先对照状态码：401 查 Key 和分组，404 查 base_url，403 查余额，下表逐条给出处理方法。

怎么确认 Codex 调用的就是你选的模型

看控制台的用量明细：每次调用都记录模型名、token 数和费用，和 config.toml 里的 model 对一下就清楚。

本站不做模型替换，用户请求哪个模型就调用哪个模型，缺货时直接报错。扣费按 OpenAI 官方美元标价，明细里的费用可以用上面的价格表自己核算。更多自检方法见 不替换模型与自检方法。