這個51K星標的開源神器，讓任何Agent都能一鍵切換所有模型。

上個禮拜我連續出咗幾篇模型評測嘅文章。

尤其係上個禮拜五，直接變身雞排哥一日連出三篇。

然後，好多朋友喺下面問我。

其實講真，上個禮拜一我已經寫咗一篇超詳細嘅Claude Code使用教學，裏面有好大篇幅係講點樣喺Claude Code度接國產模型。

不過講真，其實大家都明，咁長嘅教學文，真係會睇到尾嘅冇幾多個。

所以，我都覺得，應該將呢個我自己真係用好多次仲超好用嘅小工具，單獨拎出嚟詳細寫一篇，分享俾大家。

畢竟，呢個工具喺我睇嚟，佢而家唔單止係Claude Code度接國產模型，仲係其他Agent產品例如OpenClaw、Hermes等等入面，切換模型最方便、最好用嘅一個。

佢就係開源嘅大名鼎鼎cc switch，到而家喺github上面已經有50k粒星標。

連結喺度：

https://github.com/farion1231/cc-switch

佢嘅運作原理都超簡單，就係直接幫你改模型配置文件。

因為大家要知道，其實要幫Claude Code、OpenClaw之類嘅Agent產品改背後嘅模型，對於唔係Programmer出身嘅絕大部分普通人嚟講，係有啲麻煩。

因為你真係要識少少Code，知咩叫配置文件，先至可以手動修改。

喺Claude Code入面，呢個就係settings.json檔案。

只要你親手改過一次Claude Code嘅settings.json，你就知呢件事有幾咁煩。

我到而家仲記得，當初GLM-5啱啱推出嗰陣，我想試下，將佢接去Claude Code度用。

嗰陣睇文檔，佢叫我揾Claude Code嘅settings.json，開始人手填各種嘢。

base_url、auth_token、model name呢啲字段。。。

我即刻火都嚟埋，真係，覺得呢件事好低能。

之前玩小龍蝦嘅時候都係咁，每次出新模型想試下，我就直接叫佢自己幫自己改模型。

結果我相信玩過小龍蝦嘅都知，小龍蝦GG最常見嘅原因，基本上就係換模型，成日模型切嚇切嚇就自己冧檔。

簡直太蠢了。。。

直到之後我忍無可忍，就去問咗下Claude，有冇類似嘅可以方便切換Agent產品模型嘅開源項目，嗰陣真係揾到。

由嗰陣開始，我再冇為切模型呢件事煩惱過。

返番嚟CC Switch本身。

佢係一個Desktop App，全平台即係Windows、Mac、Linux都用得。

而家總共6個Agent工具，Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw，前幾日最新版仲將Hermes都加埋入嚟。基本上你電腦上面行緊嘅呢類Agent工具，佢都用得上。

因為係一個純粹嘅開源產品，所以資料都算比較安全，所有相關數據都存在你本地一個SQLite數據庫度，路徑係~/.cc-switch/cc-switch.db。

包括你加嘅供應商配置、全局配置、模型定價之類嘅嘢。

你用佢切換供應商嘅時候，佢會由呢個數據庫讀出對應配置，再幫你寫入各家Agent嘅配置檔案，從而幫你無痛切模型。

直接入去項目嘅github，向下揾Assets。

https://github.com/farion1231/cc-switch/releases

根據自己嘅系統揾對應嘅檔案下載安裝。

例如Mac，我哋下載紅框入面嘅檔案。

直接雙擊執行，然後喺App度我哋就會見到呢個logo同Claude極之相似，但顏色唔同嘅嘢。

安裝好之後，我哋主要再好詳細咁講嚇佢點用。

先睇點樣喺Claude Code度接模型。

我哋雙擊打開CC Switch。

喺Claude圖示下面點擊右邊嘅加號。

佢內置咗40幾個供應商嘅預設，智譜、MiMo、DeepSeek、千問、Kimi、MiniMax、DouBaoSeed、階躍等等等等，總之國內主流嘅佢基本上都有。

我哋呢度以GLM做例子，揀Zhipu GLM，你想用邊個模型就撳邊間就得。

冇揀供應商嘅話，所有配置都係吉嘅。

揀好供應商之後，除咗API Key，其餘嘅字段佢都幫你預先填好曬，完全唔使你操心。

填完API Key之後，可以拉落去睇嚇CC Switch自動幫你配嘅模型版本，唔鍾意可以改。

你唔清楚模型名嘅話，就撳右上角嘅獲取模型列表。

然之後你就可以見到廠商提供嘅所有可以調用嘅模型。

呢度要注意，唔係每個供應商都支援查詢列表，唔支援嘅話就需要你手動填模型名。

改完模型之後，你會見到佢幫你寫嘅配置文件代碼係同步嘅。

呢度嘅配置json檔案，就係CC Switch會寫入Claude Code嘅settings.json嘅內容，但其實我哋根本唔使理。

由頭到尾我哋做嘅得三步，揀供應商、填API Key、揀模型就得。

格式啦兼容啦呢啲問題，你都唔使操心。

最後，撳右下角嘅儲存。

咁樣，我哋就可以喺首頁嘅模型列表見到佢，直接撳啓用，就可以喺Claude Code度用喇。

其他間嘅模型，都可以用同樣嘅操作加落嚟。

甚至切換嘅時候我哋都唔使再撳開主頁面。

直接撳桌面右上角嘅圖標，你想換邊個就撳邊個，每個工具下面掛住自己嘅供應商列表，互相唔幹擾。

呢樣嘢裝咗之後有個好爽嘅點就係，喺Claude Code入面，熱切換模型嘅操作變得超級簡單。

熱切換，就係你唔使重啟終端，唔使熄咗Claude Code而家嘅會話。

例如你正喺度行緊嘢，覺得呢個模型唔夠叻，你只需要等佢回覆之後，喺選單欄撳CC Switch嘅小圖標，揀另一個模型，切完即刻見效。

下一輪對話直接係新模型喺度回應你。

但係注意，你千祈唔好咁蠢，喺模型做緊嘢嘅時候切，咁...一定會報下面嘅錯。

呢個功能用嚟做成本管理，超爽。

因為其實我知道，好多朋友做一啲日常任務，仲有大項目入面嘅部分細工作，其實冇需要用到最貴最強嘅模型，掛個性價比高嘅模型，真係又快又平。

而做呢個成本管理嘅操作成本，有咗佢基本上係零。

但淨係切模型呢個功能仲只係基本嘢，CC Switch入面仲做咗好多功能。

例如，佢仲做咗用量追蹤，可以快睇到API key接入嘅餘額，同coding plan嘅額度。

打開用量配置嘅操作都唔複雜。

喺模型列表撳配置用量查詢。

打開啓用用量查詢。

如果你係行API，呢度撳官方，再撳儲存配置。

如果你係買token plan嘅話，呢度我哋唔撳官方，而係撳token plan。

揀對應嘅模型供應商，撳儲存配置。

首頁列表就可以見到實時嘅消耗或者餘額。

除咗用量，CC Switch仲提供更詳細嘅使用統計，可以更直觀咁睇到每個時間段嘅成本消耗。

可以明顯見到，過去一日我嘅用量高峯，基本上都係收工之後嘅凌晨，夜深人靜，適合Coding。。。

就係呢個統計，真係好好用。

最後一個，亦係一個好實用嘅功能，特別適合一啲用多個國產模型搭配使用嘅用戶。

就係，有時你可能會臨瞓前俾Agent派個大任務，叫佢趁我瞓覺嘅時候努力做嘢。

但係呢，你可能會遇到額度突然用曬，或者網絡唔穩定中斷嘅情況，第二朝起身一睇，件事根本未做完。

呢種事用CC-Switch嘅本地代理帶故障轉移就可以解決。

CC-Switch可以喺你本地起一個代理服務，攔住你嘅CLI工具發出嘅請求，幫你做API格式轉換、故障轉移同熔斷保護。

翻譯成白話就係。

你俾同一個工具配咗三間Claude Code供應商，例如GLM、MiMo、DeepSeek。

某日，其中一間突然死咗，或者額度用曬，或者請求好耐冇回應。

CC Switch會自動切去下一間繼續行，無痛遷移，唔使嘥時間等。

詳細嘅操作我都寫喺呢度。

我哋撳入左上角嘅設定。

揾路由服務，先打開本地路由嘅開關，將本地代理服務行起嚟。

然後喺應用路由區域啓用Claude路由，將Claude Code嘅請求接到本地代理上。

呢度建議都撳開喺主頁面顯示本地路由開關。咁我哋喺主頁就可以快速打開或關閉路由。

然後我哋打開自動故障轉移，揀Claude，再撳添加供應商，將你想做後備嘅幾間加入隊列。

但係呢度要注意，如果你係用Claude嘅官方模型，就唔好開路由，問題都有啲多

最後我哋可以喺首頁列表透過拖曳俾佢哋排序。

咁樣CC Switch會優先列表上面嘅供應商進行路由，遇到故障就自動揾下一間。每個供應商卡片會顯示一個健康狀態徽章。

要關閉嘅話，直接喺主頁將呢兩個掣關閉就得。

除咗上面講嘅呢啲，CC Switch仲有好多其他功能可以慢慢發掘，例如會話管理。

仲有模型配置雲同步等等，呢度就唔一一展開講。

官方提供咗一份好全面嘅用戶手冊，寫得好詳細，地址擺喺度，有興趣嘅朋友可以去睇嚇。

https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md

多謝每一位睇到呢度嘅朋友。

講真，呢篇文章，我自己讀起上嚟係有啲悶。

但係作為一篇工具介紹嘅文章，我都真係寫唔出咩花樣。

呢類文章嘅完讀率一向都比較低。

但如果可以幫到當中，哪怕一個人。

咁我覺得，呢篇文章就有價值喇。

希望可以對大家有少少用。

剩低嘅，就交俾屏幕前面嘅你自己搞掂。

祝各位，創作愉快。

以上，既然睇到呢度，如果覺得唔錯，順手畀個讚、睇、轉發三連啦，如果想第一時間收到推送，都可以俾我個星標⭐～多謝你睇我嘅文章，我哋，下次再見。

> / 作者：卡茲克，tashi

> / 投稿或爆料，請聯繫電郵：wzglyay@virxact.com

上週我一連發了好幾篇模型評測的文章。

特別是上週五，直接化身雞排哥一天三連發。

然後，很多朋友就在下面問我。

其實說實話，上週一我已經寫了一篇超級詳細的Claude Code使用教程，裏面就有很大的篇幅，寫的就是如何在Claude Code裏接國產模型這件事。

不過說實話，其實大家都懂，就是那麼長的教程文，其實看的後面的真的沒幾個。

所以，我也覺得，得把這個我自己真的用的非常多也超級好用的小工具，單獨拎出來詳細的寫一篇，分享給大家。

畢竟，這個工具在我看來，他目前確實不僅是Claude Code裏接國產模型，也還是其他的各種Agent產品比如OpenClaw、Hermes等等裏面，切換模型最方便、最好用的一個。

他就是開源的大名鼎鼎的cc switch，至今在github上已經50k的星標了。

連結在此：

https://github.com/farion1231/cc-switch

它的工作原理也超級簡單，就是直接幫你去改模型配置文件。

因為大家要知道其實要給Claude Code、OpenClaw之類的Agent產品，改你的背後的模型，其實對於非程序出身的絕大多數的普通人來說，是有一點麻煩的。

因為，你是真的要懂一點代碼，知道啥叫配置文件，才能去手動修改的。

在Claude code裏，這玩意就是settings.json文件。

你只要自己手動改過一次Claude Code的settings.json，你就知道這事到底有多煩。

我到現在還記得，當初GLM-5剛發佈的時候，我想試一下，把它接到Claude Code裏面去用。

當時看文檔，他讓我找到Claude Code的settings.json，開始手填各種東西。

base_url、auth_token、model name各種字段。。。

我人直接炸了，真的，感覺這事太蠢了。

之前玩小龍蝦的時候也是一樣，每次出了新模型想試試，我就直接讓它自己去給自己改模型。

結果我相信玩過小龍蝦的都知道了，小龍蝦GG的最常見的原因，基本就是換模型，經常就是模型切着切着，然後自己就崩了。

簡直太呆逼了。。。

直到後面我實在忍無可忍，就去問了下Claude，有沒有類似的可以便捷切換Agent產品模型的開源項目，當時還真挖到了。

從那以後，我再也沒為切模型這事煩惱過。

回到CC Switch本身。

它是一個桌面App，全平台也就是Windows、Mac、Linux都可以用。

目前一共6個Agent工具，Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw，前幾天最新版還把 Hermes也加進來了。基本上你電腦上在跑的這類Agent工具，它都用得上。

因為是個純粹的開源產品，所以信息啥的還是比較安全的，所有相關的數據都存在你本地的一個SQLite數據庫裏，路徑是~/.cc-switch/cc-switch.db。

包括你添加的供應商配置，全局配置，模型定價之類的等等的東西。

你在用他切換供應商的時候，它會從這個數據庫裏讀出對應配置，再幫你寫到各家Agent的配置文件裏，從而幫你無痛切模型。

直接進入項目的github，下滑找到Assets。

https://github.com/farion1231/cc-switch/releases

根據自己的系統找到對應的文件進行下載安裝。

比如Mac，我們下載好紅框中的文件。

直接雙擊運行，然後在App中我們就能看到這個logo和Claude極其相似，但顏色不一樣的東西了。

安裝好後，我們主要再來非常非常詳細的說說他怎麼用。

先來看怎麼在Claude Code裏接模型。

我們雙擊打開CC Switch。

在Claude圖標下面點擊右側的加號。

它內置了40+家供應商的預設，智譜、MiMo、DeepSeek、千問、Kimi、MiniMax、DouBaoSeed、階躍等等等等，反正國內主流的他基本都有。

我們這裏以GLM為例，選Zhipu GLM，你想用哪個模型就點哪一家就行。

沒選供應商的話，所有的配置都是空的。

選好供應商之後，除了API Key，剩下的字段它都幫你預填好了，完全不用你操心。

API Key填進去之後，可以下拉看一眼CC Switch自動給你配的模型版本，不喜歡可以改。

你要是不清楚模型名字的話，就點右上角的獲取模型列表。

然後你就可以看到廠商提供的所有可以調用的模型了。

這裏需要注意一下，並不是每個供應商都支持查詢列表，不支持的話就需要你手動填一下模型名。

模型修改後，你能看到他給你寫的配置文件代碼是隨你同步的。

這裏的配置json文件，就是CC Switch會寫進Claude code的settings.json裏面的內容，但其實我們根本不用管。

從頭到尾我們做的就三步，選供應商、填API Key、選模型就行了。

格式啊兼容啊七七八八的問題，你都不用操心。

最後，點擊右下角的保存。

這樣，我們就能在首頁的模型列表看見他了，直接點啓用，就能在Claude code裏用上了。

其他家的模型，也可以同樣的操作加進來。

甚至切換的時候我們都不用再點開主頁面。

直接點擊桌面右上方的圖標，你想換哪個就點哪個，每個工具下面掛着自己的一套供應商列表，互不干擾。

這玩意裝上以後有一個很爽的點就是，在Claude Code裏面，熱切換模型的操作變得無敵簡單。

熱切換，就是你不用重啓終端，不用關掉Claude Code當前會話。

比如你正跑着東西，覺得這個模型不太聰明，你只需要等他回覆之後，在菜單欄點一下CC Switch的小圖標，選一個別的模型，切完就立刻生效。

下一輪對話直接就是新模型在回你了。

但是注意，你千萬不要犯傻，非要在模型正在幹活的時候切，那...必然會報下面的錯。

這個功能用來做成本管理，賊爽。

因為其實我知道，很多朋友做一些日常任務，還有大項目裏的部分小活兒，其實沒必要上最貴最強的模型，掛個性價比高的模型，真的又快又便宜。

而做這個成本管理的操作成本，有了他幾乎為零了。

但光是切模型這一個功能還只是基操，CC Switch裏還做了很多功能。

比如，他還做了個用量追蹤，可以快速看到，API key接入的餘額，和coding plan的額度。

打開用量配置的操作也不復雜。

在模型列表點擊配置用量查詢。

打開啓用用量查詢。

如果你是走的API，這裏點擊官方，再點擊保存配置。

如果你是買的token plan的話。這裏我們不點官方，而是點token plan。

選擇對應的模型供應商，點擊保存配置。

首頁列表就能看到實時的消耗或者餘額了。

除了用量，CC Switch還提供了更詳細的使用統計，可以更直觀地看到每個時間段的成本消耗。

能明顯的看到，過去一天我的用量高峯，基本都是下了班以後的凌晨，夜深人靜，適合Coding。。。

就這個統計，真的非常的好用。

最後一個，也是一個非常實用的功能，特別適合一些使用多個國產模型搭配使用的用戶。

就是，有的時候，你可能會睡前給agent派個大活，讓他抓緊我睡覺的時候猛猛幹活。

但是呢，你可能會遇到額度突然用完，或者魔法不穩定中斷的情況，第二天起牀一看，活兒壓根沒幹完。

這種事用CC-Switch的本地代理帶故障轉移就能解決。

CC-Switch可以在你本地起一個代理服務，攔住你的CLI工具發出去的請求，幫你做API格式轉換、故障轉移和熔斷保護。

翻譯成人話就是。

你給同一個工具配了三家Claude Code供應商，比如GLM、MiMo、DeepSeek。

某天，某一家突然宕機了，或者額度用完了，或者請求半天沒響應。

CC Switch會自動切到下一家繼續跑，無痛遷移，不讓你的等待變成白等。

詳細的操作我也寫在這裏了。

我們點進左上角的設置。

找到路由服務，先打開本地路由的開關，把本地代理服務跑起來。

然後在應用路由區域啓用Claude路由，把Claude Code的請求接到本地代理上。

這裏建議也點開在主頁面顯示本地路由開關。這樣我們在主頁就能快速打開或關閉路由。

然後我們打開自動故障轉移，選擇Claude，再點添加供應商，把你要做備用的幾家加進隊列。

但是這裏需要注意，如果你用的是Claude的官方模型，那就別開路由，問題還是有點多的

最後我們可以在首頁列表通過拖拽給他們排序。

這樣CC Switch會優先列表上面的供應商進行路由，碰到故障就自動往下一家切。每個供應商卡片上會顯示一個健康狀態徽章。

要關閉的話，直接在主頁把這兩個按鈕關閉就行。

除了上面說的這些，CC Switch還有挺多其他功能可以細挖，比如會話管理。

還有模型配置雲同步等等，這裏就不一一展開了。

官方提供了一份非常全面的用戶手冊，寫得很詳細，地址放在這裏，有興趣的朋友可以去翻翻。

https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md

感謝每一位可以看到這裏的朋友。

說實話，這篇文章，我自己讀下來是有點枯燥的。

但是作為一篇工具介紹的文章，我也確實寫不出什麼花來。

這類文章的完讀率也一向比較低。

但如果能幫到其中，哪怕一個人。

那我覺得，這篇文章也就有價值了。

希望能對大家有那麼一點點用。

剩下的，就交給屏幕前的你自己折騰了。

祝各位，創作愉快。

以上，既然看到這裏了，如果覺得不錯，隨手點個贊、在看、轉發三連吧，如果想第一時間收到推送，也可以給我個星標⭐～謝謝你看我的文章，我們，下次再見。

>/ 作者：卡茲克，tashi

>/ 投稿或爆料，請聯繫郵箱：wzglyay@virxact.com