升级 cc-switch 后常见问题汇总

Quick fix

升级到 v4.0 或更高版本，多数旧版同步、切换和显示问题已修复。

Symptom

报错原文复制

打开新版本没有API，显示“还没有添加任何供应商”。

Cause

这些问题大多发生在 cc-switch 3.13.0 及更早版本。当时配置写入、数据库升级和界面刷新逻辑存在缺陷，导致升级或切换后数据不同步。v4.0 重写了供应商切换和配置写入流程，并改进了数据库迁移前的自动备份机制。

Fix

1. 1

   备份当前配置：不要删除 ~/.cc-switch 目录下的任何文件

2. 2

   下载并安装最新版本（v4.0 或更高）

   下载地址

   https://github.com/farion1231/cc-switch/releases/latest

3. 3

   升级后检查供应商列表是否显示正常

4. 4

   如果仍有问题，查看日志文件 ~/.cc-switch/logs/cc-switch.log 并提供给开发者

Affected Versions

Toolcc-switch

Version3.13.0 及更早版本

PlatformsWindowsmacOS

Source Issues

本页汇总自 5 个真实 issue

• #2069v3.13.0版本，切换模型报异常但看setting.json发现实际上切换成功了。
• #2086云备份恢复后，列表不能自动更新
• #2221升级最新版之后，以前保存的API都没了
• #3791为什么无法同步获取大模型,以前的3.14版本是可以的,年毕业输入gpt可以获取的5.5,5.4,5.2等,现在新版本却不行
• #6475Hermes "最新版本" 显示长期为 0.19.0，与官方日期 tag 命名脱节

FAQ

升级后以前的 API 配置都没了怎么办？

先不要删除 ~/.cc-switch 目录，里面可能有自动备份。安装 v4.0 或更高版本，新版本在升级数据库前会自动备份。如果列表仍为空，查看日志文件并联系开发者。

云备份恢复后列表不更新怎么办？

这是 v3.13.0 的已知问题，需要重启应用才能看到更新。v4.0 重写了界面刷新逻辑，下载备份后列表应该会自动更新。

切换模型时提示异常但实际成功了？

这是 v3.13.0 的并发状态问题。v4.0 重写了切换流程，加入了应用级锁，写入结果和失败原因会记录到日志中。

Hermes 最新版本显示不准确？

这是因为 PyPI 上的 hermes-agent 停止更新，而上游已改用 GitHub Releases 发布。修复已提交到 main 分支，将随下一个版本发布。

相关问题

Codex接入第三方模型，对话经常自动中断根因是 cc-switch 把 Codex 的 Responses API 工具调用转成上游 Chat Completions 时丢失了 function call 的 name/call_id；可让 DeepSeek 直连 Codex 绕过代理，或升级 cc-switch 后复测。7 issues merged点击任意按钮会闪烁一次 CC Switch在 Windows 上将 CC Switch 单独改用 WebView2 152.0.4191.62 Fixed Version，可避免 WebView2 153.0.4234.32 的点击闪烁。2 issues mergedsettings.json 被重置 - Claude Code将插件、hooks 等共享字段写入「通用配置」并在切换时勾选写入；接管模式异常时先关闭后切换供应商再开启。12 issues merged