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

Перед настройкой Claude Code с Bedrock убедитесь, что у вас есть:

  • Аккаунт AWS с включенным доступом к Bedrock
  • Доступ к желаемым моделям Claude (например, Claude Sonnet 4) в Bedrock
  • Установленный и настроенный AWS CLI (необязательно - нужен только если у вас нет другого механизма получения учетных данных)
  • Соответствующие разрешения IAM

​
Настройка

​
1. Включение доступа к модели

Сначала убедитесь, что у вас есть доступ к необходимым моделям Claude в вашем аккаунте AWS:

  1. Перейдите в консоль Amazon Bedrock
  2. Перейдите в Model access в левой навигации
  3. Запросите доступ к желаемым моделям Claude (например, Claude Sonnet 4)
  4. Дождитесь одобрения (обычно мгновенно для большинства регионов)

​
2. Настройка учетных данных AWS

Claude Code использует цепочку учетных данных AWS SDK по умолчанию. Настройте свои учетные данные одним из следующих способов:

Claude Code в настоящее время не поддерживает динамическое управление учетными данными (например, автоматический вызов aws sts assume-role). Вам нужно будет запустить aws configure, aws sso login или установить переменные окружения AWS_ самостоятельно.

Вариант A: Конфигурация AWS CLI

aws configure

Вариант B: Переменные окружения (ключ доступа)

export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token

Вариант C: Переменные окружения (профиль SSO)

aws sso login --profile=<your-profile-name>

export AWS_PROFILE=your-profile-name

​
3. Настройка Claude Code

Установите следующие переменные окружения для включения Bedrock:

# Включить интеграцию с Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # или ваш предпочитаемый регион

AWS_REGION является обязательной переменной окружения. Claude Code не читает из конфигурационного файла .aws для этой настройки.

​
4. Конфигурация модели

Claude Code использует эти модели по умолчанию для Bedrock:

Тип моделиЗначение по умолчанию
Основная модельus.anthropic.claude-3-7-sonnet-20250219-v1:0
Малая/быстрая модельus.anthropic.claude-3-5-haiku-20241022-v1:0

Для настройки моделей используйте один из следующих методов:

# Использование ID профиля вывода
export ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Использование ARN профиля вывода приложения
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

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

Создайте политику IAM с необходимыми разрешениями для Claude Code.

Подробности см. в документации Bedrock IAM.

Мы рекомендуем создать выделенный аккаунт AWS для Claude Code, чтобы упростить отслеживание затрат и контроль доступа.

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

Если у вас возникли проблемы с регионом:

  • Проверьте доступность модели: aws bedrock list-inference-profiles --region your-region
  • Переключитесь на поддерживаемый регион: export AWS_REGION=us-east-1
  • Рассмотрите использование профилей вывода для межрегионального доступа

Если вы получаете ошибку “on-demand throughput isn’t supported”:

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