模型提供方与本地模型

provider 描述连接模型的地址、认证和协议。仅改变内置 OpenAI provider 的地址时，可使用 openai_base_url；确需独立连接配置时，才定义 model_providers.<id>。

用户级 provider 配置

provider 和认证设置应放在用户的 ~/.codex/config.toml。项目 .codex/config.toml 中的 model_provider、model_providers、openai_base_url 等键会被忽略并产生启动警告。

下面是官方示例形式；域名是占位符，需要替换成已验证兼容的服务：

model_provider = "proxy"

[model_providers.proxy]
name = "OpenAI using LLM proxy"
base_url = "https://proxy.example.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

同时选择服务和账号实际可用的模型。不要用 openai、ollama、lmstudio 这些保留 ID 定义自定义 provider。

请求头与外部认证程序

固定请求头用 http_headers，从环境变量读取的请求头用 env_http_headers。需要外部凭据程序时，可以配置：

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

认证程序不接收 stdin，必须在 stdout 输出 token；空值会被视为错误。这里的毫秒数是示例值。refresh_interval_ms = 0 表示只在认证重试后刷新。此方式不能与 env_key、experimental_bearer_token 或 requires_openai_auth 同时使用。

OSS 本地 provider

--oss 可使用 Ollama 或 LM Studio。单次运行用 --local-provider 选择，长期默认值用：

oss_provider = "ollama"

也可设为 "lmstudio"。既没有单次选择也没有默认值时，交互 CLI 会询问，而 codex exec 会报错。实际模型能力和服务可用性仍需在本地验证。

搜索不是自动获得的能力

provider 支持 Responses 并不保证支持 standalone web search。supports_standalone_web_search 默认 false，即使设为 true，也仍需要服务端、模型与运行时共同支持。搜索模式与组织限制见网络搜索。