Claude Code を API キーの従量課金で動かす
Claude Code は環境変数 2 つで接続先を切り替えられます。ANTHROPIC_BASE_URL を https://api.relayswitch.io/v1 に、ANTHROPIC_AUTH_TOKEN を RelaySwitch のキーにすると、以降の各ターンは前払い残高からトークン単位で課金されます。claude.ai のサブスクリプションは必要ありません。
01サブスクリプションと API キー、2 つの使い方
Claude Code には 2 通りの認証があります。claude.ai のアカウントでログインしてサブスクリプションの枠を使う方法と、API キーを渡してトークン単位で支払う方法です。同じマシンに両方を置けますが、1 つのセッションが使うのはどちらか一方です。
このページは後者の設定です。Claude Code は Anthropic の Messages 形式で通信し、接続先を ANTHROPIC_BASE_URL から読み取ります。ここを RelaySwitch に向けても、使うツールとモデル ID は変わりません。変わるのは請求先だけで、各ターンは料金ページの単価で前払い残高から引き落とされます。
02環境変数 2 つを設定する（macOS / Linux）
まず現在のターミナルで一時的に設定し、動作を確認してから設定ファイルに書くのが確実です。キーはコンソールで発行した sk-relay- で始まるものを使います。
ANTHROPIC_AUTH_TOKEN はキーを Authorization: Bearer として送ります。ANTHROPIC_API_KEY でも動きますが、設定するのはどちらか片方だけにしてください。値の異なる 2 つのキーが付いたリクエストは 400 で拒否されます。Base URL だけを設定してキーを設定しないと、Claude Code は保存済みの claude.ai ログインを使い続けます。
export ANTHROPIC_BASE_URL="https://api.relayswitch.io/v1"export ANTHROPIC_AUTH_TOKEN="sk-relay-..."claude03Windows（PowerShell）の場合
Windows では PowerShell で同じ 2 つの変数を設定します。変数名と値は macOS / Linux と同じです。ターミナルで設定した変数は、そのウィンドウの中でだけ有効です。
$env:ANTHROPIC_BASE_URL = "https://api.relayswitch.io/v1"$env:ANTHROPIC_AUTH_TOKEN = "sk-relay-..."claude04settings.json に書いて常に有効にする
すべてのプロジェクト、すべての起動方法で有効にするには、ユーザー設定の ~/.claude/settings.json（Windows は %USERPROFILE%\.claude\settings.json）の env ブロックに同じ 2 つの変数を書きます。同じ変数がシェルと設定ファイルの両方にある場合は、設定ファイルが優先されます。
- キーをプロジェクト直下の
.claude/settings.jsonに書かないでください。このファイルはコードと一緒にコミットして共有する前提のものです。 - VS Code 拡張は、独自の設定項目
claudeCode.environmentVariablesから認証情報を読みます。VS Code のユーザー設定に同じ 2 つの変数を登録してください。 - デスクトップアプリは、この 2 つの環境変数も
settings.jsonも読みません。このページの対象は CLI と VS Code 拡張です。
05接続を確認する
Claude Code を通さずに、ゲートウェイへ最小のリクエストを直接送ります。200 と JSON が返れば、Base URL とキーは正しく設定されています。
次に claude を起動して 1 回発言し、/status を実行します。Anthropic base URL の行に RelaySwitch のアドレスが、Auth token の行に ANTHROPIC_AUTH_TOKEN が表示されていれば、リクエストはこのキーで送られています。Base URL の行がなければ、変数がそのプロセスに渡っていません。送ったリクエストは数秒でコンソールの利用履歴に表示され、1 件ごとにモデル ID、課金トークン数、料金を確認できます。
curl -i https://api.relayswitch.io/v1/messages \ -H "Authorization: Bearer sk-relay-..." \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model": "claude-fable-5.1", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'06Claude モデルの料金と選び方
Claude Code から呼び出せる Claude モデルは現在 13 個です。このセクションの表は、カタログから読み込んだ現在の単価です。
セッション内では /model で opus、sonnet、haiku のエイリアスを切り替えます。各エイリアスが指す ID は ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL の 3 つの環境変数で決まり、表にある ID を指定できます。
Claude Code は毎ターン会話全体を送信し、プロンプトキャッシュの対象として印を付けます。キャッシュから読まれたトークンは、入力単価より低いキャッシュ単価で課金されます。Claude Code の画面に出るコストは Anthropic の定価にもとづく独自の見積もりで、実際に支払った額はコンソールの利用履歴で確認できます。
| モデル | 開発元 | 入力 | 出力 | コンテキスト |
|---|---|---|---|---|
| Claude Fable 5.1claude-fable-5.1 | Anthropic | $6.00 | $30.00 | 1,000,000 |
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Fable 5claude-fable-5 | Anthropic | $3.00 | $15.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6 | Anthropic | $1.80 | $9.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 5claude-opus-5 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5 | Anthropic | $0.60 | $3.00 | 200,000 |
| Claude Sonnet 5claude-sonnet-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5 | Anthropic | $0.0582 | $0.1455 | 1,000,000 |
米ドル / 100 万トークン
07Claude Code 専用のキーに予算を付ける
コーディングエージェントは自分で何ターンもリクエストを送り続けるため、問題が起きると消費が速くなります。コンソールで Claude Code 専用のキーを作り、米ドルの予算を設定しておくと、上限に達した時点でそのキーだけが 402 を返して止まり、アカウントの残りの残高には影響しません。モデルの許可リストを付ければ、選んだ Claude の ID だけを呼べるキーになります。
よくある質問
- API キーで使う場合、claude.ai のアカウントやサブスクリプションは必要ですか？
- 必要ありません。ANTHROPIC_AUTH_TOKEN を設定すると、リクエストにはこの認証情報が付き、claude.ai のログインは送られません。アカウントは RelaySwitch 側にあり、メールアドレスで開設できます。
- ANTHROPIC_AUTH_TOKEN と ANTHROPIC_API_KEY のどちらを使えばよいですか？
- ANTHROPIC_AUTH_TOKEN を使ってください。Authorization: Bearer として送られ、設定後すぐに有効になります。ANTHROPIC_API_KEY は x-api-key として送られ、対話モードでは最初に一度承認が必要です。設定するのは片方だけにします。
- ANTHROPIC_BASE_URL に /v1 は付けますか？
- 付けても付けなくても動きます。このサイトの例は https://api.relayswitch.io/v1 に統一しています。Claude Code はアドレスの後ろに /v1/messages を足しますが、重複する /v1 はゲートウェイ側で吸収します。
- 環境変数を設定したのに、ログインを求められます。
- 変数がそのプロセスに届いていません。Dock やスタートメニューから起動したエディタは、ターミナルで export した変数を読めません。2 つの変数を ~/.claude/settings.json の env ブロックに書き、/status に Anthropic base URL の行が出るか確認してください。
- Claude 以外のモデルも Claude Code から使えますか？
- GPT、Gemini、DeepSeek の ID も応答します。ゲートウェイが Messages 形式のリクエストをそのモデルの OpenAI 形式に変換し、thinking と cache_control のフィールドは取り除かれます。ただし Anthropic は Claude 以外のモデルでの Claude Code をサポートしていないため、ツール呼び出しは Claude の ID ほど安定しないことがあります。
- エラーが返ってきたときは、何を確認すればよいですか？
- ステータスコードで切り分けます。401 はキーの誤りまたは失効、402 は残高かキーの予算、403 はキーの許可リスト、429 はレート制限です。429、502、503 のリクエストは課金されません。