ホームClaudeAlishahryar1/free-claude-code
Alishahryar1

free-claude-code

AI#Claude#LLM#Proxy#Python#API
GitHub で見る →
46

// 概要

Free Claude Code は Anthropic 互換のプロキシとして機能し、開発者が Claude Code CLI や IDE のトラフィックを様々な代替プロバイダーへルーティングできるようにします。NVIDIA NIM、OpenRouter、DeepSeek、および Ollama や llama.cpp を介したローカルモデルなど、複数のバックエンドをサポートしています。また、リモートコーディングセッションやボイスメモの文字起こし用に、Discord や Telegram ボットとの統合機能も備えています。

// 技術解説

Free Claude Code は、Claude Code CLI や IDE 拡張機能を公式の Anthropic API から切り離し、さまざまな代替プロバイダー経由でトラフィックをルーティングするように設計されたミドルウェアプロキシです。そのアーキテクチャは変換レイヤーとして機能し、リクエストを正規化することで NVIDIA NIM、OpenRouter、DeepSeek、および Ollama や llama.cpp といったローカルの LLM ランナーをサポートしつつ、Claude Code が期待するプロトコルとの互換性を維持します。このプロジェクトはベンダーロックインとコストの問題を解決し、開発者が無料、有料、またはローカルのモデルをシームレスに利用できるようにします。技術的なトレードオフとして、プロキシレイヤーへの依存があるため、環境変数の慎重な設定や、モデル固有のツール使用機能に対する潜在的な調整が必要となります。

// 主要ハイライト

01
NVIDIA NIM、OpenRouter、ローカルプロバイダーを含む 6 つの異なるバックエンドへ Anthropic API 呼び出しをルーティングするドロップインプロキシを提供します。
02
きめ細かなモデルルーティングをサポートしており、Opus、Sonnet、Haiku といった特定のモデル階層に異なるプロバイダーを割り当てることが可能です。
03
互換性のある /v1/models エンドポイントを公開することで、ネイティブな Claude Code のモデル選択機能を有効にします。
04
リモートコーディングセッションやタスク管理を容易にする、オプションの Discord および Telegram ボットラッパーが含まれています。
05
ローカルの Whisper または NVIDIA NIM バックエンドを使用した、オプションの音声メモ文字起こし機能を備えています。
06
ストリーミング、ツール使用、推論/思考ブロックといった複雑な機能を正規化し、異なる LLM プロバイダー間で一貫した動作を保証します。

// ユースケース

01
Claude Code のトラフィックを無料、有料、またはローカルの AI モデルプロバイダーへルーティングする
02
モデルごとのルーティングを管理し、特定のモデル階層に対して異なるプロバイダーを利用する
03
Discord や Telegram ボットのラッパーを介してリモートコーディングセッションを有効にする

// クイックスタート

まず Python 3.14 と uv パッケージマネージャーをインストールし、リポジトリをクローンしてから、提供されている .env.example テンプレートを使用して環境変数を初期化します。次に 'uv run uvicorn server:app --host 0.0.0.0 --port 8082' を実行してプロキシサーバーを起動します。最後に、ANTHROPIC_BASE_URL をローカルのプロキシサーバーのアドレスに設定し、ANTHROPIC_AUTH_TOKEN を指定することで、Claude Code CLI または IDE 拡張機能を構成します。