Codex model catalog template `gpt-5.5` not found CC Switch
Quick fix
重新生成 ~/.codex/models_cache.json，并保留 Codex 的 ChatGPT 登录态，CC Switch 才能写入路由并显示 DeepSeek 模型。
Symptom
Section titled “Symptom”热切换失败: 写入 Codex 配置失败: Codex model catalog template `gpt-5.5` not found. Please start Codex once so models_cache.json is available, or ensure the `codex` CLI is on PATH.Codex 的模型目录 `models_cache.json` 是 CC Switch 写入 Codex 路由配置时的模板来源。若全新安装 Codex 后未登录，或 `codex` CLI 不在 PATH 上，`~/.codex/models_cache.json` 不会生成，CC Switch 在开启本地路由/切换供应商时就会因找不到 `gpt-5.5` 模板而报错。官方在 v3.16.0/v3.16.1 宣称已修复，但多个用户升级后仍可复现，因此手动生成缓存仍是实测有效方案。
另一类表现为模型列表只有“自定义”或 GPT 模型、没有 `deepseek-v4-flash`/`deepseek-v4-pro`：这是 Codex 桌面端在未保留官方 ChatGPT 登录态时隐藏第三方模型并回落默认模型所致，与本机缓存无关。还有部分问题来自 CC Switch 生成 `~/.codex/cc-switch-model-catalog.json` 时克隆了 GPT 模板的视觉/`apply_patch` 能力字段，导致 AppShots、apply_patch 异常，这些同源问题需要模板可编辑能力（#6451）才能根治。
在终端执行 `codex debug models --bundled > ~/.codex/models_cache.json`，生成包含 `gpt-5.5`、`gpt-5.4` 等模型的缓存文件。
如果是全新安装的 Codex，先正常启动并登录一次 ChatGPT 账号，让 `~/.codex` 下生成 `models_cache.json`；若仍未生成，可手动将社区分享的 `models_cache.json` 放入 `~/.codex/`。
在 Codex 桌面端保留官方 ChatGPT 登录态，再回到 CC Switch 开启本地路由/切换接入点，模型选择器才会显示 DeepSeek 的 flash/pro。
如果还是只显示旧模型，删除旧 DeepSeek Provider，从 CC Switch 内置 DeepSeek 预设重新创建（v3.16 后预设为 `deepseek-v4`）。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 10 个真实 issue
- #3325codex配置deepseek报错
- #3337codex 配置本地路由转发 报错
- #3386codex模型映射是不显示的吗？
- #3461热切换失败: 写入 Codex 配置失败: Codex model catalog template `gpt-5.5` not found. Please start Codex once so models_cache.json is available, or ensure the `codex` CLI is on PATH.
- #3481[Bug] Codex + DeepSeek 配置下 AppShots 功能不可用 — model catalog 继承了 GPT 模板的视觉能力标记
- #4271接入第三方API时，比如DeepSeek、Qwen、GLM等等，codex切换模型处显示自定义 ，不能切换模型，但是实际上可以使用。我怀疑是官方模型或者其他模型冲突导致的bug。正常来说，应该是只能使用一个模型的，但是在我发现使用中有多个模型，既可以使用官方Claude code模型，在使用过程中，我并没有手动开启使用Claude code，他自己开启的。
- #4382我用cc-switch给codex配置了DeepSeek模型，但是codex上无法正常显示模型名称，也无法选择DeepSeek的flash或pro模型，而且在对话中无法看到本次对话占了多少上下文
- #4914接入deepseekAPI后codex无法搜索模型，但接入中转站可以
- #6338cc switch模型配置文件导致codex客户端apply_patch工具调用异常
- #6451请求：允许用户编辑 Codex 模型目录模板；上游支持的能力（并行工具/搜索/max推理）不应默认关闭
- 为什么执行了 `codex debug models --bundled` 后仍然找不到模型？
- 先确认 `~/.codex/models_cache.json` 里包含 `gpt-5.5`、`gpt-5.4` 等模型；若 Codex 未登录或 `codex` CLI 不在 PATH，文件可能为空，请先登录并确保 CLI 可用。
- 为什么 Codex 里只显示“自定义”，看不到 deepseek-v4-flash/pro？
- 这是 Codex 桌面端的限制：没有保留官方 ChatGPT 登录态时模型选择器会隐藏第三方模型并回落默认模型。先登录一次官方账号再切换 CC Switch 接入点。
- 为什么 AppShots 或 apply_patch 会异常？
- 生成的 `~/.codex/cc-switch-model-catalog.json` 从 GPT 模板继承了视觉/`apply_patch` 等能力字段，手动修改会在切换时被覆盖；#6451 正在跟踪模板可编辑能力，当前只能手动临时修正。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。