Codex Desktop 升级至最新版本后，部分通过 CPA 接入的用户发现模型列表异常：GPT-6.1 Sol 不再显示，此前可见的 GLM、DeepSeek、Qwen 等第三方模型也全部消失，仅剩少数官方模型。经排查，CPA 的 /v1/models 接口返回正常，本地 models_cache.json 缓存文件中也包含这些模型，问题出在新版客户端未沿用原有缓存。解决方案是在 ~/.codex/config.toml 文件顶部、所有配置段之前添加一行 model_catalog_json 配置，显式指定 models_cache.json 的绝对路径（Windows 与 macOS/Linux 路径格式不同，如设置了 CODEX_HOME 环境变量则填写对应目录），保存后完全退出并重启 Codex Desktop 即可恢复模型列表。作者对比了本机新旧版本：Codex CLI 0.155.0-alpha.16 在不指定模型目录时可返回 16 个可选模型（含 CPA 模型），而 0.159.0 仅返回 7 个官方模型；旧版日志可见缓存命中，新版在同一 CPA 配置下未采用同一份缓存，修改缓存中的版本号也无效。添加配置后，新版后端恢复返回 16 个可选模型，包含 gpt-6.1-sol。需要注意的是，该配置仅加载已存在的模型目录，不会自动从 CPA 拉取缺失模型；模型出现在列表中也不保证上游可正常调用，需视 CPA 与上游支持情况而定，一般升级 CPA 即可。目前新版具体改动了哪处读取逻辑尚未确认。
事件分析
此次问题折射出 Codex 客户端在快速迭代中对模型目录加载机制的静默调整：新版不再默认读取本地缓存，导致依赖第三方 API 中转的开发环境受到直接影响。对于大量通过 CPA 等中转方案聚合多家模型服务的开发者而言，官方客户端的一次版本升级就可能破坏既有工作流，显式配置成为必要的兜底手段。从产业角度看，Codex 与 Claude Code 等编码智能体正成为模型分发的关键入口，官方对模型列表的收敛客观上强化了自有模型的导流地位，第三方模型服务商与聚合工具需要持续适配版本变化。后续值得关注的方向包括：官方是否会提供正式的模型目录管理接口，社区是否会沉淀出更稳健的兼容方案，以及第三方接入在官方生态中的长期定位。
核心观点：模型列表的静默收紧，揭示客户端正从中立工具演变为官方模型的分发入口，第三方接入的维护成本将持续上升。
原文链接：Linux.do
