Codex model_provider 配置说明：provider id 不要写错层级

很多配置不生效，是因为 provider 写错位置、provider id 对不上，或者把认证和模型配置混在项目级文件里。

model_provider 是什么

model_provider 指向一个 provider id；model_providers.<id> 定义这个 provider 的名字、入口、认证方式和协议。

provider id 必须一致

下面示例里 model_provider = "izkl-gateway" 和 [model_providers.izkl-gateway] 必须对应：

model = "your-codex-model"
model_provider = "izkl-gateway"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
model_reasoning_effort = "high"

[model_providers.izkl-gateway]
name = "izkl AI Gateway"
base_url = "https://izkl.top/v1"
requires_openai_auth = true
wire_api = "responses"

这些字段怎么理解

字段	说明
`base_url`	模型 provider 的 API 入口
`requires_openai_auth`	使用 OpenAI 风格认证，从环境变量拿 key
`wire_api`	Codex provider 协议，当前使用 responses
`model_reasoning_effort`	支持模型的推理强度

不要放错文件

provider、认证和 profile 这类本机配置应放在用户级 ~/.codex/config.toml。项目级配置更适合团队规则、指令和项目行为，不适合覆盖成员本机 provider。

常见问题

provider id 可以随便取吗？

可以自定义，但 model_provider 的值必须和 model_providers 表名一致，且不要覆盖内置保留 provider。

wire_api 可以写 chat_completions 吗？

不建议。Codex 当前 provider 协议使用 responses，省略时默认也是 responses。