duolahypercho/codex-router
External-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.
Codex Routerとは？
Codex Routerは、クライアント側ルーティングレイヤーであり、Codexデスクトップ/CLIアプリケーションが、Anthropic、Kimi、DeepSeek、xAI（Grok）、GitHub Copilot、Claude、Geminiなど、多数の大規模言語モデル（LLM）プロバイダーと通信できるようにします。アプリを切り替えたり、APIキーを手動で管理したりする必要はありません。
小さなバックグラウンドサービス、Electronベースのコントロールセンター（トレイ/メニューバーアプリとmacOS Dynamic Islandウィジェット付き）、およびコマンドラインツール（model-router）をインストールします。このサービスは、プロバイダーの認証情報をローカルに保存し（非表示のプロンプトを介して）、Codex内に統合されたモデルカタログを表示するため、タスクを開始するときに「ルーティングモデル」を選択できます。
主な機能（READMEに記載されている内容）
- マルチプロバイダー対応 – OAuthベースのセッション（例：Kimi Code、Grok、Claude）と通常のAPIキープロバイダー（DeepSeek、StepFun、Qwenなど）の両方で動作します。
- サブスクリプションエージェントブリッジ（実験的） – 既存のClaude、Cursor、Gemini CLIエージェントへのオプションの読み取り専用ブリッジ。Codexがこれらのツールを介してプロンプトをルーティングできるようにし、OAuthトークンを公開しません。
- 安全な認証情報の処理 – 認証情報がマシンから出ることはありません。ルーターは最小限のメタデータ（セッションID、タイムスタンプ）のみを保存し、プロンプトテキストをログに記録することはありません。
- クロスプラットフォームインストーラー – macOS/Linux用のガイド付きインストーラースクリプト、Windows用のPowerShellインストーラー、Homebrew formula、将来のnpmパッケージ計画。
- デスクトップ統合 – メニューバー/トレイアプリと移動可能なmacOSウィジェット（Dynamic Island）は、プロバイダーの有効化/無効化、使用状況の表示、ルーティングポリシーの設定を行う「コントロールセンター」として機能します。
- 広範なモデルカタログ – READMEには多数のモデルIDがリストされており、それぞれが必要な認証方法（OAuthセッション、APIキー、またはOllama Cloud）とペアになっています。ルーターは、有効な認証情報が存在するモデルのみを表示します。
- 偽のサブスクリプションプロキシなし – OpenAIのトークンからエンドポイントへの動作をエミュレートしません。選択したプロバイダーにリクエストを転送するだけです。
誰のためのものか？
- Codex UIを離れることなく、多くのLLMバックエンドを試したいCodexユーザー。
- さまざまなLLMサービスのAPIキー/OAuthセッションを一元管理する場所が必要な開発者。
- 認証情報をローカルに保持し、サードパーティのプロキシに公開しないようにしたいチーム。
インストール方法（クイックスタート）
# macOS / Linux（ガイド付き、トレイウィジェット付き）
curl -fsSL https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.sh \
| sh -s -- --target codex --guided --with-tray
# Windows
$installer = Join-Path $env:TEMP "codex-router-install.ps1"
Invoke-WebRequest https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.ps1 -OutFile $installer
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer -Target codex -Guided -WithTray
このスクリプトは、プロバイダーの選択、ログイン（例：kimi login）、バックグラウンドサービスのインストールを案内します。完了したら、Codexアプリを終了して再度開き、新しいタスクを開始すると、ピッカーにルーティングされたモデルが表示されます。
一般的なワークフロー
- インストーラーを実行 – 使用するプロバイダーを選択します。
- 認証 – インストーラーが非表示のターミナルプロンプトを開き、APIキーまたはOAuthログインを入力します。
- Codex Router Control Centerを開く – Spotlight（macOS）またはトレイアイコンから。
- Codexタスクを作成するときにルーティングモデルを選択します。
- （オプション）ブリッジを使用 – 例：
./bin/model-router codex agents probe anthropicでClaudeまたはGeminiブリッジを確認します。
コマンドライン使用例
# 利用可能なエージェントを一覧表示
./bin/model-router codex agents status
# ブリッジを介してAnthropicにプロンプトを送信（stdinから読み取る）
printf '%s' 'このリポジトリについて説明してください。' |
./bin/model-router codex agents prompt anthropic --cwd "$PWD"
プロジェクトの状態
- コミュニティ保守、記載されているプロバイダーとは無関係です。
- Claude、Cursor、Geminiのブリッジサポートは実験的です。
- macOSウィジェットはSwiftUI/WidgetKitで構築。WindowsとLinuxはElectron UIに依存します。
- CLI専用インストール用のHomebrew tapが利用可能。npmパッケージは計画中。
上記の詳細はすべて、リポジトリのREADMEから直接引用しています。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト