Пользоваться Claude, сохранив договор и оплату через Google Cloud, можно двумя способами. Первый — вариант под управлением Google: его предоставляет сама Google в составе Agent Platform (бывший Vertex AI). Второй — вариант под управлением Anthropic: вы работаете с Claude API, который обслуживает Anthropic, из проекта Google Cloud. Он стал общедоступным 22 октября 2026 года (анонс Anthropic). Оба попадают в счёт Google Cloud, но различаются набором функций, регионами, тем, кто управляет лимитами использования, и поддержкой Claude Code.
Коротко: какой вариант выбрать
Под управлением Google
Включается в Model Garden в Agent Platform (бывший Vertex AI)
- Нужен Claude Code в Google Cloud
- Данные должна обрабатывать только Google, или инференс должен оставаться внутри ЕС
- Квотами хочется управлять в консоли Google Cloud
Под управлением Anthropic
Подписка через Google Cloud Marketplace
- Нужны Files API, Agent Skills, Managed Agents, web fetch, MCP connector и подобные функции
- Нужен fast mode для Opus 5.5
- Хочется получать новые функции сразу (заявленная политика — доступность в тот же день, что и в Claude API)
Если нужен только Claude Code, выбирайте вариант под управлением Google. В документации Claude Code не описана настройка Claude Code для варианта под управлением Anthropic.
Опираясь на официальную документацию Anthropic и Google Cloud (проверено 26 октября 2026 года), статья объясняет, чем различаются два варианта, а также разбирает цены, регионы, подключение, настройку Claude Code и работу с квотами и ошибками 429. В разделах, где речь идёт об обоих вариантах, они идут в порядке под управлением Google → под управлением Anthropic и обозначены теми же цветами.
1. Чем различаются два варианта
Оба называются «Claude Models on Google Cloud» и различаются пометкой в скобках: «Google managed» или «Anthropic managed». Vertex AI теперь называется у Google «Gemini Enterprise Agent Platform», и заголовки документации сменились на Agent Platform. При этом на экране входа Claude Code по-прежнему написано «Google Vertex AI».
| Параметр | Под управлением Google | Под управлением Anthropic |
|---|---|---|
| Кто предоставляет | Google (в составе Agent Platform) | Anthropic |
| Кто обрабатывает данные | Google Cloud | AnthropicGoogle отвечает за аутентификацию, маршрутизацию API, журналы аудита и оплату; инференс и хранение данных — на инфраструктуре Anthropic |
| Формат API | Эндпоинт прогнозирования Agent PlatformИмя модели указывается в URL | Как у Claude APIОтличаются только базовый URL и аутентификация |
| Оплата | Google Cloud (как использование Agent Platform) | Google Cloud MarketplaceУчёт в Claude Consumption Units (1 CCU = 0,01 долл. США) |
| Кто управляет лимитами | Google Cloud (квоты) | Anthropic |
| Роли IAM | roles/aiplatform.user и другие | roles/claude.user, roles/claude.admin, roles/claude.viewer |
| Консоль управления | Консоль Google Cloud (Model Garden) | Claude Console (открывается из консоли Google Cloud) |
| Клиент SDK | AnthropicVertex | AnthropicGoogleCloud (бета) |
| Новые модели и функции | Появляются по графику Agent Platform и Model Garden | Политика — в тот же день, что и в Claude API |
Источники: сравнительная таблица в документе Anthropic «Claude Models on Google Cloud», а также документы Google Cloud «Use Claude models on Google Cloud (Anthropic managed)» и «Anthropic Claude models». Проверено 26 октября 2026 года.
Есть и общее. Оба варианта вызываются с учётными данными Google Cloud (в том числе Application Default Credentials, ADC), а расходы попадают в счёт Google Cloud. Для Claude 4.6 и новее идентификаторы моделей в обоих вариантах такие же, как в Claude API (например, claude-opus-5-5). Для более старых моделей только вариант под управлением Google ставит @ перед датой (например, claude-haiku-4-5@20251001).
В варианте под управлением Anthropic для каждого проекта Google Cloud создаётся новая организация Anthropic. Она отделена от организации, которой вы уже пользуетесь в Claude API или Claude Enterprise, и перенести существующую организацию нельзя. API-ключи, рабочие пространства и настройки Console не переносятся, а такие ресурсы, как файлы и пакеты, остаются в исходной организации.
2. Как выбрать: 5 вопросов
Идите сверху вниз и остановитесь на первом подходящем пункте. Если не подходит ни один, решайте по тому, насколько легко оценить расходы. Вариант под управлением Google публикует прайс-лист и квоты по умолчанию, поэтому бюджет и лимиты можно оценить заранее. Широта функций и ранний доступ к новинкам варианта под управлением Anthropic становятся преимуществом, если вы можете уточнить тарифы в листинге Marketplace, а лимиты — у представителя Anthropic.
- Нужен Claude Code с оплатой через Google Cloud→Под управлением Google
- Данные должна обрабатывать только Google, или нужны VPC Service Controls, хранение данных в регионе либо сертификации вроде FedRAMP High→Под управлением Google
- Инференс должен выполняться только внутри ЕС→Под управлением Google (мультирегион eu)
- Вы используете Files API, Agent Skills, Managed Agents, web fetch, MCP connector, code execution или Message Batches API→Под управлением Anthropic
- Нужен fast mode для Opus 5.5→Под управлением Anthropic
Во втором вопросе перечислены случаи, когда документация Google Cloud рекомендует выбрать вариант под управлением Google (Use Claude models on Google Cloud (Anthropic managed)).
Можно пользоваться и обоими. Например, разработчики работают в Claude Code через вариант под управлением Google, а ваше собственное приложение вызывает Managed Agents через вариант под управлением Anthropic. Оба попадают в один счёт Google Cloud, но консоли управления и управление лимитами раздельные.
3. Различия в функциях
Главные различия — в серверных функциях, которые обслуживает Anthropic. Вариант под управлением Google построен вокруг Messages API, хранилища файлов и сред выполнения агентов в нём нет.
| Функция | Под управлением Google | Под управлением Anthropic |
|---|---|---|
| Messages API, стриминг | Есть | Есть |
| Кэширование промптов | Есть | Есть |
| Extended thinking, structured outputs | Есть | Есть |
| Веб-поиск | Есть | Есть |
| Computer use (инструмент API) | Есть | ЕстьНет в списке функций документации Anthropic, но указан в сравнительной таблице Google Cloud и в анонсе Anthropic |
| Web fetch, code execution, advisor | Нет | Есть |
| Files API | Нет | Есть |
| Agent Skills, MCP connector | Нет | Есть |
| Claude Managed Agents | Нет | ЕстьMCP-туннели недоступны |
| Message Batches API | НетВместо него — пакетное прогнозирование Agent Platform | Есть |
| Fast mode (Opus 5.5) | Не указаноНет в списке поддерживаемых функций | Есть |
Источники: раздел Feature support в документах Anthropic «Claude Models on Google Cloud (Anthropic managed)», «Claude Models on Google Cloud (Google managed)» и «Fast mode». Fast mode для варианта под управлением Google отсутствует в списке поддерживаемых функций в документации Anthropic, где не сказано ни что он доступен, ни что недоступен (в таблице функций Claude Code он значится как недоступный в Agent Platform). Проверено 26 октября 2026 года.
Как устроены Managed Agents, рассказано в статье «Что такое Claude Managed Agents?»; скорость и цены fast mode — в «Обзоре выхода Claude Opus 5.5».
4. Цены: столько же, сколько в Claude API?
Цены варианта под управлением Google
На эндпоинте global варианта под управлением Google тарифы на ввод, вывод и кэш для Opus 5.5, Sonnet 5.5 и Haiku 5.5 такие же, как в Claude API от Anthropic. Мультирегионы us и eu на 10% дороже global (региональные эндпоинты тоже на 10% дороже, но обслуживают только Sonnet 4.6 и более ранние модели; см. раздел 5).
Источники: «Pricing» от Anthropic, раздел о моделях Claude от Anthropic на странице Google Cloud «Agent Platform pricing» и документ Anthropic «Claude Models on Google Cloud (Google managed)» (мультирегиональные и региональные эндпоинты на 10% дороже global для Sonnet 4.5, Haiku 4.5, Opus 4.5 и более новых моделей). Проверено 26 октября 2026 года. Варианта под управлением Anthropic на диаграмме нет, потому что его потокенных тарифов нет в официальной документации (см. раздел ниже).
| Модель | Ввод | Вывод | Чтение из кэша | Запись в кэш (5 мин / 1 час) |
|---|---|---|---|---|
| Opus 5.5 | $4 | $20 | $0,20 | $5 / $8 |
| Sonnet 5.5 | $2 | $10 | $0,10 | $2,50 / $4 |
| Haiku 5.5Ввод до 100K токенов | $0,10 | $0,50 | $0,01 | $0,125 / $0,20 |
| Haiku 5.5Ввод свыше 100K токенов | $0,50 | $2,50 | $0,05 | $0,625 / $1 |
Доллары США за миллион токенов. Тарифы Claude API от Anthropic и эндпоинта global варианта под управлением Google (страницы цен обеих компаний, проверено 26 октября 2026 года). Мультирегионы us/eu стоят 1,1x от этих тарифов. Чтение из кэша стоит 0,05x от ввода для Opus 5.5 и Sonnet 5.5 и 0,1x для Haiku 5.5 (примечание на странице цен Anthropic). Полный список моделей и история тарифов — в статье «Сравнение цен Claude по моделям».
Provisioned Throughput, при котором мощности резервируются за фиксированную плату, недоступен на global и в мультирегионах и требует регионального эндпоинта (документация Google Cloud). Региональные эндпоинты обслуживают только Sonnet 4.6 и более ранние модели, поэтому Opus 5.5, Sonnet 5.5 и Haiku 5.5 используются с оплатой по факту.
Цены варианта под управлением Anthropic
В варианте под управлением Anthropic Anthropic учитывает использование в Claude Consumption Units (CCU, 1 CCU = 0,01 долл. США) и передаёт данные в Google Cloud, и сумма появляется в счёте Google Cloud. Отдельного счёта от Anthropic не будет. Потокенный прайс-лист не опубликован в официальной документации ни Anthropic, ни Google Cloud (проверено 26 октября 2026 года). Надёжный путь — посмотреть тарифы в листинге Google Cloud Marketplace перед подпиской, а после начала работы сделать небольшой тест и сверить фактическую сумму на странице Usage в Claude Console и в отчётах о расходах Google Cloud.
Официально задокументированы три вещи:
- Fast mode для Opus 5.5 стоит $8 за ввод и $40 за вывод за миллион токенов (страница Fast mode и анонс Anthropic).
- Если добавить в запрос
inference_geo: "us", чтобы инференс оставался в США, цены во всех категориях умножаются на 1,1 (Anthropic, «Data residency»). - Если у вас есть обязательство по расходам в Google Cloud, использование засчитывается в него, как и другие покупки в Marketplace. Если у вас есть соглашение о скидке, свяжитесь с представителем Anthropic или Google Cloud до начала работы (скидки не применяются задним числом).
Цены на пакетную обработку
Пакеты в двух вариантах устроены по-разному. Вариант под управлением Google использует пакетное прогнозирование Agent Platform (входные данные JSONL из BigQuery или Cloud Storage), а его тарифы указаны в колонке batch на странице цен Google Cloud. Вариант под управлением Anthropic поддерживает тот же Message Batches API, что и Claude API, но его пакетных тарифов в официальной документации тоже нет. Скидка на пакеты в Claude API (напрямую) описана в статье «Сравнение цен Claude по моделям».
5. Регионы и хранение данных
У Claude в Google Cloud место выполнения инференса определяется тем, какой location вы вызываете. Вариант под управлением Google предлагает три типа, а вариант под управлением Anthropic — только global.
global
Под управлением Google Под управлением Anthropic
Инференс выполняется в любом регионе, где есть свободные мощности. Тарифы как у Claude API. В варианте под управлением Anthropic запрос можно ограничить США с помощью inference_geo: "us" (1,1x).
Мультирегион us/eu
Под управлением Google
Инференс выполняется только внутри США или ЕС. Доступен для Claude 4.7 и более новых моделей. Тарифы 1,1x.
Региональный
Под управлением Google
Инференс выполняется только в одном указанном вами регионе. Обслуживает Sonnet 4.6 и более ранние модели; новые модели используют global или мультирегион.
Источники: документы Anthropic «Claude Models on Google Cloud (Google managed)» и «(Anthropic managed)», документ Google Cloud «Agent Platform partner models». Проверено 26 октября 2026 года.
Различается и место хранения данных. Вариант под управлением Google хранит данные в выбранном регионе или мультирегионе. Однако на странице Google Cloud о партнёрских моделях также сказано, что место обработки может отличаться от места хранения. В документации Anthropic, напротив, говорится, что мультирегиональный инференс остаётся в пределах us или eu, и как соотносятся эти два утверждения, не объясняется. Если у вас строгие требования к месту обработки, уточните у Google Cloud до подписания договора. Кроме того, политикой организации constraints/gcp.restrictEndpointUsage можно заблокировать эндпоинт global и разрешить только мультирегионы.
В варианте под управлением Anthropic регион хранения рабочего пространства — "us", и изменить его нельзя (Anthropic, «Data residency»).
По состоянию на 26 октября 2026 года мультирегионы в официальной документации обоих вариантов охватывают только США и ЕС. Если обработка или хранение должны оставаться внутри конкретной страны за пределами этих зон, до подписания договора уточните у Google Cloud или представителя Anthropic, есть ли подходящий location.
6. Подключение
Для обоих вариантов нужны проект Google Cloud и платёжный аккаунт с включённой оплатой. Ниже — шаги из официальной документации, чтобы сделать доступным каждый вариант, а затем общие шаги аутентификации и вызова модели.
Под управлением Google: подключение
- Включите Agent Platform API
Это делается один раз на проект.gcloud config set project YOUR-PROJECT-ID gcloud services enable aiplatform.googleapis.com - Включите нужные модели Claude в Model GardenТому, кто их включает, нужна роль Consumer Procurement Entitlement Manager (
roles/consumerprocurement.entitlementManager). Кроме того, политика организации должна разрешатьcloudcommerceconsumerprocurement.googleapis.com. В документации Claude Code сказано, что одобрение доступа может занять от 24 до 48 часов (в документации Google Cloud срок не указан). - Выдайте роль тем, кто будет вызывать модельВыдайте роль с разрешением
aiplatform.endpoints.predict(roles/aiplatform.user).
Источники: Anthropic «Claude Models on Google Cloud (Google managed)», Google Cloud «Agent Platform partner models». Проверено 26 октября 2026 года.
Типичные проблемы при подключении (под управлением Google)
- Не удаётся включить модель в Model Garden: проверьте, что у включающего есть роль Consumer Procurement Entitlement Manager и что политика организации разрешает
cloudcommerceconsumerprocurement.googleapis.com. - Вызовы возвращают 404 (модель не найдена): проверьте, что модель включена и существует в выбранном location (новые модели есть только в global или мультирегионах).
- Вызовы возвращают 403: проверьте, что у вызывающего есть
roles/aiplatform.user.
Под управлением Anthropic: подключение
- Оформите подписку в MarketplaceОткройте «Claude Models on Google Cloud (Anthropic managed)» в Google Cloud Marketplace и нажмите Subscribe. Нужны права на покупки в Marketplace для платёжного аккаунта.
- Включите две службы
Это делается один раз на проект.gcloud services enable claude.googleapis.com \ anthropic-managed-claude.cloudpartnerservices.goog \ --project=YOUR-PROJECT-ID - Активируйте организациюНажмите Activate на странице Claude, затем по ссылке, отправленной на контактный адрес, введите название организации, тип бизнеса, страну и сценарий использования и примите Commercial Terms of Service и Usage Policy Anthropic. Для этого нужна роль
roles/claude.admin. - Запишите ID рабочего пространстваВ Claude Console (открывается из консоли Google Cloud) перейдите в Settings > Workspaces и запишите ID, начинающийся с
wrkspc_. Он нужен для вызовов. - Выдайте роль тем, кто будет вызывать модельВыдайте
roles/claude.user. Роли действуют на уровне проекта, поэтому, если нужно разделить команды, используйте отдельные проекты (каждый проект становится отдельной организацией Anthropic).
Источник: раздел Set up your account в документе Anthropic «Claude Models on Google Cloud (Anthropic managed)» (проверено 26 октября 2026 года). Войти в организацию Anthropic по адресу электронной почты нельзя; Console открывается из консоли Google Cloud.
Оба варианта: аутентификация и вызов
В любом варианте выполните gcloud auth application-default login на машине, с которой идут вызовы, чтобы создать ADC, и SDK будет использовать эти учётные данные (на серверах используйте учётные данные сервисного аккаунта). Затем вызывайте модель клиентом SDK из раздела 7.
Типичные проблемы при подключении (под управлением Anthropic)
- Служба не находится: запускайте
gcloudпод тем же аккаунтом, с которым оформляли подписку в Marketplace. - Ошибка прав при первом вызове: проверьте, что
claude.googleapis.comвключена и что у вызывающего естьroles/claude.user. - Кнопка так и остаётся «Finish Setup»: администратор не закончил ввод данных организации.
- Использование не отображается в Console: оно появляется через несколько минут.
7. Вызов Claude из SDK
Официальные SDK Anthropic поддерживают оба варианта. Различаются только устанавливаемый пакет и имя клиента; messages.create пишется так же, как с Claude API.
Под управлением Google (Python)
# pip install -U "anthropic[vertex]"
from anthropic import AnthropicVertex
client = AnthropicVertex(project_id="YOUR-PROJECT-ID", region="global") # подойдут и "us" или "eu"
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello, Claude"}],
)В TypeScript используйте AnthropicVertex из @anthropic-ai/vertex-sdk. Чтобы вызывать по HTTP без SDK, используйте URL вида https://aiplatform.googleapis.com/v1/projects/YOUR-PROJECT-ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict; имя модели в тело запроса не включайте, а укажите в нём "anthropic_version" (vertex-2023-10-16 или 2026-10-21). Для стриминга используйте :streamRawPredict. Что меняется в новой версии API 2026-10-21, рассказано в статье «temperature is deprecated for this model: причины и решения».
Под управлением Anthropic (Python)
# pip install -U "anthropic[google_cloud]"
# Переменные окружения: ANTHROPIC_GOOGLE_CLOUD_PROJECT и
# ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID (обязательны)
from anthropic import AnthropicGoogleCloud
client = AnthropicGoogleCloud()
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello, Claude"}],
)В TypeScript это AnthropicGoogleCloud из @anthropic-ai/google-cloud-sdk (оба в бета-версии). По HTTP тела запроса и ответа такие же, как у Claude API; отличия такие:
- Базовый URL:
https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke, он включает ID рабочего пространства (заголовокanthropic-workspace-idне отправляйте). - Аутентификация: отправляйте токен доступа Google в
Authorization: Bearer(x-api-keyне отправляйте). - API-ключи: создать нельзя. Переменные окружения
ANTHROPIC_API_KEYиANTHROPIC_BASE_URLигнорируются.
Источники: Anthropic «Claude Models on Google Cloud (Anthropic managed)» и «(Google managed)». Проверено 26 октября 2026 года.
8. Claude Code в Google Cloud
В Google Cloud Claude Code поддерживает вариант под управлением Google. В таблице функций Claude Code Agent Platform определяется как «run by Google, configured with CLAUDE_CODE_USE_VERTEX». Как использовать Claude Code с вариантом под управлением Anthropic, в документации Claude Code не описано (проверено 26 октября 2026 года).
Два способа настройки
- Настройка мастеромЗапустите
claudeи на экране входа выберите «3rd-party platform» → «Google Vertex AI» (если вы уже вошли, используйте/login). Мастер спросит способ аутентификации, проект и регион, покажет, какие модели доступны, и позволит их закрепить. Результат сохраняется вenvпользовательских настроек (~/.claude/settings.json), а открыть мастер снова можно командой/setup-vertex. - Настройка переменными окруженияПодходит для CI и развёртывания на команду. Включив модели в Model Garden, задайте следующее.
Зачем закреплять модели, объясняется в предупреждении ниже.export CLAUDE_CODE_USE_VERTEX=1 export CLOUD_ML_REGION=global export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID # Закрепляем модели # Основная модель: Sonnet экономит расходы. Для Opus укажите claude-opus-5-5 export ANTHROPIC_MODEL=claude-sonnet-5-5 export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5 export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5
В любом случае после настройки выполните /status. Если в «API provider» указано Google Vertex AI и появились строки с проектом GCP, регионом и моделью, настройка удалась.
Источники: Claude Code «Claude Code on Google Cloud's Agent Platform» и «Environment variables». Проверено 26 октября 2026 года.
Две опасности, если не закреплять модели
- Стоимость: в Agent Platform основная модель по умолчанию, когда ничего не закреплено, — Opus 5.5. Документация Claude Code предупреждает, что без закрепления оплата идёт по тарифам Opus.
- Сдвиг псевдонимов: псевдоним
sonnetуказывает на Sonnet 4.5, аhaiku— на Haiku 4.5, что отличается от псевдонимов в Claude API. Чтобы модели у пользователей не менялись с выходом новых, при развёртывании на нескольких человек закрепите их четырьмя переменными выше.
Как работают псевдонимы, рассказано и в статье «Что такое opusplan в Claude Code?»
Если модель недоступна в location из CLOUD_ML_REGION, регион можно переопределить только для этой модели, например VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5 (в этом примере только Haiku 4.5 вызывается в регионе us-east5). CLOUD_ML_REGION принимает global, us или eu либо имя региона, например us-east5. Claude Agent SDK тоже работает с вариантом под управлением Google через те же переменные окружения (см. «Что такое Claude Agent SDK?»).
Автообновление учётных данных, кэширование и контекст 1M
- Чтобы ADC обновлялись автоматически по истечении срока, добавьте в настройки
"gcpAuthRefresh": "gcloud auth application-default login"(обновление считается неудачным, если команда аутентификации не завершилась за 3 минуты). - Кэширование промптов применяется автоматически. Чтобы отключить его, задайте
DISABLE_PROMPT_CACHING=1; для часового кэша задайтеENABLE_PROMPT_CACHING_1H=1(тариф записи выше). - Такие модели, как Sonnet 5 и новее и Opus 4.7 и новее, по умолчанию используют контекст в 1M токенов. Чтобы использовать 200K, задайте
CLAUDE_CODE_DISABLE_1M_CONTEXT=1. - Документация Claude Code рекомендует создать для Claude Code отдельный проект, чтобы отслеживать его расходы отдельно.
Какие функции Claude Code работают в Agent Platform
| Статус | Функции |
|---|---|
| Недоступно | Функции, требующие подписки Claude (облачные сессии, Slack, /schedule, Ultrareview, Code Review, Remote Control, расширение Chrome, computer use, Artifacts, голосовой ввод), fast mode, Advisor, Channels, панель аналитики, управляемые сервером настройки, /logout |
| Частично | Веб-поиск (Opus 4, Sonnet 4, Haiku 4.5 и новее), auto mode (Sonnet 5 и новее, Opus 4.7 и новее, Haiku 5.5, Claude Fable), нулевое хранение данных (зависит от вашего соглашения с Google Cloud) |
| Доступно | GitHub Actions, GitLab CI/CD, MCP tool search (Opus 4.5, Sonnet 4.5, Haiku 4.5 и новее) |
Computer use в этой таблице — функция Claude Code (требует подписки), а не инструмент API computer use из раздела 3. Источник: Claude Code «Feature availability» (/logout и MCP tool search — из «Claude Code on Google Cloud's Agent Platform»). Проверено 26 октября 2026 года. Коннекторы claude.ai тоже не загружаются (см. «Коннекторы claude.ai отключены в Claude Code»).
Частые ошибки Claude Code и их решение (под управлением Google)
Could not load the default credentials: выполнитеgcloud auth application-default loginили укажите вGOOGLE_APPLICATION_CREDENTIALSпуть к файлу ключа.- Модель не найдена (404): проверьте, что модель включена в Model Garden и существует в выбранном location (новые модели есть только в global или мультирегионах).
- 429: если вы указали регион, проверьте, что там доступны и основная, и малая модель, и подумайте о
CLOUD_ML_REGION=global.
9. Квоты и ошибки 429
Под управлением Google: квоты задаются на семейство моделей
Модели, выпущенные после 26 мая 2026 года (Opus 5.5, Sonnet 5.5, Haiku 5.5 и другие), используют квоты, общие для всего семейства моделей (для более ранних моделей смотрите поштучные квоты на той же странице Google Cloud). Например, какую бы версию Opus вы ни вызывали на global, расход идёт из одной квоты anthropic-claude-opus, и при выходе новой версии запрашивать квоту заново не нужно. У global и у каждого мультирегиона квоты раздельные.
| Модель | global (в минуту) | Мультирегион us/eu (каждый, в минуту) |
|---|---|---|
| Opus 5.5 | 2000 запросов / 20M входных токенов / 2M выходных токенов | 1000 запросов / 10M входных токенов / 1M выходных токенов |
| Sonnet 5.5 | 2500 запросов / 25M входных токенов / 2,5M выходных токенов | 1250 запросов / 12,5M входных токенов / 1,25M выходных токенов |
| Haiku 5.5 | 3000 запросов / 30M входных токенов / 3M выходных токенов | 1500 запросов / 15M входных токенов / 1,5M выходных токенов |
Источник: квоты по умолчанию в документе Google Cloud «Quotas for Anthropic Claude models» (проверено 26 октября 2026 года). Ввод — это сумма некэшированных токенов и записей в кэш. Google отмечает, что лимиты зависят от аккаунта и могут быть ограничены.
Проверять квоты и запрашивать их увеличение можно на странице Quotas & System Limits в консоли Google Cloud. Фильтр по base_model (например, anthropic-claude-opus) упрощает поиск. Число токенов на этой странице может быть неточным из-за того, как работают оценка и возвраты; для точного подсчёта используйте API подсчёта токенов или token_count в Metrics Explorer.
При превышении квоты вы получите ошибку 429 с таким сообщением:
Resource exhausted, please try again later.Это сообщение для оплаты по факту (Google Cloud, «Error code 429»). С Provisioned Throughput оно выглядит как «Too many requests. Exceeded the Provisioned Throughput.»
- Используйте global, если нет требований к месту инференсаУ него квоты больше, чем у мультирегионов, и обработка идёт в любом регионе со свободными мощностями. В Claude Code задайте
CLOUD_ML_REGION=global. Если есть требование вроде инференса внутри ЕС, пропустите этот шаг и сначала запросите увеличение (шаг 3). - Подождите и повторитеПовторяйте с экспоненциальной задержкой с ограничением и избегайте резких всплесков нагрузки.
- Запросите увеличение квотыСделайте это на упомянутой выше странице Quotas & System Limits.
Источники: Google Cloud «Error code 429», раздел устранения неполадок в документе Claude Code «Claude Code on Google Cloud's Agent Platform».
Под управлением Anthropic: лимитами управляет Anthropic
Лимитами использования управляет Anthropic, а значений по умолчанию в официальной документации нет. Об увеличении говорите с представителем Anthropic или отделом продаж. Документация Anthropic рекомендует уточнить лимиты до переноса продакшен-трафика. Ошибки имеют тот же вид, что и в Claude API: превышение лимита возвращает 429 rate_limit_error, перегрузка — 529 overloaded_error. Если не хватает прав IAM, Google Cloud возвращает 403.
- Подождите и повторитеПовторяйте с экспоненциальной задержкой и избегайте резких всплесков нагрузки (как и в варианте под управлением Google).
- Уточните лимиты до продакшенаПеред миграцией сообщите представителю Anthropic нужный объём и уточните лимиты.
- Попросите увеличить лимитОбратитесь к представителю Anthropic или в отдел продаж. На странице квот Google Cloud эти лимиты повысить нельзя.
Источники: раздел Rate limits в документе Anthropic «Claude Models on Google Cloud (Anthropic managed)» и «Errors». Проверено 26 октября 2026 года.
Итоги
- Claude в Google Cloud бывает в двух вариантах: под управлением Google (Agent Platform, бывший Vertex AI) и под управлением Anthropic. Оба попадают в счёт Google Cloud.
- Для Claude Code используйте вариант под управлением Google. Задайте
CLAUDE_CODE_USE_VERTEX=1и связанные переменные, а при развёртывании на нескольких человек закрепите модели четырьмя переменными. - Для Files API, Agent Skills, Managed Agents, web fetch, MCP connector и подобного, а также для fast mode в Opus 5.5 используйте вариант под управлением Anthropic.
- У варианта под управлением Google на global тарифы для Opus 5.5, Sonnet 5.5 и Haiku 5.5 такие же, как в Claude API. Мультирегионы us/eu — 1,1x. Вариант под управлением Anthropic учитывается в CCU, и потокенного прайс-листа в официальной документации нет.
- Квоты варианта под управлением Google общие для семейства моделей; при превышении возвращается 429 «Resource exhausted, please try again later.» Решение — global, повторы и запрос на увеличение. Лимитами варианта под управлением Anthropic управляет Anthropic.
- Вариант под управлением Anthropic создаёт новую организацию Anthropic на каждый проект, перенести существующие организации нельзя.
- В официальной документации обоих вариантов мультирегионы — только us и eu; требования к хранению внутри других стран уточняйте до подписания договора.
Частые вопросы
Q. Claude в Vertex AI дороже, чем Claude API?
На эндпоинте global варианта под управлением Google тарифы на ввод, вывод и кэш для Opus 5.5, Sonnet 5.5 и Haiku 5.5 одинаковые. Мультирегионы us и eu на 10% дороже (страницы цен Anthropic и Google Cloud, проверено 26 октября 2026 года). Для варианта под управлением Anthropic потокенных тарифов в официальной документации нет, поэтому смотрите листинг в Google Cloud Marketplace.
Q. Можно ли использовать API-ключ Claude?
Оба варианта вызываются с аутентификацией Google Cloud (ADC или сервисный аккаунт), а не с API-ключом, созданным в Claude Console. В варианте под управлением Anthropic API-ключи создать нельзя, а заданный ANTHROPIC_API_KEY игнорируется.
Q. Можно ли использовать Claude Code с вариантом под управлением Anthropic?
В документации Claude Code настройка для варианта под управлением Anthropic не описана (проверено 26 октября 2026 года). Параметр Claude Code для Google Cloud (CLAUDE_CODE_USE_VERTEX) предназначен для варианта под управлением Google.
Q. Можно ли перевести текущую организацию Anthropic на оплату через Google Cloud?
Нет. Вариант под управлением Anthropic создаёт новую организацию на каждый проект, а существующие организации преобразовать нельзя. API-ключи, рабочие пространства и настройки Console не переносятся, поэтому их нужно создать заново в новой организации.
