OmniRoute：Claude Code 額度用完，自動換下一家繼續跑

這是什麼

OmniRoute 是一個放在 GitHub 上的免費開源工具，採 MIT 授權，作者是社群開發者。它不是 Claude 官方出品，把它當成第三方工具看最安全。它預設裝在你自己的電腦上當一個轉接站：Claude Code 本來直接連 Claude 的伺服器，裝了它之後改成先連本機這一站，再由它決定這次要走哪一家供應商。

供應商家數不是固定值。現在裝得到的版本是 352 家，其中真正能跑對話模型的官方寫 229 家（2026-09-16 查證），數字會隨版本變動，上面封面截圖裡的 339 家是官網當天顯示的數字。

要注意的是，它預設不是「訂閱用完才自動往下跳」，而是把速度、成本、健康度、配額一起算分來挑。想一層一層往下踩，模型名稱要填 auto/thrifty，順序是訂閱、免登入、免費、便宜、高價，免費排在便宜前面。觸發換手的也不只是額度用完，供應商掛掉、太慢、被判定不健康都算。

它還會在指令送出去之前先壓縮一次。官方說可以少用 15% 到 95% 的 Token（AI 計算用量的單位），常被引用的 89% 是預設組合的平均值。程式碼、網址、JSON 這類內容官方標明會原樣保留。

誰需要

• Claude Code 開著開著就跳額度用完，只能乾等重置的人
• 手上已經有訂閱，但想在額度見底後把手邊的事做完的人
• 同時有好幾家 AI 的金鑰，懶得一個一個切換的人
• 願意多花五分鐘裝一個常駐小工具，換工作不被打斷的人

要不要錢

程式本身 MIT 開源免費，裝在自己電腦上跑不用付費，不用註冊帳號、不用信用卡，也不用去外面申請供應商金鑰。要知道的是，官方網站現在掛名「A Cheaper Inference product」，首頁會推銷這家公司的付費額度，你不理它也能用。

免費的部分，官方標示 150 家以上有免費方案，其中約 52 家是不用金鑰或會週期重置的永久免費。官方另外把有公布月額度的免費條目加總，得出每月大約 14.7 億個 Token，第一個月因為各家的註冊贈金最多可到約 20.7 億，之後就沒有了；另外還有一批沒公布上限的永久免費供應商，官方只列出來、不算進這個總數。這組數字官方每兩週對照重算一次，會上下浮動，以你後台當下顯示的為準。

真正會花到錢的，是它走到你自己的訂閱或你填的 API 金鑰時，那部分照你原本的方案計算。

怎麼開始

核心其實只有三步：裝起來、啟動、打開後台看一眼，也就是下面的第 3 到 5 步，大概五分鐘。前兩步是先把 Node.js 版本對好，第 6 步之後是產金鑰和接工具。

1. 先看 Node.js 版本，它是跑這個工具要用的執行環境。打開終端機（Mac 開「終端機」，Windows 開「PowerShell」），輸入 node -v 按 Enter。官方能跑的是 22.22.2 以上的 22 開頭，或 24、25、26 開頭的版本。
2. 版本不對就到 nodejs.org 下載 LTS（長期維護版本）覆蓋安裝，裝完關掉終端機重開。18、20、23 都不行，22 也必須是 22.22.2 以上，最保險是裝 24 開頭的版本。版本不對不會直接擋你裝，而是後台會一片空白或出現橘色警告，看到就回這一步換版本。
3. 安裝：輸入 npm install -g omniroute 按 Enter（貼文和贈品指南寫的 npm i -g omniroute 是同一個指令的縮寫，打哪一種都可以）。這個套件很大，跑很久是正常的，中間跳出黃色的 npm warn 不用管。
4. 啟動：輸入 omniroute 按 Enter，這個終端機視窗不要關，關掉服務就停了。第一次啟動會要你設一組 INITIAL_PASSWORD，那是本機後台的登入密碼，不是去註冊帳號。
5. 用瀏覽器打開 http://localhost:20128 登入，看得到儀表板就算成功。
6. 產一把自己的金鑰：在後台進 Dashboard 的 Endpoints 頁，建立一組 API 金鑰（讓程式之間互相確認身分的通行碼）。這一步不能跳過，否則接上去只會一直被擋。
7. 接 Claude Code：回終端機輸入 omniroute run claude，它會帶著設定去啟動 Claude Code，官方明講這個指令不會動到你原本的設定檔。同樣寫法也能接其他寫程式的 AI 工具，把最後的 claude 換成工具名字就好，例如 omniroute run codex、omniroute run gemini；其中 run qwen 一定要再加上 --model，沒加會直接結束。
8. 模型欄位填 auto 就好。想指定的話還有 auto/coding（寫程式優先）、auto/fast（回應最快）、auto/cheap（最便宜）、auto/thrifty（訂閱用完才一階一階往上跳）。
9. 其他支援 OpenAI 格式（多數 AI 工具通用的連線規格）的工具，把 API 位址填成 http://localhost:20128/v1，金鑰貼第 6 步那一組，模型填 auto。Cursor 不能用 run，官方給的是 omniroute setup-cursor，它只會把你要手動填的步驟印出來。

小提醒

它解決的是訂閱用完之後怎麼繼續跑，不是幫你省掉訂閱費。

• 換手之後品質會變，接手的可能是別家的別的模型。不過「換下去就一定不是 Claude」是誤解，訂閱層的 Claude Code 登入、免費層的免費 Claude 都可能回你，官方拿 Kiro AI 當例子，但它在官方的條款表裡被標成 avoid，要不要用自己斟酌。想知道這次是誰回的，到後台看路由紀錄。
• 會不會先用掉你付費的訂閱？贈品指南寫「預設先把訂閱用好用滿」，官方文件寫的是層級不會強制訂閱先跑。想自己控制，模型填 auto/thrifty，或填 auto/subscription（只用方案內額度，沒額度就直接報錯，不會偷偷幫你花錢）。
• 免費供應商有自己的服務條款，怎麼用是你自己的責任。官方逐家標了 ok、caution、ambiguous、avoid 四種，連預設就接上的那家都被標成 avoid，而且這個標記只是提醒，不會真的擋掉路由。公司機密和客戶資料不要丟進免費線路。
• 設定和金鑰存在你自己電腦（Mac 和 Linux 在 ~/.omniroute，Windows 新安裝的是 %APPDATA%\omniroute），金鑰有加密，遙測預設關閉。但你的提問還是會送到當次被選中的那家供應商。
• 每次開電腦都要自己再跑一次 omniroute。用 npm 安裝沒有開機自動啟動，沒跑起來的話，所有指向 localhost:20128 的工具都會連不上。
• Mac 出現 permission denied 不要加 sudo。贈品指南第 5 頁寫可以在指令前面加 sudo，那一段請以這裡為準：官方說明從頭到尾沒有這個建議，用 sudo 裝還會讓檔案變成系統擁有，之後更新更麻煩。改用 npx omniroute@latest 不裝全域，或把 DATA_DIR 設到你有權限的資料夾。
• 貼文和贈品指南寫的「90 幾家免費、每月 15 億 Token」是官方舊版標語，官方後來改成 150 家以上、每月約 14.7 億。翻到不同數字不是你看錯。
• 不想多一個要自己顧的常駐工具，或工作內容不能換別家模型的話，這個工具不用勉強。

本文發表於 2026-09-16。步驟依官方說明與贈品指南整理，工具日後可能調整，以官方為準。