自分の API キーで Claude Code を動かす
環境変数を二つ設定すれば、Claude Code が UplinkSwitch のキーで動きます。ツールもモデルも同じで、料金はライブ価格です。
確認日 2026-11-13
必要なもの
- Claude Code がインストール済みで、
claudeに PATH が通っていること。 - コンソールで作成した UplinkSwitch のキーと、チャージ済みの残高。クレジットは $10 からのプリペイドで、カード、WeChat Pay、Apple Pay、Google Pay、暗号資産で支払えます。
二つの変数
ANTHROPIC_BASE_URLは、Claude Code の接続先を UplinkSwitch にします。/v1を付けたまま貼り付けてください。ゲートウェイは、Claude Code がそこから組み立てるパスを受け付けます。ANTHROPIC_AUTH_TOKENは、キーをAuthorization: Bearerとして送ります。代わりにANTHROPIC_API_KEYも使え、こちらはキーをx-api-keyとして送ります。設定するのはどちらか一方だけです。- 異なる二つのキーを含むリクエストは、
400で拒否されます。 - base URL だけでは足りません。キーの変数のどちらかがないと、Claude Code は保存済みの claude.ai ログインを使い続けます。
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claudesettings.json に書いて固定する
両方の変数を ~/.claude/settings.json の env に追加すると、すべてのプロジェクトに適用されます。.claude/settings.local.json は、ひとつのプロジェクトにだけ適用されます。
- さらに三つの変数で、エイリアスが指すモデルを指定します。
ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODELです。claude-opus-5-5、claude-sonnet-5-5、claude-haiku-5-5のような ID を設定します。 - プロジェクトの
.claude/settings.jsonには、キーを書かないでください。このファイルは、コミットして共有するためのものです。 - シェルの export と設定ファイルが同じ変数を設定している場合は、設定ファイルが優先されます。
- VS Code 拡張機能は、VS Code のユーザー設定にある独自の設定
claudeCode.environmentVariablesから認証情報を読み込みます。
モデルを選ぶ
opus、sonnet、haiku のエイリアスは、三つのモデル変数が指定するモデルに解決されます。Haiku の変数を設定すると、セッションタイトルの生成などのバックグラウンド処理もそのモデルに移ります。セッション中は /model で、起動時は claude --model claude-opus-5-5 で、ひとつのセッションだけなら ANTHROPIC_MODEL で切り替えます。
Claude Code は Anthropic の API 形式で通信します。ここでは、GPT、Gemini、DeepSeek、Kimi、無検閲ビルドを含むすべてのチャットモデルを、この形式で提供しています。モデル一覧にあるチャットモデルの ID はどれも同じ変数で使え、ツール呼び出しも含めて Messages レスポンスとして返されます。
このキーでの Claude Code の費用
表は、Claude モデルの百万トークンあたりの料金をカタログからライブで取得し、Anthropic が公表している公式価格と並べています。このキーで使えるすべての Claude モデルは、Claude API の料金ページにあります。
Claude Code は、毎ターン会話全体を送信し、プロンプトキャッシュの対象としてマークします。キャッシュから読み出されたトークンは、入力料金の数分の一であるキャッシュ料金で課金されます。キャッシュの保持時間は既定で五分なので、それより長い中断のあとのターンでは、コンテキスト全体に一度だけ入力料金がかかります。
Claude Code が表示する費用は、Anthropic の公式価格をもとにした独自の見積もりです。実際に支払った額は、コンソールの「使用量」ページで確認できます。
| モデル | 入力 | キャッシュ入力 | 出力 | コンテキスト |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2Anthropic | $4.00公式価格 $8.00 | $0.10公式価格 $0.20 | $20.00公式価格 $40.00 | 1,000,000 |
| Claude Fable 5.1claude-fable-5.1Anthropic | $6.00公式価格 $10.00 | $2.00公式価格 $0.25 | $30.00公式価格 $50.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5Anthropic | $2.716公式価格 $4.00 | $0.1455公式価格 $0.20 | $9.70公式価格 $20.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5Anthropic | $1.20公式価格 $2.00 | $0.075公式価格 $0.10 | $3.00公式価格 $10.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5Anthropic | $0.0582公式価格 $0.10 | $0.01公式価格 $0.01 | $0.1455公式価格 $0.50 | 1,000,000 |
| Claude Fable 5claude-fable-5Anthropic | $3.00公式価格 $10.00 | $0.30公式価格 $1.00 | $15.00公式価格 $50.00 | 1,000,000 |
| Claude Opus 5claude-opus-5Anthropic | $1.80公式価格 $5.00 | $0.16公式価格 $0.50 | $7.50公式価格 $25.00 | 1,000,000 |
| Claude Sonnet 5claude-sonnet-5Anthropic | $1.20公式価格 $2.00 | $0.12公式価格 $0.20 | $3.00公式価格 $10.00 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8Anthropic | $1.80公式価格 $5.00 | $0.16公式価格 $0.50 | $7.50公式価格 $25.00 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7Anthropic | $1.80公式価格 $5.00 | $0.16公式価格 $0.50 | $7.50公式価格 $25.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6Anthropic | $1.80公式価格 $5.00 | $0.16公式価格 $0.50 | $7.50公式価格 $25.00 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6Anthropic | $1.80公式価格 $3.00 | $0.18公式価格 $0.30 | $9.00公式価格 $15.00 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5Anthropic | $0.60公式価格 $1.00 | $0.06公式価格 $0.10 | $3.00公式価格 $5.00 | 200,000 |
百万トークンあたりの米ドル価格
動作を確認する
小さなメッセージをひとつ送ります。-i を付けると、curl がレスポンスヘッダーを表示します。x-uplink-request-id はリクエストの ID、x-uplink-charge は米ドルでの費用です。
次に claude を実行します。リクエストは数秒以内にコンソールに表示されます。Claude Code の中で /status を実行すると、UplinkSwitch のアドレスが入った Anthropic base URL の行と、設定したキーの変数名を示す行が表示されます。base URL の行がない場合は、変数がセッションに届いていません。
curl -i https://api.uplinkswitch.com/v1/messages \
-H "Authorization: Bearer sk-uplink-live-..." \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-fable-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'エラーと対処
invalid_api_key(401): キーが間違っているか失効している、または Claude Code が読み込まなかった変数に入っています。/statusを確認してください。insufficient_balance(402): コンソールでチャージしてください。monthly_limit_reached(402) は、キーに設定した月間の利用上限に達したことを意味します。model_not_found(404): その ID はモデル一覧にありません。モデル変数に入力ミスがないか確認してください。- curl のテストは通るのに、Claude Code がログインを求める: キーをシェルの export か
~/.claude/settings.jsonに設定してください。プロジェクトの設定ファイルは、初回セットアップと信頼の確認が済んでから適用されます。 - 起動時の警告に認証情報のソースが二つ表示される: 保存済みのログインと変数の両方が有効になっています。
/logoutを実行して、キーだけを残してください。 ANTHROPIC_API_KEYを設定したのに無視される: 一度だけ承認が必要です。/configで Use custom API key をオンにするか、ANTHROPIC_AUTH_TOKENを使ってください。