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

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

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

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

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

구독을 통한 Anthropic 직접 연결. Pro, Max, Team 또는 Enterprise 플랜의 claude.ai 계정으로 로그인합니다. 요청은 Anthropic API로 전달됩니다. 사용자당 비용을 지불하며, 사용량은 토큰 단위가 아닌 플랜의 제한에 따라 결정됩니다. 이 라우팅 방식만이 웹상의 Claude Code, 모바일 앱, 데스크톱 및 원격 제어와 같이 계정 기반으로 구축된 인터페이스를 사용할 수 있는 유일한 방법입니다. 팀의 경우, Claude Enterprise 플랜을 통해 싱글 사인온(SSO)과 관리형 정책 설정을 추가할 수 있습니다.

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

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

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

데이터 레지던시가 팀들이 이 방식을 선택하는 진짜 이유입니다

Bedrock에서는 요청이 사용자가 선택한 AWS 리전 내의 사용자 계정으로 직접 전송됩니다. 저장 데이터는 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을 사용하여 필수적이지 않은 모든 트래픽을 한 번에 비활성화할 수 있습니다.

학습 관련 사항: 상업적 계약 조건에 따라 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가 다른 형식으로 한 번 재시도하게 됩니다. 이 경우 오류가 발생하는 것이 아니라 새로운 모델마다 추가적인 왕복 통신이 발생합니다.

가장 빠른 클라이언트 설정 방법은 마법사를 사용하는 것입니다. 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)은 가장 간단한 옵션이지만 환경 변수에 저장되는 장기 비밀값이므로 주의해서 다루어야 합니다. 공유 빌드 서버에서는 만료되는 역할을 사용하는 것이 좋습니다. 에이전트가 읽을 수 있는 다른 모든 자격 증명도 같은 이유로 주의가 필요하며, 이는 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은 프로젝트 ID를 결정하는 가장 낮은 우선순위의 소스입니다. GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT 및 GOOGLE_APPLICATION_CREDENTIALS로 지정된 자격 증명 파일이 모두 이보다 우선합니다. 이러한 항목 중 하나가 이미 내보내진(exported) 환경에서는 비용이 해당 프로젝트로 청구되며, 세션 내 어디에서도 이를 알려주지 않습니다.

공급자 변경 후에는 반드시 확인하십시오. /status를 실행하면 API provider 라인에 Google Vertex AI가 표시되며, GCP project, Default region, Model 라인에는 Claude Code가 실제로 인식한 설정이 나타납니다. 공급자 라인이 누락되었다면 claude을 실행한 셸과 다른 셸에서 변수가 내보내졌기 때문에 해당 변수가 프로세스에 전달되지 않은 것입니다. 이 변수들을 설정 파일의 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 사용 시 제한 사항

로컬에서 작동하는 모든 기능은 어떤 제공업체를 사용하든 동일하게 동작합니다. 여기에는 서브 에이전트, 훅, 슬래시 명령어, 스킬, 플러그인, 체크포인트, 샌드박싱, 관리형 설정 파일 및 OpenTelemetry 메트릭이 포함됩니다. 차이가 발생하는 부분은 모두 서버 측입니다.

두 엔드포인트 모두에서 사용할 수 없는 기능: 패스트 모드, Advisor, 채널, 세션 간 메시징, 분석 대시보드 및 서버 관리형 설정. 또한 claude.ai 계정이 필요한 모든 기능도 사용할 수 없습니다. 여기에는 웹상의 Claude Code, 모바일 앱, 데스크톱, 원격 제어, 루틴 및 아티팩트가 포함됩니다.

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

두 엔드포인트 모두에서 부분적으로 지원되는 기능: 오토 모드는 제한된 최신 모델 세트에서만 실행되며, /loop는 스스로 간격을 선택할 수 없으므로 명시적인 간격 설정이 필요합니다. 이 목록은 변경될 수 있으므로, 팀에 특정 기능을 제공하기 전에 Anthropic의 기능 가용성 페이지를 먼저 확인하십시오.

비용 청구 주체

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

이 점은 명확히 짚고 넘어갈 필요가 있습니다. 실수가 발생해도 즉각적인 알림이 없기 때문입니다. Max 시트가 로그인된 장비에서 CLAUDE_CODE_USE_BEDROCK=1를 설정하면, 모든 토큰은 AWS Bedrock 요금 체계에 따라 측정됩니다. 시트 요금은 매달 그대로 청구되며, 해당 트래픽 비용은 전혀 포함되지 않습니다. 통합된 비용 조회 기능도 없습니다. 지출 내역은 AWS Cost Explorer나 Google Cloud Billing으로 넘어가며, Anthropic 분석 대시보드는 어떤 제공업체에서도 사용할 수 없습니다. 종료할 Anthropic 세션이 없으므로 /logout 명령도 사라집니다. 이때 사용되는 자격 증명은 클라우드 제공업체의 자격 증명입니다.

요금은 제공업체의 페이지에 명시되어 있으며 수시로 변경되므로, 기사에 적힌 수치보다는 Amazon Bedrock 요금이나 Vertex AI 요금 페이지를 직접 확인하십시오. 변하지 않는 구조적 특징은 다음과 같습니다. 이러한 엔드포인트에서는 토큰 단위로 추론 비용을 지불하므로, 에이전트를 하루 종일 실행해 두면 요금 제한 없이 사용량만큼 비용이 발생합니다.

라우팅 방식에 따른 속도 제한 및 할당량의 차이

구독 모델에서 제한은 계정에 귀속되며 정해진 주기에 따라 초기화됩니다. 제한에 도달하면 초기화될 때까지 기다려야 합니다. 해당 동작 방식은 사용량 제한 작동 방식에서 다룹니다.

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

Bedrock 및 Vertex의 경우, 제한은 클라우드 할당량(quota)이며 계정 또는 프로젝트별, 모델별, 리전별로 범위가 지정됩니다. 이는 Anthropic 플랜과는 아무런 관련이 없습니다. 429 오류는 해당 계정이 특정 리전의 특정 모델에 대한 할당량을 초과했음을 의미합니다. 따라서 해결 방법은 제공자의 콘솔에서 찾아야 합니다. 할당량 증액을 요청하거나 여유가 있는 리전으로 이동하십시오. Bedrock은 단순 요청 횟수가 아닌 토큰 소진(token burndown) 규칙에 따라 할당량을 차감하며, 예약된 용량은 프로비저닝된 처리량(provisioned throughput)으로 구매합니다. Vertex에서 429 오류가 발생하는 경우는 대개 단일 리전 엔드포인트가 기본 모델과 소형 고속 모델을 동시에 처리하지 못하기 때문이며, 이것이 바로 CLOUD_ML_REGION=global이 문서화된 시작 지점인 이유입니다. Google의 할당량(quotas) 페이지에서 증액 요청 방법을 확인할 수 있습니다.

발생 가능한 오류 유형 및 메시지

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 콘텐츠 타입의 바이너리 이벤트 스트림 형식으로 데이터를 전송합니다. 이를 서버 전송 이벤트(SSE)로 재전송하는 게이트웨이를 거치면 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 권한 규칙과 함께 사용하십시오.