Claude Code на Amazon Bedrock

​

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

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

​

Вход через Bedrock

​

Ручная настройка

​

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

1. Убедитесь, что у вас есть необходимые разрешения IAM, описанные ниже
2. Перейдите на консоль Amazon Bedrock
3. Выберите модель Anthropic из каталога моделей
4. Заполните форму варианта использования. Доступ предоставляется сразу после отправки.

​

2. Настройте учётные данные AWS

aws configure

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

aws sso login --profile=your-profile-name

export AWS_PROFILE=your-profile-name

aws login

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

​

Кэширование учётных данных и время ожидания разрешения

​

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

• awsAuthRefresh: запускается только когда Claude Code обнаруживает, что ваши учётные данные AWS истекли, либо локально на основе их временной метки, либо когда API возвращает ошибку учётных данных, затем повторяет запрос с обновлёнными учётными данными.
• awsCredentialExport: запускается при запуске сеанса и при каждой перезагрузке учётных данных, даже когда учётные данные в цепочке поставщика учётных данных AWS по умолчанию всё ещё действительны. Используйте это, когда ваш аккаунт Amazon Bedrock требует учётные данные между аккаунтами, которые отличаются от тех, которые разрешила бы цепочка поставщика по умолчанию.

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

{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value",
    "Expiration": "2026-01-01T00:00:00Z"
  }
}

​

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

# Включить интеграцию Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # необязательно, если ваш профиль AWS уже устанавливает регион

# Необязательно: переопределить регион AWS для модели small/fast (Bedrock и Mantle).
# На Bedrock не имеет эффекта без ANTHROPIC_DEFAULT_HAIKU_MODEL
# или устаревшего ANTHROPIC_SMALL_FAST_MODEL.
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

# Необязательно: переопределить URL конечной точки Bedrock для пользовательских конечных точек или шлюзов
# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

• Вам нужно установить AWS_REGION только для переопределения региона вашего профиля AWS или когда ваш профиль не имеет региона. Claude Code разрешает регион в этом порядке:
  • AWS_REGION
  • AWS_DEFAULT_REGION
  • region, установленный на вашем активном профиле AWS, прочитанный сначала из файла общих учётных данных AWS, а затем из файла общей конфигурации, соответствуя приоритету AWS SDK
  • us-east-1
  Если значение из любого из этих источников не похоже на имя региона, Claude Code рассматривает его как неустановленное и продолжает вниз по порядку. Например, Claude Code рассматривает значение, содержащее косую черту, точку или пробел, как неустановленное. Активный профиль — это AWS_PROFILE, если установлен, иначе default. Установите AWS_SHARED_CREDENTIALS_FILE или AWS_CONFIG_FILE, чтобы указать на пути к файлам, отличные от стандартных. Запустите /status, чтобы увидеть разрешённый регион. Когда регион поступил из ваших файлов конфигурации AWS или стандартного резервного варианта, Claude Code также отмечает источник в выводе /status.
• При использовании Amazon Bedrock команда /logout недоступна, так как аутентификация обрабатывается через учётные данные AWS.
• Инструмент WebSearch недоступен на Amazon Bedrock. См. поведение инструмента WebSearch.
• Вы можете использовать файлы параметров для переменных окружения, таких как AWS_PROFILE, которые вы не хотите утечь в другие процессы. См. Параметры для получения дополнительной информации.

​

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

export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'
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'

• Когда вы выбираете основную модель с --model, ANTHROPIC_MODEL или параметром model, фоновые задачи используют эту модель. Когда Claude Code запускает сеанс на модели, которую вы установили с помощью ANTHROPIC_DEFAULT_MODEL, фоновые задачи также используют эту модель. Установка ANTHROPIC_DEFAULT_OPUS_MODEL без ANTHROPIC_DEFAULT_SONNET_MODEL также считается выбором, потому что встроенная модель Sonnet может быть не включена в аккаунте, который управляет своим собственным Opus.
• Чтобы использовать Haiku для фоновых задач, установите ANTHROPIC_DEFAULT_HAIKU_MODEL на ID модели, который доступен в вашем аккаунте.

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

# Необязательно: отключить prompt caching, если необходимо
# export DISABLE_PROMPT_CACHING=1

# Необязательно: запросить TTL кэша prompt на 1 час вместо стандартного 5 минут
# export ENABLE_PROMPT_CACHING_1H=1

​

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

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-47-prod",
    "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"
  }
}

​

Проверки модели при запуске

​

Префиксы профилей кросс-региональной инференции

export ANTHROPIC_BEDROCK_REGION_PREFIX=global
# В регионе us-*, основная модель теперь разрешается на
# global.anthropic.claude-opus-5-5 вместо us.anthropic.claude-opus-5-5

• Когда Claude Code может перечислить профили инференции в вашей учётной записи, он разрешает каждую модель в этом порядке:
  1. Профиль с вашим предпочитаемым префиксом.
  2. Любой соответствующий профиль для модели, у которой нет профиля с этим префиксом.
  3. Встроенный ID модели с вашим предпочитаемым префиксом для модели, у которой вообще нет соответствующего профиля. Claude Code применяет этот ID без проверки доступности на этом этапе; проверки модели при запуске по-прежнему охватывают модели по умолчанию сеанса.
• Когда обнаружение профиля недоступно, Claude Code применяет префикс без проверки доступности. Если в вашей учётной записи не включены профили инференции с этим префиксом, запросы завершаются с ошибкой 400.

• В регионах AWS GovCloud Claude Code всегда использует us-gov., единственный префикс, который маршрутизирует в разделе GovCloud.
• Когда вы устанавливаете значение, которое не является одним из допустимых значений, Claude Code переходит на предпочитаемый префикс, полученный из региона.

​

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles",
        "bedrock:GetInferenceProfile"
      ],
      "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"
        }
      }
    }
  ]
}

​

Окно контекста 1M токенов

​

Уровни обслуживания

export ANTHROPIC_BEDROCK_SERVICE_TIER=priority

​

AWS Guardrails

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Amzn-Bedrock-GuardrailIdentifier: your-guardrail-id\nX-Amzn-Bedrock-GuardrailVersion: 1"
  }
}

​

Используйте конечную точку Mantle

​

Включите Mantle

export CLAUDE_CODE_USE_MANTLE=1
export AWS_REGION=us-east-1

​

Выберите модель Mantle

claude --model anthropic.claude-haiku-4-5

​

Запустите Mantle рядом с Invoke API

export CLAUDE_CODE_USE_BEDROCK=1
export CLAUDE_CODE_USE_MANTLE=1

{
  "availableModels": ["opus", "sonnet", "claude-haiku-4-5", "anthropic.claude-haiku-4-5"]
}

​

Маршрутизируйте Mantle через шлюз

export CLAUDE_CODE_USE_MANTLE=1
export CLAUDE_CODE_SKIP_MANTLE_AUTH=1
export ANTHROPIC_BEDROCK_MANTLE_BASE_URL=https://your-gateway.example.com

​

Переменные окружения Mantle

​

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

​

Цикл аутентификации с SSO и корпоративными прокси

​

Ошибки сертификата за прокси-сервером с проверкой TLS

• Обнаружение модели
• Подсчет токенов
• Вызовы STS и SSO для получения учетных данных роли, которые разрешают ваши учетные данные AWS
• Проверку учетных данных и проверку моделей мастера установки

​

Проблемы с регионом

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

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

​

Ошибки потоковой передачи за шлюзом или прокси

​

Нулевые подсчеты токенов в /context

​

Ошибки конечной точки Mantle

• Если ошибка называет действие bedrock-mantle:, предоставьте вашему удостоверению IAM это действие.
• Если ошибка не называет никакого действия и ваши учетные данные действительны, вашей учетной записи AWS не был предоставлен доступ к запрошенной модели. Свяжитесь с вашей командой учетной записи AWS, чтобы запросить доступ.

​

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

• Документация Amazon Bedrock
• Цены Amazon Bedrock
• Профили вывода Amazon Bedrock
• Burndown токенов Amazon Bedrock и квоты
• Claude Code на Amazon Bedrock: Quick Setup Guide
• Claude Code Monitoring Implementation (Amazon Bedrock)