「Claude Codeの定額枠を使い切った」「Cursorが急にレート制限で止まった」。OmniRoute(diegosouzapw/OmniRoute)は、こうした摩擦を1本のローカルゲートウェイで解消する、GitHubスター48,000超・MITライセンスのOSSです。OpenAI・Anthropic・Google・DeepSeekと増えたAPIキーとダッシュボードを、1つのエンドポイントに畳み込みます。
公式の約束は「1エンドポイント、340プロバイダ。二度と手を止めない」。Claude Code・Codex・Cursor・Cline・Copilotの接続先を書き換えるだけで、90以上の無料枠を含むプロバイダ群へ、自動フォールバックしながらリクエストを流せます。
本記事は、リポジトリを実際に落として数え直しました。読む前に知っておくべきズレが2つあります。「340」は未リリースのmainの数字でnpm install -g omnirouteで入るのは290であること、無料系プロバイダではツール呼び出し(function calling)の対応が薄いことです。検証手順は第4章に置きました。
30秒でわかるOmniRoute
- ・何ができる:340プロバイダ・90超の無料枠を
localhost:20128/v1に束ねる、MITの無料AIゲートウェイ。 - ・何を解決する:APIキーの分散、レート制限による中断、想定外のAPI課金、ツールごとの設定。
- ・何を代替する:LiteLLMやOpenRouterのようなルーターと、トークン圧縮・内蔵MCPサーバーを1プロセスに集約。
- ・実測:「340」は
main(v3.8.50)の値。npmの最新v3.8.49は290。 - ・実測:無料の
claude-webはtoolsを黙って捨てるため、コーディングエージェント用途では機能しない。
Claude Code側の設定そのものは扱いません。導入からCLAUDE.md・Hooksまで通しで押さえたい方は、Claude Code|2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引きを先にどうぞ。まずは公式の英語ウォークスルーで、ダッシュボードの雰囲気を掴んでください。
1. OmniRouteとは何か|無料AIゲートウェイの全体像
AIゲートウェイとは、複数の宛先へのリクエストを1か所で受け、認証・変換・振り分け・記録をまとめて引き受ける「関所」です。OmniRouteはこれをローカルの1プロセスで提供し、Claude Code・Codex・Cursor・Cline・Copilot・Antigravityなど33のコーディングエージェントを共通設定(http://localhost:20128/v1)で束ねます。技術スタックは100% TypeScript 6.0、Next.js 16、better-sqlite3。CLIとWebダッシュボードは同じポートで動きます。
出自は謝辞に明記されています。9routerのforkとして始まり、Go製CLIProxyAPIのTypeScript移植として出発したプロジェクトです。ポート番号が9routerと同じ20128なのは、その血筋のためです。コスト計算の価格データはLiteLLMの公開データセットから同期しています。
公式READMEが掲げるカバレッジは次のとおりです。
・340プロバイダ:OpenAI・Anthropic・Gemini・xAI・DeepSeek・Mistral・Qwen・Groq・NVIDIAなど
・90以上が無料枠あり/56が永久無料:Kiro・Qoder・Pollinations・LongCat・Cloudflare AI・Cerebrasなど
・Web・デスクトップ(Electron)・Android(Termux)・PWAで動作
管理画面ではプロバイダを種類別(APIキー互換・無料枠・OAuth)に並べ、トグル1つで接続を切り替えます。
2. 4段フォールバックとCombosでレート制限を避ける
READMEは日々の痛みと解決策を次のように対応づけています。
・サブスク枠が使い切れず失効する → 残量を追跡し、リセット前に使い切る
・レート制限でコーディングが止まる → サブスク→API→格安→無料の4段自動フォールバックで切り替える
・高額なAPIがかさむ → ライブ価格表を見て最安の使えるモデルへルーティングする
・ツールごとに別々のセットアップが要る → 1エンドポイント・全ツール・1ダッシュボード
中核の4段フォールバックは、上位の枠から順に使い、枯れたら1つ下へ滑り落ちる仕組みです。
4-TIER FALLBACK4段フォールバック
上の枠が尽きたら、下の段へ自動で滑る
-
Tier 1
サブスク枠
Claude Code / Codex / Copilot の定額枠を使い切る
-
Tier 2
APIキー
DeepSeek / Groq / xAI
-
Tier 3
格安
GLM 1Mあたり$0.5 / MiniMax $0.3
-
Tier 4
無料(常時ON)
Kiro / Qoder / Pollinations
この連鎖を組むのがCombosです。最も手軽なのは、モデルIDにautoを指定するゼロ設定ルーティングで、接続済みプロバイダを14因子(健全性・残量・コスト・レイテンシ・成功率など)でライブ採点します。auto/coding(品質優先)、auto/fast(レイテンシ優先)、auto/cheap(最安優先)といった用途別バリアントもあります。
細かく制御したいときは、19のルーティング戦略から自前のコンボを組みます。代表例は次のとおりです。
| 戦略 | 何をするか |
|---|---|
priority |
先頭から順に、各ターゲットを使い切ってから次へ |
cost-optimized |
ライブ価格表から1リクエストの$を最小化 |
headroom |
残量がいちばん多いターゲットを選ぶ |
lkgp |
直近で成功したターゲットに固執する |
fusion |
複数モデルに並列で投げ、judgeが1つの答えに統合 |
耐障害性は3つの独立した層で担保されます。サーキットブレーカー(プロバイダ単位)は失敗し続ける上流への連打を止め、接続クールダウン(キー単位)はレート制限されたキーを飛ばし、モデルロックアウト(モデル単位)は枠切れのモデル1つだけを隔離します。1つのモデルが429を返しても、接続全体は止まりません。
1リクエストだけ挙動を変えたいときは、HTTPヘッダで上書きできます。X-OmniRoute-Budgetでそのリクエスト限りのUSD上限を、X-Route-Modelでモデルを差し替えられます。
3. RTK+Cavemanのトークン圧縮で最大約95%削減
もう1つの目玉が、リクエストを透過的に通すだけでトークンを削る圧縮パイプラインです。クライアント側の改修は不要で、通過する全リクエストが12個の合成可能なエンジンを順に通ります。エンジンはコンボごとにON/OFFできます。主なものは次のとおりです。
| エンジン | 何をするか |
|---|---|
| Lite | 空白・画像URLの削減(低レイテンシの基準線) |
| RTK | ツール結果のフィルタ・重複除去・切り詰め |
| Headroom | 均質なJSON配列を可逆な表形式に圧縮 |
| Caveman | ルールベースの散文圧縮 |
| LLMLingua-2 | MobileBERT ONNXによる意味的プルーニング |
| OmniGlyph | 実験的。コンテキストを画像として符号化(opt-in) |
これらを組み合わせたプリセットの目安は次のとおりです。RTKとCavemanを積む「Stacked」は、2つの圧縮率が複利で効き、公式の計算で平均89.2%(範囲78.4〜94.6%)です。
TOKEN SAVINGS圧縮モード別の削減率
RTKとCavemanを重ねると平均89%(公式の目安値)
削るのは入力側の冗長部分だけで、コードブロック・URL・JSON・構造化データはバイト単位で保護されると公式は説明します。ただし、これらの削減率はプロジェクト側の主張で、当サイトは未検証です。圧縮率が上がるほど欠落リスクも上がるため、npm run eval:compressionのオフライン評価で削減率と忠実度を測ってから、強いモードへ上げるのが安全です。
適用の優先順位は、リクエスト単位のx-omniroute-compressionヘッダが最上位で、コンボ設定、有効プロファイル、自動トリガーの順に解決されます。結果はX-OmniRoute-Compressionレスポンスヘッダに返ります。「常時ONはLite、ツール出力が多いセッションだけRTKを積む」という使い分けが、設定を汚さずにできます。
圧縮の発想は既存OSSの継承です(CavemanはCaveman(原始人スキル)とはで解説)。散文圧縮のCaveman、コマンド出力圧縮のRTK(Rust Token Killer)、MicrosoftのLLMLingua-2を、1つのパイプラインに束ねています。実際の使用量と節約額は、Usage画面でモデル別・キー別に追えます。
4. 実測|「340」は何を数えた数字か
ここからは、掲げられた数字を実際に数え直します。OmniRouteはプロバイダ一覧をdocs/reference/PROVIDER_REFERENCE.mdとして自動生成しており、これが検証にそのまま使えます。
npmで入るのは340ではなく290
このファイルのfrontmatterはversion: 3.8.50・lastUpdated: 2026-08-15です。一方、npmで配布されている最新版はv3.8.49でした。READMEも「The Gateway Keeps Growing」の表で、v3.8.49が290プロバイダ/1,185モデル、v3.8.50が340プロバイダ/1,202モデルと分けています。両方のタグから一覧のデータ行を数えました。
VERSION GAP340と290のズレ
「340」はmainの数字、npmで入るのは290
main(v3.8.50)
未リリース・一覧340行
- README見出しの340はこちら
- 1,202モデル
npm最新 v3.8.49
npm install -g で入る版
- 一覧290行
- 1,185モデル
git clone --depth 1 https://github.com/diegosouzapw/OmniRoute.git && cd OmniRoute
git fetch --depth 1 origin refs/tags/v3.8.49:refs/tags/v3.8.49
# main(v3.8.50)の一覧行数 → 340
grep -cE '^\| `[^`]+` \|' docs/reference/PROVIDER_REFERENCE.md
# リリース済み v3.8.49 の一覧行数 → 290
git show v3.8.49:docs/reference/PROVIDER_REFERENCE.md | grep -cE '^\| `[^`]+` \|'
行数は見出しの内訳(No-auth 10・OAuth 25・Web Cookie 35・APIキー 228・ローカル 12・検索 12・音声 12・上流プロキシ 2・クラウドエージェント 3・システム 1)とも一致し、合計340になります。数字は正確で、ズレているのは「どの版の話か」だけです。340を前提に選ぶなら、npm版ではなくmainかv3.8.50以降のリリースを使います。
ツール呼び出しの対応表記があるのは14件だけ
Claude CodeやClineは、ファイル読み取りやコマンド実行をすべてツール呼び出しで行います。効かないプロバイダに繋ぐと、モデルは会話するだけになります。src/shared/constants/providers/*.tsのtoolCalling宣言を集計すると、リポジトリ全体で14件でした。
| 表記 | 件数 | 意味 |
|---|---|---|
native |
1 | 本物のfunction calling(chatgpt-web-codexのみ) |
emulated |
12 | <tool>{...}</tool>をプロンプトで注入し、正規表現で回収する疑似実装 |
none |
1 | tools配列を黙って捨てる(claude-web) |
これは「340中1件しか使えない」という意味ではありません。宣言が付くのは、Webアプリをcookieで包むタイプだけです。残る228件のAPIキー系はOpenAI互換でfunction callingが効く前提のため注記がなく、この表は無料・cookie系に手を出すときの地雷マップです。
無料のClaude枠(claude-web)は tools を落とす
noneが付く唯一のclaude-webは、READMEの売り文句「Claude Codeを無料のClaudeに繋ぐ」の当事者です。ソースにはコメントごとこう残っています。
// #7286 Level 3 (deferred): still silently drops tools[] — getDefaultTools()
// is a fixed Claude.ai backend contract; needs an emulate-vs-native decision.
toolCalling: "none",
対応するIssue #7286は2026-07-19にcompletedでクローズされています。しかし、疑似実装のシムprepareToolMessagesを読むのはgemini-webなど別の実行系で、claude-webは参照していません。completedなのはgemini-web側が入ったためで、claude-webはdeferredとして残されています。エラーも警告も出ずtoolsが捨てられるため、利用者には「設定を間違えた」ように見えます。
実務上の判断
無料のClaude(claude-web)にコーディングエージェントを繋ぐ使い方は、現時点では成立しません。チャット用途なら問題ありませんが、ツール呼び出し前提のクライアントでは何も実行されないままになります。エージェント用途では、function callingが効くAPIキー系プロバイダを選んでください。
Claude Codeの基礎はClaude Codeとは?2026年版の基礎解説、運用の詰め方はClaude Codeベストプラクティスで補えます。
規約面では、コード側のsubscriptionRisk: trueフラグが41件(OAuth系18件+Web Cookie系23件)ありました。READMEの「15プロバイダがToSフラグ」は無料トークン量の集計という別の数え方なので、単純比較はできません。Kiroは一覧に「Kiro ToS prohibits third-party proxy/harness use」と明記されています。無料枠を業務で使うなら、各提供元の規約確認は避けられません。
5. OmniRouteとLiteLLM・OpenRouter・Portkey・Heliconeとの比較
OmniRoute公式の比較ドキュメント(2026-Q2時点の監査)を基に、当サイトでHeliconeを補ったLLMルーターの比較表です。
| 項目 | OmniRoute | LiteLLM | OpenRouter | Portkey | Helicone |
|---|---|---|---|---|---|
| プロバイダ数 | 340+(main) | 約100 | 約50 | 約30 | パススルー |
| 無料枠プロバイダ | 90+ | なし | パススルー | なし | なし |
| 自己ホスト | 可 | 可 | 不可(SaaS) | 有料 | 可 |
| 自動フォールバック | 19戦略 | 優先度ベース | ティアベース | 加重 | 基本的 |
| トークン圧縮 | 12エンジン | なし | なし | なし | なし |
| 内蔵MCPサーバー | あり | なし | なし | なし | なし |
| 主眼 | 全部入りゲートウェイ | Python統合 | SaaS集約 | 商用SLA | ログ・監視 |
| ライセンス | MIT | MIT | プロプライエタリ | プロプライエタリ | OSS |
比較表の読み方
OmniRoute以外の列は公式の自己申告に基づき、1〜2世代前の監査です。「340」は第4章のとおりmainの値で、npm版は290です。「90+」「95%削減」は未検証のプロジェクト側の主張です。Heliconeは監視が主眼で、大量にファンアウトするルーターとは設計が違うため、勝ち負けは用途で決まります。
選び分けの指針は次のとおりです。
・OmniRoute:自己ホストで最大のプロバイダ網が欲しい。内蔵MCPや圧縮まで1プロセスで済ませたい
・LiteLLM:Pythonのlitellm.completion()に密結合したい。Kubernetes向けの成熟した本番レシピが欲しい
・OpenRouter:自己ホストせず、SaaSの従量課金で1つの支払いにまとめたい
・Portkey:商用SLAとエンタープライズのコンプライアンス機能が要る
6. OmniRouteのセットアップとClaude Code・Cursor接続の注意点
導入はnpmでグローバルインストールして起動するだけです。ダッシュボードはhttp://localhost:20128、APIは/v1に立ち上がります。
npm install -g omniroute
omniroute
# 接続済みモデルが並べば成功
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
ダッシュボードのProvidersで無料プロバイダを1つ繋ぎ、手元のツールには次を設定します。omniroute setupのウィザードや、ツールごとのsetup-*コマンド(Claude Code・Codex・Cline・Cursorなど)も用意されています。
・Base URL:http://localhost:20128/v1
・API Key:ダッシュボードのEndpointsからコピー
・Model:auto(ゼロ設定スマートルーティング)
繋ぐ相手は選んでください。第4章のとおり、無料のClaude枠はツール呼び出しが効きません。KiroはToSが第三者プロキシ経由の利用を禁じています。まず試すだけなら規約上の制約が無いものから、恒常的に使うなら規約を読んでからにしてください。Qoder・Pollinationsなど一部の永久無料は上限なしですが、Cookieセッションを使う接続は提供元のToSに抵触し得ます。
安全面では、OmniRouteは自分のハードウェア上で動くローカルプロキシで、既定でテレメトリを送らず、APIキーとOAuthトークンはAES-256-GCMで暗号化して保存します。一方でMITM復号やTLSフィンガープリント偽装といった強力な機能も持つため、使う環境と権限は自分の責任範囲に限ってください。
まとめ:OmniRouteは、乱立するプロバイダと無料枠を1本のエンドポイントに束ねる関所です。自動フォールバックで手を止めず、圧縮でトークンを削り、内蔵MCPまで1プロセスに載せます。ただし手元に入るのはv3.8.49の290プロバイダで、無料Claude枠はコーディングエージェントの代替先にならない点だけ、先に頭に置いてください。最小構成(omniroute、無料プロバイダ1つ、auto)で動かし、必要になった機能だけ足すのが近道です。
参照ソース
・OmniRoute(diegosouzapw/OmniRoute 公式リポジトリ) — README・機能一覧・謝辞
・OmniRoute vs Alternatives(公式比較ドキュメント) — LiteLLM/OpenRouter/Portkeyとの機能比較
・Provider Reference(自動生成のプロバイダ一覧) — 340と290の数え直しの根拠
・Issue #7286: tool calling for claude-web / gemini-web — claude-webのツール呼び出し
・OmniRoute 公式サイト — プロジェクト概要
・npm: omniroute — パッケージ・バージョン情報





