JA ▾

ホームガイド

Claude Code用プロキシ設定

この Claude Code プロキシ設定は、キーの取得、LiteLLM 設定の作成、プロキシの起動、2 つの環境変数の設定、テスト実行の 5 つのステップで完了します。所要時間は約 10 分です。

ターミナルからサーバーへ向かう 5 つの光る足場を示す、ステップバイステップのプロキシ設定

主要ポイント

  1. https://api.claudecodeproxyapi.com/v1 にフォワードするローカル LiteLLM プロキシを実行
  2. ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN で Claude Code をプロキシにポイント
  3. Claude Code が送信するモデル名をアップストリームのモデル uncensored にマッピング
  4. CLI 起動前に curl でプロキシをテスト

必要なもの

  • キーページから API キーを取得します。Google またはメールアドレスとパスワードでサインアップし、ワンクリックで $0.50 のトライアルクレジットを取得します。
  • プロキシをインストールするための Python 3.9 以降。
  • お使いのマシンに Claude Code がインストールされ、動作していること。

なぜプロキシが必要なのか? Claude Code は Anthropic Messages フォーマットを使用し、当社の API はモデル ID uncensored の OpenAI Chat Completions フォーマットを使用します。プロキシはこれらを変換します。背景知識が必要な場合は、プロキシトラブルシューティングガイドをお読みください。このモデルは Claude ではないオープンウェイトモデルであるため、複雑なマルチステップタスクでは異なる動作を期待してください。

ステップ 1: プロキシをインストール

プロキシの依存関係がプロジェクトと分離されるよう、仮想環境を使用してください。

python3 -m venv ~/litellm-env
source ~/litellm-env/bin/activate
pip install 'litellm[proxy]'

LiteLLM はサードパーティのオープンソースソフトウェアです。以下のコマンドと設定キーは執筆時の LiteLLM 公式ドキュメントに準拠していますが、フラグが変更された場合は最新のドキュメントを確認してください。

ステップ 2: 設定ファイルを作成

config.yaml を作成します。model_name はクライアントが送信する名前です。litellm_params ブロックはフォワード先を示します。openai/ プレフィックスは LiteLLM に OpenAI 互換サーバーとの通信を指示します。

cat > config.yaml <<'EOF'
model_list:
  - model_name: claude-sonnet
    litellm_params:
      model: openai/uncensored
      api_base: https://api.claudecodeproxyapi.com/v1
      api_key: os.environ/UPSTREAM_KEY
EOF

エイリアス claude-sonnet は例示であり必須ではありません。Claude Code は複数の異なるモデル名(メインモデルやバックグラウンドタスク用の小モデルなど)を送信する場合があります。プロキシログに表示される名前ごとに model_list エントリを追加し、すべて同じアップストリームをポイントしてください。モデルは 1 つだけなので、すべてのエイリアスを uncensored にポイントしても問題ありません。

キーは環境変数から読み取られるため、コミットされる可能性のあるファイルに保存されません。

ステップ 3: プロキシを起動

export UPSTREAM_KEY="YOUR_KEY"
litellm --config config.yaml --port 4000

このターミナルを開いたままにしてください。ポート 4000 でサーバーがリッスンしていることが表示されるはずです。次に、Claude Code が送信する Anthropic フォーマットのテストリクエストで、プロキシ側からアップストリームパスを確認します。

curl http://localhost:4000/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: sk-local-anything" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet",
    "max_tokens": 200,
    "messages": [{"role": "user", "content": "Reply with the word ready."}]
  }'

コンテンツに「ready」という単語を含む JSON 応答は、Anthropic フォーマットから OpenAI フォーマットへの https://api.claudecodeproxyapi.com/v1 への変換がエンドツーエンドで機能していることを意味します。LiteLLM 設定でマスターキーを設定している場合は、sk-local-anything の代わりにそれを使用してください。

ステップ 4: Claude Code をプロキシにポイント

Claude Code は API アドレスとトークンを環境変数から読み取ります。CLI を起動するシェルでこれらを設定します。

export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="sk-local-anything"
export ANTHROPIC_MODEL="claude-sonnet"
claude

CLIがパスを追加するため、プロキシのアドレスには/v1サフィックスなしで指定します。トークンはプロキシのみで有効で、実際のアップストリームキーはUPSTREAM_KEYとしてエクスポートしたものです。環境変数に設定ファイルを使う場合は、同じ3つの名前をそこに記述します。Claude Codeの環境変数名はリリース間で変更されるため、無視される場合は現在のClaude Codeドキュメントで確認してください。

ステップ 5: 最初のタスクを実行しログを確認

小さく始めます。CLIにファイルの説明や関数へのコメント追加を依頼します。プロキシターミナルにはステップごとのリクエストが表示されます。現れるモデル名をすべて記録し、model_listにない場合はエラーになるので、追加して再起動します。

CLIはツールを通じてファイルの読み込みやコードの編集を行うため、ツール呼び出しが重要です。APIはtools、tool_choice、ストリーミング形式のtool_callsをサポートしており、プロキシはそれらを変換します。ツールスキーマへの準拠が不十分だと、編集の失敗やステップの繰り返しとして現れます。その場合は、セットアップが壊れていると判断する前にタスクを短くして再試行してください。

コンテキストウィンドウは100,000トークンで、プロンプトと補完を合計した値です。それを超えるとセッションは失敗するため、新しいタスクには新しいセッションを開始してください。コストは極めて低く、入力トークン100万トークンあたり$0.15、出力トークン100万トークンあたり$0.50です。20,000トークンの入力と800トークンの出力の場合、$0.003 + $0.0004 = $0.0034となります。チャージについては価格ページをご覧ください。このサイトでは暗号資産(TRC20上のUSDT、Base上のUSDC)での支払いとなります。

トラブルシューティング

表示される内容原因修正方法
接続拒否プロキシが実行中ではないか、ポートが異なる起動し、ANTHROPIC_BASE_URLのポートに合わせます
プロキシ 404 または「モデルが見つからない」CLI が送信したモデル名が設定にないその名前をmodel_listに追加
アップストリーム 401UPSTREAM_KEYが間違っているか空プロキシのシェルでキーを再エクスポートし、再起動
429とconcurrency8 件を超える同時リクエスト(トライアルでは 2 件)同時エージェントを減らす
429とrate_limited1分あたり300リクエストを超える(トライアルは60)バックオフして再試行してください。
429 と Retry-After: 5一時的な過負荷5秒後に再試行する
ストリームの停止ストリーミングされたリクエストは終了するまでスロットを保持するCLI でキャンセルしてスロットを解放

ここでカバーされていない事項については、サポートに連絡する際にX-Request-Idレスポンスヘッダーを含めてください。ドキュメントにはサポートされているパラメータがすべて記載されています。

恒久的に設定

毎回エクスポートを入力するのは面倒です。プロキシの起動を小さなスクリプトに、クライアント変数をエイリアスに設定し、1 つのコマンドで全てを起動できるようにします。

cat > ~/start-proxy.sh <<'EOF'
. ~/litellm-env/bin/activate
export UPSTREAM_KEY="YOUR_KEY"
exec litellm --config ~/config.yaml --port 4000
EOF
chmod +x ~/start-proxy.sh

alias claude-uncensored='ANTHROPIC_BASE_URL=http://localhost:4000 ANTHROPIC_AUTH_TOKEN=sk-local-anything ANTHROPIC_MODEL=claude-sonnet claude'

変数はそのコマンドのみに対して設定されるため、通常のclaudeコマンドはデフォルト設定で動作し続けます。エイリアスをシェルプロファイルに追加してください。キーを含むため、chmod 700などのファイル権限でスクリプトを保護してください。

元に戻す

現在のシェルで変数をエクスポートした場合は、unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODELを実行し、CLIを再起動してください。API側では何も変更されていないため、元に戻す必要はありません。

残高と使用状況の監視

APIからのすべてのレスポンスには、X-Balance-USDヘッダーが含まれており、これはAPIキーに残っているクレジット額を示します。LiteLLMでは一部の構成でアップストリームのヘッダーを転送できますが、残高を確認する最も確実な方法は、アップストリームに直接定期的にアクセスすることです:

curl -i https://api.claudecodeproxyapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY" | grep -i x-balance-usd

エージェントセッションは静かに成長します。各ステップで作業中のコンテキストが再送信されるため、長時間のセッションは短いセッションよりもリクエストあたりのコストが高くなります。タスクごとに新しいセッションを開始すると、入力サイズが小さくなり、請求額も抑えられます。公開価格(入力100万トークンあたり$0.15、出力100万トークンあたり$0.50)では、50,000トークンの入力と1,000トークンの出力を持つリクエストのコストは、50,000 x $0.15 / 1M = $0.0075 に $0.0005 を加えたもので、合計$0.008となります。このようなリクエストが20件あると、合計$0.16になります。

チャージは$20から$500の整数額で、このサイトでは暗号通貨(TRC20上のUSDTまたはBase上のUSDC)で支払われます。クレジットは期限切れにならないため、+5%、+10%、または+15%のボーナス付きでより大きなチャージを行っても、残高に期限が設けられることはありません。

質問と回答

Claude Codeのプロキシにはどの環境変数が必要ですか?

プロキシのアドレスには ANTHROPIC_BASE_URL を、プロキシが受け付けるトークンには ANTHROPIC_AUTH_TOKEN を使用します。ANTHROPIC_MODEL には定義したエイリアスを指定できます。変更点については最新の Claude Code ドキュメントを確認してください。

ANTHROPIC_BASE_URL に /v1 を付けますか?

いいえ。CLIアプリが自身のパスを付加するため、プロキシアドレス(例:http://localhost:4000)を使用してください。/v1 はプロキシ設定内のアップストリーム api_base のみに付加します。

LiteLLM以外のプロキシを使用できますか?

はい。Anthropic MessagesリクエストをOpenAI Chat Completionsに変換するプロキシであれば、claude-code-routerなどの他のプロキシでも動作します。モデルを uncensored に設定し、アップストリームを https://api.claudecodeproxyapi.com/v1 にポイントしてください。

アップストリームのキーは設定ファイル内で安全ですか?

上記の設定ファイルにキーを直接書き込むのではなく、環境変数に格納してください。キーをリポジトリにコミットしないでください。

キーはフォーム 1 つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。