Files
cc-switch/README_ZH-TW.md
T
Jason 0a77d82808 chore(presets): point 9527CODE website and sign-up links to the CC Switch channel
Replace the affiliate sign-up link (register?aff=e5zI) with
https://9527.codes/register?channel=ccs in the eight READMEs and in the
apiKeyUrl and websiteUrl of all nine 9527CODE presets. API base URLs and
endpoint candidates are unchanged.
2026-11-14 03:59:30 -08:00

64 KiB
Raw Blame History

CC Switch

Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes Agent、Pi、MiniMax Code、Kimi Code 與 Oh My Pi 的全方位管理工具

一鍵切換 API 供應商,集中管理 MCP、Skills 與提示詞,不必再手動編輯 JSON / TOML / YAML 設定檔。

Version Platform Built with Tauri Downloads

farion1231%2Fcc-switch | Trendshift Star History Rank

farion1231%2Fcc-switch | Trendshift farion1231%2Fcc-switch | Trendshift farion1231%2Fcc-switch | Trendshift

🌐 唯一官方網站:ccswitch.io

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe | Русский | Deutsch | 更新日誌

下載與安裝 · 快速開始 · 功能特性 · 常見問題 · 使用手冊

❤️贊助商

想出現在這裡?

點擊收合

Kimi K3.1 Pro

Kimi K3.1 Pro 是 Moonshot AI 迄今最強的 3T 級開放權重模型,支援 100 萬 Token 的上下文視窗。它以 Kimi K3 為基礎,投入大幅增加的後訓練算力,在程式開發、Agent 工作流程、3D 創作與推理等方面都有持續進步。透過 CC Switch,你可以輕鬆在各種 Agentic 工具中設定並切換到 Kimi K3.1 Pro。

試試 Kimi Code 方案(中文站 | Global),或透過 Kimi 開放平台使用 API(中文站 | Global)。

新用戶首儲回饋:透過上方 API 連結註冊並完成首次儲值,即可獲贈儲值金額 10% 的 API 額度,最高 CNY ¥1,000。


AICodeMirror 感謝 AICodeMirror 贊助本專案!AICodeMirror 為 Claude Code / Codex / Gemini CLI 提供官方高穩定性中轉服務,具備企業級併發能力、快速開立發票與 7×24 小時專屬技術支援。 Claude Code / Codex / Gemini 官方通道分別低至原價的 38% / 2% / 9%,儲值還有額外折扣!AICodeMirror 為 CC Switch 用戶準備了專屬福利:透過此連結註冊,首次儲值可享 8 折優惠,企業客戶最高可享 75 折!
PackyCode 感謝 PackyCode 贊助本專案!PackyCode 是一家穩定、高效的 API 中轉服務商,提供 Claude Code、Codex、Gemini 等中轉服務。PackyCode 為本軟體的使用者提供專屬優惠:透過此連結註冊,首次儲值時輸入優惠碼「cc-switch」即可享 9 折優惠。
APINebula 感謝 APINEBULA 贊助本專案!APINEBULA 是銀河視頻局旗下的企業級 AI 聚合平台,憑藉豐富的平台資源,為開發者、團隊與企業提供穩定且高性價比的大型語言模型 API 服務。平台整合 Claude、GPT、Gemini 等頂尖滿血模型,只需一組 API 即可連接全球頂級 AI 模型,價格最低可至原價的 10%。專為 AI 程式開發、Agent 開發與業務系統整合設計,APINEBULA 支援企業級高併發、正式合約、對公轉帳與發票服務。APINEBULA 為本軟體的使用者提供專屬優惠:透過此連結註冊,首次儲值時輸入優惠碼 「ccswitch」 即可享 9 折優惠。
PatewayAI 感謝 PatewayAI 贊助本專案!PatewayAI 是為資深 AI 開發者打造的 API 中轉服務商,全面支援 Claude、GPT 系列與多款主流國產模型。所有模型均來自官方優質通道,絕不摻水、絕不造假,並提供透明可查的計費明細。 經濟模式最低可至原價的 5%。透過此連結註冊即可獲得 $1 免費體驗額度,還能參加不定期活動領取更多免費額度。 平台同時支援企業級併發、專屬管理後台、正式合約與發票,並提供雙向邀請儲值回饋,最高可達 $150。
hao.ai 感謝 hao.ai 贊助本專案!hao.ai 是為開發者與團隊打造的快速、穩定的統一 LLM API 閘道。只需一組 API Key 與統一介面,即可存取 GPT、Claude、xAI Grok 等頂尖模型,並相容 OpenAI、Anthropic 等常見協定與 SDK。平台提供模型路由、故障轉移、團隊管理與完整的請求日誌,模型價格最低可至官方參考價的 15%,讓建構 AI 應用更簡單、更穩定、更省錢。hao.ai 為 CC Switch 用戶提供專屬福利:透過此連結註冊,首單即可額外獲得 5% 贈送額度!
Fenno.ai 感謝 Fenno.ai 贊助本專案!Fenno.ai 是一家穩定、高效的 API 中轉服務商,目前專注於 Codex 中轉。它相容 OpenAI 與 Anthropic 協定,可靈活用於 Codex、Claude Code、OpenCode 等主流程式開發工具,穩定支撐每日數千億 Token 的企業級負載,並支援境內外主體的企業(B2B)結算與發票。Fenno.ai 為 CC Switch 用戶提供專屬福利:透過此連結訂閱 $1.99 體驗方案,即可獲得價值 $50 的額度(有效期 7 天),並可賺取最高 20% 的推薦獎勵,邀請越多賺越多!
OpenModel 感謝 OpenModel 贊助本專案!OpenModel 針對特定用戶端提供專屬折扣:在支援的模型上,Codex 最高 1 折、Claude Code 最高 4 折,幫助開發者在不改變使用習慣的前提下降低 API 成本。只需連接你的 OpenModel API Key,照常使用 Codex 或 Claude Code 即可,系統會自動偵測支援的用戶端並套用折扣路由,無需額外參數或手動設定路由。你還可以為每個 API Key 單獨設定備援行為,選擇在折扣路由暫時不可用時以標準價格繼續使用,或直接停止。CC Switch 用戶可透過此連結註冊,並使用優惠碼 「cc-switch」 享首次儲值 9 折優惠。
GrooRoute Pro 感謝 GrooRoute Pro 贊助本專案!GrooRoute Pro 是一個可靠、流暢的 AI API 中轉平台,可存取 OpenAI、Claude、DeepSeek 等主流模型。它部署在海外伺服器上,可自選計費倍率檔位,並同時提供按量計費與訂閱方案,讓你依需求靈活選擇,線路穩定、回應迅速,讓呼叫各種 AI 能力更輕鬆。CC Switch 用戶專屬福利:透過此連結註冊,即可獲得 ¥5 免費體驗額度!
BuyToken 感謝 BuyToken 贊助本專案!BuyToken 提供 Claude Code、Codex、DeepSeek 等中轉服務,具備企業級併發與快速開立發票能力,致力於打造穩定、可長期營運的服務。BuyToken 也為 CC Switch 用戶準備了專屬優惠:透過此連結註冊即可獲得 ¥3 體驗額度,首次儲值另享 9 折!
V-API 感謝 V-API 贊助本專案!V-API 是一個已營運三年的品牌,致力於為個人、開發者與企業提供穩定、快速、安全的高品質 LLM API 服務平台,並支援正式合約與正規發票(一般 / 專用增值稅發票)。V-API 為 CC Switch 用戶提供專屬優惠:透過此連結註冊,首單即可立減 ¥2 並享 9 折!
FluxA TokenPlan 感謝 FluxA 與百度智能雲贊助本專案!FluxA 與百度智能雲聯合推出 AgenticPlan,讓 AI Agent 具備自主購買、管理與使用模型、API 和工具的能力。其中包含最高 6 折的百度千帆 TokenPlan,可使用 DeepSeek V4、GLM 5.2、Kimi 等旗艦模型,另贈 FluxA AgentMarket API 額度,可解鎖 13,000+ 個涵蓋搜尋、資料擷取、社群媒體、金融、加密貨幣、圖像生成、影片等領域的付費 API。
在使用者授權下,AI Agent 還可使用官方 Visa 卡自主付款採購資源、管理 API Key、監控用量並規劃續訂,讓 Agent 從「自主完成任務」邁向真正的「自行規劃預算並完成任務」。透過此連結購買!
AIGoCode 感謝 AIGoCode 贊助本專案!AIGoCode 是一個訂閱制的 AI 程式開發平台,而不只是按 Token 計費。一個帳號、一份月費方案即可使用 Claude Code、Codex 與 Gemini,中國大陸可直連且回應迅速。透過此連結訂閱,可額外獲得 10% 的額度!
TeamoRouter 感謝 TeamoRouter 贊助本專案!TeamoRouter 是為開發者、AI 團隊與企業打造的企業級 Agentic LLM 閘道。無需任何訂閱,即可透過單一統一 API 使用 Claude Code、Codex、Gemini CLI、OpenAI Codex 等熱門 AI Agent,API 價格最低可享 1 折。 有別於一般 API 中轉服務,TeamoRouter 聚合了數百家官方模型供應商與可信的基礎設施夥伴,包括 OpenAI、Anthropic、Vertex、Azure 與 AWS Bedrock。每家供應商都經過 100% Agent 協定相容性、快取表現與請求可追溯性的驗證,確保品質穩定,而非逆向或摻水的端點。平台提供近乎官方的 TTFT、99.6% SLA、最高 5,000 QPM 的企業級吞吐量,以及業界領先的快取命中率,大幅降低長時間運行的 Agent 工作流程的 Token 成本。 TeamoRouter 也提供集中計費、團隊管理、BYOK、智慧路由、用量分析、動態供應商最佳化與專屬支援等企業功能。若想要更簡單的體驗,Teamo Desktop 可一鍵設定並使用 Claude Code、Codex、Gemini CLI 等熱門 AI Agent,無需管理 API Key,也不必手動設定閘道。新用戶透過此連結註冊,即可享首次儲值 9 折優惠。
AICoding 感謝 AICoding 贊助本專案!AICoding——全球 AI 模型 API 中轉服務,價格無可匹敵!Claude Code 低至原價的 19%,GPT 僅需 1%!深受數百家企業信賴的高性價比 AI 服務。支援 Claude Code、GPT、Gemini 及主流國產模型,具備企業級高併發、快速開立發票與 7×24 小時專屬技術支援。透過此連結註冊的 CC Switch 用戶,首次儲值可享 9 折優惠!
SubRouter 感謝 SubRouter 贊助本專案!SubRouter 是面向 AI 服務營運者的市集與智慧路由平台。商家可以架設營運站點、發布套餐、管理使用者、模型與定價,使用者則可探索各項服務,並透過統一 API 存取可靠的 AI 模型。透過此連結註冊!
RunAPI 感謝 RunAPI 贊助本專案!RunAPI 是一個高性能且可靠的 AI 模型 API 閘道,一組 API Key 即可存取 OpenAI、Claude、Gemini、DeepSeek、Grok 等 150+ 款主流模型,價格最低可至官方價的 10%,穩定性出色。可與 Claude Code、OpenClaw 等工具無縫搭配。CC Switch 用戶專屬福利:透過此連結註冊,首次儲值即可享 9 折優惠!
OspreyAI 感謝 OspreyAI 贊助本專案!ACS OspreyAI 是為開發者與企業打造的一站式多模型 API 平台。一組 API Key 即可存取國內外頂尖模型,包括 Claude、Gemini、GPT、GLM、Kimi、Qwen、DeepSeek 與騰訊混元。平台相容 OpenAI、Anthropic 等主流 API 協定,並適用於 Claude Code、Codex、OpenCode、Pi、Hermes 等熱門 AI 工具。國際模型比官方價格低 20–40%,國產模型低 30–50%。統一儲值、統一計費、用量追蹤與靈活的模型切換,適合 AI 應用開發、內容生產與自動化工作流程。透過此連結建立帳號即可享優惠,快速接入國內外頂尖模型。
Shengsuanyun 感謝勝算雲贊助本專案!勝算雲是服務 AI Native 團隊的超級工廠,是工業級的 AI 任務並行執行平台。其模型市集聚合 Claude、ChatGPT、Gemini 等國內外 LLM 與多媒體模型能力,直接供應。絕不逆向、絕不摻水,全平台模型 SLA 可用性達 99.7%,監控看板全線飄綠。同時提供企業級自訂閘道,可精細管理團隊成本與權限,並具備智慧路由、安全防護與 BYOK(自帶 Key)託管。平台採按量付費與 Token 方案(即將推出)計費,可開立發票。新用戶透過此連結註冊,即可獲得 ¥10 額度,首次儲值另贈 10%。
88API 感謝 88API Token 聚合平台贊助本專案!88API 是一家香港公司營運的一站式多模型 API 平台,主要面向開發者、創作者與 AI 應用使用者。透過統一介面即可存取文字、圖像、語音與影片模型,涵蓋 AI 程式開發、智慧翻譯、內容創作、配音、圖像生成與影片生成等常見工作流程。你可以直接在 CC Switch 中將它新增為供應商並切換使用。88API 支援主流國際支付方式,可開立發票,並提供企業級穩定服務。透過此連結註冊即可獲得專屬贈送額度!
APIKEY.FUN 感謝 APIKEY.FUN 贊助本專案!APIKEY.FUN 是一個專業的企業級 AI 中轉平台,致力於為企業與個人開發者提供穩定、高效且低成本的 AI 模型 API 存取。平台支援 Claude、OpenAI、Gemini 等熱門主流模型,價格最低可至官方價的 7%。透過本專案的專屬連結註冊,即可享最高永久儲值 95 折的專屬優惠。
9527CODE 感謝 9527CODE 贊助本專案!9527 CODE 是專注於穩定性與服務品質的企業級全能力 AI 中轉平台,為 Claude Code、Codex 等主流 AI 模型提供快速、穩定、高品質的中轉服務。它更重視長期穩定、線路品質與持續可用性,為企業與重度 AI 用戶提供穩定高效的一站式模型接入方案。已連續營運一年,服務穩定性達 99.9%,並提供 7×24 小時真人技術支援。透過本專案的專屬連結註冊,新用戶可聯繫客服領取體驗額度,邀請返現不設上限!
PPIO 感謝 PPIO 贊助本專案!PPIO 是中國領先的獨立 Agentic Cloud 服務商,由 PPTV 創辦人姚欣與前 PPTV 首席架構師王聞宇於 2018 年共同創立。一組 API Key 即可存取所有旗艦開源模型,包括 DeepSeek-V4-Flash、Kimi-K3、GLM-5.2 與 MiniMax-M3;企業 Token Plan 最低可享 6 折並支援 200 個席位,Fusion 混合模型以十分之一的價格媲美 Fable5。透過此連結註冊並完成實名認證,即可獲得 ¥10 代金券,邀請好友儲值還可賺取其消費金額最高 15% 的返現。
new-api 感謝開源 AI 基礎設施專案 new-api 對本專案的大力支持!new-api 是 QuantumNous 推出的開源 AI 基礎設施專案,就活躍度與採用度而言,是領先的統一 LLM 存取與分發專案之一,專注於幫助開發者、團隊與企業以更低成本建構可管理、可擴展的 AI 服務平台。作為同樣根植於開源生態的專案,new-api 希望贊助並支持更多優秀開源專案的持續成長。🌟 為 new-api 點個 Star 表示支持:https://github.com/QuantumNous/new-api。官方網站:https://www.newapi.ai/。
ClaudeCN 感謝 ClaudeCN 贊助本專案!ClaudeCN 是由正式註冊公司營運的企業級 AI 閘道平台,為 Claude、GPT、DeepSeek 等熱門模型提供高可用的商業 API 服務,並圍繞正式的企業採購流程打造——對公轉帳、簽訂合約、完整合規。透過此連結註冊!
BytePlus 感謝 Dola seed 贊助本專案!Dola Seed 2.0 是字節跳動面向全球市場自主研發的全模態通用大模型。基於統一的多模態架構,支援文字、圖像、音訊與影片的聯合理解與生成,原生支援 Agent 協作,具備強大的推理、長任務執行、工具整合與程式開發能力。廣泛適用於智慧座艙、個人助理、教育、客戶服務、行銷、零售等場景。在多模態感知、端到端複雜任務交付、穩定互動與資料安全方面表現出色,可透過 ModelArk 平台輕鬆存取與部署。透過此連結註冊,每款模型可獲得 500,000 Token 的免費推理額度。 >>中国大陆地区的开发者请点击这里
SiliconFlow 感謝矽基流動(SiliconFlow)贊助本專案!矽基流動是高性能的 AI 基礎設施與模型 API 平台,在同一處提供快速、可靠的語言、語音、圖像與影片模型存取。憑藉按量付費、廣泛的多模態模型支援、高速推理與企業級穩定性,矽基流動協助開發者與團隊更高效地建構並擴展 AI 應用。透過此連結註冊並完成實名認證,即可獲得 ¥16 贈送額度,可用於平台上的各款模型。矽基流動現已相容 OpenClaw,用戶可接入矽基流動 API Key,免費呼叫主流 AI 模型。
A6API 感謝 A6API 贊助本專案!A6API 是一站式 AI 模型 API 聚合平台,涵蓋 Claude、GPT、Gemini、Codex 等主流模型。多家供應商可在平台上架供貨,因此同一款模型可由多個上游供應商競價報價。智慧路由會自動挑選更穩定、價格更低的可用線路並自動故障轉移,幫助你減少失敗請求、降低成本並提升穩定性。無論你是個人開發者、AI 產品團隊還是工作室,都能透過統一介面快速接入——相容所有格式,遷移成本低。新用戶透過此連結註冊即可獲得免費體驗額度:先試用,再以低價使用。
Compshare 感謝優雲智算(Compshare)贊助本專案!Compshare 是 UCloud 旗下的 AI 雲平台,只需一組 Key 即可使用穩定而完整的國內外模型 API。提供高性價比的國產模型 Coding Plan 包月與按量套餐,同時提供穩定的海外官方中轉模型。支援 Claude Code、Codex 與 API 存取。具備企業級高併發、7×24 小時技術支援與自助開立發票。透過此連結註冊的用戶,可獲得平台贈送的 5 元人民幣體驗額度!
SSSAiCode 感謝 SSSAiCode 贊助本專案!SSSAiCode 是一個穩定可靠的 API 中轉服務,致力於提供穩定、可靠且實惠的 Claude 與 Codex 模型服務,並支援當日快速開立發票。SSSAiCode 為 CC Switch 用戶提供專屬優惠:透過此連結註冊,每次儲值都可額外獲得 $10 額度!
SoleAPI 感謝 SoleAPI 支持本專案!SoleAPI 是面向開發者與企業的 AI 模型閘道:一組 API Key 即可存取 Claude、GPT、Gemini 等 30+ 款領先模型。原生相容 OpenAI 與 Anthropic 協定,只需修改 Base URL,Claude Code、Codex、Cursor 與你現有的 SDK 即可直接使用。請求會依延遲與上游健康狀態即時路由,並以毫秒級自動故障轉移至備援通道,提供 99.99% 的服務可用性與 7×24 小時技術支援。每次呼叫都會歸入同一張帳單,並附有每筆請求的 Token 與費用明細,隨時可查。透過本專案的推薦連結註冊即可獲得免費體驗額度,邀請好友儲值還能持續賺取返現!
Micu 感謝 Micu API 贊助本專案!Micu API 是全球 LLM 中轉服務商,致力於以高穩定性提供最佳性價比。有正式註冊的企業作為核心保障,杜絕服務中斷的風險,並支援快速開立官方發票!我們主張「零成本體驗」:最低 ¥1 即可儲值、沒有最低門檻,並可隨時免手續費退款!Micu API 為 CC Switch 用戶提供專屬優惠:透過此連結註冊,儲值時輸入優惠碼「ccswitch」即可享 9 折優惠!
RightCode 感謝 Right Code 贊助本專案!Right Code 穩定提供 Claude Code、Codex、Gemini 等模型的路由服務,提供按量付費與包月訂閱兩種計費方式。儲值後可開立發票,企業與團隊用戶可獲得專屬一對一支援。Right Code 也為 CC Switch 用戶提供專屬優惠:透過此連結註冊,每次儲值都可獲得相當於實付金額 5% 的按量付費額度。
Cubence 感謝 Cubence 贊助本專案!Cubence 是一家可靠、高效的 API 中轉服務商,提供 Claude Code、Codex、Gemini 等中轉服務,計費方式靈活,包含按量付費與包月方案。Cubence 為 CC Switch 用戶提供專屬優惠:透過此連結註冊,儲值時輸入優惠碼「CCSWITCH」,每次儲值都可享 9 折優惠!
Crazyrouter 感謝 Crazyrouter 贊助本專案!Crazyrouter 是高性能的 AI API 聚合平台——一組 API Key 即可使用 Claude Code、Codex、Gemini CLI 等 300+ 款模型。所有模型均為官方價的 55%,並具備自動故障轉移、智慧路由與不限併發。Crazyrouter 為 CC Switch 用戶提供專屬優惠:透過此連結註冊並聯繫客服,即可領取 $2 免費額度,首次儲值時輸入優惠碼 `CCSWITCH` 還可額外獲得 30% 贈送額度!
DMXAPI 感謝 DMXAPI 贊助本專案!DMXAPI 為 200+ 家企業用戶提供全球大模型 API 服務。一組 API Key 即可使用全球模型。特色包括:即時開立發票、不限併發、$0.15 起、7×24 小時技術支援。GPT/Claude/Gemini 全系 68 折,國產模型 5–8 折,Claude Code 專屬模型 3.4 折!點此註冊

為什麼選擇 CC Switch?

Claude Code、Codex、Gemini CLI 等 AI 程式開發工具各有自己的設定格式。切換 API 供應商意味著要手動編輯 JSON、TOML、YAML 或 .env 檔案,MCP、Skills 與提示詞也得在每個工具中分別維護。

CC Switch 把這一切整合進單一桌面應用程式:選擇預設、輸入金鑰,一鍵切換。切換時只會替換連線資訊——端點、金鑰與模型——因此你自己加入的外掛、Hook、MCP 與註解都會原封不動。

  • 一個應用程式,十二種工具 — Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code 與 Oh My Pi
  • 告別手動編輯 — 90+ 個供應商預設,包含 AWS Bedrock、NVIDIA NIM 與社群中轉服務
  • 直連、路由或聚合,隨你選擇 — 直連讓工具直接連到供應商;路由則讓請求經由你的電腦轉發,轉換 API 格式並自動故障轉移,讓你能在 Claude Code 中使用 GPT、在 Codex 中使用 Claude;聚合會把多個供應商的模型放進 Claude Code 或 Codex 的同一份模型清單,每個請求都會送往你所選模型所屬的供應商
  • 集中管理 MCP、Skills 與提示詞 — MCP 伺服器和 Skills 只需新增一次,再選擇要同步到哪些工具;提示詞則依各工具分別維護
  • 看得懂的工作階段 — 把各工具的工作階段日誌整理成閱讀檢視:每一輪做了什麼、改了哪些檔案、哪一步失敗,一目了然
  • 用量與額度一目了然 — 即使沒有啟用本地路由也能追蹤 Token 用量與花費;訂閱剩餘額度與帳戶餘額直接顯示在供應商卡片與系統匣上
  • 跨平台 — 以 Tauri 2 打造的原生桌面應用程式,支援 Windows、macOS 與 Linux

螢幕截圖

主介面:側欄、直連 / 路由 / 聚合分頁與供應商卡片
主介面
應用頁面:一處查看所有 AI 程式開發工具的版本、安裝與升級
應用頁面
聚合模式:一個預設供應商加上多個新增的供應商
聚合模式
Codex 的模型選擇器列出來自多個供應商的模型
Codex 中的聚合模型清單
工作階段閱讀檢視:步驟摘要、工具呼叫詳情與對話大綱
工作階段閱讀檢視
用量統計:熱力圖與請求日誌
用量統計

下載與安裝

系統需求

  • Windows:Windows 10 及以上
  • macOS:macOS 12(Monterey)及以上
  • Linux:x86_64 或 ARM64,glibc 2.35+ 並具備 WebKitGTK 4.1——例如 Ubuntu 22.04+、Debian 12+ 與較新的 Fedora 版本;尚不支援 RHEL / Rocky / Alma 8–9

Windows 使用者

請從 Releases 頁面下載最新的 CC-Switch-v{version}-Windows.msi 安裝程式,或 CC-Switch-v{version}-Windows-Portable.zip 免安裝版。若是 Windows on ARM,請下載 CC-Switch-v{version}-Windows-arm64.msi 或 CC-Switch-v{version}-Windows-arm64-Portable.zip。

macOS 使用者

方式一:透過 Homebrew 安裝(建議)

brew install --cask cc-switch

更新:

brew upgrade --cask cc-switch

方式二:手動下載

從 Releases 頁面下載 CC-Switch-v{version}-macOS.dmg(建議)或 .zip。這是 Universal 版本,可在 Apple Silicon 與 Intel Mac 上原生執行。

注意:macOS 版 CC Switch 已通過程式碼簽署並經 Apple 公證,可直接安裝並開啟。

Arch Linux 使用者

透過 paru 安裝(建議)

paru -S cc-switch-bin

Linux 使用者

請從 Releases 頁面下載最新的 Linux 版本:

  • CC-Switch-v{version}-Linux-x86_64.deb / -Linux-arm64.deb(Debian/Ubuntu)
  • CC-Switch-v{version}-Linux-x86_64.rpm / -Linux-arm64.rpm(Fedora 及其他附帶 WebKitGTK 4.1 的 RPM 發行版)
  • CC-Switch-v{version}-Linux-x86_64.AppImage / -Linux-arm64.AppImage(任何符合上述需求的發行版)

Flatpak:官方發行版不提供。你可以自行從 .deb 建置——步驟請見 flatpak/README.md。

快速開始

基本使用

  1. 新增供應商:在側欄選擇要管理的工具,然後點擊頁面右上角的「+」(新增供應商)→ 選擇預設或建立自訂設定
  2. 切換供應商:
    • 主介面:選擇供應商 → 點擊「啟用」(OpenCode、OpenClaw、Hermes、MiniMax Code 與 Kimi Code 的按鈕是「新增」,Pi 與 Oh My Pi 則是「啟用」/「移除」;這七個是共存式工具,可以同時新增多個供應商)
    • 系統匣:每個工具一列,顯示「名稱 · 模式 · 供應商 · 額度」;在其子選單中點擊供應商名稱即可切換(Claude Code、Claude Desktop、Codex、Gemini CLI 與 Grok Build)
  3. 生效方式:Claude Code 無需重新啟動;Codex、Gemini CLI 與 Grok Build 請重新啟動終端機或 CLI 工具;Claude Desktop 則需重新啟動應用程式本身(見常見問題)
  4. 回到官方登入:在清單中切換到內建的官方供應商(例如「Claude Official」),重新啟動工具,再依照其登入 / OAuth 流程操作
  5. 路由與聚合(選用):Claude Code、Codex、Gemini CLI 與 Grok Build 頁面頂端有「直連」/「路由」分頁,Claude Code 與 Codex 另有「聚合」。點擊分頁只會改變你正在檢視的內容,不會動到你的設定;要真正切換,請在頁面上點擊「開始路由」或「切換到聚合模式」,並點擊「回到直連」返回。想在 Claude Code 中使用 OpenAI 或 Gemini 格式的供應商、或在 Codex 中使用 Claude,請用路由;想在同一份模型清單中混用多個供應商的模型,請用聚合
  6. 管理工具:側欄的「應用」頁面集中顯示各 AI 程式開發工具的版本、安裝位置與來源;你可以安裝、升級或全部升級,並選擇哪些工具顯示在側欄

MCP、提示詞、Skills、專案與工作階段

  • MCP:點擊側欄的「MCP」→ 透過範本或自訂設定新增伺服器(或「匯入已有」)→ 為每個工具切換同步開關
  • 提示詞:點擊側欄的「提示詞」→ 用 Markdown 編輯器建立提示詞 → 啟用其中一個,即可寫入該工具的提示詞檔案
  • Skills:點擊側欄的「Skills」→「發現技能」→ 搜尋 skills.sh 或瀏覽 GitHub 儲存庫 → 一鍵安裝到支援的工具
  • 專案:先在「設定 → 通用」中開啟「顯示專案切換」,然後在 Claude Code、Claude Desktop 或 Codex 頁面,開啟頂端的專案切換器 →「新建專案」以儲存目前的設定;之後從切換器中選擇它,就能一次切換整套設定
  • 工作階段:點擊側欄的「工作階段」→ 瀏覽並搜尋對話歷史、開啟閱讀檢視,或還原各工具的工作階段
  • 帳號:點擊側欄的「授權中心」,登入 GitHub Copilot、ChatGPT、xAI(Grok)與 Kimi Code 帳號,將你的訂閱用作供應商。Kimi Code 支援多個官方帳號,每個帳號有獨立的憑證與原生供應商;首次登入會使用 Kimi 原生的預設憑證槽位。登入、重新驗證與登出都在這裡管理。仍存在於原生設定中的 Kimi 官方 OAuth 節點會在供應商頁面受到保護;已儲存的設定檔可在其原生節點移除後刪除。

注意:首次啟動時,CC Switch 會自動把你現有的 Claude Code、Codex、Gemini CLI 與 Grok Build 設定匯入為名為 default 的供應商,並為這些工具與 Claude Desktop 各新增一個官方供應商,因此你原有的設定不會遺失。

各項功能的詳細說明請參閱 使用手冊,涵蓋供應商管理、MCP/提示詞/Skills、本地路由與故障轉移等內容。

功能特性

完整更新日誌 | v4.0 發布說明

各工具支援的功能

工具 供應商 本地路由 聚合 系統匣切換 MCP Skills 提示詞 工作階段 用量統計
Claude Code 切換 ✓ ✓ ✓ ✓ ✓ CLAUDE.md ✓ ✓
Claude Desktop 切換 僅模型映射 – ✓ – – – – 僅模型映射
Codex 切換 ✓ ✓ ✓ ✓ ✓ AGENTS.md ✓ ✓
Gemini CLI 切換 ✓ – ✓ ✓ ✓ GEMINI.md ✓ ✓
Grok Build 切換 ✓ – ✓ ✓ ✓ AGENTS.md ✓ ✓
OpenCode 共存 – – – ✓ ✓ AGENTS.md ✓ ✓
OpenClaw 共存 – – – – – 工作區編輯器 ✓ –
Hermes 共存 – – – ✓ ✓ 記憶 ✓ –
Pi 共存 – – – ✓ ✓ AGENTS.md、SYSTEM.md、提示詞範本 ✓ ✓
MiniMax Code 共存 – – – ✓ ✓ AGENTS.md ✓ ✓
Kimi Code 共存 – – – ✓ ✓ AGENTS.md ✓ ✓
Oh My Pi 共存 – – – ✓ ✓ AGENTS.md ✓ –
  • 切換:同一時間只有一個供應商生效;共存:多個供應商會同時寫入該工具自己的設定,由你在工具內挑選其中一個。
  • 本地路由:CC Switch 在你的電腦上轉發請求並轉換 API 格式;詳見下方的本地路由與故障轉移。Claude Desktop 的供應商可使用「直連」或「模型映射」;使用「模型映射」時,請求會經過本地路由。
  • 聚合:把多個供應商的模型放進同一份模型清單,並將每個請求送往你所選模型所屬的供應商;詳見下方的聚合模式。
  • 工作階段:瀏覽並搜尋對話歷史、開啟閱讀檢視,並複製還原指令以繼續對話(尚不支援還原 OpenClaw 與 Hermes 的工作階段)。Hermes 只顯示最近的 500 個工作階段。
  • 用量統計:沒有本地路由時,用量會從各工具的本機工作階段日誌收集;經過本地路由的請求同樣會被統計。
  • 從 Claude Desktop 頁面開啟的 MCP、Skills、提示詞與工作階段面板,作用對象是 Claude Code。

供應商管理

  • 90+ 個供應商預設 — 選擇預設並輸入金鑰即可新增供應商,也可建立自訂設定。新增面板支援依名稱(包含中文名稱)與網域搜尋,同一家廠商的不同方案與地區會合併成一列
  • 只動關鍵欄位 — 切換時只會替換端點、金鑰與模型等連線資訊;外掛、Hook、MCP、你自己加入的設定與註解都保持原樣。編輯器會顯示切換後設定檔的樣子,CC Switch 也會在第一次改寫每個設定檔之前自動備份
  • 專案 — 把 Claude Code 或 Codex 目前的供應商、MCP、Skills 與提示詞檔案儲存為一個專案(Claude Desktop 只儲存供應商),之後可從頁面頂端的專案切換器或系統匣一鍵切換整套設定;切換到另一個專案時,目前的狀態會自動存回前一個專案。專案切換器預設隱藏,請在「設定 → 通用」中開啟「顯示專案切換」
  • 帳號(Beta) — 在側欄的「授權中心」登入多個 GitHub Copilot、ChatGPT 與 xAI(Grok)帳號,並將這些訂閱用作 Claude Code、Claude Desktop 與 Codex 的供應商(除 Codex 的 OpenAI Official 外,都必須在路由模式下使用)。在官方用戶端之外使用訂閱可能違反廠商的服務條款,請自行評估風險
  • Claude Desktop 的第三方供應商 — 直接連接 Anthropic 相容端點;對於非 Claude 模型,請選擇「模型映射」,透過本地路由把 Sonnet、Opus、Haiku 等檔位對應到供應商的實際模型
  • 通用供應商 — 一份設定即可同步到 Claude Code、Codex 與 Gemini CLI
  • 一鍵切換、系統匣快速切換(Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build)、拖曳排序、匯入/匯出

本地路由與故障轉移

  • API 格式轉換 — 本地路由可在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 與 Gemini Native 之間轉換請求:Claude Code 與 Claude Desktop 可使用 OpenAI 或 Gemini 格式的供應商,Codex 與 Grok Build 則可使用 Chat Completions 或 Anthropic Messages 的供應商
  • 按工具獨立開關 — Claude Code、Codex、Gemini CLI 與 Grok Build 可分別進入路由模式:在頁面頂端的「路由」分頁點擊「開始路由」。在路由模式下,切換供應商會立即對後續請求生效(若切換會更動模型,Codex、Gemini CLI 與 Grok Build 可能仍需重新啟動)。結束 CC Switch 時,它會先把直連設定寫回,並在下次啟動時重新接上
  • 自動故障轉移 — 為每個工具設定故障轉移佇列;請求失敗時,CC Switch 會自動改用佇列中的下一個供應商,並有熔斷器與供應商健康監控作為後盾
  • 整流器 — 自動修正部分上游無法處理的請求(例如 Thinking 簽章,或在不支援圖片時降級處理)
  • 官方供應商(例如 Claude Official)無法經過本地路由(Codex 的 OpenAI Official 除外)
  • 路由服務的狀態、監聽位址與故障轉移設定都在「設定 → 本地路由」中
  • 指南:在 Claude Code 中使用 GPT · 在 Codex 中使用 Claude

聚合模式

  • 一份模型清單,多個供應商 — 在 Claude Code 或 Codex 頁面切換到「聚合」並新增幾個供應商,它們的模型都會出現在用戶端的模型選擇器中。每個請求都會送往你所選模型所屬的供應商,無需在 CC Switch 中切換
  • 隨時新增與移除 — 在供應商卡片上點擊「新增」或「移除」,再選一個供應商作為預設;未指定聚合模型的請求會送往它。Codex 的 OpenAI Official 只能作為預設供應商;聚合模式目前不支援 Claude 官方訂閱
  • 注意事項 — 聚合不提供故障轉移;Claude Code 需要 2.1.243 或更新版本;聚合清單變動後,Codex 需要重新啟動,Claude Code 則不用。在同一工作階段中切換模型時,新模型必須重建提示詞快取,因此第一輪的花費會略高
  • 聚合模式的許多設計參考了 opencodex——感謝其作者與貢獻者
  • 文件:聚合模式手冊 · 圖文指南(中文)

MCP、提示詞與 Skills

  • 統一的 MCP 面板 — 在同一處管理所有 MCP 伺服器,選擇每個伺服器要同步到哪些工具(Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、Hermes、Pi、MiniMax Code、Kimi Code、Oh My Pi),從各工具匯入現有設定,並可透過 Deep Link 匯入
  • 提示詞 — 依工具分別建立的提示詞庫,附 Markdown 編輯器;啟用提示詞時會將其寫入該工具的提示詞檔案(CLAUDE.md / AGENTS.md / GEMINI.md),並先把檔案現有的內容存回提示詞庫,確保不會遺失任何內容。Pi 還可編輯 SYSTEM.md、APPEND_SYSTEM.md 與提示詞範本
  • Skills — 搜尋 skills.sh,或從 GitHub 儲存庫或 ZIP 檔案一鍵安裝;可檢查更新並一鍵全部更新;可自動同步到各工具、僅用符號連結,或僅用複本;也可選擇存放在 ~/.agents/skills
  • 三個面板都支援搜尋,MCP 與 Skills 還可依工具一次全部啟用或停用;供應商、MCP 伺服器與提示詞都在內容區以整頁方式編輯,離開時若有未儲存的變更會先提醒你

用量與費用追蹤

  • 用量儀表板 — 不需要本地路由:預設會自動掃描各工具的本機工作階段日誌,並依供應商與模型追蹤請求數、Token、快取命中率、輸出速度與花費,附趨勢圖、全年熱力圖與逐筆請求日誌
  • 額度與餘額 — 供應商卡片與系統匣會顯示剩餘額度與重置倒數,例如「5h 94% left」:官方訂閱額度(Claude、ChatGPT、Gemini、SuperGrok)、Coding Plan 的 5 小時 / 每週 / 每月額度(Kimi、智譜 GLM、MiniMax、火山方舟等),以及帳戶餘額(DeepSeek、OpenRouter、矽基流動等);部分需要先在供應商卡片上透過「設定用量查詢」開啟,其他供應商則可撰寫自訂用量指令碼。ChatGPT 訂閱還會顯示剩餘的額度重置次數與 Codex Credits 餘額
  • 自訂定價 — 可為每個模型設定價格,或從 models.dev 匯入

工作階段管理與工作區

  • 工作階段閱讀檢視 — 將各工具的工作階段日誌解析為結構化內容:文字、思考、工具呼叫、工具結果與圖片分別顯示;每一輪工作會收合成一行摘要(幾個步驟、改了幾個檔案、幾次失敗),失敗的步驟以紅色標示;右側有對話大綱,並支援工作階段內搜尋、Markdown 匯出,以及複製單一輪次或整段對話
  • 清單與還原 — 依專案或時間分組,可搜尋標題、目錄、訊息或工作階段 ID,並可批次刪除;複製還原指令即可繼續對話,在 macOS 上還可一鍵在終端機中還原
  • 工作區編輯器(OpenClaw) — 編輯 Agent 檔案(AGENTS.md、SOUL.md 等)與每日記憶
  • 記憶(Hermes) — 編輯 Hermes 的 MEMORY.md 與 USER.md

系統與平台

  • 雲端同步 — 透過 WebDAV(堅果雲、Nextcloud、Synology NAS 等)或相容 S3 的儲存空間(AWS S3、Cloudflare R2、阿里雲 OSS、騰訊雲 COS 等)在多台裝置間同步;你也可以把 CC Switch 設定目錄放進 Dropbox、OneDrive 或 iCloud 等雲端硬碟資料夾
  • CLI 工具管理 — 在側欄的「應用」頁面查看 Claude Code、Codex 等命令列工具的目前版本與最新版本,一鍵安裝、升級或全部升級,並診斷重複安裝;在 Windows 上也能管理 WSL 內的工具(見常見問題)
  • Deep Link(ccswitch://) — 透過連結一鍵匯入供應商、MCP 伺服器與提示詞,或新增 Skill 儲存庫;可用線上產生器建立連結;想提供匯入按鈕的網站擁有者可參考整合指南
  • 內建小工具 — 略過 Claude Code 的首次執行確認、隱藏 AI 署名、讓 VS Code 的 Claude Code 擴充功能跟隨 CC Switch 的供應商切換等
  • 深色 / 淺色 / 跟隨系統主題、開機自動啟動、自動更新、原子寫入、自動備份(在「設定 → 資料」中可查看每份備份的位置與佔用空間)、多語系介面(簡體中文、繁體中文、英文、日文、韓文、土耳其文、俄文、德文)

常見問題

CC Switch 支援哪些 AI 工具?

CC Switch 支援十二個工具:Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code、Oh My Pi。每個工具都有專屬的供應商預設與設定管理;各工具支援的功能請見各工具支援的功能。

切換供應商後需要重新啟動終端機嗎?

視工具而定:

  • Claude Code:支援供應商資料熱切換,無需重新啟動。
  • Codex、Gemini CLI、Grok Build:請重新啟動終端機或 CLI 工具,變更才會生效(切換後 CC Switch 會提醒你)。在路由模式下,請求會立即送往新的供應商,但若切換會更動模型,這三個工具仍可能需要重新啟動。
  • 聚合模式:Claude Code 聚合模型的變更會立即生效;Codex 進入或離開聚合、以及變更聚合模型清單,都需要完整重新啟動——見下一則。
  • Claude Desktop:完全結束並重新開啟 Claude Desktop;使用「模型映射」時,也請保持 CC Switch 執行中。
  • OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code、Oh My Pi:這些是共存式工具——點擊「新增」(Pi 與 Oh My Pi 為「啟用」)會把供應商與其他供應商一起寫入工具自己的設定;之後再到工具內選擇你要的模型。Kimi Code 還提供「切換」按鈕來選擇供應商的模型;仍被設為主要或次要模型的模型無法移除。設定與帳號詳情請見 Kimi Code 整合指南(中文)。
聚合模式下,為什麼聚合的模型沒有出現在 Codex 的 /model 中?

Codex 只會在啟動時讀取模型清單。進入或離開聚合模式、新增或移除聚合供應商,或變更供應商的聚合模型後,請完整重新啟動 Codex 才能看到新的清單:

  • Codex CLI:關閉終端機再執行 codex 並不夠。所有終端機中的每個 codex 共用同一個背景常駐程式,必須重新啟動它才會讀取新的清單。當 CC Switch 偵測到 Codex 仍在使用舊清單時,會在 Codex 頁面頂端顯示提示;請點擊提示中的「重新啟動 Codex 守護行程」。重新啟動會中斷常駐程式中正在執行的任何任務。
  • Codex 桌面應用程式:完全結束後重新開啟(在 macOS 上按 ⌘Q;只關閉視窗並不夠)。
  • 編輯器擴充功能:重新開啟編輯器視窗。

Claude Code 不受影響:聚合模型的變更會立即生效。

切換供應商會更動我的外掛、Hook 或其他設定嗎?

不會。為 Claude Code、Codex、Gemini CLI 或 Grok Build 切換供應商時,CC Switch 只會替換設定檔中的關鍵欄位:端點、金鑰、模型名稱與 API 協定(Codex 另含推理強度,Gemini CLI 另含驗證方式),以及少數屬於供應商的相容性選項(例如 Claude Code 的「停用 Artifact 工具」與上下文視窗)。外掛、Hook、權限、MCP、你自己加入的環境變數、註解與格式都保持原樣,並適用於每個供應商。

你可以在工具本身或手動編輯設定檔來變更這些共用設定。你也可以在 CC Switch 中編輯任一供應商:編輯器會顯示「切換到此供應商後設定檔的樣子」。儲存時,關鍵欄位會存入該供應商,其餘所有變更則寫入設定檔,並適用於每個供應商。

因此舊有的「通用設定片段」已不再需要,其按鈕也已移除。升級前在片段中的設定,早在你切換時就已寫入設定檔,所以會保留下來。CC Switch 在第一次改寫每個設定檔之前,也會把原始檔案備份到 ~/.cc-switch/backups/live-first-write/。

我在工具內改了模型,為什麼切換走再切換回來後又變回去了?

模型是關鍵欄位,屬於供應商。你在工具內選擇的模型(例如在 Claude Code 中使用 /model)會一直生效到下次切換;切換時,設定檔中的模型會被替換成目標供應商中儲存的模型,而 CC Switch 不會把你選擇的模型存回前一個供應商。若想長期使用某個模型,請在 CC Switch 中編輯該供應商。

舊版本在你切換離開時,會把整個設定檔存回供應商。現在已不再這樣做:那會把外掛與其他共用設定凍結在單一供應商中,切換到別的供應商時就會遺失。

為什麼無法刪除目前使用中的供應商?

CC Switch 遵循「最小侵入」的設計原則——即使你解除安裝本應用程式,你的工具仍能正常運作。

因此,對於同一時間只使用一個供應商的工具(Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build),系統一律會保留一份使用中的設定,因為刪除所有設定會讓對應的工具無法使用;若要刪除,請先切換到其他供應商。同樣地,聚合模式的預設供應商也無法移除;請先將另一個供應商設為預設。共存式工具(OpenCode、OpenClaw、Hermes、Pi 與 MiniMax Code)不受此限制——你可以直接刪除任何供應商。如果你很少使用某個工具,可以在「應用」頁面將它從側欄隱藏。若要切換回官方登入,請見下一個問題。

如何切換回官方登入?

在 CC Switch 中,Claude Code、Claude Desktop、Codex、Gemini CLI 與 Grok Build 的供應商清單各自包含一個內建的官方供應商(Claude Official、Claude Desktop Official、OpenAI Official、Google Official、Grok Official);如果你刪除了它,可以從預設中重新新增。切換到官方供應商後,請依照工具自己的登入流程操作(例如 Claude Code 的 /login、Codex 的 codex login),之後你就能在官方供應商與第三方供應商之間自由切換。

對於 Codex,你也可以在 CC Switch 內透過「Sign in with ChatGPT」登入多個 ChatGPT 帳號,並為每張 OpenAI Official 卡片選擇「使用的帳號」,只需一鍵就能在多個 Plus、Pro 或 Team 帳號之間切換;設為「跟隨 Codex 登入」的卡片則會繼續使用 Codex CLI 自己的登入。

注意:官方訂閱使用工具自己的登入,不會經過本地路由。路由模式下無法選擇官方供應商(Codex 的 OpenAI Official 卡片除外);請先切換回直連。

開始路由後,為什麼我的設定檔指向 127.0.0.1?

在路由模式下,工具的請求會先送到 CC Switch 的本地路由(預設為 http://127.0.0.1:15721),再由 CC Switch 轉發給你選擇的供應商。因此工具的設定檔裡只會有本機位址與預留位置金鑰 PROXY_MANAGED;對於 Claude Code,模型名稱也會寫成固定的別名,例如 claude-sonnet-5(/model 選單仍會顯示真實的模型名稱)。真實的供應商位址、金鑰與模型都儲存在 CC Switch 中。聚合模式的運作方式相同。

在側欄「用量統計」的請求日誌中,你可以看到每個請求的「請求的模型 → 實際的模型」。

在路由模式下,切換改變的是路由所使用的供應商;你在進入路由之前使用的供應商維持不變,並在其卡片上標示為「直連」。當你點擊「回到直連」時,設定檔會被寫回這個直連供應商的設定。結束 CC Switch 時也會先寫回直連供應商,並在下次啟動 CC Switch 時重新接上。

可以在 Claude Code 中使用 OpenAI 相容 API、Gemini 或本地模型嗎?

可以,但需要使用路由。編輯供應商時,請將「進階選項」中的「上游格式」設為與供應商 API 相符:只提供 Chat Completions 端點的服務(許多本地模型伺服器都是如此)請選「OpenAI Chat Completions」,提供 Responses 端點的服務請選「OpenAI Responses API」,Gemini 請選「Gemini Native generateContent」。然後在 Claude Code 頁面的「路由」分頁點擊「開始路由」。選錯格式或沒有開始路由,通常會出現 404 或 405 錯誤。

反過來說,在 Codex 或 Grok Build 中將「上游格式」選為「Anthropic Messages」,就能使用 Claude 格式的供應商;這同樣需要路由。詳情請見在 Claude Code 中使用 GPT與在 Codex 中使用 Claude。

「檢測連通」通過了,為什麼請求還是失敗?

供應商卡片上的「檢測連通」只會檢查供應商位址是否可連線,並不會送出真正的模型請求,因此無法驗證 API 金鑰與模型名稱是否正確。請求失敗時,請檢查金鑰、模型名稱與上游格式;對於經過路由的請求,你也可以在側欄「用量統計」的請求日誌中看到確切的錯誤。

我的資料存放在哪裡?

預設情況下,所有資料都存放在你使用者主目錄下的 .cc-switch 資料夾(Windows 上為 C:\Users\<user>\.cc-switch):

  • 資料庫:cc-switch.db(SQLite——供應商、MCP、提示詞、Skills、專案、用量記錄等)
  • 本機設定:settings.json(裝置層級的設定,例如各工具的設定目錄、備份策略與雲端同步連線資訊)
  • 備份:backups/(預設每 24 小時自動備份一次,保留最近 10 份;可在「設定 → 資料 → 備份與還原」中調整;其下的「其他備份」會列出其他所有備份的位置與大小,可依類別清理)
  • Skills:skills/(可在設定中改為 ~/.agents/skills),預設透過符號連結同步到各工具,失敗時退回複製
  • Skill 備份:skill-backups/(在解除安裝或更新 Skill 之前自動建立,保留最近 20 份)
  • OAuth 登入憑證:copilot_auth.json、codex_oauth_auth.json、xai_oauth_auth.json
  • 日誌:logs/cc-switch.log 與 crash.log——回報問題時請附上
  • 裝置狀態:live-state.json(各工具目前處於直連、路由或聚合模式,以及最後寫入的內容)、codex-login-stash.json(切換到第三方供應商時暫存起來的 Codex 官方登入,切換回官方供應商時會還原)
  • 原始設定檔:backups/live-first-write/(CC Switch 第一次改寫之前各工具設定檔的原樣)

在「設定 → 資料 → 儲存位置」中變更「CC Switch 設定目錄」後,除了 settings.json、裝置狀態與原始設定檔之外,上述所有檔案都會存放在新目錄中。CC Switch 不會自動搬移既有檔案,請先手動複製過去。settings.json、裝置狀態與原始設定檔只屬於這台電腦:它們一律保留在預設目錄,也不會納入雲端同步。

如何在 Windows 上管理 WSL 內的工具?

CC Switch 不會自動偵測 WSL。請在「設定 → 應用設定」中,把對應工具的設定目錄改成 WSL 內的路徑,例如 \\wsl.localhost\Ubuntu\home\<user>\.claude;儲存後,CC Switch 就會讀寫 WSL 內的設定(支援 Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes 與 Pi)。設定完成後,側欄的「應用」頁面也會偵測並升級對應 WSL 發行版中的該工具。

注意:路由與聚合會把 127.0.0.1 作為位址寫入設定。在 WSL2 預設的 NAT 網路模式下,WSL 內的 127.0.0.1 無法連到 Windows 上的本地路由;請改將 WSL 切換為鏡像網路模式。

有命令列或無頭(headless)版本嗎?

CC Switch 本身只以需要圖形介面的桌面應用程式形式發行(系統需求請見下載與安裝)。對於伺服器、SSH 連線或沒有桌面環境的機器,我們建議使用社群維護的 CC Switch CLI:它同時提供互動式終端機介面(TUI)與命令列模式,支援 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 與 Pi,並可透過 Homebrew(brew install cc-switch-cli)或安裝指令碼安裝。

預設情況下,CC Switch CLI 與桌面應用程式共用 ~/.cc-switch 資料目錄,並相容桌面應用程式的 WebDAV 同步。這兩個專案是分開發布的,CLI 支援的資料庫版本有時會落後於桌面應用程式;若你看到「資料庫版本過新」的訊息,請升級 CLI,或等待它跟上。

Linux(Wayland + NVIDIA):點擊沒有反應,且調整視窗大小時黑屏

AppImage 會強制設定 GDK_BACKEND=x11(XWayland),以避開過去原生 Wayland 的當機問題。在較新的 Wayland + NVIDIA 環境中,這可能導致網頁內容區域無法點擊(標題列按鈕仍可使用),並在調整大小時黑屏。請使用選擇性啟用的逃生開關啟動,以切換回原生 Wayland:

CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch-*.AppImage

如果你是從桌面圖示啟動,請把它加到 .desktop 檔的 Exec= 行(例如 env CC_SWITCH_GDK_BACKEND=wayland /path/to/AppImage),或設定在你的工作階段環境中。這個變數是通用的:在點擊沒有反應的平鋪式 Wayland 合成器(sway/Hyprland)上,請改試 CC_SWITCH_GDK_BACKEND=x11。不設定則維持預設行為。

更多問題請參閱使用手冊中的常見問題。

參與貢獻

歡迎提出 Issue 與建議!開發新功能之前,請先開一個 Issue 討論方案;不適合本專案的功能 PR 可能會被關閉。

開發環境設定、提交前檢查與架構說明請見 CONTRIBUTING.md;使用上的問題請先查看 SUPPORT.md;安全漏洞請依 SECURITY.md 的說明私下回報。

技術棧:Tauri 2 · Rust · React 18 · TypeScript · SQLite

Star 歷史

Star History Chart

授權條款

MIT © Jason Young