Claude CodeのAPIキー。小さな物理的な鍵がターミナル形の錠に差し込まれ、その隣に整然とした設定パネルと短いケーブルがあります。

Claude CodeのAPIキー — ANTHROPIC_API_KEY：取得方法、設定方法、代わりにclaude setup-tokenを使うべき場合

Claude Codeの動作にはAPIキーが必要です。Claude Codeを初めて設定する場合でも、Anthropicの直接契約アカウントから定額制ゲートウェイに移行する場合でも、キーの生成、環境変数の設定、接続の確認が必要です。設定する環境変数は二つです。

Claude Code APIキー：要点

Claude Code APIキーは、通常のAnthropic形式のキー（sk-...）で、Claude Codeは次の環境変数から読み取ります： ANTHROPIC_API_KEY。Claude Console（設定 → APIキー。表示は一度のみ）またはこのゲートウェイのダッシュボード（いつでも表示可能）でキーを取得し、exportすると、Claude Codeはブラウザーでのログインなしで起動します。ゲートウェイキーを使う場合は、次の変数も設定します： ANTHROPIC_BASE_URL 。値にはゲートウェイのホストを指定します。設定はこれで完了です。このページの残りでは、APIキー、次のコマンドで取得するOAuthトークン /login 、およびclaude.aiのセッションキーの違い、OS別の手順、よく遭遇するエラーを詳しく説明します。

Claude Code APIキーとは

Claude Code APIキーは、Claude Code CLIがClaudeモデルのプロバイダーにリクエストを送信するための認証情報です。キーがないと、Claude Codeで実行するすべてのコマンドで認証エラーが返されます。キーは環境変数に保存する文字列で、ANTHROPIC_API_KEY（x-api-keyヘッダーとして送信）またはANTHROPIC_AUTH_TOKEN（Bearerトークンとして送信）のいずれかを使用します。どちらもAI Prime Techで利用できます。

Anthropicを直接利用する代わりにAI Prime Techのようなゲートウェイを使う場合、キーはAnthropic Consoleではなくゲートウェイのダッシュボードで取得します。キーの形式は異なる場合がありますが、Claude Codeでの設定手順は同じです。環境変数にキーを設定し、ベースURLをゲートウェイに向ければ、残りはClaude Codeが処理します。キーはAnthropicの請求ではなく、ゲートウェイアカウントの残高またはサブスクリプションに紐づきます。

同じキーを複数のマシンやClaude Codeセッションで同時に使用できます。ただし、チームでキーを共有すると、すべての使用量が同じアカウントのレート制限と残高に計上されます。チームで設定する場合は、ダッシュボードから開発者ごとに個別のキーを生成し、各ユーザーの使用量追跡とレート制限が正しく機能するようにしてください。

APIキーとOAuthトークンの違い、および「セッションキー」とは

Claude Codeは二種類の認証情報に対応しています。APIキー（ANTHROPIC_API_KEY、またはBearerトークンとして送信するANTHROPIC_AUTH_TOKEN）では、トークンごとにAPI残高から料金が差し引かれます。ゲートウェイで使用するのはこちらです。OAuthトークンはClaude ProまたはMaxのサブスクリプションから取得します： /login をClaude Code内で実行するとログインでき、 claude setup-token を実行すると有効期間の長いトークンが発行されます。このトークンをCIやヘッドレスマシンに設定すると、API残高ではなくサブスクリプションを利用できます。

「Claudeセッションキー」は、そのどちらでもありません。claude.aiのブラウザーセッションCookieであり、一部の非公式クライアントがチャットインターフェースを操作するために抽出しています。API認証情報ではなく、その利用は一般ユーザー向けの利用規約に違反します。有効期限があり、アカウントが停止される可能性もあります。プログラムからアクセスしたい場合は、Anthropicのコンソールまたはこのようなゲートウェイで取得したAPIキーを使用してください。

ステップ1 — キーの取得：Claude Consoleまたはゲートウェイのダッシュボード

Claude Codeで使えるキーは、二つの場所で発行できます。Claude Console（platform.claude.comにあるClaudeプラットフォーム）で設定 → APIキーを開き、「キーを作成」をクリックして名前を付け、キーのシークレットをコピーします。Consoleでシークレットが表示されるのは一度だけで、その後は名前とプレフィックスのみが表示されます。そのため、ここでのキー管理では、古いキーを再取得するのではなく新しいキーを作成します。

Claude Codeに必要なのは通常のキーです。管理者APIキーは組織管理用の別の認証情報であり、リクエストの認証には使えません。次に、 export ANTHROPIC_API_KEY=sk-ant-... をシェルで実行すると、Claude Codeは/loginなしでそのキーを使用します。Anthropicはトークンごとに課金するため、まずアカウントに支払い方法を登録する必要があります。

より手早い方法はゲートウェイキーの取得です。aiprimetech.ioで登録し、ダッシュボードの「APIキー」を開いて「作成」をクリックします。キーはダッシュボードでいつでも表示でき、再コピー、名前の変更、失効もいつでも行えます。同じ sk- 形式で、同じ環境変数で使えます。追加で必要な手順はANTHROPIC_BASE_URLのみで、ステップ2で説明します。

この時点ではキーはありますが、残高はありません。テストする前に少額をチャージしてください。モデルページでは、各モデルで一ドル分がどれだけ使えるかを確認できます。Claude Codeを一日中使うことが決まっている場合は、/plans/で無制限プランを選んでください。

ステップ2 — 環境変数の設定

Claude Codeはゲートウェイの設定に、ANTHROPIC_BASE_URLとANTHROPIC_API_KEYという二つの環境変数を読み取ります。ANTHROPIC_BASE_URLには、パスの接尾辞を付けずにゲートウェイのルートホストを設定してください。Anthropic SDKは/v1/messagesを自動的に追加します。ベースURLに/v1を含めると、リクエストの送信先が/v1/v1/messagesになり、404エラーが返されます。

LinuxまたはmacOSでは、シェルのプロファイル（~/.bashrc、~/.zshrc、または~/.profile）に次の行を追加します：export ANTHROPIC_BASE_URL="https://aiprimetech.io"およびexport ANTHROPIC_API_KEY="your-key-here"。Windowsでは、設定 > システム > システムの詳細設定 > 環境変数からシステム環境変数として設定するか、PowerShellの$PROFILEに追加します。

プロジェクトごとに設定するには、プロジェクトのルートに同じ変数を記述した.envファイルを作成します。Claude Codeは作業ディレクトリから.envファイルを読み込み、そこにある変数はシステムレベルの変数より優先されます。プロジェクトごとに異なるAPIプロバイダーを使う場合に便利です。キーを誤ってバージョン管理にコミットしないよう、必ず.envを.gitignoreに追加してください。

ステップ3 — 接続の確認

環境変数を設定したら、新しいターミナルセッションを開いて変数を読み込み、Claude Codeを実行します。「こんにちは。応答できることを確認してください。」などの簡単なメッセージを入力してください。Claudeから応答が返れば、設定はエンドツーエンドで機能しています。キーは有効で、ベースURLは正しく、ゲートウェイがリクエストをClaudeに正常にルーティングしています。

確認に失敗した場合は、エラーメッセージから原因を判断できます。401または403エラーは、APIキーが無効または期限切れであることを意味します。ダッシュボードから改めてコピーしてください。404エラーは、ほぼ常にベースURLの誤りを意味します。誤って/v1の接尾辞や末尾のスラッシュが付いていないか確認してください。接続拒否エラーは、ゲートウェイに到達できないことを意味します。ネットワーク、VPN、ファイアウォールの設定を確認してください。

curlでゲートウェイのステータスエンドポイントにアクセスし、プログラムから確認することもできます：curl -H 'Authorization: Bearer YOUR_KEY' https://aiprimetech.io/v1/models。キーが有効であれば、利用可能なモデルの一覧が返されます。これが成功するのにClaude Codeが動作しない場合、問題はキーやゲートウェイ自体ではなく、環境変数の読み込みにあります。

ステップ4 — モデル設定

デフォルトでは、Claude Codeは各階層（Sonnet、Opus、Haiku）で組み込みのモデル選択を使用します。追加の環境変数ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_FABLE_MODELで、これらを上書きできます。ゲートウェイが対応する正確なモデル識別子を設定してください。

ほとんどの開発者は、ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5とANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6を設定すれば十分です。Claude Codeは通常のやり取りではデフォルトでSonnetを使用し、/modelコマンドで選択した場合、またはプランモードでより強力なモデルに切り替わる場合にOpusを使用します。ゲートウェイは現在のすべてのClaudeモデルバージョンに対応しています。

CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1を設定して、ゲートウェイでのモデル検出を有効にします。これにより、Claude Codeはハードコードされた一覧を使う代わりに、利用可能なモデルをゲートウェイに問い合わせます。また、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1も設定して、テレメトリーリクエストがゲートウェイに送信されないようにしてください。これにより不要な通信が減り、リクエストのレイテンシーがわずかに改善します。

よくある認証エラーのトラブルシューティング

最もよくある問題は、環境変数が読み込まれていないことです。プロファイルに設定した後は、新しいターミナルを開く必要があります。既存のターミナルは古い環境を使用します。Windowsでは、新しいタブを開くだけでなく、ターミナルアプリケーション全体を再起動する必要がある場合があります。echo $ANTHROPIC_BASE_URL（bash/zsh）またはecho $env:ANTHROPIC_BASE_URL（PowerShell）で確認してください。

接続が有効なのに「モデルが見つかりません」というエラーが出る場合は、モデル識別子がゲートウェイの提供するものと一致していません。モデルIDは大文字と小文字を区別し、バージョンごとに異なります。対応している正確な識別子は、ダッシュボードまたは/v1/modelsエンドポイントで確認してください。よくある間違いには、「claude-opus-4-6」ではなく「claude-3-opus」を使うことや、環境変数の値に余分な空白を入れることがあります。

ダッシュボードで残高を確認してください。中断せずに利用を続けるには、従量課金用の残高を追加するか、無制限プランにアップグレードしてください。1日間（$9）または1週間（$39）のプランなら、トークン単位の課金なしで、すべてのモデルを定額で利用できます。

# Add to ~/.bashrc or ~/.zshrc:
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_API_KEY="your-key-from-dashboard"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Verify connection:
# $ source ~/.bashrc && claude
# Or test the gateway directly:
# $ curl -H "x-api-key: $ANTHROPIC_API_KEY" https://aiprimetech.io/v1/models

よくある質問

ANTHROPIC_API_KEY — 取得方法は？

Claude Consoleでキーを作成する（設定 → APIキー → キーを作成。キーのシークレットは表示時にコピーしてください）か、このゲートウェイのダッシュボードで作成してください。こちらではキーを引き続き表示できます。ANTHROPIC_API_KEYとしてエクスポートしてください。ゲートウェイのキーを使う場合は、ANTHROPIC_BASE_URLも設定してください。

Claude Codeとほかのツールで別々のキーが必要ですか？

いいえ。同じAPIキーをClaude Code、Cursor、Cline、Aider、およびAnthropic Messages APIやOpenAI互換エンドポイントを使うほかのツールで利用できます。同じキーを複数のツールで使えます。

ClaudeのセッションキーはAPIキーと同じですか？

いいえ。セッションキーは非公式クライアントが使用するclaude.aiブラウザCookieです。一方、APIキーはAPIとClaude Codeが要求する認証情報です。サポート、課金、安定した利用の対象となるのはAPIキーのみです。

ANTHROPIC_API_KEYを取得するにはどうすればよいですか？

Anthropicのコンソール（Anthropicアカウントに定価で課金）またはこのゲートウェイのダッシュボード（額面より安く購入したクレジット、または無制限プランで課金）から取得できます。どちらもANTHROPIC_API_KEY環境変数に設定します。

何を行うのですか： claude setup-token は何をしますか？

Claudeサブスクリプション用の長期間有効なOAuthトークンを作成し、対話形式のログインなしでClaude CodeをCIやヘッドレス環境で実行できるようにします。APIクレジットではなくサブスクリプションの利用枠を消費します。ゲートウェイを使う場合は、代わりにAPIキーを使用します。

ANTHROPIC_BASE_URLに/v1を含める必要はありますか？

いいえ。ルートホストのみを設定してください：https://aiprimetech.io。Anthropic SDKが/v1/messagesを自動的に追加します。/v1を含めるとパスが重複し、404エラーが返されます。

同じキーを複数のマシンで使えますか？

はい。同じキーをすべてのデバイスで同時に使用できます。すべての利用量は同じアカウントの残高とレート制限に計上されます。チームでは、個別に利用状況を追跡できるよう、開発者ごとに別々のキーを生成してください。

数分でClaudeの利用を開始

APIキーを取得 — Anthropicアカウントもウェイトリストへの登録も不要です。

APIキーを取得

AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。