Claude Code с моделями Claude в Google Cloud (под управлением Anthropic)

Модели Claude в Google Cloud (под управлением Anthropic) — это Claude API, который работает под управлением Anthropic и доступен через ваш проект Google Cloud. Чтобы использовать его из Claude Code, войдите в Google Cloud и задайте три переменные окружения.

Google Cloud также предлагает Claude через Agent Platform от Google Cloud (ранее Vertex AI), которой управляет Google. Если вы используете Agent Platform, следуйте вместо этого инструкциям из раздела Claude Code на Agent Platform от Google Cloud. Чтобы узнать, какое из предложений вы используете, см. Which offering are you using?

Прежде чем начать, установите Claude Code версии 2.1.307 или новее. Чтобы проверить версию, выполните claude --version в оболочке. Чтобы обновить, выполните claude update.

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

Проект Google Cloud, в котором завершена настройка аккаунта
Роль IAM roles/claude.user в этом проекте для каждого аккаунта Google или сервисного аккаунта, от имени которого запускается Claude Code
ID вашего проекта и ваш ID рабочего пространства, который начинается с wrkspc_
gcloud CLI, если вы входите с аккаунтом Google, а не с файлом ключа сервисного аккаунта

Настройка Claude Code

Создайте Application Default Credentials

Аккаунт Google
Файл ключа сервисного аккаунта

Выполните эту команду в оболочке и войдите с аккаунтом Google, у которого есть роль roles/claude.user:

gcloud auth application-default login

Выполните её, даже если вы уже выполняли gcloud auth login.Если задана переменная GOOGLE_APPLICATION_CREDENTIALS, удалите её. Пока эта переменная задана, Claude Code использует указанный в ней файл и игнорирует учётные данные, сохранённые командой.

В оболочке или CI-задании, в котором запускается Claude Code, задайте GOOGLE_APPLICATION_CREDENTIALS равной пути к файлу ключа сервисного аккаунта. О других источниках учётных данных см. how to authenticate.

Добавьте переменные в настройки

Добавьте три переменные в блок env вашего файла пользовательских настроек ~/.claude/settings.json. Если файла не существует, создайте его со следующим содержимым:

{
  "env": {
    "CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD": "1",
    "ANTHROPIC_GOOGLE_CLOUD_PROJECT": "my-project-id",
    "ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID": "wrkspc_01ABCDEFGHIJKLMN"
  }
}

Укажите ID своего проекта и ID рабочего пространства вместо my-project-id и значения wrkspc_. Чтобы вместо этого настроить отдельную оболочку или CI-задание, задайте те же три переменные в этом окружении.Входить в аккаунт Anthropic или выходить из него не нужно.

Запустите Claude Code и проверьте провайдера

Выполните claude в оболочке, затем выполните /status в промпте Claude Code. Строка API provider содержит on Google Cloud, а следующие за ней строки показывают ваши Workspace ID, GCP project и GCP location. Чтобы вывести те же строки из оболочки или CI-задания, выполните claude auth status --text.Если вы видите on Google Cloud, отправьте промпт или выполните claude -p "hello" в CI-задании. Ответ подтверждает, что ваши учётные данные и роль IAM работают. Если вы этого не видите или Claude Code показывает ошибку, устраните неполадки настройки провайдера.

Настройка Claude Code для команды

Поместите блок env из шага 2 раздела Настройка Claude Code в файл управляемых настроек на компьютере каждого разработчика. Выдайте каждому разработчику роль roles/claude.user в проекте и попросите каждого выполнить gcloud auth application-default login на своём компьютере.

Закрепление версий моделей

Если вы выполняете развёртывание для команды, закрепите ID моделей, чтобы обновление Claude Code не переводило всех сразу на более новую модель. Добавьте эти переменные в блок env, содержащий три переменные из раздела Настройка Claude Code:

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

Вместо примеров значений укажите нужные вам ID моделей Claude API из Models overview.

Переменные окружения

Переменная	Обязательна	Описание
`CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD`	Да	Задайте `1`, чтобы отправлять запросы к моделям в Модели Claude в Google Cloud (под управлением Anthropic)
`ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID`	Да, если только вы не задали `ANTHROPIC_GOOGLE_CLOUD_BASE_URL`	Ваш ID рабочего пространства
`ANTHROPIC_GOOGLE_CLOUD_PROJECT`	Рекомендуется	ID вашего проекта Google Cloud. Без неё Claude Code использует `GOOGLE_CLOUD_PROJECT`
`ANTHROPIC_GOOGLE_CLOUD_LOCATION`	Нет	Location в URL запроса. По умолчанию `global`
`ANTHROPIC_GOOGLE_CLOUD_BASE_URL`	Нет	Заменяет базовый URL, который Claude Code формирует из проекта, location и ID рабочего пространства, например адресом LLM-шлюза. Claude Code добавляет путь API, например `/v1/messages`
`CLAUDE_CODE_SKIP_ANTHROPIC_GOOGLE_CLOUD_AUTH`	Нет	Задайте `1`, если шлюз сам добавляет учётные данные Google, чтобы Claude Code не отправлял токен доступа Google

Недоступные функции Claude Code

При использовании Claude Models on Google Cloud (Anthropic managed) недоступны следующие функции:

Быстрый режим: его нельзя включить с помощью /fast или настройки fastMode
Remote Control и облачные сессии
MCP-коннекторы из claude.ai
Каналы
Команды /design-sync и /import
Настройки, управляемые сервером. Чтобы применять настройки для вашей команды, используйте вместо этого управляемые настройки на каждом компьютере

Чтобы увидеть другие функции, которые недоступны или поддерживаются частично, выберите вкладку Google Cloud (Anthropic managed) в сводке доступности функций.

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

Если Claude Code просит вас войти или строка API provider в /status не содержит on Google Cloud:

Убедитесь, что CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD имеет значение 1
Убедитесь, что claude --version выводит 2.1.307 или новее
Удалите CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_FOUNDRY и CLAUDE_CODE_USE_ANTHROPIC_AWS из оболочки и ваших файлов настроек

CLAUDE_CODE_USE_VERTEX можно оставить заданной. После изменения переменной перезапустите Claude Code. Если /status не отражает изменение, см. Заданное значение игнорируется.

`No workspace ID found`

Задайте ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID равной вашему ID рабочего пространства, затем перезапустите Claude Code. Игнорируйте упомянутый в сообщении параметр конструктора workspaceId: он предназначен для тех, кто вызывает SDK Anthropic из собственного кода.

`No project was given`

Задайте ANTHROPIC_GOOGLE_CLOUD_PROJECT равной ID вашего проекта Google Cloud, затем перезапустите Claude Code.

`Could not load Google Cloud credentials`

Повторите шаг 1 раздела Настройка Claude Code, используя новый ключ, если вы используете файл ключа сервисного аккаунта.

`Google Cloud credentials expired or invalid`

Если сообщение предлагает обновить учётные данные Google Cloud, повторите шаг 1 раздела Настройка Claude Code. При использовании файла ключа сервисного аккаунта используйте новый ключ.

`Google Cloud authentication failed`

Выполните шаги для Google Cloud credentials expired or invalid. Если это не устранит ошибку:

Проект: в /status убедитесь, что в строке GCP project указан ваш проект. Если указан другой проект или такой строки нет, следуйте инструкциям для No project was given
Рабочее пространство: в /status убедитесь, что строка Workspace ID показывает ваш ID рабочего пространства. Если показан другой, следуйте инструкциям для No workspace ID found
Роль IAM: убедитесь, что у аккаунта Google или сервисного аккаунта, от имени которого запускается Claude Code, есть роль roles/claude.user или roles/claude.admin в проекте из строки GCP project. Чтобы выдать роль, используйте команду выдачи роли для сервиса или попросите администратора проекта выдать её
Сервис: убедитесь, что сервис claude.googleapis.com включён в проекте из строки GCP project. Чтобы включить его, выполните шаги настройки аккаунта для сервиса или попросите администратора проекта включить его

Модели Claude в Google Cloud (под управлением Anthropic): настройка аккаунта, роли IAM, биллинг, хранение данных и поддержка функций
Обзор корпоративного развёртывания: другие способы развёртывания Claude Code, а также настройка прокси и шлюза
Конфигурация моделей: псевдонимы моделей, закрепление версии модели и ограничение набора моделей, которые могут выбирать пользователи

Настройка и доступ

Развёртывание

Шлюзы

Использование и расходы

Безопасность и данные

Внедрение

Claude Code с моделями Claude в Google Cloud (под управлением Anthropic)

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

Настройка Claude Code

Настройка Claude Code для команды

Закрепление версий моделей

Переменные окружения

Недоступные функции Claude Code

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

`No workspace ID found`

`No project was given`

`Could not load Google Cloud credentials`

`Google Cloud credentials expired or invalid`

`Google Cloud authentication failed`

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

Настройка Claude Code

Настройка Claude Code для команды

Закрепление версий моделей

Переменные окружения

Недоступные функции Claude Code

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

No workspace ID found

No project was given

Could not load Google Cloud credentials

Google Cloud credentials expired or invalid

Google Cloud authentication failed

Связанные ресурсы

`No workspace ID found`

`No project was given`

`Could not load Google Cloud credentials`

`Google Cloud credentials expired or invalid`

`Google Cloud authentication failed`