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.

​

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

Claude Code поддерживает автоматическое обновление учетных данных для AWS SSO и корпоративных поставщиков удостоверений. Добавьте эти настройки в файл настроек Claude Code (см. Настройки для расположения файлов).

Когда Claude Code обнаруживает, что ваши учетные данные AWS истекли (либо локально на основе их временной метки, либо когда Bedrock возвращает ошибку учетных данных), он автоматически запустит ваши настроенные команды awsAuthRefresh и/или awsCredentialExport для получения новых учетных данных перед повторной попыткой запроса.

Пример конфигурации

{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}

Объяснение настроек конфигурации

awsAuthRefresh: Используйте это для команд, которые изменяют директорию .aws (например, обновление учетных данных, кэша SSO или файлов конфигурации). Вывод показывается пользователю (но пользовательский ввод не поддерживается), что делает его подходящим для потоков аутентификации на основе браузера, где CLI отображает код для ввода в браузере.

awsCredentialExport: Используйте это только если вы не можете изменить .aws и должны напрямую возвращать учетные данные. Вывод захватывается молча (не показывается пользователю). Команда должна выводить JSON в этом формате:

{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value"
  }
}

​

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

При включении Bedrock для Claude Code имейте в виду следующее:

• AWS_REGION является обязательной переменной окружения. Claude Code не читает из файла конфигурации .aws для этой настройки.
• При использовании Bedrock команды /login и /logout отключены, поскольку аутентификация обрабатывается через учетные данные AWS.
• Вы можете использовать файлы настроек для переменных окружения, таких как AWS_PROFILE, которые вы не хотите передавать другим процессам. См. Настройки для получения дополнительной информации.

​

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

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

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

# Использование ID профиля вывода
export ANTHROPIC_MODEL='us.anthropic.claude-opus-4-1-20250805-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

​

5. Конфигурация выходных токенов

При использовании Claude Code с Amazon Bedrock мы рекомендуем следующие настройки токенов:

# Рекомендуемые настройки выходных токенов для Bedrock
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096
export MAX_THINKING_TOKENS=1024

Почему эти значения:

• CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096: Логика дросселирования Bedrock устанавливает минимум 4096 токенов как штраф max_token. Установка меньшего значения не снизит затраты, но может обрезать длинные использования инструментов, вызывая постоянные сбои цикла агента Claude Code. Claude Code обычно использует менее 4096 выходных токенов без расширенного мышления, но может нуждаться в этом запасе для задач, включающих значительное создание файлов или использование инструмента Write.

• MAX_THINKING_TOKENS=1024: Это обеспечивает пространство для расширенного мышления без обрезания ответов использования инструментов, при этом поддерживая сфокусированные цепочки рассуждений. Этот баланс помогает предотвратить изменения траектории, которые не всегда полезны специально для задач кодирования.

​

Конфигурация 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 профиля вывода

Claude Code использует Invoke API Bedrock и не поддерживает Converse API.

​

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

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