Skip to content
CC Switch WikiUnofficial Community Wiki

CC Switch config import / sync not taking effect

Quick fix

Upgrade CC Switch to v3.16.1+, and check that WebDAV / cloud sync and the config write path are syncing correctly.

Symptom

Section titled “Symptom”
Error output
cc-swtich管理的本地自定义技能在技能更新后没有更新，导致无法通过云同步更新另外一台机器的自定义技能
English translation

A local custom skill managed by cc-swtich did not update after the skill itself was updated, so the custom skill on the other machine cannot be updated through cloud sync.

Cause

Section titled “Cause”

This problem spans CC Switch's config import, sync, and persistence path. In some cases the UI or a config write never reaches the target app's config file — Hermes updating only the model: block while providers: stays empty, for instance. In others, cloud sync, WebDAV, SQL import/export, or a local skill update does not refresh. Closed issues show v3.16.0 / v3.16.1 fixed Windows environment detection, Codex config and takeover switching, model catalogue refresh, tool and plugin restoration, and some provider format conversions. But WebDAV sync, SQL import performance, cloud sync of updated local skills, and the jobs directory not being cleaned after deleting a session are all still unresolved in the issues provided.

Fix

Section titled “Fix”

  1. Upgrade CC Switch to v3.16.1 or newer, then re-check config switching, provider saving, and environment detection.

  2. If ~/.hermes/config.yaml is missing its providers: block after a Hermes provider switch, copy the provider config from the CC Switch database into config.yaml by hand as a stopgap.

    ~/.hermes/config.yaml
    providers:
      # 从 CC Switch 当前供应商配置复制 api_key / base_url 等字段

  3. If you sync cc-switch.db with OneDrive, Nutstore, or WebDAV, make sure the sync directory holds only the config data that needs syncing. A cc-switch-<hostname>.db appearing means several machines wrote to the same SQLite file and the cloud drive made a conflict copy.

  4. If a SQL import hangs on "importing" for a long time, upgrade to v3.19.2 or newer and retry. That version switched the export to batched writes and merged the restore into a single transaction.

  5. If CC Switch does not sync a local custom skill after you update it, re-import the skill. The issues do not yet offer a confirmed auto-refresh fix.

Affected Versions

Section titled “Affected Versions”
ToolClaude Code
Version3.12.3 - 3.19.1
PlatformsWindowsmacOSLinux

Source Issues

Section titled “Source Issues”

This page is distilled from 23 real issues

FAQ

Section titled “FAQ”
Why does the Hermes local environment check still fail after upgrading?
Users report version detection problems with hermes even after updating, for example uv trampoline failed to spawn Python child process Caused by: entity not found (os error 2). Keep checking the hermes executable path and whether the Python/uv environment is usable.
Why does putting cc-switch.db on OneDrive or Nutstore cause problems?
cc-switch.db holds runtime data. Switching provider, request logs, and health checks all rewrite the SQLite file frequently, causing constant cloud uploads and sync lag, and possibly a cc-switch-<hostname>.db conflict copy.
WebDAV sync reports MKCOL failed. What now?
On a 502 Bad Gateway, check your tunnel, reverse proxy, or WebDAV service reachability first. If a NAS returns 400 Bad Request for a directory that already exists, analysis in the issue argues CC Switch needs to treat 400 as an already-exists case; no fix is confirmed yet.
Why does the Agents panel still show a Claude Code session I deleted?
When deleting a session cc-switch may remove only the transcript file, without cleaning the session index or job data under ~/.claude/jobs/, so the Claude Code Agents view still shows ghost entries.
Section titled “Related problems”
Codex cannot select models after configurationEnable keep-official-login in Codex app enhancements, then log in again and switch providers to restore the model list.1 issues mergedGemini CLI usage data is not counted - CC SwitchThe consumer Gemini CLI is retired in favour of Antigravity CLI, so CC Switch no longer supports its usage statistics. For template or Grok problems, upgrade.4 issues mergedCodex shows no model list and will not switch modelsTurn on keeping the official login when switching to a third party in cc-switch, and make sure you signed in to official ChatGPT in Codex once.6 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.