--- title: Claude в Amazon Bedrock (Opus 4.7 и более поздние версии) url: https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock description: Доступ к моделям Claude через Amazon Bedrock с нативной аутентификацией AWS, выставлением счетов и границами безопасности. --- Это руководство поможет вам настроить Claude в Amazon Bedrock и выполнять к нему вызовы API. Claude в Amazon Bedrock работает на инфраструктуре под управлением AWS с нулевым доступом операторов (сотрудники Anthropic не имеют доступа к инфраструктуре инференса). Это позволяет создавать приложения, работающие с конфиденциальными данными, полностью в пределах границы безопасности AWS, используя ту же структуру Messages API, что и в собственном API Anthropic. На этой странице описан Claude в Amazon Bedrock, который предоставляет Claude через Messages API по адресу `/anthropic/v1/messages` на инфраструктуре под управлением AWS. Предыдущая интеграция с Amazon Bedrock (API `InvokeModel` и `Converse` с идентификаторами моделей, версионируемыми через ARN) по-прежнему доступна и описана на странице [Claude в Amazon Bedrock (Opus 4.6 и более ранние версии)](https://platform.claude.com/docs/ru/build-with-claude/claude-on-amazon-bedrock-legacy). Об альтернативе на AWS под управлением Anthropic с оплатой через AWS Marketplace и, как правило, доступом к новым функциям в день их выпуска см. [Claude Platform на AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws). ## Доступ 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](https://console.aws.amazon.com/bedrock/home#/modelaccess) консоли AWS. Для Claude Mythos Preview требуется приглашение через [Project Glasswing](https://anthropic.com/glasswing). О доступности по регионам см. раздел [Регионы](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock#regions). ## Предварительные требования Прежде чем начать, убедитесь, что у вас есть: * Учетная запись AWS с включенным [доступом к моделям Amazon Bedrock](https://console.aws.amazon.com/bedrock/home#/modelaccess) для моделей Claude, которые вы планируете использовать. * Установленный и настроенный [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) (необязательно, для управления учетными данными). Для Claude Mythos Preview дополнительно требуется выделенная учетная запись AWS, добавленная в список разрешенных командой Bedrock Marketplace. Ваш менеджер по работе с клиентами в Anthropic может отправить идентификатор вашей учетной записи для добавления в список разрешенных (обычно обрабатывается в течение 24 часов), и после завершения AWS отправит приветственное письмо. ## Аутентификация Claude в Amazon Bedrock поддерживает три способа аутентификации. Выберите тот, который лучше всего соответствует вашим требованиям безопасности. ### Сервисная роль Bedrock (рекомендуется) Используйте сервисную роль Bedrock с ключами под управлением AWS для наиболее безопасного долгосрочного доступа: Администратор AWS создает сервисную роль Bedrock и предоставляет разработчикам разрешение `iam:PassRole` на ARN этой сервисной роли. При вызове API Bedrock принимает сервисную роль от вашего имени. О том, как связать роль с вашими запросами, см. [документацию Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-mantle.html). ### Принимаемые роли IAM Для доступа с федерацией удостоверений и максимальной продолжительностью сеанса 12 часов: Создайте роль IAM, ограниченную вашими моделями Claude. В политике доверия указывается ваш поставщик удостоверений (SAML, OIDC или AWS Identity Center). Политика разрешений предоставляет `bedrock-mantle:CreateInference` только для разрешенных ARN моделей. Пройдите аутентификацию через корпоративного поставщика удостоверений, затем примите роль IAM. AWS STS выдает временные учетные данные, которые SDK или CLI использует для подписи запросов. ### Токены носителя Для краткосрочного доступа без ролей IAM (максимум 12 часов, наименее предпочтительный вариант) используются «bearer tokens» (токены носителя): Заблокируйте долгосрочные ключи, прикрепив политику, которая запрещает `bedrock:CallWithBearerToken`, если условие `bedrock:BearerTokenType` не соответствует краткосрочному токену. Используйте CLI `aws-bedrock-token-generator` для создания токена носителя. Передавайте его в заголовке `x-api-key` в каждом запросе. ## Установка SDK [Клиентские SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview) Anthropic поддерживают Claude в Amazon Bedrock через специальный пакет или модуль для Bedrock. ```bash pip install -U "anthropic[bedrock]" ``` ```bash npm install @anthropic-ai/bedrock-sdk ``` ```bash dotnet add package Anthropic.Bedrock ``` ```bash go get github.com/anthropics/anthropic-sdk-go/bedrock ``` ```kotlin implementation("com.anthropic:anthropic-java:2.73.0") implementation("com.anthropic:anthropic-java-bedrock:2.73.0") ``` ```xml com.anthropic anthropic-java 2.73.0 com.anthropic anthropic-java-bedrock 2.73.0 ``` ```bash composer require anthropic-ai/sdk aws/aws-sdk-php ``` ```bash # Gemfile gem "anthropic" gem "aws-sdk-core" ``` ## Выполнение первого запроса Конечная точка имеет вид `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). ```bash curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \ --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \ --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \ -H "x-amz-security-token: $AWS_SESSION_TOKEN" \ -H "content-type: application/json" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "anthropic.claude-opus-5-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello, Claude"} ] }' ``` CLI `ant` не поддерживает Amazon Bedrock. Используйте cURL или SDK. ```python 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")) ``` ```typescript import { AnthropicBedrockMantle } from "@anthropic-ai/bedrock-sdk"; const client = new AnthropicBedrockMantle({ awsRegion: "us-east-1" }); const message = await client.messages.create({ model: "anthropic.claude-opus-5-5", max_tokens: 1024, messages: [{ role: "user", content: "Hello, Claude" }] }); const textBlock = message.content.find((block) => block.type === "text"); if (textBlock) { console.log(textBlock.text); } ``` ```csharp using Anthropic.Bedrock; using Anthropic.Models.Messages; var client = new AnthropicBedrockMantleClient(new() { AwsRegion = "us-east-1" }); var message = await client.Messages.Create(new() { Model = "anthropic.claude-opus-5-5", MaxTokens = 1024, Messages = [new() { Role = Role.User, Content = "Hello, Claude" }], }); foreach (var item in message.Content) { if (item.Value is TextBlock block) { Console.WriteLine(block.Text); break; } } ``` ```go client, err := bedrock.NewMantleClient(context.Background(), bedrock.MantleClientConfig{ AWSRegion: "us-east-1", }) if err != nil { panic(err) } message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{ Model: "anthropic.claude-opus-5-5", MaxTokens: 1024, Messages: []anthropic.MessageParam{ anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, Claude")), }, }) if err != nil { panic(err) } for _, block := range message.Content { if textBlock, ok := block.AsAny().(anthropic.TextBlock); ok { fmt.Println(textBlock.Text) break } } ``` ```java import com.anthropic.bedrock.backends.BedrockMantleBackend; import com.anthropic.client.AnthropicClient; import com.anthropic.client.okhttp.AnthropicOkHttpClient; import com.anthropic.models.messages.ContentBlock; import com.anthropic.models.messages.Message; import com.anthropic.models.messages.MessageCreateParams; void main() { AnthropicClient client = AnthropicOkHttpClient.builder() .backend(BedrockMantleBackend.fromEnv()) .build(); Message message = client.messages().create( MessageCreateParams.builder() .model("anthropic.claude-opus-5-5") .maxTokens(1024) .addUserMessage("Hello, Claude") .build() ); message.content().stream() .filter(ContentBlock::isText) .findFirst() .ifPresent(block -> IO.println(block.asText().text())); } ``` ```php use Anthropic\Bedrock\MantleClient; $client = new MantleClient(awsRegion: 'us-east-1'); $message = $client->messages->create( model: 'anthropic.claude-opus-5-5', maxTokens: 1024, messages: [ ['role' => 'user', 'content' => 'Hello, Claude'], ], ); echo array_find($message->content, fn ($block) => $block->type === 'text')->text; ``` ```ruby require "anthropic" client = Anthropic::BedrockMantleClient.new(aws_region: "us-east-1") message = client.messages.create( model: "anthropic.claude-opus-5-5", max_tokens: 1024, messages: [{role: "user", content: "Hello, Claude"}] ) puts message.content.find { it.type == :text }.text ``` Вы также можете создать стандартный клиент с помощью `Anthropic` (go: `anthropic.NewClient()`; java: `AnthropicOkHttpClient.builder()`; csharp: `AnthropicClient`; php: `Anthropic\Client`; ruby: `Anthropic::Client`): задайте для `base_url` (typescript: `baseURL`; go: `option.WithBaseURL()`; java: `.baseUrl()`; csharp: `BaseUrl`; php: `baseUrl`) значение `https://bedrock-mantle.{region}.api.aws/anthropic` и передайте ваш токен носителя как `api_key` (typescript, php: `apiKey`; go: `option.WithAPIKey()`; java: `.apiKey()`; csharp: `ApiKey`). Этот способ поддерживает только аутентификацию с помощью токена носителя. Для подписи SigV4 требуется `AnthropicBedrockMantle` (csharp: `AnthropicBedrockMantleClient`; go: `bedrock.NewMantleClient`; java: `BedrockMantleBackend`; php: `MantleClient`; ruby: `Anthropic::BedrockMantleClient`). ## Поддерживаемые модели Идентификаторы моделей в Claude в Amazon Bedrock имеют префикс поставщика `anthropic.`. Возможности и поведение моделей описаны на странице [Обзор моделей](https://platform.claude.com/docs/ru/models/overview). | Model | Model ID | Access | | :------------------------------------------------------------------------------------------ | :-------------------------------- | :-------------------------------------------------------------------------------------------------- | | Claude Fable 5.1 | `anthropic.claude-fable-5-1` | Open | | Claude Mythos 5.1 ([limited availability](https://support.claude.com/en/articles/14604842)) | `anthropic.claude-mythos-5-1` | Active (verification required) | | Claude Fable 5 | `anthropic.claude-fable-5` | Open | | Claude Mythos 5 ([limited availability](https://support.claude.com/en/articles/14604842)) | `anthropic.claude-mythos-5` | Active (verification required) | | Claude Mythos Preview ([limited availability](https://anthropic.com/glasswing)) | `anthropic.claude-mythos-preview` | Invitation only | | Claude Opus 5.5 | `anthropic.claude-opus-5-5` | [See Access](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Opus 5 | `anthropic.claude-opus-5` | [See Access](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Opus 4.8 | `anthropic.claude-opus-4-8` | Open | | Claude Opus 4.7 | `anthropic.claude-opus-4-7` | Open | | Claude Sonnet 5.5 | `anthropic.claude-sonnet-5-5` | [See Access](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Sonnet 5 | `anthropic.claude-sonnet-5` | Open | | Claude Haiku 5.5 | `anthropic.claude-haiku-5-5` | [See Access](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Haiku 4.5 | `anthropic.claude-haiku-4-5` | Open | Используйте последнюю версию Claude Code с Claude в Amazon Bedrock; для обновления выполните `claude update`. Переходите на более новую модель Claude? В Claude Code выполните `/claude-api migrate`, чтобы применить замену идентификаторов моделей и критические изменения параметров во всей вашей кодовой базе. Навык определяет, на какую облачную платформу ориентирован ваш код, и корректирует форматы идентификаторов моделей и изменения функций для этой платформы. См. раздел [Миграция на более новую модель Claude](https://platform.claude.com/docs/ru/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model). ## Поддержка функций Полный список функций с указанием доступности в Amazon Bedrock см. в разделе [Обзор функций](https://platform.claude.com/docs/ru/build-with-claude/overview). ### Основные поддерживаемые функции * [Messages API](https://platform.claude.com/docs/ru/api/messages/create) (`/anthropic/v1/messages`) * [Кэширование подсказок](https://platform.claude.com/docs/ru/build-with-claude/prompt-caching) * [Размышления](https://platform.claude.com/docs/ru/build-with-claude/thinking) * [Использование инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/overview), включая [инструмент Bash](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/bash-tool), [инструмент использования компьютера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool), [инструмент памяти](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/memory-tool) и [инструмент текстового редактора](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/text-editor-tool) * [Цитирование](https://platform.claude.com/docs/ru/build-with-claude/citations) ### Неподдерживаемые функции * [Структурированные выходные данные](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs) * Источники входных данных (URL-источники для изображений и документов, Files API) * Серверные инструменты (выполнение кода, веб-поиск, веб-загрузка, advisor) * Инфраструктура агентов (Agent Skills, коннектор MCP, программный вызов инструментов) * Конечные точки API (Message Batches, Models, Admin, Compliance, Usage and Cost) * Claude Managed Agents * Резервный вариант на стороне сервера ([параметр `fallbacks`](https://platform.claude.com/docs/ru/build-with-claude/refusals-and-fallback#server-side-fallback); вместо него используйте [шаблон резервного варианта на стороне клиента](https://platform.claude.com/docs/ru/build-with-claude/refusals-and-fallback#client-side-fallback)) * Наборы инструментов [использования компьютера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool) и [использования браузера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/browser-use-tool) (`computer_toolset_20260801` и `browser_toolset_20260801` в настоящее время недоступны в Amazon Bedrock; бета-версии инструмента использования компьютера остаются доступными) ## Регионы Claude в Amazon Bedrock доступен в следующих регионах AWS. Amazon Bedrock предлагает два типа конечных точек: * **Глобальная:** динамическая маршрутизация по всем доступным регионам для максимальной доступности. Без надбавки к цене. * **Региональная:** конечная точка разрешается в указанный вами единственный регион AWS — для соблюдения требований к месту хранения данных. Региональные конечные точки имеют надбавку к цене в 10% по сравнению с глобальными. Для маршрутизации между несколькими регионами в пределах одной географической зоны используйте [профиль инференса](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html) (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`. | Регион AWS | Расположение | Типы конечных точек | | ---------------- | ------------------------------------------ | ------------------------------------- | | `af-south-1` | Африка (Кейптаун) | Глобальная | | `ap-northeast-1` | Азиатско-Тихоокеанский регион (Токио) | Глобальная, JP, Только внутри региона | | `ap-northeast-2` | Азиатско-Тихоокеанский регион (Сеул) | Глобальная | | `ap-northeast-3` | Азиатско-Тихоокеанский регион (Осака) | Глобальная, JP | | `ap-south-1` | Азиатско-Тихоокеанский регион (Мумбаи) | Глобальная | | `ap-south-2` | Азиатско-Тихоокеанский регион (Хайдарабад) | Глобальная | | `ap-southeast-1` | Азиатско-Тихоокеанский регион (Сингапур) | Глобальная | | `ap-southeast-2` | Азиатско-Тихоокеанский регион (Сидней) | Глобальная, AU | | `ap-southeast-3` | Азиатско-Тихоокеанский регион (Джакарта) | Глобальная | | `ap-southeast-4` | Азиатско-Тихоокеанский регион (Мельбурн) | Глобальная, AU, Только внутри региона | | `ca-central-1` | Канада (Центральная) | Глобальная, US | | `ca-west-1` | Западная Канада (Калгари) | Глобальная | | `eu-central-1` | Европа (Франкфурт) | Глобальная, EU | | `eu-central-2` | Европа (Цюрих) | Глобальная, EU | | `eu-north-1` | Европа (Стокгольм) | Глобальная, EU, Только внутри региона | | `eu-south-1` | Европа (Милан) | Глобальная, EU | | `eu-south-2` | Европа (Испания) | Глобальная, EU | | `eu-west-1` | Европа (Ирландия) | Глобальная, EU, Только внутри региона | | `eu-west-2` | Европа (Лондон) | Глобальная, EU | | `eu-west-3` | Европа (Париж) | Глобальная, EU | | `il-central-1` | Израиль (Тель-Авив) | Глобальная | | `me-central-1` | Ближний Восток (ОАЭ) | Глобальная | | `sa-east-1` | Южная Америка (Сан-Паулу) | Глобальная | | `us-east-1` | Восток США (Северная Вирджиния) | Глобальная, US, Только внутри региона | | `us-east-2` | Восток США (Огайо) | Глобальная, US, Только внутри региона | | `us-west-1` | Запад США (Северная Калифорния) | Глобальная, US | | `us-west-2` | Запад США (Орегон) | Глобальная, US, Только внутри региона | ## Квоты Квота по умолчанию составляет 2 миллиона входных токенов в минуту (TPM). Вы можете запросить до 5 миллионов входных TPM и 500 000 выходных TPM без дополнительного одобрения Anthropic. AWS применяет ограничения на количество запросов в минуту (RPM) на стороне Bedrock; для изменения RPM обратитесь в службу поддержки AWS. ## Хранение данных Обработка данных для этого предложения регулируется Amazon Bedrock. Подробнее см. [Data protection in Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/data-protection.html). ## Мониторинг и журналирование Claude в Amazon Bedrock отправляет журналы как в CloudWatch, так и в CloudTrail. Anthropic рекомендует хранить журналы активности как минимум за скользящий 30-дневный период, чтобы понимать закономерности использования и расследовать возможные проблемы. ## Поддержка Для получения поддержки обращайтесь по адресу **[bedrock-ant-eap@amazon.com](mailto:bedrock-ant-eap@amazon.com)**. Укажите идентификатор вашей учетной записи AWS и `request-id` из всех неудачных ответов API. **Claude Mythos Preview** — это модель в режиме исследовательского предварительного просмотра, доступная приглашенным клиентам в Amazon Bedrock. Подробнее см. [Project Glasswing](https://anthropic.com/glasswing).