CC Switch 使用注意事項｜這 8 個細節決定體驗
整理版優先睇
CC Switch 日常使用最易踩嘅8個坑，跟住避開就順暢
呢篇文章係由H先生整理，佢專注AI工具效率提升，分享CC Switch嘅使用心得。針對已經安裝好CC Switch嘅用戶，日常使用中最容易踩嘅坑全部整理出嚟。作者發現好多人裝好工具之後，用用嚇就會遇到切換失效、Skill重複、密鑰洩漏等麻煩，其實只要注意幾個細節就可以避免。
整體結論好簡單：只要跟住8個細節，就可以大幅減少問題，令CC Switch用得順暢。呢8個細節包括：API密鑰安全（唔好亂存亂傳）、切換時機（部分工具要重啟）、配置備份（每星期做一次）、雲同步（避免多設備同時操作）、Skills管理（只掃描一次，唔好重複導入）、國內中轉站配置（注意URL同模型名）、費用監控（每星期睇統計）、問題排查（用速查錶快速診斷）。
呢篇文章實用性高，特別係用中轉站或者多人共用電腦嘅用戶，更加要留意。H先生仲提供咗常見症狀速查表，同埋一鍵還原嘅終極方案，令用戶遇到問題時有路可循。總括嚟講，呢篇文章係CC Switch用戶必睇嘅避坑指南。
- API密鑰要妥善保管，導出配置文件唔好公開，多人用電腦要開密碼鎖。
- 唔係所有工具都支援熱切換，Claude Code唔使重啟，Codex、Gemini CLI等要重啟，切換前確認工具類型。
- 配置備份要勤做，推薦每次加新供應商同大版本更新前備份，至少每星期一次。
- 雲同步避免多台電腦同時操作，同步前先本地備份，WebDAV用戶要確保網絡穩定。
- Skills只掃描一次，唔好手動重複導入；刪除Skills會影響所有工具，要謹慎。
結構示例
# Windows
%APPDATA%\cc-switch\
# macOS
~/Library/Application Support/cc-switch/
# Linux
~/.config/cc-switch/🔑 API密鑰安全與配置備份
CC Switch 裏填嘅 API 密鑰會保存在本地數據庫，雖然用 SQLite 加密存儲，但有幾個習慣一定要養成。
唔好將導出配置文件發到羣組或 GitHub
導出備份時揀個安全位置，唔好放桌面。如果係公司電腦多人用，記得到設定 → 進階 → 開啟「啟動密碼鎖」，離開前鎖屏。
- 方法一：界面導出——設定 → 通用 → 數據管理 → 點「導出配置」，會生成 .json 檔。
- 方法二：手動複製數據庫——Windows 喺 %APPDATA%\cc-switch，macOS 喺 ~/Library/Application Support/cc-switch，Linux 喺 ~/.config/cc-switch/，成個 folder 抄走就得。
🔄 切換時機與雲同步
呢個係最易誤解嘅地方：唔係所有工具都支援熱切換。Claude Code 自動熱重載，但 Codex、Gemini CLI、OpenCode 呢啲就要重啟終端或重新執行命令。建議切換前先確認當前用緊邊個工具，同埋唔好喺跑長任務嘅時候切。
切換前確認工具類型，Codex/Gemini 需要重啟終端
雲同步方面，CC Switch 支援 Dropbox、OneDrive、iCloud、WebDAV。開同步前一定要先本地備份，因為同步過程可能出現衝突。最緊要嘅係：唔好兩部電腦同時改配置，改完一部等同步完成先改另一部。
⚡ Skills管理與中轉站配置
Skills 導入只做一次就得，重複導入會令所有 Skill 變成兩份，刪除時刪唔曬，最後要重裝。正確做法係喺任何一個工具裝好 Skill 後，開 CC Switch → Skills 管理 → 點「掃描」，佢會自動發現新裝嘅 Skill，唔使手動導入。
刪除 Skill 喺 CC Switch 會從所有工具一齊刪除，要特別謹慎
- 1 Base URL 要填完整地址，唔好漏咗 /v1 之類嘅路徑，否則會 404。
- 2 模型名稱要同中轉站文檔一致，唔同名會報錯。
- 3 開啟「跳過初次安裝確認」，避免每次彈窗。
- 1 Base URL 填完整地址，例如 https://api.example.com/v1，唔好加多或加少。
- 2 模型名稱要匹配中轉站嘅叫法，例如官方 claude-sonnet-4-20250514 中轉站可能叫 sonnet-4。
- 3 開啟「跳過初次安裝確認」，慳返彈窗麻煩。
📊 費用監控與問題排查
CC Switch 有使用統計功能，喺設定 → 使用統計可以睇到每個供應商嘅調用次數、Token 消耗同各工具使用頻率。建議每星期睇一次，特別係用按量付費中轉站嘅用戶。
發現用量暴增可能係代碼死循環，要即刻檢查
出問題時先睇常見症狀速查表：切換後工具讀舊設定 → 重啟終端或電腦；API 401 → 密鑰過期或填錯；404 → Base URL 錯誤；超時 → 網絡問題或中轉站死咗；Skills 消失 → 符號連結斷咗，重新導入一次。終極方案係備份數據目錄後成個刪除，再重新打開 CC Switch 恢復。
裝好咗 CC Switch，切換又順暢，但用用嚇就出問題？ 呢篇文章將日常使用中最易踩嘅坑全部整理曬出嚟。
🔑 一、API 密鑰安全
密鑰唔好亂存、唔好亂傳
CC Switch 裏面填嘅 API 密鑰會儲存喺本地數據庫入面。 雖然佢用 SQLite 加密儲存，但有幾個習慣要養成：
不要 將導出嘅配置文件 send 去羣組或者 GitHub 配置文件入面明文包含你嘅 API Key 導出備份時揀個安全位置，唔好放桌面
多人共用電腦點算？
如果公司電腦多人用，記得：
設定 → 進階 → 開啟「啟動密碼鎖」 離開位前鎖屏，防止其他人誤操作切換你嘅配置
🔄 二、切換供應商嘅時機
唔係所有工具都支援熱切換
呢個係最易誤解嘅地方：
建議： 切換前先確認而家用緊嘅工具係邊個。 正在跑緊長任務嘅時候唔好切，容易斷纜。
📦 三、配置備份要勤力做
備份方法（兩種）
方法一：界面導出設定 → 一般 → 數據管理 → 撳「導出配置」 會產生一個 .json 文件，包含所有供應商同密鑰資料。
方法二：手動複製數據庫CC Switch 嘅數據放喺呢度：
# Windows
%APPDATA%\cc-switch\
# macOS
~/Library/Application Support/cc-switch/
# Linux
~/.config/cc-switch/成個文件夾 copy 一份就係完整備份。
備份頻率建議
每次加新供應商之後備份一次 每次大版本更新前備份一次 至少每星期一次自動備份（可以配合雲端同步）
☁️ 四、雲端同步唔好踩坑
CC Switch 支援 Dropbox / OneDrive / iCloud / WebDAV 雲端同步。
開啟前注意
先本地備份再開同步同步過程中可能會出現衝突，有備份先可以回滾
多部電腦唔好同時操作兩部電腦同時改配置，同步時會產生衝突文件 改完一部，等同步完成，再去另一部改
WebDAV 用戶檢查連接自建 NAS 做 WebDAV 同步嘅話，確保網絡穩定 斷線同步可能會導致配置損壞
🛠️ 五、Skills 管理嘅細節
導入 Skills 只做一次
之前安裝篇講過，但日常使用仲有人重複導入：
導入兩次 = 所有 Skill 出現兩份 刪除時刪唔到（因為有兩份） 最後只能重裝解決
安裝新 Skill 嘅正確流程
喺任何一個工具度裝好 Skill（例如 Claude Code） 打開 CC Switch → Skills 管理 撳「掃描」→ 自動發現新裝嘅 Skill 唔需要手動導入，掃描就夠
刪除 Skill 要小心
CC Switch 裏面刪除 Skill = 喺所有工具裏面都刪除 唔係淨係刪某一個工具嘅。 想保留嘅話，先確認其他工具唔需要呢個 Skill。
⚡ 六、國內中轉站配置要點
用中轉站要注意呢三點
① Base URL 填啱位置中轉站俾嘅地址通常係咁：
https://api.example.com/v1CC Switch 裏面填「自訂」供應商時，直接貼完整地址就得。 唔好加多或者減少 /v1，否則 404。
② 模型名稱要匹配中轉站嘅模型名可能同官方唔一樣：
官方叫 claude-sonnet-4-20250514中轉站可能會叫 claude-sonnet-4或sonnet-4
填之前睇一睇中轉站嘅文檔，模型名唔啱會報錯。
③ 開啟「跳過初次安裝確認」用中轉站基本上都唔會行官方認證流程。 設定度將呢個選項打開，省卻每次彈窗確認嘅麻煩。
📊 七、費用監控唔好忽略
CC Switch 有使用統計功能
設定 → 使用統計，可以睇到：
每個供應商調用咗幾多次 大約消耗咗幾多 Token 各工具嘅使用頻率
建議每星期睇一次
特別係用按量付費嘅中轉站：
發現某日用量暴增 → 可能係代碼死循環調用 發現某個工具異常頻繁 → 檢查係咪被誤觸 接近額度上限 → 提前充值或者換供應商
🐛 八、出咗問題點樣排查
常見症狀速查表
終極方案：一鍵還原
如果搞咗好耐都仲係唔得：
關閉 CC Switch 備份當前數據目錄（如果開得到嘅話） 刪除成個數據目錄 重新打開 CC Switch（會好似首次使用咁） 從備份還原或重新配置
💡 總結一張清單
日常使用記住呢 8 條就夠：
✅ API 密鑰唔外傳，導出文件妥善保管 ✅ 切換前確認工具類型，Codex/Gemini 需要重啓終端 ✅ 每星期備份一次配置，更新前必備份 ✅ 雲端同步唔同時操作多部設備 ✅ Skills 掃描就得，唔好重複導入 ✅ 中轉站注意 URL 同模型名匹配 ✅ 每星期查看使用統計，監控費用 ✅ 出問題先查速查表，唔得就一鍵還原
如果呢篇內容對你有幫助，歡迎收藏備用。 有問題歡迎留言區交流。
點讚同關注唔迷路，之後仲會分享更多 AI 效率工具。
👨💻 H先生出品 | 專注 AI 工具與效率提升
裝好了 CC Switch，切換也順暢，但用着用着就出問題？ 這篇文章把日常使用中最容易踩的坑全整理出來了。
🔑 一、API 密鑰安全
密鑰別亂存、別亂傳
CC Switch 裏填的 API 密鑰會保存在本地數據庫裏。 雖然它用的是 SQLite 加密存儲，但有幾個習慣要養成：
不要 把導出的配置文件發到羣裏或 GitHub 配置文件裏明文包含你的 API Key 導出備份時選個安全位置，別放桌面
多人共用電腦怎麼辦？
如果公司電腦多人使用，記得：
設置 → 高級 → 開啓「啓動密碼鎖」 離開工位前鎖屏，防止別人誤操作切換你的配置
🔄 二、切換供應商的時機
不是所有工具都支持熱切換
這是最容易誤解的地方：
建議： 切換前先確認當前在用的工具是哪個。 正在跑長任務的時候別切，容易中斷。
📦 三、配置備份要勤做
備份方法（兩種）
方法一：界面導出設置 → 通用 → 數據管理 → 點「導出配置」 會生成一個 .json 文件，包含所有供應商和密鑰信息。
方法二：手動複製數據庫CC Switch 的數據存在這裏：
# Windows
%APPDATA%\cc-switch\
# macOS
~/Library/Application Support/cc-switch/
# Linux
~/.config/cc-switch/整個文件夾拷貝一份就是完整備份。
備份頻率建議
每次添加新供應商後備份一次 每次大版本更新前備份一次 至少每週一次自動備份（可配合雲同步）
☁️ 四、雲同步別踩坑
CC Switch 支持 Dropbox / OneDrive / iCloud / WebDAV 雲同步。
開啓前注意
先本地備份再開同步同步過程中可能出現衝突，有備份才能回滾
多台電腦不要同時操作兩台電腦同時改配置，同步時會產生衝突文件 改完一台，等同步完成，再去另一台改
WebDAV 用戶檢查連接自建 NAS 做 WebDAV 同步的話，確保網絡穩定 斷網同步可能導致配置損壞
🛠️ 五、Skills 管理的細節
導入 Skills 只做一次
前面安裝篇說過，但日常使用中還有人重複導入：
導入兩次 = 所有 Skill 出現兩份 刪除時刪不掉（因為有兩份） 最後只能重裝解決
安裝新 Skill 的正確流程
在任意一個工具裏裝好 Skill（比如 Claude Code） 打開 CC Switch → Skills 管理 點「掃描」→ 自動發現新裝的 Skill 不用手動導入，掃描就夠了
刪除 Skill 要謹慎
CC Switch 裏刪除 Skill = 從所有工具裏都刪除 不是隻刪某一個工具的。 想保留的話，先確認其他工具不需要這個 Skill。
⚡ 六、國內中轉站配置要點
用中轉站要注意這三點
① Base URL 填對位置中轉站給的地址一般是這樣：
https://api.example.com/v1CC Switch 裏填「自定義」供應商時，直接粘貼完整地址就行。 別多加或少加 /v1，否則 404。
② 模型名稱要匹配中轉站的模型名可能和官方不一樣：
官方叫 claude-sonnet-4-20250514中轉站可能叫 claude-sonnet-4或sonnet-4
填之前看一眼中轉站的文檔，模型名不對會報錯。
③ 開啓「跳過初次安裝確認」用中轉站基本都不會走官方認證流程。 設置裏把這個選項打開，省去每次彈窗確認的麻煩。
📊 七、費用監控別忽略
CC Switch 有使用統計功能
設置 → 使用統計，可以看到：
每個供應商調用了多少次 大概消耗了多少 Token 各工具的使用頻率
建議每週看一次
特別是用按量付費的中轉站：
發現某天用量暴增 → 可能是代碼死循環調用 發現某個工具異常頻繁 → 檢查是否被誤觸 接近額度上限 → 提前充值或換供應商
🐛 八、出了問題怎麼排查
常見症狀速查表
終極方案：一鍵還原
如果折騰半天還是不行：
關閉 CC Switch 備份當前數據目錄（如果能打開的話） 刪除整個數據目錄 重新打開 CC Switch（會像首次使用一樣） 從備份恢復或重新配置
💡 總結一張清單
日常使用記住這 8 條就夠了：
✅ API 密鑰不外傳，導出文件妥善保管 ✅ 切換前確認工具類型，Codex/Gemini 需要重啓終端 ✅ 每週備份一次配置，更新前必備份 ✅ 雲同步不同時操作多台設備 ✅ Skills 掃描即可，別重複導入 ✅ 中轉站注意 URL 和模型名匹配 ✅ 每週查看使用統計，監控費用 ✅ 出問題先查速查表，不行就一鍵還原
如果這篇內容對你有幫助，歡迎收藏備用。 有問題歡迎評論區留言交流。
點點贊和關注不迷路，後續還會分享更多 AI 效率工具。
👨💻 H先生出品 | 專注 AI 工具與效率提升