GetCheapAI

在 Codex 中使用 API 中转站

通过 ~/.codex/config.toml 配置自定义模型提供方。

2 分钟阅读

Codex CLI 在启动时读取 ~/.codex/config.toml。通过自定义「模型提供方（model provider）」，可以让 Codex 连接到兼容 OpenAI 接口的 API 中转站。

准备信息

从你使用的 API 平台获取以下信息：

  • API 地址（Base URL）：平台提供的接口根地址，通常以 /v1 结尾
  • API 密钥（Key）：用于鉴权的令牌
  • 模型名称：平台支持、且你打算使用的模型标识

配置 config.toml

编辑 ~/.codex/config.toml，添加一个自定义提供方并将其设为默认：

model = "your-model-name"        # 替换为平台支持的模型名
model_provider = "thirdparty"    # 自定义提供方标识，可自取（勿用 openai/ollama/lmstudio）

[model_providers.thirdparty]
name = "Third-party API"
base_url = "https://example.com/v1"   # 替换为平台提供的 API 地址
env_key = "THIRDPARTY_API_KEY"        # 读取密钥的环境变量名
wire_api = "chat"                      # 第三方兼容端点通常使用 chat

env_key 指定的是「存放密钥的环境变量名」，而不是密钥本身。请在终端中导出该变量：

export THIRDPARTY_API_KEY="your-key"

常见问题

  • 密钥校验失败：若平台密钥前缀与 OpenAI 不同而被拒绝，可在该提供方配置下加入 requires_openai_auth = false。
  • 协议选择：第三方兼容端点一般使用 wire_api = "chat"（对应 /chat/completions）。
  • 不要把密钥写进 config.toml：用 env_key 指向环境变量，避免密钥随配置文件泄露。
  • 仅临时改用：如只想临时更改地址，可设置环境变量 OPENAI_BASE_URL 覆盖当前会话。