文章 / 觀點與方法
4 min給工具使用者

CC Switch 教學:第一次設定、驗證切換與恢復原設定

CC Switch 第一次設定,先只切換一個工具與一組供應商。確認請求確實送到預期位置,再測試恢復原設定;畫面顯示「已啟用」,還不能證明模型、帳號與計費都切對。

Aaron Huang系統、產品與 AI 實作

CC Switch 第一次設定,先只切換一個工具與一組供應商。確認請求確實送到預期位置,再測試恢復原設定;畫面顯示「已啟用」,還不能證明模型、帳號與計費都切對。

CC Switch:設定供應商、核對請求、恢復原設定;啟用不等於驗證成功。
CC Switch:設定供應商、核對請求、恢復原設定;啟用不等於驗證成功。

搜尋 CC Switch 教學的人,通常已經知道它能管理 AI 工具設定。真正卡住的是:安裝後要填什麼、切換有沒有成功,以及出問題時怎麼回去。我建議把第一次操作當成一次小型搬移,保留原本可用的環境,再逐項核對新設定。

先準備一組你有權使用的供應商設定

CC Switch 的官方入口是 farion1231/cc-switch。Windows 使用者可從官方 Releases 取得安裝包或可攜版本。下載前核對作業系統與檔名,不把搜尋廣告中的充值網站當成官方工具。

這份教學使用 Codex CLI 作為操作情境。CC Switch 管理的工具很多,但不同產品的登入、設定檔與生效方式不能混用;使用 Codex 桌面 App 的人,也不要把 CLI 步驟直接套到 App。

準備項目要確認的內容
原本可用的設定目前工具、供應商名稱與登入方式;先完成一次小測試,確認起點真的能用。
新供應商資料從該供應商官方文件取得 Base URL、模型 ID 與驗證方式,不靠模型猜欄位。
測試材料一段自己寫的公開文字即可,不需要真實專案或私人檔案。
回復依據保留設定備份;敏感金鑰留在本機安全位置,不貼進截圖或公開教學。

以下使用的「研究測試」只是自訂名稱,不是供應商,也不是可直接連線的預設。你必須先有合法可用的服務;安裝 CC Switch 不會自動取得模型額度。

新增設定後,先核對,再啟用

  1. 開啟 CC Switch,選擇你實際使用的工具。本例選 Codex,先不要同步更動其他工具。
  2. 若要保留現有 CLI 設定,可依官方文件在首次啟動時手動匯入,並給它一個容易辨識的名稱,例如「原設定」。確認匯入內容與你原本使用的服務一致。
  3. 選擇「新增供應商」,使用符合服務的預設或自訂設定。名稱可填「研究測試」,其他欄位逐項對照服務商文件。不要把網站首頁當成 API 位址,也不要任意補上請求路徑。
  4. 儲存後重新打開設定,檢查端點、模型與驗證方式;再選取這組供應商並啟用。
  5. 依官方生效說明重啟 Codex CLI,再開始小測試。不同工具的重啟要求不同,不能把某一工具的行為視為全部通用。

第一次不需要一起開代理、故障轉移或多模型自動路由。一次改很多項,就很難知道是哪個設定造成結果變化。

用三項證據確認切換,而不是問 AI 自己是誰

在新的測試對話中,要求 AI 把「星期五下午確認活動場地」整理成一個待辦項目。這只是確認基本請求能完成,不是模型能力比較。

檢查合格條件不能替代它的證據
設定是否生效工具實際設定或可取得的請求紀錄,符合剛選的供應商與模型。CC Switch 按鈕變色。
請求是否完成測試正常回應,沒有登入或模型不存在等錯誤。只有介面沒有錯誤提示。
費用歸屬是否符合預期若服務提供使用紀錄,核對對應時間的請求;尚未更新就保留未確認。AI 用自然語言自稱某個模型。

三項中有一項不確定,就先停在測試。不要用重要任務來驗證新設定是否穩定。

恢復原設定,也要再做一次小測試

若原本就用另一組供應商,切回先前保留的設定,重啟對應工具後再做相同測試。若要恢復官方登入,官方 README 提供的路徑是加入官方登入預設,再重啟 CLI 並依其登入流程操作;這不等於恢復任意第三方設定。

如果之前啟用過代理接管,還要確認請求路徑已回到預期位置。不要只看供應商名稱相同,就認定所有路由都恢復。備份還原若涉及登入資料,也應按該工具的官方流程重新驗證。

失敗時先查改動過的那一層

登入失敗先核對憑證與服務帳號;模型不存在先核對模型 ID;能回答但特定功能失敗,則需要確認供應商對該功能的支援。這些是診斷方向,不是每個錯誤的固定原因。保留錯誤原文,避免在沒有證據時反覆換端點或開更多權限。

第一次設定的完成標準,是你能說明現在使用哪組設定、請求是否成功,以及如何回到原本的狀態。需要了解工具定位,可先讀 CC Switch 工具介紹;涉及換電腦,另見 Codex 備份與還原

來源與驗證範圍

2026-09-14 核對 官方中文 README的基本操作與下載說明。檢查表與測試文字為本篇原創方法。本稿未連接第三方付費 API,也未完成 Windows 全流程實測,不宣稱特定供應商的相容性、價格或穩定性。