클로드코드 /setup-bedrock — AWS Bedrock 연결 설정하기

회사가 클라우드를 AWS로 통일했거나, 보안 정책상 외부 API 대신 사내 클라우드를 거쳐 모델을 써야 하는 경우가 있습니다. /setup-bedrock은 이럴 때 클로드코드를 아마존 Bedrock에 연결해주는 설정 명령입니다.

정의 (뭐냐면)

/setup-bedrock은 아마존 Bedrock(AWS의 AI 모델 호스팅 서비스) 연결을 설정하는 명령입니다. 이 환경을 쓰는 사용자에게만 해당되는 기능이에요.

Bedrock이란 아마존이 제공하는 클라우드에서 여러 AI 모델을 불러 쓰게 해주는 서비스입니다. 회사가 AWS 환경을 쓴다면, 클로드코드가 모델을 직접 호출하는 대신 이 Bedrock을 거쳐 동작하도록 맞출 수 있어요. 자격증명(클라우드 접속 권한 정보)과 리전(region, 데이터센터가 위치한 지역) 설정이 필요해 고급 분류에 들어갑니다.

어떻게 쓰나 (난이도별)

기초 — Bedrock 연결 설정

입력창에 이렇게 칩니다.

/setup-bedrock

그러면 Bedrock 인증과 리전을 설정하는 절차가 시작됩니다. 안내에 따라 AWS 자격증명과 사용할 리전을 입력하면 연결이 맞춰져요. 자격증명은 사람마다 다르므로, 회사에서 발급받은 본인 값을 그 자리에 넣으면 됩니다. 예를 들면 다음처럼 자리에 들어갈 항목을 채우는 식입니다.

AWS 접근 키 ID: <발급받은_액세스_키>
AWS 비밀 접근 키: <발급받은_시크릿_키>
리전: <사용할_리전_예: ap-northeast-2>

흔한 함정

• 이 명령은 Bedrock 환경을 쓰는 사용자에게만 해당됩니다. 개인 계정으로 일반 사용 중이라면 굳이 설정할 필요가 없어요.
• 자격증명은 비밀번호처럼 민감한 정보입니다. 화면 캡처나 메모로 외부에 노출하지 않도록 주의하세요. 위 예시의 <...> 부분은 자리표시자일 뿐, 실제 값은 회사 보안 절차에 따라 안전하게 다뤄야 합니다.
• 리전을 잘못 지정하면 연결이 안 되거나 느려질 수 있습니다. 회사가 지정한 리전 값을 정확히 확인하고 넣으세요.

실전 사례

사내 보안 규정상 외부 서비스로 데이터가 나가면 안 되고, 인프라가 모두 AWS에 있는 팀에 잘 맞습니다. /setup-bedrock으로 Bedrock에 맞춰 연결해두면, 회사 정책을 지키면서 클로드코드를 그대로 쓸 수 있어요.

이렇게 더 씁니다

구글 클라우드 환경이라면 같은 방식으로 동작하는 /setup-vertex가 따로 있습니다. 설정 전반을 다루는 /config와 함께 보면, 우리 팀 환경에 맞는 연결 상태를 점검하고 정돈하기 좋아요. 본격 설정 전에 클라우드 담당자에게 자격증명과 리전 정보를 미리 받아두면 한 번에 끝납니다.

정리

/setup-bedrock은 클로드코드를 아마존 Bedrock에 연결하는 설정 명령입니다(해당 환경 사용자 한정). 사내 AWS 정책에 맞춰 인증과 리전을 맞추면, 보안 규정을 지키면서 그대로 작업할 수 있어요. 자격증명은 자리표시자가 아닌 본인 값으로, 노출되지 않게 다루는 게 핵심입니다.

기준: Claude Code v2.1.154 (2026.05)