Claude Codeの月額枠が尽きた瞬間にCursorへ切り替え、また別のAPIキーを探す——こうした手間が、コーディングの流れを何度も断ち切ります。

この記事では、オープンソースのAIゲートウェイ「OmniRoute」が、複数のAIコーディングツールと231のプロバイダを1つのエンドポイントに束ねる仕組みを解説します。

この記事でわかること

  • OmniRouteが解決する課題と基本構成
  • Auto-fallbackやトークン圧縮などの主な機能
  • 導入手順と対応ツール
  • LiteLLMなど類似ルーターとの違い

https://github.com/diegosouzapw/OmniRoute

複数ツールの切り替えが、コーディングを止める

AIコーディングツールを複数使うと、課題は「モデルの性能」より先に「運用」に現れます。Claude Codeのサブスク枠、CodexのOAuth、CursorのAPI設定——ツールごとに接続先がバラバラです。1社のレート制限や障害で作業が止まると、別プロバイダへ手動で切り替える必要が出ます。

さらに、git diffやログ出力などツール実行の結果はトークンを大量に消費します。無料枠や月額枠を効率よく使い切れず、月末に余るケースも珍しくありません。

OmniRouteとは

OmniRouteは、MITライセンスのオープンソースAIゲートウェイです。ローカルマシン上で動かし、OpenAI互換の単一エンドポイント(http://localhost:20128/v1)を介して、背後の231プロバイダへリクエストを振り分けます。

公式サイトによると、対応プロバイダは231社、うち50社以上が無料枠を持ち、11社はクレジットカード不要の「永久無料」枠です。ドキュメント上の集計では、月あたり約16億トークン分の無料枠をプール重複を除いて可視化しており、初月はサインアップクレジット込みで最大約21億トークン相当とされています。

データはローカルのSQLiteに保存され、認証情報はAES-256で暗号化されます。テレメトリ送信やクラウドアカウントは不要で、セルフホスト型の設計です。

レート制限や障害をAuto-fallbackで吸収する

OmniRouteの中核は「Combos」と呼ばれるルーティングチェーンです。1つのモデル指定に対し、複数プロバイダを優先順位付きで並べ、クォータ枯渇や障害時にミリ秒単位で次候補へ切り替えます。

READMEの説明では、フォールバックは4段階で設計されています。Tier 1はClaude CodeやCopilotなどのサブスクリプション枠、Tier 2はAPIキー課金、Tier 3は低コストモデル、Tier 4はKiroやPollinationsなどの無料枠です。サブスク枠が尽きても、安価なAPIや無料プロバイダへ自動で流れます。

ルーティング戦略は17種類あり、モデル名をautoにするだけで9要素スコアリング(健全性・コスト・レイテンシなど)による自動選択も可能です。auto/codingはコード生成向け、auto/cheapは最安モデル優先、auto/fastは低遅延優先と用途別に切り替えられます。

障害対策は3層構造です。プロバイダ単位のサーキットブレーカー、接続単位のクールダウン、モデル単位のロックアウトが独立して働き、1つの障害が全体を止めない設計になっています。

RTKとCavemanでトークンを15〜95%削減

コーディングセッションでは、ツール出力がコンテキストを圧迫します。OmniRouteはRTK(ツール結果のフィルタリング・重複除去)とCaveman(ルールベースの散文圧縮)を段階的に適用し、対象トークンの15〜95%を削減します。公式資料では、ツール出力が多いセッションで平均約89%の削減例が示されています。

圧縮エンジンは9段のスタックで、Session-Dedup、CCR、Headroom、LLMLingua-2なども組み合わせ可能です。プロファイルやリクエストヘッダー(x-omniroute-compression)で強度を調整でき、圧縮はモデルに送る前のローカル処理として動作します。

対応ツールとプロトコル変換

OmniRouteはOpenAI API、Claude API、Gemini API、Responses APIの相互変換を内蔵します。Base URLをhttp://localhost:20128/v1に向けるだけで、既存ツールをそのまま接続できます。

対応コーディングエージェントは16種類以上で、Claude Code、Cursor、Codex、GitHub Copilot、Cline、Antigravity、Continue、OpenCodeなどが挙げられます。OAuth対応プロバイダは19社で、Claude CodeやGemini CLIの認証フローもダッシュボードから設定できます。

MCP(Model Context Protocol)サーバーも内蔵され、87ツールを30スコープで公開します。A2A(Agent-to-Agent)プロトコルにも対応し、CodexやDevin、Julesなどのクラウドエージェントを同一インターフェースから操作できます。

導入手順

Node.js 22.0.0以上が必要です。ターミナルで以下を実行します。

npm install -g omniroute
omniroute

起動後、ダッシュボードはhttp://localhost:20128、APIは同ポートの/v1で待ち受けます。初回はダッシュボードのProviders画面でOAuthまたはAPIキーを登録し、Endpoints画面でAPIキーを発行します。任意でCombos画面にフォールバックチェーンを設定します。

コーディングツール側の設定例は次のとおりです。

  • Base URL: http://localhost:20128/v1
  • API Key: ダッシュボードで発行したキー
  • Model: auto(自動ルーティング)またはif/kimi-k2-thinkingのようなプロバイダ/モデル指定

Docker、Electronデスクトップアプリ、Termux(Android)、PWAからのインストールにも対応しています。設定とデータはデフォルトで~/.omnirouteに保存されます。

料金と運用コスト

OmniRoute本体は無料のオープンソースです。利用料金は背後のプロバイダ課金に依存し、無料枠だけで運用することも可能です。サブスクリプション型ツールの月額枠を優先的に消費し、枯渇後に安価なAPIや無料枠へ流す設計で、有料APIの出費を抑えやすくなります。

LiteLLMなど類似ツールとの違い

AIルーティングにはLiteLLMや9router、CLIProxyAPIなどもあります。公式サイトの比較表では、OmniRouteは231プロバイダ、15ルーティング戦略、RTK+Cavemanの段階圧縮(15〜95%)、内蔵MCPサーバー(87ツール)を強みに挙げています。LiteLLMは100社超のプロバイダ対応とガードレールが充実する一方、トークン圧縮やMCPサーバー機能はOmniRouteと役割が異なります。9routerはRTK圧縮(20〜40%)に対応しますが、段階的なCavemanスタックはOmniRoute独自です。

選び方の目安は次のとおりです。Python中心の既存パイプラインに組み込むならLiteLLM、コーディングツールをローカルで束ねて無料枠を最大化したいならOmniRouteが向きます。

注意点

231プロバイダという数字はカタログ上の接続先数であり、実際に使えるモデルは登録した認証情報に依存します。無料枠の集計はプール重複を除いた「文書化された上限」であり、常時フル稼働で16億トークンが使えるわけではありません。各プロバイダの利用規約は個別に確認が必要です。

ローカルで動くため、マシンを止めるとゲートウェイも停止します。常時稼働させる場合は、専用マシンやDockerでの常駐運用を検討してください。プロジェクトは2026年2月13日の公開以降、6月29日時点でv3.8.40がリリースされており、活発に更新されています。

複数のAIコーディングツールを使い分ける運用は、接続設定と枠管理の負担が積み重なります。OmniRouteは1エンドポイントへの集約、Auto-fallback、トークン圧縮の3点で、その負担をまとめて下げるゲートウェイです。Claude CodeとCursorを併用している開発者は、まずローカルで試し、自分のワークフローに合うか確認する価値があります。