Claude Code на Amazon Bedrock

​

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

Перед настройкой 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 по умолчанию. Настройте свои учетные данные одним из следующих способов:

Вариант 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

Вариант D: API ключи Bedrock

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

API ключи Bedrock предоставляют более простой метод аутентификации без необходимости полных учетных данных AWS. Узнайте больше об API ключах Bedrock.

​

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

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

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

# Необязательно: Переопределить регион для малой/быстрой модели (Haiku)
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

​

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

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

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

# Использование 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'

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

​

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

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*"
      ]
    }
  ]
}

Для более ограничительных разрешений вы можете ограничить Resource конкретными ARN профилей вывода.

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

​

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

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

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

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

• Укажите модель как ID профиля вывода

​

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

• Документация Bedrock
• Цены на Bedrock
• Профили вывода Bedrock
• Claude Code на Amazon Bedrock: Руководство по быстрой настройке