Amazon Bedrock의 Claude

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

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

AWS CLI 설치 및 구성

1. AWS CLI 버전 2.13.23 이상을 설치합니다
2. AWS 구성 명령을 사용하여 AWS 자격 증명을 구성합니다(AWS CLI 구성 참조) 또는 AWS 대시보드 내에서 "Command line or programmatic access"로 이동하여 팝업 모달의 지시사항을 따라 자격 증명을 찾습니다.
3. 자격 증명이 작동하는지 확인합니다:

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

지역별 및 글로벌 모델 ID에 대한 자세한 내용은 아래의 Global vs regional endpoints 섹션을 참조하세요.

사용 가능한 모델 나열

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

import boto3

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

for summary in response["modelSummaries"]:
    print(summary["modelId"])

요청 만들기

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

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # 아래 키를 제공하거나 기본 AWS 자격 증명 공급자(예: ~/.aws/credentials 또는 "AWS_SECRET_ACCESS_KEY" 및 "AWS_ACCESS_KEY_ID" 환경 변수)를 사용하여 인증합니다.
    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 지역을 변경합니다. 기본적으로 AWS_REGION을 읽고, 없으면 us-east-1로 기본 설정됩니다. ~/.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)

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

Bearer 토큰 인증

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

가장 간단한 방법은 AWS_BEARER_TOKEN_BEDROCK 환경 변수를 설정하는 것입니다. 이는 fromEnv() 자격 증명 해결에 의해 자동으로 감지됩니다.

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

using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockClient(
    new AnthropicBedrockApiTokenCredentials
    {
        BearerToken = "your-bearer-token",
        Region = "us-east-1",
    }
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    MaxTokens = 1024,
    Messages = [new() { Role = Role.User, Content = "Hello!" }],
});

활동 로깅

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

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

기능 지원

Bedrock에서 현재 지원되는 모든 기능은 API 기능 개요를 참조하세요.

Bedrock의 PDF 지원

PDF 지원은 Amazon Bedrock에서 Converse API 및 InvokeModel API를 통해 사용 가능합니다. PDF 처리 기능 및 제한 사항에 대한 자세한 정보는 PDF 지원 문서를 참조하세요.

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

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

두 문서 처리 모드 및 해당 제한 사항에 대한 자세한 내용은 PDF 지원 가이드를 참조하세요.

컨텍스트 윈도우

Claude Opus 4.6 및 Claude Sonnet 4.6은 Amazon Bedrock에서 1M 토큰 컨텍스트 윈도우를 가지고 있습니다. Sonnet 4.5 및 Sonnet 4(더 이상 사용되지 않음)를 포함한 다른 Claude 모델은 200k 토큰 컨텍스트 윈도우를 가지고 있습니다.

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

Global vs regional endpoints

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

• Global endpoints: 최대 가용성을 위한 동적 라우팅
• Regional endpoints: 특정 지리적 지역을 통한 보장된 데이터 라우팅

Regional endpoints는 global endpoints보다 10% 가격 프리미엄이 있습니다.

각 옵션을 사용할 때

Global endpoints(권장):

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

Regional endpoints (CRIS):

• 특정 지리적 지역을 통해 트래픽 라우팅
• 데이터 거주지 및 규정 준수 요구 사항에 필수
• US, EU, Japan 및 Australia에서 사용 가능
• 10% 가격 프리미엄은 전용 지역 용량의 인프라 비용을 반영합니다

구현

Global endpoints 사용(Opus 4.6, Sonnet 4.5 및 Sonnet 4(더 이상 사용되지 않음)의 기본값):

Claude Sonnet 4.5 및 4(더 이상 사용되지 않음)의 모델 ID에는 이미 global. 접두사가 포함되어 있습니다:

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"}],
)

Regional endpoints 사용(CRIS):

Regional endpoints를 사용하려면 모델 ID에서 global. 접두사를 제거합니다:

from anthropic import AnthropicBedrock

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

# US regional endpoint(CRIS) 사용
message = client.messages.create(
    model="anthropic.claude-opus-4-6-v1",  # global. 접두사 없음
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

추가 리소스

• AWS Bedrock 가격: aws.amazon.com/bedrock/pricing
• AWS 가격 문서: Bedrock 가격 가이드
• AWS 블로그 게시물: Introducing Claude Sonnet 4.5 in Amazon Bedrock
• Anthropic 가격 세부 정보: 가격 문서