Codex 切换 DeepSeek 模型报错或只显示自定义 - CC Switch

Quick fix

开启本地路由并确保 Codex 已登录官方账号生成 models_cache.json，即可恢复模型列表。

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.

Cause

该问题集群涵盖多种 Codex 接入 DeepSeek/GLM/Qwen 等第三方模型时的表现，核心原因有两条：

1. **models_cache.json 缺失**：全新安装的 Codex 在未登录官方账号前不会生成 `~/.codex/models_cache.json`，CC Switch 热切换时找不到 `gpt-5.5` 模板，报错写入失败。手动执行 `codex debug models --bundled > ~/.codex/models_cache.json` 可生成缓存文件。v3.16.1 已修复此问题。

2. **Codex 桌面端登录态限制**：Codex 桌面端的模型选择器根据是否登录官方 ChatGPT 身份决定是否显示第三方模型，未登录时会强制回落到默认模型并显示「自定义」，cc-switch 无法直接改写。需先登录官方账号再配置 CC Switch。

此外，DeepSeek 默认仅支持 Chat Completions API，而 Codex 使用 Responses API，协议不兼容会导致 404 报错，需在 CC Switch 中开启本地路由进行协议转换。

Fix

1. 1

   确保 Codex 已登录官方 ChatGPT 账号，以生成 `~/.codex/models_cache.json` 缓存文件。

2. 2

   若缓存文件仍未生成，手动执行命令生成：codex debug models --bundled > ~/.codex/models_cache.json

   ~/.codex/models_cache.json

   # 包含 gpt-5.5、gpt-5.4、gpt-5.4-mini、gpt-5.3-codex、gpt-5.2、codex-auto-review 等模型条目

3. 3

   在 CC Switch 中为 Codex 配置 DeepSeek 供应商时，开启「本地路由」模式，由 CC Switch 进行 Responses API ↔ Chat Completions 协议转换。

4. 4

   若 Codex 仍只显示「自定义」无法选模型，尝试退出 Codex 登录后重新用 GPT 账号登录，再配置 CC Switch。

5. 5

   升级 CC Switch 至 v3.16.1 或更新版本，该版本已修复 models_cache.json 缺失导致的热切换失败问题。

Affected Versions

ToolCodex

Version3.15.0 - 3.16.4（受影响版本），v3.16.1 起修复缓存缺失问题

PlatformsWindowsmacOS

Source Issues

本页汇总自 24 个真实 issue

• #383如何使用千问或Deepseek模型自带的联网搜索功能？
• #1565无法接入poe api到claude code
• #2580有没有和我一样使用英伟达或者 OpenRouter 这种三方的免费 API，它就有问题
• #2792使用opencode的deepseek-v4-flash-free模型会报错400
• #2891给codex 自定义配置deepseek或者glm模型，测试一直报错404。给claude code 配置deepseek/glm就没有问题
• #2921Claude桌面端无法调用第三方模型
• #2998cc 3.15.0 deepseek 模型提示 reasoning_content
• #3017Claude Code 渲染异常，部分模型的输出变成列表
• #3244Claude desktop 模型映射失败
• #3250Claude 桌面端路由不支持 claude-haiku-4-5-20251001，导致 Explore 子 Agent 报"模型路由未配置"
• #3325codex配置deepseek报错
• #3337codex 配置本地路由转发 报错
• #3342最新版的deepseek的模型默认错误
• #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 模板的视觉能力标记
• #3527更新3.16版本后，原来配置的模型除了deepseek，其他的无法使用了
• #4271接入第三方API时，比如DeepSeek、Qwen、GLM等等，codex切换模型处显示自定义 ，不能切换模型，但是实际上可以使用。我怀疑是官方模型或者其他模型冲突导致的bug。正常来说，应该是只能使用一个模型的，但是在我发现使用中有多个模型，既可以使用官方Claude code模型，在使用过程中，我并没有手动开启使用Claude code，他自己开启的。
• #4382我用cc-switch给codex配置了DeepSeek模型，但是codex上无法正常显示模型名称，也无法选择DeepSeek的flash或pro模型，而且在对话中无法看到本次对话占了多少上下文
• #4914接入deepseekAPI后codex无法搜索模型，但接入中转站可以
• #4950deepseek无法连通
• #5047切换deepseek，对话经常死循环（和上下文无关）
• #6338cc switch模型配置文件导致codex客户端apply_patch工具调用异常
• #6451请求：允许用户编辑 Codex 模型目录模板；上游支持的能力（并行工具/搜索/max推理）不应默认关闭

FAQ

为什么 Codex 接入 DeepSeek 后只显示「自定义」，看不到 flash 和 pro 模型？

这是 Codex 桌面端本身的限制：模型选择器根据是否登录官方 ChatGPT 身份来决定是否显示第三方模型。请先在 Codex 中登录官方账号，确保 `~/.codex/auth.json` 存在，再配置 CC Switch。

执行 codex debug models 命令时报错或找不到命令怎么办？

确保 `codex` CLI 已安装并在 PATH 中。若通过 Homebrew 安装，确认路径正确。也可以从其他已正常运行的 Codex 环境复制 `models_cache.json` 文件到 `~/.codex/` 目录下。

给 Codex 配置 DeepSeek 测试一直报 404 是什么原因？

DeepSeek 默认只支持 Chat Completions API 格式，而 Codex 更新后只支持 Responses API 格式请求。需要在 CC Switch 中开启「本地路由」模式，由 CC Switch 进行协议转换。

使用 DeepSeek 时 AppShots 截图功能不可用怎么办？

CC Switch 生成 Codex model catalog 时从 GPT 模板继承了视觉能力标记（`input_modalities` 包含 `image`），但 DeepSeek 实际不支持图片输入。此问题已在后续版本中修复，升级到最新版即可。

切换到 DeepSeek 后对话经常死循环是什么原因？

该问题仍在排查中，有用户反馈同时接 Codex 底层用 DeepSeek 不会出现死循环，可能与 Claude Code 客户端识别底层模型后的行为有关，暂未确认是 CC Switch 的 bug。

相关问题

api failed deserialize json body into按错误类型回退 Claude Code、升级 cc-switch、关闭本地代理或停止发送不支持的字段。8 issues mergedDeepSeek Claude Code 配置与切换异常先确认问题属于同一类：新终端或新会话会重新读取配置；DeepSeek 缓存命中率异常可先升级到 v3.16.3，但其他变体仍未修复。15 issues merged只在 OpenCode agent 下更新到 v3.16.4 或更新版本，可在 Claude Code、Claude Desktop、Codex 和 OpenCode 中使用 OpenCode Go 预设及纯 API Key 配置。1 issues merged