OpenAI Codex 支持自定义第三方模型提供者

OpenAI Codex 现在支持自定义第三方模型提供者（Custom Model Providers）。在配置文件中定义提供者名称、接口地址和 API 密钥，即可接入 OpenAI 代理、本地 Ollama、Mistral 等外部模型，不必局限于 OpenAI 官方模型。

配置方法

在 ~/.codex/config.toml 中定义 model_provider 和对应的 [model_providers.<id>]：

toml
model = "gpt-5.4"
model_provider = "proxy"

[model_providers.proxy]
name = "OpenAI using LLM proxy"
base_url = "http://proxy.example.com"
env_key = "OPENAI_API_KEY"

[model_providers.local_ollama]
name = "Ollama"
base_url = "http://localhost:11434/v1"

[model_providers.mistral]
name = "Mistral"
base_url = "https://api.mistral.ai/v1"
env_key = "MISTRAL_API_KEY"

定义好之后，通过 model_provider 字段切换使用哪个提供者。每个提供者需要指定 name（显示名称）、base_url（接口地址）、env_key（环境变量名，用于读取 API 密钥）。

内置提供者

Codex 内置了三个保留提供者 ID：openai、ollama、lmstudio，自定义提供者不能复用这些名称。此外还有一个内置的 Amazon Bedrock 提供者：

toml
model_provider = "amazon-bedrock"
model = "<bedrock-model-id>"

[model_providers.amazon-bedrock.aws]
profile = "default"
region = "eu-central-1"

Azure 提供者也支持，可以配置 base_url、query_params、wire_api 以及重试参数：

toml
[model_providers.azure]
name = "Azure"
base_url = "https://YOUR_PROJECT_NAME.openai.azure.com/openai"
env_key = "AZURE_OPENAI_API_KEY"
query_params = { api-version = "2025-04-01-preview" }
wire_api = "responses"

CLI 覆盖

除了编辑配置文件，也可以在命令行中直接覆盖配置：

bash
# 使用专用 flag
codex --model gpt-5.4

# 覆盖任意 key（值为 TOML 格式）
codex --config model='"gpt-5.4"'
codex --config sandbox_workspace_write.network_access=true

--config 的值按 TOML 解析，支持点号嵌套设置。Profile 机制也支持：codex --profile deep-review 会加载 ~/.codex/deep-review.config.toml 作为覆盖层。

OSS 模式

通过 --oss 参数可以快速切换到本地开源模型：

bash
codex --oss  # 使用默认的 oss_provider（ollama 或 lmstudio）

命令行认证

对于需要从外部凭证助手获取 token 的场景，Codex 支持命令行认证（command-backed auth）：

toml
[model_providers.proxy.auth]
command = "/usr/local/bin/fetch-codex-token"
args = ["--audience", "codex"]
timeout_ms = 5000
refresh_interval_ms = 300000

认证命令不需要 stdin 输入，将 token 输出到 stdout 即可。Codex 会按 refresh_interval_ms 定期刷新。

这意味着什么

Codex 开放第三方模型提供者配置，意味着开发者可以用同一套 Codex 工作流接入任意 OpenAI 兼容的模型服务。对国内开发者来说，可以通过代理接入国产模型；对隐私敏感的团队，可以跑本地 Ollama；对多云架构的企业，可以在 Bedrock、Azure、OpenAI 之间灵活切换。

来源：OpenAI Codex 文档