Codex model catalog template `gpt-5.5` not found - CC Switch
Quick fix
运行 codex debug models --bundled > ~/.codex/models_cache.json 生成缺失的模型缓存，再重新切换 Codex 路由即可。
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.CC Switch 在接管或写入 Codex 路由配置时，会读取 `~/.codex/models_cache.json` 作为模型目录来源，并要求其中包含 `gpt-5.5` 模板。如果 Codex 从未以官方账号登录或启动过，或一开始就使用自定义 DeepSeek 后端，`models_cache.json` 不会生成，CC Switch 在切换路由时就会报 `gpt-5.5` not found。手动执行 `codex debug models --bundled > ~/.codex/models_cache.json` 可以补齐该缓存。
同一类问题还有多个变体：切换后模型列表为空（#3340）、`/model` 不显示 DeepSeek 模型（#3422），通常与 `cc-switch-model-catalog.json` 未刷新或自定义供应商残留有关，删除该缓存文件再切换可重新生成；`config.toml` 中 `model_provider` 沿用旧 key（#3318）是 v3.15.0 为避免 Codex 历史分桶的兼容设计，实际生效的是 `[model_providers.<key>]` 内容；开启路由但 `base_url` 未热切换为 `127.0.0.1`（#4082/#3756）在 v3.16.2 修复；默认模型被数据库旧值覆盖（#5783）需在 CC Switch 编辑页保存而不是直接改 `~/.codex/config.toml`；v3.16.4 的 `AbsolutePathBuf deserialized without a base path in model_catalog_json`（#4761）被维护者归并到 #5731。注意各修复之间存在矛盾：维护者在关闭 #3340/#3422 时称 v3.16.0/v3.16.1 已修复，但仍有用户在 v3.16.2 复现，并分别通过重装 Codex、关闭 VPN、删除并重建供应商恢复，因此应结合自身环境尝试，不要只依赖升级版本。
打开终端，执行 `codex debug models --bundled > ~/.codex/models_cache.json`，生成包含 `gpt-5.5` 等模板的模型缓存文件。
重新启动 Codex（至少启动一次），然后回到 CC Switch 重新开启或切换 Codex 路由。
如果 `/model` 仍不显示 DeepSeek 模型，删除 `cc-switch-model-catalog.json`，再重新切换供应商，CC Switch 会重新生成对应目录。
如果切换后模型列表仍为空，在 CC Switch 中删除该自定义供应商并重新创建，部分用户在 #3340 反馈此方法有效。
如果遇到 `base_url` 未热切换或仍为 `https://api.deepseek.com`，先升级到 v3.16.2 或更新版本；如果默认模型被覆盖，请在 CC Switch 的 Codex 供应商编辑页修改“默认模型”并保存，不要只手动编辑 `~/.codex/config.toml`。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 10 个真实 issue
- #1337使用cc-switch配置codex的deepseek模型报错
- #3318切换第三方模型的时候，.codex/config.toml文件配置参数会相互干扰，需要先切换到官方默认，再切换到第三方。
- #3340codex客户端中还是无法显示模型名称，自定义模型为空
- #3343打开路由报错，无法写入配置文件和鉴权文件
- #3378切换路由状态失败: 写入 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.
- #3422codex--在进行过cc-switch的配置deepseek后，使用/model依旧不显示deepseek模型
- #3756切换不需要本地路由的供应商，API请求配置也会被强制改成https://127.0.0.1/v1
- #4082ccswitch开启了codex本地路由，但是并没有热修改config.toml里面的base_url，仍然保持着"https://api.deepseek.com"而不是换成"http://127.0.0.1:15721/v1"
- #4761deepseek无法正确接入
- #5783cc switch会主动覆盖config.toml的默认模型设置
- 这是不是 `config.toml` 文件配置不对呢？
- 不一定是。更常见原因是 `~/.codex/models_cache.json` 缺失，导致 CC Switch 找不到 `gpt-5.5` 模型目录模板。建议先执行 `codex debug models --bundled > ~/.codex/models_cache.json` 生成缓存，再检查 `config.toml` 中的自定义 provider `base_url`/`model` 是否正确。
- 我在 `.env` 里设置了代理，关闭代理后 Codex 进不去，开启代理又看不到模型，怎么办？
- 社区反馈不一致：有用户关闭 VPN 后重启 Codex 就能看到第三方模型，也有用户依赖代理才能访问 API。建议先确认代理没有拦截本地路由地址 `127.0.0.1`，并确保 Codex 与 CC Switch 使用同一份 `~/.codex/config.toml`；若仍冲突，可尝试删除供应商重建或删除 `cc-switch-model-catalog.json` 后再切换。
- Claude Code 也遇到类似问题，`codex debug models --bundled` 能解决吗？
- `gpt-5.5 not found` 是 Codex 的模型缓存问题，`codex debug models --bundled` 只针对 Codex。Claude Code 用户曾报告不同错误 `There's an issue with the selected model (claude-sonnet-4-6[1m]). It may not exist or you may not have access to it.`，本页步骤不适用于 Claude Code。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。