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

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

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

​
Установка

​
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 (см. Settings для расположения файлов). Когда 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, которые вы не хотите утечь в другие процессы. См. Settings для получения дополнительной информации.

​
4. Закрепите версии моделей

Закрепите конкретные версии моделей для каждого развертывания. Если вы используете псевдонимы моделей (sonnet, opus, haiku) без закрепления, Claude Code может попытаться использовать более новую версию модели, которая недоступна в вашей учетной записи Bedrock, нарушив работу существующих пользователей при выпуске обновлений Anthropic.
Установите эти переменные окружения на конкретные ID моделей Bedrock: 
export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-6-v1'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'
Эти переменные используют ID профилей вывода между регионами (с префиксом us.). Если вы используете другой префикс региона или профили вывода приложения, отрегулируйте соответственно. Для текущих и устаревших ID моделей см. Models overview. См. Model configuration для полного списка переменных окружения. Claude Code использует эти модели по умолчанию, когда переменные закрепления не установлены:
Тип моделиЗначение по умолчанию
Основная модельglobal.anthropic.claude-sonnet-4-6
Малая/быстрая модельus.anthropic.claude-haiku-4-5-20251001-v1:0
Для дальнейшей настройки моделей используйте один из этих методов: 
# Using inference profile ID
export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-6'
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 может быть недоступен во всех регионах.

​
Сопоставьте каждую версию модели с профилем вывода

Переменные окружения ANTHROPIC_DEFAULT_*_MODEL настраивают один профиль вывода на семейство моделей. Если вашей организации необходимо предоставить несколько версий одного семейства в средстве выбора /model, каждая маршрутизируется на свой ARN профиля вывода приложения, используйте вместо этого параметр modelOverrides в вашем файле параметров. Этот пример сопоставляет три версии Opus с отдельными ARN, чтобы пользователи могли переключаться между ними без обхода профилей вывода вашей организации: 
{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-opus-4-5-20251101": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-45-prod",
    "claude-opus-4-1-20250805": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-41-prod"
  }
}
Когда пользователь выбирает одну из этих версий в /model, Claude Code вызывает Bedrock с сопоставленным ARN. Версии без переопределения возвращаются к встроенному ID модели Bedrock или любому соответствующему профилю вывода, обнаруженному при запуске. См. Override model IDs per version для получения подробной информации о том, как переопределения взаимодействуют с availableModels и другими параметрами модели.

​
Конфигурация 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.

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