Claude Code on Microsoft Foundry

前提条件

• Microsoft Foundry へのアクセス権を持つ Azure サブスクリプション
• Microsoft Foundry リソースとデプロイメントを作成するための RBAC 権限
• Azure CLI がインストールされ、構成されている（オプション - 認証情報を取得する別のメカニズムがない場合のみ必要）

セットアップ

1. Microsoft Foundry リソースをプロビジョニングする

1. Microsoft Foundry ポータルに移動します
2. 新しいリソースを作成し、リソース名をメモします
3. Claude モデルのデプロイを作成します。各デプロイに付与する名前をメモしてください。ステップ 4 でこれらの名前をモデル変数として設定します：
   • Claude Opus
   • Claude Sonnet
   • Claude Haiku
   デプロイを設定する際に、ホスティングオプションも選択します。これにより、推論が Azure で実行されるか、Anthropic インフラストラクチャで実行されるかが決まります。

2. Azure 認証情報を構成する

• API キー：Microsoft Foundry ポータルからキーをコピーし、ANTHROPIC_FOUNDRY_API_KEY として設定します
• Microsoft Entra ID：Claude Code は Azure SDK のデフォルト認証情報チェーンを通じて（たとえば az login セッションから）トークンを取得するため、API キーを保存する必要がありません
• ベアラートークン：別のプロセスが Microsoft Entra ID アクセストークンを取得し、それを ANTHROPIC_FOUNDRY_AUTH_TOKEN で渡します

API キーを使用する

1. Microsoft Foundry ポータルでリソースに移動します
2. Endpoints and keys セクションを開きます
3. API キーをコピーします
4. 環境変数を設定します。your-azure-api-key をコピーしたキーに置き換えます：

export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

Microsoft Entra ID を使用する

az login

ベアラートークンを使用する

export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

3. Claude Code を構成する

# 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

4. モデルバージョンをピン留めする

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'

export ENABLE_PROMPT_CACHING_1H=1

5. Claude Code を実行する

claude

Azure RBAC 構成

1M トークンのコンテキストウィンドウ

{
  "modelOverrides": {
    "claude-opus-4-8": "team-opus-prod"
  }
}

トラブルシューティング

• 環境で Entra ID を構成するか、ANTHROPIC_FOUNDRY_API_KEY を設定してください。

• ANTHROPIC_FOUNDRY_RESOURCE がプレースホルダーではなく、実際のリソース名に設定されていることを確認してください。Claude Code はこの値からエンドポイント URL を構築するため、不正な名前は存在しないホストを指します。

その他のリソース

• Microsoft Foundry ドキュメント
• Microsoft Foundry モデル
• Microsoft Foundry 価格