Codex 启动失败：缺少 supports_reasoning_summaries 字段（cc-switch）

Quick fix

把 cc-switch 升级到 v3.18.0 及以上，重新切换 DeepSeek 供应商重新生成模型目录，即可自动补齐该字段并正常启动 Codex。

Symptom

报错原文复制

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

Cause

codex 0.144.5+ 的模型目录解析器要求模型条目必须包含 supports_reasoning_summaries 字段，而 cc-switch v3.17.0 及更早版本为 Chat Completions 类供应商（如 DeepSeek）生成 cc-switch-model-catalog.json 时不会写入该字段，Codex 解析失败直接无法启动。该问题已在 v3.18.0 修复：生成模型目录时会从内置静态模板回填解析器必需字段（仅在缺失时回填、动态值优先）。

本集群中还存在几个症状相似但成因不同的变体：#3615 是 Codex 启动时向 OpenAI 独立的 entitlements/credits 端点做额度查询，cc-switch 代理只能劫持 /v1/chat/completions 等推理接口、无法拦截该检查，因此免费试用额度用完后 Codex 前端直接白屏/警告，这一问题被标记 stale 关闭，暂无修复；#3796 是在 cc-switch 界面添加供应商、配置 DeepSeek 模型时界面白屏，维护者建议升级到 v3.16.4 后重试，但有用户反馈 3.17.0 仍复现，未见确认修复；#4130 是接管 Hermes（provider: deepseek）时每次保存都向 config.yaml 末尾追加一个 custom_providers 块，导致 YAML 重复键，下次启动报 duplicate entry with key "custom_providers"，该问题已在 v3.16.3 修复（写入前清除旧块 + 启动解析前去重自愈）。

Fix

1. 1

   将 cc-switch 升级到 v3.18.0 或更高版本（维护者确认该版本会在生成模型目录时自动回填 supports_reasoning_summaries 等解析器必需字段）。

2. 2

   升级后在 cc-switch 中重新切换到 DeepSeek 供应商，让其重新生成 cc-switch-model-catalog.json，然后重启 Codex 验证能否正常启动。

3. 3

   若升级后仍启动失败，将生成的 cc-switch-model-catalog.json 附在原 issue 中 reopen 反馈。

4. 4

   如果你遇到的实际是 Hermes 的 YAML 重复键启动报错（duplicate entry with key "custom_providers"），升级 cc-switch 到 v3.16.3 及以上即可，存量重复键文件会被自动清理。

Affected Versions

ToolCodex

Versioncc-switch v3.17.0 及以下为受影响版本，v3.18.0 起修复（Hermes YAML 变体在 v3.16.3 修复）

PlatformsWindowsmacOS

Source Issues

本页汇总自 4 个真实 issue

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

FAQ

我有 DeepSeek 的 API key，为什么 Codex 启动时还是提示额度不足/白屏？

Codex 启动后会先向 OpenAI 独立的 entitlements/credits 端点查询额度，cc-switch 的代理只能劫持 /v1/chat/completions 等模型推理接口，无法拦截或伪造这个额度检查，所以 Codex 看到的仍是 OpenAI 账户的真实额度（接近 0），直接在前端弹出警告/白屏。该 issue 已因 stale 关闭，暂无修复方案。

升级到 3.17.0 后添加供应商配置 DeepSeek 模型还是白屏，怎么办？

维护者指出 v3.16.1 之后 Codex 供应商表单经过较大重构（v3.16.3 统一高级设置区、v3.16.4 解耦上游格式选择器并刷新国产预设），建议升级到最新版本后重试；若白屏仍出现，请打开开发者工具查看控制台报错并附重现步骤回复原 issue，以便继续排查。截至该 issue 关闭，3.17.0 上仍有用户反馈复现，未见确认修复。

每次保存 Hermes 配置，config.yaml 里就多一个 custom_providers 块，启动报重复键错误怎么办？

这是 cc-switch 3.14.1 等旧版本的 bug：保存时简单追加而非原地替换。升级到 v3.16.3 即可修复——写入时会先清除所有旧的 custom_providers 块再重写，且启动解析前会对重复键去重自愈，不再报 duplicate entry with key 错误。

Codex 启动失败一定要升级 cc-switch 吗，能不能手动改文件？

issue 中维护者给出的唯一确认方案是升级到 v3.18.0 及以上（生成目录时自动回填缺失字段，且动态值优先）。是否可手动在 cc-switch-model-catalog.json 中补字段，issue 中未提及，不做推荐。

相关问题

cc-switch 用量统计与 DeepSeek 官网不一致 / 不更新先升级到 v3.19.2 或更新版本，然后在「使用统计」页执行一次「重建 Codex 用量」，历史虚增或漏记的数据才会被修正。22 issues mergedDeepSeek 接入 cc-switch：Codex 深度集成功能请求这是 DeepSeek 深度接入 Codex 的功能请求；原帖尚未提供可验证的解法，关闭状态不能证明已实现。1 issues mergedRequest exceeds the context window原帖未提供可验证的解法；该问题已作为与 catalog 配置及自动压缩相关的重复项关闭。1 issues merged