AI開発 ·

OmniRoute 実測:AI Gateway で 352 モデルに繋ぐ意味と Claude Code・Codex・Cursor の統一呼び出し

暗いダッシュボード:左の端末に OmniRoute の setup コマンド、右のカードに Claude Code、Codex、Cursor

同じ週に Claude Code、Codex、Cursor を同時に開いているとき、本当に時間を食うのは「もっと強いモデルを探すこと」ではなく、3つのキー、3つの Base URL、クォータ切れのたびに変わる応急処置です。OmniRoute の実測価値は、それらの入口をローカルの AI Gateway にまとめ、日常ワークフローに残すモデルだけを選ぶことにあります。

データ点: OmniRoute v3.8.50 の公開説明では 352 の provider、チャットカタログは約 1,312 のユニークなモデル ID です。「ちょうど 352 モデル」ではありません。見出しの 352 は接続面の広さに近く、受け入れ検査で見るべきなのは、1つの endpoint が Claude Code、Codex、Cursor を安定して扱えるかどうかです。(GitHub:OmniRoute

判断:先に入口を統一し、モデル数は後回し。 すでに3つのコーディングエージェントと環境変数を行き来しているなら、30分の受け入れは価値があります。公式プランが1つで、クォータ停止もほぼ無いなら、「352」のためにゲートウェイを足さない方がよいです。

対象は、Claude Code と Cursor を同時に使う個人開発者、Codex CLI とエディタの鍵を一本化したい少人数チーム、ノートPCごとに構成を複製したくないのでクラウド Mac に常駐 Gateway を置きたい担当者です。

最終更新は 2026年9月11日。数値は当時の公開説明です。社内Wikiに書く前に、稼働中ホストの /v1/models で実数を確認してください。

352 の意味:provider はモデル一覧ではない

検索スニペットは “352 providers” を「352モデル」に縮めがちです。README と omniroute.online を並べると、次の読み方が安全です。

  • 352 は登録済み provider 数。うち約150は無料発見フラグ付き。
  • チャットカタログは 1,200+ のモデル ID(v3.8.50 付近の公開表は 1,312)。
  • 無料枠、OAuth、ローカルモデル、クラウドカタログは分母が違う。足して営業数字にしない。

調達の問いが変わります。買っているのは 352 モデルではありません。OpenAI 互換の入口1つで3ツールを同じマシンに向けられるか、クォータ切れでフォールバックするか、失敗がキー・モデル名・プロトコル差のどれかをログで切り分けられるかです。

OmniRoute は MIT の自己ホスト型 AI Gateway で、既定ポートは 20128 です。ツールは localhost に送り、カタログ・クォータ・フォールバックで転送します。公式サイトの比較軸も、新しいチャット画面ではなく、provider 数、フォールバック、トークン圧縮、CLI 一発設定です。

カタログを棚、Gateway を倉庫係と考えると現場に近いです。棚は長くてよい。毎日出荷するレーンは数本です。352 は棚の幅、日常プロファイルは出荷規則です。両者を取り違えると、「たくさん繋がる」ことを「運用できるコーディングワークフローがある」と錯覚します。

なぜ3つのツールに共通ゲートウェイが要るのか

  1. プロトコルが違う。 Claude Code は Anthropic Messages、Codex は OpenAI Chat Completions、Cursor は OpenAI 互換 URL。ゲートウェイが無いと頭の中に3モデルが残ります。
  2. 鍵が散る。 Anthropic を Claude Code、OpenAI を Codex、別アグリゲータを Cursor。退職やローテーションで失効範囲が曖昧になります。
  3. クォータが同期しない。 Claude が止まっても Cursor は公式 API を叩き、Codex の無料枠終了をエディタは知りません。
  4. 名前が再利用できない。 同じ DeepSeek や GLM でも ID が3つになり、差がモデルか綴りか分かりません。

ゲートウェイは3製品を1つにしません。「どの環境変数を直すか」を「ゲートウェイの1ルート」にまとめます。少人数チームには、別の集約サイトを買うより日常に近いです。

同じホストで MCP やツールサーバーも動かすなら車線を分けてください。サイト内の クラウド Mac mini での MCP Server 配備 がツール経路、OmniRoute がモデル経路です。1プロセスに混ぜて切り分けないでください。

受け入れでは「失敗の言葉が共有されているか」も見ます。Claude Code がタイムアウト、Codex が 429、Cursor が “provider error” だけで、ゲートウェイログに共通の provider 名もモデル ID も無いなら、ホップは運用価値をほとんど足していません。統一呼び出しの目標は UI の一致ではなく、1人が1つのログで1件の失敗を説明できることです。

3ツールを同じ入口に繋ぐ

公式は稼働中カタログを読み、各ツール固有の設定を書く omniroute setup-* を用意しています。(CLI Integrations

ツールコマンド書き込み先よくある失敗
Claude Codeomniroute setup-claude~/.claude/profiles/…/settings.jsonANTHROPIC_BASE_URL/v1 を付けない。CLI が /v1/messages を足す
Codex CLIomniroute setup-codex~/.codex/.config.tomlOpenAI 互換の /v1。切替は profile
Cursoromniroute setup-cursorファイルは書かず、アプリ内手順を表示設定は不透明ストレージ。表示どおり Base URL とキーを入れる

恒久設定を触りたくないデモなら omniroute run claude / omniroute run codex でそのプロセスだけ環境注入できます。共有ワークステーション向きではありません。

Claude Code はゲートウェイ発見をオンにすると、ネイティブ /modelclaude / anthropic 始まりの ID に絞られます。Kimi、GLM、DeepSeek は profile か ANTHROPIC_MODEL で指定でき、ピッカーに出ないだけです。(Claude Code 設定

合格条件は、3ツールのリクエストがコンソールに出ること、失敗がどの provider か言えること、モデル変更で3社のダッシュボードを開かなくてよいことです。

図:Claude Code、Codex、Cursor がローカル OmniRoute に集まり、各 provider へ分かれる
3つのコーディングツールがポート 20128 を共有。カタログとフォールバックは Gateway 側。

初回配線では「会話できる」と「日常に耐える」を分けます。返信はポートが開いただけです。日常条件は、同じ短タスクが3ツールで再現し、失敗がログのモデル ID に対応し、profile 切替で3つの GUI を回さないことです。最初の返信で成功宣言すると、あとから Cursor が公式経路のまま、Claude Code に余分な /v1、Codex profile が1つのターミナルにしか効いていない、といった穴が出ます。

30分の受け入れリスト

  • [ ] 常時起動する Mac に Node.js があり omniroute が動く。
  • [ ] http://localhost:20128 にカタログが出る。白紙ではない。
  • [ ] ゲートウェイキーで /v1/models を叩き、実数を記録する。宣伝数字を貼らない。
  • [ ] 最初は Claude Code か Codex の1つだけ。
  • [ ] 再現可能な短タスクを送り、モデル ID・遅延・エラー種別をログで確認。
  • [ ] 優先モデルを落とし、フォールバックが起きるか見る。
  • [ ] 2つ目を繋ぎ、同じカタログか、別名リストではないかを確認。
  • [ ] ベンダーキーはゲートウェイ側。ツールにはゲートウェイトークンだけ。

カタログが取れなければ 352 はポスターです。カタログが大きくてもフォールバックが無ければ、プロキシと単一障害点が増えただけです。

短タスクは固定してください。「このフォルダのテストファイルを列挙し、関数を1つ説明する」で足ります。雑談は受け入れに弱いです。モデル ID の誤記も、ツール呼び出しが想定レーンを通ったかも見えません。時刻、ツール、モデル ID、フォールバック有無、生エラーを1行残します。2週間後、その表がアップグレード破綻か無料 provider 消失かを分けます。

入れるべき時、見送るべき時

状況妥当な判断理由
1人、公式プラン1つ、切替が稀直結のままプロセス、更新、ログが増える
Claude Code と Cursor が別キーを奪い合うOmniRoute を入れる既定モデル議論の前に入口を揃える
下書きは無料枠、仕上げは有料モデル入れ、ルートを書くクォータ感知の本領
指定ベンダー/地域に閉じたいprovider とコンプラを先に確認大きなカタログは適合リストではない
LiteLLM で既に3ツールが揃い方針が安定数字のために移行しないコストは方針側。インストールコマンドではない

トークン圧縮(公式は約 15–95% 削減)を「既定オンで節約」と書かないでください。長いリポジトリと反復コンテキストには効きます。短い補完では変換が1回増えるだけ、ということもあります。同じタスクでオンオフし、品質と請求を比べます。

ルーティングは壊れた tool-calling JSON を直しません。引数で落ちるなら、別ホップを足す前に AI Agent が JSON に依存する理由 を見てください。

評測に書かれにくい見送り理由もあります。当番がいないことです。Gateway は新しい単一障害点になります。蓋を閉じる、プロセス落ち、証明書期限、カタログ API 変更で、3ツールが同時停止します。再起動方針とスナップショットを置けないなら、入口統一の便利さは1回の共同障害で消えます。先に運用、そのあと 352 です。

なぜクラウド Mac に置くのか

ノート上の OmniRoute は個人試験向けです。Cursor、Claude Code、CI が同じカタログを共有した瞬間、蓋を閉じるとインフラが消えます。常時起動でき、スナップショットでき、権限を回収できるクラウド Mac の方が向きます。

  • launchd 等で常駐させ、ウィンドウを閉じても止めない。
  • 20128 はトンネルか私有網だけ。コンソールを公開しない。
  • キーはマシン側。Git にもチャットにも入れない。
  • アップグレード前にスナップショットし、カタログ変更を戻せるようにする。

ここでの Mac は「高いモデル」ではありません。ノートが寝ても3ツールが使い続けられる会合点です。権限分割は ZekVPS の Mac サポート を先に見てください。Gateway アカウントをホスト管理者にしないでください。

2人以上なら「Gateway ホスト1台+各自のエディタ」を推奨します。人ごとゲートウェイは隔離に見えて、ルート、無料枠判定、更新を3倍にします。共有の代償は境界です。同僚はゲートウェイトークンだけ持ち、上流キーも本番ルート編集も持たせません。線を書けば、352 provider は 352 の誤操作入口になりません。

よくある質問

OmniRoute はすでに 352 モデルなのか?

2026年9月の公開説明では、352 は主に provider です。モデルカタログは 1,200 超。受け入れはホストの /v1/models を正とします。

3ツールは同じ Base URL を共有できるか?

同じ OmniRoute ホストは共有できます。接尾辞は共有できません。Claude Code は通常 /v1 を付けません。Codex と多くの OpenAI 互換クライアントは /v1 です。Cursor は setup-cursor の表示に従います。

無料 provider だけで日常コーディングできるか?

下書きと探索には使えます。顧客コードや後から説明責任が必要な作業の唯一経路にはしないでください。無料枠は制限、待ち行列、突然の消失があります。

3ツールのリクエストが 352 社に漏れるのか?

ゲートウェイは制御下のマシンで動きます。上流はあなたが選びます。鍵の集約は、カタログ全行の開放ではありません。本番ルートはホワイトリストにしてください。

OpenRouter や LiteLLM がある。乗り換えるべきか?

352 という数字のためではありません。まだ3つのネイティブ設定を保守していて、setup-claude / setup-codex / setup-cursor で配線を終えたいなら検討してください。

入口を揃えてからカタログを広げる

OmniRoute の用途は、週末に 1,300 モデルを試す競技ではありません。期限切れ寸前のキーを3つ回さず、停止ではなくフェイルオーバーし、比較を1つのログで行うことです。352 は幅であり、既定プロファイルではありません。

個人試験が通ったら、スナップショット可能なクラウド Mac に移し、同僚のエディタも同じ入口を向けるのが次です。ホスト境界は ZekVPS のサービス説明 を見てから、ノートか遠隔ノードかを決めてください。

週報に書ける一文で閉じます。3つのコーディングツールが同じローカルポートに届くことを先に証明し、ホワイトリストに入れるモデルを後で決める。カタログは伸びてよい。日常ワークフローは短く、入れ替え可能で、戻せるべきです。

3つのコーディングツールを常駐 Gateway に集めたい?

ノートを閉じると Gateway は消えます。クラウド Mac なら常時起動し、アップグレード前にスナップショットできます。

月額の独立 Mac mini に OmniRoute、ログ、鍵の境界を置き、権限は回収できるようにします。

個人試験が通ったら、入口をスナップショット可能なノードへ。別の集約タブを買うより現場に近いです。 ZekVPS クラウド Mac mini プランを見る

期間限定