---
title: Claude Platform на AWS
url: https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws
description: Получите доступ ко всем возможностям платформы Claude через AWS на инфраструктуре, управляемой Anthropic.
---
Claude Platform on AWS предоставляет вам полноценные возможности платформы Anthropic через вашу учетную запись AWS, включая Messages API, Agent Skills, выполнение кода и бета-функции. В [Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock) стеком «inference» (инференса) управляет 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 от Anthropic. «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 от Anthropic не может стать организацией 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 от Anthropic. Меняются базовый 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 от Anthropic, за исключением случаев, указанных в разделе [ограничения функций](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 издателя (issuer) для вашей учетной записи:
```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» (подпись версии 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
Если рабочей нагрузке нужно передать учетные данные отдельному процессу (например, шлюзу «large language model» (большой языковой модели), или LLM, бессерверной функции или инструменту, который поддерживает аутентификацию с bearer-токеном, но не SigV4), не создавайте долгосрочный ключ в AWS Console, а сгенерируйте краткосрочный ключ API на основе своих учетных данных AWS.
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 через стандартную цепочку поставщиков и возвращает токен с ограниченным сроком действия, который работает с заголовком `x-api-key`. По умолчанию срок действия токена составляет 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`) → заголовок `x-api-key`
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` → заголовок `x-api-key`
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:2.73.0")
implementation("com.anthropic:anthropic-java-aws:2.73.0")
```
```xml Maven
com.anthropic
anthropic-java
2.73.0
com.anthropic
anthropic-java-aws
2.73.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 от Anthropic. ARN в стиле Bedrock и префиксы `anthropic.` не используются.
Новые модели, как правило, появляются в Claude Platform on AWS в тот же день, что и в собственном Claude API от Anthropic.
Переходите на более новую модель 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).
## Выполнение запросов
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 и отправляет его как x-api-key. Создайте ключ в
# AWS Console (см. раздел об аутентификации с помощью ключа 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!"}' \
--transform content
```
```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() { Role = Role.User, 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 от Anthropic. Ограничения для каждой модели см. в разделе [Контекстные окна](https://platform.claude.com/docs/ru/build-with-claude/context-windows).
## Поддержка функций
Claude Platform on AWS напрямую использует конечные точки Claude API, поэтому набор функций полностью совпадает с собственным Claude API от Anthropic (за исключениями, указанными в разделе [ограничения функций](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) доступны, кроме наборов инструментов для использования компьютера и браузера; см. [Неподдерживаемые функции](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:** загружайте файлы и ссылайтесь на них в разных запросах.
* **«Customer-managed encryption keys» (ключи шифрования, управляемые клиентом), или 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-aws-kms#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 в трёх аспектах:
* **Повторная аутентификация автономных сессий:** сессия может работать автономно, без каких-либо [пользовательских событий](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 нет ограничения на время работы автономных сессий.
* **[Хранилища памяти в самостоятельно размещаемых окружениях](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-memory):** сессия, работающая в самостоятельно размещаемом окружении, не может прикреплять хранилища памяти; сессия, включающая такое хранилище, отклоняется при создании. Сессии в облачных окружениях прикрепляют хранилища памяти как обычно. В собственном Claude Managed Agents сессии как в облачных, так и в самостоятельно размещаемых окружениях могут прикреплять хранилища памяти.
* **[Аутентификация воркеров в самостоятельно размещаемых окружениях](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 поддерживает следующие «inference geographies» (географии инференса):
* **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 и отправляет его как x-api-key. Создайте ключ в
# AWS Console (см. раздел об аутентификации с помощью ключа 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!"}' \
--transform content
```
```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() { Role = Role.User, 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 адресуются рабочему пространству. В этих вызовах API вы передаёте ID рабочего пространства в заголовке `anthropic-workspace-id`. ID рабочего пространства имеет формат с тегом: `wrkspc_`, за которым следует буквенно-цифровой идентификатор (например, `wrkspc_01AbCdEf23GhIj`). Если у вас ещё нет этого ID, см. раздел [Получение ID рабочего пространства](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. Для этого используется «Amazon Resource Name» (имя ресурса Amazon), или ARN, рабочего пространства. Сегмент ресурса в ARN — это тот же ID с префиксом `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`. Операции создания и получения списка действуют на уровне организации. Операции получения, обновления и архивирования принимают 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. В ней доступны:
* аналитика использования и разбивка затрат;
* просмотр «rate limits» (ограничений скорости);
* управление рабочими пространствами;
* страницы для управления файлами, 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 субъекту (principal), обратитесь к представителю 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» (единица потребления Claude), или 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-aws-kms#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 управляет ограничениями скорости напрямую, а не через системы квот 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 Unit (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 есть ежемесячный «spend cap» (потолок расходов). Текущие значения см. в разделе [потолки расходов по уровням](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)).
Вы также можете задать собственные ежемесячные «spend limits» (лимиты расходов) ниже потолка. Сначала добавьте хотя бы одного получателя в разделе **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/).
### ID запросов
Каждый ответ содержит в заголовках два ID запроса:
* **ID запроса AWS (`x-amzn-requestid`):** основной ID, индексируемый в CloudTrail. Используйте его при расследовании запросов с помощью инструментов AWS или при обращении в службу поддержки AWS.
* **ID запроса Anthropic (`request-id`):** дополнительный 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 и отправляет его как x-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() { Role = Role.User, 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
# Читайте заголовки ответа в промежуточном ПО для каждого запроса, которое получает
# необработанный 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 и ID моделей;
* клиент и пакет 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`. Если вы используете устаревший API InvokeModel или Converse, вам также потребуется переписать структуры запросов и ответов в формат 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 commitment retirement)
### Подводные камни миграции
**Сначала включите исходящую федерацию веб-удостоверений.** Если ваша учётная запись 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 включается только по запросу (opt-in).** В Bedrock обработчиком данных является AWS, и Anthropic не хранит входные и выходные данные инференса, поэтому программа ZDR от Anthropic там не применяется. В Claude Platform on AWS Anthropic обрабатывает данные инференса как независимый обработчик данных. Поэтому ZDR работает так же, как в собственном Claude API: её можно получить по запросу через представителя 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. Чтобы согласовать коммерческие условия для Claude Platform on AWS, обратитесь к представителю Anthropic, который ведёт вашу учётную запись.
## Политики IAM
Claude Platform on AWS интегрируется с AWS IAM для управления доступом. С помощью стандартного синтаксиса политик IAM вы предоставляете или запрещаете доступ к определённым действиям API в определённых рабочих пространствах.
Имя сервиса 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` авторизует два маршрута: маршрут метаданных пакета и маршрут результатов пакета. Запрет этого действия блокирует оба чтения. Политика только с запретами (Deny), подходящая для рабочих нагрузок с требованиями 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 для Claude Platform on AWS](https://platform.claude.com/docs/ru/api/claude-platform-on-aws-iam-actions#managed-policies) описаны:
* действия, которые предоставляет каждая политика;
* полный список действий IAM;
* сопоставление маршрутов с действиями;
* дополнительные примеры политик.
## Следующие шаги
Изучите расширенные функции и возможности Claude.
Узнайте о ценах Claude Platform on AWS и тарифах Claude Consumption Unit.
С выходом более безопасных и функциональных моделей Anthropic регулярно выводит из эксплуатации старые. Здесь собраны все случаи устаревания в API и рекомендуемые замены.
## Дополнительные ресурсы
Просматривайте использование, затраты и рабочие пространства в Claude Console. Вход выполняется через AWS Console.
Используйте Claude под управлением AWS, если единственным обработчиком данных должен быть AWS.
Управляйте подпиской и выставлением счетов в AWS Marketplace.