---
title: Claude Models on Google Cloud (Google managed)
url: https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/google-managed
description: Google управляет Claude Models on Google Cloud (Google managed) в рамках Google Cloud's Agent Platform. Вы можете вызывать Claude с помощью клиентских SDK от Anthropic.
---

На странице [Claude Models on Google Cloud](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/overview) сравниваются два предложения Google Cloud. Там также показано, как определить, какое из них вы используете.

## Перед выполнением вызовов API

Чтобы использовать Claude Models on Google Cloud (Google managed), вам потребуется:

1. Проект Google Cloud, который может использовать Agent Platform. Шаги настройки см. на странице 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. Для удостоверения, выполняющего вызовы, — роль IAM, включающая разрешение `aiplatform.endpoints.predict`, например 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. Учётные данные Google Cloud для этого удостоверения. Для примеров с SDK вам может потребоваться выполнить `gcloud auth application-default login`, чтобы пройти аутентификацию в Google Cloud. Примеры cURL для Claude Models on Google Cloud (Google managed) получают токен с помощью `gcloud auth print-access-token`. Эта команда использует собственный вход gcloud CLI, а не Application Default Credentials. Для этих примеров сначала выполните `gcloud auth login` или `gcloud init`.

### Установка SDK

[Клиентские SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview) от Anthropic поддерживают Claude Models on Google Cloud (Google managed) через `AnthropicVertex` (csharp: `AnthropicVertexClient`; go: `vertex.WithGoogleAuth`; java: `VertexBackend`; php: `Anthropic\Vertex\Client`; ruby: `Anthropic::VertexClient`). Установите пакет, который его предоставляет:

<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>

CLI `ant` не поддерживает Claude Models on Google Cloud (Google managed).

## Выполнение запросов

Запросы к Claude Models on Google Cloud (Google managed) отправляются на URL конечной точки Agent Platform, который заканчивается на `:rawPredict`. Запросы с «streaming» (потоковой передачей) вместо этого используют `:streamRawPredict`.

Запрос почти идентичен запросу к [Messages API](https://platform.claude.com/docs/ru/api/messages/create). Он отличается двумя основными моментами:

* **Модель:** модель указывается в URL конечной точки. В запросе cURL не включайте `model` в тело.
* **Версия:** в запросе cURL передавайте `anthropic_version` в теле, а не в заголовке. Установите значение `vertex-2023-10-16` или [версию API `2026-10-21`](https://platform.claude.com/docs/ru/api/migration-2026-10-21).

В следующих примерах используется глобальная конечная точка. Другие типы конечных точек см. в разделе [Глобальные, мультирегиональные и региональные конечные точки](https://platform.claude.com/docs/ru/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">
    CLI `ant` не поддерживает 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

| 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/ru/about-claude/model-deprecations))   | `claude-opus-4-1@20250805`   |
| Claude Opus 4 ([deprecated](https://platform.claude.com/docs/ru/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/ru/about-claude/model-deprecations)) | `claude-sonnet-4-5@20250929` |
| Claude Sonnet 4 ([deprecated](https://platform.claude.com/docs/ru/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/ru/about-claude/model-deprecations))  | `claude-3-5-haiku@20241022`  |

Claude Models on Google Cloud (Google managed) предлагает разные модели Claude в разных регионах. Чтобы проверить, какие модели доступны в регионе, выполните поиск «Claude» в [Model Garden](https://cloud.google.com/model-garden) или см. страницу 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/ru/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 API](https://platform.claude.com/docs/ru/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model) в Claude Code применяет замену идентификаторов моделей и критические изменения параметров во всей вашей кодовой базе:

  Позвольте Claude Code выполнить миграцию вашего кода за вас

  ```text
  /claude-api migrate этот проект на последнюю модель Claude Opus
  ```

  Навык определяет, на какую облачную платформу ориентирован ваш код, и корректирует форматы идентификаторов моделей и изменения функций для этой платформы.
</Tip>

## Глобальные, мультирегиональные и региональные конечные точки

Claude Models on Google Cloud (Google managed) предлагает три типа конечных точек. Вы выбираете один из них с помощью значения региона, которое передаёте при создании клиента. В запросе cURL тип конечной точки определяет хост и сегмент `locations` в URL.

| Тип конечной точки             | Значение региона              | Хост                                                                       |
| ------------------------------ | ----------------------------- | -------------------------------------------------------------------------- |
| **Глобальная** (рекомендуется) | `"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/ru/about-claude/pricing#cloud-platform-pricing). Для региональных конечных точек надбавка отражает затраты на инфраструктуру для выделенной региональной мощности.
</Note>

В следующих примерах используется мультирегиональная конечная точка `us`. Выделенные строки задают регион. Полный запрос к глобальной конечной точке см. в разделе [Выполнение запросов](https://platform.claude.com/docs/ru/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">
    CLI `ant` не поддерживает 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/ru/api/messages/create)

* [«Prompt caching» (кэширование подсказок)](https://platform.claude.com/docs/ru/build-with-claude/prompt-caching)

* [«Thinking» (размышления)](https://platform.claude.com/docs/ru/build-with-claude/thinking)

* [«Tool use» (использование инструментов)](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/overview), включая следующие инструменты:

  * [Инструмент Bash](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/bash-tool)
  * [Инструмент использования браузера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/browser-use-tool)
  * [Инструмент использования компьютера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool)
  * [Инструмент памяти](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/memory-tool)
  * [Инструмент текстового редактора](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/text-editor-tool)
  * [Инструмент веб-поиска](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/web-search-tool)

* [Цитирование](https://platform.claude.com/docs/ru/build-with-claude/citations)

* [Структурированные выходные данные](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs)

В [обзоре функций](https://platform.claude.com/docs/ru/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/ru/build-with-claude/refusals-and-fallback#server-side-fallback)

Вместо серверного резервного варианта используйте [шаблон клиентского резервного варианта](https://platform.claude.com/docs/ru/build-with-claude/refusals-and-fallback#client-side-fallback).

### Контекстное окно

Claude Models on Google Cloud (Google managed) предлагает [«context window» (контекстное окно) на 1M токенов](https://platform.claude.com/docs/ru/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 ограничивает размер полезной нагрузки запроса 30 МБ. При отправке больших документов или множества изображений вы можете достичь этого ограничения раньше, чем ограничения по токенам.

## Выставление счетов, ограничения скорости и ведение журналов

### Ограничения скорости

Google Cloud управляет «rate limits» (ограничениями скорости) и квотами для 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/ru/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), используйте [службу журналирования запросов и ответов](https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/request-response-logging) Agent Platform.

Anthropic рекомендует хранить журналы как минимум за последние 30 дней. Журналы помогают понимать вашу активность и расследовать возможные злоупотребления.

<Note>
  Включение этой службы не предоставляет Google или Anthropic никакого доступа к вашему контенту.
</Note>

## Миграция с Claude Models on Google Cloud (Anthropic managed)

Что меняется при переходе, см. в разделе [Чем различаются два предложения Google Cloud](https://platform.claude.com/docs/ru/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="Настройте доступ">
    Убедитесь, что ваш проект и удостоверение, выполняющее вызовы, соответствуют требованиям из раздела [Перед выполнением вызовов API](https://platform.claude.com/docs/ru/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/ru/build-with-claude/claude-models-on-google-cloud/google-managed#install-an-sdk-for-accessing-vertex-ai).
  </Step>

  <Step title="Замените импорт и клиент">
    Измените код, который импортирует и создаёт ваш клиент. Используйте `AnthropicVertex` (csharp: `AnthropicVertexClient`; go: `vertex.WithGoogleAuth`; java: `VertexBackend`; php: `Anthropic\Vertex\Client`; ruby: `Anthropic::VertexClient`) вместо `AnthropicGoogleCloud` (csharp: `AnthropicGoogleCloudClient`; go: `googlecloud.NewClient`; java: `GoogleCloudBackend`; php: `Anthropic\GoogleCloud\Client`; ruby: `Anthropic::GoogleCloudClient`). Для запроса 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/ru/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">
        CLI `ant` не поддерживает 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>

    Этот код передаёт идентификатор вашего проекта и регион при создании клиента. Замените `MY_PROJECT_ID` на идентификатор вашего проекта. Вызовы Messages API, которые вы выполняете с помощью клиента, остаются без изменений. Исключение составляют идентификаторы моделей и функции, описанные в следующем шаге.
  </Step>

  <Step title="Проверьте идентификаторы моделей и функции">
    * **Идентификаторы моделей:** если вы используете модель, выпущенную до Claude 4.6, замените дефис перед датой снимка в её идентификаторе на `@`. Например, `claude-haiku-4-5-20251001` становится `claude-haiku-4-5@20251001`. Модели и их идентификаторы см. в разделе [Идентификаторы моделей API](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/google-managed#api-model-ids).
    * **Функции:** убедитесь, что функции, которые использует ваш код, не перечислены в разделе [Неподдерживаемые функции](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/google-managed#features-not-supported).
  </Step>

  <Step title="Выполните тестовый запрос">
    Выполните запрос из раздела [Выполнение запросов](https://platform.claude.com/docs/ru/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/ru/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/ru/build-with-claude/overview">
    Изучите функции Claude.
  </Card>

  <Card title="Модели Anthropic Claude на 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's 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">
    Прочитайте запись в блоге Google Cloud о глобальной конечной точке для моделей Claude.
  </Card>
</CardGroup>