---
title: Claude Platform on AWS
url: https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws
description: Получите доступ ко всем возможностям платформы Claude через AWS с инфраструктурой, управляемой Anthropic.
---
Claude Platform on AWS предоставляет вам полноценную платформу Anthropic, включая Messages API, Agent Skills, выполнение кода и бета-функции, с доступом через вашу учётную запись AWS. В отличие от [Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock), где стек инференса обслуживает AWS, Claude Platform on AWS обслуживает Anthropic. AWS предоставляет уровень аутентификации (SigV4 или ключ API), управление доступом на основе IAM и интеграцию выставления счетов через AWS Marketplace.
SDK Anthropic поддерживают Claude Platform on AWS.
## Как работает интеграция платформы
Модели Claude работают на инфраструктуре, управляемой Anthropic. Это коммерческая интеграция для выставления счетов и доступа через AWS. Anthropic является обработчиком данных для входных и выходных данных инференса. AWS обрабатывает метаданные выставления счетов и идентификации в рамках модели маркетплейса. На клиентов, использующих Claude через Claude Platform on AWS, распространяются [условия использования данных](https://www.anthropic.com/legal) Anthropic.
Anthropic использует инфраструктуру AWS для обработки ваших запросов к API, выполнения инференса модели и хранения содержимого вашего рабочего пространства (например, подсказок, выходных данных, файлов, Skills и пакетов). Для рабочих пространств, созданных до 18 сентября 2026 года, 00:00 UTC, Anthropic может обрабатывать запросы, хранить данные и выполнять инференс за пределами AWS. В любом случае вспомогательные сервисы могут меняться без уведомления. Задайте параметр [`inference_geo`](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#data-residency) для каждого запроса, чтобы закрепить инференс за определённым географическим регионом.
Claude Platform on AWS следует той же политике хранения данных, что и собственный Claude API. «Zero Data Retention» (нулевое хранение данных), или ZDR, доступно по запросу. Свяжитесь с вашим представителем Anthropic, чтобы включить его для вашей организации.
## Claude Platform on AWS в сравнении с Amazon Bedrock
Оба предложения позволяют использовать Claude через AWS, но различаются архитектурой, поверхностью API и доступностью функций.
| Аспект | Claude Platform on AWS | [Claude in Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock) | [Amazon Bedrock (Opus 4.6 и более ранние)](https://platform.claude.com/docs/ru/build-with-claude/claude-on-amazon-bedrock-legacy) |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Кто обслуживает стек** | Anthropic | AWS | AWS |
| **Поверхность API** | Claude API (`/v1/{endpoint}`) | Messages API по адресу `/anthropic/v1/messages` | Bedrock Converse / InvokeModel |
| **Доступность функций** | Как правило, в тот же день, что и в Claude API (см. [ограничения функций](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#features-not-supported)) | Согласно графику выпусков Amazon Bedrock | Согласно графику выпусков Amazon Bedrock |
| **Agent Skills** | Доступны | Недоступны (требуется выполнение кода) | Недоступны |
| **Бета-функции** | Передаются через заголовки `anthropic-beta` (см. [ограничения функций](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#features-not-supported)) | Бета-функции, поддерживаемые Amazon Bedrock, через заголовок `anthropic-beta` | Бета-функции, поддерживаемые Amazon Bedrock, через поле `anthropic_beta` в теле запроса InvokeModel |
| **Аутентификация** | AWS IAM / SigV4 или ключ API | AWS IAM / SigV4 | AWS IAM / SigV4 или bearer-токен |
| **Выставление счетов** | AWS Marketplace | AWS (нативный сервис) | AWS (нативный сервис) |
| **Базовый URL** | `aws-external-anthropic.{region}.api.aws` | `bedrock-mantle.{region}.api.aws` | `bedrock-runtime.{region}.amazonaws.com` |
| **Клиент SDK** | `AnthropicAWS` (typescript: `AnthropicAws`; csharp: `AnthropicAwsClient`; go: `anthropicaws.NewClient()`; java: `AwsBackend`; php: `Anthropic\Aws\Client`; ruby: `Anthropic::AWSClient`), в бета-версии | `AnthropicBedrockMantle` | `AnthropicBedrock` / Bedrock SDK |
| **Консоль** | Claude Console (`platform.claude.com`, доступ через AWS Console) | Bedrock Console | Bedrock Console |
| **Ограничения скорости и квоты** | Управляются Anthropic | Управляются AWS | Управляются AWS |
| **Обработчик данных инференса** | Anthropic | AWS | AWS |
Если вам нужен Claude, обслуживаемый AWS, см. [Claude in Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock). Claude Platform on AWS использует отдельный пул мощностей, независимый как от собственного Claude API, так и от Amazon Bedrock. Вы можете запускать рабочие нагрузки на нескольких платформах и переключаться между ними при сбоях.
[AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/what-is-privatelink.html) поддерживается для подключения вашего VPC к конечной точке Claude Platform on AWS.
**Когда выбирать Bedrock:** организациям в регулируемых отраслях, которым требуется соответствие FedRAMP High, IL4, IL5 или готовность к HIPAA, либо которым нужно, чтобы AWS был единственным обработчиком данных, следует использовать [Claude in Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock). Bedrock полностью работает на инфраструктуре, контролируемой AWS, и AWS выступает обслуживающей стороной.
**Каким предложением вы пользуетесь?** Claude доступен через несколько отдельных продуктов:
* **Claude Platform on AWS** (эта страница): платформа Claude API со счетами через AWS Marketplace. Управляется в [Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#using-the-claude-console) и AWS Console.
* **[Claude in Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock):** нативный сервис AWS. Управляется в консоли Amazon Bedrock, счета выставляются как за использование сервиса AWS.
* **Claude Enterprise, приобретённый через AWS Marketplace:** план [claude.ai](https://claude.ai) (чат-продукт Claude), а не платформа API. Управляется на claude.ai, а поведение его учётной записи и миграции отличается от описанного на этой странице. См. [Справочный центр Claude](https://support.claude.com).
* **Прямые учётные записи Anthropic:** собственный Claude API и планы claude.ai со счетами от Anthropic. Управляются в Claude Console и на claude.ai.
## Настройка учётной записи
Настройка Claude Platform on AWS проходит в четыре этапа: регистрация на странице сервиса в AWS Console, завершение настройки организации Anthropic, получение идентификатора рабочего пространства и вход в Claude Console.
Регистрация через AWS Console создаёт новую организацию Anthropic, привязанную к вашей учётной записи AWS. Эта организация отделена от любых существующих организаций вашей компании в Anthropic, включая организации Claude Enterprise, приобретённые через AWS Marketplace. Ключи API, рабочие пространства и настройки Claude Console из собственной организации Anthropic не переносятся.
Если у вас есть действующее частное предложение Amazon Bedrock, свяжитесь с вашим представителем Anthropic или AWS до регистрации, чтобы скидка применялась с вашего первого запроса. Скидки не могут применяться задним числом к использованию, произошедшему до принятия частного предложения. См. [Частные предложения](https://platform.claude.com/docs/ru/about-claude/pricing#private-offers).
1. Откройте [AWS Console](https://console.aws.amazon.com/) и перейдите на страницу сервиса **Claude Platform on AWS**.
2. Выберите **Sign up**.
3. На странице регистрации ознакомьтесь с условиями (Лицензионное соглашение с конечным пользователем Anthropic, Уведомление о конфиденциальности AWS и Клиентское соглашение AWS) и установите флажок согласия.
4. Выберите **Continue**.
На странице отображается баннер **Sign-up in progress**. Оставайтесь на странице. Регистрация занимает несколько минут, пока AWS оформляет за вас подписку в AWS Marketplace, после чего вы будете автоматически перенаправлены.
Если у вашей организации есть частное предложение от Anthropic, консоль найдёт его и предложит принять его в AWS Marketplace. Подробнее см. в разделе [Частные предложения](https://platform.claude.com/docs/ru/about-claude/pricing#private-offers).
Когда вы используете Claude Platform on AWS, Anthropic обрабатывает и хранит ваше содержимое (например, подсказки и выходные данные) на инфраструктуре AWS. Для рабочих пространств, созданных до 18 сентября 2026 года, 00:00 UTC, Anthropic может обрабатывать и хранить это содержимое за пределами AWS. [Политики использования данных](https://www.anthropic.com/legal) Anthropic описывают, как обрабатываются и хранятся содержимое и метаданные.
После завершения регистрации вы будете перенаправлены на `platform.claude.com/partner-signup`.
1. Введите адрес электронной почты владельца вашей организации и выберите **Get started**.
2. Проверьте этот почтовый ящик на наличие ссылки для настройки и перейдите по ней. Если браузер показывает страницу **Signed in as a different account**, выберите **Log out and continue**.
3. Заполните форму сведений об организации (название организации, тип юридического лица, страна, предполагаемое использование) и выберите **Complete setup**.
Завершение настройки создаёт вашу организацию Anthropic и означает принятие Коммерческих условий обслуживания и Политики использования Anthropic. Теперь на странице сервиса в AWS Console отображается левая панель навигации с разделами **Home**, **API keys**, **Quickstart** и **Workspaces**.
После завершения настройки AWS Console предложит вам создать рабочее пространство. Подробнее о привязке к региону, ограничении ресурсов IAM и создании дополнительных рабочих пространств см. в разделе [Рабочие пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#workspaces).
Идентификатор рабочего пространства можно найти в разделе **Workspaces** на странице сервиса **Claude Platform on AWS** в AWS Console или в [Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#using-the-claude-console). Идентификаторы рабочих пространств имеют формат `wrkspc_`, за которым следует буквенно-цифровой идентификатор.
Доступ к Claude Console федерируется через AWS IAM:
1. Примите роль IAM с разрешением `aws-external-anthropic:AssumeConsole`. См. [Действия IAM для Claude Platform on AWS](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#console-access).
2. На странице сервиса **Claude Platform on AWS** выберите **Open Claude Console**. AWS Console выдаёт JWT и перенаправляет вас на `platform.claude.com`.
3. При первом входе вам будет предложено ввести адрес электронной почты. Введите рабочий адрес. Платформа создаст вашего пользователя Claude Console по требованию (just-in-time).
Когда вы входите через AWS Console, Claude Console ограничивается вашей организацией Claude Platform on AWS. В левом нижнем углу боковой панели Claude Console появляется индикатор **Account managed by AWS**.
### Переход с существующей организации Anthropic
Регистрация в Claude Platform on AWS всегда создаёт новую организацию Anthropic, привязанную к вашей учётной записи AWS. Преобразование на месте невозможно: существующая организация, например организация собственного Claude API, не может стать организацией Claude Platform on AWS.
Планируйте переход с существующей организации как переключение на новую:
* **Сначала создайте новую организацию.** Зарегистрируйтесь через AWS Console (см. [Настройка учётной записи](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#set-up-your-account)). Если ваш переход связан с частным предложением, завершите регистрацию до принятия предложения: скидки применяются с момента принятия, а не задним числом. См. [Частные предложения](https://platform.claude.com/docs/ru/about-claude/pricing#private-offers).
* **Воссоздайте доступ и конфигурацию.** Ключи API, рабочие пространства и настройки Claude Console не переносятся из существующей организации. Создайте рабочие пространства в новой организации и переведите свои приложения на [аутентификацию Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#authentication).
* **Обновите интеграцию.** Claude Platform on AWS обслуживает Claude API (`/v1/{endpoint}`), поэтому структура запросов и ответов не отличается от собственного Claude API. Меняются базовый URL, метод аутентификации и заголовок `anthropic-workspace-id` в запросах инференса и запросах к ресурсам; см. [Выполнение запросов](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#making-requests). Некоторые функции платформы отличаются; см. [Неподдерживаемые функции](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#features-not-supported).
* **Переключайтесь по собственному графику.** Новая организация независима от существующей, и обе могут обслуживать трафик параллельно. Жёсткое переключение не требуется: переносите рабочие нагрузки постепенно, пока весь ваш трафик не окажется в новой организации.
После запуска новой организации различия сосредоточены в выставлении счетов и аутентификации, которые обрабатываются через AWS:
* **Выставление счетов** переходит в AWS Marketplace: использование тарифицируется в Claude Consumption Units, а не в предоплаченных кредитах (см. [Выставление счетов](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#billing)), а лимиты расходов задаются на странице Billing (см. [Лимиты расходов](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#spend-limits)). В переходный период выставление счетов остаётся раздельным: существующей организации счета продолжают выставляться так же, как сейчас.
* **Аутентификация и доступ** переходят в AWS: запросы аутентифицируются с помощью учётных данных AWS или ключей API, созданных в AWS Console, а не в Claude Console (см. [Аутентификация](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#authentication)). Членство в организации управляется через AWS IAM, а не через Claude Console (см. [Доступные страницы](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#available-pages)), а клиентские SDK Anthropic предоставляют специфичные для платформы клиентские классы (см. [Установка SDK](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#install-an-sdk)).
* **Повседневное использование API** работает так же, как в собственном Claude API, за исключением случаев, указанных в [ограничениях функций](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#features-not-supported). Перед переносом производственного трафика проверьте свои ограничения скорости: новые организации получают уровень Start, а повышение лимитов осуществляется через вашего представителя Anthropic (см. [Ограничения скорости и квоты](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)).
Об организациях Claude Enterprise (claude.ai), которые ведут себя иначе, см. [сравнение предложений](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#claude-platform-on-aws-vs-amazon-bedrock).
### Устранение неполадок при настройке учётной записи
* **«Sign-up failed: Failed to enable OutboundWebIdentityFederation»:** если вы видите этот баннер при первой отправке, снова выберите **Continue**. Включение IAM может вступить в силу не сразу.
* **Нет индикатора прогресса во время регистрации:** регистрация занимает несколько минут. Пока AWS создаёт вашу учётную запись, на странице отображается статический баннер **Sign-up in progress** без индикатора выполнения.
* **«Signed in as a different account» после перехода по ссылке для настройки:** выберите **Log out and continue**. Страница повторно аутентифицирует вас с введённым адресом электронной почты.
* **Сообщение «Not found» во время входа:** это сообщение может ненадолго появиться во время перенаправления. Его можно закрыть.
* **Страница Usage не показывает данных после первого вызова API:** данные об использовании могут появиться в Claude Console через несколько минут.
* **«Outbound web identity federation is disabled» при первом вызове API:** включите федерацию один раз для учётной записи. См. [Включение исходящей федерации веб-идентификации](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation).
## Перед выполнением вызовов API
Убедитесь, что у вас есть:
1. Активная учётная запись AWS с подпиской на Claude Platform on AWS (см. [Настройка учётной записи](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#set-up-your-account))
2. Установленный и настроенный [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)
3. **Включённая исходящая федерация веб-идентификации** в вашей учётной записи AWS — однократный шаг настройки (см. [Включение исходящей федерации веб-идентификации](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation))
4. Идентификатор вашего рабочего пространства (см. [Получение идентификатора рабочего пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#obtain-your-workspace-id))
5. Разрешение IAM на вызов API: действие `aws-external-anthropic:CreateInference` для вашего рабочего пространства, а также `aws-external-anthropic:CallWithBearerToken`, если вы аутентифицируетесь с помощью ключа API (см. [Политики IAM](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#iam-policies))
### Включение исходящей федерации веб-идентификации
Шлюз Claude Platform on AWS на стороне сервера вызывает `sts:GetWebIdentityToken`, чтобы выпустить JWT, который он передаёт в Anthropic. Эта возможность STS **по умолчанию отключена** в каждой учётной записи AWS. Включите её один раз для учётной записи:
```bash CLI
aws iam enable-outbound-web-identity-federation
```
Если ответ — `[ERROR] (FeatureEnabled) ... already enabled`, настройка уже включена для вашей учётной записи, и можно продолжать. Проверьте и получите URL издателя для вашей учётной записи:
```bash CLI
aws iam get-outbound-web-identity-federation-info
```
Без этого шага каждый запрос возвращает `"Outbound web identity federation is disabled for your account"`. Это самая распространённая ошибка настройки.
### Получение идентификатора рабочего пространства
Вы создаёте рабочее пространство в AWS Console после завершения настройки учётной записи (см. [Настройка учётной записи](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#set-up-your-account)). Рабочие пространства привязаны к одному региону AWS. Идентификатор рабочего пространства можно найти в [Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#using-the-claude-console) в разделе **Workspaces** или в разделе **Workspaces** на странице сервиса в AWS Console.
Задайте переменные окружения `ANTHROPIC_AWS_WORKSPACE_ID` и `AWS_REGION`, чтобы клиенты SDK считывали их автоматически:
```bash CLI
export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj'
export AWS_REGION='us-west-2' # Your workspace's AWS region
```
Регион обязателен. Клиент SDK выдаёт ошибку, если регион не задан. Передайте `aws_region` (typescript, php: `awsRegion`; go: `AWSRegion`; java: `.region()`; csharp: `AwsClientOptions.AwsRegion`) при создании клиента или задайте `AWS_REGION` (или `AWS_DEFAULT_REGION`). Поддерживаются все коммерческие регионы AWS.
## Аутентификация
Claude Platform on AWS поддерживает два метода аутентификации: AWS IAM с подписью запросов Signature Version 4 (SigV4) (основной) и аутентификацию с помощью ключа API. Оба используют один и тот же базовый URL и формат запроса.
### Аутентификация SigV4
SigV4 — это нативный для предприятий путь, который интегрируется с вашими существующими политиками, ролями и аудитом AWS IAM. Настройте учётные данные AWS любым способом, поддерживаемым [цепочкой поставщиков учётных данных AWS по умолчанию](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html):
* Переменные окружения (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`)
* Общий файл учётных данных (`~/.aws/credentials`)
* Общий файл конфигурации (`~/.aws/config`), включая SSO и `credential_process`
* Веб-идентификация (`AWS_WEB_IDENTITY_TOKEN_FILE` и `AWS_ROLE_ARN`) для IRSA и GitHub Actions
* Учётные данные контейнера ECS
* Служба метаданных экземпляра EC2 (IMDS)
Убедитесь, что ваши учётные данные работают:
```bash CLI
aws sts get-caller-identity
```
### Аутентификация с помощью ключа API
Для более простых путей интеграции (локальная разработка и скрипты) вы можете аутентифицироваться с помощью ключа API вместо SigV4. Задайте переменную окружения `ANTHROPIC_AWS_API_KEY` или передайте `api_key` (typescript, php: `apiKey`; go: `APIKey`; java: `.apiKey()`; csharp: `AwsClientOptions.ApiKey`) при создании клиента.
Создавайте ключи API в **AWS Console** в разделе **Claude Platform on AWS → API keys**. Выберите **Generate a key**, затем скопируйте значение ключа. Предоставьте действие IAM `aws-external-anthropic:CallWithBearerToken` тем субъектам, которым должно быть разрешено использовать аутентификацию с помощью ключа API.
Ключи API для Claude Platform on AWS управляются в AWS Console, а не в Claude Console. Ключи, созданные в стандартной [Claude Console](https://platform.claude.com/) (для доступа к собственному API), не работают с конечной точкой Claude Platform on AWS.
#### Краткосрочные ключи API
Для рабочих нагрузок, которым нужно передать учётные данные отдельному процессу (например, шлюзу LLM, бессерверной функции или инструменту, который поддерживает аутентификацию с bearer-токеном, но не SigV4), создайте краткосрочный ключ API на основе ваших учётных данных AWS вместо выпуска долгосрочного ключа в AWS Console.
AWS публикует библиотеки генерации токенов для [JavaScript](https://github.com/aws/token-generator-for-aws-external-anthropic-js), [Python](https://github.com/aws/token-generator-for-aws-external-anthropic-python) и [Java](https://github.com/aws/token-generator-for-aws-external-anthropic-java). Каждая библиотека считывает ваши учётные данные AWS через стандартную цепочку поставщиков и возвращает токен с ограниченным сроком действия, который вы отправляете как `Authorization: Bearer `. Срок действия токена по умолчанию составляет 12 часов и ограничен наименьшим из значений: запрошенной вами длительности, срока действия ваших учётных данных AWS и 12 часов. Инструкции по установке и полные параметры конфигурации см. в README связанных репозиториев.
Передайте сгенерированный токен в SDK так же, как вы передали бы ключ API, созданный в AWS Console:
```python Python
from token_generator_for_aws_external_anthropic import TokenGenerator
from anthropic import AnthropicAWS
token = TokenGenerator(region="us-west-2").get_token()
client = AnthropicAWS(api_key=token, aws_region="us-west-2")
```
```typescript TypeScript
import { getTokenProvider } from "@aws/token-generator-for-aws-external-anthropic";
import AnthropicAws from "@anthropic-ai/aws-sdk";
const tokenProvider = getTokenProvider({ region: "us-west-2" });
const token = await tokenProvider();
const client = new AnthropicAws({ apiKey: token, awsRegion: "us-west-2" });
```
```java Java
import software.amazon.awsexternalanthropic.TokenGenerator;
import software.amazon.awssdk.regions.Region;
import com.anthropic.aws.backends.AwsBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
void main() {
String token = TokenGenerator.builder().region(Region.US_WEST_2).build().getToken();
AnthropicClient client = AnthropicOkHttpClient.builder()
.backend(AwsBackend.builder()
.apiKey(token)
.region(Region.US_WEST_2)
.workspaceId(System.getenv("ANTHROPIC_AWS_WORKSPACE_ID"))
.build())
.build();
}
```
Если вы можете сгенерировать токен локально, у вашего процесса уже есть учётные данные SigV4, и аутентификация SigV4 обычно оказывается более простым вариантом. Используйте краткосрочные ключи, когда процесс, выполняющий вызовы API, отделён от процесса, который хранит учётные данные AWS.
SDK не обновляет краткосрочные ключи автоматически. Когда срок действия токена истекает, сгенерируйте новый и создайте новый клиент. Субъекту, использующему токен, по-прежнему требуется действие IAM `aws-external-anthropic:CallWithBearerToken`.
### Приоритет учётных данных
Специфичный для платформы клиент определяет аутентификацию в следующем порядке, начиная с того, что вы передаёте при его создании:
1. `api_key` (typescript, php: `apiKey`; go: `APIKey`; java: `.apiKey()`; csharp: `AwsClientOptions.ApiKey`) → заголовок `Authorization: Bearer`
2. `aws_access_key` (typescript, php: `awsAccessKey`; go: `AWSAccessKey`; java: `.awsAccessKey()`; csharp: `AwsClientOptions.AwsAccessKey`) + `aws_secret_key` (ruby: `aws_secret_access_key`; typescript, php: `awsSecretAccessKey`; go: `AWSSecretAccessKey`; java: `.awsSecretAccessKey()`; csharp: `AwsClientOptions.AwsSecretAccessKey`) → AWS SigV4
3. `aws_profile` (typescript, php: `awsProfile`; go: `AWSProfile`; java: `.awsProfile()`; csharp: `AwsClientOptions.AwsProfile`) → AWS SigV4 с именованным профилем
4. Переменная окружения `ANTHROPIC_AWS_API_KEY` → заголовок `Authorization: Bearer`
5. Цепочка поставщиков учётных данных AWS по умолчанию → AWS SigV4
### Определение региона
Клиент считывает `AWS_REGION` из окружения, если вы не задали `aws_region` (typescript, php: `awsRegion`; go: `AWSRegion`; java: `.region()`; csharp: `AwsClientOptions.AwsRegion`), и использует `AWS_DEFAULT_REGION` в качестве запасного варианта для совместимости со стандартными AWS SDK. Регион обязателен, и значения по умолчанию нет: `AnthropicAWS` (typescript: `AnthropicAws`; csharp: `AnthropicAwsClient`; go: `anthropicaws.NewClient()`; java: `AwsBackend`; php: `Anthropic\Aws\Client`; ruby: `Anthropic::AWSClient`) выдаёт ошибку, если не задан ни аргумент конструктора, ни переменная окружения.
## Установка SDK
[Клиентские SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview) Anthropic поддерживают Claude Platform on AWS. Ваш SDK предоставляет `AnthropicAWS` (typescript: `AnthropicAws`; csharp: `AnthropicAwsClient`; go: `anthropicaws.NewClient()`; java: `AwsBackend`; php: `Anthropic\Aws\Client`; ruby: `Anthropic::AWSClient`), который обрабатывает подпись SigV4, построение базового URL на основе региона и заголовок `anthropic-workspace-id`.
```bash
pip install -U "anthropic[aws]"
```
В macOS с Python из Homebrew или в других внешне управляемых окружениях Python команда `pip install` может завершиться ошибкой PEP 668 `externally-managed-environment`. Сначала создайте и активируйте виртуальное окружение: `python3 -m venv .venv && source .venv/bin/activate`.
```bash
npm install @anthropic-ai/aws-sdk
```
```bash
dotnet add package Anthropic.Aws
```
```bash
go get github.com/anthropics/anthropic-sdk-go
```
```kotlin Gradle
implementation("com.anthropic:anthropic-java:3.3.0")
implementation("com.anthropic:anthropic-java-aws:3.3.0")
```
```xml Maven
com.anthropic
anthropic-java
3.3.0
com.anthropic
anthropic-java-aws
3.3.0
```
```bash
composer require anthropic-ai/sdk aws/aws-sdk-php
```
```bash
gem install anthropic aws-sdk-core
```
Клиенты SDK для Claude Platform on AWS находятся в бета-версии.
## Доступные модели
В Claude Platform on AWS доступны следующие модели:
| Model | Model ID |
| :---------------------------------------------------------------------------------------------------- | :------------------ |
| Claude Fable 5.1 | `claude-fable-5-1` |
| Claude Fable 5 | `claude-fable-5` |
| Claude Opus 5.5 | `claude-opus-5-5` |
| Claude Opus 5 | `claude-opus-5` |
| Claude Opus 4.8 | `claude-opus-4-8` |
| Claude Opus 4.7 | `claude-opus-4-7` |
| Claude Opus 4.6 | `claude-opus-4-6` |
| Claude Opus 4.5 | `claude-opus-4-5` |
| Claude Sonnet 5.5 | `claude-sonnet-5-5` |
| Claude Sonnet 5 | `claude-sonnet-5` |
| Claude Sonnet 4.6 | `claude-sonnet-4-6` |
| Claude Sonnet 4.5 ([deprecated](https://platform.claude.com/docs/ru/about-claude/model-deprecations)) | `claude-sonnet-4-5` |
| Claude Haiku 5.5 | `claude-haiku-5-5` |
| Claude Haiku 4.5 | `claude-haiku-4-5` |
Идентификаторы моделей идентичны собственному Claude API. ARN в стиле Bedrock и префиксы `anthropic.` не используются.
Новые модели, как правило, появляются в Claude Platform on AWS в тот же день, что и в собственном Claude API.
Переходите на более новую модель Claude? [Навык Claude API](https://platform.claude.com/docs/ru/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model) в Claude Code применяет замену идентификаторов моделей и критические изменения параметров во всей вашей кодовой базе:
Позвольте Claude Code выполнить миграцию вашего кода за вас
```text
/claude-api migrate этот проект на последнюю модель Claude Opus
```
Навык определяет, на какую облачную платформу ориентирован ваш код, и корректирует форматы идентификаторов моделей и изменения функций для этой платформы.
## Выполнение запросов
Claude Platform on AWS использует те же конечные точки API, что и собственный Claude API. Различаются базовый URL, метод аутентификации и заголовок `anthropic-workspace-id`, который определяет [рабочее пространство](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#workspaces), на которое направлен запрос. Заголовок обязателен в запросах инференса и запросах к ресурсам, например в вызовах Messages API, Models API, Files API и конечных точек Claude Managed Agents. Запросам к [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api) он не требуется.
Перед запуском этих примеров выполните шаги из раздела [Перед выполнением вызовов API](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#before-making-api-calls).
```bash cURL
# Замените us-west-2 на ваш регион AWS как в URL, так и в --aws-sigv4
# Не указывайте заголовок x-amz-security-token, если используете долгосрочные учётные данные пользователя IAM
curl "https://aws-external-anthropic.us-west-2.api.aws/v1/messages" \
--aws-sigv4 "aws:amz:us-west-2:aws-external-anthropic" \
--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" \
-H "anthropic-workspace-id: $ANTHROPIC_AWS_WORKSPACE_ID" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Hello!"}
]
}'
```
```bash CLI
# Замените us-west-2 на ваш регион AWS
# ant считывает ANTHROPIC_API_KEY. Создайте ключ в консоли AWS
# (см. аутентификацию с помощью ключа API).
export ANTHROPIC_API_KEY="YOUR_AWS_API_KEY"
ant messages create \
--base-url https://aws-external-anthropic.us-west-2.api.aws \
--workspace-id "$ANTHROPIC_AWS_WORKSPACE_ID" \
--model claude-sonnet-5-5 \
--max-tokens 1024 \
--message '{role: user, content: "Hello!"}'
```
```python Python
from anthropic import AnthropicAWS
client = AnthropicAWS()
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message)
```
```typescript TypeScript
import AnthropicAws from "@anthropic-ai/aws-sdk";
const client = new AnthropicAws();
const message = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello!" }]
});
console.log(message);
```
```csharp C#
using Anthropic;
using Anthropic.Aws;
var client = new AnthropicAwsClient();
var message = await client.Messages.Create(new()
{
Model = Model.ClaudeSonnet5_5,
MaxTokens = 1024,
Messages = [new UserMessageParam { Content = "Hello!" }]
});
Console.WriteLine(message);
```
```go Go
client, err := anthropicaws.NewClient(context.Background(), anthropicaws.ClientConfig{})
if err != nil {
panic(err)
}
message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
Model: anthropic.ModelClaudeSonnet5_5,
MaxTokens: 1024,
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),
},
})
if err != nil {
panic(err)
}
fmt.Println(message)
```
```java Java
import com.anthropic.aws.backends.AwsBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Model;
void main() {
AnthropicClient client = AnthropicOkHttpClient.builder()
.backend(AwsBackend.fromEnv())
.build();
Message message = client.messages().create(
MessageCreateParams.builder()
.model(Model.CLAUDE_SONNET_5_5)
.maxTokens(1024)
.addUserMessage("Hello!")
.build()
);
IO.println(message);
}
```
```php PHP
use Anthropic\Aws\Client;
$client = new Client();
$message = $client->messages->create(
model: 'claude-sonnet-5-5',
maxTokens: 1024,
messages: [['role' => 'user', 'content' => 'Hello!']],
);
echo $message;
```
```ruby Ruby
require "anthropic"
client = Anthropic::AWSClient.new
message = client.messages.create(
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello!" }]
)
puts message
```
Клиент считывает `AWS_REGION` (или `AWS_DEFAULT_REGION`) и `ANTHROPIC_AWS_WORKSPACE_ID` из окружения. Вы можете переопределить любое из этих значений, передав `aws_region` (typescript, php: `awsRegion`; go: `AWSRegion`; java: `.region()`; csharp: `AwsClientOptions.AwsRegion`) или `workspace_id` (typescript, php: `workspaceId`; go: `WorkspaceID`; java: `.workspaceId()`; csharp: `AwsClientOptions.WorkspaceId`) при создании клиента. И регион, и идентификатор рабочего пространства обязательны. Конструктор выдаёт ошибку, если какое-либо из этих значений не удаётся определить.
Заголовок `x-amz-security-token` (cURL) требуется только для временных учётных данных, таких как роли IAM, SSO или STS. Не указывайте его при использовании долгосрочных учётных данных пользователя IAM. Клиенты SDK обрабатывают это автоматически в зависимости от источника учётных данных.
Значение `--aws-sigv4` имеет формат `aws:amz::`. Имя сервиса SigV4 — `aws-external-anthropic`, а регион должен совпадать с регионом в URL вашей конечной точки. Несовпадение любого из них приводит к общей ошибке отклонения подписи, а не к конкретной диагностике.
### Контекстное окно
Размеры «context window» (контекстное окно) в Claude Platform on AWS идентичны собственному Claude API. Ограничения для каждой модели см. в разделе [Контекстные окна](https://platform.claude.com/docs/ru/build-with-claude/context-windows).
## Поддержка функций
Claude Platform on AWS напрямую использует конечные точки Claude API, что означает полное соответствие функций собственному Claude API (за исключением случаев, указанных в [ограничениях функций](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#features-not-supported)):
* **Доступ к функциям:** поскольку Anthropic обслуживает обе платформы, большинство новых функций и бета-заголовков становятся доступны в Claude Platform on AWS без отдельного шага интеграции. Исключения см. в разделе [ограничения функций](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#features-not-supported).
* **Бета-функции:** передавайте стандартный заголовок `anthropic-beta` для доступа к бета-функциям, как и в Claude API.
* **Agent Skills:** используйте готовые и пользовательские [Agent Skills](https://platform.claude.com/docs/ru/agents-and-tools/agent-skills/overview) с тем же параметром `container.skills`, что и в Claude API. Все готовые Skills (PowerPoint, Excel, Word, PDF) работают сразу.
* **Выполнение кода:** запускайте код в управляемой песочнице Anthropic с помощью [инструмента выполнения кода](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/code-execution-tool).
* **Использование инструментов:** все [возможности «tool use» (использование инструментов)](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/overview) доступны, кроме наборов инструментов computer use и browser use; см. [Неподдерживаемые функции](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#features-not-supported).
* **Размышления:** [адаптивные размышления](https://platform.claude.com/docs/ru/build-with-claude/thinking), [параметр effort](https://platform.claude.com/docs/ru/build-with-claude/effort) и, на поддерживающих их моделях, [«extended thinking» (расширенные размышления)](https://platform.claude.com/docs/ru/build-with-claude/extended-thinking) работают с теми же параметрами, что и в Claude API.
* **Потоковая передача:** полная поддержка «streaming» (потоковая передача) через SSE для ответов в реальном времени.
* **Пакетная обработка:** отправляйте пакетные запросы для высокопроизводительных рабочих нагрузок.
* **Кэширование подсказок:** кэшируйте инструменты, системные подсказки и историю сообщений, чтобы снизить задержку и стоимость. Доступны все возможности «prompt caching» (кэширование подсказок) (TTL 5 минут, TTL 1 час и автоматическое кэширование).
* **Files API:** загружайте файлы и ссылайтесь на них в разных запросах.
* **Ключи шифрования, управляемые клиентом (CMEK):** [CMEK](https://platform.claude.com/docs/ru/manage-claude/cmek) доступно только с ключами [AWS KMS](https://platform.claude.com/docs/ru/manage-claude/cmek-aws-kms). Ключи Google Cloud KMS и Azure Key Vault зарегистрировать нельзя. Ключ должен быть однорегиональным ключом KMS в той же учётной записи и регионе AWS, что и рабочее пространство, к которому он прикреплён, а его политика ключа должна предоставлять доступ субъекту сервиса `aws-external-anthropic.amazonaws.com`; см. [Настройка CMEK в Claude Platform on AWS](https://platform.claude.com/docs/ru/manage-claude/cmek-claude-platform-on-aws). Регистрируйте и прикрепляйте ключи в [Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#using-the-claude-console); внешние конечные точки ключей также доступны и авторизуются через [действия IAM](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#encryption-keys). Отдельного шага проверки нет: ключ неявно проверяется при прикреплении к рабочему пространству (вызов прикрепления выполняет цикл шифрования/расшифровки), поэтому проблема с политикой ключа проявляется во время прикрепления, а не при регистрации.
* **Compliance API:** [Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-api) доступен. Доступ авторизуется через [действие `ListComplianceActivities`](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#compliance) AWS IAM.
Различия в доступности функций по сравнению с Amazon Bedrock см. в [сравнительной таблице](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#claude-platform-on-aws-vs-amazon-bedrock).
### Claude Managed Agents
[Claude Managed Agents](https://platform.claude.com/docs/ru/managed-agents/overview) доступен на Claude Platform on AWS, включая [агентов](https://platform.claude.com/docs/ru/managed-agents/agent-setup), [окружения](https://platform.claude.com/docs/ru/managed-agents/environments), [сеансы](https://platform.claude.com/docs/ru/managed-agents/sessions), [запланированные развёртывания](https://platform.claude.com/docs/ru/managed-agents/scheduled-deployments), [хранилища учётных данных](https://platform.claude.com/docs/ru/managed-agents/vaults), [хранилища памяти](https://platform.claude.com/docs/ru/managed-agents/memory), [вебхуки](https://platform.claude.com/docs/ru/managed-agents/webhooks), [мультиагентную оркестрацию](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration) и [самостоятельно размещаемые песочницы](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes).
Сеансы и самостоятельно размещаемые воркеры на Claude Platform on AWS отличаются от собственного Claude Managed Agents от Anthropic в трёх аспектах:
* **Повторная аутентификация автономных сеансов:** сеанс может работать автономно, без каких-либо [пользовательских событий](https://platform.claude.com/docs/ru/managed-agents/reference#event-types), до 6 часов. По истечении 6 часов сеанс требует повторной аутентификации, прежде чем продолжить работу. Чтобы пройти повторную аутентификацию, отправьте в сеанс любое событие с ролью пользователя (см. [События и потоковая передача](https://platform.claude.com/docs/ru/managed-agents/events-and-streaming)). В собственном Claude Managed Agents от Anthropic нет ограничения на время работы автономного сеанса.
* **[Хранилища памяти в самостоятельно размещаемых окружениях](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-memory):** сеанс, работающий в самостоятельно размещаемом окружении, не может подключать хранилища памяти; сеанс, включающий такое хранилище, отклоняется при создании. Сеансы в облачных окружениях подключают хранилища памяти как обычно. В собственном Claude Managed Agents от Anthropic сеансы как в облачных, так и в самостоятельно размещаемых окружениях могут подключать хранилища памяти.
* **[Аутентификация воркеров в самостоятельно размещаемых окружениях](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes#prerequisites):** воркер проходит аутентификацию с помощью AWS IAM (SigV4) или [ключа API, созданного в AWS Console](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#api-key-authentication), а не ключа окружения. Ключи окружения, созданные в Claude Console, не работают с эндпоинтом Claude Platform on AWS.
### Неподдерживаемые функции
Следующие возможности в настоящее время недоступны на Claude Platform on AWS:
* **Готовность к HIPAA:** программа Anthropic по готовности к HIPAA недоступна. См. [API и хранение данных](https://platform.claude.com/docs/ru/manage-claude/api-and-data-retention).
* **Наборы инструментов для использования компьютера и браузера:** `computer_toolset_20260801` и `browser_toolset_20260801` в настоящее время недоступны на Claude Platform on AWS. Бета-версии инструмента использования компьютера остаются доступными для моделей, перечисленных в разделе [Более ранние версии инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions).
- **Admin API:** доступны эндпоинты рабочих пространств (создание, получение, перечисление, обновление и архивирование в `/v1/organizations/workspaces`), эндпоинты внешних ключей (регистрация, получение, перечисление, обновление и удаление в `/v1/organizations/external_keys`, для [CMEK](https://platform.claude.com/docs/ru/manage-claude/cmek); ключи проверяются при подключении к рабочему пространству, а не через эндпоинт проверки) и [эндпоинты назначений телеметрии](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#telemetry-destinations). Другие эндпоинты Admin API (участники организации, участники рабочих пространств, приглашения, ключи API, отчёты об использовании, отчёты о затратах и отчёты об ограничениях скорости) в настоящее время недоступны. Вместо этого просматривайте данные об использовании и затратах в [Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#using-the-claude-console). Членством в организации управляет AWS IAM.
- **Управление участниками рабочих пространств:** добавление или удаление пользователей из отдельных рабочих пространств недоступно. Доступом управляют политики AWS IAM для ARN рабочих пространств.
- **Рабочее пространство Claude Code и Analytics API:** рабочее пространство Claude Code с автоматическими ограничениями скорости недоступно. Использование Claude Code отображается в общем представлении использования, а не на отдельном экране.
- **Аутентификация OAuth:** не поддерживается. Используйте аутентификацию SigV4 или с помощью ключа API.
- **Быстрый режим:** недоступен на Claude Platform on AWS.
- **Эндпоинты API, совместимые с OpenAI:** недоступны на Claude Platform on AWS.
- **Туннели MCP:** поддерживаются только серверы MCP, доступные через общедоступный интернет.
## Резидентность данных
Claude Platform on AWS поддерживает следующие географии инференса:
* **US:** инференс остаётся в пределах центров обработки данных в США. Применяется ценовой множитель 1,1x.
* **Global:** инференс может направляться в любой центр обработки данных Anthropic по всему миру. Применяются стандартные цены.
Регион AWS, к которому привязано ваше рабочее пространство, определяет, какой эндпоинт шлюза вы вызываете и в какой области действуют ресурсы на стороне AWS (IAM, CloudTrail, выставление счетов). Он не фиксирует место выполнения инференса модели. Чтобы закрепить инференс за определённой географией, задайте `inference_geo` в каждом запросе или настройте значение по умолчанию для рабочего пространства.
Задайте географию инференса для каждого запроса с помощью параметра `inference_geo`:
Параметр `inference_geo` поддерживается в моделях Claude 4.6 и более поздних. Запросы с `inference_geo` к Claude Opus 4.5, Claude Sonnet 4.5 (устаревшая) или Claude Haiku 4.5 возвращают ошибку 400. Подробнее о доступности моделей см. в разделе [Резидентность данных](https://platform.claude.com/docs/ru/manage-claude/data-residency).
```bash cURL
# Замените us-west-2 на ваш регион AWS как в URL, так и в --aws-sigv4
# Не указывайте заголовок x-amz-security-token, если используете долгосрочные учётные данные пользователя IAM
curl "https://aws-external-anthropic.us-west-2.api.aws/v1/messages" \
--aws-sigv4 "aws:amz:us-west-2:aws-external-anthropic" \
--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" \
-H "anthropic-workspace-id: $ANTHROPIC_AWS_WORKSPACE_ID" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"inference_geo": "us",
"messages": [
{"role": "user", "content": "Hello!"}
]
}'
```
```bash CLI
# Замените us-west-2 на ваш регион AWS
# ant считывает ANTHROPIC_API_KEY. Создайте ключ в консоли AWS
# (см. аутентификацию с помощью ключа API).
export ANTHROPIC_API_KEY="YOUR_AWS_API_KEY"
ant messages create \
--base-url https://aws-external-anthropic.us-west-2.api.aws \
--workspace-id "$ANTHROPIC_AWS_WORKSPACE_ID" \
--model claude-sonnet-5-5 \
--max-tokens 1024 \
--inference-geo us \
--message '{role: user, content: "Hello!"}'
```
```python Python
from anthropic import AnthropicAWS
client = AnthropicAWS()
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
inference_geo="us",
messages=[{"role": "user", "content": "Hello!"}],
)
print(message)
```
```typescript TypeScript
import AnthropicAws from "@anthropic-ai/aws-sdk";
const client = new AnthropicAws();
const message = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
inference_geo: "us",
messages: [{ role: "user", content: "Hello!" }]
});
console.log(message);
```
```csharp C#
using Anthropic;
using Anthropic.Aws;
var client = new AnthropicAwsClient();
var message = await client.Messages.Create(new()
{
Model = Model.ClaudeSonnet5_5,
MaxTokens = 1024,
InferenceGeo = "us",
Messages = [new UserMessageParam { Content = "Hello!" }]
});
Console.WriteLine(message);
```
```go Go
client, err := anthropicaws.NewClient(context.Background(), anthropicaws.ClientConfig{})
if err != nil {
panic(err)
}
message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
Model: anthropic.ModelClaudeSonnet5_5,
MaxTokens: 1024,
InferenceGeo: anthropic.String("us"),
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),
},
})
if err != nil {
panic(err)
}
fmt.Println(message)
```
```java Java
import com.anthropic.aws.backends.AwsBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Model;
void main() {
AnthropicClient client = AnthropicOkHttpClient.builder()
.backend(AwsBackend.fromEnv())
.build();
Message message = client.messages().create(
MessageCreateParams.builder()
.model(Model.CLAUDE_SONNET_5_5)
.maxTokens(1024)
.inferenceGeo("us")
.addUserMessage("Hello!")
.build()
);
IO.println(message);
}
```
```php PHP
use Anthropic\Aws\Client;
$client = new Client();
$message = $client->messages->create(
model: 'claude-sonnet-5-5',
maxTokens: 1024,
inferenceGeo: 'us',
messages: [['role' => 'user', 'content' => 'Hello!']],
);
echo $message;
```
```ruby Ruby
require "anthropic"
client = Anthropic::AWSClient.new
message = client.messages.create(
model: "claude-sonnet-5-5",
max_tokens: 1024,
inference_geo: "us",
messages: [{ role: "user", content: "Hello!" }]
)
puts message
```
Если вы опустите `inference_geo`, запрос использует значение `default_inference_geo` рабочего пространства, если оно настроено, в противном случае — `global`.
Элементы управления географией инференса на уровне рабочего пространства (`allowed_inference_geos` и `default_inference_geo`) также доступны на Claude Platform on AWS. См. [Ограничения на уровне рабочего пространства](https://platform.claude.com/docs/ru/manage-claude/data-residency#workspace-level-restrictions).
## Рабочие пространства
Запросы инференса и запросы к ресурсам на Claude Platform on AWS направляются в рабочее пространство. Вы передаёте идентификатор рабочего пространства в заголовке `anthropic-workspace-id` в этих вызовах API. Идентификаторы рабочих пространств используют формат с тегом: `wrkspc_`, за которым следует буквенно-цифровой идентификатор (например, `wrkspc_01AbCdEf23GhIj`). Если у вас его ещё нет, см. [Получение идентификатора рабочего пространства](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#obtain-your-workspace-id).
### Область действия рабочих пространств
Рабочие пространства привязаны к одному региону AWS. К рабочему пространству, созданному в `us-west-2`, можно получить доступ только через эндпоинт `us-west-2`. Использование, квоты, затраты, файлы, пакеты и Skills агрегируются по каждому рабочему пространству, что даёт вам разбивку по регионам в Claude Console.
Рабочие пространства также служат основным ресурсом IAM для Claude Platform on AWS. Вы предоставляете или запрещаете доступ к определённым рабочим пространствам с помощью политик AWS IAM, используя ARN рабочего пространства. Сегмент ресурса в ARN — это тот же идентификатор с префиксом `wrkspc_`, который вы передаёте в заголовке `anthropic-workspace-id`:
```text wrap
arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}
```
Например:
```text wrap
arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj
```
Примеры политик см. в разделе [Политики IAM](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#iam-policies).
### Управление рабочими пространствами
Создавайте дополнительные рабочие пространства, переименовывайте или архивируйте рабочее пространство на странице **Workspaces** в AWS Console или с помощью эндпоинтов рабочих пространств [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api). Этим эндпоинтам не требуется заголовок `anthropic-workspace-id`. Создание и перечисление действуют на уровне организации; получение, обновление и архивирование принимают идентификатор рабочего пространства в пути URL. Новое рабочее пространство привязывается к региону AWS эндпоинта, который вы вызываете для его создания (см. [Область действия рабочих пространств](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#workspace-scoping)). С ролью Admin вы также можете создавать, переименовывать и архивировать рабочие пространства на странице **Workspaces** в Claude Console.
## Использование Claude Console
Claude Platform on AWS использует стандартную Claude Console по адресу [platform.claude.com](https://platform.claude.com). Когда вы входите из AWS Console, в левом нижнем углу боковой панели Claude Console появляется индикатор **Account managed by AWS**, и Console ограничивается вашей организацией Claude Platform on AWS. Она предоставляет аналитику использования, разбивку затрат, просмотр ограничений скорости, управление рабочими пространствами, а также страницы для управления файлами, Agent Skills, пакетными заданиями и ресурсами Claude Managed Agents (агентами, сеансами, окружениями, хранилищами учётных данных, хранилищами памяти и вебхуками).
### Вход в систему
Доступ к Claude Console федерируется через AWS IAM. Полный процесс первого входа см. в разделе [Настройка учётной записи](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#set-up-your-account). Вкратце:
1. Примите роль IAM с разрешением `aws-external-anthropic:AssumeConsole`. См. [Действия IAM для Claude Platform on AWS](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#console-access).
2. Перейдите на страницу Claude Platform on AWS в [AWS Console](https://console.aws.amazon.com/).
3. Выберите **Open Claude Console**. AWS Console выдаёт JWT и перенаправляет вас на `platform.claude.com`.
4. При первом входе вам будет предложено ввести адрес электронной почты. Введите свой рабочий адрес. Платформа создаёт вашего пользователя Claude Console по принципу just-in-time.
Доступны две роли Claude Console: **Admin** и **Developer**. Роль Admin предоставляет доступ ко всем страницам и настройкам Claude Console, доступным для Claude Platform on AWS. Роль Developer предоставляет доступ на чтение к информации об использовании, затратах, ограничениях скорости и рабочих пространствах. Чтобы назначить субъекту роль Admin или Developer, обратитесь к своему представителю Anthropic.
### Доступные страницы
Столбец **Через шлюз AWS** указывает, читает и записывает ли страница данные через шлюз AWS (и, следовательно, регулируется ли она [действиями IAM](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions)). Страницы, отмеченные **Нет**, считывают метаданные уровня организации напрямую из Anthropic и обходят проверки действий IAM.
| Страница | Доступна | Через шлюз AWS | Примечания |
| --------------------- | ---------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Usage** | Да | Нет | Просмотр использования токенов по модели, рабочему пространству и измерению. Данные могут появиться через несколько минут после запроса. |
| **Cost** | Да | Нет | Просмотр разбивки затрат по модели и рабочему пространству. AWS Cost Explorer показывает агрегированную статью [Claude Consumption Unit (CCU)](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#billing). |
| **Rate limits** | Да | Нет | Просмотр ограничений скорости (только чтение). Повышение уровня выполняется через вашего представителя Anthropic; см. [Ограничения скорости и квоты](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas). |
| **Workspaces** | Да | Да (кроме лимитов расходов) | Просмотр рабочих пространств по регионам. С ролью Admin вы также можете создавать, переименовывать и архивировать рабочие пространства, а также задавать [лимиты расходов](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#spend-limits) для каждого рабочего пространства. |
| **Encryption keys** | Да | Да | Раздел страницы [Data retention](https://platform.claude.com/settings/privacy#encryption-keys) (`platform.claude.com/settings/privacy`) в Claude Console, отображаемый, когда в раскрывающемся меню в верхней части страницы выбрано **Organization**. Регистрируйте там ключи AWS KMS для [CMEK](https://platform.claude.com/docs/ru/manage-claude/cmek-claude-platform-on-aws) (роль Admin). Чтобы подключить зарегистрированный ключ к рабочему пространству, выберите рабочее пространство в этом раскрывающемся меню, затем выберите ключ в разделе **Encryption key**. |
| **Files** | Да | Да | Просмотр и управление загруженными файлами. |
| **Skills** | Да | Да | Просмотр и управление Agent Skills. |
| **Batches** | Да | Да | Просмотр и управление заданиями пакетной обработки. |
| **Agents** | Да | Да | Просмотр и управление определениями агентов. |
| **Sessions** | Да | Да | Просмотр сеансов агентов и истории событий. |
| **Environments** | Да | Да | Просмотр и управление конфигурациями облачных песочниц для сеансов. |
| **Credential vaults** | Да | Да | Просмотр и управление хранилищами учётных данных для аутентификации сеансов. |
| **Memory stores** | Да | Да | Просмотр и управление постоянной памятью агентов. |
| **Webhooks** | Да | Да | Просмотр и управление эндпоинтами вебхуков. |
| **API keys** | Нет | Н/Д | Управляйте ключами API в AWS Console (**Claude Platform on AWS → API keys**). См. [Аутентификация с помощью ключа API](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#api-key-authentication). |
| **Members** | Нет | Н/Д | Неприменимо. Доступом управляет AWS IAM. |
| **Billing** | Да (ограниченно) | Нет | Задайте ежемесячный лимит расходов организации; см. [Лимиты расходов](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#spend-limits). Выставлением счетов управляет AWS Marketplace. Просматривайте разбивку затрат на странице Cost. |
| **Claude Code** | Нет | Н/Д | Просматривайте использование Claude Code на странице Usage. |
### Переключение организаций
Claude Console не поддерживает переключение организаций для Claude Platform on AWS. Чтобы получить доступ к другой организации, выйдите из системы и пройдите повторную аутентификацию через AWS Console, используя роль IAM для учётной записи AWS этой организации.
## Ограничения скорости и квоты
Организации на Claude Platform on AWS размещаются на уровне Start. Anthropic управляет «rate limits» (ограничения скорости) напрямую, а не через системы квот AWS.
Организации на Claude Platform on AWS могут автоматически переходить на более высокий уровень использования по мере накопления истории оплаченных счетов AWS Marketplace. Процесс самообслуживания **Request tier increase** в Claude Console недоступен: вместо этого страница Rate limits направляет вас к вашему представителю Anthropic.
Чтобы запросить более высокие лимиты, обратитесь к своему представителю Anthropic или в [службу поддержки Anthropic](https://support.claude.com). Включите в запрос следующее:
* Модели, для которых нужно повысить лимиты
* Пиковое количество входных токенов в минуту и выходных токенов в минуту для каждой модели (не суточные итоги)
* Приблизительную долю ваших входных данных, которая является кэшированным или повторяющимся контекстом (чтения из кэша не учитываются в лимитах входных токенов для большинства моделей; см. [ITPM с учётом кэша](https://platform.claude.com/docs/ru/api/rate-limits#cache-aware-itpm))
Уровни использования — это фиксированные ступени: каждый уровень сочетает ограничения скорости с [ежемесячным пределом расходов](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#spend-limits), и переход на более высокий уровень повышает и то, и другое. Подробнее об уровнях и лимитах для каждой модели см. в разделе [Ограничения скорости](https://platform.claude.com/docs/ru/api/rate-limits).
## Выставление счетов
Счета за Claude Platform on AWS выставляются через [AWS Marketplace](https://aws.amazon.com/marketplace). Использование выражается в Claude Consumption Units (CCU), измеряется ежечасно и выставляется ежемесячно по факту в вашем счёте AWS. CCU не являются предоплаченными кредитами. Баланса CCU или обязательств нет.
Цену CCU, механизм пересчёта, применение скидок и тарифы на токены для каждой модели см. в разделе [Цены Claude Platform on AWS](https://platform.claude.com/docs/ru/about-claude/pricing#claude-platform-on-aws-pricing).
### Лимиты расходов
Каждый из уровней использования Start, Build и Scale имеет ежемесячный предел расходов; текущие значения см. в разделе [пределы расходов по уровням](https://platform.claude.com/docs/ru/api/rate-limits#spend-limits). Когда использование вашей организации за календарный месяц достигает предела её уровня, запросы API завершаются [ошибкой превышения предела расходов](https://platform.claude.com/docs/ru/api/rate-limits#reaching-your-spend-cap) до 00:00 UTC первого дня следующего месяца, и повторные попытки раньше этого срока не увенчаются успехом. Предел расходов и ограничения скорости относятся к одному и тому же уровню. Чтобы повысить предел или восстановить доступ после его достижения, запросите повышение уровня через своего представителя Anthropic или [службу поддержки Anthropic](https://support.claude.com) (см. [Ограничения скорости и квоты](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)).
Вы также можете задать собственные ежемесячные лимиты расходов ниже предела, предварительно добавив хотя бы одного получателя в разделе **Email recipients** на странице Billing:
* **Лимит расходов организации:** перейдите в [Settings > Billing](https://platform.claude.com/settings/billing) в [Claude Console](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#using-the-claude-console), чтобы задать ежемесячный лимит расходов.
* **Лимиты расходов рабочих пространств:** на странице [Workspaces](https://platform.claude.com/settings/workspaces) (`platform.claude.com/settings/workspaces`) в Claude Console выберите рабочее пространство. В открывшейся панели нажмите **Spend limits**.
Когда использование достигает заданного вами лимита, запросы завершаются ошибкой HTTP 400 (см. [ошибку лимита расходов](https://platform.claude.com/docs/ru/api/rate-limits#setting-your-own-spend-limit)) до 00:00 UTC первого дня следующего месяца или до тех пор, пока вы не повысите или не удалите лимит.
Расходы рассчитываются по прейскурантным ценам, и отражение недавнего использования может занять около 2 часов, поэтому использование может превысить предел или лимит до того, как запросы начнут завершаться ошибкой. Превышение оплачивается. Когда предел уровня или лимит расходов организации останавливает ваши запросы, уведомление по электронной почте отправляется получателям, указанным в разделе **Email recipients** на странице Billing. Получатели на основе ролей, например все администраторы, недоступны на Claude Platform on AWS. Уведомление о пределе уровня также отправляется на адрес электронной почты, использованный при регистрации в AWS Marketplace.
## Мониторинг и журналирование
AWS CloudTrail может фиксировать все запросы к Claude Platform on AWS. Операции с рабочими пространствами, внешними ключами, назначениями телеметрии, соответствием требованиям, хранилищами учётных данных и вебхуками по умолчанию журналируются как события управления (Management events). Операции инференса, пакетов, файлов, навыков, моделей, профилей пользователей и Claude Managed Agents (кроме хранилищ учётных данных и вебхуков) классифицируются как события данных (Data events) и требуют явной настройки журналирования событий данных, что влечёт дополнительные расходы на CloudTrail. Полную классификацию типов событий см. в [справочнике по действиям IAM](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#route-to-action-mapping), а подробности настройки — в [документации AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
### Идентификаторы запросов
Каждый ответ содержит два идентификатора запроса в заголовках ответа:
* **Идентификатор запроса AWS (`x-amzn-requestid`):** основной идентификатор, индексируемый в CloudTrail. Используйте его при исследовании запросов с помощью инструментов AWS или при обращении в службу поддержки AWS.
* **Идентификатор запроса Anthropic (`request-id`):** дополнительный идентификатор. Используйте его при обращении в службу поддержки Anthropic.
```bash cURL
# Замените us-west-2 на ваш регион AWS как в URL, так и в --aws-sigv4
# -i включает заголовки ответа в вывод
# Не указывайте заголовок x-amz-security-token, если используете долгосрочные учётные данные пользователя IAM
curl -i "https://aws-external-anthropic.us-west-2.api.aws/v1/messages" \
--aws-sigv4 "aws:amz:us-west-2:aws-external-anthropic" \
--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" \
-H "anthropic-workspace-id: $ANTHROPIC_AWS_WORKSPACE_ID" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Hello!"}
]
}'
```
```bash CLI
# Замените us-west-2 на ваш регион AWS
# ant считывает ANTHROPIC_API_KEY. Создайте ключ в AWS Console
# (см. аутентификацию по ключу API).
export ANTHROPIC_API_KEY="YOUR_AWS_API_KEY"
# --debug выводит HTTP-ответ, включая заголовки X-Amzn-Requestid и
# Request-Id, в stderr
ant --debug messages create \
--base-url https://aws-external-anthropic.us-west-2.api.aws \
--workspace-id "$ANTHROPIC_AWS_WORKSPACE_ID" \
--model claude-sonnet-5-5 \
--max-tokens 1024 \
--message '{role: user, content: "Hello!"}'
```
```python Python
from anthropic import AnthropicAWS
client = AnthropicAWS()
response = client.messages.with_raw_response.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(response.headers.get("x-amzn-requestid")) # AWS request ID
print(response.headers.get("request-id")) # Anthropic request ID
message = response.parse()
print(message.content)
```
```typescript TypeScript
import AnthropicAws from "@anthropic-ai/aws-sdk";
const client = new AnthropicAws();
const { data: message, response } = await client.messages
.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello!" }]
})
.withResponse();
console.log(response.headers.get("x-amzn-requestid")); // AWS request ID
console.log(response.headers.get("request-id")); // Anthropic request ID
console.log(message.content);
```
```csharp C#
using Anthropic;
using Anthropic.Aws;
var client = new AnthropicAwsClient();
var response = await client.WithRawResponse.Messages.Create(new()
{
Model = Model.ClaudeSonnet5_5,
MaxTokens = 1024,
Messages = [new UserMessageParam { Content = "Hello!" }]
});
Console.WriteLine(response.Headers.GetValues("x-amzn-requestid").First()); // AWS request ID
Console.WriteLine(response.Headers.GetValues("request-id").First()); // Anthropic request ID
Console.WriteLine(response.Value.Content);
```
```go Go
client, err := anthropicaws.NewClient(context.Background(), anthropicaws.ClientConfig{})
if err != nil {
panic(err)
}
var response *http.Response
message, err := client.Messages.New(
context.Background(),
anthropic.MessageNewParams{
Model: anthropic.ModelClaudeSonnet5_5,
MaxTokens: 1024,
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),
},
},
option.WithResponseInto(&response),
)
if err != nil {
panic(err)
}
fmt.Println(response.Header.Get("x-amzn-requestid")) // AWS request ID
fmt.Println(response.Header.Get("request-id")) // Anthropic request ID
fmt.Println(message.Content)
```
```java Java
import com.anthropic.aws.backends.AwsBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.core.http.HttpResponseFor;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Model;
void main() {
AnthropicClient client = AnthropicOkHttpClient.builder()
.backend(AwsBackend.fromEnv())
.build();
HttpResponseFor response = client.messages().withRawResponse().create(
MessageCreateParams.builder()
.model(Model.CLAUDE_SONNET_5_5)
.maxTokens(1024)
.addUserMessage("Hello!")
.build()
);
IO.println(response.headers().values("x-amzn-requestid").get(0)); // AWS request ID
IO.println(response.requestId().orElse(null)); // Anthropic request ID
IO.println(response.parse().content());
}
```
```php PHP
use Anthropic\Aws\Client;
$client = new Client();
$response = $client->messages->raw->create(
model: 'claude-sonnet-5-5',
maxTokens: 1024,
messages: [['role' => 'user', 'content' => 'Hello!']],
);
echo $response->getHeaderLine('x-amzn-requestid') . "\n"; // AWS request ID
echo $response->getHeaderLine('request-id') . "\n"; // Anthropic request ID
echo $response->parse()->content;
```
```ruby Ruby
require "anthropic"
client = Anthropic::AWSClient.new
# Читайте заголовки ответа в middleware для каждого запроса, которое получает
# необработанный HTTP-ответ до того, как SDK его разберёт
aws_request_id = nil
anthropic_request_id = nil
read_request_ids = lambda do |request, call_next|
response = call_next.call(request)
# Ключи в response.headers записаны в нижнем регистре
aws_request_id = response.headers["x-amzn-requestid"]
anthropic_request_id = response.headers["request-id"]
response
end
message = client.messages.create(
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello!" }],
request_options: { middleware: [read_request_ids] }
)
puts aws_request_id # AWS request ID
puts anthropic_request_id # Anthropic request ID
puts message.content
```
Anthropic рекомендует журналировать вашу активность как минимум за скользящий 30-дневный период, чтобы понимать закономерности использования и расследовать проблемы.
AWS CloudTrail настраивается в вашей учётной записи AWS. Включение журналирования не предоставляет AWS или Anthropic доступ к вашему контенту сверх того, что необходимо для выставления счетов и работы сервиса.
## Миграция с Amazon Bedrock
Если вы в настоящее время используете Claude в Bedrock, миграция на Claude Platform on AWS требует изменений во всей вашей интеграции. Подпись SigV4 по-прежнему поддерживается, но контекст подписи, базовый URL, формат API, идентификаторы моделей, клиент и пакет SDK, формат «streaming» (потоковая передача), заголовки запросов и доступность регионов — всё это меняется. Claude Platform on AWS также создаёт новую организацию Anthropic. В следующей таблице обобщены различия.
### Что меняется
Объём изменений при миграции зависит от того, с какой интеграции Bedrock вы переходите. В следующей таблице показаны как [текущая интеграция Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock) (Messages API по адресу `bedrock-mantle.{region}.api.aws`), так и [устаревшая интеграция InvokeModel](https://platform.claude.com/docs/ru/build-with-claude/claude-on-amazon-bedrock-legacy).
| Аспект | С [Claude in Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock) | С [Amazon Bedrock (Opus 4.6 и более ранние)](https://platform.claude.com/docs/ru/build-with-claude/claude-on-amazon-bedrock-legacy) | На Claude Platform on AWS |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Базовый URL** | `bedrock-mantle.{region}.api.aws` | `bedrock-runtime.{region}.amazonaws.com` | `aws-external-anthropic.{region}.api.aws` |
| **Формат API** | Messages API по адресу `/anthropic/v1/messages` | Bedrock Converse / InvokeModel | Claude API (`/v1/{endpoint}`) |
| **Идентификаторы моделей** | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-4-5-20251001-v1:0 (с префиксом профиля инференса `us.` или `global.`) | claude-haiku-4-5 |
| **Клиент SDK** | `AnthropicBedrockMantle` | `AnthropicBedrock` / Bedrock SDK | Клиент для конкретной платформы (см. [Установка SDK](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#install-an-sdk)), в бета-версии |
| **Пакет SDK** | `anthropic[bedrock]` (typescript: `@anthropic-ai/bedrock-sdk`; csharp: `Anthropic.Bedrock`; go: `github.com/anthropics/anthropic-sdk-go/bedrock`; java: `com.anthropic:anthropic-java-bedrock`; php: `anthropic-ai/sdk`; ruby: `anthropic`) | `anthropic[bedrock]` (typescript: `@anthropic-ai/bedrock-sdk`; csharp: `Anthropic.Bedrock`; go: `github.com/anthropics/anthropic-sdk-go/bedrock`; java: `com.anthropic:anthropic-java-bedrock`; php: `anthropic-ai/sdk`; ruby: `anthropic`) или AWS SDK | `anthropic[aws]` (typescript: `@anthropic-ai/aws-sdk`; csharp: `Anthropic.Aws`; go: `github.com/anthropics/anthropic-sdk-go/aws`; java: `com.anthropic:anthropic-java-aws`; php: `anthropic-ai/sdk`; ruby: `anthropic`) (см. [Установка SDK](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#install-an-sdk)) |
| **Имя сервиса SigV4** | `bedrock-mantle` | `bedrock` | `aws-external-anthropic` |
| **Формат потоковой передачи** | SSE | AWS EventStream | SSE (как в Claude API) |
| **Заголовок рабочего пространства** | Неприменимо | Неприменимо | `anthropic-workspace-id`, обязателен для запросов инференса и запросов к ресурсам |
| **Доступность регионов** | См. [регионы Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-regions.html) | См. [регионы Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-regions.html) | Все коммерческие регионы AWS |
| **Организация Anthropic** | Не требуется | Не требуется | Новая организация создаётся при регистрации. Существующие организации нельзя преобразовать (см. [Переход с существующей организации Anthropic](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#moving-from-an-existing-anthropic-organization)) |
Если вы используете текущую интеграцию Bedrock, формат тела запроса уже соответствует Messages API. Изменения касаются базового URL, имени сервиса SigV4, идентификаторов моделей и добавления заголовка `anthropic-workspace-id`. Если вы используете устаревший InvokeModel или Converse API, вам также потребуется переписать структуры запросов и ответов в формат Messages API. Сопоставление структур запросов см. в разделе [Claude в Amazon Bedrock (Opus 4.6 и более ранние)](https://platform.claude.com/docs/ru/build-with-claude/claude-on-amazon-bedrock-legacy).
### Что вы получаете
* Как правило, доступ к новым моделям и функциям в день их выпуска (см. [ограничения функций](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#features-not-supported))
* Agent Skills для создания документов (PowerPoint, Excel, Word, PDF)
* Выполнение кода в управляемой песочнице Anthropic
* Бета-функции Claude API, которые не предлагает Amazon Bedrock, через заголовок `anthropic-beta` (см. [ограничения функций](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#features-not-supported))
* Claude Console для просмотра квот и аналитики использования
* Прямую поддержку Anthropic
* Аутентификацию с помощью ключа API как альтернативу SigV4 (см. [Аутентификация с помощью ключа API](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#api-key-authentication))
### Что остаётся прежним
* Аутентификация AWS IAM (SigV4)
* AWS как сторона, выставляющая счета. Канал выставления счетов меняется с собственного сервиса AWS на AWS Marketplace (см. [Коммерческие аспекты](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#commercial-considerations)).
* Погашение обязательств AWS
### Подводные камни миграции
**Сначала включите исходящую федерацию веб-удостоверений.** Если ваша учётная запись AWS ранее не использовала Claude Platform on AWS, вы должны [включить исходящую федерацию веб-удостоверений](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation) один раз для каждой учётной записи, прежде чем отправлять запросы. Без этого шага все запросы завершаются ошибкой федерации (точную ошибку и способ её устранения см. в разделе [Включение исходящей федерации веб-удостоверений](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation)). Для Bedrock этот шаг не требуется.
**Zero Data Retention (ZDR) на Claude Platform on AWS включается по запросу.** В Bedrock обработчиком данных является AWS, и Anthropic не хранит входные или выходные данные инференса. Программа ZDR от Anthropic там не применяется. На Claude Platform on AWS Anthropic обрабатывает данные инференса как независимый обработчик данных, и ZDR следует модели собственного Claude API от Anthropic: она доступна по запросу через вашего представителя Anthropic. Подтвердите участие в ZDR перед миграцией производственных рабочих нагрузок, которые зависят от гарантий хранения данных.
### Коммерческие аспекты
* **Условия обслуживания Anthropic:** использование Claude Platform on AWS требует принятия Коммерческих условий обслуживания и Политики использования Anthropic. Если ваша организация ещё не приняла их (например, если вы использовали Claude только через Bedrock), вам будет предложено сделать это во время настройки учётной записи. См. [Настройка учётной записи](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#set-up-your-account).
* **Скидки и частные предложения:** согласованные скидки и частные предложения AWS Marketplace не переносятся автоматически между Bedrock и Claude Platform on AWS. Обратитесь к своему представителю Anthropic, чтобы настроить коммерческие условия для Claude Platform on AWS.
## Политики IAM
Claude Platform on AWS интегрируется с AWS IAM для управления доступом. Вы предоставляете или запрещаете доступ к определённым действиям API в определённых рабочих пространствах, используя стандартный синтаксис политик IAM.
Имя сервиса SigV4 и пространство имён действий IAM — `aws-external-anthropic`. Действия следуют шаблону `aws-external-anthropic:` (например, `aws-external-anthropic:CreateInference`).
### Пример: запрет пакетного инференса
Следующая политика разрешает инференс в реальном времени, блокируя пакетную обработку:
```json
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-external-anthropic:CreateInference",
"aws-external-anthropic:CountTokens",
"aws-external-anthropic:GetModel",
"aws-external-anthropic:ListModels",
"aws-external-anthropic:GetWorkspace"
],
"Resource": "arn:aws:aws-external-anthropic:*:*:workspace/*"
},
{
"Effect": "Allow",
"Action": "aws-external-anthropic:ListWorkspaces",
"Resource": "*"
},
{
"Effect": "Deny",
"Action": [
"aws-external-anthropic:CreateBatchInference",
"aws-external-anthropic:GetBatchInference",
"aws-external-anthropic:ListBatchInferences"
],
"Resource": "*"
}
]
}
```
Действие `GetBatchInference` авторизует как маршрут метаданных пакета, так и маршрут результатов пакета. Его запрет блокирует оба чтения. Политику, содержащую только запреты и подходящую для рабочих нагрузок, чувствительных к ZDR, см. в разделе [Блокировка функций для рабочего пространства, чувствительного к ZDR](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#feature-lockdown-for-a-zdr-sensitive-workspace).
`ListWorkspaces` действует на уровне учётной записи, поэтому оно указано в отдельном операторе Allow с `"Resource": "*"`. Указание ARN рабочего пространства для действия уровня учётной записи не имеет эффекта (см. [Автоматизация подготовки](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#provisioning-automation)).
Эта политика предполагает аутентификацию AWS SigV4. Если субъект проходит аутентификацию с помощью ключа API, также добавьте `aws-external-anthropic:CallWithBearerToken` в оператор Allow с `"Resource": "*"`. `CallWithBearerToken` — это действие уровня аутентификации без маршрута, которое не привязывается к ARN рабочего пространства. Шаблон с двумя операторами см. в разделе [Изоляция рабочих пространств для каждого клиента](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#per-customer-workspace-isolation).
### Управляемые политики
AWS предоставляет пять управляемых политик (`AnthropicFullAccess`, `AnthropicReadOnlyAccess`, `AnthropicInferenceAccess`, `AnthropicLimitedAccess` и `AnthropicSelfHostedEnvironmentAccess`) для распространённых шаблонов доступа. Действия, предоставляемые каждой политикой, полный список действий IAM, сопоставление маршрутов с действиями и дополнительные примеры политик см. в разделе [Действия IAM для Claude Platform on AWS](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#managed-policies).
## Следующие шаги
Изучите расширенные функции и возможности Claude.
Узнайте о ценах Claude Platform on AWS и тарифах Claude Consumption Unit.
По мере выпуска более безопасных и функциональных моделей Anthropic регулярно выводит из эксплуатации старые. Просмотрите все выводы из эксплуатации в API вместе с рекомендуемыми заменами.
## Дополнительные ресурсы
Просматривайте использование, затраты и рабочие пространства в Claude Console. Входите через AWS Console.
Используйте Claude под управлением AWS, если вам нужно, чтобы AWS был единственным обработчиком данных.
Управляйте своей подпиской AWS Marketplace и выставлением счетов.