메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
필수 조건

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. 엔드포인트 및 키 섹션으로 이동합니다
  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를 활성화하려면 다음 환경 변수를 설정합니다: 
# 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. 모델 버전 고정

모든 배포에 대해 특정 모델 버전을 고정합니다. 고정하지 않고 모델 별칭(sonnet, opus, haiku)을 사용하면 Claude Code가 Foundry 계정에서 사용할 수 없는 최신 모델 버전을 사용하려고 시도하여 Anthropic이 업데이트를 출시할 때 기존 사용자가 중단될 수 있습니다. Azure 배포를 만들 때 “최신으로 자동 업데이트” 대신 특정 모델 버전을 선택합니다.
모델 변수를 1단계에서 만든 배포 이름과 일치하도록 설정합니다. ANTHROPIC_DEFAULT_OPUS_MODEL이 없으면 Foundry의 opus 별칭은 Opus 4.6으로 확인됩니다. 최신 모델을 사용하려면 Opus 4.7 ID로 설정합니다: 
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-7'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
백그라운드 작업(예: 세션 제목 생성)은 일반적으로 Haiku 클래스 모델인 소형/빠른 모델을 사용합니다. Foundry에서 Claude Code는 모든 계정이 Haiku 배포를 가지고 있지 않기 때문에 기본 모델로 기본 설정됩니다. 백그라운드 작업에 Haiku를 사용하려면 위에 표시된 대로 ANTHROPIC_DEFAULT_HAIKU_MODEL을 계정에서 사용 가능한 Haiku 배포로 설정합니다. 현재 및 레거시 모델 ID는 모델 개요를 참조하세요. 전체 환경 변수 목록은 모델 구성을 참조하세요. Prompt caching은 자동으로 활성화됩니다. 기본 5분 대신 1시간 캐시 TTL을 요청하려면 다음 변수를 설정합니다. 1시간 TTL로 캐시 쓰기는 더 높은 요금으로 청구됩니다: 
export ENABLE_PROMPT_CACHING_1H=1

​
5. Claude Code 실행

환경 변수가 설정되면 프로젝트 디렉터리에서 Claude Code를 시작합니다: 
claude
Claude Code는 환경에서 CLAUDE_CODE_USE_FOUNDRY 및 기타 Foundry 변수를 읽고 첫 번째 프롬프트에서 Azure 리소스에 연결합니다. Bedrock 및 Vertex AI와 달리 Foundry는 대화형 설정 마법사가 없으므로 3단계와 4단계의 환경 변수가 유일한 구성 경로입니다.

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

​
추가 리소스