自分の 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 ログインを使い続けます。
shell
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claude

settings.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.001,000,000
Claude Fable 5.1claude-fable-5.1Anthropic$6.00公式価格 $10.00$2.00公式価格 $0.25$30.00公式価格 $50.001,000,000
Claude Opus 5.5claude-opus-5-5Anthropic$2.716公式価格 $4.00$0.1455公式価格 $0.20$9.70公式価格 $20.001,000,000
Claude Sonnet 5.5claude-sonnet-5-5Anthropic$1.20公式価格 $2.00$0.075公式価格 $0.10$3.00公式価格 $10.001,000,000
Claude Haiku 5.5claude-haiku-5-5Anthropic$0.0582公式価格 $0.10$0.01公式価格 $0.01$0.1455公式価格 $0.501,000,000
Claude Fable 5claude-fable-5Anthropic$3.00公式価格 $10.00$0.30公式価格 $1.00$15.00公式価格 $50.001,000,000
Claude Opus 5claude-opus-5Anthropic$1.80公式価格 $5.00$0.16公式価格 $0.50$7.50公式価格 $25.001,000,000
Claude Sonnet 5claude-sonnet-5Anthropic$1.20公式価格 $2.00$0.12公式価格 $0.20$3.00公式価格 $10.001,000,000
Claude Opus 4.8claude-opus-4-8Anthropic$1.80公式価格 $5.00$0.16公式価格 $0.50$7.50公式価格 $25.001,000,000
Claude Opus 4.7claude-opus-4-7Anthropic$1.80公式価格 $5.00$0.16公式価格 $0.50$7.50公式価格 $25.001,000,000
Claude Opus 4.6claude-opus-4-6Anthropic$1.80公式価格 $5.00$0.16公式価格 $0.50$7.50公式価格 $25.001,000,000
Claude Sonnet 4.6claude-sonnet-4-6Anthropic$1.80公式価格 $3.00$0.18公式価格 $0.30$9.00公式価格 $15.001,000,000
Claude Haiku 4.5claude-haiku-4-5Anthropic$0.60公式価格 $1.00$0.06公式価格 $0.10$3.00公式価格 $5.00200,000

百万トークンあたりの米ドル価格

動作を確認する

小さなメッセージをひとつ送ります。-i を付けると、curl がレスポンスヘッダーを表示します。x-uplink-request-id はリクエストの ID、x-uplink-charge は米ドルでの費用です。

次に claude を実行します。リクエストは数秒以内にコンソールに表示されます。Claude Code の中で /status を実行すると、UplinkSwitch のアドレスが入った Anthropic base URL の行と、設定したキーの変数名を示す行が表示されます。base URL の行がない場合は、変数がセッションに届いていません。

curl
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 を使ってください。

よくある質問

はい。ここではすべてのチャットモデルを Anthropic 形式で提供しているので、GPT、Gemini、DeepSeek、無検閲モデルの ID をモデル変数に設定でき、ツール呼び出しも含めて Messages レスポンスとして返されます。

はい。キャッシュ入力はキャッシュ料金で課金されます。リクエストの記録でキャッシュ読み取りトークン数がゼロより大きければ、キャッシュが効いています。

Remote Control と音声入力は claude.ai ログインが必要なので、キーの変数を設定している間は使えません。MCP ツール検索は Anthropic 以外のホストではオフになり、ENABLE_TOOL_SEARCH=true を設定するとオンになります。

ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を unset し、settings.json に書いた場合はそこからも削除します。

コンソールの「使用量」ページに、支払った額が表示されます。リクエスト単位では、リクエスト ID で検索します。記録には入力トークン、キャッシュ読み取りトークン、出力トークン、米ドルでの請求額が載り、一分ほどでログに反映されます。

クレジットはコンソールで $10 からプリペイドし、カード、WeChat Pay、Apple Pay、Google Pay、暗号資産で支払えます。サブスクリプションはありません。チャージするたびに、料金が 30 日間ロックされます。

Claude Code 用のキーを取得する

変数は二つ。$10 からのプリペイド、サブスクリプションなしで、チャージのたびに料金を 30 日間ロックします。

キーを取得
Join on Telegram