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

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

Перед настройкой 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 
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: 
# Enable Bedrock integration
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # or your preferred region

# Optional: Override the region for the small/fast model (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).
Чтобы настроить модели, используйте один из этих методов: 
# Using inference profile 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'

# Using application inference profile ARN
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

# Optional: Disable prompt caching if needed
export DISABLE_PROMPT_CACHING=1
Prompt caching может быть недоступен во всех регионах.

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

Это рекомендуемые параметры токенов для Claude Code с Amazon Bedrock: 
# Recommended output token settings for 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 Guardrails

Amazon Bedrock Guardrails позволяют вам реализовать фильтрацию контента для Claude Code. Создайте Guardrail в консоли Amazon Bedrock, опубликуйте версию, затем добавьте заголовки Guardrail в ваш файл параметров. Включите Cross-Region inference на вашем Guardrail, если вы используете профили вывода между регионами. Пример конфигурации: 
{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Amzn-Bedrock-GuardrailIdentifier: your-guardrail-id\nX-Amzn-Bedrock-GuardrailVersion: 1"
  }
}

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

Если вы столкнулись с проблемами региона:
  • Проверьте доступность модели: 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.

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