Codex 配置第三方 API 指南

教程
834 词

1. 配置文件位置

Codex 默认配置目录：

  • Windows：C:\Users\你的用户名\.codex\config.toml
  • macOS / Linux：~/.codex/config.toml

Codex 默认授权文件目录：

  • Windows：C:\Users\你的用户名\.codex\auth.json
  • macOS / Linux：~/.codex/auth.json

auth.json 填写 API Key 的格式示例：

1
2
3
{
  "OPENAI_API_KEY": "your_api_key"
}

如果你已经在用 Codex，建议先备份当前配置，再修改。

2. 核心思路与配置示例

Codex 的做法很简单：

  1. 先定义一个 provider（第三方 API 或本地中转的地址与鉴权方式）
  2. 再把 model_provider 指向这个 provider 名称

把下面内容放到 config.toml（或合并到你现有配置）即可：

第三方网关和本地中转本质上是同一套配置，只需要改 base_url：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
model = "gpt-5.3-codex"
model_reasoning_effort = "high"

# 选择当前启用的提供方名称（要和下面的段名一致）
model_provider = "proxy"

[model_providers.proxy]
# 提供方显示名称（可选）
name = "My Proxy"

# 链接示例（通常以 /v1 结尾）
base_url = "https://api.example.com/v1"

# 使用 OpenAI 认证（登录态或 OPENAI_API_KEY）
requires_openai_auth = true

# 接口协议类型（常用 responses）
wire_api = "responses"
留言