• Messages
  • Managed Agents
  • 관리자

Search...
⌘K
첫 단계
Claude 소개빠른 시작
Claude로 빌드하기
기능 개요Messages API 사용하기중지 이유 및 폴백거부 및 폴백폴백 크레딧
모델 기능
확장 사고적응형 사고Effort작업 예산 (베타)고속 모드 (리서치 프리뷰)구조화된 출력인용스트리밍 메시지배치 처리검색 결과스트리밍 거부다국어 지원임베딩
도구
개요도구 사용 작동 방식튜토리얼: 도구 사용 에이전트 빌드하기도구 정의도구 호출 처리병렬 도구 사용Tool Runner (SDK)엄격한 도구 사용프롬프트 캐싱과 함께 도구 사용서버 도구문제 해결웹 검색 도구웹 가져오기 도구코드 실행 도구어드바이저 도구메모리 도구Bash 도구컴퓨터 사용 도구텍스트 편집기 도구
도구 인프라
도구 레퍼런스도구 컨텍스트 관리도구 조합도구 검색프로그래밍 방식 도구 호출세분화된 도구 스트리밍
컨텍스트 관리
컨텍스트 윈도우압축컨텍스트 편집프롬프트 캐싱대화 중 시스템 메시지오케스트레이션 모드 빌드하기캐시 진단 (베타)토큰 계산
파일 작업
Files APIPDF 지원이미지 및 비전
스킬
개요빠른 시작모범 사례엔터프라이즈용 스킬API에서의 스킬
MCP
원격 MCP 서버MCP 커넥터
클라우드 플랫폼의 Claude
Amazon BedrockAmazon Bedrock (레거시)AWS의 Claude PlatformMicrosoft FoundryVertex AI

Log in
Amazon Bedrock (레거시)
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Claude on AWS
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Messages/클라우드 플랫폼의 Claude

Amazon Bedrock의 Claude (레거시)

ARN 버전 모델 식별자와 함께 InvokeModel 및 Converse API를 사용하는 Claude 모델용 레거시 Amazon Bedrock 통합입니다.


이 페이지는 레거시 Amazon Bedrock 통합을 다룹니다: ARN 버전 모델 식별자와 AWS 이벤트 스트림 인코딩을 사용하는 InvokeModel 및 Converse API입니다. Messages-API Bedrock 엔드포인트에서 사용 가능한 모델에 대해서는 SSE 스트리밍과 함께 /anthropic/v1/messages에서 Messages API를 사용하는 Amazon Bedrock의 Claude를 참조하세요. AWS Marketplace 결제와 일반적으로 당일 기능 액세스를 제공하는 Anthropic 운영 대안에 대해서는 AWS의 Claude Platform을 참조하세요. 기존 Bedrock 사용자는 마이그레이션 가이드를 따를 수 있습니다.

Bedrock을 통해 Claude를 호출하는 방식은 Claude API에서 직접 Claude를 호출하는 방식과 약간 다릅니다. 이 가이드는 Anthropic의 클라이언트 SDK 중 하나를 사용하여 Bedrock에서 Claude에 대한 API 호출을 완료하는 과정을 안내합니다.

이 가이드는 이미 AWS 계정에 가입하고 프로그래밍 방식 액세스를 구성했다고 가정합니다.

AWS CLI 설치 및 구성

  1. 버전 2.13.23 이상의 AWS CLI 버전을 설치하세요
  2. AWS configure 명령을 사용하여 AWS 자격 증명을 구성하거나(AWS CLI 구성 참조), AWS 대시보드에서 "Command line or programmatic access"로 이동하여 팝업 모달의 지침에 따라 자격 증명을 찾으세요.
  3. 자격 증명이 작동하는지 확인하세요:
AWS CLI
aws sts get-caller-identity

Bedrock 액세스를 위한 SDK 설치

Anthropic의 클라이언트 SDK는 Bedrock을 지원합니다. boto3와 같은 AWS SDK를 직접 사용할 수도 있습니다.

Bedrock 액세스

Anthropic 모델 구독

AWS Console > Bedrock > Model Access로 이동하여 Anthropic 모델에 대한 액세스를 요청하세요. Anthropic 모델 가용성은 리전에 따라 다릅니다. 최신 정보는 AWS 문서를 참조하세요.

API 모델 ID



Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7은 bedrock-runtime의 InvokeModel을 통해 접근할 수 있습니다. 이러한 요청은 Amazon Bedrock의 Claude 엔드포인트와 동일한 인프라에서 처리됩니다. 네이티브 Messages API 요청 형식과 완전한 기능 패리티를 위해서는 해당 페이지를 사용하세요. Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7은 ARN 버전 모델 ID가 없기 때문에 이 페이지의 모델 표에서 제외되었습니다.

수명 주기 용어(Deprecated, Retired)는 모델 지원 중단에 정의되어 있습니다. 파트너 운영 플랫폼의 수명 주기 날짜는 파트너가 설정하며 Claude API 일정과 다를 수 있습니다. Amazon Bedrock에서 모델의 현재 종료 날짜는 Amazon Bedrock의 모델 수명 주기 페이지를 참조하세요.

모델기본 Bedrock 모델 IDglobaluseujpapac
Claude Opus 4.6anthropic.claude-opus-4-6-v1예예예예예
Claude Sonnet 4.6anthropic.claude-sonnet-4-6예예예예아니요
Claude Sonnet 4.5anthropic.claude-sonnet-4-5-20250929-v1:0예예

리전별 모델 ID와 글로벌 모델 ID에 대한 자세한 내용은 글로벌 엔드포인트와 리전별 엔드포인트 섹션을 참조하세요.

사용 가능한 모델 나열

다음 예제는 Bedrock을 통해 사용 가능한 모든 Claude 모델 목록을 출력하는 방법을 보여줍니다:

요청 보내기

다음 예제는 Bedrock에서 Claude로부터 텍스트를 생성하는 방법을 보여줍니다:

자세한 내용은 클라이언트 SDK와 공식 Bedrock 문서를 참조하세요.

Bearer 토큰 인증

AWS 자격 증명 대신 "bearer token"(베어러 토큰)을 사용하여 Bedrock에 인증할 수 있습니다. 이는 팀이 AWS 자격 증명, IAM 역할 또는 계정 수준 권한을 관리하지 않고 Bedrock에 액세스해야 하는 기업 환경에서 유용합니다.

가장 간단한 방법은 AWS_BEARER_TOKEN_BEDROCK 환경 변수를 설정하는 것입니다. 각 SDK는 환경에서 자격 증명을 확인할 때 이를 자동으로 감지합니다.

프로그래밍 방식으로 토큰을 제공하려면:

활동 로깅

Bedrock은 고객이 사용과 관련된 프롬프트 및 완성을 로깅할 수 있는 호출 로깅 서비스를 제공합니다.

Anthropic은 활동을 이해하고 잠재적인 오용을 조사하기 위해 최소 30일 롤링 기준으로 활동을 로깅할 것을 권장합니다.



이 서비스를 활성화해도 AWS 또는 Anthropic이 귀하의 콘텐츠에 액세스할 수 없습니다.

기능 지원

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

지원되는 주요 기능

  • Messages API
  • 프롬프트 캐싱
  • 확장 사고
  • Bash 도구, 컴퓨터 사용 도구, 메모리 도구, 텍스트 편집기 도구를 포함한 도구 사용
  • 인용
  • 구조화된 출력

지원되지 않는 기능

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

Bedrock의 PDF 지원

PDF 지원은 Converse API와 InvokeModel API 모두를 통해 Bedrock에서 사용할 수 있습니다. PDF 처리 기능 및 제한 사항에 대한 자세한 내용은 Amazon Bedrock PDF 지원을 참조하세요.

Converse API 사용자를 위한 중요 고려 사항:

  • 시각적 PDF 분석(차트, 이미지, 레이아웃)을 위해서는 인용이 활성화되어야 합니다
  • 인용이 없으면 기본 텍스트 추출만 사용할 수 있습니다
  • 강제 인용 없이 완전한 제어를 원하면 InvokeModel API를 사용하세요

컨텍스트 윈도우

Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 4.6은 Amazon Bedrock에서 1M 토큰 컨텍스트 윈도우를 제공합니다. Sonnet 4.5 및 Sonnet 4(지원 중단됨)를 포함한 다른 Claude 모델은 200k 토큰 컨텍스트 윈도우를 제공합니다.

Bedrock은 요청 페이로드를 20MB로 제한합니다. 대용량 문서나 많은 이미지를 전송할 때 토큰 제한에 도달하기 전에 이 제한에 도달할 수 있습니다.

글로벌 엔드포인트와 리전별 엔드포인트

Claude Sonnet 4.5 및 이후 모든 모델부터 Bedrock은 두 가지 엔드포인트 유형을 제공합니다:

  • 글로벌 엔드포인트: 최대 가용성을 위한 동적 라우팅
  • 리전별 엔드포인트: 특정 지리적 리전을 통한 데이터 라우팅 보장

리전별 엔드포인트는 글로벌 엔드포인트 대비 10% 가격 프리미엄이 적용됩니다.



이는 Claude Sonnet 4.5 및 이후 모델에만 적용됩니다. 이전 모델(Claude Sonnet 4(지원 중단됨), Opus 4(지원 중단됨) 및 그 이전)은 기존 가격 구조를 유지합니다.

각 옵션을 사용해야 하는 경우

글로벌 엔드포인트(권장):

  • 최대 가용성 및 가동 시간 제공
  • 사용 가능한 용량이 있는 리전으로 요청을 동적으로 라우팅
  • 가격 프리미엄 없음
  • 데이터 상주가 유연한 애플리케이션에 가장 적합

리전별 엔드포인트(CRIS):

  • 특정 지리적 리전을 통해 트래픽 라우팅
  • 데이터 상주 및 규정 준수 요구 사항에 필요
  • 미국, EU, 일본, 아시아 태평양에서 사용 가능
  • 10% 가격 프리미엄은 전용 리전 용량을 위한 인프라 비용을 반영

구현

글로벌 엔드포인트 사용(Opus 4.6, Sonnet 4.6, Sonnet 4.5의 기본값):

Claude Opus 4.6, Sonnet 4.6, Sonnet 4.5의 모델 ID에는 이미 global. 접두사가 포함되어 있습니다:

리전별 엔드포인트(CRIS) 사용:

리전별 엔드포인트를 사용하려면 global. 접두사를 us.와 같은 리전 접두사로 바꾸세요:



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

추가 리소스

  • Bedrock 가격: aws.amazon.com/bedrock/pricing
  • AWS 가격 문서: Bedrock 가격 가이드
  • AWS 블로그 게시물: Amazon Bedrock에서 Claude Sonnet 4.5 소개
  • Anthropic 가격 세부 정보: 클라우드 플랫폼 가격

Was this page helpful?

  • AWS CLI 설치 및 구성
  • Bedrock 액세스를 위한 SDK 설치
  • Bedrock 액세스
  • Anthropic 모델 구독
  • 사용 가능한 모델 나열
  • 요청 보내기
  • Bearer 토큰 인증
  • 활동 로깅
  • 기능 지원
  • 지원되는 주요 기능
  • 지원되지 않는 기능
  • Bedrock의 PDF 지원
  • 컨텍스트 윈도우
  • 글로벌 엔드포인트와 리전별 엔드포인트
  • 각 옵션을 사용해야 하는 경우
  • 구현
  • 추가 리소스
예
예
아니요
Claude Sonnet 4
지원 중단됨.		anthropic.claude-sonnet-4-20250514-v1:0예예예아니요예
Claude Sonnet 3.7
종료됨.		anthropic.claude-3-7-sonnet-20250219-v1:0아니요아니요아니요아니요아니요
Claude Opus 4.5anthropic.claude-opus-4-5-20251101-v1:0예예예아니요아니요
Claude Opus 4.1
지원 중단됨.		anthropic.claude-opus-4-1-20250805-v1:0아니요예아니요아니요아니요
Claude Opus 4
종료됨.		anthropic.claude-opus-4-20250514-v1:0아니요아니요아니요아니요아니요
Claude Haiku 4.5anthropic.claude-haiku-4-5-20251001-v1:0예예예아니요아니요
Claude Haiku 3.5
지원 중단됨.		anthropic.claude-3-5-haiku-20241022-v1:0아니요예아니요아니요아니요
import boto3

bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")

for summary in response["modelSummaries"]:
    print(summary["modelId"])
from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # 아래 키를 제공하거나 ~/.aws/credentials 또는 "AWS_SECRET_ACCESS_KEY" 및 "AWS_ACCESS_KEY_ID" 환경 변수와 같은
    # 기본 AWS 자격 증명 공급자를 사용하여 인증합니다.
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # 임시 자격 증명은 aws_session_token과 함께 사용할 수 있습니다.
    # 자세한 내용은 https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html 을 참조하세요.
    aws_session_token="<session_token>",
    # aws_region은 요청이 전송되는 AWS 리전을 변경합니다. 기본적으로 SDK는 AWS_REGION을 읽고,
    # 해당 값이 없으면 us-east-1을 기본값으로 사용합니다. SDK는 리전을 위해 ~/.aws/config를 읽지 않습니다.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)
from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    api_key="your-bearer-token",
    aws_region="us-west-2",
)

message = client.messages.create(
    model="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)
from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)
from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

# 미국 리전 엔드포인트(CRIS) 사용
message = client.messages.create(
    model="us.anthropic.claude-opus-4-6-v1",  # Regional prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)