OmniRoute 是什麼？把 Claude Code、Cursor 的 API 帳單省到接近 0 的免費 AI Gateway（2026）

截至 2026 年 7 月。AI 工具更新極快，文中的免費額度與供應商清單以官方 GitHub 為準，本文只做中性介紹，不構成任何投資或消費建議。

如果你有在用 Claude Code、Cursor 或 Codex，應該對一件事很有感：API 帳單燒得比想像快。跑幾個大專案、開幾次 agent，一個月幾十美金就沒了。更煩的是，各家其實都有免費額度——Groq、DeepSeek、Cloudflare、Cerebras、Qwen⋯⋯但額度分散在十幾個平台，你不可能一個個切換、一個個管 key。

最近 GitHub 上一個叫 OmniRoute 的開源專案，兩天衝上 trending、目前約 8,900 顆星，就是專門解這個痛點的。它的定位一句話講完：一個本地 AI gateway，把 236 個 AI 供應商（其中 50 多個有免費額度）整合成單一端點，讓 Claude Code、Cursor 這些工具「無痛」共用。

我把它的 GitHub 文件從頭到尾看了一遍，這篇就幫你把「它到底是什麼、怎麼裝、值不值得、有什麼坑」講清楚。

OmniRoute 到底是什麼？

用最白話的方式講：它是一個跑在你自己電腦上的「AI 中轉站」。

你把 Claude Code、Cursor 這些工具的 API 位址，從原本各家官方的網址，改成指向本機的 OmniRoute（http://localhost:20128/v1）。之後所有請求都先進 OmniRoute，由它決定「這一題丟給哪一家模型」——可以優先用免費的、免費額度用完自動切下一家、也可以照成本或速度排優先序。整個過程你原本的工具完全不用改用法。

它是 MIT 授權的開源專案、100% 自架，OmniRoute 本身不收你一毛錢，也沒有帳單系統。你付的錢是「直接付給各家 AI 供應商」，而它的價值就在於幫你把免費的榨乾、把付費的省到最少。

核心功能拆解

• 236 個供應商、50+ 免費額度：其中 11 個是「永久免費」（Cloudflare AI、NVIDIA NIM、Cerebras、Qwen、Pollinations 等）。官方說把免費的疊起來，每月大約有 16 億 token 的穩定額度可用。
• 自動 fallback：某一家額度用完或掛了，毫秒級自動切到下一家，不會中斷。
• Token 壓縮：內建 9 種壓縮引擎，官方宣稱可把送出的 token 砍掉 15%～95%。送給付費模型的 token 少了，帳單自然低。
• 接 16+ 種工具：Claude Code、Cursor、Cline、Copilot、Codex 都在支援清單，且有一鍵設定指令。
• MCP server + 儀表板：內建 MCP 伺服器、網頁儀表板（可看用量分析、壓縮成效）、60+ 個 CLI 指令。
• 多平台：npm、Docker、桌面 App（Electron）、甚至 Android（Termux）都能跑。

快速上手：三步接上 Cursor / Claude Code

前提：先裝好 Node.js（需要 22 或 24 LTS 版本）。

1. 安裝並啟動：
   npm install -g omniroute
omniroute
   啟動後打開 http://localhost:20128 就是儀表板。
2. 拿 API key：在儀表板的 Endpoints 頁面複製一組 key（這是給你本地工具用的，不是各家官方 key）。免費供應商多半不用另外申請；付費的才要去該平台拿 key 填進去。
3. 一鍵接上工具：跑對應指令，例如 omniroute setup-cursor（或 setup-cline、setup-codex）。它會自動幫你把該工具的 Base URL 改成 http://localhost:20128/v1、模型設成 auto（智慧路由）。

也提供 Docker 版，適合想丟到 NAS 或伺服器上長期跑的人：

docker run -d --name omniroute --restart unless-stopped \
  -p 20128:20128 -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

免費額度到底夠不夠用？

官方數字是「疊加免費供應商後，每月約 16 億 token 穩定額度，首月加上註冊贈金可達約 21 億」。這聽起來很誇張，但要講幾句實話：

• 這 16 億 token 是把十幾家免費額度全加起來的理論總和，不是單一家給你的。
• 免費供應商的模型，品質參差——拿來做一般問答、程式補全、草稿沒問題；但你要跑重度、要求高準確度的 agent 任務，還是會想用到付費的頂級模型。
• 免費額度政策隨時會變。今天某家佛心，下個月可能就收緊。這也正是 OmniRoute 的意義：哪家還免費，它幫你自動找、自動切。

結論是：如果你是「輕度到中度」使用者，靠免費疊加＋壓縮，確實有機會把月費壓到接近 0。重度使用者則是「大幅省」而非「全免」。

優點、缺點，還有你該知道的風險

優點很明確：省錢、自架資料不外流、一次管所有供應商、fallback 讓服務更穩、跟現有工具零改動。對重度用 Claude Code / Cursor 的人來說，光是「免費額度自動輪替」這件事就值得裝。

缺點與風險則要老實講，這也是我覺得多數搬運文不會提的地方：

• ToS 灰色地帶：OmniRoute 內建「TLS 指紋偽裝（JA3/JA4）」和「三層代理繞地區封鎖」等功能。大量疊加、輪替免費額度，本身就可能踩到部分供應商的服務條款。你要清楚：省下的錢背後有這層風險，帳號被限制的責任在你自己。
• 設定門檻：要自己裝 Node、跑指令、管儀表板。對完全不碰終端機的人不友善。
• 免費額度不保證：如前所述，政策會變，別把它當成穩定的生產環境唯一依賴。
• 還很新：專案更新頻繁、功能龐雜（連記憶層、guardrails 都有），穩定度需要時間驗證。

適合誰？不適合誰？

• ✅ 適合：重度用 AI coding 工具、每月 API 帳單有感、願意動手設定、想把免費額度用好用滿的開發者與重度玩家。
• ❌ 不適合：完全不碰終端機的純新手；需要企業級穩定與合規、不能承擔 ToS 風險的商業生產環境。

還有哪些替代方案？

如果你覺得 OmniRoute 太重，可以看看：OpenRouter（雲端聚合，設定最簡單，但要付費、不自架）、LiteLLM（開源代理，偏工程導向、更輕量）。三者的取捨大致是：OpenRouter 最省事、LiteLLM 最單純、OmniRoute 最省錢但也最複雜。

還沒決定要用哪個 AI coding 工具的人，可以先看我們這兩篇：Claude Code vs Cursor vs Codex 怎麼選、以及 Claude Code 新手 15 分鐘上手教學地圖。

常見問題 FAQ

OmniRoute 真的完全免費嗎？

軟體本身是 MIT 開源、完全免費，也自架在你電腦上。但「用 AI」這件事的成本是付給各家供應商的——OmniRoute 幫你優先用免費額度、壓縮 token，讓這筆成本盡量趨近 0，但付費模型還是要你自己付。

用它會不會讓我的 API key 外流？

它是自架的，資料與憑證都存在你本機（官方說用 AES-256-GCM 加密儲存）。相比雲端聚合服務，自架的資料掌控度更高，但相對地，安全與備份也是你自己的責任。

非工程背景的人裝得起來嗎？

老實說有點門檻。你至少要會裝 Node.js、開終端機打幾行指令。如果這幾步對你來說很陌生，建議先從桌面 App 版試，或先把上面「快速上手」三步照著做一遍。

免責聲明：本文為 AI 工具的中性資訊整理，所有數據以 OmniRoute 官方 GitHub 為準，可能隨版本更新而變動。文中提及的免費額度、TLS 指紋、代理等功能，使用時請自行評估是否符合各 AI 供應商的服務條款，相關風險與責任由使用者自負。本文不構成任何投資、消費或技術採用建議。