메인 콘텐츠로 건너뛰기

​
필수 조건

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에 대해 두 가지 인증 방법을 지원합니다. 보안 요구 사항에 가장 적합한 방법을 선택하세요. 옵션 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를 사용할 때 /login 및 /logout 명령은 Azure 자격 증명을 통해 인증이 처리되므로 비활성화됩니다.

​
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를 설정합니다.

​
추가 리소스