free-claude-code
CLI ツールAlishahryar1/free-claude-code
無料プロキシ。Claude Code を複数の AI プロバイダーに接続します。
概要
ローカルプロキシサーバー。Claude Code の API 呼び出しを NVIDIA NIM、OpenRouter、DeepSeek、Ollama などの無料またはローカルの AI プロバイダーにルーティングします。Anthropic のサブスクリプションなしで Claude Code を利用でき、ストリーミングレスポンス、ツール呼び出し、モデルルーティングをサポートしています。
README プレビュー
\n\n# 🤖 Free Claude Code\n\nUse Claude Code CLI, VS Code, JetBrains ACP, or chat bots through your own Anthropic-compatible proxy.\n\n[](https://opensource.org/licenses/MIT)\n[](https://www.python.org/downloads/)\n[](https://github.com/astral-sh/uv)\n[](https://github.com/Alishahryar1/free-claude-code/actions/workflows/tests.yml)\n[](https://pypi.org/project/ty/)\n[](https://github.com/astral-sh/ruff)\n[](https://github.com/Delgan/loguru)\n\nFree Claude Code routes Anthropic Messages API traffic from Claude Code to NVIDIA NIM, OpenRouter, DeepSeek, LM Studio, llama.cpp, or Ollama. It keeps Claude Code's client-side protocol stable while letting you choose free, paid, or local models.\n\n[Quick Start](#quick-start) · [Providers](#choose-a-provider) · [Clients](#connect-claude-code) · [Troubleshooting](#troubleshooting) · [Development](#development)\n\n\n\n\n \n\n\n## Star History\n\n\n \n \n \n \n \n \n \n\n\n## What You Get\n\n- Drop-in proxy for Claude Code's Anthropic API calls.\n- Six provider backends: NVIDIA NIM, OpenRouter, DeepSeek, LM Studio, llama.cpp, and Ollama.\n- Per-model routing: send Opus, Sonnet, Haiku, and fallback traffic to different providers.\n- Native Claude Code `/model` picker support through the proxy's `/v1/models` endpoint (Claude Code must opt in to Gateway model discovery; see [Model Picker](#model-picker)).\n- Streaming, tool use, reasoning/thinking block handling, and local request optimizations.\n- Optional Discord or Telegram bot wrapper for remote coding sessions.\n- Optional voice-note transcription through local Whisper or NVIDIA NIM.\n\n## Quick Start\n\n### 1. Install Requirements\n\nInstall [Claude Code](https://github.com/anthropics/claude-code), then install `uv` and Python 3.14.\n\nmacOS/Linux:\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\nuv self update\nuv python install 3.14\n```\n\nWindows PowerShell:\n\n```powershell\npowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/u
FAQ (4)
トラブル対応Claude Codeがシステムメッセージを送信する際のfree-claude-codeプロキシ422エラーの修正方法
api/models/anthropic.pyの95行目のMessageモデルを更新し、"system"ロールを許可する: role: Literal["user", "assistant", "system"]。編集後、プロキシを再起動してください。注意: これはローカルパッチであり、アップデート時に上書きされます。恒久的な修正には、ソースリポジトリを更新する必要があります。
トラブル対応Free Claude Code (FCC)ですべてのモデルが突然動作しなくなったのはなぜですか？また、どうすれば修正できますか？
これは FCC バージョン 6.16.15 に影響します。このバージョンは廃止された NVIDIA Super エンドポイントを依然として参照しているため、すべてのモデルリクエストが失敗します。再インストールや API キーのローテーションを行っても解決しません。修正方法: fcc-update を実行して 6.16.16 以降にアップグレードしてください。このバージョンでは NVIDIA Super の選択が新しい Ultra エンドポイントへ自動的に移行されます。その後 FCC を再起動してください。アップデート後も失敗する場合は、FCC の設定ページを開き、誤ったモデルマッピングを修正してください。
トラブル対応macOSでFree Claude Codeのメニューバー（トレイ）アイコンが表示されないのはなぜですか？また、どうすれば修正できますか？
これは ~/Applications/Free Claude Code.app から FCC を起動した場合の既知の問題です。バンドルの実行ファイルはシェルスクリプトで、バンドル外の Python インタプリタを exec するため、macOS はこのランチャーパターンに対してステータスアイテムを表示しません(LSUIElement やアドホックな codesign -s - に関係なく発生します)。サーバー自体は動作しており、http://localhost:8082/admin も利用できますが、Open Admin / Restart Server / Quit のトレイメニューが失われます。回避策:pkill -f fcc-desktop で実行中のインスタンスを終了してから、ターミナルで fcc-desktop を直接実行して FCC を起動してください。メニューバーアイコンが正常に表示されます。なお、.app を再度クリックしても何も起こりません。2 つ目のインスタンスが desktop.lock の保持を検出してサイレントに終了するためです。恒久的な修正には、コンパイル済みのランチャーバイナリか、独自の Python 実行ファイルを同梱/リンクしたバンドルが必要です。
トラブル対応Claude Codeで「There's an issue with the selected model. It may not exist or you may not have access to it」というエラーを修正する方法
このエラーは、選択したモデル（例：claude-opus-5）に対する Claude Code のリクエストがバックエンドによって拒否されることを意味します。サーバーログには POST /v1/messages?beta=true に対する 404 Not Found レスポンスが繰り返し記録されており、そのモデルに対応するルート/ハンドラーが存在しないことを示しています。回避策：Claude Code 内で /model を実行し、プロバイダーまたはプロキシが実際にサポートしているモデルに切り替えてから、プロンプトを再試行してください。FCC などのプロキシ経由で Claude Code をルーティングしている場合は、使用中の FCC バージョンが選択したモデルのエンドポイントを登録していることを確認し、設定変更後にサーバーを再起動してから、fcc doctor を実行してプロバイダー設定を確認してください。