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

​

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

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

export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

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 構成

{
  "permissions": [
    {
      "dataActions": [
        "Microsoft.CognitiveServices/accounts/providers/*"
      ]
    }
  ]
}

​

トラブルシューティング

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

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

​

その他のリソース

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