Claude Code on Microsoft Foundry
Microsoft Foundry を通じて Claude Code を構成する方法について学びます。セットアップ、構成、トラブルシューティングを含みます。
Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.
View plans Contact sales
前提条件
Microsoft Foundry で Claude Code を構成する前に、以下を確認してください：
- Microsoft Foundry へのアクセス権を持つ Azure サブスクリプション
- Microsoft Foundry リソースとデプロイメントを作成するための RBAC 権限
- Azure CLI がインストールされ、構成されている（オプション - 認証情報を取得する別のメカニズムがない場合のみ必要）
[!NOTE]
Claude Code を複数のユーザーにデプロイする場合は、モデルバージョンをピン留めして、ロールアウト前に実施してください。
セットアップ
Microsoft Foundry リソースをプロビジョニングする
まず、Azure で Claude リソースを作成します：
-
Microsoft Foundry ポータルに移動します
-
新しいリソースを作成し、リソース名をメモします
-
Claude モデルのデプロイを作成します。各デプロイに付与する名前をメモしてください。ステップ 4 でこれらの名前をモデル変数として設定します：
- Claude Opus
- Claude Sonnet
- Claude Haiku
デプロイを設定する際に、ホスティングオプションも選択します。これにより、推論が Azure で実行されるか、Anthropic インフラストラクチャで実行されるかが決まります。
Azure 認証情報を構成する
Claude Code は Microsoft Foundry の 3 つの認証方法をサポートしています。セキュリティ要件に最適な方法を選択してください：
- API キー：Microsoft Foundry ポータルからキーをコピーし、
ANTHROPIC_FOUNDRY_API_KEYとして設定します - Microsoft Entra ID：Claude Code は Azure SDK のデフォルト認証情報チェーンを通じて（たとえば
az loginセッションから）トークンを取得するため、API キーを保存する必要がありません - ベアラートークン：別のプロセスが Microsoft Entra ID アクセストークンを取得し、それを
ANTHROPIC_FOUNDRY_AUTH_TOKENで渡します
[!NOTE]
Microsoft Foundry を使用する場合、認証が Azure 認証情報を通じて処理されるため、
/logoutコマンドは利用できません。
API キーを使用する
Microsoft Foundry ポータルからキーをコピーし、環境変数として設定します：
- Microsoft Foundry ポータルでリソースに移動します
- Endpoints and keys セクションを開きます
- API キーをコピーします
- 環境変数を設定します。
your-azure-api-keyをコピーしたキーに置き換えます：
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
Microsoft Entra ID を使用する
ANTHROPIC_FOUNDRY_API_KEY と ANTHROPIC_FOUNDRY_AUTH_TOKEN を設定しないままにします。すると Claude Code は Azure SDK のデフォルト認証情報チェーンを使用します。
これは、ローカルおよびリモートワークロードを認証するためのさまざまな方法をサポートしています。
ローカルマシンでは、Azure CLI でサインインします：
az login
ID に必要なロールについては、Azure RBAC 設定を参照してください。
ベアラートークンを使用する
Claude Code は、すべてのリクエストで ANTHROPIC_FOUNDRY_AUTH_TOKEN の値を Authorization: Bearer ヘッダーとして送信します。ホストアプリケーションやサインインスクリプトなど、別のプロセスがすでにアクセストークンを取得している場合に、このオプションを使用します。
変数を、Microsoft Entra ID がリソース用に発行したベアラートークンに設定します：
export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token
ANTHROPIC_FOUNDRY_AUTH_TOKEN は ANTHROPIC_FOUNDRY_API_KEY およびデフォルト認証情報チェーンより優先されます。
Claude Code を構成する
Microsoft Foundry を有効にするには、以下の環境変数を設定します：
# Microsoft Foundry 統合を有効にする
export CLAUDE_CODE_USE_FOUNDRY=1
# Azure リソース名（{resource} をリソース名に置き換えます）
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# または完全なベース URL を提供します：
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
ANTHROPIC_FOUNDRY_RESOURCE には、my-resource のようにリソース名のみを設定します。URL やホスト名を設定した場合、メッセージを送信した時点で Claude Code はそれを拒否します。
モデルバージョンをピン留めする
[!WARNING]
すべてのデプロイに対して特定のモデルバージョンをピン留めしてください。ピン留めなしでは、
sonnetやopusなどのモデルエイリアスが Claude Code の Microsoft Foundry 用の組み込みデフォルトに解決されます。これは最新リリースより遅れている可能性があり、アカウントでまだ利用できない場合があります。Microsoft Foundry にはスタートアップモデルチェックがないため、デフォルトが利用できない場合、リクエストは失敗します。Azure デプロイを作成するときは、「最新に自動更新」ではなく、特定のモデルバージョンを選択してください。
モデル変数をステップ 1 で作成したデプロイ名と一致するように設定します。
ANTHROPIC_DEFAULT_OPUS_MODEL がない場合、Microsoft Foundry の opus エイリアスは Opus 4.6 に解決されます。より新しい Opus モデル（Opus 4.8 など）の ID に設定します：
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
セッションタイトル生成などのバックグラウンドタスクは、通常は Haiku クラスモデルである小型/高速モデルを使用します。Microsoft Foundry では、すべてのアカウントが Haiku デプロイを持っているわけではないため、Claude Code はこれをプライマリモデルにデフォルト設定します。バックグラウンドタスクに Haiku を使用するには、上記のように、アカウントで利用可能な Haiku デプロイに ANTHROPIC_DEFAULT_HAIKU_MODEL を設定します。
現在および従来のモデル ID については、モデル概要を参照してください。環境変数の完全なリストについては、モデル設定を参照してください。
プロンプトキャッシュは自動的に有効になります。デフォルトの 5 分ではなく 1 時間のキャッシュ TTL をリクエストするには、以下の変数を設定します。1 時間の TTL でのキャッシュ書き込みはより高いレートで課金されます：
export ENABLE_PROMPT_CACHING_1H=1
メインの会話と、Claude Code がその外部で実行するリクエストとで異なる TTL を設定するには、TTL を自分で選択してください。
Claude Code を実行する
環境変数を設定したら、プロジェクトディレクトリから Claude Code を起動します：
claude
Claude Code は環境から CLAUDE_CODE_USE_FOUNDRY およびその他の Microsoft Foundry 変数を読み込み、最初のプロンプトで Azure リソースに接続します。Amazon Bedrock および Google Cloud の Agent Platform とは異なり、Microsoft Foundry には対話型セットアップウィザードがないため、ステップ 3 およびステップ 4 の環境変数が唯一の設定方法です。
セットアップを確認するには、Claude Code 内で /status を実行します。API プロバイダー行に Microsoft Foundry が表示され、設定したリソース名またはベース URL が表示されます。
Azure RBAC 構成
Azure AI User および Cognitive Services User デフォルトロールには、Claude モデルを呼び出すために必要なすべての権限が含まれています。
より制限的な権限の場合は、以下を含むカスタムロールを作成します：
{
"permissions": [
{
"dataActions": [
"Microsoft.CognitiveServices/accounts/providers/*"
]
}
]
}
詳細については、Microsoft Foundry RBAC ドキュメントを参照してください。
1M トークンのコンテキストウィンドウ
Microsoft Foundry では、デプロイがどのモデルを提供しているかを Claude Code が判別できる場合、Fable モデル、Sonnet 5 以降、Opus 4.7 以降は、[1m] サフィックスを付けなくてもデフォルトで 1M トークンのコンテキストウィンドウで動作します。Claude Code は、モデル変数に指定されたデプロイ名からモデルを読み取ります。各デプロイには claude-opus-4-8 のようにモデル ID を名前として付けるか、modelOverrides でモデルをデプロイ名にマッピングしてください。モデルと照合できないデプロイ名の場合、別のウィンドウを宣言しない限り、Claude Code は 200K のウィンドウを想定します。
次の settings.json のエントリは、team-opus-prod という名前のデプロイが Opus 4.8 を提供していることを Claude Code に伝えます。
{
"modelOverrides": {
"claude-opus-4-8": "team-opus-prod"
}
}
代わりに 200K のウィンドウを維持するには、CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を設定します。
Opus 4.6 と Sonnet 4.6 は、サードパーティデプロイ向けにモデルを固定するで説明されているように、ANTHROPIC_DEFAULT_OPUS_MODEL または ANTHROPIC_DEFAULT_SONNET_MODEL のデプロイ名に [1m] を付加すると 1M のウィンドウを利用できます。v2.1.287 より前では、Microsoft Foundry 上の Fable モデルおよび Opus 4.7 以降でもこのサフィックスが必要で、付けない場合はデフォルトで 200K のウィンドウで動作していました。
トラブルシューティング
「Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed」というエラーが表示される場合：
- 環境で Entra ID を構成するか、
ANTHROPIC_FOUNDRY_API_KEYを設定してください。
最初のプロンプトで接続エラーが繰り返される場合、リクエストが失敗する場合：
ANTHROPIC_FOUNDRY_RESOURCEがプレースホルダーではなく、実際のリソース名に設定されていることを確認してください。Claude Code はこの値からエンドポイント URL を構築するため、不正な名前は存在しないホストを指します。