跳到正文
funcoding.ai
← OpenAI Codex

OpenAI Codex · 自定义模型

Codex 配置自定义模型：config.toml、第三方提供方与本地模型

在 ~/.codex/config.toml 里切换模型、添加自定义 model_providers，用 profile 管理多套配置，以及用 --oss 连接 Ollama 本地模型。

1 分钟读完

Codex 的模型相关配置都在用户级配置文件 ~/.codex/config.toml 中。

model_provider 和 model_providers 只在用户级 ~/.codex/config.toml 中生效，写在项目里的 .codex/config.toml 会被忽略，并在启动时给出警告。

切换模型

临时切换：

Terminal window
codex -m <模型名>

会话中可以用 /model 切换。想长期使用某个模型，写进配置文件：

~/.codex/config.toml
model = "<模型名>"

可用模型以官方文档的 Models 页面为准。

添加自定义提供方

在 [model_providers.<id>] 下定义一个提供方，再用 model_provider 指向它。以 Azure OpenAI 为例（官方示例）：

~/.codex/config.toml
model_provider = "azure"


[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"

各字段的含义：

字段 说明
name 显示名称
base_url 接口地址
env_key 存放 API Key 的环境变量名，Codex 会以 Bearer Token 发送
wire_api 接口协议。新版 Codex 已移除 Chat Completions 协议，需要提供方支持 Responses API（responses）
query_params / http_headers 可选，附加的查询参数或请求头

注意事项：

  • 自定义提供方的 ID 不能使用内置保留的 openai、ollama、lmstudio
  • 记得在 shell 里导出 env_key 指定的变量，例如 export AZURE_OPENAI_API_KEY=...

用 profile 管理多套配置

把不同的模型和提供方组合放进不同的配置档，启动时用 --profile 选择：

~/.codex/config.toml
[profiles.work]
model_provider = "azure"
model = "<模型名>"
Terminal window
codex --profile work

使用 Ollama 本地模型

Codex 内置了对本地开源模型的支持，加上 --oss 参数即可：

Terminal window
# 使用默认的本地提供方
codex --oss


# 指定模型
codex --oss -m gpt-oss:120b

如果 Ollama 跑在另一台机器上，在配置里改 base_url：

~/.codex/config.toml
oss_provider = "ollama"


[model_providers.ollama]
name = "Ollama"
base_url = "http://192.168.1.50:11434/v1"
wire_api = "responses"

新版 Ollama 还提供了一键启动命令：

Terminal window
ollama launch codex

排查问题

  • 提示找不到 API Key：检查 env_key 写的是变量名而不是 Key 本身，并确认变量已经导出
  • 第三方服务报错：确认对方支持 Responses API；只支持 Chat Completions 的服务需要经过兼容层转换