Anthropic 클로드 모델은 고급 대화형 AI 기능을 Microsoft Foundry를 제공하여 최첨단 언어 이해 및 생성을 통해 지능형 애플리케이션을 빌드할 수 있도록 합니다. Claude 모델은 이미지 분석을 비롯한 복잡한 추론, 코드 생성 및 멀티모달 작업에 탁월합니다.
이 문서에서는 다음 방법을 알아봅니다.
- Microsoft Foundry에서 Claude 모델 배포
- Microsoft Entra ID 또는 API 키를 사용하여 인증
- Python, JavaScript 또는 REST에서 Claude Messages API 호출
사용 가능한 모델, 모델 버전 및 기능은 Microsoft Foundry의 Claude 모델을 참조하세요. 구독 유형별 기본 할당량은 Claude 모델 할당량 및 속도 제한을 참조하세요.
중요
이 문서에서 미리 보기로 표시된 항목은 현재 미리 보기로 제공됩니다. 이 미리 보기는 서비스 수준 계약 없이 제공되며 Microsoft 프로덕션 워크로드에 권장하지 않습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.
필수 구성 요소
- 유효한 결제 방법이 있는 Azure 구독입니다. Azure 구독이 없는 경우 지불 Azure 계정 만듭니다. 자세한 내용은 구독 유형 및 지역 지원을 참조하세요.
- 리소스를 만들고 관리할 수 있는 적절한 권한이 있는 Microsoft Foundry에 액세스합니다.
- 지원되는 배포 위치에서 만든 Microsoft Foundry 프로젝트입니다. 모든 Claude 모델(Azure 호스트되고 Anthropic 인프라에서 호스팅됨)은 글로벌 표준 배포를 지원합니다. 일부 Claude 모델의 Azure 버전의 호스트는 미국(데이터 영역 표준) 배포에도 사용할 수 있습니다. Claude 모델을 배포에 사용할 수 있는 정확한 Azure 지역은 배포 유형별 지역 가용성을 참조하세요.
- 파트너 및 커뮤니티의 Foundry 모델은 구독을 생성하기 위해 Azure Marketplace에 액세스해야 합니다. 모델 제품을 구독하는 데 필요한 권한이 있는지 확인합니다.
- 모델을 배포할 리소스 그룹의 기여자 또는 소유자 역할입니다. 자세한 내용은 Azure RBAC 역할 참조하세요.
구독 유형 및 지역 지원
Microsoft Foundry에서 Claude 모델을 사용하려면 Anthropic 구매 모델을 제공하는 국가 또는 지역의 청구 계정이 있는 유료 Azure 구독이 있어야 합니다. 일반적인 구독 관련 오류 목록은 일반적인 오류 메시지 및 솔루션을 참조하세요. 현재 지원되지 않는 구독 유형은 다음과 같습니다.
- 한국에 있는 엔터프라이즈 계정
- 클라우드 솔루션 공급자 구독
- Azure 구독 중 활성 종량제 요금제가 없는 것(예: 학생, 무료 평가판, 스타트업 크레딧 기반 계정)
- Azure 크레딧만 사용하는 스폰서 구독 참고: 신용 카드가 등록된 계정을 사용할 경우, Azure 크레딧 대신 신용 카드로 비용이 청구됩니다.
지원되는 지역 목록은 지원되는 지리적 위치를 참조하세요. Anthropic "지원되는 지역 정책"이 해당 지역의 가용성에 적용될 수 있습니다. 자세한 내용은 지원 지역을 확인하세요.
클로드 온 파운드리 스타터 키트 사용
코드로서의 인프라 도구를 사용하여 Microsoft Foundry에서 Claude 모델을 배포하려면 Bicep 또는 Terraform을 사용하여 Microsoft Foundry에서 Claude 모델 배포를 참조하세요. 이 문서는 Claude on Foundry 시작 키트를 기반으로 하며, Foundry 계정 및 프로젝트를 프로비전하고, 선택한 Claude 모델을 배포하고, Bicep 또는 Terraform 자동화를 사용하여 Microsoft Entra ID 또는 API 키로 인증을 구성하는 방법을 설명합니다.
Claude 모델 배포
Foundry 포털에서 다음 단계를 수행하여 Claude 모델을 배포합니다.
-
Microsoft Foundry에 로그인합니다. New Foundry 토글이 설정되었는지 확인합니다. 이러한 단계는 Foundry(신규)를 참조합니다.
Foundry 포털 홈페이지에서 오른쪽 위 탐색 창에서 검색 을 선택한 다음, 왼쪽 창에서 모델을 선택합니다.
Claude 모델을 선택하고 모델 카드에서 세부 정보를 검토합니다. 두 버전 모두에서 모델을 사용할 수 있는 경우 기본적으로 모델의 Azure(버전 2) 버전에 호스트됩니다. 모델 카드의 빠른 정보 창에서 호스팅 위치 정보를 찾아 현재 열려 있는 버전을 확인할 수 있습니다.
Tip
선택한 Claude 모델을 두 버전에서 모두 사용할 수 있는 경우 모델 카드에는 모델의 대체 버전으로 연결되는 링크가 포함됩니다.
사용자 지정 설정>를 선택하여 배포를 사용자 지정합니다.
Azure Marketplace 약관을 읽고, 업계를 선택하고, 동의를 선택하고 계속 진행하여 Azure Marketplace 구독하는 약관에 동의합니다.
두 버전을 모두 사용할 수 있는 경우 배포 페이지에는 모델 버전이 기본적으로 Azure 호스트되는 버전 2로 설정됩니다. 원하는 경우 이 선택을 1: Anthropic 인프라에서 호스팅됨(으)로 변경하세요.
참고
기본 설정> 옵션을 선택하면 배포가 자동으로 버전 2로 설정됩니다. Azure 호스트됩니다.
다른 배포 설정을 구성합니다.
- 기본적으로 배포는 모델 이름을 사용합니다. 배포하기 전에 이 이름을 수정할 수 있습니다. 유추하는 동안 매개 변수의 배포 이름을
model사용하여 요청을 이 특정 배포로 라우팅합니다. - 지역 범위: 전역(모든 Claude 모델 및 버전에 사용 가능) 또는 데이터 영역(모델 및 버전 조합에 사용할 수 있는 경우)을 선택합니다.
- 기본적으로 배포는 모델 이름을 사용합니다. 배포하기 전에 이 이름을 수정할 수 있습니다. 유추하는 동안 매개 변수의 배포 이름을
배포를 선택하여 배포를 만듭니다.
배포가 완료되면 모델을 대화형으로 테스트할 수 있는 Foundry Playgrounds 에 배치됩니다. 프로젝트 및 리소스는 모델에 대해 지원되는 배포 지역 중 하나에 있어야 합니다.
세부 정보 탭을 선택하여 배포 세부 정보를 확인하고 배포 상태가 성공으로 표시되는지 확인합니다.
Claude 메시지 API 호출
Claude 모델을 배포한 후 상호 작용하여 텍스트 응답을 생성합니다.
다음과 같은 Anthropic SDK 및 Claude API를 사용합니다.
지원되는 API에 대한 자세한 내용은 Microsoft Foundry의 Claude 모델을 참조하세요.
인증을 사용하여 메시지 보내기
다음 예제에서는 Microsoft Entra ID 또는 API 키 인증을 사용하여 Claude Sonnet 4.6에 요청을 보내는 방법을 보여 줍니다. 배포된 모델을 작업하려면 다음이 필요합니다.
- 기본 URL(형식
https://<resource name>.services.ai.azure.com/anthropic)입니다. - 배포 세부 정보의
https://<resource name>.services.ai.azure.com/anthropic/v1/messages형식인 대상 URI입니다. - Microsoft Entra ID로 키 없는 인증을 하거나, API 인증을 위한 배포의 API 키를 사용합니다.
- 배포를 만드는 동안 선택한 배포 이름입니다. 이 이름은 모델 ID와 다를 수 있습니다.
Claude 모델의 고급 기능 및 기능은 Microsoft Foundry의 Claude 모델을 참조하세요.
Microsoft Entra ID 인증 사용
메시지 API 엔드포인트에서는 기본 URL과 Microsoft Entra ID 인증을 사용합니다.
Azure ID 클라이언트 라이브러리를 설치합니다:
DefaultAzureCredential사용하도록 이 라이브러리를 설치합니다. 권한 부여는DefaultAzureCredential를 사용할 때 가장 쉽습니다. 이는 실행 중인 환경에서 사용할 최상의 자격 증명을 찾기 때문입니다.pip install azure-identityMicrosoft Entra ID 애플리케이션의 클라이언트 ID, 테넌트 ID 및 클라이언트 암호 값을 환경 변수로 설정합니다.
AZURE_CLIENT_ID,AZURE_TENANT_ID,AZURE_CLIENT_SECRET.export AZURE_CLIENT_ID="<AZURE_CLIENT_ID>" export AZURE_TENANT_ID="<AZURE_TENANT_ID>" export AZURE_CLIENT_SECRET="<AZURE_CLIENT_SECRET>"종속성 제거: pip를 사용하여 Anthropic SDK를 설치합니다(Python 3.8 이상 필요).
pip install -U "anthropic"기본 코드 샘플을 실행 하여 다음 작업을 완료합니다.
- Microsoft Entra ID 인증을 사용하여 Anthropic SDK를 사용하여 클라이언트를 만듭니다.
- 메시지 API에 대한 기본 호출을 만듭니다. 호출이 동기적입니다.
from anthropic import AnthropicFoundry from azure.identity import DefaultAzureCredential, get_bearer_token_provider baseURL = "https://<resource-name>.services.ai.azure.com/anthropic" # Your base URL. Replace <resource-name> with your resource name deploymentName = "claude-sonnet-4-6" # Replace with your deployment name # Create token provider for Entra ID authentication tokenProvider = get_bearer_token_provider( DefaultAzureCredential(), "https://ai.azure.com/.default" ) # Create client with Entra ID authentication client = AnthropicFoundry( azure_ad_token_provider=tokenProvider, base_url=baseURL ) # Send request message = client.messages.create( model=deploymentName, messages=[ {"role": "user", "content": "What are 3 things to visit in Seattle?"} ], max_tokens=1048, temperature=1, thinking={"type":"adaptive"}, output_config={"effort": "max"}, stream=False ) print(message.content)예상 출력: 세 가지 시애틀 권장 사항이 포함된 모델의 텍스트 완성을 포함하는 JSON 응답입니다.
Reference:Anthropic 클라이언트 SDK, DefaultAzureCredential
API 키 인증 사용
중요
Claude Mythos 5-1, Mythos 5 및 Mythos Preview는 Microsoft Entra ID 인증만 지원합니다.
메시지 API 엔드포인트의 경우 기본 URL 및 API 키를 사용하여 서비스에 대해 인증합니다.
종속성 제거: pip를 사용하여 Anthropic SDK를 설치합니다(Python 3.8 이상 필요).
pip install -U "anthropic"기본 코드 샘플을 실행 하여 다음 작업을 완료합니다.
- API 키를 SDK의 구성에 전달하여 Anthropic SDK를 사용하여 클라이언트를 만듭니다. 이 인증 방법을 사용하면 서비스와 원활하게 상호 작용할 수 있습니다.
- 메시지 API에 대한 기본 호출을 만듭니다. 호출이 동기적입니다.
from anthropic import AnthropicFoundry baseURL = "https://<resource-name>.services.ai.azure.com/anthropic" # Your base URL. Replace <resource-name> with your resource name deploymentName = "claude-sonnet-4-6" # Replace with your deployment name apiKey = "YOUR_API_KEY" # Replace YOUR_API_KEY with your API key # Create client with API key authentication client = AnthropicFoundry( api_key=apiKey, base_url=baseURL ) # Send request message = client.messages.create( model=deploymentName, messages=[ {"role": "user", "content": "What are 3 things to visit in Seattle?"} ], max_tokens=1048, temperature=1, thinking={"type":"adaptive"}, output_config={"effort": "max"}, stream=False ) print(message.content)예상 출력: 세 가지 시애틀 권장 사항이 포함된 모델의 텍스트 완성을 포함하는 JSON 응답입니다.
리퍼런스:Anthropic 클라이언트 SDK
문제 해결
다음 표에서는 Foundry 및 해당 솔루션에서 Claude 모델을 사용할 때 발생하는 일반적인 오류를 나열합니다.
| 오류 | 원인 | 솔루션 |
|---|---|---|
| 401 권한 없음 | 유효하지 않거나 만료된 API 키 또는 잘못된 Entra ID 토큰 범위입니다. | API 키가 올바른지 확인합니다. Entra ID에 대해 범위 https://ai.azure.com/.default를 사용하는지 확인하십시오. |
| 403 금지됨 | 리소스 또는 구독에 대한 권한이 부족합니다. | 리소스 그룹에 기여자 또는 소유자 역할이 있는지 확인합니다. Entra ID 경우 Cognitive Services 사용자 역할이 할당되었는지 확인합니다. |
| 404 찾을 수 없음 | 잘못된 엔드포인트 URL 또는 배포 이름입니다. | 기본 URL이 패턴을 https://<resource-name>.services.ai.azure.com/anthropic 따르고 배포 이름이 구성과 일치하는지 확인합니다. |
| 429 요청이 너무 많음 | 구독 계층에 대한 속도 제한을 초과했습니다. | 재시도 논리를 사용하여 지수 백오프를 구현합니다. 요청 빈도를 줄이거나 할당량 증가를 요청하는 것이 좋습니다. |
데이터 보존 필요(400 invalid_request_error) |
이 모델은 데이터 보존이 필요한 Anthropic에서 지정한 적용 대상 모델이지만, 회원님의 구독에는 데이터 미보존(ZDR)이 활성화되어 있습니다. 업스트림 Anthropic 메시지에는 "조직 또는 작업 영역에 데이터 보존이 활성화되어 있어야 합니다"라는 메시지가 표시되지만 Foundry에서는 이 설정이 구독에 적용됩니다. | Anthropic Azure Claude에 대한 데이터 보존을 독립적으로 관리하므로 Microsoft 이 설정을 변경할 수 없습니다. 모델을 사용하려면 Anthropic 직접 작업하여 구독에 대해 ZDR을 사용하지 않도록 설정하거나 새 구독을 만들고(새 구독에서 기본적으로 데이터 보존이 사용하도록 설정됨) 모델을 배포합니다. 배경은 적용 대상 모델에 대한 데이터 보존 사례를 참조하세요. |
| 구독 자격 오류 | Azure 구독 유형 또는 청구 지역이 지원되지 않거나 구독 계층에 모델에 대한 기본 할당량이 0입니다. | 구독에 활성 종량제 청구 방법 및 지원되는 청구 국가/지역이 있는지 확인합니다. 구독 유형 및 지역 지원을 참조하세요. 계층별 기본 제한은 Claude 모델 할당량 및 속도 제한을 참조하세요. |
| 지역을 사용할 수 없음 | 지원되지 않는 지역에서 배포를 시도했습니다. | 사용 중인 특정 Claude 모델에 대해 지원되는 Azure 지역에 배포합니다. 모델을 사용할 수 있는 정확한 Azure 지역은 배포 유형별 지역 가용성을 참조하세요. |
베타 헤더를 포함하고 context-1m-2025-08-07 200K보다 큰 토큰을 요청하는 경우 Claude Sonnet 4.5에 대한 요청이 실패합니다. |
Claude Sonnet 4.5의 1M 컨텍스트 베타는 2026년 4월 30일에 사용 중지되었습니다. 2026년 5월 1일부터 context-1m-2025-08-07 베타 헤더를 포함한 요청 중 토큰 수가 200K를 초과하는 요청은 거부됩니다. |
요청에서 context-1m-2025-08-07 베타 헤더를 제거합니다. 1M 컨텍스트가 필요한 워크로드의 경우 더 높은 인텔리전스 워크로드를 위해 Claude Sonnet 4.6 (1M 컨텍스트가 일반 공급되는 경우) 또는 Claude Opus 4.6 또는 Claude Opus 5 로 마이그레이션합니다. Claude Sonnet 4.5에 대한 200K 토큰 이하의 요청은 헤더가 있는 경우에도 영향을 받지 않습니다. |