Claude에 액세스하기 위한 Vertex API는 Messages API와 거의 동일하며 동일한 모든 옵션을 지원하지만 두 가지 주요 차이점이 있습니다:
  • Vertex에서는 model이 요청 본문에 전달되지 않습니다. 대신 Google Cloud 엔드포인트 URL에서 지정됩니다.
  • Vertex에서는 anthropic_version이 요청 본문에 전달되며(헤더가 아님), vertex-2023-10-16 값으로 설정되어야 합니다.
Vertex는 Anthropic의 공식 클라이언트 SDK에서도 지원됩니다. 이 가이드는 Python 또는 TypeScript에서 Vertex AI의 Claude에 요청하는 프로세스를 안내합니다. 이 가이드는 Vertex AI를 사용할 수 있는 GCP 프로젝트가 이미 있다고 가정합니다. 필요한 설정 및 전체 연습에 대한 자세한 내용은 Anthropic의 Claude 3 모델 사용을 참조하세요.

​
Vertex AI에 액세스하기 위한 SDK 설치

먼저 선택한 언어에 대해 Anthropic의 클라이언트 SDK를 설치합니다. 
pip install -U google-cloud-aiplatform "anthropic[vertex]"

​
Vertex AI 액세스

​
모델 가용성

Anthropic 모델 가용성은 지역에 따라 다릅니다. Vertex AI Model Garden에서 “Claude”를 검색하거나 Claude 3 사용으로 이동하여 최신 정보를 확인하세요.

​
API 모델 ID

모델Vertex AI API 모델 ID
Claude Sonnet 4.5claude-sonnet-4-5@20250929Copied!
Claude Sonnet 4claude-sonnet-4@20250514Copied!
Claude Sonnet 3.7claude-3-7-sonnet@20250219Copied!
Claude Sonnet 3.5 claude-3-5-sonnet-v2@20241022Copied!
Claude Opus 4.1claude-opus-4-1@20250805Copied!
Claude Opus 4claude-opus-4@20250514Copied!
Claude Opus 3 claude-3-opus@20240229Copied!
Claude Haiku 4.5claude-haiku-4-5@20251001Copied!
Claude Haiku 3.5claude-3-5-haiku@20241022Copied!
Claude Haiku 3claude-3-haiku@20240307Copied!

​
요청 만들기

요청을 실행하기 전에 GCP로 인증하기 위해 gcloud auth application-default login을 실행해야 할 수 있습니다. 다음 예제는 Vertex AI의 Claude에서 텍스트를 생성하는 방법을 보여줍니다: 
from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-sonnet-4-5@20250929",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)
자세한 내용은 클라이언트 SDK 및 공식 Vertex AI 문서를 참조하세요.

​
활동 로깅

Vertex는 고객이 사용과 관련된 프롬프트 및 완료를 기록할 수 있는 요청-응답 로깅 서비스를 제공합니다. Anthropic은 활동을 이해하고 잠재적인 오용을 조사하기 위해 최소 30일 롤링 기준으로 활동을 기록할 것을 권장합니다.
이 서비스를 켜면 Google이나 Anthropic이 콘텐츠에 액세스할 수 없습니다.

​
기능 지원

Vertex에서 현재 지원되는 모든 기능은 여기에서 찾을 수 있습니다.

​
글로벌 대 지역 엔드포인트

Claude Sonnet 4.5 및 모든 향후 모델부터 Google Vertex AI는 두 가지 엔드포인트 유형을 제공합니다:
  • 글로벌 엔드포인트: 최대 가용성을 위한 동적 라우팅
  • 지역 엔드포인트: 특정 지리적 지역을 통한 보장된 데이터 라우팅
지역 엔드포인트는 글로벌 엔드포인트보다 10% 가격 프리미엄을 포함합니다.
이는 Claude Sonnet 4.5 및 향후 모델에만 적용됩니다. 이전 모델(Claude Sonnet 4, Opus 4 및 이전 버전)은 기존 가격 구조를 유지합니다.

​
각 옵션을 사용할 시기

글로벌 엔드포인트(권장):
  • 최대 가용성 및 가동 시간 제공
  • 사용 가능한 용량이 있는 지역으로 요청을 동적으로 라우팅
  • 가격 프리미엄 없음
  • 데이터 상주가 유연한 애플리케이션에 최적
  • 종량제 트래픽만 지원(프로비저닝된 처리량은 지역 엔드포인트 필요)
지역 엔드포인트:
  • 특정 지리적 지역을 통해 트래픽 라우팅
  • 데이터 상주 및 규정 준수 요구 사항에 필수
  • 종량제 및 프로비저닝된 처리량 모두 지원
  • 10% 가격 프리미엄은 전용 지역 용량의 인프라 비용을 반영합니다

​
구현

글로벌 엔드포인트 사용(권장): 클라이언트를 초기화할 때 region 매개변수를 "global"로 설정합니다: 
from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-sonnet-4-5@20250929",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)
지역 엔드포인트 사용: "us-east1" 또는 "europe-west1"과 같은 특정 지역을 지정합니다: 
from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east1"  # 특정 지역 지정

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-sonnet-4-5@20250929",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

​
추가 리소스