缺少 supports_reasoning_summaries 字段 Codex 启动失败

Quick fix

升级 cc-switch 至 v3.18.0 及以上版本，修复生成模型目录时缺失必需字段导致 Codex 启动失败的问题。

Symptom

报错原文复制

切换供应商后生成的 cc-switch-model-catalog.json 中，DeepSeek 模型缺少 supports_reasoning_summaries 字段，导致 Codex 启动失败

Cause

该问题是由于 cc-switch 在生成 `cc-switch-model-catalog.json` 时，未能为 DeepSeek 等 Chat Completions 供应商自动填充 `supports_reasoning_summaries` 字段，导致 Codex (0.144.5+) 解析目录时启动失败。在 v3.18.0 中，生成逻辑已更新，会从内置静态模板回填解析器必需字段。

需要特别说明的是，本 issue 集群实际上混合了多个与 DeepSeek 相关的独立问题。除上述 Codex 启动失败外，还包括：1. cc-switch 无法拦截 Codex 的 OpenAI 额度查询接口导致白屏（#3615，暂无修复）；2. 在 UI 中添加 DeepSeek 供应商时触发白屏（#3796，官方称 v3.16.4 修复，但部分用户反馈 v3.17.0 仍复现）；3. 接管 Hermes 配置时重复追加 `custom_providers` 导致 YAML 重复键报错（#4130，已在 v3.16.3 修复）。

Fix

1. 1

   升级 cc-switch 到 v3.18.0 或更高版本。

2. 2

   在 cc-switch 中重新切换或保存一次 DeepSeek 供应商配置，以触发 `cc-switch-model-catalog.json` 的重新生成。

Affected Versions

ToolCodex

Version0.144.5+

PlatformsWindowsmacOS

Source Issues

本页汇总自 4 个真实 issue

• #3615Codex在有试用额度且用完的情况下，ccswitch无法拦截请求
• #3796cc swtich 点击添加新的供应商，在选择配置deepseek模型时出现白屏
• #4130Bug: 接管 Hermes 配置时重复追加 custom_providers，导致 YAML 重复键错误
• #5554Chat Completions 供应商生成的 model_catalog_json 缺少 supports_reasoning_summaries 字段

FAQ

升级到 v3.17.0 后，添加 DeepSeek 供应商依然白屏怎么办？

官方在 v3.16.4 重构了表单，若新版仍复现白屏，请打开开发者工具查看控制台报错，并附上重现步骤与日志重新反馈。

我有 DeepSeek 的 API，为什么 Codex 还是提示额度不足或白屏？

Codex 启动时会独立查询 OpenAI 的 entitlements 端点，cc-switch 目前只能劫持模型推理接口，无法拦截额度查询。因此即使配置了第三方 API，前端仍会因 OpenAI 账户额度为 0 而阻断。

相关问题

cc-switch DeepSeek 用量统计不准/余额查询失败升级到 v3.19.2 并重建 Codex 用量；余额查询需正确填写 {{apiKey}} 或代理。17 issues mergedDeepSeek 勾选 1M 不生效？cc-switch 本地代理配置开启 cc-switch 本地代理时不要填 [1m]，主模型留空；未开代理才可用 [1m] 后缀。4 issues merged404 Not FoundDeepSeek 不支持 Responses API，请使用内置预设走 Chat Completions 路由；若因图片报错需修改模型目录移除 image 模态。5 issues merged