跳转到主要内容

​
简短答案

model_provider 决定 Codex CLI 当前使用哪个 provider。它的值要对应下面 [model_providers.<id>] 中定义的 provider id。 base_url 是模型请求发往的 API 地址。对 OpenAI-compatible provider，它通常指向 /v1 风格的 endpoint。 wire_api 指定 Codex 与该 provider 通信时使用的协议形态。根据 Codex 配置参考，responses 是 provider 配置中支持的协议值之一。

​
什么时候需要理解它

  • 你在配置自定义 OpenAI-compatible provider
  • Codex 提示 provider 找不到或模型请求失败
  • 你不确定 model_provider 和 model 的区别
  • 你在把 LLMEasy、OpenAI 或其他 provider 放进同一份 config.toml
  • 你想区分 Base URL、API Key、Model ID 三个字段

​
字段关系

字段作用
model_provider选择当前使用哪个 provider id
[model_providers.<id>]定义某个 provider 的详细配置
nameprovider 的显示名称
base_urlAPI 请求根地址
wire_apiprovider 通信协议，常见值是 responses
model默认主模型 ID
review_model/review 等代码审查场景使用的模型

​
推荐配置方式

保持 provider id 一致： 
model_provider = "custom"
model = "gpt-5.5"

[model_providers.custom]
name = "LLMEasy"
base_url = "https://www.llmeasy.ru/v1"
wire_api = "responses"
requires_openai_auth = false
这表示：Codex 使用名为 custom 的 provider，把模型请求发送到 https://www.llmeasy.ru/v1，并按 Responses API 形态通信。

​
常见误区

  • 把 model_provider 写成显示名称，而不是 provider id。
  • 把 model 当作 provider 名称。
  • 忘记 base_url 和 provider 必须属于同一种协议。
  • 把 Anthropic-compatible Base URL 填到 Codex 的 OpenAI-compatible provider。
  • 用工具界面里的模型展示名替代 API 可识别的 Model ID。

​
关于 LLMEasy

LLMEasy 可以作为 [model_providers.custom] 这样的自定义 provider。base_url 使用 https://www.llmeasy.ru/v1，模型 ID 从 GPT 分组复制。 在 LLMEasy 区域站中，同样使用 custom 作为 provider id，Base URL 则使用 LLMEasy 的区域地址。

​
References