Claude Code на Google Cloud's Agent Platform

​

Предварительные требования

• Учетная запись Google Cloud Platform (GCP) с включенной биллингом
• Проект GCP с включенным API Google Cloud’s Agent Platform
• Доступ к нужным моделям Claude (например, Claude Sonnet 4.6)
• Установленный и настроенный Google Cloud SDK (gcloud)
• Квота, выделенная в нужном регионе GCP

​

Вход с Agent Platform

​

Конфигурация региона

​

Ручная установка

​

1. Включите API Agent Platform

# Установите ID вашего проекта
gcloud config set project YOUR-PROJECT-ID

# Включите API Agent Platform
gcloud services enable aiplatform.googleapis.com

​

2. Запросите доступ к модели

1. Перейдите в Google Cloud’s Agent Platform Model Garden
2. Найдите модели “Claude”
3. Запросите доступ к нужным моделям Claude (например, Claude Sonnet 4.6)
4. Дождитесь одобрения (может занять 24-48 часов)

​

3. Настройте учетные данные GCP

​

Расширенная конфигурация учетных данных

{
  "gcpAuthRefresh": "gcloud auth application-default login",
  "env": {
    "ANTHROPIC_VERTEX_PROJECT_ID": "your-project-id"
  }
}

​

4. Настройте Claude Code

# Включите интеграцию Agent Platform
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

# Опционально: переопределите URL конечной точки Agent Platform для пользовательских конечных точек или шлюзов
# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com

# Опционально: отключите кэширование запросов, если необходимо
export DISABLE_PROMPT_CACHING=1

# Опционально: запросите TTL кэша запросов на 1 час вместо стандартного 5-минутного
export ENABLE_PROMPT_CACHING_1H=1

# Когда CLOUD_ML_REGION=global, переопределите регион для моделей, которые не поддерживают глобальные конечные точки
export VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5
export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

​

5. Закрепите версии моделей

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

• Когда вы выбираете основную модель с помощью --model, ANTHROPIC_MODEL или параметра model, фоновые задачи используют эту модель. Установка ANTHROPIC_DEFAULT_OPUS_MODEL без ANTHROPIC_DEFAULT_SONNET_MODEL также считается выбором, потому что встроенная модель Sonnet может быть не включена в проекте, который управляет своим собственным Opus.
• Чтобы использовать Haiku для фоновых задач, установите ANTHROPIC_DEFAULT_HAIKU_MODEL на ID модели, который доступен в вашем проекте.

export ANTHROPIC_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

​

Проверки моделей при запуске

​

Конфигурация IAM

• aiplatform.endpoints.predict - требуется для вызова модели и подсчета токенов

​

Контекстное окно с 1M токенов

​

Устранение неполадок

• Запустите gcloud auth application-default login для установки Application Default Credentials
• Установите GOOGLE_APPLICATION_CREDENTIALS на путь файла ключа сервисного аккаунта
• См. Configure GCP credentials для всех вариантов

• Проверьте текущие квоты или запросите увеличение квоты через Cloud Console

• Подтвердите, что модель включена в Model Garden
• Проверьте, что модель доступна в указанном вами местоположении. Некоторые модели предлагаются только на global или многорегиональных местоположениях, таких как eu и us, а не в конкретных регионах
• Если вы используете CLOUD_ML_REGION=global, проверьте, что ваши модели поддерживают глобальные конечные точки в Model Garden в разделе “Supported features”. Для моделей, которые не поддерживают глобальные конечные точки, либо:
  • Укажите поддерживаемую модель через ANTHROPIC_MODEL или ANTHROPIC_DEFAULT_HAIKU_MODEL, либо
  • Установите регион или многорегиональное местоположение, используя переменные окружения VERTEX_REGION_<MODEL_NAME>

• Для региональных конечных точек убедитесь, что основная модель и малая/быстрая модель поддерживаются в выбранном регионе
• Рассмотрите возможность переключения на CLOUD_ML_REGION=global для лучшей доступности

​

Дополнительные ресурсы

• Документация Google Cloud’s Agent Platform
• Цены Google Cloud’s Agent Platform
• Квоты и лимиты Google Cloud’s Agent Platform