跳转到内容

CC Switch 配置导入/同步不生效

Quick fix

升级 CC Switch 到 v3.16.1+,并检查 WebDAV/云同步与配置写入路径是否被正确同步。

报错原文
cc-swtich管理的本地自定义技能在技能更新后没有更新,导致无法通过云同步更新另外一台机器的自定义技能

该问题涉及 CC Switch 的配置导入、同步与持久化链路。部分场景是 UI 或配置写入后没有同步到目标应用的配置文件,例如 Hermes 只更新 model: 块而 providers: 块为空;部分场景是云同步、WebDAV、SQL 导入导出或本地技能更新后未刷新。已关闭 issue 显示 v3.16.0 / v3.16.1 修复了 Windows 环境检测、Codex 配置/接管切换、模型目录刷新、工具/插件恢复和部分 provider 格式转换问题;但 WebDAV 同步、SQL 导入性能、本地 skill 云同步更新、删除会话后 jobs 目录未清理等问题在提供的 issue 中仍未完全解决。

  1. 升级 CC Switch 到 v3.16.1 或更新版本,然后重新验证配置切换、供应商保存和环境检测。

  2. 如果是 Hermes 供应商切换后 ~/.hermes/config.yaml 缺少 providers: 配置,临时手动从 CC Switch 数据库复制供应商配置到 config.yaml。

    ~/.hermes/config.yaml
    providers:
    # 从 CC Switch 当前供应商配置复制 api_key / base_url 等字段
  3. 如果使用 OneDrive、坚果云或 WebDAV 同步 cc-switch.db,确认同步目录只包含需要同步的配置数据;若出现 cc-switch-<hostname>.db,说明多设备写入同一 SQLite 文件触发网盘冲突副本。

  4. 如果 SQL 导入长时间卡在“导入中”,升级到 v3.19.2 或更新版本后重试;该版本将导出改为批量写入,并把恢复合并进单个事务。

  5. 如果本地自定义 skill 更新后 CC Switch 未同步,重新导入该 skill;当前 issue 未给出已确认的自动刷新修复。

ToolClaude Code
Version3.12.3 - 3.19.1
PlatformsWindowsmacOSLinux

本页汇总自 23 个真实 issue

为什么升级后 Hermes 本地环境检查仍然失败?
有用户反馈更新后仍出现 hermes 检测版本问题,例如 uv trampoline failed to spawn Python child process Caused by: entity not found (os error 2)。需要继续检查 hermes 可执行文件路径、Python/uv 环境是否可用。
把 cc-switch.db 放到 OneDrive 或坚果云为什么会出问题?
cc-switch.db 会保存运行期数据,切换 provider、请求日志或健康检测都会频繁改写 SQLite 文件,导致云盘频繁上传、同步延迟,并可能生成 cc-switch-<hostname>.db 冲突副本。
WebDAV 同步报 MKCOL 失败怎么办?
如果是 502 Bad Gateway,先检查内网穿透、反向代理或 WebDAV 服务可达性;如果是 NAS 对已存在目录返回 400 Bad Request,issue 中分析认为需要 CC Switch 将 400 纳入已存在目录的容错逻辑,当前未确认修复。
删除 Claude Code 会话后 Agents 面板为什么还显示?
cc-switch 删除会话时可能只删除 transcript 文件,没有同步清理 ~/.claude/jobs/ 下的会话索引或任务数据,导致 Claude Code Agents View 仍显示幽灵条目。

这是一个非官方社区 wiki,与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。