Messages클라우드 플랫폼의 Claude

Amazon Bedrock의 Claude

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

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

이 페이지는 AWS 관리형 인프라에서 /anthropic/v1/messages의 Messages API를 통해 Claude를 제공하는 Amazon Bedrock의 Claude를 다룹니다. 이전 Amazon Bedrock 통합(ARN 버전 모델 식별자를 사용하는 InvokeModel 및 Converse API)은 계속 사용 가능하며 Amazon Bedrock의 Claude(레거시)에 문서화되어 있습니다. AWS Marketplace 결제와 일반적으로 당일 기능 액세스를 제공하는 AWS 기반의 Anthropic 운영 대안은 AWS의 Claude Platform을 참조하세요.

액세스

Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7 및 Claude Haiku 4.5는 모든 Amazon Bedrock 고객에게 공개되어 있습니다. Claude Mythos Preview는 초대가 필요합니다. Project Glasswing을 참조하세요. 리전 가용성은 리전을 참조하세요.

사전 요구 사항

시작하기 전에 다음 사항을 확인하세요:

사용하려는 Claude 모델에 대해 Amazon Bedrock 모델 액세스가 활성화된 AWS 계정.
AWS CLI가 설치 및 구성되어 있어야 합니다(선택 사항, 자격 증명 관리용).

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

인증

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

Bedrock 서비스 역할(권장)

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

관리자: 서비스 역할 프로비저닝
AWS 관리자가 Bedrock 서비스 역할을 프로비저닝하고 개발자에게 서비스 역할 ARN에 대한 iam:PassRole 권한을 부여합니다.
개발자: 역할 전달
API를 호출할 때 Bedrock이 사용자를 대신하여 서비스 역할을 수임합니다. 역할을 요청과 연결하는 방법은 Amazon Bedrock 문서를 참조하세요.

IAM 수임 역할

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

관리자: IAM 역할 구성
Claude 모델로 범위가 지정된 IAM 역할을 생성합니다. 신뢰 정책은 ID 공급자(SAML, OIDC 또는 AWS Identity Center)를 지정합니다. 권한 정책은 허용된 모델 ARN에 대해서만 bedrock-mantle:CreateInference를 부여합니다.
개발자: 인증 및 수임
기업 ID 공급자를 통해 인증한 다음 IAM 역할을 수임합니다. AWS STS는 SDK 또는 CLI가 요청에 서명하는 데 사용하는 임시 자격 증명을 발급합니다.

Bearer 토큰

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

관리자: 토큰 유형 제한
bedrock:BearerTokenType 조건이 단기 토큰과 일치하지 않는 한 bedrock:CallWithBearerToken을 거부하는 정책을 연결하여 장기 키를 차단합니다.
개발자: 토큰 발급
aws-bedrock-token-generator CLI를 사용하여 bearer 토큰을 발급합니다. 각 요청의 x-api-key 헤더에 전달합니다.

SDK 설치

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

첫 번째 요청 보내기

엔드포인트는 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).

표준 Anthropic 클라이언트를 사용할 수도 있습니다: base_url을 https://bedrock-mantle.{region}.api.aws/anthropic으로 설정하고 bearer 토큰을 api_key로 전달하세요. 이 경로는 bearer 토큰 인증만 지원합니다. SigV4 서명에는 전용 클라이언트가 필요합니다.

지원되는 모델

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

모델	모델 ID	액세스
Claude Fable 5	anthropic.claude-fable-5	공개
Claude Opus 4.8	anthropic.claude-opus-4-8	공개
Claude Opus 4.7	anthropic.claude-opus-4-7	공개
Claude Haiku 4.5	anthropic.claude-haiku-4-5	공개
Claude Mythos Preview	anthropic.claude-mythos-preview	초대 전용(Project Glasswing)

최신 Claude 모델로 업그레이드하시나요? Claude Code에서 /claude-api migrate를 실행하여 코드베이스 전체에 모델 ID 교체 및 호환성이 깨지는 매개변수 변경 사항을 적용하세요. 이 스킬은 코드가 대상으로 하는 클라우드 플랫폼을 감지하고 해당 플랫폼에 맞게 모델 ID 형식과 기능 변경 사항을 조정합니다. 최신 Claude 모델로 마이그레이션하기를 참조하세요.

기능 지원

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

지원되는 주요 기능

Messages API (/anthropic/v1/messages)
프롬프트 캐싱
확장 사고
도구 사용, Bash 도구, 컴퓨터 사용 도구, 메모리 도구, 텍스트 편집기 도구 포함
인용
구조화된 출력

지원되지 않는 기능

입력 소스(이미지 및 문서용 URL 소스, Files API)
서버 측 도구(코드 실행, 웹 검색, 웹 가져오기, 어드바이저)
에이전트 인프라(Agent Skills, MCP 커넥터, 프로그래밍 방식 도구 호출)
API 엔드포인트(Message Batches, Models, Admin, Compliance, Usage and Cost)
Claude Managed Agents
서버 측 폴백(fallbacks 매개변수; 대신 클라이언트 측 폴백 패턴을 사용하세요)

리전

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

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

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

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

할당량

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

데이터 보존

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

모니터링 및 로깅

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

지원

지원이 필요하면 [email protected]으로 문의하세요. AWS 계정 ID와 실패한 API 응답의 request-id를 포함하세요.

Claude Mythos Preview는 Amazon Bedrock에서 초대된 고객에게 제공되는 연구 프리뷰 모델입니다. 자세한 내용은 Project Glasswing을 참조하세요.

Was this page helpful?

Messages클라우드 플랫폼의 Claude

Amazon Bedrock의 Claude

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

액세스

사전 요구 사항

시작하기 전에 다음 사항을 확인하세요:

사용하려는 Claude 모델에 대해 Amazon Bedrock 모델 액세스가 활성화된 AWS 계정.
AWS CLI가 설치 및 구성되어 있어야 합니다(선택 사항, 자격 증명 관리용).

인증

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

Bedrock 서비스 역할(권장)

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

관리자: 서비스 역할 프로비저닝
AWS 관리자가 Bedrock 서비스 역할을 프로비저닝하고 개발자에게 서비스 역할 ARN에 대한 iam:PassRole 권한을 부여합니다.
개발자: 역할 전달
API를 호출할 때 Bedrock이 사용자를 대신하여 서비스 역할을 수임합니다. 역할을 요청과 연결하는 방법은 Amazon Bedrock 문서를 참조하세요.

IAM 수임 역할

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

관리자: IAM 역할 구성
Claude 모델로 범위가 지정된 IAM 역할을 생성합니다. 신뢰 정책은 ID 공급자(SAML, OIDC 또는 AWS Identity Center)를 지정합니다. 권한 정책은 허용된 모델 ARN에 대해서만 bedrock-mantle:CreateInference를 부여합니다.
개발자: 인증 및 수임
기업 ID 공급자를 통해 인증한 다음 IAM 역할을 수임합니다. AWS STS는 SDK 또는 CLI가 요청에 서명하는 데 사용하는 임시 자격 증명을 발급합니다.

Bearer 토큰

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

관리자: 토큰 유형 제한
bedrock:BearerTokenType 조건이 단기 토큰과 일치하지 않는 한 bedrock:CallWithBearerToken을 거부하는 정책을 연결하여 장기 키를 차단합니다.
개발자: 토큰 발급
aws-bedrock-token-generator CLI를 사용하여 bearer 토큰을 발급합니다. 각 요청의 x-api-key 헤더에 전달합니다.

SDK 설치

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

첫 번째 요청 보내기

지원되는 모델

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

모델	모델 ID	액세스
Claude Fable 5	anthropic.claude-fable-5	공개
Claude Opus 4.8	anthropic.claude-opus-4-8	공개
Claude Opus 4.7	anthropic.claude-opus-4-7	공개
Claude Haiku 4.5	anthropic.claude-haiku-4-5	공개
Claude Mythos Preview	anthropic.claude-mythos-preview	초대 전용(Project Glasswing)

기능 지원

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

지원되는 주요 기능

Messages API (/anthropic/v1/messages)
프롬프트 캐싱
확장 사고
도구 사용, Bash 도구, 컴퓨터 사용 도구, 메모리 도구, 텍스트 편집기 도구 포함
인용
구조화된 출력

지원되지 않는 기능

입력 소스(이미지 및 문서용 URL 소스, Files API)
서버 측 도구(코드 실행, 웹 검색, 웹 가져오기, 어드바이저)
에이전트 인프라(Agent Skills, MCP 커넥터, 프로그래밍 방식 도구 호출)
API 엔드포인트(Message Batches, Models, Admin, Compliance, Usage and Cost)
Claude Managed Agents
서버 측 폴백(fallbacks 매개변수; 대신 클라이언트 측 폴백 패턴을 사용하세요)

리전

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

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

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

할당량

데이터 보존

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

모니터링 및 로깅

지원

지원이 필요하면 [email protected]으로 문의하세요. AWS 계정 ID와 실패한 API 응답의 request-id를 포함하세요.

Claude Mythos Preview는 Amazon Bedrock에서 초대된 고객에게 제공되는 연구 프리뷰 모델입니다. 자세한 내용은 Project Glasswing을 참조하세요.

Was this page helpful?