获取模型列表失败 - cc-switch
Quick fix
先升级 cc-switch 并先添加模型行再获取列表；若仍失败，用 curl 验证 /v1/models 权限。
Symptom
Section titled “Symptom”获取模型列表失败cc-switch 的“获取模型列表”会按 OpenAI 兼容协议请求 `{Base URL}/v1/models`，并发送 `Authorization: Bearer <API Key>`。只要该接口返回 401/403，前端就会显示“API Key 无效或无权限”或“获取模型列表失败”。这不一定是 key 本身失效：有些服务商的对话接口可用，但模型列表接口未开放或无权限；也可能是 API Key 误粘了空格、换行或 `Bearer ` 前缀。
该问题存在多个变体：早期版本中“添加 codex 作为供应商后获取模型列表提示请先填写 API Key”已在 v3.15.0 修复；“获取成功但不显示”通常是未先点击“添加模型”导致拉到的模型没有可挂载的模型行；Codex Desktop 中 catalog 已生成但模型选择器不显示的问题由 #4420 跟踪，与官方登录态有关；另有用户报告编辑 Codex provider 的 `base_url` 后 `provider_endpoints.url` 未同步更新，导致模型列表仍请求旧地址。
将 cc-switch 升级到 v3.15.0 或更高版本；如果是 Codex Desktop 模型选择器不显示，按 #4420 的官方登录态说明处理。
在供应商表单中先点击“添加模型”新建一行，再点击“获取模型列表”，让拉取到的模型挂载到该模型行的下拉框中。
检查 API Key 输入框是否误粘了前后空格、换行，或整段 `Bearer xxx`；这里只需要填写纯 key。
用同一个 key 手动请求模型列表接口确认权限，例如：`curl -H "Authorization: Bearer YOUR_KEY" https://api.deepseek.com/v1/models`。如果 curl 返回 401/403，说明该 key 对 `/v1/models` 无权限或服务商未开放该接口，请联系服务商确认；此时可以先手动填写模型名继续使用。
如果 curl 能正常返回模型列表但 cc-switch 仍失败，检查是否修改过 Codex provider 的 `base_url` 后 `provider_endpoints.url` 仍是旧地址；手动把 `provider_endpoints.url` 改成和 `base_url` 一致后重试。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 21 个真实 issue
- #2274各家codeplan多模型切换的支持
- #2325Claude桌面端无法检测模型列表
- #2404获取模型列表失败
- #2672curl 可以正常工作，ccswitch测试模型始终404
- #2685claude code
- #2687添加 codex作为Claude Code供应商后，选择获取模型列表，提示：请先填写 API Key
- #3035GLM模型5小时余量与7天余量展示数据相反
- #3800配置面板抖动
- #4364claude显示网络问题，同时CCswitch关于页面获取模型更新显示未知
- #4543获取模型列表失败
- #4552获取模型列表成功之后为什么不显示获取到的模型列表呢？
- #4790如何获取模型列表
- #4904获取模型列表失败
- #5066codex模型只显示自定义，看不到模型列表
- #5072获取模型、检测连通性提示错误，但是实际是通
- #5099Codex provider 编辑 base_url 后 provider_endpoints.url 未同步更新，导致模型列表/测试仍请求旧地址
- #5507与BUG共存，不要作完美主义
- #5726Codex桌面版更新后模型不可选
- #6184开启本地路由后，模型列表与供应商模型列表不一致
- #6295Correct configuration for the Grok build
- #6349模型供应商名称疯狂闪烁
- 为什么同一个 key 别人能获取模型列表，我这里失败？
- 可能是本机 API Key 输入框误粘了空格、换行或 `Bearer ` 前缀，也可能是代理软件、网络环境或服务商对 `/v1/models` 接口的权限不同。先用 `curl -H "Authorization: Bearer YOUR_KEY" {Base URL}/v1/models` 在本机验证。
- 提示“请先填写 API Key”怎么办？
- 该问题在 v3.15.0 中已修复，请升级 cc-switch。如果升级后仍然出现，请补充最新版本号、复现步骤和相关日志。
- 获取模型列表成功但为什么不显示？
- 先点击“添加模型”新建一行，再点击“获取模型列表”。拉到的模型需要挂在已有的模型条目上供选择；没有模型行时直接获取，结果没有可挂载的位置，就会表现为获取成功但不显示。
- curl 可以正常返回，但 cc-switch 测试模型一直 404 或获取失败？
- 有用户报告这是旧版本问题，可尝试换用 3.13.0 或升级新版本；另外如果编辑过 Codex provider 的 `base_url`，检查 `provider_endpoints.url` 是否仍指向旧地址。
- 模型列表获取失败会影响实际使用吗？
- 不一定。有些服务商只是模型列表接口没有开放或没有权限，对话接口仍可用。可以先手动填写模型名继续使用。
- Claude Desktop 开启开发者模式后无法检测模型列表，是 cc-switch 的问题吗？
- 按 issue 中的讨论，Claude Desktop 开发者模式没有提供自定义模型名输入，模型列表和组件显示由 Desktop 自己控制。cc-switch 本地路由可以处理已发出的 API 请求并做模型映射，但不能修改 Claude Desktop 的模型选择 UI 或硬编码校验逻辑。
- Codex Desktop 更新后模型列表为空不可选怎么办？
- 参照 #4420 的官方登录态相关说明处理；如果按步骤仍无效，重新打开 issue 并补充 Codex Desktop 版本及 `codex debug models` 结果。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。