--- title: Claude Models on Google Cloud url: https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/overview description: Claude Models on Google Cloud (Anthropic managed)와 Claude Models on Google Cloud (Google managed)를 비교하고, 어떤 것을 사용하고 있는지 확인하세요. --- Google Cloud 프로젝트를 통해 Claude를 사용하는 방법은 두 가지입니다: * **[Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed):** Anthropic이 [Claude API](https://platform.claude.com/docs/ko/api/overview)를 운영합니다. * **[Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed):** Google이 Google Cloud's Agent Platform의 일부로 Claude 모델을 운영합니다. ## 두 Google Cloud 제공 방식의 차이점 다음 표는 Claude Models on Google Cloud (Anthropic managed)와 Claude Models on Google Cloud (Google managed)를 비교합니다. | 항목 | [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed) | [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/ko/build-with-claude/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`
[프로젝트, 위치 및 워크스페이스 확인](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution)을 참조하세요. | 글로벌, 멀티 리전 또는 리전 엔드포인트
[글로벌, 멀티 리전 및 리전 엔드포인트](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#global-multi-region-and-regional-endpoints)를 참조하세요. | | **Claude 4.6 이전 모델의 모델 ID** | Claude API ID
예: `claude-haiku-4-5-20251001` | 스냅샷 날짜 앞의 하이픈 대신 `@`를 사용하는 Claude API ID
예: `claude-haiku-4-5@20251001`
[모델 ID 및 버전 관리](https://platform.claude.com/docs/ko/about-claude/models/model-ids-and-versions)를 참조하세요. | | **프로젝트에서 활성화할 서비스** | [계정 설정](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account)을 참조하세요. | Agent Platform API
`aiplatform.googleapis.com` | | **Anthropic 조직** | 프로젝트용 새 Anthropic 조직 | 없음 | | **결제** | Google Cloud Marketplace | Agent Platform 사용량으로 Google Cloud에서 결제 | | **속도 제한** | Anthropic이 관리 | Google Cloud가 관리 | ## 두 제공 방식의 공통점 * **자격 증명:** 두 제공 방식 모두 Application Default Credentials를 포함한 Google Cloud 자격 증명을 사용합니다. 각 제공 방식에 대한 액세스 권한은 해당 방식의 자체 IAM 역할을 통해 별도로 부여합니다. * [Claude Models on Google Cloud (Anthropic managed)의 자격 증명](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed#authentication) * [Claude Models on Google Cloud (Google managed)의 자격 증명](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#before-making-api-calls) * **결제:** 두 제공 방식의 요금은 모두 Google Cloud 청구서에 표시됩니다. * [Claude Models on Google Cloud (Anthropic managed)의 결제](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed#billing) * [Claude Models on Google Cloud (Google managed)의 결제](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#billing) * **모델 ID:** Claude 4.6 이상 모델은 두 제공 방식 모두에서 Claude API ID를 사용합니다. [모델 ID 및 버전 관리](https://platform.claude.com/docs/ko/about-claude/models/model-ids-and-versions)를 참조하세요. * **SDK:** Anthropic의 [클라이언트 SDK](https://platform.claude.com/docs/ko/cli-sdks-libraries/overview)는 두 제공 방식을 모두 지원합니다. ## 두 제공 방식 간 전환 전환하려는 제공 방식에 해당하는 단계를 따르세요: * [Claude Models on Google Cloud (Anthropic managed)로 전환하는 단계](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed#migrating-from-google-managed) * [Claude Models on Google Cloud (Google managed)로 전환하는 단계](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#migrating-from-anthropic-managed) ## 어떤 제공 방식을 사용하고 있나요? 다음 표는 Claude Models on Google Cloud (Anthropic managed)와 Claude Models on Google Cloud (Google managed)를 식별하는 값을 나열합니다. 이미 가지고 있는 값을 찾아보세요. 예를 들어, 요청 URL의 호스트나 코드의 SDK 클라이언트를 확인하세요. 해당 값 위의 열 제목이 사용 중인 제공 방식입니다. | 확인할 항목 | [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed) | [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/ko/build-with-claude/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` (csharp: `AnthropicGoogleCloudClient`; go: `googlecloud.NewClient`; java: `GoogleCloudBackend`; php: `Anthropic\GoogleCloud\Client`; ruby: `Anthropic::GoogleCloudClient`)
모든 SDK에서 클라이언트 이름에 `GoogleCloud`가 포함됩니다(Go에서는 모두 소문자). | `AnthropicVertex` (csharp: `AnthropicVertexClient`; go: `vertex.WithGoogleAuth`; java: `VertexBackend`; php: `Anthropic\Vertex\Client`; ruby: `Anthropic::VertexClient`)
모든 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**라는 레이블이 붙은 옵션
[계정 설정](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account)을 참조하세요. | [Model Garden](https://cloud.google.com/model-garden)의 Claude 모델 | API 키로 `api.anthropic.com`을 호출하는 경우 두 제공 방식 중 어느 것도 사용하지 않는 것입니다. 이러한 호출을 Claude Models on Google Cloud (Anthropic managed)로 옮기려면 [기존 Anthropic 조직에서 이전하기](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed#moving-from-an-existing-anthropic-organization)를 참조하세요. ## 다음 단계 계정을 설정하고 첫 번째 요청을 보내세요. SDK를 설치하고 첫 번째 요청을 보내세요. 권한, 역할 및 감사 로그 유형을 확인하세요.