Claude CodeでAPI中継サービスのベースURLを設定する方法

最小構成

Claude Codeを中継サービスに接続する前に、そのサービスがAnthropic互換APIを提供しているか確認してください。一般的な設定は次のとおりです。

export ANTHROPIC_BASE_URL="https://your-proxy.example"
export ANTHROPIC_AUTH_TOKEN="your proxy API key"
claude

ANTHROPIC_BASE_URLは、リクエストの送信先を中継サービスまたはゲートウェイに変更します。ANTHROPIC_AUTH_TOKENはBearerトークンとして送信されます。

Claude Codeを設定する前にサービスを比較する場合は、Anthropic互換、OpenAI互換、マルチモデル対応のサービスをまとめたAI API中継サービス一覧を利用できます。

APIキーを使用する設定

サービスからAnthropic形式のAPIキーが発行された場合は、次の設定を求められることがあります。

export ANTHROPIC_API_KEY="sk-..."
claude

注意：ANTHROPIC_API_KEYを設定すると、Claude CodeはClaude Pro、Max、Teamサブスクリプションのログインに含まれる利用枠ではなく、そのAPIキーを使用します。中継サービスをテストするときは新しいターミナルを開き、そのウィンドウ内だけで環境変数を設定してください。

よくあるエラー

• 401：キーが間違っている、認証ヘッダーの種類が違う、またはサービスがANTHROPIC_API_KEYではなくANTHROPIC_AUTH_TOKENを要求しています。
• 404：ベースURLのパスが間違っています。サービスが/v1を必要とするかどうかを特に確認してください。
• model not found：指定したモデル名をサービスが提供していないか、カスタムモデルの設定が必要です。
• MCP検索の問題：公式以外のベースURLを使用すると、Claude CodeのMCPツール検索の動作が変わる場合があります。必要な機能がサービス側で完全に転送されるか確認してください。

推奨手順

設定のない新しいターミナルと一時的な環境変数から始めてください。動作を確認してから、シェルプロファイル、プロジェクトスクリプト、切り替えツールに設定を移します。最初からグローバル設定を変更すると、問題がアカウント、環境変数、サービス側APIのどこにあるのか切り分けにくくなります。