Claude в Amazon Bedrock (Opus 4.7 и более поздние версии)

Это руководство поможет вам настроить Claude в Amazon Bedrock и выполнять к нему вызовы API. Claude в Amazon Bedrock работает на инфраструктуре под управлением AWS с нулевым доступом операторов (сотрудники Anthropic не имеют доступа к инфраструктуре инференса). Это позволяет создавать приложения, работающие с конфиденциальными данными, полностью в пределах границы безопасности AWS, используя ту же структуру Messages API, что и в собственном API Anthropic.

Доступ

Amazon Bedrock устанавливает критерии доступа для каждой модели Claude отдельно. Claude Fable 5.1, Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5, Claude Opus 4.7 и Claude Haiku 4.5 открыты для всех клиентов Amazon Bedrock. Актуальные критерии для любой другой модели см. в разделе Amazon Bedrock model access консоли AWS. Для Claude Mythos Preview требуется приглашение через Project Glasswing. О доступности по регионам см. раздел Регионы.

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

Прежде чем начать, убедитесь, что у вас есть:

• Учетная запись AWS с включенным доступом к моделям Amazon Bedrock для моделей Claude, которые вы планируете использовать.
• Установленный и настроенный AWS CLI (необязательно, для управления учетными данными).

Для Claude Mythos Preview дополнительно требуется выделенная учетная запись AWS, добавленная в список разрешенных командой Bedrock Marketplace. Ваш менеджер по работе с клиентами в Anthropic может отправить идентификатор вашей учетной записи для добавления в список разрешенных (обычно обрабатывается в течение 24 часов), и после завершения AWS отправит приветственное письмо.

Аутентификация

Claude в Amazon Bedrock поддерживает три способа аутентификации. Выберите тот, который лучше всего соответствует вашим требованиям безопасности.

Сервисная роль Bedrock (рекомендуется)

Используйте сервисную роль Bedrock с ключами под управлением AWS для наиболее безопасного долгосрочного доступа:

1. 1

   Администратор: подготовьте сервисную роль

   Администратор AWS создает сервисную роль Bedrock и предоставляет разработчикам разрешение iam:PassRole на ARN этой сервисной роли.

2. 2

   Разработчик: передайте роль

   При вызове API Bedrock принимает сервисную роль от вашего имени. О том, как связать роль с вашими запросами, см. документацию Amazon Bedrock.

Принимаемые роли IAM

Для доступа с федерацией удостоверений и максимальной продолжительностью сеанса 12 часов:

1. 1

   Администратор: настройте роль IAM

   Создайте роль IAM, ограниченную вашими моделями Claude. В политике доверия указывается ваш поставщик удостоверений (SAML, OIDC или AWS Identity Center). Политика разрешений предоставляет bedrock-mantle:CreateInference только для разрешенных ARN моделей.

2. 2

   Разработчик: пройдите аутентификацию и примите роль

   Пройдите аутентификацию через корпоративного поставщика удостоверений, затем примите роль IAM. AWS STS выдает временные учетные данные, которые SDK или CLI использует для подписи запросов.

Токены носителя

Для краткосрочного доступа без ролей IAM (максимум 12 часов, наименее предпочтительный вариант) используются «bearer tokens» (токены носителя):

1. 1

   Администратор: ограничьте типы токенов

   Заблокируйте долгосрочные ключи, прикрепив политику, которая запрещает bedrock:CallWithBearerToken, если условие bedrock:BearerTokenType не соответствует краткосрочному токену.

2. 2

   Разработчик: создайте токен

   Используйте CLI aws-bedrock-token-generator для создания токена носителя. Передавайте его в заголовке x-api-key в каждом запросе.

Установка SDK

Клиентские SDK Anthropic поддерживают Claude в Amazon Bedrock через специальный пакет или модуль для Bedrock.

pip install -U "anthropic[bedrock]"

Выполнение первого запроса

Конечная точка имеет вид https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. В отличие от интеграции на основе InvokeModel, эта конечная точка использует стандартную «streaming» (потоковую передачу) через SSE и ту же структуру тела запроса, что и собственный API Anthropic.

SDK определяет учётные данные и регион в стандартном для AWS порядке приоритета: сначала аргументы конструктора, затем переменные окружения (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), затем файл конфигурации AWS и цепочка учётных данных (SSO, принимаемые роли, роль задачи ECS, IMDS).

from anthropic import AnthropicBedrockMantle

client = AnthropicBedrockMantle(aws_region="us-east-1")

message = client.messages.create(
    model="anthropic.claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(next(block.text for block in message.content if block.type == "text"))

Поддерживаемые модели

Идентификаторы моделей в Claude в Amazon Bedrock имеют префикс поставщика anthropic.. Возможности и поведение моделей описаны на странице Обзор моделей.

Используйте последнюю версию Claude Code с Claude в Amazon Bedrock; для обновления выполните claude update.

Поддержка функций

Полный список функций с указанием доступности в Amazon Bedrock см. в разделе Обзор функций.

Основные поддерживаемые функции

• Messages API (/anthropic/v1/messages)
• Кэширование подсказок
• Размышления
• Использование инструментов, включая инструмент Bash, инструмент использования компьютера, инструмент памяти и инструмент текстового редактора
• Цитирование

Неподдерживаемые функции

• Структурированные выходные данные
• Источники входных данных (URL-источники для изображений и документов, Files API)
• Серверные инструменты (выполнение кода, веб-поиск, веб-загрузка, advisor)
• Инфраструктура агентов (Agent Skills, коннектор MCP, программный вызов инструментов)
• Конечные точки API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Резервный вариант на стороне сервера (параметр fallbacks; вместо него используйте шаблон резервного варианта на стороне клиента)
• Наборы инструментов использования компьютера и использования браузера (computer_toolset_20260801 и browser_toolset_20260801 в настоящее время недоступны в Amazon Bedrock; бета-версии инструмента использования компьютера остаются доступными)

Регионы

Claude в Amazon Bedrock доступен в следующих регионах AWS. Amazon Bedrock предлагает два типа конечных точек:

• Глобальная: динамическая маршрутизация по всем доступным регионам для максимальной доступности. Без надбавки к цене.
• Региональная: конечная точка разрешается в указанный вами единственный регион AWS — для соблюдения требований к месту хранения данных. Региональные конечные точки имеют надбавку к цене в 10% по сравнению с глобальными. Для маршрутизации между несколькими регионами в пределах одной географической зоны используйте профиль инференса (US, EU, JP или AU). Регионы, отмеченные в таблице как Только внутри региона, поддерживают прямую маршрутизацию в один регион без профиля инференса.

Глобальная конечная точка доступна для Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5.5, Claude Sonnet 5, Claude Haiku 5.5 и Claude Haiku 4.5. Для Claude Fable 5.1 региональные конечные точки в настоящее время доступны только в us-east-1. Claude Mythos Preview доступен только через региональную конечную точку в us-east-1.

Квоты

Квота по умолчанию составляет 2 миллиона входных токенов в минуту (TPM). Вы можете запросить до 5 миллионов входных TPM и 500 000 выходных TPM без дополнительного одобрения Anthropic. AWS применяет ограничения на количество запросов в минуту (RPM) на стороне Bedrock; для изменения RPM обратитесь в службу поддержки AWS.

Хранение данных

Обработка данных для этого предложения регулируется Amazon Bedrock. Подробнее см. Data protection in Amazon Bedrock.

Мониторинг и журналирование

Claude в Amazon Bedrock отправляет журналы как в CloudWatch, так и в CloudTrail. Anthropic рекомендует хранить журналы активности как минимум за скользящий 30-дневный период, чтобы понимать закономерности использования и расследовать возможные проблемы.

Поддержка

Для получения поддержки обращайтесь по адресу bedrock-ant-eap@amazon.com. Укажите идентификатор вашей учетной записи AWS и request-id из всех неудачных ответов API.