20260926 Codex 0.157+ 加载第三方供应商模型目录的方案（旧版方案已失效）

背景说明

从 Codex 0.155.0 起，带 API key 的自定义服务商默认不再拉取远程模型目录。0.156.0 起可以在服务商上写 model_catalog_url。到 0.157.1（2026-09-26），仍然是这样，对应codex desktop就是新UI的版本，原有的配置不再能显示第三方provider如CPA等提供的非OpenAI模型。

原因

目前站内主流的在codex中启用第三方供应商和模型的教程，普遍都有：

experimental_bearer_token 会让这次会话按 API key 登录。

但：发现功能 api_key_model_discovery 默认关闭，关闭时客户端不请求 model_catalog_url，选择器里只剩自带模型。

一句话总结

api_key_model_discovery这个配置选项默认为false，导致站内其他教程如【09/26更新一下自定义模型不显示的问题】绝不允许泥萌们还没有配置Codex桌面端的远程连接 等不生效了。

配置

~/.codex/config.toml：

model_provider = "moxi"

model = "gpt-6-sol"

model_reasoning_effort = "high"



[features]

api_key_model_discovery = true



[model_providers.moxi]

name = "moxi"

experimental_bearer_token = "sk-..."

requires_openai_auth = false

wire_api = "responses"

base_url = "https://api.XXXX.xxxx/v1"

model_catalog_url = "https://api.XXXX.xxxx/v1/models"

客户端会自己请求 https://api.XXXX.xxxx/v1/models?client_version=...。

根据官方日志，这个功能仍在开发中，启动时可能提示不稳定功能。

生效

1. 保存配置后完全退出 Codex，再重新打开。


2. 打开模型选择器，应能看到接口当前下发的模型，例如 gpt-6-sol、gpt-5.5，以及 DeepSeek、MiniMax。


3. 列表仍是旧的时，删掉 ~/.codex/models_cache.json 后再开一次。这份缓存默认保留 5 分钟，而且和 bearer token 绑在一起，改 key 或改地址后旧缓存不会自动换掉。

效果