ClaudeCode on Amazon Bedrock 사용 시의 절차 및 아키텍처 정리

이번 블로그는 ClaudeCode on Amazon Bedrock을 사용할 때의 절차와 아키텍처를 정리한 것입니다.

※ ClaudeCode 자체는 Amazon Bedrock을 이용하지 않고도 사용하는 방법이 있습니다.

Amazon Bedrock을 통해 ClaudeCode를 사용하고 싶지만, AWS를 전혀 다뤄본 적이 없는 분들을 위한 블로그입니다.

ClaudeCode on Amazon Bedrock의 아키텍처 도표는 다음과 같습니다.

Amazon Bedrock을 사용하기 위해, 필요 최소한의 AWS 계정 관련 보안 및 비용 알람(Cost Alarm) 설정을 추가했습니다.

・ClaudeCode를 이용하는 IAM 사용자 권한 설정 ※ 다요소 인증 (MFA) 필수화
・예산 관리를 위한 비용 알람 (Cost Alert) 설정
・AWS CloudTrail을 통한 AWS 내 조작 로그 취득
・Amazon GuardDuty를 통한 부정 활동 탐지 구현
・Amazon Bedrock에서 Anthropic사의 모델 (Claude) 액세스 활성화
・Amazon Bedrock의 「모델 호출 로그 기록」 설정 (임의) ※ 권장되지 않음

이번에는 ClaudeCode on Amazon Bedrock을 사용하기 위한 최소한의 설정을 포함했습니다.

실제로는 클라이언트 측에서 MCP 서버나 Skills 등을 설정하기도 하겠지만, 본 블로그에서는 이 부분에 대해서는 설명하지 않습니다.

또한, 생성형 AI가 작성한 콘텐츠의 품질 보증 방법(Quality Assurance)에 대해서도 검토가 필요합니다.

ClaudeCode용 AWS 계정을 신규로 발급하여 설정을 진행하는 상황을 가정하여 작성했습니다.

이미 설정이 완료된 항목에 대해서는 불필요합니다.

이번에는 AWS login을 통해 ClaudeCode on Amazon Bedrock을 이용할 때의 이용 절차에 대해 해설합니다.

AWS 계정에서 최소한으로 필요한 설정을 수행합니다.

・IAM 사용자 설정 MFA 디바이스
・비용 알람 (Cost Alert) 설정
・AWS CloudTrail을 통한 조작 로그 취득
・Amazon GuardDuty를 통한 부정 활동 탐지 구현
・Amazon Bedrock에서 Anthropic사의 모델 (Claude) 액세스 활성화

자세한 내용은 아래 블로그에 기재되어 있습니다.

ClaudeCode용 IAM 사용자에게 필요한 IAM 정책을 부여합니다.

자세한 내용은 아래 블로그에 기재되어 있습니다.

클라이언트 Claude Code에서 AWS login을 통해 Amazon Bedrock에 접속하는 설정입니다.

자세한 내용은 아래 블로그에 기재되어 있습니다.

ClaudeCode CLI 절차

요건상 반드시 필요한 경우, Amazon Bedrock의 「모델 호출 로그 기록」을 활성화합니다.

※ 기밀 정보를 클라우드에 보관하는 설정이므로, 요건상 필수적이지 않다면 취득하는 것을 권장하지 않습니다.

자세한 내용은 아래 블로그에 기재되어 있습니다.

이번에 ClaudeCode on Amazon Bedrock을 사용할 때의 절차와 아키텍처를 정리했습니다.

AWS를 전혀 다뤄본 적이 없더라도 Amazon Bedrock을 통해 ClaudeCode를 사용하는 경우, 꼭 기억해 두시기 바랍니다.