帮我排查并修复 Codex / ChatGPT App 在 API Key 登录或自定义 provider 场景下,模型列表不显示 GPT-5.6 的问题。
目标:
让本机 Codex 的 /model 或 ChatGPT App 内置 Codex 模型列表能看到:
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna请按下面步骤执行,不要猜测:
先检查 Codex CLI 版本:
which codex
codex --version要求至少 0.144.0。低于这个版本就升级:
npm install -g @openai/codex@latest检查当前 Codex 配置:
grep -nE ‘^(model|model_provider|model_catalog_json)|base_url’ ~/.codex/config.toml检查 Codex 是否已经能渲染 5.6 模型:
codex debug models如果输出里已经有:
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna但 App 或 /model 里看不到,重点检查 model_catalog_json 是否写入配置。
如果 ~/.codex/config.toml 没有 model_catalog_json,则创建模型目录文件:~/.codex/cc-switch-model-catalog.json
最简单可靠的方式是用当前 Codex 内置模型目录导出:
codex debug models > ~/.codex/cc-switch-model-catalog.json然后在 ~/.codex/config.toml 顶层加入,注意放在 [model_providers] 之前,和 model 同级:
model_catalog_json = “/Users/你的用户名/.codex/cc-switch-model-catalog.json”示例:
model_provider = “custom”
model = “gpt-5.6-terra”
model_catalog_json = “/Users/xxx/.codex/cc-switch-model-catalog.json”验证:
codex debug models
codex doctor --summary --ascii期望 codex debug models 能显示:
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna如果是 ChatGPT App 内置 Codex,也检查:/Applications/ChatGPT.app/Contents/Resources/codex debug models
它也应该显示 5.6 三个模型。
最后彻底退出 ChatGPT/Codex App,不是只关窗口,然后重新打开,再看模型列表。
注意:
API Key 登录 / 自定义 provider / sub2api / CC Switch 场景下,ChatGPT 账号模型列表和 Codex API Key 模型列表不是一回事。
仅设置 model = “gpt-5.6-terra” 不一定会让模型选择器显示 5.6。
关键是 model_catalog_json。
修改前先备份 ~/.codex/config.toml。
把以上提示词丢给codex5.5模型即可解决