Infinite Claude Codeとは？
Infinite Claude Codeは、Claude Code CLI、Claude Desktop、対応IDE拡張機能などの公式Anthropicクライアントを、OpenAI互換モデルプロバイダーのプールに接続する、依存関係不要のNode.jsプロキシです。/v1/messagesでAnthropic Messages APIリクエストを受け付け、プロバイダー形式に変換してから、レスポンスをAnthropic互換のリアルタイムServer-Sent Eventsに変換します。
このプロジェクトは無料のクラウドモデルを優先し、任意のプロバイダー認証情報に対応しているほか、ローカルのOllamaインスタンスへフォールバックできます。プロジェクトREADMEによると、ルーターは高速に起動し、RAM使用量は30 MB未満で、アイドル時のCPU消費はありません。
リポジトリでは、事前設定済みのクラウドプールを無料で利用できると説明しています。ただし、プロバイダーの可用性、レート制限、モデルへのアクセス、料金は外部サービスによって変更される可能性があるため、継続的なワークロードで利用する前に各プロバイダーの最新の利用規約を確認してください。
ルーターの仕組み
ローカルルーターは、デフォルトで127.0.0.1:20129をリッスンします。Claude CodeがこのエンドポイントにAnthropic形式のリクエストを送信すると、Infinite Claude Codeがタスクを分類し、適切なモデルを選択し、ツール呼び出しを変換して、結果をクライアントへストリーミングします。
Claude Code、Claude Desktop、またはIDE拡張機能が
/v1/messagesへリクエストを送信します。セマンティック分類器がプロンプトと利用可能なツールを調べます。
ディスパッチャーが優先プールからプロバイダーとモデルを選択します。
そのプロバイダーが利用できないかレート制限に達した場合、ルーターは設定済みの別のプロバイダーへ移行します。
OpenAI形式の関数呼び出しがAnthropicのツール使用メッセージに変換されます。
レスポンストークンがリアルタイムSSEストリーミングで返されます。
クラウドルートが利用できず、Ollamaが設定されている場合、ルーターはローカルモデルを使用できます。
主な機能
サブエージェントの並列ディスパッチ
Claude Codeが複数のサブエージェントやバックグラウンドセッションを開始すると、スワームディスパッチャーは同時リクエストを異なるプロバイダーに分散できます。これにより、単一プロバイダーへの集中やレート制限による失敗を減らすことを目的としています。
セマンティックタスクルーティング
ルーターは、想定されるワークロードに応じてモデルを選択します。文書化されているルーティング戦略では、アーキテクチャタスクにはNemotron 120BやKimi K3などの推論モデル、コード生成やファイル編集にはNorth Mini CodeやQwen Coderなどのコード特化モデル、クイックコマンドにはNemotron Lightningを優先します。
ツール呼び出しの修復
一部のオープンウェイトモデルは、ツール引数に不正なJSONを生成します。Infinite Claude CodeにはASTベースのサニタイザーが組み込まれており、Claude Codeがツール呼び出しを実行する前に、エスケープされていない引用符や不完全な括弧などの問題の修復を試みます。
プロバイダーの自動フェイルオーバー
このプロジェクトは、OpenRouter、NVIDIA NIM、OmniRouter、9Router、Groq、Cerebras、Together AI、Google Gemini、Mistral AI、OpenAI、Anthropicなど、その他の任意サービスを含む優先プールに対応しています。失敗したリクエストやレート制限されたリクエストは、利用可能な別のプロバイダーを通じて再試行できます。
モニタリングダッシュボード
ブラウザベースのHUDに、アクティブなサブエージェント、プロバイダーのアクティビティ、生成トークン数、レイテンシ、公式Claude 3.7 Sonnet API料金に基づく推定節約額カウンターが表示されます。
オフラインフォールバック
Ollamaを使用すると、qwen3:4bやdeepseek-r1などのモデルでローカル環境の耐障害性を確保できます。ローカルでの性能とツールの信頼性は、選択したモデルとハードウェアによって異なります。
前提条件
Node.js 18以降。
手動インストール方法で使用するGit。
Claude Code CLI、Claude Desktop、または互換性のあるIDE統合。
WindowsではPowerShell、macOSとLinuxではシェル。
ローカルでのオフラインフォールバックを使用する場合のみOllama。
プロジェクト自体にPython環境や追加のNode.jsパッケージは必要ありません。
Infinite Claude Codeのインストール
方法1：Windowsのワンラインインストーラー
PowerShellを開き、リポジトリのインストーラーコマンドを実行します。
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/juanitogit/infinite-claude-code/main/install.ps1")))このコマンドはリモートスクリプトをダウンロードして直ちに実行するため、セキュリティポリシーで求められる場合は、先にinstall.ps1を確認してください。
方法2：Windowsへの手動インストール
git clone https://github.com/juanitogit/infinite-claude-code.git
cd infinite-claude-code
powershell -ExecutionPolicy Bypass -File .\install.ps1方法3：macOSまたはLinuxへのインストール
git clone https://github.com/juanitogit/infinite-claude-code.git
cd infinite-claude-code
chmod +x install.sh && ./install.shインストールモードの選択
対話式インストーラーには2つのモードがあります。
高速インストール：任意のプロバイダー認証情報を尋ねず、文書化されている事前設定済みの無料ティアを構成します。
カスタムインストール：追加のプロバイダー用APIキーを尋ねます。設定しないプロバイダーでは
Enterを押してスキップしてください。
ローカルルーターの確認
リポジトリのディレクトリから、サービスの状態を確認します。
node bin/infinite-claude.js status正常にインストールされていれば、Infinite Claude Codeがアクティブであること、ローカルURLがhttp://127.0.0.1:20129であること、SSEストリーミングが有効であること、プール内のアクティブなプロバイダーが一覧表示されます。
Infinite Claude Code は稼働中で正常です！
URL: http://127.0.0.1:20129
ストリーミング: 有効（SSE リアルタイム）
プール内のアクティブなプロバイダー: ...サービスが正常でない場合は、Node.js 18 以降が利用可能であること、また別のアプリケーションがポート 20129 を使用していないことを確認してください。
Claude Code を起動する
ルーターが稼働し、インストーラーによるクライアントの設定が完了したら、通常どおり Claude Code を起動します。
claudeその後、対話セッションでコーディングの依頼を入力できます。
このプロジェクトを調査し、アーキテクチャを説明して、安全に着手できる最初のリファクタリング作業を特定してください。依頼はローカルプロキシ経由でルーティングされ、回答は生成され次第ストリーミングされます。
直接タスクを試す
Claude Code には、ターミナルからプロンプトを直接渡すこともできます。
claude "認証モジュールをレビューし、リファクタリング計画を提案してください"これは、空の対話セッションから始める必要がない、集中的な作業に便利です。モデルの選択はコマンド自体ではなく、Infinite Claude Code のルーティングロジックによって処理されます。
Cyber HUD でリクエストを監視する
ルーターがアクティブな間に、次のローカルアドレスを開きます。
http://localhost:20129/hudHUD では、現在のセッションに関する次のライブテレメトリを確認できます。
各リクエストを処理しているプロバイダー。
生成されたトークン数。
リクエストのレイテンシ（ミリ秒）。
現在同時実行中のサブエージェント数。
Claude 3.7 Sonnet API の料金に基づく推定節約額。
このダッシュボードを使って、設定済みのプール全体にリクエストが分散されていることを確認し、レイテンシが異常に高いプロバイダーを見つけます。
プロバイダーと環境変数を設定する
src/providers.js でプロバイダー定義をカスタマイズするか、環境変数を通じて認証情報とエンドポイントを指定できます。README には次の変数が記載されています。
OPENROUTER_API_KEY: カスタム OpenRouter 認証情報。ドキュメントに記載されたデフォルトでは、事前設定済みの無料ティアを使用します。NVIDIA_API_KEY: カスタム NVIDIA NIM 認証情報。リポジトリには、デフォルトとして事前設定済みの NIM キーが記載されています。OMNIROUTER_API_KEY: カスタム OmniRouter 認証情報。ROUTER9_API_KEY: カスタム 9Router 認証情報。GROQ_API_KEY: オプションの Groq 認証情報。TOGETHER_API_KEY: オプションの Together AI 認証情報。OLLAMA_HOST: Ollama エンドポイント。デフォルトはhttp://localhost:11434です。PORT: ローカルプロキシのポート。デフォルトは20129です。
たとえば、macOS または Linux のシェルでは、起動前に別の Ollama ホストとポートをルーターに指定できます。
export OLLAMA_HOST="http://localhost:11434"
export PORT="20129"PowerShell での同等のセッション変数は次のとおりです。
$env:OLLAMA_HOST = "http://localhost:11434"
$env:PORT = "20129"個人用 API キーはソース管理の外で管理してください。シェルプロファイル、環境ファイル、または秘密情報を含む変更済みのプロバイダー設定をコミットしないでください。
ローカルフォールバックとして Ollama を設定する
Infinite Claude Code は、オフライン時または緊急時の経路として Ollama をサポートしています。README には、ローカルモデルの例として qwen3:4b と deepseek-r1 が記載されています。
Ollama を別途インストールして起動します。
使用するモデルを Ollama のインストール環境で利用可能にします。
OLLAMA_HOSTはhttp://localhost:11434のままにするか、カスタムエンドポイントに変更します。ステータスコマンドで Infinite Claude Code ルーターを再度確認します。
ローカルフォールバックは、特にインターネット障害時に便利です。ただし、モデルの速度、コンテキスト容量、コーディング品質は、使用するローカルモデルと利用可能な CPU、メモリ、GPU リソースによって異なります。
自律型サブエージェントを実行する
タスクの分解が有効な場合は、同時実行するサブエージェントを作成するよう Claude Code に明示的に依頼します。
claude "このタスクを分割し、同時実行するサブエージェントを並列に使って完全なプラットフォームを構築してください"ドキュメントに記載された --bg オプションを使って、バックグラウンドタスクを起動することもできます。
claude --bg "認証モジュールをリファクタリングし、ユニットテストを作成してください"このルーターは、同時に呼び出されたサブエージェントを別々のプロバイダーに分散するよう設計されています。タスクの実行中に HUD を確認し、負荷の分散状況とプロバイダーの選択を監視してください。
高度なヒント
プロバイダーの利用状況に合わせて同時実行数を調整する
このプロジェクトは広範な同時実行をサポートしていますが、外部プロバイダーには独自のレート制限や利用可能性に関する制約がある場合があります。大量のバックグラウンドジョブを起動する前に、HUD とアクティブなプロバイダー一覧を確認してください。
オプションのキーを使ってプールを拡張する
事前設定済みの経路が混雑している場合、Custom Install で Groq や Together AI などのプロバイダーを追加できます。設定済みのプールを広げると、フェイルオーバーシステムで利用できる経路が増えますが、各オプションサービスには個別の割り当て量と利用規約がある場合があります。
トラブルシューティング中にステータスコマンドを使う
Claude クライアント自体をデバッグする前に、node bin/infinite-claude.js status を実行してください。これにより、ローカルルーターの問題とモデルプロバイダーまたはクライアントの問題をすばやく切り分けられます。
必要に応じてポートを変更する
ポート 20129 が別のサービスと競合する場合は、PORT を別の値に設定してください。変更後は、Anthropic クライアントの設定が同じローカルエンドポイントを指していることを確認します。
プロバイダー設定を慎重に確認する
上級ユーザーは src/providers.js を変更してモデルをカスタマイズできます。想定されるプロバイダー形式を維持し、同時実行エージェントを開始する前に、簡単なリクエストで変更をテストしてください。
専有コードを保護する
クラウド経由のプロンプトには、ソースコード、ツールの出力、プロジェクトのコンテキストが含まれる場合があります。機密性の高いリポジトリでルーターを使用する前に、有効にするすべてのプロバイダーのプライバシーおよびデータ取り扱いポリシーを確認してください。作業をローカルにとどめる必要がある場合は、Ollamaルートを優先してください。
まとめ
Infinite Claude Codeは、Anthropicクライアントと、多数のクラウドまたはローカルモデルとの間をつなぐ、軽量な翻訳・ルーティングレイヤーです。インストーラーの実行後、サービスを確認して claude を起動し、HUDでストリーミング、フェイルオーバー、同時実行サブエージェントを監視してください。必要に応じて、任意のプロバイダーキーやOllamaを使い、モデルプールを拡張したり、ローカルでの耐障害性を追加したりできます。
このプロジェクトはJuaneXが保守しており、MITライセンスの下で配布されています。ソースコードとインストールスクリプトはInfinite Claude Codeリポジトリで入手できます。