Claude Platform Docs
MessagesGoogle Cloud

Claude Models on Google Cloud

Claude Models on Google Cloud (Anthropic managed)와 Claude Models on Google Cloud (Google managed)를 비교하고, 어떤 것을 사용하고 있는지 확인하세요.

Google Cloud 프로젝트를 통해 Claude를 사용하는 방법은 두 가지입니다:

두 Google Cloud 제공 방식의 차이점

다음 표는 Claude Models on Google Cloud (Anthropic managed)와 Claude Models on Google Cloud (Google managed)를 비교합니다.

항목Claude Models on Google Cloud (Anthropic managed)Claude Models on Google Cloud (Google managed)
API 표면Claude API 엔드포인트
/v1/{endpoint}		Agent Platform 예측 엔드포인트
요청 형식Claude API와 동일
요청 본문의 model
anthropic-version 헤더		URL의 model
요청 본문의 anthropic_version
스트리밍요청 본문의 "stream": true별도의 :streamRawPredict 엔드포인트
위치global
프로젝트, 위치 및 워크스페이스 확인을 참조하세요.		글로벌, 멀티 리전 또는 리전 엔드포인트
글로벌, 멀티 리전 및 리전 엔드포인트를 참조하세요.
Claude 4.6 이전 모델의 모델 IDClaude API ID
예: claude-haiku-4-5-20251001		스냅샷 날짜 앞의 하이픈 대신 @를 사용하는 Claude API ID
예: claude-haiku-4-5@20251001
모델 ID 및 버전 관리를 참조하세요.
프로젝트에서 활성화할 서비스계정 설정을 참조하세요.Agent Platform API
aiplatform.googleapis.com
Anthropic 조직프로젝트용 새 Anthropic 조직없음
결제Google Cloud MarketplaceAgent Platform 사용량으로 Google Cloud에서 결제
속도 제한Anthropic이 관리Google Cloud가 관리

두 제공 방식의 공통점

두 제공 방식 간 전환

전환하려는 제공 방식에 해당하는 단계를 따르세요:

어떤 제공 방식을 사용하고 있나요?

다음 표는 Claude Models on Google Cloud (Anthropic managed)와 Claude Models on Google Cloud (Google managed)를 식별하는 값을 나열합니다. 이미 가지고 있는 값을 찾아보세요. 예를 들어, 요청 URL의 호스트나 코드의 SDK 클라이언트를 확인하세요. 해당 값 위의 열 제목이 사용 중인 제공 방식입니다.

확인할 항목Claude Models on Google Cloud (Anthropic managed)Claude Models on Google Cloud (Google managed)
요청이 전송되는 위치claude.googleapis.com
URL에 워크스페이스 ID가 포함됩니다.
.../invoke/v1/messages와 같은 Claude API 경로로 끝납니다.		다음 Agent Platform 호스트 중 하나:
aiplatform.googleapis.com
aiplatform.us.rep.googleapis.com
aiplatform.eu.rep.googleapis.com
{region}-aiplatform.googleapis.com
URL 경로에 .../publishers/anthropic/models/{model}이 포함됩니다.
:rawPredict 또는 :streamRawPredict로 끝납니다.
코드의 SDK 클라이언트AnthropicGoogleCloud
모든 SDK에서 클라이언트 이름에 GoogleCloud가 포함됩니다(Go에서는 모두 소문자).		AnthropicVertex
모든 SDK에서 클라이언트 이름에 Vertex가 포함됩니다(Go에서는 모두 소문자).
액세스 권한을 부여하는 IAM 역할roles/claude.admin
roles/claude.user
roles/claude.viewer		Agent Platform IAM 역할
관리 콘솔platform.claude.com의 Claude Console
Google Cloud 콘솔에서 엽니다.		Google Cloud 콘솔
Google Cloud 콘솔에서 각 제공 방식이 표시되는 위치Anthropic managed라는 레이블이 붙은 옵션
계정 설정을 참조하세요.		Model Garden의 Claude 모델

API 키로 api.anthropic.com을 호출하는 경우 두 제공 방식 중 어느 것도 사용하지 않는 것입니다. 이러한 호출을 Claude Models on Google Cloud (Anthropic managed)로 옮기려면 기존 Anthropic 조직에서 이전하기를 참조하세요.

다음 단계

Claude Models on Google Cloud (Anthropic managed)

계정을 설정하고 첫 번째 요청을 보내세요.

Claude Models on Google Cloud (Google managed)

SDK를 설치하고 첫 번째 요청을 보내세요.

Claude Models on Google Cloud (Anthropic managed)의 IAM 권한

권한, 역할 및 감사 로그 유형을 확인하세요.

Was this page helpful?