OmniRoute：裝好就能用的免費 AI 閘道器，連 API KEY 都不用

你遇到過這些問題嗎？

用 Claude Code 寫到一半，5 小時配額用完，被迫中斷重來。Cursor 切換模型要重新設定環境變數。Codex 只能接 OpenAI，完全跨不過去。每個 AI 工具活在自己的孤島裡，quota 用不完浪費、用完了乾瞪眼。

OmniRoute 解決的就是這件事。

OmniRoute 是什麼

一個開源的本機 AI 閘道器，裝一次，產生一個統一的 OpenAI 相容端點：

http://localhost:20128/v1

所有 AI 工具——Claude Code、Codex、Cursor、Cline、Copilot、OpenCode——全部接這一個 URL。OmniRoute 根據你設定的規則，自動決定用哪個供應商、哪個帳號、哪個模型來回應。一個帳號限流了，自動跳下一個。一個供應商掛了，1 秒內切換。

你的工具只會看到一個成功的回應。它不知道背後嘗試了三個供應商。

裝好就能用：OpenCode Free

OmniRoute 最強的地方是：裝完立刻可以用，完全不需要任何 API KEY。

它內建了一個叫 OpenCode Free 的供應商（對應的 provider ID 是 opencode），直接呼叫 OpenCode 的公開端點。不需要註冊、不需要 OAuth、不需要輸入任何 API KEY。

根據官方 README：「OmniRoute ships with keyless free providers (OpenCode Free, Felo) already wired into the auto combo, so a fresh install responds out of the box — no API key, no signup, no configuration。」

白話：裝好 OmniRoute，打開 Dashboard，直接用 auto combo 就能發請求。零成本、零設定、零 API KEY。

這跟 OpenCode Zen 完全不一樣——Zen 雖然有免費模型，但必須先儲值 20 美元才啟用 API key 使用那些免費模型額度。OpenCode Free 是真正的 No-Auth。

核心數字

免 API KEY 供應商一覽

以下供應商在 OmniRoute 中不需要任何 API KEY 或註冊：

這三個是真正的「零摩擦」——安裝 OmniRoute 後，auto combo 已經幫你把它們串好，直接就能用。

需要簡單註冊但完全免費的供應商

這些供應商需要一些認證步驟（OAuth 或 API Key），但不花錢：

五分鐘快速安裝

Step 1：安裝 OmniRoute

npm install -g omniroute
omniroute

Dashboard 自動開啟在 localhost:20128。

Step 2：直接用 auto combo

新版 OmniRoute 裝好後，auto combo 已經串好 OpenCode Free + Felo 等內建 keyless 供應商。直接把你的 AI 工具指向：

就能用了。先測試一下：

curl http://localhost:20128/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "Hello, world!"}]
  }'

Step 3（進階）：建立自訂 Combo

如果想串多個免費供應商做自動 fallback，可以在 Dashboard → Combos 建立組合。例如：

{
  "name": "free-forever",
  "strategy": "priority",
  "nodes": [
    { "provider": "opencode", "model": "auto" },
    { "provider": "pollinations", "model": "gpt-5" },
    { "provider": "groq", "model": "llama-3.3-70b" },
    { "provider": "cerebras", "model": "llama-3.3-70b" }
  ]
}

Strategy 選 priority：依序嘗試，第一個失敗就跳下一個。

Step 4：接你的 AI 工具

以 Claude Code 為例：

export ANTHROPIC_BASE_URL=http://localhost:20128/v1
export ANTHROPIC_API_KEY=omniroute
claude

OpenCode 的話：

opencode --provider openai \
  --base-url http://localhost:20128/v1 \
  --api-key omniroute \
  --model auto

注意：這裡設定的 opencode 是指 OpenCode CLI 工具，跟 OmniRoute 內建的 OpenCode Free 供應商是不同東西。用法是先裝 OpenCode CLI，然後把它的 provider 指向 OmniRoute 端點。

19 種路由策略

OmniRoute 不只是簡單的 fallback，它有 19 種路由策略：

RTK + Caveman 壓縮：省 15%–95% token

OmniRoute 內建兩種壓縮演算法：

• Caveman：把冗長的 tool payload 壓成精簡格式，最適合 Claude Code 的大量檔案操作
• RTK：智慧 token 壓縮，保留語意完整性

實測中，這兩種壓縮可以節省 15%–95% 的 token 消耗。免費帳號的配額本來就有限，壓縮後能撐更久。

接入 Hermes Agent

如果你用的是 Hermes Agent（正在執行這篇文章的那個 agent），接 OmniRoute 只需一行設定：

# config.yaml
providers:
  omniroute:
    base_url: http://localhost:20128/v1
    model: auto

Hermes 的 provider 支援直接指定 OmniRoute 的 auto combo，由 OmniRoute 自動路由到健康的免費供應商。也可以寫死特定供應商：

providers:
  opencode-free:
    base_url: http://localhost:20128/v1
    model: opencode/auto
  pollinations:
    base_url: http://localhost:20128/v1
    model: pollinations/gpt-5

多層 fallback 範例

把 keyless 供應商設為主要，付費供應商設為保底：

providers:
  omniroute:
    base_url: http://localhost:20128/v1
    model: auto
  # 當 auto 供應商全滿時 fallback 到自訂 combo
  fallback-free:
    base_url: http://localhost:20128/v1
    model: free-forever

# Hermes 本身的 provider fallback chain
provider: omniroute
fallbacks:
  - provider: fallback-free
  # 連免費 combo 都掛了才用付費
  - provider: anthropic
    model: claude-sonnet-4

這樣設定後，Hermes 每次請求的 routing 順序：

1. OmniRoute auto combo（OpenCode Free + Felo，零成本）
2. OmniRoute free-forever combo（多個免費供應商輪流 fallback）
3. Anthropic Claude Sonnet（花錢保底，通常用不到）

實測 curl

確認 OmniRoute 正常運作後，可直接用 Hermes 內建的 API 測試工具驗證路由是否生效。

實際使用場景

Combo: student-free
Strategy: priority
Nodes:
  1. opencode/auto（免費，無 API KEY）
  2. pollinations/gpt-5（免費，無 API KEY）
  3. groq/llama-3.3-70b（14.4K req/天）

Combo: hybrid
Strategy: priority
Nodes:
  1. opencode/auto（免費，無 API KEY）
  2. anthropic/claude-opus-4.6（付費，保底）

為什麼選 OmniRoute

• 裝好就能用：內建 OpenCode Free + Felo，一個 API KEY 都不用申請
• 一個 URL 搞定：所有 AI 工具接同一個端點，不用每次切換環境變數
• 自動 fallback：帳號限流、供應商掛掉，自動跳下一個，工作不中斷
• 免費為主：11+ 個供應商完全免費，其中 3 個連 API KEY 都不需要
• 智慧路由：19 種策略，從簡單的依序嘗試到 12 因子自動評分
• Token 壓縮：Caveman + RTK，免費額度多用 15%–95%
• 開源 MIT：500+ 貢獻者，28.4k ⭐

相關連結

• GitHub：github.com/diegosouzapw/OmniRoute
• 官網：omniroute.online
• OpenCode：opencode.ai