router-for-me/CLIProxyAPI

CLI Proxy API – これは何ですか

CLI Proxy APIは、OpenAIスタイルのHTTP APIを、さまざまな大規模言語モデルプロバイダー（OpenAI、Google Gemini、Anthropic Claude、xAI Grok、Kimiなど）への呼び出しに変換するセルフホスト型プロキシサーバーです。このプロキシをローカルで実行することで、api.openai.comエンドポイントを期待する既存のCLIツール、SDK、エディタ拡張機能をそのまま使い続けることができます。プロキシはリクエストを実際のプロバイダーに転送し、認証（OAuthまたはAPIキー）を処理し、複数のアカウント間でトラフィックを分散させることができます。

---

主な機能 (READMEより)

• マルチプロバイダー互換性 – OpenAI、Gemini、Claude、Grok、KimiなどのOpenAI互換エンドポイントを公開します。
• OAuthおよびAPIキーログイン – 各プロバイダーのネイティブなログインフローをサポートしているため、ツールに生のキーを公開する必要はありません。
• 負荷分散とラウンドロビン – プロバイダーごとに複数のアカウントを設定でき、プロキシが自動的にリクエストを分散します。
• ストリーミング、非ストリーミング、WebSocket – アップストリームモデルがサポートするすべてのレスポンスモードを透過的に処理します。
• 関数呼び出し / ツール使用 – 関数呼び出しのペイロードを転送するため、OpenAIの関数呼び出しに依存するツールをそのまま使用できます。
• マルチモーダル入力 – アップストリームモデルが許可する場合、テキストおよび画像ペイロードを受け入れます。
• 管理API – プロキシの検査と制御を行うためのHTTP APIを記述した独立したドキュメントファイル (MANAGEMENT_API.md) があります。
• Go SDK – 再利用可能なGoライブラリ (docs/sdk-*.md) により、開発者はプロキシロジックを自身のGoプログラムに直接組み込むことができます。
• オプションの使用量追跡サービス – プロジェクト自体には統計機能は組み込まれていませんが、ログ記録、コスト見積もり、ダッシュボードのために CPA Usage Keeper や CPA-Manager-Plus などのサードパーティ製ヘルパーの使用を推奨しています。

---

一般的なワークフロー

1. インストール プロキシ（またはUIを備えたコンパニオンデスクトップクライアント EasyCLIProxyAPI）。
2. 設定 config.yamlで1つ以上のプロバイダーアカウントを設定します（OAuthログインURLが提供されます）。
3. 実行 プロキシを実行します。ローカルポート（例: http://127.0.0.1:8000）でリッスンします。
4. OpenAI互換のCLIツール（例: curl、openai-cli、VS Code拡張機能）の接続先を、公式エンドポイントではなくローカルアドレスに向けます。
5. プロキシがリクエストを転送し、アカウント間で負荷分散を行い、変更なしでレスポンスを返します。

---

エコシステムと注目すべき統合

• デスクトップクライアント – EasyCLIProxyAPI（グラフィカルUI、トレイアイコン、自動更新）およびコミュニティによって構築された複数のトレイ/TUIアプリ。
• 管理ダッシュボード – Next.js/Reactで構築されたWebパネル、VS Code拡張機能、軽量なPowerShellトレイツール。
• サードパーティツール – vibeproxy、Subtitle Translator、Claude Proxy VSCode、ZeroLimit などのプロジェクトは、APIキーを直接扱うことなくAIサブスクリプションを統合するためにこのプロキシに依存しています。
• リレーサービス – READMEには、割引アクセスを提供する多くのスポンサー付きAPIリレープロバイダー（PackyCode、AICodeMirrorなど）がリストされており、プロキシは「OpenRouterスタイル」のアップストリーム設定を介してそれらのいずれにも接続可能です。

---

誰が使用すべきか

• 開発者：複数の有料LLMサブスクリプションを持っており、すべてのCLIツールに対して単一のローカルエンドポイントを求めている方。
• ツール作成者：プロバイダー固有のSDKを埋め込みたくない方。汎用的なOpenAI互換クライアントを出荷し、ユーザーにプロキシを実行してもらうことができます。
• チーム：プロバイダー間でのクォータ追跡、自動フェイルオーバー、コスト見積もりが必要な方。
• パワーユーザー：既存のスクリプトを書き直すことなく、新しいモデル（例: GPT-5.6、Claude Fable、Gemini 3.5 Flash）を試したい方。

---

はじめに & ドキュメント

• クイックスタートガイド – https://help.router-for.me/
• 管理API仕様 – MANAGEMENT_API.md（同じヘルプサイトでホストされています）。
• SDKドキュメント – docs/ 配下の複数のMarkdownファイル。基本的な使用法、高度なエグゼキューター、カスタムプロバイダー、ウォッチャーコンポーネントをカバーしています。
• コミュニティの例 – examples/custom-provider フォルダには、新しいアップストリームサービスを追加する方法が示されています。

---

ライセンスと貢献

リポジトリは標準的なfork-and-pull-requestワークフローによる貢献を歓迎しています。特別なCLAは言及されておらず、貢献者は通常のGitHubプロセスに従うよう求められています。

---

結論

CLI Proxy APIは、ローカルのコマンドラインツールとさまざまな商用LLM APIの間に位置する、真のオープンソースユーティリティです。これらを使い慣れたOpenAI HTTPスキーマに正規化し、複数アカウントの負荷分散、OAuth処理、オプションの監視機能を追加します。AIインフラストラクチャの分野に位置し、異なるモデルプロバイダーを単一の交換可能なバックエンドとして扱いたいすべての人にとって有用です。