在 Codex 中配置自定义 API 地址

Codex CLI 可以通过自定义模型提供方连接兼容 OpenAI 的接口。配置字段会随 Codex 版本变化，使用前请同时核对官方配置参考。

准备信息

准备服务商提供的 Base URL、API 密钥和模型 ID。兼容 OpenAI 的服务通常要求 Base URL 包含 /v1，但最终以服务商文档为准。

配置 config.toml

编辑 ~/.codex/config.toml，添加一个自定义提供方：

model = "your-model-name"
model_provider = "thirdparty"

[model_providers.thirdparty]
name = "Third-party API"
base_url = "https://example.com/v1"
env_key = "THIRDPARTY_API_KEY"
wire_api = "chat"

env_key 是环境变量名，不是密钥本身。密钥应在终端或本地密钥管理工具中提供：

export THIRDPARTY_API_KEY="your-key"

不要把真实密钥写进 config.toml，也不要把该文件上传到公共仓库。

常见问题

• 密钥校验失败：确认服务商的认证方式和 Codex 的提供方设置是否匹配。
• 协议选择：第三方兼容端点可能要求 chat completions 或其他 wire API，按服务商文档选择。
• 模型不存在：使用服务商真实支持的模型 ID，不要仅复制厂商展示名。
• 临时切换：只在当前会话测试时，可以使用 Codex 当前版本支持的环境变量覆盖方式；以官方文档为准。

相关背景可阅读什么是 AI API 中转服务和如何理解价格、倍率与实际额度。