Skip to content
CC Switch WikiUnofficial Community Wiki

Config file sync delay: CC Switch cloud sync directory

Quick fix

After upgrading to 4.0, try built-in WebDAV / S3 cloud sync. If you still use a third-party cloud drive directory, retest and report the drive, version, and…

Symptom

Section titled “Symptom”
Error output
目前只有  CC Switch 退出或重启才会触发文件变更和同步
English translation

Currently, file changes and sync are triggered only when CC Switch exits or restarts.

Cause

Section titled “Cause”

When the config directory is inside a cloud sync directory such as OneDrive or 坚果云, the database also contains runtime data, including request and health check records. Frequent writes increase sync traffic and can delay synchronization. Another report found that config changes after adding a provider seemed to trigger file changes and sync only when CC Switch exited or restarted. A maintainer said the request data table's sync behavior had been adjusted and request data was periodically settled and compressed. A reply to the other issue recommended upgrading to 4.0 and using built-in WebDAV / S3 sync; it did not confirm that using a third-party cloud drive directory was fixed in the latest version.

Fix

Section titled “Fix”

  1. After upgrading to 4.0, try built-in WebDAV / S3 cloud sync in the “Data” section of Settings.

  2. If you still want to keep the config directory in a third-party cloud drive directory, retest on the latest version and report the cloud drive software, CC Switch version, and whether cc-switch.db's modification time changes after adding a provider.

Affected Versions

Section titled “Affected Versions”
ToolCC Switch
Version3.14.1（受影响版本）；维护者建议在 4.0 复测
PlatformsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Why doesn't another computer get the latest config immediately after I add a provider?
The report says that when the config directory is in a cloud sync directory, file changes and sync are triggered only when CC Switch exits or restarts. The maintainer recommended upgrading to 4.0 and using built-in WebDAV / S3 sync. If you still use a third-party cloud drive directory, retest and provide the cloud drive name, version, and cc-switch.db modification time.
Can frequent database writes affect cloud drive sync?
The report says switching providers, requests, and health checks write to the database, causing frequent uploads, longer sync delays, or faster upload traffic consumption. The maintainer replied that the request data table had been excluded from sync and request data was periodically settled and compressed.
Section titled “Related problems”
Configured models not visible - CodexSign in to Codex with an official OpenAI account, retain the official login when switching providers, resave, and restart. Some API Key users report no fix.1 issues mergedBlank or missing model names in /models — OpenCode v2Remove empty name fields from the OpenCode configuration to restore names. Saving again in CC Switch brings the issue back; no official fix is documented.1 issues mergedOMO Configuration Cannot Add Custom subagents - OpenCodeAs a temporary workaround, write all configuration in “Other fields”, but this overwrites the UI configuration above.1 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.