必要なもの
- キーページから 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に追加 |
| アップストリーム 401 | UPSTREAM_KEYが間違っているか空 | プロキシのシェルでキーを再エクスポートし、再起動 |
429とconcurrency | 8 件を超える同時リクエスト(トライアルでは 2 件) | 同時エージェントを減らす |
429とrate_limited | 1分あたり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%のボーナス付きでより大きなチャージを行っても、残高に期限が設けられることはありません。
