---
title: Claude Models on Google Cloud (Google managed)
url: https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed
description: Google은 Google Cloud's Agent Platform의 일부로 Claude Models on Google Cloud (Google managed)를 운영합니다. Anthropic의 클라이언트 SDK로 Claude를 호출할 수 있습니다.
---

[Claude Models on Google Cloud](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/overview)에서는 두 가지 Google Cloud 제품을 비교합니다. 또한 어떤 제품을 사용하고 있는지 확인하는 방법도 보여줍니다.

## API 호출 전 준비 사항

Claude Models on Google Cloud (Google managed)를 사용하려면 다음이 필요합니다:

1. Agent Platform을 사용할 수 있는 Google Cloud 프로젝트. 설정 단계는 Google Cloud의 [Anthropic Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude) 페이지를 참조하세요.
2. 로컬 개발을 위해 설치된 [gcloud CLI](https://cloud.google.com/sdk/docs/install).
3. 호출을 수행하는 ID에 대해 `aiplatform.endpoints.predict` 권한을 포함하는 IAM 역할(예: Agent Platform User(`roles/aiplatform.user`)). 자세한 내용은 Google Cloud의 [Agent Platform partner models](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models) 페이지를 참조하세요.
4. 해당 ID의 Google Cloud 자격 증명. SDK 예제의 경우 Google Cloud에 인증하기 위해 `gcloud auth application-default login`을 실행해야 할 수 있습니다. Claude Models on Google Cloud (Google managed)의 cURL 예제는 `gcloud auth print-access-token`으로 토큰을 가져옵니다. 이 명령은 Application Default Credentials가 아닌 gcloud CLI 자체의 로그인을 사용합니다. 해당 예제를 사용하려면 먼저 `gcloud auth login` 또는 `gcloud init`을 실행하세요.

### SDK 설치

Anthropic의 [클라이언트 SDK](https://platform.claude.com/docs/ko/cli-sdks-libraries/overview)는 `AnthropicVertex` (csharp: `AnthropicVertexClient`; go: `vertex.WithGoogleAuth`; java: `VertexBackend`; php: `Anthropic\Vertex\Client`; ruby: `Anthropic::VertexClient`)를 통해 Claude Models on Google Cloud (Google managed)를 지원합니다. 이를 제공하는 패키지를 설치하세요:

<Tabs>
  <Tab title="Python">
    ```bash
    pip install -U "anthropic[vertex]"
    ```
  </Tab>

  <Tab title="TypeScript">
    ```bash
    npm install @anthropic-ai/vertex-sdk
    ```
  </Tab>

  <Tab title="C#">
    ```bash
    dotnet add package Anthropic.Vertex
    ```
  </Tab>

  <Tab title="Go">
    ```bash
    go get github.com/anthropics/anthropic-sdk-go
    ```
  </Tab>

  <Tab title="Java">
    <CodeGroup exclude="shell, python, typescript, csharp, go, php, ruby">
      ```groovy Gradle
      implementation("com.anthropic:anthropic-java:3.1.0")
      implementation("com.anthropic:anthropic-java-vertex:3.1.0")
      ```

      ```xml Maven
      <dependency>
          <groupId>com.anthropic</groupId>
          <artifactId>anthropic-java</artifactId>
          <version>3.1.0</version>
      </dependency>
      <dependency>
          <groupId>com.anthropic</groupId>
          <artifactId>anthropic-java-vertex</artifactId>
          <version>3.1.0</version>
      </dependency>
      ```
    </CodeGroup>
  </Tab>

  <Tab title="PHP">
    ```bash
    composer require anthropic-ai/sdk google/auth
    ```
  </Tab>

  <Tab title="Ruby">
    ```bash
    # Gemfile
    gem "anthropic"
    gem "googleauth"
    ```
  </Tab>
</Tabs>

`ant` CLI는 Claude Models on Google Cloud (Google managed)를 지원하지 않습니다.

## 요청 보내기

Claude Models on Google Cloud (Google managed)에 대한 요청은 `:rawPredict`로 끝나는 Agent Platform 엔드포인트 URL로 전송됩니다. 스트리밍 요청은 대신 `:streamRawPredict`를 사용합니다.

요청은 [Messages API](https://platform.claude.com/docs/ko/api/messages/create) 요청과 거의 동일합니다. 주요 차이점은 두 가지입니다:

* **모델:** 엔드포인트 URL이 모델을 지정합니다. cURL 요청에서는 본문에서 `model`을 생략하세요.
* **버전:** cURL 요청에서는 `anthropic_version`을 헤더가 아닌 본문에 전달하세요. 값은 `vertex-2023-10-16` 또는 [API 버전 `2026-10-21`](https://platform.claude.com/docs/ko/api/migration-2026-10-21)로 설정하세요.

다음 예제는 글로벌 엔드포인트를 사용합니다. 다른 엔드포인트 유형은 [글로벌, 멀티 리전 및 리전 엔드포인트](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#global-multi-region-and-regional-endpoints)를 참조하세요.

<CodeGroup exclude="shell:CLI">
  ```bash cURL
  curl https://aiplatform.googleapis.com/v1/projects/MY_PROJECT_ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "anthropic_version": "vertex-2023-10-16",
      "messages": [{"role": "user", "content": "Hey Claude!"}],
      "max_tokens": 100
    }'
  ```

  <CodeGroupItem language="CLI">
    `ant` CLI는 Claude Models on Google Cloud (Google managed)를 지원하지 않습니다.
  </CodeGroupItem>

  ```python Python
  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-opus-5-5",
      max_tokens=100,
      messages=[
          {
              "role": "user",
              "content": "Hey Claude!",
          }
      ],
  )
  print(message)
  ```

  ```typescript TypeScript
  import { AnthropicVertex } from "@anthropic-ai/vertex-sdk";

  const projectId = "MY_PROJECT_ID";
  const region = "global";

  // 표준 `google-auth-library` 흐름을 거칩니다.
  const client = new AnthropicVertex({
    projectId,
    region
  });

  const result = await client.messages.create({
    model: "claude-opus-5-5",
    max_tokens: 100,
    messages: [
      {
        role: "user",
        content: "Hey Claude!"
      }
    ]
  });
  console.log(JSON.stringify(result, null, 2));
  ```

  ```csharp C#
  using Anthropic.Models.Messages;
  using Anthropic.Vertex;

  var projectId = "MY_PROJECT_ID";
  var region = "global";

  var client = new AnthropicVertexClient(new AnthropicVertexCredentials(region, projectId));

  var parameters = new MessageCreateParams
  {
      Model = Model.ClaudeOpus5_5,
      MaxTokens = 100,
      Messages = [new UserMessageParam { Content = "Hey Claude!" }]
  };

  var message = await client.Messages.Create(parameters);
  Console.WriteLine(message);
  ```

  ```go Go
  import (
  	"context"
  	"fmt"

  	"github.com/anthropics/anthropic-sdk-go"
  	"github.com/anthropics/anthropic-sdk-go/vertex"
  )
  // ...
  	// 기본 Google Cloud 자격 증명을 사용합니다
  	client := anthropic.NewClient(
  		vertex.WithGoogleAuth(context.Background(), "global", "MY_PROJECT_ID"),
  	)

  	message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
  		Model:     anthropic.ModelClaudeOpus5_5,
  		MaxTokens: 100,
  		Messages: []anthropic.MessageParam{
  			anthropic.NewUserMessage(anthropic.NewTextBlock("Hey Claude!")),
  		},
  	})
  	if err != nil {
  		panic(err)
  	}
  	fmt.Printf("%+v\n", message)
  ```

  ```java Java
  import com.anthropic.client.AnthropicClient;
  import com.anthropic.client.okhttp.AnthropicOkHttpClient;
  import com.anthropic.models.messages.Message;
  import com.anthropic.models.messages.MessageCreateParams;
  import com.anthropic.models.messages.Model;
  import com.anthropic.vertex.backends.VertexBackend;
  import com.google.auth.oauth2.GoogleCredentials;

  void main() throws Exception {
      AnthropicClient client = AnthropicOkHttpClient.builder()
          .backend(
              VertexBackend.builder()
                  .googleCredentials(GoogleCredentials.getApplicationDefault())
                  .region("global")
                  .project("MY_PROJECT_ID")
                  .build()
          )
          .build();

      Message message = client
          .messages()
          .create(
              MessageCreateParams.builder()
                  .model(Model.CLAUDE_OPUS_5_5)
                  .maxTokens(100)
                  .addUserMessage("Hey Claude!")
                  .build()
          );

      IO.println(message);
  }
  ```

  ```php PHP
  <?php

  use Anthropic\Messages\TextBlock;
  use Anthropic\Vertex;

  $client = Vertex\Client::fromEnvironment(
      region: 'global',
      projectId: 'MY_PROJECT_ID',
  );

  $message = $client->messages->create(
      maxTokens: 100,
      messages: [
          ['role' => 'user', 'content' => 'Hey Claude!']
      ],
      model: 'claude-opus-5-5',
  );

  foreach ($message->content as $block) {
      if ($block instanceof TextBlock) {
          echo $block->text . PHP_EOL;
      }
  }
  ```

  ```ruby Ruby
  require "anthropic"

  client = Anthropic::VertexClient.new(
    region: "global",
    project_id: "MY_PROJECT_ID"
  )

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

  puts message.content.find { it.type == :text }.text
  ```
</CodeGroup>

### API 모델 ID

| Model                                                                                                 | Agent Platform API model ID  |
| :---------------------------------------------------------------------------------------------------- | :--------------------------- |
| Claude Fable 5.1                                                                                      | `claude-fable-5-1`           |
| Claude Mythos 5.1 ([limited availability](https://support.claude.com/en/articles/14604842))           | `claude-mythos-5-1`          |
| Claude Fable 5                                                                                        | `claude-fable-5`             |
| Claude Mythos 5 ([limited availability](https://support.claude.com/en/articles/14604842))             | `claude-mythos-5`            |
| Claude Opus 5.5                                                                                       | `claude-opus-5-5`            |
| Claude Opus 5                                                                                         | `claude-opus-5`              |
| Claude Opus 4.8                                                                                       | `claude-opus-4-8`            |
| Claude Opus 4.7                                                                                       | `claude-opus-4-7`            |
| Claude Opus 4.6                                                                                       | `claude-opus-4-6`            |
| Claude Opus 4.5                                                                                       | `claude-opus-4-5@20251101`   |
| Claude Opus 4.1 ([deprecated](https://platform.claude.com/docs/ko/about-claude/model-deprecations))   | `claude-opus-4-1@20250805`   |
| Claude Opus 4 ([deprecated](https://platform.claude.com/docs/ko/about-claude/model-deprecations))     | `claude-opus-4@20250514`     |
| Claude Sonnet 5.5                                                                                     | `claude-sonnet-5-5`          |
| Claude Sonnet 5                                                                                       | `claude-sonnet-5`            |
| Claude Sonnet 4.6                                                                                     | `claude-sonnet-4-6`          |
| Claude Sonnet 4.5 ([deprecated](https://platform.claude.com/docs/ko/about-claude/model-deprecations)) | `claude-sonnet-4-5@20250929` |
| Claude Sonnet 4 ([deprecated](https://platform.claude.com/docs/ko/about-claude/model-deprecations))   | `claude-sonnet-4@20250514`   |
| Claude Haiku 5.5                                                                                      | `claude-haiku-5-5`           |
| Claude Haiku 4.5                                                                                      | `claude-haiku-4-5@20251001`  |
| Claude Haiku 3.5 ([deprecated](https://platform.claude.com/docs/ko/about-claude/model-deprecations))  | `claude-3-5-haiku@20241022`  |

Claude Models on Google Cloud (Google managed)는 리전마다 서로 다른 Claude 모델을 제공합니다. 리전에서 제공하는 모델을 확인하려면 [Model Garden](https://cloud.google.com/model-garden)에서 "Claude"를 검색하거나 Google Cloud의 [Anthropic Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude) 페이지를 참조하세요.

Google은 Claude Models on Google Cloud (Google managed)가 제공하는 모델의 수명 주기 날짜를 설정합니다. 이 날짜는 Claude API 일정과 다를 수 있습니다. 모델의 현재 종료 날짜는 Google Cloud의 [Anthropic Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude) 페이지를 참조하세요. 지원 중단(Deprecated)과 종료(Retired)의 의미는 [모델 지원 중단](https://platform.claude.com/docs/ko/about-claude/model-deprecations)을 참조하세요.

<Note>
  Claude Mythos Preview는 연구 프리뷰입니다. Claude Models on Google Cloud (Google managed)는 초대된 고객에게 이를 제공합니다. 자세한 내용은 [Project Glasswing](https://anthropic.com/glasswing)을 참조하세요.
</Note>

<Tip>
  최신 Claude 모델로 업그레이드하시나요? Claude Code의 [Claude API 스킬](https://platform.claude.com/docs/ko/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model)은 코드베이스 전체에 모델 ID 교체 및 호환성이 깨지는 매개변수 변경 사항을 적용합니다:

  Claude Code가 코드를 대신 마이그레이션하도록 하세요

  ```text
  /claude-api migrate 이 프로젝트를 최신 Claude Opus 모델로 마이그레이션해 줘
  ```

  이 스킬은 코드가 대상으로 하는 클라우드 플랫폼을 감지하고 해당 플랫폼에 맞게 모델 ID 형식과 기능 변경 사항을 조정합니다.
</Tip>

## 글로벌, 멀티 리전 및 리전 엔드포인트

Claude Models on Google Cloud (Google managed)는 세 가지 엔드포인트 유형을 제공합니다. 클라이언트를 생성할 때 전달하는 리전 값으로 유형을 선택합니다. cURL 요청에서는 엔드포인트 유형이 호스트와 URL의 `locations` 세그먼트를 결정합니다.

| 엔드포인트 유형     | 리전 값                | 호스트                                                                        |
| ------------ | ------------------- | -------------------------------------------------------------------------- |
| **글로벌** (권장) | `"global"`          | `aiplatform.googleapis.com`                                                |
| **멀티 리전**    | `"us"` 또는 `"eu"`    | `aiplatform.us.rep.googleapis.com`<br />`aiplatform.eu.rep.googleapis.com` |
| **리전**       | `"us-east5"`와 같은 리전 | `{region}-aiplatform.googleapis.com`                                       |

엔드포인트 유형은 요청을 보내는 위치가 다릅니다:

* **글로벌:** 요청이 가용 용량이 있는 모든 리전으로 전송됩니다. 최대 가용성을 원하고 데이터 레지던시가 유연한 경우에 사용하세요.
* **멀티 리전:** 요청이 미국(`"us"`) 또는 유럽 연합(`"eu"`) 내의 모든 리전으로 전송됩니다. 넓은 지역 내 데이터 레지던시와 단일 리전보다 높은 가용성이 필요한 경우에 사용하세요.
* **리전:** 요청이 `"us-east5"` 또는 `"europe-west1"`과 같이 지정한 리전으로만 전송됩니다. 단일 리전 데이터 레지던시가 필요하거나 엄격한 규정 준수 요건을 충족해야 하는 경우에 사용하세요.

멀티 리전 및 리전 엔드포인트는 글로벌 엔드포인트보다 비용이 10% 더 높습니다. 세 가지 엔드포인트 유형 모두 종량제 트래픽을 처리하며, 프로비저닝된 처리량에는 리전 엔드포인트가 필요합니다.

리전 엔드포인트는 Claude Sonnet 4.6 및 이전 모델만 제공합니다. 최신 모델의 경우 글로벌 또는 멀티 리전 엔드포인트를 사용하세요.

<Note>
  멀티 리전 및 리전 엔드포인트의 추가 요금은 Claude Sonnet 4.5(지원 중단) 및 이후 모델에만 적용됩니다. 이전 가격이 유지되는 모델은 [클라우드 플랫폼 가격](https://platform.claude.com/docs/ko/about-claude/pricing#cloud-platform-pricing)을 참조하세요. 리전 엔드포인트의 경우 추가 요금은 전용 리전 용량에 대한 인프라 비용을 반영합니다.
</Note>

다음 예제는 `us` 멀티 리전 엔드포인트를 사용합니다. 강조 표시된 줄이 리전을 설정합니다. 글로벌 엔드포인트에 대한 전체 요청은 [요청 보내기](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#accessing-vertex-ai)를 참조하세요.

<CodeGroup exclude="shell:CLI">
  ```bash cURL
  # 멀티 리전 식별자("us" 또는 "eu")는 호스트 이름과 경로에 모두 나타납니다
  curl https://aiplatform.us.rep.googleapis.com/v1/projects/MY_PROJECT_ID/locations/us/publishers/anthropic/models/claude-opus-5-5:rawPredict \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "anthropic_version": "vertex-2023-10-16",
      "messages": [{"role": "user", "content": "Hey Claude!"}],
      "max_tokens": 100
    }'
  ```

  <CodeGroupItem language="CLI">
    `ant` CLI는 Claude Models on Google Cloud (Google managed)를 지원하지 않습니다.
  </CodeGroupItem>

  ```python Python
  from anthropic import AnthropicVertex

  project_id = "MY_PROJECT_ID"
  region = "us"  # Multi-region identifier: "us" or "eu"

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

  ```typescript TypeScript
  import { AnthropicVertex } from "@anthropic-ai/vertex-sdk";

  const projectId = "MY_PROJECT_ID";
  const region = "us"; // Multi-region identifier: "us" or "eu"

  const client = new AnthropicVertex({
    projectId,
    region
  });
  ```

  ```csharp C#
  using Anthropic.Vertex;

  var projectId = "MY_PROJECT_ID";
  var region = "us"; // Multi-region identifier: "us" or "eu"

  var client = new AnthropicVertexClient(new AnthropicVertexCredentials(region, projectId));
  ```

  ```go Go
  import (
  	"context"

  	"github.com/anthropics/anthropic-sdk-go"
  	"github.com/anthropics/anthropic-sdk-go/vertex"
  )
  // ...
  	// 멀티 리전 식별자: "us" 또는 "eu"
  	client := anthropic.NewClient(
  		vertex.WithGoogleAuth(context.Background(), "us", "MY_PROJECT_ID"),
  	)
  ```

  ```java Java
  import com.anthropic.client.AnthropicClient;
  import com.anthropic.client.okhttp.AnthropicOkHttpClient;
  import com.anthropic.vertex.backends.VertexBackend;
  import com.google.auth.oauth2.GoogleCredentials;

  void main() throws Exception {
      // 멀티 리전 식별자: "us" 또는 "eu"
      AnthropicClient client = AnthropicOkHttpClient.builder()
          .backend(
              VertexBackend.builder()
                  .googleCredentials(GoogleCredentials.getApplicationDefault())
                  .region("us")
                  .project("MY_PROJECT_ID")
                  .build()
          )
          .build();
  }
  ```

  ```php PHP
  use Anthropic\Vertex;

  $client = Vertex\Client::fromEnvironment(
      region: 'us', // Multi-region identifier: "us" or "eu"
      projectId: 'MY_PROJECT_ID',
  );
  ```

  ```ruby Ruby
  require "anthropic"

  client = Anthropic::VertexClient.new(
    region: "us", # Multi-region identifier: "us" or "eu"
    project_id: "MY_PROJECT_ID"
  )
  ```
</CodeGroup>

## 기능 지원

Claude Models on Google Cloud (Google managed)에서 지원되는 기능은 다음과 같습니다:

* [Messages API](https://platform.claude.com/docs/ko/api/messages/create)

* [프롬프트 캐싱](https://platform.claude.com/docs/ko/build-with-claude/prompt-caching)

* [Thinking](https://platform.claude.com/docs/ko/build-with-claude/thinking)

* 다음 도구를 포함한 [도구 사용](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/overview):

  * [Bash 도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/bash-tool)
  * [브라우저 사용 도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/browser-use-tool)
  * [컴퓨터 사용 도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/computer-use-tool)
  * [메모리 도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/memory-tool)
  * [텍스트 편집기 도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/text-editor-tool)
  * [웹 검색 도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/web-search-tool)

* [인용](https://platform.claude.com/docs/ko/build-with-claude/citations)

* [구조화된 출력](https://platform.claude.com/docs/ko/build-with-claude/structured-outputs)

[기능 개요](https://platform.claude.com/docs/ko/build-with-claude/overview)에는 모든 기능과 Claude Models on Google Cloud (Google managed)의 지원 여부가 나열되어 있습니다.

### 지원되지 않는 기능

Claude Models on Google Cloud (Google managed)는 다음을 지원하지 않습니다:

* **입력 소스:** 이미지 및 문서의 URL 소스, Files API
* **서버 측 도구:** 코드 실행, 웹 가져오기, advisor
* **에이전트 인프라:** Agent Skills, MCP 커넥터, 프로그래밍 방식 도구 호출
* **API 엔드포인트:** Message Batches API, Models API, Admin API, Compliance API, Usage and Cost API
* **Claude Managed Agents**
* **서버 측 폴백:** [`fallbacks` 매개변수](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback#server-side-fallback)

서버 측 폴백 대신 [클라이언트 측 폴백 패턴](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback#client-side-fallback)을 사용하세요.

### 컨텍스트 윈도우

Claude Models on Google Cloud (Google managed)는 다음 모델에 대해 [1M 토큰 컨텍스트 윈도우](https://platform.claude.com/docs/ko/build-with-claude/context-windows)를 제공합니다:

* Claude Fable 5.1
* Claude Fable 5
* Claude Opus 5.5
* Claude Opus 5
* Claude Opus 4.8
* Claude Opus 4.7
* Claude Opus 4.6
* Claude Sonnet 5.5
* Claude Sonnet 5
* Claude Sonnet 4.6
* Claude Haiku 5.5

다른 Claude 모델은 200k 토큰 컨텍스트 윈도우를 가집니다. 여기에는 Claude Sonnet 4.5(지원 중단)와 Claude Sonnet 4(지원 중단)가 포함됩니다.

Agent Platform은 요청 페이로드를 30MB로 제한합니다. 대용량 문서나 많은 이미지를 보내는 경우 토큰 제한보다 먼저 이 제한에 도달할 수 있습니다.

## 청구, 속도 제한 및 로깅

### 속도 제한

Google Cloud는 Claude Models on Google Cloud (Google managed)의 속도 제한과 할당량을 관리합니다. 할당량 증가를 요청하는 방법을 포함한 자세한 내용은 Google Cloud의 [Quotas for Anthropic Claude models](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude/quotas) 페이지를 참조하세요.

### 청구

Google Cloud가 Claude Models on Google Cloud (Google managed) 사용 요금을 청구합니다. 가격은 Google Cloud의 [Generative AI pricing](https://cloud.google.com/vertex-ai/generative-ai/pricing#claude-models) 페이지를 참조하세요. 가격은 엔드포인트 유형에 따라서도 달라집니다. [글로벌, 멀티 리전 및 리전 엔드포인트](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#global-multi-region-and-regional-endpoints)를 참조하세요.

### 데이터 보존

Google Cloud가 Claude Models on Google Cloud (Google managed)의 데이터 처리를 관리합니다. 자세한 내용은 [Agent Platform and zero data retention](https://cloud.google.com/vertex-ai/generative-ai/docs/data-governance)을 참조하세요.

### 모니터링 및 로깅

Claude Models on Google Cloud (Google managed)의 프롬프트와 완성 결과를 기록하려면 Agent Platform의 [요청-응답 로깅 서비스](https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/request-response-logging)를 사용하세요.

Anthropic은 최소 최근 30일간의 로그를 보관할 것을 권장합니다. 로그는 활동을 파악하고 잠재적인 오용을 조사하는 데 도움이 됩니다.

<Note>
  이 서비스를 켜더라도 Google이나 Anthropic이 귀하의 콘텐츠에 접근할 수 있게 되지는 않습니다.
</Note>

## Claude Models on Google Cloud (Anthropic managed)에서 마이그레이션

이전 시 변경되는 사항은 [두 Google Cloud 제품의 차이점](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/overview#how-the-two-google-cloud-offerings-differ)을 참조하세요. Claude Models on Google Cloud (Google managed)로 이전하려면 다음 단계를 따르세요:

<Steps>
  <Step title="액세스 설정">
    프로젝트와 호출을 수행하는 ID가 [API 호출 전 준비 사항](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#before-making-api-calls)의 요구 사항을 충족하는지 확인하세요.
  </Step>

  <Step title="SDK 패키지 설치">
    Claude Models on Google Cloud (Google managed)용 클라이언트를 제공하는 패키지를 설치하세요. [SDK 설치](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#install-an-sdk-for-accessing-vertex-ai)를 참조하세요.
  </Step>

  <Step title="import 및 클라이언트 교체">
    클라이언트를 import하고 생성하는 코드를 변경하세요. `AnthropicGoogleCloud` (csharp: `AnthropicGoogleCloudClient`; go: `googlecloud.NewClient`; java: `GoogleCloudBackend`; php: `Anthropic\GoogleCloud\Client`; ruby: `Anthropic::GoogleCloudClient`) 대신 `AnthropicVertex` (csharp: `AnthropicVertexClient`; go: `vertex.WithGoogleAuth`; java: `VertexBackend`; php: `Anthropic\Vertex\Client`; ruby: `Anthropic::VertexClient`)를 사용하세요. cURL 요청에는 새 URL, 새 헤더, 새 본문이 필요합니다. 다음 코드는 현재 사용 중인 Claude Models on Google Cloud (Anthropic managed)용 클라이언트를 생성합니다:

    <CodeGroup>
      ```bash cURL
      curl "https://claude.googleapis.com/v1/projects/$ANTHROPIC_GOOGLE_CLOUD_PROJECT/locations/global/workspaces/$ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID/invoke/v1/messages" \
        -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
        -H "content-type: application/json" \
        -H "anthropic-version: 2023-06-01" \
        -d '{
          "model": "claude-opus-5-5",
          "max_tokens": 1024,
          "messages": [
            {"role": "user", "content": "Hello, Claude"}
          ]
        }'
      ```

      ```bash CLI
      ant messages create \
        --model claude-opus-5-5 \
        --max-tokens 1024 \
        --message '{role: user, content: "Hello, Claude"}'
      ```

      ```python Python
      from anthropic import AnthropicGoogleCloud

      client = AnthropicGoogleCloud()
      ```

      ```typescript TypeScript
      import { AnthropicGoogleCloud } from "@anthropic-ai/google-cloud-sdk";

      const client = new AnthropicGoogleCloud();
      ```

      ```csharp C#
      using Anthropic.GoogleCloud;

      var client = new AnthropicGoogleCloudClient();
      ```

      ```go Go
      import (
      	"context"

      	"github.com/anthropics/anthropic-sdk-go"
      	"github.com/anthropics/anthropic-sdk-go/googlecloud"
      )
      // ...
      	client, err := googlecloud.NewClient(context.Background(), googlecloud.ClientConfig{})
      	if err != nil {
      		panic(err)
      	}
      ```

      ```java Java
      import com.anthropic.client.AnthropicClient;
      import com.anthropic.client.okhttp.AnthropicOkHttpClient;
      import com.anthropic.googlecloud.backends.GoogleCloudBackend;

      void main() {
          AnthropicClient client = AnthropicOkHttpClient.builder()
              .backend(GoogleCloudBackend.fromEnv())
              .build();
      }
      ```

      ```php PHP
      use Anthropic\GoogleCloud\Client;

      $client = new Client();
      ```

      ```ruby Ruby
      require "anthropic"

      client = Anthropic::GoogleCloudClient.new
      ```
    </CodeGroup>

    다음 코드는 Claude Models on Google Cloud (Google managed)용 클라이언트를 생성합니다. 글로벌 엔드포인트를 사용합니다. 다른 엔드포인트 유형은 [글로벌, 멀티 리전 및 리전 엔드포인트](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#global-multi-region-and-regional-endpoints)를 참조하세요.

    <CodeGroup exclude="shell:CLI">
      ```bash cURL
      curl https://aiplatform.googleapis.com/v1/projects/MY_PROJECT_ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        -d '{
          "anthropic_version": "vertex-2023-10-16",
          "messages": [{"role": "user", "content": "Hey Claude!"}],
          "max_tokens": 100
        }'
      ```

      <CodeGroupItem language="CLI">
        `ant` CLI는 Claude Models on Google Cloud (Google managed)를 지원하지 않습니다. 대신 cURL 또는 SDK를 사용하세요.
      </CodeGroupItem>

      ```python Python
      from anthropic import AnthropicVertex

      project_id = "MY_PROJECT_ID"
      region = "global"

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

      ```typescript TypeScript
      import { AnthropicVertex } from "@anthropic-ai/vertex-sdk";

      const projectId = "MY_PROJECT_ID";
      const region = "global";

      const client = new AnthropicVertex({
        projectId,
        region
      });
      ```

      ```csharp C#
      using Anthropic.Vertex;

      var projectId = "MY_PROJECT_ID";
      var region = "global";

      var client = new AnthropicVertexClient(new AnthropicVertexCredentials(region, projectId));
      ```

      ```go Go
      import (
      	"context"

      	"github.com/anthropics/anthropic-sdk-go"
      	"github.com/anthropics/anthropic-sdk-go/vertex"
      )
      // ...
      	// 기본 Google Cloud 자격 증명을 사용합니다
      	client := anthropic.NewClient(
      		vertex.WithGoogleAuth(context.Background(), "global", "MY_PROJECT_ID"),
      	)
      ```

      ```java Java
      import com.anthropic.client.AnthropicClient;
      import com.anthropic.client.okhttp.AnthropicOkHttpClient;
      import com.anthropic.vertex.backends.VertexBackend;
      import com.google.auth.oauth2.GoogleCredentials;

      void main() throws Exception {
          AnthropicClient client = AnthropicOkHttpClient.builder()
              .backend(
                  VertexBackend.builder()
                      .googleCredentials(GoogleCredentials.getApplicationDefault())
                      .region("global")
                      .project("MY_PROJECT_ID")
                      .build()
              )
              .build();
      }
      ```

      ```php PHP
      use Anthropic\Vertex;

      $client = Vertex\Client::fromEnvironment(
          region: 'global',
          projectId: 'MY_PROJECT_ID',
      );
      ```

      ```ruby Ruby
      require "anthropic"

      client = Anthropic::VertexClient.new(
        region: "global",
        project_id: "MY_PROJECT_ID"
      )
      ```
    </CodeGroup>

    이 코드는 클라이언트를 생성할 때 프로젝트 ID와 리전을 전달합니다. `MY_PROJECT_ID`를 프로젝트 ID로 바꾸세요. 클라이언트로 수행하는 Messages API 호출은 그대로 유지됩니다. 예외는 다음 단계의 모델 ID와 기능입니다.
  </Step>

  <Step title="모델 ID 및 기능 확인">
    * **모델 ID:** Claude 4.6 이전 모델을 사용하는 경우 ID에서 스냅샷 날짜 앞의 하이픈을 `@`로 바꾸세요. 예를 들어 `claude-haiku-4-5-20251001`은 `claude-haiku-4-5@20251001`이 됩니다. 모델과 해당 ID는 [API 모델 ID](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#api-model-ids)를 참조하세요.
    * **기능:** 코드에서 사용하는 기능이 [지원되지 않는 기능](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#features-not-supported)에 나열되어 있지 않은지 확인하세요.
  </Step>

  <Step title="테스트 요청 실행">
    [요청 보내기](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#accessing-vertex-ai)의 요청을 실행하여 설정이 작동하는지 확인하세요. 그런 다음 자체 코드를 실행하세요. 프로덕션 트래픽을 이전하기 전에 [Claude Models on Google Cloud (Google managed)의 속도 제한](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed#rate-limits)에 대해 읽어 보세요.
  </Step>
</Steps>

## 다음 단계

<CardGroup cols={2}>
  <Card title="기능 개요" icon="stack" href="https://platform.claude.com/docs/ko/build-with-claude/overview">
    Claude의 기능을 살펴보세요.
  </Card>

  <Card title="Anthropic Claude models on Agent Platform" icon="book" href="https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude">
    각 리전에서 제공하는 Claude 모델과 해당 종료 날짜를 확인하세요.
  </Card>

  <Card title="Agent Platform 문서" icon="book" href="https://cloud.google.com/vertex-ai/docs">
    Google Cloud의 Agent Platform 문서를 읽어 보세요.
  </Card>

  <Card title="Claude 모델용 글로벌 엔드포인트" icon="link" href="https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai">
    Claude 모델용 글로벌 엔드포인트에 관한 Google Cloud의 블로그 게시물을 읽어 보세요.
  </Card>
</CardGroup>