클로드코드 /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 정책에 맞춰 인증과 리전을 맞추면, 보안 규정을 지키면서 그대로 작업할 수 있어요. 자격증명은 자리표시자가 아닌 본인 값으로, 노출되지 않게 다루는 게 핵심입니다.

FAQ · 자주 묻는 질문

AWS 자격증명을 입력하라는데, 유출될까 봐 불안해요. 어떻게 다뤄야 하나요?

자격증명은 비밀번호처럼 민감한 정보라서 외부에 노출되지 않게 본인이 직접 관리해야 합니다. 화면 캡처나 메모로 남기지 말고, 예시에 보이는 <...> 부분은 자리표시자일 뿐이니 실제 값은 회사 보안 절차에 따라 안전하게 다루세요. 발급받은 본인 값만 그 자리에 넣고, 다른 곳에 옮겨 적지 않는 게 기본입니다.

Bedrock 연결은 어떻게 시작하나요? 미리 준비할 게 있나요?

입력창에 /setup-bedrock을 치면 인증과 리전을 설정하는 절차가 바로 시작됩니다. 안내에 따라 AWS 접근 키와 비밀 접근 키, 사용할 리전을 입력하면 연결이 맞춰져요. 본격 설정 전에 클라우드 담당자에게 자격증명과 리전 정보를 미리 받아두면 한 번에 끝낼 수 있습니다. 개인 계정으로 일반 사용 중이라면 굳이 설정할 필요가 없어요.

연결이 안 되거나 느릴 때는 무엇부터 확인해야 하나요?

리전 값부터 확인하세요. 리전을 잘못 지정하면 연결이 안 되거나 느려질 수 있으므로, 회사가 지정한 리전 값을 정확히 확인하고 다시 입력해야 합니다. 자격증명도 회사에서 발급받은 본인 값이 맞는지 점검해 보세요. 설정 전반은 /config와 함께 보면 우리 팀 환경에 맞는 연결 상태를 점검하기 좋아요.

기준: Claude Code v2.1.154 (2026.05)