Claude Code Microsoft Foundry設定ガイド
Claude CodeをMicrosoft Foundry経由で使うためのAzureリソース作成・認証方式・Azure RBAC設定・モデルピン留めを手順で確認します。
Microsoft Foundryとは何か
Microsoft FoundryはAzure上でClaudeモデルを含む各種モデルをデプロイ・運用するためのプラットフォームです。Claude CodeはAzureリソースにデプロイしたClaude Opus・Sonnet・Haikuの各モデルを、環境変数だけで呼び出せます。Amazon BedrockやGoogle Cloud's Agent Platformには対話的なセットアップウィザードがありますが、Microsoft Foundryには無く、手順3・4で設定する環境変数が唯一の設定経路です。
デプロイ時に選ぶホスティングオプション(Azure上で推論するか、Anthropicのインフラで推論するか)によって挙動が変わる点も、他のクラウド経由の接続と異なる特徴です。CLI本体ではなくVS Code拡張からサードパーティプロバイダーを使いたい場合は、VS Code拡張でサードパーティプロバイダーを使う設定を参照してください。
前提条件
Microsoft Foundryへのアクセスがあり、Foundryリソースとデプロイを作成できるRBAC権限を持つAzureサブスクリプションが必要です。ローカルでAzure CLIによる認証を使う場合は、Azure CLIのインストールと設定も済ませておきます(Azure CLIは他の認証手段がない場合のみ必須)。複数ユーザーに展開する場合は、後述の手順4でモデルバージョンを固定してから展開する構成を公式ドキュメントも案内しています。
1. Foundryリソースをプロビジョニングする
Microsoft Foundryポータルでリソースを新規作成し、リソース名を控えます。続けてClaude Opus・Claude Sonnet・Claude Haikuのデプロイを作成し、それぞれに付けたデプロイ名も控えます。このデプロイ名が手順4で環境変数に設定する値になります。
デプロイを構成するときは、ホスティングオプション(Azure上で推論するか、Anthropicインフラ上で推論するか)も選択します。どちらを選ぶかで推論の実行場所が変わるため、データレジデンシー要件がある組織は事前に確認してください。
2. Azure認証を構成する
Claude CodeはMicrosoft Foundryに対して3種類の認証方式に対応しています。セキュリティ要件に合う方式を選びます。
方式A: APIキー認証。Microsoft Foundryポータルのリソースで「Endpoints and keys」からAPIキーをコピーし、環境変数に設定します。
bash export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
方式B: Microsoft Entra ID認証。ANTHROPIC_FOUNDRY_API_KEYもANTHROPIC_FOUNDRY_AUTH_TOKENも設定していない場合、Claude CodeはAzure SDKの既定の認証情報チェーンを自動的に使います。ローカル環境ではaz loginを使うのが一般的です。
bash az login
方式C: ベアラートークン認証(Claude Code v2.1.203以降が必要)。ホストアプリケーションやサインインスクリプトなど、別のプロセスがすでにアクセストークンを取得済みの場合に使います。Claude Codeはこの値をリクエストごとにAuthorization: Bearerヘッダーとして送ります。
bash export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token
ANTHROPIC_FOUNDRY_AUTH_TOKENはANTHROPIC_FOUNDRY_API_KEYおよび既定の認証情報チェーンより優先されます。Microsoft Foundryを使う場合、認証はAzure認証情報で扱われるため/logoutコマンドは使えません。
3. Claude Codeの環境変数を設定する
Microsoft Foundry統合を有効にする環境変数を設定します。
bash export CLAUDE_CODE_USE_FOUNDRY=1 export ANTHROPIC_FOUNDRY_RESOURCE={resource}
{resource}の部分は手順1で控えたリソース名に置き換えます。フルのベースURLを直接指定したい場合は、代わりにANTHROPIC_FOUNDRY_BASE_URLを設定します(例: https://{resource}.services.ai.azure.com/anthropic)。
4. モデルバージョンを固定する
モデルのエイリアスを固定しないと、opusエイリアスはMicrosoft Foundry上でOpus 4.6に解決されます。手順1で作成したデプロイ名に合わせて、モデル変数を設定します。
bash 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'
Microsoft Foundryには起動時のモデル可用性チェックがありません。デフォルトが使えない場合、Amazon BedrockやGoogle Cloud's Agent Platformのように自動フォールバックせず、リクエストがそのまま失敗します。Azureデプロイを作成するときも「auto-update to latest」ではなく特定のモデルバージョンを選ぶ構成を公式ドキュメントは案内しています。
セッションタイトル生成などのバックグラウンドタスクは通常Haikuクラスのモデルが担いますが、Microsoft FoundryではすべてのアカウントにHaikuデプロイがあるとは限らないため、既定ではプライマリモデルが代わりに使われます。Haikuを使いたい場合はANTHROPIC_DEFAULT_HAIKU_MODELにアカウントで使えるHaikuデプロイを指定してください。
プロンプトキャッシュは追加設定なしで自動的に有効になります。既定のTTLは5分ですが、ENABLE_PROMPT_CACHING_1H=1を設定すると1時間に延長できます。1時間TTLのキャッシュ書き込みは単価が高いため、長時間のセッションでキャッシュヒット率を優先する場合にのみ有効にしてください。
5. Claude Codeを起動して確認する
環境変数を設定したら、プロジェクトディレクトリでClaude Codeを起動します。
bash claude
Claude Codeは環境変数CLAUDE_CODE_USE_FOUNDRYと関連する変数を読み込み、最初のプロンプトでAzureリソースに接続します。設定を確認するには/statusを実行します。APIプロバイダー行にMicrosoft Foundryと、設定したリソース名かベースURLが表示されます。想定と違うリソース名やモデルが表示された場合は、手順3・4の環境変数の設定値を見直してください。
Azure RBACの設定
Claudeモデルを呼び出すために必要な権限は、既定ロールのAzure AI UserまたはCognitive Services Userに含まれています。より限定した権限にしたい場合は、次のカスタムロールを作成します。
{
"permissions": [
{
"dataActions": [
"Microsoft.CognitiveServices/accounts/providers/*"
]
}
]
}| ロール | 用途 |
|---|---|
Azure AI User | 用途Claudeモデル呼び出しに必要な権限一式を含む既定ロール |
Cognitive Services User | 用途同じく既定ロール。組織の権限体系に応じてどちらかを使う |
| カスタムロール(上記JSON) | 用途Microsoft.CognitiveServices/accounts/providers/*のみに絞った最小権限 |
つまずきやすいポイント
「Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed」というエラーが出る場合、環境にEntra IDの認証情報が構成されていないか、ANTHROPIC_FOUNDRY_API_KEYが未設定です。方式Aか方式Bのどちらかを明示的に設定してください。
最初のプロンプトで接続エラーが繰り返される場合は、ANTHROPIC_FOUNDRY_RESOURCEが実在するリソース名になっているかを確認します。プレースホルダーのまま残っていると存在しないホストへ接続しようとして失敗し続けます。
モデルが呼び出せない場合、起動時チェックが無い分、原因がAzure側のデプロイ未作成なのか認証情報の権限不足なのか自分で切り分ける必要があります。まず/statusでリソース名と選択されているモデルを確認し、次にMicrosoft Foundryポータルでそのデプロイ名が実在するかを確認する順番が近道です。
まとめ
Microsoft Foundry経由でClaude Codeを使う設定は、①Foundryポータルでのリソース作成とモデルデプロイ ②APIキー・Entra ID・ベアラートークンいずれかの認証構成 ③CLAUDE_CODE_USE_FOUNDRYとリソース名の環境変数設定 ④モデルバージョンの固定、の4手順で完結します。起動時チェックが無いことだけは念頭に置き、モデルバージョンは展開前に必ず固定してください。AWSやGCP経由の選択肢とIAM権限設計を比較したい場合は、Claude Code Vertex AI IAM設定とチーム展開ガイドとClaude Code Bedrock Mantleエンドポイントの使い方も参考になります。
よくある質問
Microsoft Foundry経由で使うとき/logoutコマンドが使えないのはなぜですか
Microsoft Foundryを使う場合、認証はAzure側の認証情報(APIキー・Entra ID・ベアラートークン)で扱われ、Claude Code側にログインセッションという概念がないためです。認証を切り替えたい場合は、環境変数を設定し直すかaz logoutでAzure側のログイン状態を変更します。
3つの認証方式を同時に設定した場合どれが使われますか
ANTHROPIC_FOUNDRY_AUTH_TOKENが最優先です。次にANTHROPIC_FOUNDRY_API_KEYが優先され、どちらも未設定のときだけAzure SDKの既定の認証情報チェーンが使われます。
ホスティングオプションの選択はClaude Code側の設定に影響しますか
公式ドキュメントは、デプロイ作成時に選ぶホスティングオプション(Azure上かAnthropicインフラ上か)が推論の実行場所を左右するとしていますが、Claude Code側の環境変数設定はホスティングオプションによって変わりません。設定はAzure側のデプロイ作成時点で完結します。
モデルバージョンを固定しないとどうなりますか
opusエイリアスはMicrosoft Foundry上でOpus 4.6に解決されます。起動時の可用性チェックが無いため、指定したエイリアスやモデルIDに対応するデプロイが存在しないとリクエストがそのまま失敗します。チーム展開前にANTHROPIC_DEFAULT_OPUS_MODELなどで明示的に固定しておくことを公式ドキュメントも推奨しています。