Claude Models on Google Cloud (Anthropic managed)

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

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

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

• Разрешение на покупки в Google Cloud Marketplace для вашего платёжного аккаунта
• Разрешение на включение сервисов в проекте
• Роль IAM, позволяющая открыть Claude Console, которая нужна для шага 4

Эти шаги создают новую организацию Anthropic для вашего проекта Google Cloud. Она отделена от любой организации Anthropic, которая уже есть у вашей компании. Это относится и к организации Claude Enterprise. Чтобы перейти с существующей организации, см. Переход с существующей организации Anthropic.

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

1. 1

   Оформите подписку в Marketplace

   1. Откройте Google Cloud 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.

2. 2

   Включите сервисы

   Включите два сервиса в каждом проекте, который обращается к 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, который относит использование проекта к вашей подписке.

   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 и найдите оба имени.

3. 3

   Настройте организацию Anthropic

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

   Контактный адрес используется только для настройки и служебных уведомлений. О том, как пользователи открывают Claude Console после настройки, см. Использование Claude Console.

4. 4

   Откройте Claude Console

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

   Находясь в Claude Console, найдите идентификатор рабочего пространства и скопируйте его. Он нужен всем, кто обращается к Claude Models on Google Cloud (Anthropic managed). Передайте его своим разработчикам.

Чтобы добавить ещё один проект, повторите эти шаги в этом проекте, начиная с шага 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. Применение новой выдачи роли или только что включённого сервиса может занять некоторое время.
• «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. Выдавайте роли на уровне проекта.

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

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

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

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

В Claude Models on Google Cloud (Anthropic managed) нельзя войти в организацию Anthropic с помощью адреса электронной почты. Вместо этого выберите Open Claude Console на странице Claude в консоли Google Cloud. Google Cloud IAM определяет, кто может открыть Claude Console. Из трёх предопределённых ролей IAM открыть Claude Console позволяет только roles/claude.admin в проекте.

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

В Claude Models on Google Cloud (Anthropic managed) при настройке создаётся организация Anthropic с одним рабочим пространством — Default Workspace. Чтобы создать дополнительные рабочие пространства, откройте Claude Console и перейдите в Settings > Workspaces. На той же странице можно переименовать или архивировать любое рабочее пространство, кроме Default Workspace. У каждого рабочего пространства есть собственный идентификатор рабочего пространства. Файлы, навыки, пакеты, сеансы Claude Managed Agents и другие ресурсы рабочего пространства принадлежат тому рабочему пространству, идентификатор которого вы указали для запроса.

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

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

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

1. Проект Google Cloud с активной подпиской и организацией Anthropic, настройка которой завершена. См. Настройка учётной записи.
2. Установленный gcloud CLI для локальной разработки.
3. Роль roles/claude.user, выданная в проекте удостоверению, которое выполняет вызовы.
4. Application Default Credentials для этого удостоверения. См. Аутентификация.
5. Идентификатор вашего проекта и идентификатор рабочего пространства.

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

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.

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

Чтобы найти идентификатор рабочего пространства для Claude Models on Google Cloud (Anthropic managed), откройте Claude Console и перейдите в Settings > Workspaces. Идентификатор начинается с wrkspc_. Если вы не можете открыть Claude Console, попросите того, кто может, прислать вам идентификатор.

Задайте проект и рабочее пространство в виде переменных окружения, чтобы клиенты SDK и ant CLI их подхватили:

export ANTHROPIC_GOOGLE_CLOUD_PROJECT="my-project-id"
export ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID="wrkspc_01AbCdEf23GhIj"

Установка SDK

Клиент SDK для Claude Models on Google Cloud (Anthropic managed) — это AnthropicGoogleCloud. Клиент определяет ваши учётные данные Google. Он также формирует базовый URL из вашего проекта, расположения и идентификатора рабочего пространства.

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

pip install -U "anthropic[google_cloud]"

Чтобы вместо этого использовать ant CLI, установите или обновите его до последней версии. Версия без поддержки Claude Models on Google Cloud (Anthropic managed) игнорирует переменные ANTHROPIC_GOOGLE_CLOUD_*. В этом случае она делает одно из следующего:

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

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

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

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

Маршруты уровня организации, пути которых начинаются с /v1/organizations/, используют базовый URL без рабочего пространства:

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

Если вы не задаёте базовый URL, клиенты SDK выбирают между этими двумя вариантами для каждого запроса.

Добавьте путь Claude API к базовому URL. Например, Messages API находится по адресу .../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.

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)

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

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

Claude Models on Google Cloud (Anthropic managed) использует те же идентификаторы моделей, что и Claude API, например claude-opus-5-5. О моделях и их идентификаторах см. Обзор моделей.

В 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 и workspace_id.

Оставьте расположение global. Расположение не связано с тем, где выполняется инференс, поэтому для инференса только в США задавайте inference_geo: "us" в каждом запросе, как описано в разделе Резидентность данных.

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.

Клиенты SDK получают токен из 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 работает:

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 при создании клиента. Это функция или источник токенов, возвращающий токен доступа. Клиент запрашивает у него токен при каждом запросе. Кэширование и обновление токена — ваша ответственность.
2. Объект учётных данных Google, который вы передаёте как credentials при создании клиента. В Go SDK этого варианта нет.
3. Application Default Credentials.

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

• Go: для варианта 1 клиент принимает oauth2.TokenSource. Он кэширует токен до истечения его срока действия.
• Java: используйте GoogleCloudBackend.fromEnv(), чтобы считать Application Default Credentials и переменные окружения из раздела Определение проекта, расположения и рабочего пространства.

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

Если ваши запросы проходят через прокси, который сам добавляет токен, задайте skip_auth. Тогда клиент не отправляет заголовок 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, если он указывает на профиль конфигурации, с помощью которого CLI может пройти аутентификацию
• Любая из переменных федерации Anthropic:
  • ANTHROPIC_FEDERATION_RULE_ID
  • ANTHROPIC_ORGANIZATION_ID
  • ANTHROPIC_SERVICE_ACCOUNT_ID
  • ANTHROPIC_IDENTITY_TOKEN
  • ANTHROPIC_IDENTITY_TOKEN_FILE

Если что-то из этого задано, CLI использует эти учётные данные вместо параметров Google Cloud из раздела Поиск идентификатора рабочего пространства. Если задана только часть переменных федерации, 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 (быстрый режим): Быстрый режим для Claude Opus 5.5.

• Бета-функции: если в Claude API бета-версия доступна только избранным организациям, организации Anthropic, созданной при настройке, нужен такой же доступ.
• Инструменты: «tool use» (использование инструментов), включая:
  • Веб-поиск
  • Веб-загрузку
  • Выполнение кода
  • Инструмент памяти
  • Инструмент-советник
  • Коннектор MCP
• Навыки и файлы: Agent Skills и Files API.
• Возможности моделей:
  • «Prompt caching» (кэширование подсказок)
  • «Extended thinking» (расширенные размышления)
  • Резервный вариант на стороне сервера
  • Потоковая передача
  • Структурированные выходные данные
  • Подсчёт токенов
• Пакеты и модели: Message Batches API и Models API.

Чтобы включить или выключить Compliance API для организации Anthropic, созданной при настройке, откройте Claude Console, перейдите в Settings > Compliance и воспользуйтесь переключателем Compliance API.

Ключи шифрования, управляемые клиентом (CMEK), доступны с ключами Google Cloud KMS. Чтобы активировать CMEK для организации Anthropic, созданной при настройке, см. Ключи шифрования, управляемые клиентом. Чтобы настроить ключ, следуйте инструкциям в разделе Настройка Google Cloud KMS для CMEK. Затем зарегистрируйте, проверьте и подключите ключ в Claude Console, как описано на вкладке Claude Console страницы настройки.

Claude Managed Agents

Claude Managed Agents доступен через Claude Models on Google Cloud (Anthropic managed), включая следующее:

• Агенты
• Среды
• Сеансы
• Хранилища учётных данных
• Хранилища памяти
• Развёртывания по расписанию
• Самостоятельно размещаемые песочницы

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

• Запущенные сеансы продолжают работать. Если вы отзовёте доступ Google Cloud у удостоверения, создавшего сеанс, сеанс не остановится. Чтобы остановить его, отправьте ему отдельное событие user.interrupt. После того как сеанс перейдёт в состояние idle, его можно архивировать или удалить.
• Развёртывания по расписанию продолжают работать. Развёртывание не перепроверяет доступ своего создателя при каждом запуске по расписанию. Чтобы остановить его, приостановите, обновите или архивируйте его.

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

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

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

• Ключи API: аутентификация выполняется только с помощью учётных данных Google Cloud.
• Туннели MCP: туннели MCP недоступны в Claude Models on Google Cloud (Anthropic managed).
• Хранилища памяти в самостоятельно размещаемых средах: хранилища памяти не поддерживаются для сеансов в самостоятельно размещаемых средах.
• Готовые рабочие процессы для самостоятельно размещаемых песочниц: самостоятельно размещаемые рабочие процессы в ant CLI и в SDK для Python, TypeScript и Go не поддерживают Claude Models on Google Cloud (Anthropic managed). Вместо этого реализуйте собственный рабочий процесс, который напрямую вызывает конечные точки Environments Work. Сведения о ролях и разрешениях, необходимых вашему рабочему процессу, см. в разделе Разрешения IAM для сред.

Контекстное окно

Размеры «context window» (контекстного окна) в Claude Models on Google Cloud (Anthropic managed) такие же, как в Claude API. Ограничение для каждой модели см. в разделе Контекстные окна.

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

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

Anthropic управляет «rate limits» (ограничениями скорости) для Claude Models on Google Cloud (Anthropic managed). Чтобы запросить более высокие ограничения, свяжитесь с вашим представителем Anthropic или с отделом продаж. О том, как измеряются и сообщаются ограничения скорости, см. Ограничения скорости.

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

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

Данные об использовании и затратах можно просмотреть на страницах Usage и Cost в 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 и хранение данных. Нулевое хранение данных (ZDR) доступно по запросу. Свяжитесь с вашим представителем Anthropic.

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

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

Cloud Audit Logs записывает активность 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).

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

Успешные ответы от Claude Models on Google Cloud (Anthropic managed) содержат заголовок request-id.

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

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

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

• Сначала создайте новую организацию. Следуйте инструкциям в разделе Настройка учётной записи.
• Воссоздайте доступ и конфигурацию. Ключи API, рабочие пространства и настройки Claude Console не переносятся. Вместо создания ключей API выдавайте роли IAM в проекте. Чтобы воссоздать рабочие пространства, см. Рабочие пространства. О соглашениях ZDR см. Хранение данных.
• Спланируйте работу с сохранёнными ресурсами. Файлы, навыки, пакеты и ресурсы Claude Managed Agents остаются в существующей организации.
• Обновите интеграцию. О том, что меняется и что остаётся прежним, см. Выполнение запросов. О неподдерживаемых функциях см. Неподдерживаемые функции.
• Переключайтесь по собственному графику. Две организации независимы и могут обслуживать трафик параллельно. Рабочие нагрузки можно переносить постепенно. Существующая организация сохраняет текущий порядок выставления счетов. Прежде чем переводить производственный трафик, проверьте ограничения скорости.

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

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

1. 1

   Настройте свою учётную запись

   Выполните все шаги из раздела Настройка учётной записи.

2. 2

   Настройте доступ

   Предоставьте роль roles/claude.user каждому удостоверению, которое вызывает Claude Models on Google Cloud (Anthropic managed). Задайте свой проект и идентификатор рабочего пространства в качестве переменных окружения. Подробнее об обоих действиях см. Перед выполнением вызовов API.

3. 3

   Установите пакет SDK

   Установите пакет, который предоставляет клиент для Claude Models on Google Cloud (Anthropic managed). См. Установка SDK.

4. 4

   Замените импорт и клиент

   Измените код, который импортирует и создаёт ваш клиент. Используйте AnthropicGoogleCloud вместо AnthropicVertex. В запросе cURL измените URL, заголовки и тело. Ваш текущий код создаёт клиент для Claude Models on Google Cloud (Google managed). Например, следующий код создаёт такой клиент с глобальной конечной точкой:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicVertex
   
   project_id = "MY_PROJECT_ID"
   region = "global"
   
   client = AnthropicVertex(project_id=project_id, region=region)

   Следующий код создаёт клиент для Claude Models on Google Cloud (Anthropic managed):

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicGoogleCloud
   
   client = AnthropicGoogleCloud()

   Новый клиент считывает ваш проект и идентификатор рабочего пространства из переменных окружения, которые вы задали в разделе Поиск идентификатора рабочего пространства. Вам не нужно передавать их при создании клиента. Ваши вызовы Messages API остаются без изменений, за исключением идентификаторов моделей и функций, описанных в следующем шаге.

5. 5

   Проверьте идентификаторы моделей и функции

   • Идентификаторы моделей: если вы используете модель, выпущенную до Claude 4.6, замените @ перед датой снимка в её идентификаторе на дефис. Например, claude-haiku-4-5@20251001 становится claude-haiku-4-5-20251001. Список моделей и их идентификаторов см. в разделе Идентификаторы моделей API.
   • Функции: проверьте раздел Поддержка функций для каждой функции, которую использует ваш код.
   • Расположение: если сейчас вы используете мультирегиональную или региональную конечную точку, проверьте, какое расположение использует Claude Models on Google Cloud (Anthropic managed). См. Определение проекта, расположения и рабочего пространства.
6. 6

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

   Выполните запрос из раздела Выполнение запросов, чтобы убедиться, что ваша настройка работает. Затем запустите собственный код. Если вызов завершается ошибкой доступа, см. Устранение неполадок при настройке учётной записи. Прежде чем переносить производственный трафик, проверьте ограничения скорости.

Следующие шаги