Microsoft Foundry에서 Claude Code 사용하기

설정, 구성, 문제 해결을 포함하여 Microsoft Foundry를 통해 Claude Code를 구성하는 방법을 알아보세요.

사전 요구사항

Microsoft Foundry로 Claude Code를 구성하기 전에 다음을 준비하세요:

• Microsoft Foundry에 접근 가능한 Azure 구독
• Microsoft Foundry 리소스 및 배포를 생성할 수 있는 RBAC 권한
• Azure CLI 설치 및 구성 (선택사항 - 자격 증명을 얻을 다른 방법이 없는 경우에만 필요)

참고: Claude Code를 여러 사용자에게 배포하는 경우, Anthropic이 새 모델을 출시할 때 중단을 방지하기 위해 모델 버전을 고정하세요.

설정

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. Endpoints and keys 섹션으로 이동합니다
3. API Key를 복사합니다
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를 활성화하려면 다음 환경 변수를 설정하세요:

# Enable Microsoft Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1

# Azure resource name (replace {resource} with your resource name)
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Or provide the full base URL:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic

4. 모델 버전 고정

주의: 모든 배포에 대해 특정 모델 버전을 고정하세요. 고정 없이 모델 별칭(sonnet, opus, haiku)을 사용하면, Anthropic이 업데이트를 출시할 때 Claude Code가 Foundry 계정에서 사용할 수 없는 최신 모델 버전을 사용하려고 시도하여 기존 사용자에게 문제가 발생할 수 있습니다. Azure 배포를 생성할 때 "최신 버전으로 자동 업데이트" 대신 특정 모델 버전을 선택하세요.

1단계에서 생성한 배포 이름과 일치하도록 모델 변수를 설정합니다:

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

현재 및 레거시 모델 ID는 모델 개요를 참조하세요. 전체 환경 변수 목록은 모델 구성을 참조하세요.

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를 설정하세요.

추가 리소스

• Microsoft Foundry 문서
• Microsoft Foundry 모델
• Microsoft Foundry 가격