---
title: Claude Models on Google Cloud (Anthropic managed)
url: https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed
description: Claude Models on Google Cloud (Anthropic managed) — это Claude API, которым управляет Anthropic и доступ к которому осуществляется через ваш проект Google Cloud.
---

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

## Настройка учётной записи

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

* Разрешение на покупки в Google Cloud Marketplace для вашего платёжного аккаунта
* Разрешение на включение сервисов в проекте
* [Роль IAM, позволяющая открыть Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console), которая нужна для шага 4

Эти шаги создают новую организацию Anthropic для вашего проекта Google Cloud. Она отделена от любой организации Anthropic, которая уже есть у вашей компании. Это относится и к организации Claude Enterprise. Чтобы перейти с существующей организации, см. [Переход с существующей организации Anthropic](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#moving-from-an-existing-anthropic-organization).

Если у вас есть действующая скидка, свяжитесь с вашим представителем Anthropic или Google Cloud до начала выполнения этих шагов. Скидки не могут быть применены к прошлому использованию.

<Steps>
  <Step title="Оформите подписку в Marketplace">
    1. Откройте [Google Cloud Marketplace](https://console.cloud.google.com/marketplace) и найдите страницу **Claude Models on Google Cloud (Anthropic managed)**.
    2. Выберите **Subscribe** и завершите процесс покупки.
    3. Вернитесь на страницу продукта и выберите **Manage on Console**. Откроется страница Claude в консоли Google Cloud.

    Чтобы позже вернуться на страницу Claude, выберите свой проект в консоли Google Cloud. Затем перейдите в **Agent Platform > Models > Claude Platform** и выберите **Anthropic managed**.
  </Step>

  <Step title="Включите сервисы">
    Включите два сервиса в каждом проекте, который обращается к Claude Models on Google Cloud (Anthropic managed):

    * `claude.googleapis.com` обслуживает API для Claude Models on Google Cloud (Anthropic managed). Этот сервис также определяет разрешения IAM. Без него вызовы завершаются ошибкой.
    * `anthropic-managed-claude.cloudpartnerservices.goog` — это сервис Marketplace, который относит использование проекта к вашей подписке.

    ```bash CLI
    gcloud services enable claude.googleapis.com \
      anthropic-managed-claude.cloudpartnerservices.goog \
      --project=my-project-id
    ```

    Замените `my-project-id` на идентификатор вашего проекта.

    Вы также можете включить оба сервиса на странице Claude или в разделе **APIs & Services**. Включение выполняется один раз для каждого проекта. Чтобы проверить, что оба сервиса включены, выполните `gcloud services list --enabled --project=my-project-id` и найдите оба имени.
  </Step>

  <Step title="Настройте организацию Anthropic">
    1. На странице Claude выберите **Activate**.
    2. В процессе настройки Anthropic введите контактный адрес электронной почты.
    3. Откройте ссылку для настройки, отправленную на этот адрес.
    4. Укажите название организации, тип юридического лица, страну и предполагаемое использование.
    5. Примите Коммерческие условия обслуживания и Политику использования Anthropic.

    Контактный адрес используется только для настройки и служебных уведомлений. О том, как пользователи открывают Claude Console после настройки, см. [Использование Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console).
  </Step>

  <Step title="Откройте Claude Console">
    Когда ваша организация Anthropic станет активной, кнопка на странице Claude изменится на **Open Claude Console**. Нажмите её. Google Cloud проверит ваш доступ IAM. Затем браузер будет перенаправлен на `platform.claude.com`. Вы войдёте в новую организацию.

    Находясь в Claude Console, [найдите идентификатор рабочего пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) и скопируйте его. Он нужен всем, кто обращается к Claude Models on Google Cloud (Anthropic managed). Передайте его своим разработчикам.
  </Step>
</Steps>

Чтобы добавить ещё один проект, повторите эти шаги в этом проекте, начиная с шага 2.

### Устранение неполадок при настройке учётной записи

Если при настройке Claude Models on Google Cloud (Anthropic managed) вы столкнулись с одной из следующих проблем, примените соответствующее решение:

* **`gcloud services enable` не может найти `anthropic-managed-claude.cloudpartnerservices.goog`:** выполните команду от имени учётной записи, которая совершила покупку в Marketplace, или свяжитесь с вашим представителем Anthropic.
* **Ошибка разрешений при первом вызове API:** убедитесь, что `claude.googleapis.com` включён в проекте, к которому вы обращаетесь. Убедитесь, что у вызывающей стороны есть роль `roles/claude.user` или `roles/claude.admin` в этом проекте. О том, что разрешает каждая роль, см. [Роли IAM](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles). Применение новой выдачи роли или только что включённого сервиса может занять некоторое время.
* **«Signed in as a different account» после перехода по ссылке для настройки:** выберите **Log out and continue**. Затем используйте адрес электронной почты, который вы ввели на шаге 3.
* **На кнопке написано «Finish Setup» вместо «Open Claude Console»:** ваша организация Anthropic существует, но её настройка не завершена. Администратор должен заполнить форму со сведениями об организации.
* **Страница Usage не показывает данных после первого вызова API:** появление данных об использовании в Claude Console может занять несколько минут.

## Управление доступом

### Роли IAM

В Claude Models on Google Cloud (Anthropic managed) есть три предопределённые роли IAM. Выдавайте роли на уровне проекта.

| Роль                  | Отображаемое имя | Что разрешает                                                                                                                                                                                                                                            |
| --------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `roles/claude.viewer` | Claude Viewer    | Все разрешения `get` и `list` для ресурсов рабочего пространства<br />Эта роль предназначена только для чтения.                                                                                                                                          |
| `roles/claude.user`   | Claude User      | Всё, что разрешает `roles/claude.viewer`, а также создание и изменение ресурсов рабочего пространства<br />Сюда входят отправка сообщений и подсчёт токенов. Также сюда входит управление пакетами, файлами, навыками и ресурсами Claude Managed Agents. |
| `roles/claude.admin`  | Claude Admin     | Всё, что разрешает `roles/claude.user`, а также разрешения, проверяемые для вашей организации Anthropic<br />Маршруты уровня организации действуют на вашу организацию Anthropic в целом, а не на одно рабочее пространство.                             |

Например, следующая команда позволяет сервисному аккаунту обращаться к Claude Models on Google Cloud (Anthropic managed):

```bash CLI
gcloud projects add-iam-policy-binding my-project-id \
  --member="serviceAccount:my-app@my-project-id.iam.gserviceaccount.com" \
  --role="roles/claude.user"
```

О разрешениях, предопределённых ролях и типах журналов аудита см. [Разрешения IAM для Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ru/api/claude-models-on-google-cloud-anthropic-managed-iam-permissions).

Включение `claude.googleapis.com` создаёт сервисного агента для проекта. Не удаляйте выданные ему роли. Их удаление приведёт к тому, что Claude Models on Google Cloud (Anthropic managed) перестанет работать в проекте.

### Использование Claude Console

В Claude Models on Google Cloud (Anthropic managed) нельзя войти в организацию Anthropic с помощью адреса электронной почты. Вместо этого выберите **Open Claude Console** на [странице Claude](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account) в консоли Google Cloud. Google Cloud IAM определяет, кто может открыть Claude Console. Из трёх предопределённых [ролей IAM](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles) открыть Claude Console позволяет только `roles/claude.admin` в проекте.

### Рабочие пространства

В Claude Models on Google Cloud (Anthropic managed) при настройке создаётся организация Anthropic с одним рабочим пространством — Default Workspace. Чтобы создать дополнительные рабочие пространства, [откройте Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console) и перейдите в **Settings > Workspaces**. На той же странице можно переименовать или архивировать любое рабочее пространство, кроме Default Workspace. У каждого рабочего пространства есть собственный [идентификатор рабочего пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id). Файлы, навыки, пакеты, сеансы Claude Managed Agents и другие ресурсы рабочего пространства принадлежат тому рабочему пространству, идентификатор которого вы [указали для запроса](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution).

[Роли IAM](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles) выдаются на уровне проекта, поэтому роль применяется ко всем рабочим пространствам в этом проекте. Если командам нужен раздельный доступ, выделите каждой команде собственный проект Google Cloud. У каждого проекта своя организация Anthropic, поэтому повторите [шаги настройки](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account) в каждом проекте, начиная с шага 2.

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

Чтобы обращаться к Claude Models on Google Cloud (Anthropic managed), вам потребуется следующее:

1. Проект Google Cloud с активной подпиской и организацией Anthropic, настройка которой завершена. См. [Настройка учётной записи](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account).
2. Установленный [gcloud CLI](https://cloud.google.com/sdk/docs/install) для локальной разработки.
3. Роль `roles/claude.user`, выданная в проекте удостоверению, которое выполняет вызовы.
4. Application Default Credentials для этого удостоверения. См. [Аутентификация](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#authentication).
5. Идентификатор вашего проекта и [идентификатор рабочего пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id).

Чтобы выдать роль своей учётной записи для локальной разработки, выполните следующую команду. Вам нужно разрешение на изменение политики IAM проекта.

```bash CLI
gcloud projects add-iam-policy-binding my-project-id \
  --member="user:you@example.com" \
  --role="roles/claude.user"
```

Замените `my-project-id` на идентификатор вашего проекта. Замените `you@example.com` на адрес электронной почты вашего аккаунта Google. Чтобы узнать, какой проект использует gcloud, выполните `gcloud config get-value project`. О сервисных аккаунтах и других ролях см. [Роли IAM](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles).

### Поиск идентификатора рабочего пространства

Чтобы найти идентификатор рабочего пространства для Claude Models on Google Cloud (Anthropic managed), [откройте Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console) и перейдите в **Settings > Workspaces**. Идентификатор начинается с `wrkspc_`. Если вы не можете открыть Claude Console, попросите того, кто может, прислать вам идентификатор.

Задайте проект и рабочее пространство в виде переменных окружения, чтобы клиенты SDK и [`ant` CLI](https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/quickstart) их подхватили:

```bash CLI
export ANTHROPIC_GOOGLE_CLOUD_PROJECT="my-project-id"
export ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID="wrkspc_01AbCdEf23GhIj"
```

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

[Клиент SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview) для Claude Models on Google Cloud (Anthropic managed) — это `AnthropicGoogleCloud` (csharp: `AnthropicGoogleCloudClient`; go: `googlecloud.NewClient`; java: `GoogleCloudBackend`; php: `Anthropic\GoogleCloud\Client`; ruby: `Anthropic::GoogleCloudClient`). Клиент определяет ваши учётные данные Google. Он также формирует базовый URL из вашего проекта, расположения и идентификатора рабочего пространства.

<Note>
  Клиенты SDK для Claude Models on Google Cloud (Anthropic managed) находятся в бета-версии.
</Note>

Установите пакет, предоставляющий клиент:

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

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

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

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

  <Tab title="Java">
    ```kotlin Gradle
    implementation("com.anthropic:anthropic-java:3.1.0")
    implementation("com.anthropic:anthropic-java-google-cloud: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-google-cloud</artifactId>
      <version>3.1.0</version>
    </dependency>
    ```
  </Tab>

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

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

Чтобы вместо этого использовать `ant` CLI, [установите или обновите его](https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/quickstart#installation) до последней версии. Версия без поддержки Claude Models on Google Cloud (Anthropic managed) игнорирует переменные `ANTHROPIC_GOOGLE_CLOUD_*`. В этом случае она делает одно из следующего:

* Отправляет запрос в Claude API с любыми другими настроенными вами учётными данными
* Завершается ошибкой аутентификации

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

Claude Models on Google Cloud (Anthropic managed) обслуживает конечные точки Claude API по базовому URL, в котором указаны ваш проект, расположение и рабочее пространство:

```text wrap
https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke
```

[Маршруты уровня организации](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles), пути которых начинаются с `/v1/organizations/`, используют базовый URL без рабочего пространства:

```text wrap
https://claude.googleapis.com/v1/projects/{project}/locations/global/claudeOrganization/invoke
```

Если вы не [задаёте базовый URL](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution), клиенты SDK выбирают между этими двумя вариантами для каждого запроса.

Добавьте путь Claude API к базовому URL. Например, [Messages API](https://platform.claude.com/docs/ru/api/messages/create) находится по адресу `.../invoke/v1/messages`. От запроса к Claude API отличаются три вещи:

* **Базовый URL:** показанные выше URL с привязкой к проекту вместо `https://api.anthropic.com`.
* **Аутентификация:** заголовок `Authorization: Bearer` с токеном доступа Google. Не отправляйте заголовок `x-api-key`.
* **Рабочее пространство:** идентификатор рабочего пространства является частью URL. Не отправляйте заголовок `anthropic-workspace-id`.

Всё остальное такое же, как в Claude API, включая следующее:

* Заголовки `anthropic-version` и `anthropic-beta`
* Тело запроса
* «Streaming» (потоковая передача)
* Ответ

Примеры кода в других разделах этой документации создают клиент Claude API и считывают ключ API. Чтобы запустить такой пример с Claude Models on Google Cloud (Anthropic managed), замените в нём импорт и конструктор клиента на те, что приведены в следующих примерах. Для примера cURL примените три перечисленных выше отличия.

Перед запуском этих примеров выполните шаги из раздела [Перед выполнением вызовов API](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#before-making-api-calls).

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

  message = client.messages.create(
      model="claude-opus-5-5",
      max_tokens=1024,
      messages=[{"role": "user", "content": "Hello, Claude"}],
  )
  print(message)
  ```

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

  const client = new AnthropicGoogleCloud();

  const message = await client.messages.create({
    model: "claude-opus-5-5",
    max_tokens: 1024,
    messages: [{ role: "user", content: "Hello, Claude" }]
  });
  console.log(message);
  ```

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

  var client = new AnthropicGoogleCloudClient();

  var parameters = new MessageCreateParams
  {
      Model = Model.ClaudeOpus5_5,
      MaxTokens = 1024,
      Messages = [new UserMessageParam { Content = "Hello, 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/googlecloud"
  )

  func main() {
  	client, err := googlecloud.NewClient(context.Background(), googlecloud.ClientConfig{})
  	if err != nil {
  		panic(err)
  	}

  	message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
  		Model:     anthropic.ModelClaudeOpus5_5,
  		MaxTokens: 1024,
  		Messages: []anthropic.MessageParam{
  			anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, Claude")),
  		},
  	})
  	if err != nil {
  		panic(err)
  	}

  	fmt.Println(message)
  }
  ```

  ```java Java
  import com.anthropic.client.AnthropicClient;
  import com.anthropic.client.okhttp.AnthropicOkHttpClient;
  import com.anthropic.googlecloud.backends.GoogleCloudBackend;
  import com.anthropic.models.messages.Message;
  import com.anthropic.models.messages.MessageCreateParams;
  import com.anthropic.models.messages.Model;

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

      Message message = client.messages().create(
          MessageCreateParams.builder()
              .model(Model.CLAUDE_OPUS_5_5)
              .maxTokens(1024)
              .addUserMessage("Hello, Claude")
              .build()
      );

      IO.println(message);
  }
  ```

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

  $client = new Client();

  $message = $client->messages->create(
      model: Model::CLAUDE_OPUS_5_5,
      maxTokens: 1024,
      messages: [['role' => 'user', 'content' => 'Hello, Claude']],
  );

  echo $message;
  ```

  ```ruby Ruby
  require "anthropic"

  client = Anthropic::GoogleCloudClient.new

  message = client.messages.create(
    model: Anthropic::Model::CLAUDE_OPUS_5_5,
    max_tokens: 1024,
    messages: [{ role: "user", content: "Hello, Claude" }]
  )

  puts message
  ```
</CodeGroup>

Пример cURL запрашивает у gcloud токен Application Default Credentials. Токены доступа недолговечны. Генерируйте новый токен для каждого сеанса, а не сохраняйте его.

### Идентификаторы моделей API

Claude Models on Google Cloud (Anthropic managed) использует те же идентификаторы моделей, что и Claude API, например `claude-opus-5-5`. О моделях и их идентификаторах см. [Обзор моделей](https://platform.claude.com/docs/ru/models/overview).

В Claude Models on Google Cloud (Anthropic managed) запрос к модели, недоступной для вашей организации Anthropic, возвращает ошибку. Сообщение об ошибке гласит: `Model {model} is not available for this organization's inference configuration.`

## Определение проекта, расположения и рабочего пространства

Клиенты для Claude Models on Google Cloud (Anthropic managed) принимают параметры, приведённые в следующей таблице. Значение, переданное при создании клиента, имеет приоритет над переменной окружения. Чтобы явно задать проект и идентификатор рабочего пространства, передайте `project` (go: `Project`; java: `.project()`; csharp: `GoogleCloudClientOptions.Project`; cli: `--google-cloud-project`) и `workspace_id` (typescript, php: `workspaceId`; go: `WorkspaceID`; java: `.workspaceId()`; csharp: `GoogleCloudClientOptions.WorkspaceId`; cli: `--google-cloud-workspace-id`).

| Параметр                            | Переменная окружения                                           | Если не задано                                                                                                                                                                                                                                     |
| ----------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Идентификатор проекта               | `ANTHROPIC_GOOGLE_CLOUD_PROJECT`, затем `GOOGLE_CLOUD_PROJECT` | Проект, который сообщают Application Default Credentials, если тип учётных данных его содержит                                                                                                                                                     |
| Идентификатор рабочего пространства | `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID`                          | Клиент выдаёт ошибку, если вы не задали базовый URL. [Маршрутам уровня организации](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles) идентификатор рабочего пространства не нужен. |
| Расположение                        | `ANTHROPIC_GOOGLE_CLOUD_LOCATION`                              | `global`                                                                                                                                                                                                                                           |
| Базовый URL                         | `ANTHROPIC_GOOGLE_CLOUD_BASE_URL`                              | Формируется из проекта, расположения и идентификатора рабочего пространства                                                                                                                                                                        |

Оставьте расположение `global`. Расположение не связано с тем, где выполняется инференс, поэтому для инференса только в США задавайте `inference_geo: "us"` в каждом запросе, как описано в разделе [Резидентность данных](https://platform.claude.com/docs/ru/manage-claude/data-residency#inference-geo).

`ant` CLI принимает те же параметры в виде флагов:

* **Идентификатор проекта:** `--google-cloud-project`
* **Идентификатор рабочего пространства:** `--google-cloud-workspace-id`
* **Расположение:** `--google-cloud-location`
* **Базовый URL:** `--google-cloud-base-url`

CLI использует Claude Models on Google Cloud (Anthropic managed), когда задан проект, идентификатор рабочего пространства или расположение. Задания `GOOGLE_CLOUD_PROJECT`, базового URL или обоих недостаточно.

## Аутентификация

Каждый запрос к Claude Models on Google Cloud (Anthropic managed) содержит токен доступа Google OAuth 2.0 в заголовке `Authorization: Bearer`. Токен имеет область действия `https://www.googleapis.com/auth/cloud-platform`.

Доступом управляет Google Cloud. Его шлюз `claude.googleapis.com` для каждого запроса делает следующее:

1. Проверяет ваши учётные данные Google Cloud.
2. Проверяет, что у вызывающей стороны есть разрешение IAM, необходимое для запроса. Если его нет, Google Cloud возвращает ошибку HTTP 403.
3. Пересылает запрос в Anthropic. Anthropic проверяет запрос.

О выдаче разрешений см. [Роли IAM](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles).

Клиенты SDK получают токен из [Application Default Credentials](https://cloud.google.com/docs/authentication/application-default-credentials) (ADC). Подходит любой источник учётных данных, поддерживаемый ADC:

* **Локальная разработка:** выполните `gcloud auth application-default login`.
* **В Google Cloud:** клиент автоматически использует сервисный аккаунт, привязанный к рабочей нагрузке, например в Compute Engine, GKE или Cloud Run.
* **Файл ключа сервисного аккаунта:** задайте в `GOOGLE_APPLICATION_CREDENTIALS` путь к нему.
* **Workload Identity Federation и имперсонация сервисного аккаунта:** настройте их так же, как для любого API Google Cloud.

Проверьте, что ADC работает:

```bash CLI
gcloud auth application-default print-access-token
```

Claude Models on Google Cloud (Anthropic managed) не использует ключи API. В Claude Console нельзя создать ключи API для организации Anthropic, созданной при настройке. Клиенты SDK для Claude Models on Google Cloud (Anthropic managed) игнорируют следующие переменные окружения:

* `ANTHROPIC_API_KEY`
* `ANTHROPIC_AUTH_TOKEN`
* `ANTHROPIC_BASE_URL`

### Приоритет учётных данных

Клиент SDK для Claude Models on Google Cloud (Anthropic managed) ищет учётные данные в следующем порядке. Клиент использует первые найденные:

1. Поставщик токенов, который вы передаёте как `token_provider` (typescript: `bearerTokenProvider`; csharp: `GoogleCloudClientOptions.TokenProvider`; go: `TokenSource`; java: `.bearerTokenSupplier()`; php: `tokenProvider`) при создании клиента. Это функция или источник токенов, возвращающий токен доступа. Клиент запрашивает у него токен при каждом запросе. Кэширование и обновление токена — ваша ответственность.
2. Объект учётных данных Google, который вы передаёте как `credentials` (typescript: `googleAuth`; csharp: `GoogleCloudClientOptions.GoogleCredential`; java: `.googleCredentials()`; php: `googleCredentials`; ruby: `google_credentials`) при создании клиента. В Go SDK этого варианта нет.
3. Application Default Credentials.

Go и Java отличаются от других SDK:

* **Go:** для варианта 1 клиент принимает `oauth2.TokenSource`. Он кэширует токен до истечения его срока действия.
* **Java:** используйте `GoogleCloudBackend.fromEnv()`, чтобы считать Application Default Credentials и переменные окружения из раздела [Определение проекта, расположения и рабочего пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution).

У клиента нет собственной переменной окружения для учётных данных. Вместо этого используйте `GOOGLE_APPLICATION_CREDENTIALS` из ADC.

Если ваши запросы проходят через прокси, который сам добавляет токен, задайте `skip_auth` (typescript, php: `skipAuth`; go: `SkipAuth`; java: `.skipAuth()`; csharp: `GoogleCloudClientOptions.SkipAuth`). Тогда клиент не отправляет заголовок `Authorization`. Этот параметр нельзя сочетать с перечисленными выше вариантами учётных данных.

Когда `ant` CLI использует Claude Models on Google Cloud (Anthropic managed), он всегда получает токен из Application Default Credentials. Он не принимает поставщика токенов, объект учётных данных или параметр пропуска аутентификации.

Прежде чем использовать `ant` с Claude Models on Google Cloud (Anthropic managed), убедитесь, что ничего из следующего не задано:

* Ключ API

* Токен аутентификации

* `--profile` или `ANTHROPIC_PROFILE`, если он указывает на [профиль конфигурации](https://platform.claude.com/docs/ru/manage-claude/wif-reference#profile-configuration-file), с помощью которого CLI может пройти аутентификацию

* Любая из переменных федерации Anthropic:

  * `ANTHROPIC_FEDERATION_RULE_ID`
  * `ANTHROPIC_ORGANIZATION_ID`
  * `ANTHROPIC_SERVICE_ACCOUNT_ID`
  * `ANTHROPIC_IDENTITY_TOKEN`
  * `ANTHROPIC_IDENTITY_TOKEN_FILE`

Если что-то из этого задано, CLI использует эти учётные данные вместо параметров Google Cloud из раздела [Поиск идентификатора рабочего пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id). Если задана только часть переменных федерации, CLI завершает работу с ошибкой. Если задано несколько учётных данных, CLI выводит примечание с указанием тех, которые он использует.

Также не задавайте `ANTHROPIC_WORKSPACE_ID` и флаг `--workspace-id`. CLI всё равно отправляет это значение в заголовке `anthropic-workspace-id`. Запросы к Claude Models on Google Cloud (Anthropic managed) не должны содержать этот заголовок. Вместо этого задавайте рабочее пространство с помощью `--google-cloud-workspace-id` или `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID`.

Как и клиенты SDK, CLI не отправляет запросы для Claude Models on Google Cloud (Anthropic managed) на `--base-url` или `ANTHROPIC_BASE_URL`.

## Поддержка функций

В этом разделе перечислены функции, которые работают в Claude Models on Google Cloud (Anthropic managed), и функции, которые там не поддерживаются. Здесь перечислены не все функции Claude API, и здесь не указано, работает ли функция, отсутствующая в списке.

Следующие функции работают в Claude Models on Google Cloud (Anthropic managed) так же, как в Claude API:

* **Fast mode (быстрый режим):** [Быстрый режим](https://platform.claude.com/docs/ru/build-with-claude/fast-mode) для Claude Opus 5.5.

- **Бета-функции:** если в Claude API бета-версия доступна только избранным организациям, организации Anthropic, созданной при настройке, нужен такой же доступ.

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

  * Веб-поиск
  * Веб-загрузку
  * Выполнение кода
  * Инструмент памяти
  * Инструмент-советник
  * Коннектор MCP

- **Навыки и файлы:** [Agent Skills](https://platform.claude.com/docs/ru/agents-and-tools/agent-skills/overview) и [Files API](https://platform.claude.com/docs/ru/build-with-claude/files).

- **Возможности моделей:**

  * [«Prompt caching» (кэширование подсказок)](https://platform.claude.com/docs/ru/build-with-claude/prompt-caching)
  * [«Extended thinking» (расширенные размышления)](https://platform.claude.com/docs/ru/build-with-claude/thinking)
  * [Резервный вариант на стороне сервера](https://platform.claude.com/docs/ru/build-with-claude/refusals-and-fallback#server-side-fallback)
  * [Потоковая передача](https://platform.claude.com/docs/ru/build-with-claude/streaming)
  * [Структурированные выходные данные](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs)
  * [Подсчёт токенов](https://platform.claude.com/docs/ru/build-with-claude/token-counting)

- **Пакеты и модели:** [Message Batches API](https://platform.claude.com/docs/ru/build-with-claude/batch-processing) и Models API.

Чтобы включить или выключить [Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-api) для организации Anthropic, созданной при настройке, [откройте Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console), перейдите в **Settings > Compliance** и воспользуйтесь переключателем **Compliance API**.

Ключи шифрования, управляемые клиентом (CMEK), доступны с ключами Google Cloud KMS. Чтобы активировать CMEK для организации Anthropic, созданной при настройке, см. [Ключи шифрования, управляемые клиентом](https://platform.claude.com/docs/ru/manage-claude/cmek). Чтобы настроить ключ, следуйте инструкциям в разделе [Настройка Google Cloud KMS для CMEK](https://platform.claude.com/docs/ru/manage-claude/cmek-google-cloud-kms). Затем зарегистрируйте, проверьте и подключите ключ в [Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console), как описано на вкладке **Claude Console** страницы настройки.

### Claude Managed Agents

[Claude Managed Agents](https://platform.claude.com/docs/ru/managed-agents/overview) доступен через Claude Models on Google Cloud (Anthropic managed), включая следующее:

* [Агенты](https://platform.claude.com/docs/ru/managed-agents/agent-setup)
* [Среды](https://platform.claude.com/docs/ru/managed-agents/environments)
* [Сеансы](https://platform.claude.com/docs/ru/managed-agents/sessions)
* [Хранилища учётных данных](https://platform.claude.com/docs/ru/managed-agents/vaults)
* [Хранилища памяти](https://platform.claude.com/docs/ru/managed-agents/memory)
* [Развёртывания по расписанию](https://platform.claude.com/docs/ru/managed-agents/scheduled-deployments)
* [Самостоятельно размещаемые песочницы](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes)

Доступ проверяется при создании сеанса или развёртывания, а не во время их работы:

* **Запущенные сеансы продолжают работать.** Если вы отзовёте доступ Google Cloud у удостоверения, создавшего сеанс, сеанс не остановится. Чтобы остановить его, отправьте ему отдельное [событие `user.interrupt`](https://platform.claude.com/docs/ru/managed-agents/events-and-streaming#integrating-events). После того как сеанс перейдёт в состояние `idle`, его можно архивировать или удалить.
* **Развёртывания по расписанию продолжают работать.** Развёртывание не перепроверяет доступ своего создателя при каждом запуске по расписанию. Чтобы остановить его, приостановите, обновите или архивируйте его.

Когда вы удаляете пользователя или меняете сервисный аккаунт, проверьте сеансы и развёртывания, созданные этим удостоверением.

### Неподдерживаемые функции

В Claude Models on Google Cloud (Anthropic managed) не поддерживается следующее:

* **Ключи API:** аутентификация выполняется только с помощью учётных данных Google Cloud.
* **Туннели MCP:** [туннели MCP](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/overview) недоступны в Claude Models on Google Cloud (Anthropic managed).
* **[Хранилища памяти в самостоятельно размещаемых средах](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-memory):** хранилища памяти не поддерживаются для сеансов в самостоятельно размещаемых средах.
* **Готовые рабочие процессы для самостоятельно размещаемых песочниц:** [самостоятельно размещаемые рабочие процессы](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-workers) в `ant` CLI и в SDK для Python, TypeScript и Go не поддерживают Claude Models on Google Cloud (Anthropic managed). Вместо этого реализуйте собственный рабочий процесс, который напрямую вызывает [конечные точки Environments Work](https://platform.claude.com/docs/ru/api/beta/environments/work). Сведения о ролях и разрешениях, необходимых вашему рабочему процессу, см. в разделе [Разрешения IAM для сред](https://platform.claude.com/docs/ru/api/claude-models-on-google-cloud-anthropic-managed-iam-permissions#environments).

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

Размеры «context window» (контекстного окна) в Claude Models on Google Cloud (Anthropic managed) такие же, как в Claude API. Ограничение для каждой модели см. в разделе [Контекстные окна](https://platform.claude.com/docs/ru/build-with-claude/context-windows).

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

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

Anthropic управляет «rate limits» (ограничениями скорости) для Claude Models on Google Cloud (Anthropic managed). Чтобы запросить более высокие ограничения, свяжитесь с вашим представителем Anthropic или [с отделом продаж](https://claude.com/contact-sales). О том, как измеряются и сообщаются ограничения скорости, см. [Ограничения скорости](https://platform.claude.com/docs/ru/api/rate-limits).

### Выставление счетов

Счета за Claude Models on Google Cloud (Anthropic managed) выставляются через Google Cloud Marketplace. Anthropic учитывает ваше использование и сообщает о нём в Google Cloud в единицах Claude Consumption Units. Начисления отображаются в вашем счёте Google Cloud. Anthropic не выставляет отдельный счёт.

Данные об использовании и затратах можно просмотреть на страницах **Usage** и **Cost** в [Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console).

Если у вас есть обязательство по расходам в Google Cloud, использование засчитывается в него так же, как другие покупки в Marketplace.

### Хранение данных

Anthropic является обработчиком данных для Claude Models on Google Cloud (Anthropic managed). Некоторые вспомогательные сервисы, например системы доверия и безопасности Anthropic, обрабатывают данные за пределами Google Cloud.

Claude Models on Google Cloud (Anthropic managed) следует той же политике хранения данных, что и Claude API. См. [API и хранение данных](https://platform.claude.com/docs/ru/manage-claude/api-and-data-retention). Нулевое хранение данных (ZDR) доступно по запросу. Свяжитесь с вашим представителем Anthropic.

Соглашение о ZDR для другой организации Anthropic не распространяется на вашу организацию для Claude Models on Google Cloud (Anthropic managed).

### Мониторинг и журналирование

[Cloud Audit Logs](https://cloud.google.com/logging/docs/audit) записывает активность API для Claude Models on Google Cloud (Anthropic managed) в вашем проекте. Записи отображаются в разделе сервиса `claude.googleapis.com`. Каждый маршрут API относится к одному из двух типов журналов:

* **Журналы Data Access:** охватывают большинство маршрутов, включая сообщения, пакеты, файлы, навыки, модели и большинство ресурсов Claude Managed Agents. По умолчанию они выключены.
* **Журналы Admin Activity:** охватывают остальные маршруты, включая маршруты ключей шифрования и большинство маршрутов хранилищ учётных данных. Исключение — маршрут для `vaults.verify`, который относится к Data Access. Журналы Admin Activity всегда включены.

Чтобы сохранять записи о запросах, включите журналы Data Access для `claude.googleapis.com` в настройках журналов аудита вашего проекта.

Типы журналов аудита по маршрутам см. в разделе [Разрешения IAM для Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ru/api/claude-models-on-google-cloud-anthropic-managed-iam-permissions).

#### Идентификаторы запросов

Успешные ответы от Claude Models on Google Cloud (Anthropic managed) содержат заголовок [`request-id`](https://platform.claude.com/docs/ru/api/errors#request-id).

## Переход с существующей организации Anthropic

Существующую организацию Anthropic нельзя преобразовать в организацию для Claude Models on Google Cloud (Anthropic managed). Это относится и к организации, которую вы используете с Claude API напрямую.

Планируйте переход как переключение на новую организацию:

* **Сначала создайте новую организацию.** Следуйте инструкциям в разделе [Настройка учётной записи](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account).
* **Воссоздайте доступ и конфигурацию.** Ключи API, рабочие пространства и настройки Claude Console не переносятся. Вместо создания ключей API выдавайте [роли IAM](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles) в проекте. Чтобы воссоздать рабочие пространства, см. [Рабочие пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#workspaces). О соглашениях ZDR см. [Хранение данных](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#data-retention).
* **Спланируйте работу с сохранёнными ресурсами.** Файлы, навыки, пакеты и ресурсы Claude Managed Agents остаются в существующей организации.
* **Обновите интеграцию.** О том, что меняется и что остаётся прежним, см. [Выполнение запросов](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#making-requests). О неподдерживаемых функциях см. [Неподдерживаемые функции](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#features-not-supported).
* **Переключайтесь по собственному графику.** Две организации независимы и могут обслуживать трафик параллельно. Рабочие нагрузки можно переносить постепенно. Существующая организация сохраняет текущий порядок выставления счетов. Прежде чем переводить производственный трафик, проверьте [ограничения скорости](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#rate-limits).

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

Чтобы перейти на Claude Models on Google Cloud (Anthropic managed), выполните следующие шаги. Прежде чем переносить рабочие нагрузки, которые зависят от соглашения о ZDR, ознакомьтесь с разделом [Хранение данных](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#data-retention). О том, что меняется при переходе, см. [Чем различаются два предложения Google Cloud](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/overview#how-the-two-google-cloud-offerings-differ).

<Steps>
  <Step title="Настройте свою учётную запись">
    Выполните все шаги из раздела [Настройка учётной записи](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account).
  </Step>

  <Step title="Настройте доступ">
    Предоставьте роль `roles/claude.user` каждому удостоверению, которое вызывает Claude Models on Google Cloud (Anthropic managed). Задайте свой проект и идентификатор рабочего пространства в качестве переменных окружения. Подробнее об обоих действиях см. [Перед выполнением вызовов API](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#before-making-api-calls).
  </Step>

  <Step title="Установите пакет SDK">
    Установите пакет, который предоставляет клиент для Claude Models on Google Cloud (Anthropic managed). См. [Установка SDK](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#install-an-sdk).
  </Step>

  <Step title="Замените импорт и клиент">
    Измените код, который импортирует и создаёт ваш клиент. Используйте `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 (Google managed). Например, следующий код создаёт такой клиент с глобальной конечной точкой:

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

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

    Следующий код создаёт клиент для 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>

    Новый клиент считывает ваш проект и идентификатор рабочего пространства из переменных окружения, которые вы задали в разделе [Поиск идентификатора рабочего пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-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/anthropic-managed#api-model-ids).
    * **Функции:** проверьте раздел [Поддержка функций](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#feature-support) для каждой функции, которую использует ваш код.
    * **Расположение:** если сейчас вы используете мультирегиональную или региональную конечную точку, проверьте, какое расположение использует Claude Models on Google Cloud (Anthropic managed). См. [Определение проекта, расположения и рабочего пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution).
  </Step>

  <Step title="Выполните тестовый запрос">
    Выполните запрос из раздела [Выполнение запросов](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#making-requests), чтобы убедиться, что ваша настройка работает. Затем запустите собственный код. Если вызов завершается ошибкой доступа, см. [Устранение неполадок при настройке учётной записи](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed#troubleshooting-account-setup). Прежде чем переносить производственный трафик, проверьте [ограничения скорости](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-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="Разрешения IAM" icon="lock" href="https://platform.claude.com/docs/ru/api/claude-models-on-google-cloud-anthropic-managed-iam-permissions">
    Найдите разрешения, роли и типы журналов аудита.
  </Card>

  <Card title="Вывод моделей из эксплуатации" icon="arrow-clockwise" href="https://platform.claude.com/docs/ru/about-claude/model-deprecations">
    По мере выпуска более безопасных и функциональных моделей Anthropic регулярно выводит из эксплуатации старые. Ознакомьтесь со всеми выводами из эксплуатации в API, а также с рекомендуемыми заменами.
  </Card>

  <Card title="Google Cloud Marketplace" icon="coins" href="https://console.cloud.google.com/marketplace">
    Управляйте своей подпиской и оплатой.
  </Card>
</CardGroup>
