メインコンテンツへスキップ

前提条件

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

セットアップ

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

まず、AzureでClaudeリソースを作成します:
  1. Microsoft Foundryポータルに移動します
  2. 新しいリソースを作成し、リソース名をメモします
  3. Claudeモデルのデプロイメントを作成します:
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

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

Claude CodeはMicrosoft Foundryの2つの認証方法をサポートしています。セキュリティ要件に最適な方法を選択してください。 オプションA:APIキー認証
  1. Microsoft Foundryポータルでリソースに移動します
  2. エンドポイントとキーセクションに移動します
  3. APIキーをコピーします
  4. 環境変数を設定します:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
オプションB:Microsoft Entra ID認証 ANTHROPIC_FOUNDRY_API_KEYが設定されていない場合、Claude CodeはAzure SDKデフォルト認証情報チェーンを自動的に使用します。 これは、ローカルおよびリモートワークロードを認証するためのさまざまな方法をサポートしています。 ローカル環境では、一般的にAzure CLIを使用できます:
az login
Microsoft Foundryを使用する場合、認証がAzure認証情報を通じて処理されるため、/loginおよび/logoutコマンドは無効になります。

3. Claude Codeを構成する

Microsoft Foundryを有効にするには、以下の環境変数を設定します。デプロイメント名は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

# モデルをリソースのデプロイメント名に設定します
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-1'
モデル構成オプションの詳細については、モデル構成を参照してください。

Azure RBAC構成

Azure AI UserおよびCognitive Services Userデフォルトロールには、Claudeモデルを呼び出すために必要なすべての権限が含まれています。 より制限的な権限の場合は、以下を含むカスタムロールを作成します:
{
  "permissions": [
    {
      "dataActions": [
        "Microsoft.CognitiveServices/accounts/providers/*"
      ]
    }
  ]
}
詳細については、Microsoft Foundry RBACドキュメントを参照してください。

トラブルシューティング

「Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed」というエラーが表示される場合:
  • 環境でEntra IDを構成するか、ANTHROPIC_FOUNDRY_API_KEYを設定してください。

その他のリソース