SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor · 업데이트됨 2026-10-19

Claude Code를 Bedrock 및 Vertex AI에서 실행하는 방법

Claude Code를 Amazon Bedrock 또는 Google Vertex AI로 전환하는 환경 변수 설정법과 자격 증명 관리 방식을 설명합니다. 클라우드 계정별 비용 청구 구조와 모델 호출 시 변경되는 네트워크 경로 및 서비스 제한 사항을 상세히 안내합니다.

Claude Code를 사용자 본인의 클라우드 계정에서 실행할 때의 변화

Claude Code는 Amazon Bedrock 또는 Google Vertex AI에서 실행할 수 있으며, 전환 방법은 환경 변수 2~3개를 설정하고 팀이 이미 보유한 클라우드 자격 증명을 사용하는 것뿐입니다. CLI, 서브 에이전트, 훅, 스킬, MCP 서버, CLAUDE.md 파일 등 로컬 환경의 모든 요소는 동일하게 작동합니다. 오직 모델 호출 방식만 변경되며, 이에 따라 다음 네 가지 요소가 함께 바뀝니다: 요청이 통과하는 네트워크, 비용을 지불하는 계정, 호출 가능한 Claude 모델, 그리고 서버 측에서 제공되는 기능의 범위입니다.

작동 여부는 문제가 되지 않습니다. 정상적으로 작동하기 때문입니다. 중요한 것은 앞서 언급한 네 가지 요소 중 무엇을 가장 중요하게 고려하느냐 하는 점입니다.

세 가지 라우팅 방식과 각 비용 구조

Anthropic 직접 구독 방식. claude.ai 계정으로 Pro, Max, Team 또는 Enterprise 플랜에 로그인합니다. 요청은 Anthropic API로 전달됩니다. Pro, Max, Team 플랜은 사용자당 요금을 지불하며, 사용량은 토큰 단위가 아닌 플랜의 제한에 따라 결정됩니다. 단, 현재의 Enterprise 플랜은 예외입니다. 사용자당 요금에 사용량이 포함되지 않으며, 모든 토큰은 표준 API 요금으로 별도 청구됩니다. 기존의 사용자 기반 Enterprise 계약도 갱신 시점에 이 모델로 전환됩니다. 이 방식은 웹상의 Claude Code, 모바일 앱, Remote Control 등 계정 기반 인터페이스를 사용할 수 있는 유일한 라우팅 경로입니다. Team 플랜은 이미 싱글 사인온(SSO)과 조직 전체의 Claude Code 설정을 관리하는 서버 관리 기능을 포함하며, Claude Enterprise 플랜은 여기에 감사 로그, SCIM, 데이터 보존 제어, Compliance API 기능을 추가로 제공합니다.

Anthropic 직접 API 키 방식. Anthropic Console에서 키를 생성하고 토큰당 요금을 지불합니다. 구독 방식과 동일한 인프라와 리전을 사용하며, 사용자당 요금은 없습니다. 사용량은 Anthropic 대시보드에서 확인할 수 있습니다. 두 방식 중 어느 것이 더 저렴한지는 에이전트가 하루에 실제로 몇 시간 동안 실행되는지에 따라 달라지며, 이는 API와 구독 비용 비교 및 Claude Code의 실제 비용에서 다루는 핵심 주제입니다.

Bedrock 또는 Vertex의 타사 엔드포인트 방식. 사용자의 AWS 또는 Google Cloud 계정에서 모델을 서비스합니다. 추론 시점에 Anthropic은 요청 경로에 포함되지 않습니다. 토큰 비용은 기존에 사용 중인 청구서에 합산되며, 이미 운영 중인 IAM(Identity and Access Management) 정책과 감사 로그가 적용됩니다. 이 외에도 Microsoft Foundry와 AWS의 Claude Platform이라는 두 가지 타사 옵션이 더 존재하며, 이들 역시 동일한 구조를 따릅니다. 환경 변수 하나로 제공자를 선택하며, 비용은 클라우드 계정으로 청구됩니다.

명칭 관련 참고 사항(2026년 10월 기준): Google은 Vertex AI의 명칭을 Google Cloud's Agent Platform으로 변경했습니다. Anthropic 문서는 새로운 명칭을 사용하지만, Claude Code 로그인 프롬프트에는 여전히 Google Vertex AI로 표시되며 환경 변수 또한 VERTEX를 그대로 사용합니다.

데이터 레지던시는 팀이 이 방식을 선택하는 실질적인 이유입니다

Bedrock에서는 요청이 사용자가 선택한 AWS 리전 내의 본인 계정으로 위치한 Bedrock 엔드포인트로 전달됩니다. 저장 데이터는 AWS 관리형 키를 사용하여 AES-256으로 암호화되며, AWS KMS(Key Management Service)를 통해 직접 관리하는 키를 제공할 수도 있습니다. Vertex에서는 이와 동일한 기능으로 Google 관리형 암호화 키가 제공되며, CMEK(Customer-Managed Encryption Keys)도 사용할 수 있습니다. 접근 권한은 기존에 사용 중인 IAM 역할을 통해 제어되며, 호출 기록은 다른 API 호출과 마찬가지로 CloudTrail 또는 Cloud Audit Logs에 남습니다. 규제 대상 팀에게는 이것이 가장 중요한 논거이며, 충분히 타당한 이유입니다.

마케팅 문구에서 제시하는 것보다 절대적이지 않게 만드는 두 가지 세부 사항이 있습니다.

교차 리전 추론 프로파일은 단일 리전이 아닙니다. Bedrock에서 Claude Code는 내장된 기본 모델을 교차 리전 추론 프로파일 ID로 확인하며, 선호하는 접두사는 확인된 리전에서 가져옵니다. us.은 us-* 리전에서, eu.은 eu-* 리전에서, apac.는 ap-* 리전에서, us-gov.은 GovCloud에서 사용됩니다. 교차 리전 프로파일은 해당 지리적 위치 내의 다른 리전에서 요청을 처리할 수 있으므로, 보장되는 것은 특정 도시가 아닌 지리적 영역입니다. 요구 사항에 특정 리전을 명시해야 한다면, 직접 제어하는 애플리케이션 추론 프로파일을 통해 라우팅하고 ANTHROPIC_MODEL을 해당 ARN으로 설정하십시오.

일부 트래픽은 여전히 Anthropic으로 전송되지만, 코드 데이터는 포함되지 않습니다. 원격 측정, 오류 보고 및 /feedback 명령은 Bedrock과 Vertex 모두에서 기본적으로 비활성화되어 있으며, /feedback은 데이터를 업로드하는 대신 로컬 머신의 ~/.claude/feedback-bundles/ 아래에 아카이브를 기록합니다. 모든 제공자에서 두 가지 예외가 발생합니다. WebFetch 도구는 URL을 가져오기 전에 안전 차단 목록을 확인하기 위해 호스트 이름(호스트 이름만 해당)을 api.anthropic.com로 보냅니다. 세션 품질 설문조사도 여전히 나타날 수 있습니다. 첫 번째 기능은 설정 파일에서 skipWebFetchPreflight을 사용하여 끄고, 두 번째 기능은 CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1를 사용하여 끌 수 있습니다. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC를 설정하면 설문조사와 기타 비필수 트래픽이 모두 중단되지만, 별도의 수신 거부 설정을 유지하는 WebFetch 확인 기능에는 영향을 주지 않습니다.

학습 관련 사항: 상업적 조건에 따라 Anthropic은 Claude Code를 통해 전송된 코드나 프롬프트로 모델을 학습시키지 않으며, 타사 플랫폼 사용은 상업적 용도로 간주됩니다. 학습을 허용하는 옵트인 방식인 Development Partner Program은 Bedrock 또는 Vertex 사용자에게는 전혀 제공되지 않습니다. 이러한 엔드포인트에서의 데이터 보존 정책은 AWS 또는 Google과의 계약에 따릅니다.

Claude Code를 Amazon Bedrock에 연결하기

AWS 계정당 한 번씩, 클라이언트 설정 이전에 두 가지 작업을 수행해야 합니다. Amazon Bedrock 콘솔을 열고 모델 카탈로그에서 Anthropic 모델을 선택한 뒤 사용 사례 양식을 제출하십시오. 제출 즉시 접근 권한이 부여됩니다. 그 후 Claude Code가 호출을 수행할 수 있도록 허용하는 IAM 정책을 연결하십시오.

  • bedrock:InvokeModel
  • bedrock:InvokeModelWithResponseStream
  • bedrock:ListInferenceProfiles
  • bedrock:GetInferenceProfile

ListInferenceProfiles은 Claude Code가 시작 시점에 귀하의 계정에서 실제로 호출 가능한 모델을 확인할 수 있게 합니다. GetInferenceProfile은 애플리케이션 추론 프로필 ARN을 기반 모델로 해석하여 올바른 요청 형식을 선택할 수 있게 합니다. 이 권한이 없어도 요청은 성공하지만, Claude Code가 다른 형식으로 한 번 재시도하게 됩니다. 이 경우 오류가 발생하는 것이 아니라 새로운 모델마다 추가적인 왕복 통신이 발생합니다. Anthropic이 게시한 정책은 Bedrock을 통해 호출될 때 aws-marketplace:ViewSubscriptions 및 aws-marketplace:Subscribe도 허용하며, 이는 모델 구독 단계를 포함합니다.

가장 빠른 클라이언트 설정 방법은 마법사를 사용하는 것입니다. claude를 실행하고 3rd-party platform을 선택한 뒤 Amazon Bedrock을 선택하거나, 이미 로그인된 세션에서 /setup-bedrock를 입력하십시오. 이 도구는 ~/.aws 디렉터리의 프로필을 읽고 호출 가능한 모델을 확인한 뒤, 그 결과를 ~/.claude/settings.json의 env 블록에 기록하므로 셸 프로필에 의존하지 않습니다.

스크립트를 통한 배포를 원한다면 변수를 직접 설정하십시오.

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

자격 증명은 표준 AWS SDK 자격 증명 체인에서 가져오므로 aws CLI에서 이미 작동하는 방식(aws configure, SSO 프로필, 역할 수임(assumed role), Bedrock API 키 등)이 그대로 적용됩니다.

aws sso login --profile=your-profile-name
export AWS_PROFILE=your-profile-name
export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

베어러 토큰(bearer token)은 가장 간단한 옵션이지만 환경 변수에 저장되는 비밀값이므로 주의해서 다루어야 합니다. AWS는 최대 12시간 동안 유효한 단기 키와 설정한 날짜까지 유효한 장기 키를 발급하며, 장기 키는 탐색 용도로만 사용할 것을 권장합니다. 공유 빌드 서버에서는 만료되는 역할을 사용하는 것이 좋습니다. 동일한 논리가 에이전트가 읽을 수 있는 모든 자격 증명에 적용되며, 이에 관한 내용은 AI 에이전트가 비밀값에 접근하지 못하도록 차단하기에서 다룹니다.

리전 설정의 함정. Claude Code는 AWS_REGION, AWS_DEFAULT_REGION, 활성 AWS 프로필의 region, us-east-1 순서로 리전을 결정합니다. 마지막 단계는 오류가 아닌 기본값으로 처리되므로, 리전을 어디에도 설정하지 않고 유럽 라우팅을 가정했던 팀이 경고 없이 미국 리전으로 요청을 보낼 수 있습니다. Claude Code 내부에서 /status를 실행하여 결정된 리전과 그 출처를 확인하십시오. 특정 리전에서 계정이 호출할 수 있는 모델을 확인하려면 aws bedrock list-inference-profiles --region your-region을 실행하십시오.

Google Vertex AI에서 Claude Code 실행하기

API를 활성화하고 자격 증명을 준비합니다.

gcloud config set project YOUR-PROJECT-ID
gcloud services enable aiplatform.googleapis.com
gcloud auth application-default login

Model Garden에서 사용하려는 Claude 모델에 대한 접근 권한을 요청합니다. 승인은 즉시 이루어지지 않으므로 24시간에서 48시간 정도 기다려야 합니다. 모델 호출과 토큰 계산에 모두 사용되는 aiplatform.endpoints.predict 권한이 포함된 roles/aiplatform.user을 부여합니다.

그런 다음 공급자를 선택합니다.

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

CLOUD_ML_REGION는 eu이나 us와 같은 다중 리전 위치 또는 단일 리전을 나타내는 global을 인자로 받습니다. 글로벌 엔드포인트는 가용성이 가장 높지만 요청이 처리되는 위치에 대한 제어권은 가장 낮습니다. 따라서 데이터 거주지 요건이 있는 경우 일반적으로 특정 위치를 지정해야 합니다. 모델 지원 범위는 세 가지 형태에 따라 다릅니다. 필요한 모델이 글로벌 엔드포인트에서 누락된 경우, 해당 모델만 VERTEX_REGION_CLAUDE_* 변수를 사용하여 특정 위치에 고정하고 나머지는 글로벌로 둡니다. 시간이 지나면 정보가 달라질 수 있는 목록을 신뢰하기보다 현재 Vertex AI 위치 페이지를 확인하십시오.

프로젝트 관련 주의 사항. ANTHROPIC_VERTEX_PROJECT_ID는 요청이 전달되는 위치를 결정합니다. GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT 또는 GOOGLE_APPLICATION_CREDENTIALS이 지정한 자격 증명 파일에 다른 프로젝트가 명시되어 있더라도 Claude Code는 해당 요청을 이 프로젝트로 보냅니다. gcloud이 한 프로젝트를 가리키고 남겨진 ANTHROPIC_VERTEX_PROJECT_ID가 다른 프로젝트를 가리키는 환경에서는 요금이 두 번째 프로젝트로 청구되며, 세션 내에서 이를 경고하는 메시지는 표시되지 않습니다.

공급자를 변경한 후에는 반드시 확인하십시오. /status을 실행합니다. API provider 줄에는 Google Vertex AI가 표시되어야 하며, GCP project, Default region, Model 줄에는 Claude Code가 실제로 해석한 내용이 나타납니다. 공급자 줄이 누락되었다면 변수가 프로세스에 전달되지 않은 것입니다. 이는 claude을 실행한 셸과 다른 셸에서 변수를 export했기 때문입니다. 해당 변수들을 설정 파일의 env 블록으로 옮기십시오. 이 방법은 AWS_PROFILE과 같은 값을 시작하는 다른 모든 프로세스에서 분리하여 관리하는 방법이기도 합니다.

제공되는 모델과 도입 시점

sonnet 및 opus와 같은 별칭이 반드시 최신 모델을 의미하지는 않습니다. 타사 엔드포인트에서 이러한 별칭은 해당 공급자가 제공하는 Claude Code의 기본 설정으로 해석되는데, 이는 현재 릴리스보다 뒤처질 수 있으며 계정에서 아예 활성화되지 않았을 수도 있습니다. 기본 모델을 사용할 수 없는 경우, Claude Code는 해당 세션에서 이전 버전이나 하위 등급 모델로 대체하고 알림을 출력합니다. 대체 설정은 저장되지 않으므로 다음 세션에서 다시 시도하고 동일한 알림이 출력됩니다.

팀 단위로 배포할 때는 버전을 고정하십시오.

# Copy the exact IDs from your provider's own model catalog.
export ANTHROPIC_DEFAULT_OPUS_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_SONNET_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='<provider model id>'

모델 개요와 공급자의 카탈로그에서 ID를 가져오십시오. 공급자마다 형식이 다르기 때문입니다. Bedrock은 추론 프로필 ID나 ARN을 요구하며, Vertex는 일반 모델 이름을 요구합니다. 이 문서를 포함하여 기사에 적힌 내용을 그대로 복사하지 마십시오. 기본 주력 모델은 Opus급 모델이며 Opus는 Sonnet보다 토큰당 비용이 높기 때문에, 모델을 고정하는 것은 비용 관리 측면에서도 중요합니다. 아무것도 고정하지 않은 배포 환경은 더 높은 요금이 청구됩니다. 대신 특정 모델을 세션 기본값으로 고정하려면 ANTHROPIC_MODEL을 해당 모델의 전체 ID로 설정하십시오.

모델 도입 시점은 이 비교에서 가장 명확한 차이점입니다. Anthropic의 자체 API에서는 모델이 출시되는 당일에 바로 사용할 수 있습니다. 반면 Bedrock과 Vertex에서는 클라우드 공급자가 해당 리전에서 모델을 활성화하고 계정에 접근 권한을 부여한 후에야 사용할 수 있으며, 이는 최소 며칠에서 길게는 훨씬 더 오랜 시간이 걸릴 수 있습니다. 최신 모델에서 반드시 실행해야 하는 작업이 있다면, 해당 모델에 접근할 수 있는 라우팅 경로를 하나 유지하십시오. 이것이 바로 서로 다른 작업에 서로 다른 모델을 라우팅하는 실질적인 이유입니다.

Bedrock 및 Vertex 사용 시 제한 사항

로컬에서 작동하는 모든 기능은 공급자와 관계없이 동일하게 동작합니다. 여기에는 하위 에이전트(subagents), 훅(hooks), 슬래시 커맨드(slash commands), 스킬(skills), 플러그인(plugins), 체크포인트(checkpoints), 샌드박싱(sandboxing), 관리형 설정 파일 및 OpenTelemetry 메트릭이 포함됩니다. 차이점은 모두 서버 측에서 발생합니다.

두 엔드포인트 모두에서 사용할 수 없는 기능: fast mode, Advisor, Channels, 분석 대시보드, 서버 관리형 설정, 그리고 /design-sync 및 /import 커맨드. 또한 claude.ai 계정이 필요한 모든 기능(웹상의 Claude Code, 모바일 앱, Remote Control, 루틴 및 아티팩트)도 사용할 수 없습니다.

Bedrock 전용 제한: WebSearch 도구가 존재하지 않으므로, Bedrock으로 라우팅된 세션에서는 Claude가 검색을 수행할 수 없습니다. 다만 URL을 제공할 경우 WebFetch를 사용하여 페이지 내용을 읽는 것은 가능합니다. Vertex에서는 Claude 4 생성 모델 이상부터 웹 검색 기능이 정상적으로 작동합니다.

두 엔드포인트 모두에서 부분적으로 지원되는 기능: auto mode는 제한된 최신 모델 세트에서만 실행되며, 세션 간 메시징은 동일한 머신 내의 다른 세션으로만 전달됩니다. 또한 스스로 간격을 선택하는 /loop 기능을 사용하려면 Claude Code v2.1.248 버전 이상이 필요합니다. 데스크톱은 3P(타사) 환경의 Claude Desktop을 통해서만 접근할 수 있으며, Vertex의 경우 관리형 설정으로 구성된 Enterprise 배포를 통해서도 접근 가능합니다. 이 목록은 변경될 수 있으므로, 팀에 특정 기능을 도입하기 전에 Anthropic의 기능 가용성 페이지를 먼저 확인하십시오.

비용은 누구에게 청구되는가

구독과 서드파티 엔드포인트는 별개의 구매 항목입니다. 어느 한쪽이 다른 쪽을 대체하지 않습니다.

이 점은 명확히 짚고 넘어가야 합니다. 실수가 발생해도 즉각 드러나지 않기 때문입니다. Max 시트 계정으로 로그인된 머신에서 CLAUDE_CODE_USE_BEDROCK=1를 설정하면, 트래픽 비용은 AWS에 청구됩니다. Bedrock의 온디맨드 요금제에 따라 토큰 단위로 과금되거나, 계정에서 구매한 프로비저닝된 처리량(provisioned throughput)에서 차감됩니다. 시트 비용은 매달 별도로 청구되며, 해당 트래픽 비용은 전혀 포함하지 않습니다. 통합된 비용 조회 기능도 없습니다. 지출 내역은 AWS Cost Explorer나 Google Cloud Billing으로 넘어가며, Anthropic 분석 대시보드는 어떤 제공업체에서도 사용할 수 없습니다. Anthropic 세션을 종료할 필요가 없으므로 /logout 명령도 사라집니다. 클라우드 자격 증명이 곧 인증 수단이 되기 때문입니다.

요금은 제공업체의 페이지에 명시되어 있으며 수시로 변경되므로, 기사에 적힌 수치보다는 Amazon Bedrock 요금 또는 Vertex AI 요금 페이지를 직접 확인하십시오. 변하지 않는 구조적 특징은 있습니다. 이러한 엔드포인트에서의 온디맨드 추론은 토큰당 과금되므로, 에이전트를 하루 종일 실행해 두면 요금제 한도와 관계없이 사용량만큼 비용이 발생합니다. 두 클라우드 서비스가 모두 제공하는 대안은 프로비저닝된 처리량으로, 보유하는 동안 고정 요금을 내는 예약 용량 방식입니다. AWS는 이를 시간 단위로 청구하며, Claude Code에서 모델 ID로 프로비저닝된 처리량 ARN을 설정하면 해당 용량을 사용합니다. 팀 전체에 시트를 구매하는 것보다 어느 쪽이 경제적인지는 첫 청구서가 나오기 전에 미리 계산해 보아야 하며, Team 및 Enterprise를 위한 시트 비용과 토큰당 비용 비교에서 팀 규모에 따른 비교를 확인할 수 있습니다.

요금 제한과 할당량은 라우팅 방식에 따라 다르게 작동합니다

구독 모델에서 제한은 계정에 귀속되며 일정 주기에 따라 초기화됩니다. 제한에 도달하면 사용 크레딧이 활성화되지 않은 이상 대기해야 합니다. Pro 및 Max 구독자, Team 및 기존 좌석 기반 Enterprise 조직은 지출 한도 내에서 표준 API 요금으로 제한을 초과하여 계속 작업할 수 있습니다. 현재의 사용량 기반 Enterprise 플랜은 모든 토큰이 이미 청구되므로 소진될 허용량이 별도로 존재하지 않습니다. 해당 동작에 대한 자세한 내용은 사용량 제한 작동 방식에서 확인할 수 있습니다.

Anthropic API 키에서 제한은 조직에 귀속되며 분당 요청 수 및 토큰 수로 표현되고, 사용 등급에 따라 증가합니다.

Bedrock 및 Vertex에서 제한은 Anthropic 플랜과 무관한 클라우드 할당량입니다. Bedrock의 경우 계정 및 리전별로 설정되며 대부분 모델별로 적용됩니다. 또한 계정 전체에 대한 일일 토큰 할당량이 추가로 존재합니다. Vertex의 경우 프로젝트 및 위치별로 설정되며, 글로벌 및 멀티 리전 엔드포인트의 경우 2026년 5월 26일 이후 출시된 Claude 모델은 모델 계보당 하나의 할당량을 공유합니다. 즉, 특정 위치에서 동일한 모델 제품군의 모든 버전이 같은 버킷을 공유하며, 글로벌 엔드포인트와 각 멀티 리전 엔드포인트는 별도의 버킷을 유지합니다. 429 오류는 일반적으로 이러한 할당량 중 하나가 소진되었음을 의미하지만, 공유 종량제 용량에서는 공급자의 용량이 부족하다는 의미일 수도 있으므로 설정을 변경하기 전에 백오프를 적용하여 재시도하십시오. 할당량 문제인 경우 공급자 콘솔에서 해결해야 합니다. 할당량 증액을 요청하거나 여유가 있는 위치로 이동하십시오. Bedrock은 단순 요청 횟수가 아닌 토큰 번다운 규칙에 따라 할당량을 차감하며, 두 클라우드 모두에서 예약된 용량은 프로비저닝된 처리량으로 구매합니다. Vertex에서 429 오류는 종종 단일 리전 엔드포인트가 기본 모델과 작고 빠른 모델을 모두 지원하지 않음을 의미하며, 이것이 CLOUD_ML_REGION=global이 문서화된 시작 지점인 이유입니다. Google의 할당량 페이지에서 증액 요청 방법을 확인할 수 있습니다.

실패 유형 및 표시되는 메시지

Could not load the default credentials, Vertex 사용 시. 애플리케이션 기본 자격 증명(Application Default Credentials)이 없거나 만료되었습니다. gcloud auth application-default login을 실행하거나, GOOGLE_APPLICATION_CREDENTIALS를 서비스 계정 키 파일로 지정하십시오.

Vertex 사용 시 모델 이름을 포함한 404 오류. 해당 프로젝트의 Model Garden에서 모델이 활성화되지 않았거나, 설정한 위치에서 제공되지 않는 모델입니다. 일부 모델은 특정 리전이 아닌 글로벌 엔드포인트나 eu와 같은 다중 리전 위치에서만 제공됩니다.

on-demand throughput isn't supported, Bedrock 사용 시. 추론 프로필(inference profile)을 통해서만 제공되는 모델에 대해 기본 모델 ID를 직접 전달했습니다. 대신 추론 프로필 ID를 사용하십시오.

AWS default-chain credential resolve timed out. AWS 자격 증명 체인의 단계가 중단되었습니다. 대부분 입력을 받을 수 없는 상태에서 대기 중인 credential_process 도우미로 인해 발생합니다. 체인의 전체 확인 과정은 60초 후에 타임아웃됩니다. MFA(다중 인증)를 사용하는 브라우저 SSO 흐름처럼 체인 처리에 더 많은 시간이 필요한 경우, CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS을 사용하여 제한 시간을 밀리초 단위로 늘리십시오.

Bedrock streaming response has content-type 시작 오류. Claude Code와 Bedrock 사이의 무언가가 스트림을 재작성하고 있습니다. Bedrock은 application/vnd.amazon.eventstream 콘텐츠 유형의 바이너리 이벤트 스트림 형식으로 스트리밍하므로, 이를 서버 전송 이벤트(server-sent events)로 다시 방출하는 게이트웨이는 Claude Code가 디코딩할 수 없는 본문을 반환합니다. 응답 본문과 Content-Type 헤더를 변경 없이 통과시키도록 게이트웨이를 수정하십시오.

AWS SSO 중 브라우저 탭이 반복적으로 열림. 기업용 VPN이나 TLS 검사 프록시가 로그인을 방해하는 경우입니다. Claude Code는 끊어진 연결을 인증 실패로 간주하여 awsAuthRefresh 명령을 계속 재실행합니다. 설정 파일에서 awsAuthRefresh를 제거하고, Claude Code를 시작하기 전에 aws sso login을 수동으로 실행하십시오.

라우팅 선택하기

출시 당일에 새로운 모델을 사용하고 전체 기능을 활용하려면 Anthropic direct를 선택하십시오. 좌석(seat) 구매 없이 토큰 단위로 비용을 지불하려면 API key를 선택하십시오. 이미 관리 중인 클라우드 계정 내에서 추론이 이루어져야 하며, 그 대가로 모델 파이프라인이 다소 느려지고 기능 목록이 제한되는 것을 감수할 수 있다면 Bedrock이나 Vertex를 선택하십시오. Amazon Bedrock 및 Google Vertex AI를 위한 Anthropic 공식 설정 페이지와 AWS의 리전별 모델 목록은 즐겨찾기에 추가해 둘 가치가 있습니다.

세 가지 방식 모두 에이전트가 실행되는 위치를 변경하지는 않습니다. Claude Code는 어떤 엔드포인트를 사용하든 관계없이 로컬에서 실행되는 프로세스이며, 사용자의 파일을 읽고 명령을 수행합니다. 이것이 바로 노트북이 아닌 다른 곳에서 에이전트를 실행하려는 팀이 코딩 에이전트를 VPS에 배치하고 동일한 환경 변수를 해당 환경으로 내보내는 이유입니다.

FAQ

Claude 구독으로 Bedrock이나 Vertex에서 Claude Code를 사용할 수 있습니까?

아니요. Pro, Max, Team 또는 Enterprise 라이선스와 타사 엔드포인트는 별도의 구매 항목이며 서로 포함되지 않습니다. CLAUDE_CODE_USE_BEDROCK=1 또는 CLAUDE_CODE_USE_VERTEX=1이 설정된 경우, 트래픽은 AWS 또는 Google Cloud의 온디맨드 요금제나 구매한 프로비저닝 처리량에 따라 해당 클라우드 청구서로 토큰당 비용이 청구됩니다. 라이선스 비용은 기존 서비스 범위에 대해 매달 청구됩니다. Anthropic 분석 대시보드는 두 제공업체에서 사용할 수 없으므로, 비용 추적은 AWS Cost Explorer나 Google Cloud Billing에서 확인해야 합니다.

Claude Code는 Amazon Bedrock에서 어떤 리전으로 요청을 보냅니까?

/status 명령어로 확인할 수 있는 리전으로 요청이 전달됩니다. Claude Code는 AWS_REGION, AWS_DEFAULT_REGION, 그리고 활성 AWS 프로필의 region 순서로 확인하며, 모두 설정되지 않은 경우 us-east-1로 대체합니다. 내장된 기본 모델은 해당 리전의 접두사를 따르는 교차 리전 추론 프로필(예: us. 또는 eu.)로 연결되며, 교차 리전 프로필은 동일한 지리적 영역 내의 다른 리전에서 요청을 처리할 수 있습니다. 특정 리전을 반드시 사용해야 한다면 직접 관리하는 애플리케이션 추론 프로필을 사용하고 ANTHROPIC_MODEL에 해당 ARN을 설정하십시오.

Bedrock이나 Vertex 계정에 최신 Claude 모델이 보이지 않는 이유는 무엇입니까?

각 클라우드 제공업체는 자체 일정에 따라 모델을 활성화하며, 계정별로 별도의 접근 권한을 승인받아야 하기 때문입니다. Vertex의 경우 Model Garden에서 접근 권한을 요청해야 하며 승인까지 24시간에서 48시간이 소요될 수 있습니다. 승인 전까지 sonnet 및 opus과 같은 별칭은 해당 제공업체에 대한 Claude Code의 기본 설정으로 연결됩니다. 해당 기본 모델을 사용할 수 없는 경우 Claude Code는 세션에 대해 이전 모델이나 하위 등급 모델로 대체하고 알림을 표시합니다. ANTHROPIC_DEFAULT_SONNET_MODEL 및 관련 모델은 사용 권한이 확인된 ID로 고정하십시오.

Amazon Bedrock의 Claude Code에서 웹 검색을 사용할 수 있습니까?

아니요. WebSearch 도구는 Bedrock에서 사용할 수 없으므로 해당 경로로 연결된 세션에서는 Claude가 검색을 수행할 수 없습니다. URL을 직접 제공하면 WebFetch를 통해 특정 페이지를 읽을 수는 있습니다. Google Vertex AI에서는 Claude 4 생성 모델 이상부터 웹 검색이 작동하며, 이는 Vertex가 가지는 몇 안 되는 기능적 차이점 중 하나입니다.

Bedrock이나 Vertex에서 Claude Code를 실행하려면 Anthropic 계정이 필요합니까?

아니요. 인증은 AWS 또는 Google Cloud 자격 증명을 사용하므로 두 제공업체 모두에서 /logout을 사용할 수 없습니다. 어떤 제공업체를 사용하든 Anthropic과의 연결은 하나만 유지됩니다. WebFetch 도구는 URL을 가져오기 전에 안전 차단 목록 확인을 위해 호스트 이름(호스트 이름만 해당)을 api.anthropic.com로 전송합니다. 이를 비활성화하려면 설정 파일에 skipWebFetchPreflight을 설정하십시오. Claude가 접근할 수 있는 도메인을 제한하려면 WebFetch 권한 규칙과 함께 사용하십시오.

이 글이 도움이 되었나요?