Claude Platform Docs
Messages클라우드 플랫폼의 Claude

Amazon Bedrock의 Claude (Opus 4.7 이상)

AWS 네이티브 인증, 청구 및 보안 경계를 통해 Amazon Bedrock에서 Claude 모델에 액세스하세요.

이 가이드는 Amazon Bedrock에서 Claude를 설정하고 API 호출을 수행하는 과정을 안내합니다. Amazon Bedrock의 Claude는 운영자 액세스가 전혀 없는(Anthropic 직원은 추론 인프라에 액세스할 수 없음) AWS 관리형 인프라에서 실행되므로, Anthropic의 자사 API에서 사용하는 것과 동일한 Messages API 형태를 사용하면서도 민감한 애플리케이션을 AWS 보안 경계 내에서 완전히 구축할 수 있습니다.

액세스

Amazon Bedrock은 각 Claude 모델에 대해 개별적으로 액세스 기준을 설정합니다. Claude Fable 5.1, Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5, Claude Opus 4.7 및 Claude Haiku 4.5는 모든 Amazon Bedrock 고객에게 개방되어 있습니다. 다른 모델의 현재 기준은 AWS 콘솔의 Amazon Bedrock 모델 액세스에서 확인하세요. Claude Mythos Preview는 Project Glasswing을 통한 초대가 필요합니다. 리전 가용성은 리전을 참조하세요.

사전 요구 사항

시작하기 전에 다음을 갖추었는지 확인하세요:

Claude Mythos Preview는 추가로 Bedrock Marketplace 팀이 허용 목록에 등록한 전용 AWS 계정이 필요합니다. Anthropic 계정 담당자가 허용 목록 등록을 위해 계정 ID를 제출할 수 있으며(일반적으로 24시간 이내 처리), 완료되면 AWS에서 환영 이메일을 보냅니다.

인증

Amazon Bedrock의 Claude는 세 가지 인증 경로를 지원합니다. 보안 요구 사항에 가장 적합한 것을 선택하세요.

가장 안전하고 장기적인 액세스를 위해 AWS 관리형 키와 함께 Bedrock 서비스 역할을 사용하세요:

  1. 관리자: 서비스 역할 프로비저닝

    AWS 관리자가 Bedrock 서비스 역할을 프로비저닝하고 개발자에게 서비스 역할 ARN에 대한 iam:PassRole 권한을 부여합니다.

  2. 개발자: 역할 전달

    API를 호출할 때 Bedrock이 사용자를 대신하여 서비스 역할을 수임합니다. 역할을 요청과 연결하는 방법은 Amazon Bedrock 문서를 참조하세요.

IAM 수임 역할

최대 12시간 세션의 ID 페더레이션 액세스의 경우:

  1. 관리자: IAM 역할 구성

    Claude 모델로 범위가 지정된 IAM 역할을 생성합니다. 신뢰 정책은 ID 공급자(SAML, OIDC 또는 AWS Identity Center)를 지정합니다. 권한 정책은 허용된 모델 ARN에 대해서만 bedrock-mantle:CreateInference를 부여합니다.

  2. 개발자: 인증 및 수임

    회사 ID 공급자를 통해 인증한 다음 IAM 역할을 수임합니다. AWS STS가 SDK 또는 CLI에서 요청 서명에 사용하는 임시 자격 증명을 발급합니다.

Bearer 토큰

IAM 역할 없이 단기 액세스하는 경우(최대 12시간, 가장 권장되지 않음):

  1. 관리자: 토큰 유형 제한

    bedrock:BearerTokenType 조건이 단기 토큰과 일치하지 않는 한 bedrock:CallWithBearerToken을 거부하는 정책을 연결하여 장기 키를 차단합니다.

  2. 개발자: 토큰 발급

    aws-bedrock-token-generator CLI를 사용하여 bearer 토큰을 발급합니다. 각 요청의 x-api-key 헤더에 전달하세요.

SDK 설치

Anthropic의 클라이언트 SDK는 Bedrock 전용 패키지 또는 모듈을 통해 Amazon Bedrock의 Claude를 지원합니다.

pip install -U "anthropic[bedrock]"

첫 번째 요청 보내기

엔드포인트는 https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages 패턴을 따릅니다. InvokeModel 기반 통합과 달리, 이 엔드포인트는 표준 SSE 스트리밍과 Anthropic의 자사 API와 동일한 요청 본문 형태를 사용합니다.

SDK는 표준 AWS 우선순위에 따라 자격 증명과 리전을 확인합니다: 생성자 인수, 그다음 환경 변수(AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), 그다음 AWS 구성 파일 및 자격 증명 체인(SSO, 수임 역할, ECS 태스크 역할, IMDS) 순입니다.

from anthropic import AnthropicBedrockMantle

client = AnthropicBedrockMantle(aws_region="us-east-1")

message = client.messages.create(
    model="anthropic.claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(next(block.text for block in message.content if block.type == "text"))

지원 모델

Amazon Bedrock의 Claude 모델 ID에는 anthropic. 공급자 접두사가 붙습니다. 모델 기능 및 동작은 모델 개요 페이지에 문서화되어 있습니다.

모델모델 ID액세스
Claude Fable 5.1개방
Claude Fable 5개방
Claude Opus 5액세스 참조
Claude Opus 4.8개방
Claude Opus 4.7개방
Claude Sonnet 5anthropic.claude-sonnet-5개방
Claude Haiku 4.5개방
Claude Mythos Preview초대 전용 (Project Glasswing)

Amazon Bedrock에서 Claude Fable 5.1을 사용하려면 Claude Code 2.1.255 이상을 사용하세요. 업그레이드하려면 claude update를 실행하세요.

기능 지원

Amazon Bedrock 가용성이 포함된 전체 기능 목록은 기능 개요를 참조하세요.

주요 지원 기능

지원되지 않는 기능

  • 구조화된 출력
  • 입력 소스 (이미지 및 문서용 URL 소스, Files API)
  • 서버 측 도구 (코드 실행, 웹 검색, 웹 가져오기, 어드바이저)
  • 에이전트 인프라 (Agent Skills, MCP 커넥터, 프로그래매틱 도구 호출)
  • API 엔드포인트 (Message Batches, Models, Admin, Compliance, Usage and Cost)
  • Claude Managed Agents
  • 서버 측 폴백 (fallbacks 파라미터; 대신 클라이언트 측 폴백 패턴을 사용하세요)
  • 컴퓨터 사용 및 브라우저 사용 도구 세트 (computer_toolset_20260801 및 browser_toolset_20260801은 현재 Amazon Bedrock에서 사용할 수 없으며, 베타 컴퓨터 사용 도구 버전은 계속 사용할 수 있습니다)

리전

Amazon Bedrock의 Claude는 다음 AWS 리전에서 사용할 수 있습니다. Amazon Bedrock은 두 가지 엔드포인트 유형을 제공합니다:

  • 글로벌: 최대 가용성을 위해 사용 가능한 모든 리전에 걸쳐 동적 라우팅합니다. 가격 프리미엄이 없습니다.
  • 리전별: 데이터 레지던시 요구 사항을 위해 엔드포인트가 지정한 단일 AWS 리전으로 확인됩니다. 리전별 엔드포인트는 글로벌 엔드포인트 대비 10%의 가격 프리미엄이 있습니다. 한 지역 내 여러 리전에 걸쳐 라우팅하려면 추론 프로필(US, EU, JP 또는 AU)을 사용하세요. 표에서 In-region only로 표시된 리전은 추론 프로필 없이 직접 단일 리전 라우팅을 지원합니다.

글로벌 엔드포인트는 Claude Fable 5.1, Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 및 Claude Haiku 4.5에서 사용할 수 있습니다. Claude Fable 5.1의 경우 리전별 엔드포인트는 현재 us-east-1에서만 사용할 수 있습니다. Claude Mythos Preview는 리전별 전용이며 us-east-1에서 사용할 수 있습니다.

AWS 리전위치엔드포인트 유형
af-south-1아프리카 (케이프타운)Global
ap-northeast-1아시아 태평양 (도쿄)Global, JP, In-region only
ap-northeast-2아시아 태평양 (서울)Global
ap-northeast-3아시아 태평양 (오사카)Global, JP
ap-south-1아시아 태평양 (뭄바이)Global
ap-south-2아시아 태평양 (하이데라바드)Global
ap-southeast-1아시아 태평양 (싱가포르)Global
ap-southeast-2아시아 태평양 (시드니)Global, AU
ap-southeast-3아시아 태평양 (자카르타)Global
ap-southeast-4아시아 태평양 (멜버른)Global, AU, In-region only
ca-central-1캐나다 (중부)Global, US
ca-west-1캐나다 서부 (캘거리)Global
eu-central-1유럽 (프랑크푸르트)Global, EU
eu-central-2유럽 (취리히)Global, EU
eu-north-1유럽 (스톡홀름)Global, EU, In-region only
eu-south-1유럽 (밀라노)Global, EU
eu-south-2유럽 (스페인)Global, EU
eu-west-1유럽 (아일랜드)Global, EU, In-region only
eu-west-2유럽 (런던)Global, EU
eu-west-3유럽 (파리)Global, EU
il-central-1이스라엘 (텔아비브)Global
me-central-1중동 (UAE)Global
sa-east-1남아메리카 (상파울루)Global
us-east-1미국 동부 (버지니아 북부)Global, US, In-region only
us-east-2미국 동부 (오하이오)Global, US, In-region only
us-west-1미국 서부 (캘리포니아 북부)Global, US
us-west-2미국 서부 (오리건)Global, US, In-region only

할당량

기본 할당량은 분당 200만 입력 토큰(TPM)입니다. 추가 Anthropic 승인 없이 최대 500만 입력 TPM 및 50만 출력 TPM을 요청할 수 있습니다. AWS는 Bedrock 측에서 분당 요청 수(RPM) 제한을 적용합니다. RPM 조정은 AWS 지원팀에 문의하세요.

데이터 보존

이 서비스의 데이터 처리는 Amazon Bedrock의 관리를 받습니다. 자세한 내용은 Amazon Bedrock의 데이터 보호를 참조하세요.

모니터링 및 로깅

Amazon Bedrock의 Claude는 CloudWatch와 CloudTrail 모두에 로그를 내보냅니다. Anthropic은 사용 패턴을 이해하고 잠재적 문제를 조사하기 위해 활동 로그를 최소 30일 롤링 기준으로 보존할 것을 권장합니다.

지원

지원이 필요하면 bedrock-ant-eap@amazon.com으로 문의하세요. AWS 계정 ID와 실패한 API 응답의 request-id를 포함하세요.

Was this page helpful?