Amazon Bedrock 기반 Claude Code/Desktop 통합 설계 및 설정

Running Claude Code and Claude Desktop on Amazon Bedrock

Haowen Huang2026년 5월 4일8분intermediate

AI 요약

Context

Anthropic API의 개별 구독 및 인증 체계로 인한 관리 복잡성과 데이터 거버넌스 이슈 존재. AWS 생태계 내에서 데이터 보안 유지와 통합 빌링 체계를 확보하기 위해 Bedrock을 추론 백엔드로 활용하는 구조 필요.

AWS SDK credential chain을 통한 IAM 기반의 통합 인증 아키텍처 적용
Inference Profile ID(us. prefix)를 사용하여 Cross-region 추론 경로 확보 및 Throughput 제한 문제 해결
Claude Code의 ~/.claude/settings.json 내 CLAUDE_CODE_USE_BEDROCK 플래그 설정을 통한 API Provider 런타임 전환
Claude Desktop의 Setup UI를 통한 JSON 스키마 유효성 검증 및 로컬 설정 동기화
Bedrock InvokeModel 및 ResponseStream 권한을 제한한 Least Privilege 기반 IAM 정책 설계

실천 포인트

1. Bedrock 모델 호출 시 Bare Model ID 대신 Cross-region Inference Profile ID 사용 여부 확인

2. Claude Code 설정 시 AWS_REGION 환경 변수가 ~/.aws/config에서 읽히지 않으므로 settings.json에 명시적 정의

3. Claude Desktop 설정 시 JSON 직접 수정 대신 Setup UI를 통한 Apply locally 프로세스 준수

4. IAM Policy에 bedrock:InvokeModelWithResponseStream 권한 포함 여부 검토

태그