SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

Claude API認証:key、Bedrock、Vertex、Foundryの設定

VPSのClaude APIクライアントを、Anthropic key、AWS IAM、Google ADC、Microsoft Entraで認証する方法です。BedrockではAnthropic keyを使わない構成も解説します。

Claude API の認証経路

Claude API の認証は、クライアントがネットワーク経由で送信する認証情報を 1 つ選ぶことに集約されます。Anthropic は、直接利用する Claude API に加えて、5 つのクラウドプラットフォームを案内しています。Amazon Bedrock、AWS 上の Claude Platform、Google Cloud 上の Claude Models(Google 管理)、Google Cloud 上の Claude Models(Anthropic 管理)、Microsoft Foundry です。直接利用する Anthropic API は、Authorization: Bearer ヘッダーで API key または短時間有効な token を受け付けます。従来の x-api-key ヘッダーによる API key も引き続き利用できます。Amazon Bedrock は AWS request signing と Bedrock API keys に対応しており、この構成では Anthropic key はどこにも存在しません。Google Cloud では短時間有効な Google access token を送信します。Microsoft Foundry では、Azure が発行した key または Microsoft Entra token を使用します。以下の 4 セクションでは、これらの認証情報の構成を説明します。Anthropic が管理する AWS と Google Cloud の提供形態については、それぞれ対応するクラウドの経路と併せて説明します。

このガイドは、Linux サーバー上で動作するサービスに SDK(software development kit)を組み込むためのものです。代わりに Claude Code command line tool を設定する場合は、変数と手順が異なります。Claude Code を Bedrock または Vertex に接続する方法を参照してください。サービスがまだ存在しない場合は、まず VPS 上で最初の Claude API アプリを作成する方法で構築し、認証情報を設定するためにこのページへ戻ってください。

以下の内容は、2026 年 8 月に Anthropic のプラットフォームドキュメントと照合し、2026 年 10 月 16 日に各プロバイダーのドキュメントと再照合しています。Bedrock のモデルアクセスの詳細は、2026 年 10 月 19 日に AWS のドキュメントと再照合しました。Anthropic の 4 つの経路、API keys、API versions に関するページは、2026 年 10 月 27 日に再確認しています。Microsoft Foundry、2 つの Bedrock endpoint、Google 管理の経路、AWS 上の Claude Platform、authentication、Workload Identity Federation、API versions に関する Anthropic のページは、Ruby SDK の変更履歴と併せて、2026 年 11 月 10 日に再確認しました。モデル識別子、料金、SDK versions、endpoint の形式は変更されるため、このガイドでは古くなる値を記載せず、それぞれのプロバイダーページにリンクしています。

Route 1: Anthropic API キー

これは直接的な経路であり、Anthropic が Secret を発行する唯一の方法です。リクエストは Anthropic の API ホスト上にある Messages エンドポイントへ送信され、すべてのリクエストに 3 つのヘッダーが付きます。

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "MODEL_ID", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'

MODEL_ID を Anthropic の モデル一覧にある現在の識別子に置き換えます。正常なレスポンスは、content 配列と usage オブジェクトを含む JSON です。無効または期限切れのキーを使うと、HTTP 401 と authentication_error が返ります。anthropic-version ヘッダーがない場合は別のエラーになります。このヘッダーはすべてのリクエストで必須であり、SDK が自動的に設定します。2026 年 10 月時点で、Anthropic のドキュメントでは Authorization: Bearer がキーを送信する主な方法として示され、x-api-key は legacy とされています。ただし、どちらも受け付けられるため、上のコマンドは引き続き動作します。現在の SDK のメジャーバージョンもキーを Authorization: Bearer として送信するため、X-Api-Key を読み取るプロキシまたはゲートウェイは、SDK をアップグレードするときに変更が必要です。コマンド内の 2023-06-01 バージョンも引き続き受け付けられます。Anthropic の最新 API バージョンは 2026-10-21 で、該当する SDK バージョンはこれをデフォルトで送信します。このバージョンでは、temperature など一部の古いリクエストパラメーターが拒否されます。

クライアントの構築は、これらの構成の中で最も簡単です。構築するものがないためです。公式 SDK はすべて、環境から ANTHROPIC_API_KEY を自動的に読み取ります。

import os
from anthropic import Anthropic

client = Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model=os.environ["CLAUDE_MODEL"],
    max_tokens=64,
    messages=[{"role": "user", "content": "Hello"}],
)
print(message.usage)

キーと同じ環境にモデル識別子も保持すると便利です。モデル名は自分で管理できないスケジュールで変更されるため、1 つの文字列を編集するためにコードを再デプロイする作業を避けられます。

キーは Console で作成します。作成時に、有効期限として 3 hours、1 day、7 days、30 days のプリセット、カスタム期間、または Never を選択できます。ただし、組織の最大有効期限ポリシーに従います。有効期限は作成時に固定され、後から変更できません。 Anthropic は長期間有効なキーの期限が切れる前に作成者へメールを送信しますが、短期間だけ有効なキーは警告メールなしで期限切れになります。期限切れのキーは 401 を返し、再有効化できません。そのため、常に新しいキーを発行して対応します。

直接 API ではリージョンを選択する必要がなく、請求は Anthropic 組織に直接行われます。Workspace を使うと、キーを 1 つのプロジェクトに限定できます。これにより、単一サービスの利用額を最も明確に把握できます。サーバーのキーを作成するときは、その Workspace に限定してください。Workspace に限定されていない個人キーまたはサービスアカウントキーでは、すべてのリクエストに anthropic-workspace-id ヘッダーを付ける必要があります。そうしないと、API は invalid_request_error とともに 400 を返します。サービスでは、個人キーではなくサービスアカウントキーを選択してください。個人キーは、作成者が組織を離れると動作しなくなるためです。請求額の計算方法については、トークン単位の API 料金とサブスクリプションの比較を参照してください。

ここで、静的な Secret を完全に排除する別の方法にも触れておきます。Workload Identity Federation を使うと、すでに信頼している Identity Provider から取得した OpenID Connect (OIDC) トークンを、POST /v1/oauth/token で短期間有効な Anthropic トークンと交換できます。SDK はトークンの期限が切れる前に自動更新します。sk-ant-api... 文字列が発行されたり、どこかへコピーされたりすることはありません。すでにプラットフォーム ID を持つ Kubernetes、GitHub Actions、クラウド VM に適しています。通常の VPS には、そのような issuer がないことが多いため、そのサーバーではファイル内の API キーが現実的な選択肢です。このガイドの後半も、その前提で説明します。

ルート 2: Amazon Bedrock での AWS 認証情報

Bedrock では Anthropic のキーを保持する必要がありません。AWS 認証情報を使用すると、SDK が各 HTTP リクエストに AWS Signature Version 4 (SigV4) で署名し、その呼び出し元がモデルを呼び出せるかどうかを AWS が判断します。

pip install -U "anthropic[bedrock]"
aws sts get-caller-identity

aws sts get-caller-identity は、認証情報から解決された ID のアカウント番号と ARN (Amazon Resource Name) を出力します。SigV4 を使用する場合は、他の処理より先に実行してください。SigV4 では、SDK がコンストラクターで指定された認証情報、環境変数の認証情報、標準の AWS 認証情報チェーンを解決します。リージョンの選択は別に行われます。Python の AnthropicBedrock クライアントでは、api_key として、または AWS_BEARER_TOKEN_BEDROCK を介して指定した Bedrock API キーに加えて aws_access_key、aws_secret_key、aws_session_token、aws_profile のいずれかを渡すと、ValueError が発生します。これらの明示的な引数を指定しない場合、キーによって AWS 認証情報チェーンではなく bearer 認証が選択されます。TypeScript クライアントでは、Bedrock API キーが明示的な AWS 認証情報より優先されます。STS コマンドでは bearer 認証をテストできません。

クライアントの構築で変わるのは、クラスと 1 つの引数です。

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-east-1")

AnthropicBedrock は Bedrock の InvokeModel 統合を処理します。2026 年 10 月時点で、Anthropic は Amazon Bedrock 上の Claude についても説明しており、Claude Opus 4.7 以降のモデル向けに https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages の Messages API エンドポイントを提供しています。このエンドポイントには、同じパッケージの AnthropicBedrockMantle クライアントからアクセスします。AWS 認証情報と Bedrock bearer token に対応していますが、モデルへのアクセス要件は 2 つのエンドポイントで異なります。詳細は後述します。

pip install -U の行でのアップグレードに注意してください。2026 年 10 月 27 日時点で、最新の SDK は Bedrock 経由を含め、デフォルトで API バージョン 2026-10-21 を送信します。Anthropic の説明によると、Claude Opus 4.6 以前について掲載されている ARN でバージョン指定されたモデル ID は、Bedrock ではこのバージョンに対応しておらず、400 エラーを返す場合があります。サービスがこれらのモデルのいずれかを呼び出す場合は、現在使用している SDK のバージョンを維持して固定するか、先にサービスを Claude 4.7 以降のモデルへ移行してください。

ここではリージョンを単なる表示項目として扱えません。Bedrock のエンドポイントはリージョンごとに異なり、利用できる Claude モデルもリージョンによって異なります。また、リージョンは SigV4 署名の一部であるため、あるリージョン向けに計算した署名は別のリージョンでは拒否されます。SDK は未指定時の動作が一致しないため、サービス環境で AWS_REGION を明示的に設定してください。2026 年 10 月時点のドキュメントでは、Python の AnthropicBedrock クライアントは AWS_REGION または AWS_DEFAULT_REGION を読み取り、その後 boto3 セッションまたは AWS プロファイルのリージョン(~/.aws/config を含む)にフォールバックし、どれも解決できなければ ValueError を発生させます。TypeScript クライアントは AWS_REGION を読み取り、未設定の場合は us-east-1 にフォールバックしますが、リージョンについて ~/.aws/config は読み取りません。そのため、同じホスト上で AWS CLI は Claude モデルを正常に一覧表示できるのに、Node プロセスは誤ったリージョンを呼び出すことがあります。CLI は設定ファイルを読み取りますが、クライアントは読み取らないためです。

EC2 インスタンスでは IAM (identity and access management) ロールをアタッチすれば、Secret をディスクに保存する必要がありません。インスタンスメタデータサービスが SDK に一時的な認証情報を渡すためです。AWS 外部の VPS には、インスタンスロールもメタデータサービスもありません。その場合は、ボックス上に IAM ユーザーの長期アクセスキーペアを置くか、フェデレーションを利用するかを選択します。前者は Anthropic キーと同じ種類の Secret です。後者では、ID プロバイダーで認証し、AWS STS (security token service) を呼び出して、返された一時認証情報を使用します。Bedrock は AWS_BEARER_TOKEN_BEDROCK を介して bearer token として渡す Bedrock API キーにも対応しており、AWS は 2 種類を説明しています。短期キーの有効期間は最大 12 時間です。ただし、生成元のセッション期間がそれより短い場合は、その期間だけ有効です。生成元の IAM ID の権限を引き継ぎ、AWS は本番環境にこの種類を推奨しています。長期キーは、作成時に指定した有効期限(--credential-age-days を使用した 30 日や 90 日など)まで有効です。API パラメーターを省略すると、有効期限はありません。Console はそのキーの背後に IAM ユーザーを作成するため、AWS は探索用途に限って使用することを推奨しています。長期キーは生成されたリージョンでのみ機能し、別のリージョンで使用すると Credential should be scoped to a valid region が返されます。

請求先は Anthropic ではなく AWS アカウントになります。通常、これが Bedrock を利用する主な理由です。2026 年 10 月時点のドキュメントでは、リージョン別エンドポイントにはグローバルエンドポイントより 10% 高い料金が適用されます。AWS 上の Claude Platform は別の製品です。Anthropic が運用し、AWS Marketplace を通じて AWS が請求します。認証には SigV4 または AWS Console で生成した API キーを使用します。Claude Console で生成したキーは使用できません。アクセスには、Anthropic が beta として扱っている AnthropicAWS クライアントを使用します。権限の問題に見えて、実際にはそうではない Bedrock エラーが 1 つあります。Invocation of model ID ... with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model. これはモデルのルーティングに関するエラーであり、認証情報を変更しても解決しません。

Route 3: Google credentials on Vertex AI

Anthropic のドキュメントでは現在、この経路を Claude Models on Google Cloud (Google managed) と呼んでいます。Google はこれを、Vertex AI から発展した新しい Agent Platform の一部として運用しています。以下に示す aiplatform.googleapis.com ホスト、anthropic[vertex] 追加機能、AnthropicVertex クラスは変更されていません。

Google Cloud は Application Default Credentials (ADC) を使用します。これは、認証情報を指定しなくても認証情報を探せるように、Google の認証ライブラリが従う固定の検索順序です。ADC は最初に GOOGLE_APPLICATION_CREDENTIALS を確認し、次に gcloud auth application-default login が書き込んだファイルを確認し、その後にメタデータサーバー経由で割り当てられたサービスアカウントを確認します。

pip install -U "anthropic[vertex]"
gcloud auth application-default login

ワークステーションでは、ログインによって $HOME/.config/gcloud/application_default_credentials.json が書き込まれるため、それで完了です。サーバーでは、人間のユーザーの認証情報を保存しないでください。このコマンドはサービスアカウントの偽装にも対応しています。Google Cloud の外部には Google のメタデータサーバーもないため、GOOGLE_APPLICATION_CREDENTIALS を使用して、ADC に Workload Identity Federation の設定ファイルまたはサービスアカウントキーのファイルを指定します。サービスアカウントキーの JSON ファイルは有効期間の長い Secret であり、このガイドの後半で説明する方法に厳密に従って扱う必要があります。Google Cloud 内では、VM にサービスアカウントを割り当てれば、保護するファイルはありません。ADC が見つける ID には、aiplatform.endpoints.predict 権限を含む IAM ロールが必要です。たとえば Agent Platform User (roles/aiplatform.user) です。

from anthropic import AnthropicVertex

client = AnthropicVertex(project_id="my-project", region="global")

SDK より下の層で raw HTTP を使用すると、2 つの点が変わります。モデル識別子はリクエストボディから URL パスに移り、anthropic_version はヘッダーからボディに移ります。2026年10月27日時点で、Anthropic のドキュメントでは、そこに vertex-2023-10-16 または新しい API バージョン 2026-10-21 のいずれかを指定できます。認証情報は通常の Google アクセストークンです。以下のコマンドでは、gcloud auth print-access-token が ADC ではなく gcloud CLI 自身のログインを使用するため、テストするマシンで先に gcloud auth login または gcloud init を実行してください。

curl https://aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/publishers/anthropic/models/${MODEL_ID}:rawPredict \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{"anthropic_version": "vertex-2023-10-16", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'

リージョンは主要な引数です。global は可用性に応じて動的にルーティングし、us と eu はマルチリージョン識別子です。us-east5 のような名前を指定すると、単一のリージョンに固定されます。2026年10月時点で、Anthropic が単一リージョンのエンドポイントを文書化しているのは Claude Sonnet 4.6 以前だけです。新しいモデルではグローバルまたはマルチリージョンのエンドポイントを使用します。2026年10月のドキュメントに記載されているとおり、マルチリージョンおよびリージョンのエンドポイントはグローバルより 10% 高くなります。課金は Google Cloud プロジェクトを通じて行われるため、クォータと請求書の管理元は Google です。

2026年10月27日時点で、Anthropic は 2 つ目の Google Cloud サービスも文書化しており、リクエスト形式は異なります。Claude Models on Google Cloud (Anthropic managed) では、Anthropic が Claude API 自体を claude.googleapis.com で運用し、AnthropicGoogleCloud クライアントを通じてアクセスします。ADC を含む Google Cloud 認証情報で認証する点は同じですが、リクエストは直接 API と同じ形式です。model はボディに残り、バージョンは anthropic-version ヘッダーで送信されます。アクセスには独自の IAM ロール (roles/claude.user など) を使用し、セットアップによってプロジェクト用の新しい Anthropic 組織が作成され、使用料金は Google Cloud Marketplace を通じて請求されます。リクエスト URL に aiplatform が含まれ、:rawPredict で終わる場合は、このセクションで説明している Google 管理の経路を使用しています。

経路 4: Microsoft Foundry は Azure の経路

Azure で Claude を検索した場合は、このセクションが該当します。対応する経路は実際に存在します。Claude は Microsoft Foundry(旧 Azure AI Foundry)で動作し、Azure Marketplace を通じて Claude Consumption Units で課金されます。Foundry resource を作成し、その中に Claude model を deploy して、https://{resource}.services.ai.azure.com/anthropic/v1/* の Azure-hosted endpoint を呼び出します。

使用できる認証情報は 2 つあります。1 つ目は、Foundry portal の deployment の Details tab に表示される Azure-issued key です。これは api-key または x-api-key ヘッダーで送信します。2 つ目は Microsoft Entra token です。サーバーではこちらが適しています。Azure role-based access control によって、endpoint を呼び出せるユーザーを制御できるためです。

ACCESS_TOKEN=$(az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv)

curl https://${RESOURCE}.services.ai.azure.com/anthropic/v1/messages \
  -H "content-type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model": "DEPLOYMENT_NAME", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'

model フィールドには model identifier ではなく、deployment name を指定します。デフォルトでは両者は一致します。しかし deployment に独自の名前を付けた時点で一致しなくなります。これは、正しい request で発生する Deployment not found error の一般的な原因です。Python SDK と TypeScript SDK は、環境から ANTHROPIC_FOUNDRY_API_KEY と ANTHROPIC_FOUNDRY_RESOURCE を読み取ります。2026 年 11 月 10 日時点のドキュメントによると、Foundry は公式 SDK 7 種類すべてに対応しています。C#、Go、Java、PHP、Python、Ruby、TypeScript です。Go では専用の foundry package(go get github.com/anthropics/anthropic-sdk-go/v2/foundry)を使用します。Ruby では、2026 年 11 月 4 日にリリースされた gem version 2.5.0 で専用の Anthropic::FoundryClient が追加されました。それ以前は、Ruby code から generic client の接続先を Foundry base URL に指定する必要がありました。

generic client の接続先を Foundry base URL に指定する方法には、依然として注意点があります。対象は、2.5.0 より前に作成された Ruby code でも、Anthropic 自身の Foundry examples が同じ方法で呼び出している ant CLI でも同じです。generic client に認証情報を明示的に渡さず、環境に ANTHROPIC_API_KEY または ANTHROPIC_AUTH_TOKEN が設定されたままだと、client はその値を取得し、Anthropic credential を Microsoft endpoint に送信します。変数の設定を解除するか、Foundry key または token を client に明示的に渡してください。Ruby では、Foundry key または Entra token provider を受け取る Anthropic::FoundryClient へ移行するのが、より確実な解決策です。Entra access token のデフォルトの有効期間は 60 分から 90 分の範囲でランダムに決まります。そのため、長時間動作する process では、開始時に 1 つ取得して保持するのではなく、更新する必要があります。

サーバー上の認証情報はどのくらいの期間有効ですか?

グラフDocumented credential lifetime by route, hours
このグラフのデータ
[
  {
    "label": "Anthropic key, 30-day preset",
    "max_lifetime_hours": 720
  },
  {
    "label": "Anthropic key, 7-day preset",
    "max_lifetime_hours": 168
  },
  {
    "label": "AWS STS assumed role",
    "max_lifetime_hours": 12
  },
  {
    "label": "Bedrock short-term API key",
    "max_lifetime_hours": 12
  },
  {
    "label": "Entra ID access token, default upper bound",
    "max_lifetime_hours": 1.5
  },
  {
    "label": "Federated Anthropic token, default",
    "max_lifetime_hours": 1
  }
]

これらは各プロバイダーが公開している上限値とデフォルト値で、2026年10月時点で確認したものです。実測値ではありません。重要なのは、認証情報の漏えいに気付いて対応するまでの間、漏えいした認証情報がどのくらい使われ続けるかを把握できる点です。図の最下段にあるフェデレーションされた Anthropic token は、デフォルトで最大 1 時間有効です。ただし、identity provider の token の残り有効期間の2倍も上限になります。Microsoft Entra access token には単一のデフォルト値がありません。Microsoft は各 token に60分から90分の範囲でランダムな有効期間を設定します。平均は75分です。図では、上限である 1.5 時間の位置に示しています。このデフォルト値は、client、resource、テナントで Conditional Access が有効かどうかによっても変わります。client と resource の両方が Continuous Access Evaluation をサポートしている場合、Entra は有効期間を24時間から28時間まで延長することがあります。その代わり、アカウントの無効化などのイベントが発生すると、ほぼリアルタイムで token を失効させます。テナントの token lifetime policy では、10分から23:59:59までの範囲で設定できます。SDK はフェデレーションされた Anthropic token を自動的に更新します。Foundry では、固定された token 文字列を渡すのではなく、Entra token provider を設定して token を更新してください。フェデレーションルールでは、token の有効期間を1分から24時間まで独自に設定できます。また、Console の Connect workload ウィザードは10分を事前入力します。したがって、デフォルト値を前提にせず、ルールを確認してください。引き受けた role と Bedrock short-term API key は、どちらも 12 時間有効です。Bedrock long-term API key には固定の上限がないため、図には含めていません。作成時に選択した有効期限まで有効で、CredentialAgeDays を API 呼び出しから省略した場合は無期限になります。そのため、AWS はこの key を探索用途に限って使用することを推奨しています。30日間のプリセットで作成した key は 720 時間有効です。これは、サーバー上のファイルに1か月間保存される認証情報です。

VPS 上で認証情報を保管する場所

Secret は root だけが読み取れるファイルに保存し、systemd からプロセスへ渡します。この方法は SDK のバージョンが変わっても有効なので、最初に適切に設定しておく価値があります。

sudo useradd --system --home /opt/claude-app --shell /usr/sbin/nologin claudeapp
sudo install -d -m 700 -o root -g root /etc/claude-app
sudo install -m 600 -o root -g root /dev/null /etc/claude-app/env
sudoedit /etc/claude-app/env

ファイルには平文の KEY=value 行を記述します。systemd 自身が解析し、shell を介して実行するわけではないため、export、引用符、shell 構文は使用しません。

ANTHROPIC_API_KEY=sk-ant-api03-REPLACE-ME
CLAUDE_MODEL=REPLACE-ME
[Unit]
Description=Claude API service
After=network-online.target

[Service]
User=claudeapp
EnvironmentFile=/etc/claude-app/env
ExecStart=/opt/claude-app/venv/bin/python -m claude_app
Restart=on-failure

[Install]
WantedBy=multi-user.target

systemd は EnvironmentFile= を root として読み取り、その後 User=claudeapp に切り替えます。そのため、サービスアカウントにファイルの読み取り権限は必要ありません。root が所有する Mode 600 で十分です。上述の install コマンドがこの権限を設定するのはそのためです。sudo systemctl enable --now claude-app で起動し、systemctl status claude-app で unit がループして再起動せず、active (running) に到達したことを確認します。

避けるべきことは 4 つあります。それぞれ理由を自分で確認できます。

  • unit ファイル内で Environment= を使って key を記述しないでください。/etc/systemd/system 配下の unit は全ユーザーが読み取れるため、systemctl cat claude-app によってローカルユーザーへ Secret が出力されます。
  • commit しないでください。.gitignore は新しいファイルを commit 対象から外すだけで、すでに commit されたファイルには何もしません。git の履歴には、渡された内容がそのまま残るためです。
  • container image に埋め込まないでください。ENV の値は image の設定に残り、build 引数は image の履歴や provenance metadata から確認できます。後続の layer でファイルを削除しても、前の layer からは削除されません。代わりに、--env-file または mount したファイルを使って実行時に Secret を渡します。
  • process environment を root からも非公開だと考えないでください。sudo cat /proc/$(pgrep -u claudeapp -f claude_app | head -1)/environ | tr '\0' '\n' によって key が出力されます。ファイルを読み取るコマンド自体には sudo が必要です。shell の入力リダイレクトは sudo より前に実行され、現在のアカウントの権限を使います。目的は root から Secret を隠すことではなく、同じマシン上の他のすべてのアカウントから Secret を遠ざけることです。root は、どのような対策をしても Secret を読み取れます。

この点が、この設計で保護できる範囲を示します。root 専用ファイルは保存された key を保護しますが、サービスアカウントとして実行されるコードは process environment を読み取れます。また、子プロセスはその environment を継承します。プロセスが自分で作成していないコードを実行する場合、この方法では不十分です。プロセスが実行できるものは、自身の environment を読み取れるためです。AI agent の手の届かない場所に Secret を保管するではこのケースを扱います。これは別の問題であり、解決方法も異なります。

ダウンタイムなしで key をローテーションするにはどうすればよいですか?

先に新しい key を切り替え、最後に古い key を失効させます。以下の単一サービスの再起動では、サービスが短時間中断します。可用性を維持するには、再起動中のリクエストを処理する別のインスタンスが必要です。

  1. Console で、古い key と同じ workspace に新しい key を作成します。
  2. /etc/claude-app/env に sudoedit を使用して書き込みます。
  3. sudo systemctl restart claude-app を実行します。
  4. サービスがリクエストに応答していることを確認してから、Console で古い key を失効させます。

EnvironmentFile は unit の起動時に読み込まれるため、実行中のプロセスは起動時に渡された値を保持します。systemctl daemon-reload は unit ファイルを再読み込みしますが、実行中のプロセスの環境には触れません。そのため、新しい key を反映するには再起動だけが必要です。step 4 ではなく step 1 で失効させると、step 3 まで停止が続きます。

cloud route のローテーションは provider 側で行われます。IAM user は同時に2つの active access key を使用できるため、2つ目を作成してデプロイし、その後で1つ目を削除します。Google service account key も同じ方法でローテーションします。Foundry resource には2つの key があり、一方を再生成すると古い値は直ちに使用できなくなります。そのため、使用中の key を再生成する前に、サービスをもう一方の key に切り替えてください。Entra token と federated Anthropic token は手動でローテーションする必要がありません。利用できる場合にこれらを使用する最大の理由はこの点です。

Console を開いている間に、workspace に spend limit を設定します。key の漏えいは、何より先に高額な費用につながります。VPS 上の agent による支出額を制限するでは、各種制御について説明しています。

クライアントが401または403を返すのはなぜですか?

直接 API で authentication_error を伴う401。 鍵が間違っているか、失効しているか、有効期限を過ぎています。コードが変わっておらず、昨日までリクエストが成功していたため、有効期限を見落としやすい点に注意してください。Console で鍵の有効期限の列を確認するか、Admin API から expires_at を読み取ってください。有効期限がない鍵では、null になります。個人用の鍵は、所有者が組織を離れた場合も使用できなくなります。

SDK が federation の設定を無視し、代わりに鍵を使用する。 ANTHROPIC_API_KEY と ANTHROPIC_AUTH_TOKEN は認証情報の優先順位で federation より上位にあるため、どちらかが federation を隠します。特に注意が必要なのは、空の文字列として export された変数もその位置を占有することです。そのため ANTHROPIC_API_KEY="" により、SDK は次の認証方式へ移行せず、空の鍵で認証します。unset ANTHROPIC_API_KEY を使用してください。

federation でメッセージが Authentication failed だけの401。 このメッセージは、考えられるすべての原因で意図的に同一です。これにより、呼び出し元がエラーテキストからルール設定を推測できないようにしています。実際の理由は、Console の認証履歴ページに記録されています。JWT を推測する前に、まずここを確認してください。

Foundry で403。 トークンによる認証は成功していますが、Azure アカウントにその呼び出しを許可するロールがありません。リクエストを実行する ID に、Foundry User(旧称 Azure AI User)や Cognitive Services User などの Azure RBAC ロールを割り当ててください。

Bedrock で発生するすべてのエラー。 SigV4 認証では、まずサービスユーザーとして aws sts get-caller-identity を実行してください。これにより、そのホストで使用可能な AWS 認証情報が存在するかどうかを確認できます。認証情報の問題と、モデルへのアクセス権やリージョンの不一致を切り分けられます。2026 年10月29日時点で、AWS は必要な AWS Marketplace 権限があれば、商用リージョンで多くのモデルへのアクセスを初回使用時に有効にします。ただし、アカウントレベルで別途アクセスを許可する必要があるモデルもあります。InvokeModel ルート経由で呼び出す Anthropic モデルでは、まずアカウントごとに1回、ユースケースフォームを提出する必要があります。AWS Organization 全体では1回で済みますが、オプトインリージョンでは再度必要です。承認されるまで、呼び出しは AccessDeniedException を返します。AWS のドキュメントによると、このフォームは bedrock-mantle エンドポイントには適用されません。アカウントでモデルを初めて呼び出すと、Bedrock はバックグラウンドで AWS Marketplace のサブスクリプションも開始します。このサブスクリプションには、aws-marketplace:Subscribe、aws-marketplace:Unsubscribe、aws-marketplace:ViewSubscriptions の権限を持つ ID が必要です。権限が不足していても、初回の呼び出しが必ず失敗するとは限りません。AWS のドキュメントでは、サブスクリプションの設定中は最大15分間、呼び出しが成功する場合があると説明されています。サブスクリプションの作成に失敗すると、その後の呼び出しは同じ AccessDeniedException を返します。最初の数分間は動作していたサービスが、その後失敗し始めた場合は、認証情報ではなく、ここを確認してください。権限を付与した後、サブスクリプションの完了まで AWS は最大2分かかる場合があります。呼び出し先のリージョンで提供されていないモデルは、認証情報が正しくても失敗します。

FAQ

Bedrock または Vertex で Claude を使用する場合、Anthropic API key は必要ですか?

いいえ。Amazon Bedrock では、SDK が SigV4 を使用して AWS credentials でリクエストに署名するか、Bedrock API key を送信します。Google Cloud では、Application Default Credentials を通じて取得した Google access token を送信します。どちらの構成にも Anthropic が発行した secret は存在せず、利用料金は Anthropic ではなく cloud account に請求されます。そのため、これらのホストの ANTHROPIC_API_KEY に Anthropic key を残すのは危険です。cloud endpoint を指す汎用 client は、その key を問題なく送信してしまいます。

Claude は Azure で利用できますか?

はい。以前の Azure AI Foundry である Microsoft Foundry を通じて利用できます。Foundry resource を作成し、Claude model をデプロイして、https://{resource}.services.ai.azure.com/anthropic/v1/messages を呼び出します。このとき、api-key header に Azure-issued key を指定するか、Microsoft Entra bearer token を指定します。利用料金は Claude Consumption Units として Azure Marketplace 経由で請求されます。request body の model field には deployment name を指定する必要があります。この名前が model identifier と一致するのは、deployment の作成時に default name を維持した場合だけです。名前は後から変更できません。

Claude API key は Linux server のどこに保存すべきですか?

root が所有し、mode 600 に設定した file に保存し、systemd unit の EnvironmentFile= を通じて読み込みます。systemd は unit の User= に切り替える前に root としてこの file を読み込むため、service account がこの file にアクセスする必要はありません。repository、unit file 自体(world readable であり、systemctl cat によって表示されます)、container image の configuration、layers、build metadata には保存しないでください。

何も変更していないのに、Claude API request が 401 を返すようになったのはなぜですか?

作成時に設定された有効期限に達した key は 401 を返します。有効期限は作成時に設定され、後から編集できません。また、有効期間の短い key は警告 email なしで期限切れになります。期限切れの key は再有効化できないため、replacement を作成し、environment file に書き込み、service を再起動してから、古い key を revoke してください。key が確実に有効な場合は、古い credential が優先されていないか確認します。ANTHROPIC_API_KEY が empty string に設定されていても、それより下位の federation および profile source より優先されます。

この記事は役に立ちましたか?

#claude#api#authentication#bedrock#vertex#secrets-management