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 из Model catalog
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

# Enable Bedrock integration
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # optional if your AWS profile already sets a region

# Optional: Override the AWS region for the small/fast model (Bedrock and Mantle).
# On Bedrock, has no effect without ANTHROPIC_DEFAULT_HAIKU_MODEL
# or the deprecated ANTHROPIC_SMALL_FAST_MODEL set.
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

# Optional: Override the Bedrock endpoint URL for custom endpoints or gateways
# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

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

​

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, фоновые задачи используют эту модель. Установка ANTHROPIC_DEFAULT_OPUS_MODEL без ANTHROPIC_DEFAULT_SONNET_MODEL также считается выбором, потому что встроенная модель Sonnet может быть не включена в учетной записи, которая управляет своим собственным Opus.
• Чтобы использовать Haiku для фоновых задач, установите ANTHROPIC_DEFAULT_HAIKU_MODEL на ID модели, который доступен в вашей учетной записи.

# Using inference profile ID
export ANTHROPIC_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_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

# Optional: Request 1-hour prompt cache TTL instead of the 5-minute default
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"
  }
}

​

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

​

Конфигурация 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 и корпоративными прокси

​

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

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

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

​

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

​

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

​

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

​

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

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