duolahypercho/codex-router

Codex Router – Codex アプリ用のマルチプロバイダー LLMゲートウェイ

何であるか

• コードックスデスクトップ/CLIアプリが、APIキーをコードックスアプリに公開せずに、多数の外部大規模言語モデル（LLM）プロバイダー（Anthropic、Kimi、DeepSeek、xAI/Grok、Gemini、GitHub Copilot、Ollama Cloudなど）と通信できるようにする、コミュニティメンテナンス型ユーティリティ。
• バックグラウンドサービス、オプションのElectronベースのコントロールセンター（macOS Dynamic Islandウィジェット付きのトレイ/メニュー項目アプリ）、およびプロバイダー認証情報、モデルカタログ、オプションの検索サイドカーを管理するCLIヘルパーをインストールします。

入手方法

• 推奨のワンクリックインストーラー（macOS/Linux/Windows） – シェル/PowerShellスクリプトを実行し、ローカルでElectron UIをビルドし、プロバイダーを選択するよう促し、認証情報をプライベートで隠されたプロンプトに保存します。
• Homebrewフォーミュラ – CLI（codex-routerコマンド）とそのNode/Python依存関係のみをインストールします；後で codex-router setup --guided を実行してプロバイダー選択を完了する必要があります。
• ガイド付きインストーラー – 推奨インストーラーと同じスクリプトですが、トレイ/ウィジェットは含まれません（--guidedのみ）。

コア機能

機能	説明
プロバイダールーティング	セットアップ後、コードックスタスクを開始し、ピッカーからルーテッドモデルを選択できます。ルーターはリクエストを選択された外部APIに転送し、必要なOAuthまたはAPIキーのヘッダーを追加します。
認証情報の安全性	APIキーとOAuthトークンはチャットUIに直接入力されません；一度だけ隠されたターミナルプロンプトで入力され、ユーザーごとの所有者専用の状態ディレクトリに保存されます。
モデルカタログ	ルーターは動的モデルリスト（READMEの詳細な表を参照）を構築し、対応する認証情報が存在する場合にのみ表示されます。ネイティブOpenAIモデルは codex login が成功した後のみ表示されます。
検索サイドカー	ネイティブWeb検索機能のないモデルに対して、Perplexity Searchプロバイダーをバインドできます。このサイドカーはモデル固有であり、認証情報もプライベートに保持されます。
クロスプラットフォームUI	macOSではコントロールセンターがメニュー項目にあり、「Dynamic Island」デスクトップウィジェットを表示できます。LinuxはCLIのみ；WindowsはPowerShellラッパー（codex-router.ps1）を提供します。
拡張可能なプロバイダーシステム	model-router codex providers generic add … を使って、一般的なプロバイダー（例：Perplexity）を追加し、特定のモデルにバインドできます。
セキュリティチェック	インストーラーは 認証情報なしモード（--no-provider --no-discovery）で実行可能で、キーを一切読み取らず、インストール/アンインストールのライフサイクルを最初に検証できます。

対応プロバイダーと認証スタイル

• OAuthベース（Kimi、Grok、Antigravity） – 公式CLIのOAuthセッションを再利用します。
• APIキーベース（DeepSeek、MiniMax、Qwen、ClinePass、Xiaomi MiMoなど） – キーは安全に保存され、コマンドラインに渡されることはありません。
• Ollama Cloud – Ollama Cloud APIキーを使用します。
• GitHub Copilot – Copilot Requests権限を持つ細粒度GitHub PATが必要です；ルーターは公式Copilot CLIストアを読み取りません。
• Antigravity（Google Gemini内部） – オプション、オペレーターから提供されるプライベートクライアントシークレットが必要；パブリックビルドでは利用不可。

一般的なワークフロー

1. インストーラーを実行（curl … | sh -s -- --target codex --guided --with-tray）。
2. 使用するプロバイダーを選択；必要に応じてOAuthログインまたはAPIキーの入力を促されます。
3. コードックスアプリを終了して再起動します。
4. 新しいタスクを作成し、ドロップダウンからルーテッドモデルを選択します。
5. （オプション）メニュー項目から Codex Router を開き、ステータスを確認、プロバイダーを変更、または検索サイドカーを管理します。

制限事項 / 備考

• このプロジェクトは、リストアップされたプロバイダー（OpenAI、Anthropic、Googleなど）のいずれとも関係ありません。
• macOSにはまだ事前ビルドされた .dmg が提供されていません；インストーラーはローカルでElectronアプリをコンパイルします。
• HomebrewフォーミュラにはElectron UIが含まれません；codex-router CLIのみを提供します。
• 一部のプロバイダー（例：Antigravity）は、公開されていないプライベートクライアントシークレットが必要です。
• 検索サイドカーはモデルごと；グローバルフォールバック検索は有効にできません。
• ルーターは、元のCodexクライアントのネイティブGPTモデルを変更しません；それらは既存のOpenAIログイン経由で直接アクセスされます。

詳細情報の入手先

• 完全なインストールガイド：docs/INSTALL.md
• Homebrew貢献ガイド：docs/HOMEBREW_CORE.md
• プロバイダー固有のノートは、READMEの大きなモデル/認証情報テーブルに埋め込まれています。

---

上記のすべての詳細は、リポジトリのREADMEから直接取得されています；追加機能は推測されていません。