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 不會自動取得模型額度。
新增設定後,先核對,再啟用
- 開啟 CC Switch,選擇你實際使用的工具。本例選 Codex,先不要同步更動其他工具。
- 若要保留現有 CLI 設定,可依官方文件在首次啟動時手動匯入,並給它一個容易辨識的名稱,例如「原設定」。確認匯入內容與你原本使用的服務一致。
- 選擇「新增供應商」,使用符合服務的預設或自訂設定。名稱可填「研究測試」,其他欄位逐項對照服務商文件。不要把網站首頁當成 API 位址,也不要任意補上請求路徑。
- 儲存後重新打開設定,檢查端點、模型與驗證方式;再選取這組供應商並啟用。
- 依官方生效說明重啟 Codex CLI,再開始小測試。不同工具的重啟要求不同,不能把某一工具的行為視為全部通用。
第一次不需要一起開代理、故障轉移或多模型自動路由。一次改很多項,就很難知道是哪個設定造成結果變化。
用三項證據確認切換,而不是問 AI 自己是誰
在新的測試對話中,要求 AI 把「星期五下午確認活動場地」整理成一個待辦項目。這只是確認基本請求能完成,不是模型能力比較。
| 檢查 | 合格條件 | 不能替代它的證據 |
|---|---|---|
| 設定是否生效 | 工具實際設定或可取得的請求紀錄,符合剛選的供應商與模型。 | CC Switch 按鈕變色。 |
| 請求是否完成 | 測試正常回應,沒有登入或模型不存在等錯誤。 | 只有介面沒有錯誤提示。 |
| 費用歸屬是否符合預期 | 若服務提供使用紀錄,核對對應時間的請求;尚未更新就保留未確認。 | AI 用自然語言自稱某個模型。 |
三項中有一項不確定,就先停在測試。不要用重要任務來驗證新設定是否穩定。
恢復原設定,也要再做一次小測試
若原本就用另一組供應商,切回先前保留的設定,重啟對應工具後再做相同測試。若要恢復官方登入,官方 README 提供的路徑是加入官方登入預設,再重啟 CLI 並依其登入流程操作;這不等於恢復任意第三方設定。
如果之前啟用過代理接管,還要確認請求路徑已回到預期位置。不要只看供應商名稱相同,就認定所有路由都恢復。備份還原若涉及登入資料,也應按該工具的官方流程重新驗證。
失敗時先查改動過的那一層
登入失敗先核對憑證與服務帳號;模型不存在先核對模型 ID;能回答但特定功能失敗,則需要確認供應商對該功能的支援。這些是診斷方向,不是每個錯誤的固定原因。保留錯誤原文,避免在沒有證據時反覆換端點或開更多權限。
第一次設定的完成標準,是你能說明現在使用哪組設定、請求是否成功,以及如何回到原本的狀態。需要了解工具定位,可先讀 CC Switch 工具介紹;涉及換電腦,另見 Codex 備份與還原。
來源與驗證範圍
2026-09-14 核對 官方中文 README的基本操作與下載說明。檢查表與測試文字為本篇原創方法。本稿未連接第三方付費 API,也未完成 Windows 全流程實測,不宣稱特定供應商的相容性、價格或穩定性。