apikey无权限或失效 - Claude Code 获取模型列表
Quick fix
先用 curl 验证 /v1/models 权限；确认 Key 无空格或 Bearer 前缀，接口未开放时手动填写模型名。
Symptom
Section titled “Symptom”apikey无权限或失效CC Switch 会按 OpenAI 兼容协议请求 `{Base URL}/v1/models`，并发送 `Authorization: Bearer <API Key>`。只要该接口返回 401/403，前端就会显示“API Key 无效或无权限”；这不一定表示 Key 已失效，也可能是服务商未开放模型列表接口，或该 Key 只有对话接口权限。火山 agent-plan、火山 coding-plan、智谱 coding-plan 也有获取失败的报告，但这些 issue 没有给出已确认的供应商侧解决方案。
该组 issue 还包含不同变体：v3.14.1 的“请先填写 API Key”被维护者称已在 v3.15.0 修复，但 v3.16.1 至 v3.16.5 仍有人报告获取失败；另有 Windows 用户的 curl 返回正常，而 CC Switch 连接失败。因此，升级只能解决部分已知问题，不能证明所有模型列表失败都已修复。
检查 API Key 输入框，只填写纯 Key，删除前后空格、换行以及误粘贴的 `Bearer ` 前缀。
使用同一个 Key 请求服务商的模型列表接口，例如运行 `curl -H "Authorization: Bearer YOUR_KEY" https://windhub.cc/v1/models`。
如果 curl 返回 401/403，请联系服务商确认该 Key 是否具有 `/v1/models` 权限，以及服务商是否开放了该接口。
如果对话接口可用但模型列表接口未开放，可先手动填写模型名继续使用。
如果使用 v3.14.1 时出现“请先填写 API Key”，升级到维护者标明已修复该问题的 v3.15.0 或更新版本。
如果 curl 返回 200 但 CC Switch 仍失败，请提交 CC Switch 版本、系统、Base URL 和相关日志，且不要提交 API Key。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 5 个真实 issue
- 这是 bug 还是什么问题？
- 可能是不同原因：v3.14.1 的“请先填写 API Key”被维护者确认为已在 v3.15.0 修复；401/403 则可能表示 Key 无权访问 `/v1/models`，并不一定是 Key 失效。
- 为什么同一个 Key 别人能获取模型列表，我这里却提示无权限或失效？
- 先检查 Key 是否带有空格、换行或 `Bearer ` 前缀，再用相同 Key 直接请求 `/v1/models`。如果 curl 成功而 CC Switch 失败，需要结合版本、系统、Base URL 和日志继续排查。
- 无法获取模型列表时还能使用吗？
- 如果对话接口实际可用，只是模型列表接口没有开放或没有权限，可以手动填写模型名继续使用。
- 火山 agent-plan、火山 coding-plan 或智谱 coding-plan 获取失败怎么办？
- 这些服务在输入 issue 中有失败报告，但没有给出已确认的修复；应先验证对应 Base URL 的 `/v1/models` 接口及 Key 权限。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。