Amazon Bedrock의 Claude Code

​

전제 조건

Bedrock으로 Claude Code를 구성하기 전에 다음 사항을 확인하세요:

• Bedrock 액세스가 활성화된 AWS 계정
• Bedrock에서 원하는 Claude 모델(예: Claude Sonnet 4)에 대한 액세스
• AWS CLI 설치 및 구성 (선택사항 - 자격 증명을 얻는 다른 메커니즘이 없는 경우에만 필요)
• 적절한 IAM 권한

​

설정

​

1. 모델 액세스 활성화

먼저 AWS 계정에서 필요한 Claude 모델에 대한 액세스 권한이 있는지 확인하세요:

1. Amazon Bedrock 콘솔로 이동
2. 왼쪽 탐색에서 Model access로 이동
3. 원하는 Claude 모델(예: Claude Sonnet 4)에 대한 액세스 요청
4. 승인 대기 (대부분의 지역에서 일반적으로 즉시 승인)

​

2. AWS 자격 증명 구성

Claude Code는 기본 AWS SDK 자격 증명 체인을 사용합니다. 다음 방법 중 하나를 사용하여 자격 증명을 설정하세요:

옵션 A: AWS CLI 구성

aws configure

옵션 B: 환경 변수 (액세스 키)

export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token

옵션 C: 환경 변수 (SSO 프로필)

aws sso login --profile=<your-profile-name>

export AWS_PROFILE=your-profile-name

​

3. Claude Code 구성

Bedrock을 활성화하려면 다음 환경 변수를 설정하세요:

# Bedrock 통합 활성화
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # 또는 선호하는 지역

​

4. 모델 구성

Claude Code는 Bedrock에 대해 다음 기본 모델을 사용합니다:

모델을 사용자 정의하려면 다음 방법 중 하나를 사용하세요:

# 추론 프로필 ID 사용
export ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# 애플리케이션 추론 프로필 ARN 사용
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

​

IAM 구성

Claude Code에 필요한 권한이 있는 IAM 정책을 생성하세요.

자세한 내용은 Bedrock IAM 문서를 참조하세요.

​

문제 해결

지역 문제가 발생하는 경우:

• 모델 가용성 확인: aws bedrock list-inference-profiles --region your-region
• 지원되는 지역으로 전환: export AWS_REGION=us-east-1
• 지역 간 액세스를 위한 추론 프로필 사용 고려

“on-demand throughput isn’t supported” 오류가 발생하는 경우:

• 모델을 추론 프로필 ID로 지정

​

추가 리소스

• Bedrock 문서
• Bedrock 요금
• Bedrock 추론 프로필
• Claude Code on Amazon Bedrock: Quick Setup Guide