Codex 0.124.0 · Model Catalog Fix

修复 gpt-5.5 模型元数据未找到的警告

当 Codex 提示 “Model metadata for gpt-5.5 not found” 时，通常不是模型不可用， 而是本地模型目录文件没有被 Codex 从正确的配置层级读取。

下载 model-catalog.gpt-5.5.json
错误配置

为什么会出现警告？

TOML 中的表头会改变后续配置项的归属。下面这种写法表示 model_catalog_json 属于 model_providers.yourapi， 但 Codex 查找模型元数据时读取的是顶层配置。

config.toml Before 
model_provider = "yourapi"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"

[model_providers.yourapi]
name = "yourapi"
base_url = "https://example.com/api/codex"
wire_api = "responses"
model_catalog_json = '.\\model-catalog.gpt-5.5.json'
正确配置

应该如何修复？

把 model_catalog_json 放到任何表头之前，也就是 config.toml 顶层。这样 Codex 启动时就能正确加载本地模型目录。

config.toml After 
model_provider = "yourapi"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"
model_catalog_json = '.\\model-catalog.gpt-5.5.json'

[model_providers.yourapi]
name = "yourapi"
base_url = "https://example.com/api/codex"
wire_api = "responses"
修复流程

按这几步检查

确认模型目录文件存在 文件应放在 C:\Users\Administrator\.codex\model-catalog.gpt-5.5.json。
打开 Codex 配置文件 配置文件路径是 C:\Users\Administrator\.codex\config.toml。
把 model_catalog_json 移到顶层 确保它位于 [model_providers.yourapi] 之前，而不是表头下面。
完全重启 Codex 退出当前 Codex 进程后重新打开，再发送消息或输入 /model 验证。
原理说明

Codex 为什么需要这份 metadata？

模型目录文件不只是模型列表，它还描述了模型能力。缺少它时 Codex 仍可能调用模型， 但会使用 fallback metadata，可能导致参数、工具行为或性能不够准确。

Reasoning Levels 声明模型支持 low、medium、high、xhigh 等推理强度。
Tool Support 声明是否支持图片、工具调用、并行工具、补丁编辑等能力。
Context Window 提供上下文窗口、截断策略、默认 verbosity 等运行参数。