블로그 릴레이 - Amazon Bedrock으로 Claude Code 사용해보기
2025.04.15안녕하세요! 제조 비즈니스 테크놀로지부의 이병현입니다.
본 블로그는 당사의 한국어 블로그 릴레이의 2025년 열두 번째 블로그입니다.
이번 블로그의 주제는 「Amazon Bedrock으로 Claude Code 사용해보기」 입니다.
Claude Code란?
Claude Code는 Claude로 유명한 Anthropic에서 제공하는 에이전트 코딩 도구입니다.
터미널에서 명령어를 통해 코드베이스를 LLM이 이해한 상태에서 질답을 할 수 있습니다.
LLM을 이용하기 위해 코드를 직접 복사해서 웹에 붙여넣기 하거나, IDE에 통합하거나 하는 방식외에 위와 같이 터미널에서 Claude Code를 이용해 직접 상호작용하는 방법을 제공하고 있습니다.
참고: https://docs.anthropic.com/ko/docs/agents-and-tools/claude-code/overview
Claude Code 설치
npm으로 아래처럼 쉽게 설치할 수 있습니다. (NodeJS 18이상)
npm install -g @anthropic-ai/claude-code
설치하고 나서 claude 를 터미널에 입력하여 실행하여 아래처럼 시작된 것처럼 보이면 설치가 잘 된 것을 확인할 수 있습니다.
하지만, 아직 LLM과 연결하지 않았기 때문에 요청을 해도 아래처럼 에러가 날 것입니다.
그렇기에 Claude를 API로 이용하기 위해 추가하여야 합니다. 여러 방법으로 Claude를 API로 사용할 수 있지만, Amazon Bedrock을 사용하여 쉽게 사용해보겠습니다.
Amazon Bedrock으로 Claude Code 사용해보기
Claude Code는 현재(2025년 4월) Claude 3.7 Sonnet과 Claude 3.5 Haiku 모델 모두에 대한 액세스가 필요합니다.
한국 리전에는 Claude 3.7 Sonnet과 Claude 3.5 Haiku 모델이 아직 없기 때문에 미국 버지니아 북부(us-east-1) 리전을 사용하겠습니다.
위 처럼 액세스 권한 부여됨 이 표시된다면 해당 모델을 사용할 수 있습니다. 아직 권한이 없다면 해당 아이템의 메뉴 버튼(...버튼) 을 눌러 Modify access 메뉴에서 권한을 추가해주세요.
이후 AWS를 CLI로 연결할 수 있게 준비한 후 아래 환경변수를 설정해주세요.
# 리전 설정
export AWS_REGION=us-east-1
# claude code에 bedrock 활성화
export CLAUDE_CODE_USE_BEDROCK=1
# 모델 id 설정
export ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'
설정한 후에 claude를 입력하여 테스트 해보겠습니다.
그러면 실제 프로젝트 코드 베이스를 이해하고 답변하는 것을 확인할 수 있었습니다!
마무리
Cursor나 Windsurf를 사용하여 개발하는 것도 편리하지만, 터미널로 간단한 내용을 점검하고 싶을 때가 있습니다. 이럴 때 코드를 복붙해 웹에다가 붙여넣기하거나 코드 베이스를 이해시키기 위해 여러 방법을 사용하거나 했던 것 같습니다.
이런 문제들을 Claude Code가 많이 해결해주는 것 같고, 위 API를 Amazon Bedrock을 이용하여 비용을 AWS를 통해 처리해야하는 경우 위 방법이 매우 유용한 것 같습니다.
터미널을 위한 AI 클라이언트들이 더 많이 발전했으면 좋겠네요. 🤗
이상, 한국어 블로그 릴레이의 2025년 열두 번째 블로그 「Amazon Bedrock으로 Claude Code 사용해보기」 편이었습니다. 다음 2025년 열세 번째 번째 블로그 릴레이는 4월 넷째 주에 공개됩니다.
끝까지 읽어주셔서 감사합니다! 이상, 제조 비즈니스 테크놀로지부의 이병현이었습니다.
