free-claude-code — 多様なコーディングエージェントを各種LLMへ中継するプロキシツール

AI/MLLLMPythonCLIDeveloper ToolsAI Agent

Alishahryar1/free-claude-code

★ 69,334 ・ Python

GitHub →

概要

free-claude-code（FCC）は、Claude CodeやCodex、Cline、Aiderといった各種AIコーディングエージェント（ハーネス）からのリクエストを、多数の外部LLMプロバイダーへ柔軟にルーティングするためのローカルプロキシサーバーおよび管理ツールです。Pythonを中心に構築されています。

Anthropicが提供するClaude Codeなどの公式ツールは、通常特定のAPIやモデルとの連携を前提としていますが、本プロジェクトを介することで、OpenAI互換のエンドポイントやサードパーティのAPIプロバイダー、無料枠が提供されている各種推論サービスなどと組み合わせて動かすことが可能になります。

特定のプロバイダーのAPIキーや無料枠を有効活用したい開発者や、障害時のフォールバック先を確保して作業の中断を防ぎたいエンジニア、ターミナルだけでなくIDEやチャットアプリ、Webブラウザなど複数の環境から同じエージェント環境を利用したい人に向いています。なお、本プロジェクトはAnthropicなどの公式プロジェクトではなく、独立したコミュニティによるオープンソースソフトウェアとして公開されています。

主な特徴

  • 12種類のコーディングエージェントに対応 Claude Code、Codex、Pi、OpenCode、Cline、Hermes、DeepSeek Harness、Grok Build、Muse Code、Aider、Antigravity CLI、VS Code Chatに対応しており、各エージェントのストリーミング出力やツール実行（tool use）、思考プロセスの表示（interleaved thinking）などの挙動を維持したまま中継します。

  • 61以上のプロバイダーと接続可能 NVIDIA NIM、OpenRouter、Groq、OpenAI、GitHub Copilot、Anthropic、Google AI Studio（Gemini）、各種クラウドベンダーなど、無料枠や定額サブスクリプション、ローカル環境を含む幅広いプロバイダーをサポートしています。

  • 多様なクライアントインターフェース ターミナルでのCLI実行に加え、デスクトップアプリ（Codex AppやClaude Desktop等）、IDE拡張機能（VS Code、JetBrains）、電話・チャット連携（Discord、Telegram）、さらにはWebブラウザのUIセッション経由での利用が可能です。チャット連携では音声メモの処理にも対応しています。

  • トークン最適化機能の統合 RTKおよびHeadroomとの連携により、対応エージェントにおけるプロンプトやコンテキストの最適化を行い、トークン消費量を抑える仕組みが用意されています。

  • 安定稼働のためのフォールバックと制御 プロバイダーの障害時やレートリミット到達時に備え、自動リトライ、レートリミット制御、同時実行数の制限、複数APIキーの自動ローテーション、モデルおよびプロバイダー単位のフォールバック機能が実装されています。

使い方

1. インストール

READMEでは、プラットフォームに応じたインストールスクリプトが提供されています。

macOSまたはLinuxの場合:

curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh

Windows（PowerShell）の場合:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))

対話プロンプトが表示されたら、利用するコーディングエージェントを選択します。必要に応じてRTKとHeadroomによるトークン最適化の有効化も指定できます。

2. サーバーの起動

WindowsやmacOSでは、スタートメニューやアプリケーションフォルダから「Free Claude Code」を起動します。Linux環境ではターミナルから以下のコマンドを実行します。

fcc-server

起動後、管理用のWeb UI（Admin UI）が開きます。Linuxで fcc-server を実行している間は、そのターミナルを開いたまま保持する必要があります。

3. プロバイダーとモデルの設定（例: NVIDIA NIM）

  1. NVIDIAのサイト（build.nvidia.com）でAPIキーを発行します。
  2. サーバー起動ログに表示されたURLからAdmin UIを開きます。
  3. Providers メニューから「NVIDIA NIM」を選択し、Add key をクリックしてAPIキーを保存します。
  4. デフォルトモデルのままにするか、ドロップダウンから目的のモデルを選択します。
  5. Apply をクリックして設定を反映します。

ローカルプロキシをトークンで保護したい場合は、Admin UIで「Proxy Authentication」を有効にします。

4. エージェントの実行

セットアップ完了後、各エージェント専用のラッパーコマンドを用いて起動できます。

Claude Codeを起動する場合:

fcc-claude

Codexを起動する場合:

fcc-codex

Aiderを起動する場合:

fcc-aider

その他のツールやChat Completions対応クライアントからは、FCCのサーバーURL（デフォルトは http://127.0.0.1:8082/v1）をOpenAI互換のBase URLとして指定することで接続できます。

技術的なポイント

  • Pythonベースのローカル中継サーバー FCCはPythonで実装されており、各コーディングツールの通信仕様を吸収しながら、上流の各種LLM APIが要求するフォーマット（OpenAI Chat Completions仕様や各種ベンダー独自仕様）へと相互変換するプロキシレイヤーとして動作します。

  • OpenAI互換エンドポイントの提供 デフォルトでポート 8082 上で /v1 エンドポイントを提供し、ストリーミングレスポンスとJSONレスポンスの双方に対応しています。これにより、既存のOpenAI互換クライアント全般から透過的に接続できる設計になっています。

  • 堅牢性を意識したリトライ・フォールバック設計 単一のモデルやプロバイダーがダウンした場合でも、あらかじめ優先順位を設定した「Fallback Models」リストに従い、順次別のプロバイダーへリクエストを転送します。APIキーも複数登録して順序変更が可能になっており、レート制限やクォータ超過による作業中断を回避する工夫が見られます。

注意点

  • ライセンスについて リポジトリのメタデータおよびREADME抜粋において、適用されているオープンソースライセンスの種類（MIT、Apache 2.0等）は明記されていません。利用や再配布にあたってはリポジトリ全体の最新のライセンスファイルを確認する必要があります。

  • 無料枠および利用規約の変動 各プロバイダーが提供する無料枠の有無や制限値、APIの利用規約（TOS）はプロバイダー側の都合で変更される可能性があります。READMEにも「無料枠の利用可否と制限は各プロバイダーに依存し、変動する」旨が記載されています。

  • 公式サービスとの非提携 READMEの冒頭にある通り、本プロジェクトはAnthropicやその他のモデル提供企業とは提携しておらず、公式に承認されたものではありません。各ツールの利用規約を遵守した上で、個人の責任において設定・運用することが求められます。

まとめ

free-claude-codeは、Claude CodeやCodexをはじめとする多数のコーディングエージェントを、多種多様なLLMプロバイダーへ接続可能にするプロキシツールです。柔軟なフォールバック機能やトークン最適化、複数UIサポートを備えており、各種AI支援ツールのバックエンドを自由に切り替えながら開発環境を整えたい方にとって有用な選択肢となります。

関連記事