Перейти к основному содержанию

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

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

​
Установка

​
1. Отправьте детали варианта использования

Пользователи моделей Anthropic в первый раз должны отправить детали варианта использования перед вызовом модели. Это делается один раз на учетную запись.
  1. Убедитесь, что у вас есть правильные разрешения IAM (см. подробнее ниже)
  2. Перейдите на консоль Amazon Bedrock
  3. Выберите Chat/Text playground
  4. Выберите любую модель Anthropic и вам будет предложено заполнить форму варианта использования

​
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: учетные данные AWS Management Console 
aws login
Узнайте больше о aws login. Вариант E: ключи 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 или файлов конфигурации. Вывод команды отображается пользователю, но интерактивный ввод не поддерживается. Это хорошо работает для потоков SSO на основе браузера, где CLI отображает URL или код, и вы завершаете аутентификацию в браузере. 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:
Тип моделиЗначение по умолчанию
Основная модельglobal.anthropic.claude-sonnet-4-5-20250929-v1:0
Малая/быстрая модельus.anthropic.claude-haiku-4-5-20251001-v1:0
Для пользователей Bedrock Claude Code не будет автоматически обновляться с Haiku 3.5 на Haiku 4.5. Чтобы вручную переключиться на более новую модель Haiku, установите переменную окружения ANTHROPIC_DEFAULT_HAIKU_MODEL на полное имя модели (например, us.anthropic.claude-haiku-4-5-20251001-v1:0).
Чтобы настроить модели, используйте один из этих методов: 
# Использование ID профиля вывода
export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-5-20250929-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-haiku-4-5-20251001-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": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*",
        "arn:aws:bedrock:*:*:foundation-model/*"
      ]
    },
    {
      "Sid": "AllowMarketplaceSubscription",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:CalledViaLast": "bedrock.amazonaws.com"
        }
      }
    }
  ]
}
Для более ограничительных разрешений вы можете ограничить Resource конкретными ARN профилей вывода. Для получения подробной информации см. документацию 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”: Claude Code использует Bedrock Invoke API и не поддерживает Converse API.

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