Claude Platform на AWS

Claude Platform on AWS предоставляет вам полный опыт работы с платформой Anthropic, включая Messages API, Agent Skills, выполнение кода и бета-функции, доступные через вашу учётную запись AWS. В отличие от Amazon Bedrock, где AWS управляет стеком инференса, Claude Platform on AWS управляется Anthropic. AWS предоставляет уровень аутентификации (SigV4 или ключ API), управление доступом на основе IAM и интеграцию биллинга через AWS Marketplace.



Как работает интеграция платформы

Модели Claude работают на инфраструктуре, управляемой Anthropic. Это коммерческая интеграция для биллинга и доступа через AWS. Anthropic является обработчиком данных для входных и выходных данных инференса. AWS обрабатывает метаданные биллинга и идентификации в рамках модели маркетплейса. Клиенты, использующие Claude через Claude Platform on AWS, подпадают под действие условий использования данных Anthropic.

Claude Platform on AWS имеет следующие операционные характеристики: данные могут не находиться в AWS, инференс может маршрутизироваться в основное облако Anthropic, а подсервисы могут изменяться без уведомления. Устанавливайте параметр inference_geo для каждого запроса, чтобы закрепить инференс за определённой географией.

Claude Platform on AWS следует той же политике хранения данных, что и собственный Claude API. Zero Data Retention (ZDR) доступен по запросу. Свяжитесь с вашим представителем Anthropic, чтобы включить его для вашей организации.



Claude Platform on AWS и Amazon Bedrock

Оба предложения позволяют использовать Claude через AWS, но они различаются архитектурой, поверхностью API и доступностью функций.

Если вам нужен Claude, управляемый AWS, см. Claude in Amazon Bedrock. Claude Platform on AWS использует отдельный пул мощностей как от собственного Claude API, так и от Amazon Bedrock. Вы можете запускать рабочие нагрузки на нескольких платформах и переключаться между ними при сбоях.

AWS PrivateLink поддерживается для подключения вашего VPC к конечной точке Claude Platform on AWS.

Когда выбирать Bedrock: Организации в регулируемых отраслях, которым требуется соответствие FedRAMP High, IL4, IL5 или готовность к HIPAA, или которым нужно, чтобы AWS был единственным обработчиком данных, должны использовать Claude in Amazon Bedrock. Bedrock полностью работает на инфраструктуре, контролируемой AWS, где AWS является управляющей стороной.

Какое предложение вы используете? Claude доступен через несколько различных продуктов:

• Claude Platform on AWS (эта страница): Платформа Claude API с биллингом через AWS Marketplace. Управляется в Claude Console и AWS Console.
• Claude in Amazon Bedrock: Нативный сервис AWS. Управляется в консоли Amazon Bedrock и оплачивается как использование сервиса AWS.
• Claude Enterprise, приобретённый через AWS Marketplace: План claude.ai (чат-продукт Claude), а не платформа API. Управляется на claude.ai, и его поведение в отношении учётных записей и миграции отличается от описанного на этой странице. См. Справочный центр Claude.
• Прямые учётные записи Anthropic: Собственный Claude API и планы claude.ai, оплачиваемые через Anthropic. Управляются в Claude Console и на claude.ai.



Настройка учётной записи

Настройка Claude Platform on AWS происходит в четыре этапа: регистрация на странице сервиса в AWS Console, завершение настройки организации Anthropic, запись идентификатора рабочего пространства и вход в Claude Console.



Переход из существующей организации Anthropic

Регистрация в Claude Platform on AWS всегда создаёт новую организацию Anthropic, привязанную к вашей учётной записи AWS. Преобразование на месте невозможно: существующая организация, например организация собственного Claude API, не может стать организацией Claude Platform on AWS.

Планируйте переход из существующей организации как переключение на новую:

• Сначала создайте новую организацию. Зарегистрируйтесь через AWS Console (см. Настройка учётной записи). Если ваш переход включает частное предложение, завершите регистрацию до принятия предложения: скидки применяются с момента принятия, а не задним числом. См. Частные предложения.
• Воссоздайте доступ и конфигурацию. Ключи API, рабочие пространства и настройки Claude Console не переносятся из существующей организации. Создайте рабочие пространства в новой организации и переключите ваши приложения на аутентификацию Claude Platform on AWS.
• Обновите вашу интеграцию. Claude Platform on AWS обслуживает Claude API (/v1/{endpoint}), поэтому форматы запросов и ответов не отличаются от собственного Claude API. Изменяются базовый URL, метод аутентификации и обязательный заголовок anthropic-workspace-id; см. Выполнение запросов. Некоторые функции платформы отличаются; см. Неподдерживаемые функции.
• Переключайтесь по собственному графику. Новая организация независима от существующей, и обе могут обслуживать трафик параллельно. Нет необходимости в жёстком переключении: переносите рабочие нагрузки постепенно, пока весь ваш трафик не окажется в новой организации.

Как только новая организация заработает, различия сосредоточены в биллинге и аутентификации, которые обрабатываются через AWS:

• Биллинг переходит в AWS Marketplace: использование оплачивается в Claude Consumption Units, а не предоплаченными кредитами (см. Биллинг), а лимиты расходов управляются на странице Billing, а не на странице Limits (см. Лимиты расходов). Во время перехода биллинг остаётся раздельным: существующая организация продолжает оплачиваться так же, как и сегодня.
• Аутентификация и доступ переходят в AWS: запросы аутентифицируются с помощью учётных данных AWS или ключей API, сгенерированных в AWS Console, а не в Claude Console (см. Аутентификация). Членство в организации управляется через AWS IAM, а не через Claude Console (см. Доступные страницы), а клиентские SDK Anthropic предоставляют специфичные для платформы классы клиентов (см. Установка SDK).
• Повседневное использование API работает так же, как и в собственном Claude API, за исключением случаев, отмеченных в ограничениях функций. Перед переносом производственного трафика проверьте ваши ограничения скорости: новые организации помещаются на уровень Start, а увеличение лимитов осуществляется через вашего представителя Anthropic (см. Ограничения скорости и квоты).

Для организаций Claude Enterprise (claude.ai), которые ведут себя иначе, см. сравнение предложений.



Устранение неполадок при настройке учётной записи

• «Sign-up failed: Failed to enable OutboundWebIdentityFederation»: Если вы видите этот баннер при первой отправке, выберите Continue ещё раз. Включение IAM может занять некоторое время.
• Нет индикатора прогресса во время регистрации: Регистрация занимает несколько минут. Страница показывает статический баннер Sign-up in progress без индикатора прогресса, пока AWS создаёт вашу учётную запись.
• «Signed in as a different account» после перехода по ссылке настройки: Выберите Log out and continue. Страница повторно аутентифицирует вас с введённым адресом электронной почты.
• Сообщение «Not found» во время входа: Это сообщение может ненадолго появиться во время перенаправления. Вы можете его закрыть.
• Страница Usage не показывает данные после вашего первого вызова API: Данные об использовании могут появиться в Claude Console через несколько минут.
• «Outbound web identity federation is disabled» при первом вызове API: Включите федерацию один раз для каждой учётной записи. См. Включение исходящей федерации веб-идентификации.



Перед выполнением вызовов API

Убедитесь, что у вас есть:

1. Активная учётная запись AWS с подпиской на Claude Platform on AWS (см. Настройка учётной записи)
2. Установленный и настроенный AWS CLI
3. Включённая исходящая федерация веб-идентификации в вашей учётной записи AWS — одноразовый шаг настройки (см. Включение исходящей федерации веб-идентификации)
4. Идентификатор вашего рабочего пространства (см. Получение идентификатора рабочего пространства)
5. Разрешение IAM для вызова API: действие aws-external-anthropic:CreateInference для вашего рабочего пространства, плюс aws-external-anthropic:CallWithBearerToken, если вы аутентифицируетесь с помощью ключа API (см. Политики IAM)



Включение исходящей федерации веб-идентификации

Шлюз Claude Platform on AWS вызывает sts:GetWebIdentityToken на стороне сервера для создания JWT, который он пересылает в Anthropic. Эта возможность STS отключена по умолчанию в каждой учётной записи AWS. Включите её один раз для каждой учётной записи:

aws iam enable-outbound-web-identity-federation

Если ответ — [ERROR] (FeatureEnabled) ... already enabled, настройка уже включена для вашей учётной записи, и вы можете двигаться дальше. Проверьте и получите URL издателя вашей учётной записи:

aws iam get-outbound-web-identity-federation-info



Получение идентификатора рабочего пространства

Вы создаёте рабочее пространство из AWS Console после завершения настройки учётной записи (см. Настройка учётной записи). Рабочие пространства привязаны к одному региону AWS. Вы можете найти идентификатор рабочего пространства в Claude Console в разделе Workspaces или в разделе Workspaces на странице сервиса в AWS Console.

Установите переменные окружения ANTHROPIC_AWS_WORKSPACE_ID и AWS_REGION, чтобы клиенты SDK считывали их автоматически:

export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj'
export AWS_REGION='us-west-2'  # Your workspace's AWS region

Регион обязателен. Клиент SDK выдаёт ошибку, если регион не задан. Передайте aws_region/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 по умолчанию:

• Переменные окружения (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)

Проверьте, что ваши учётные данные работают:

aws sts get-caller-identity



Аутентификация по ключу API

Для более простых путей интеграции (локальная разработка и скрипты) вы можете аутентифицироваться с помощью ключа API вместо SigV4. Установите переменную окружения ANTHROPIC_AWS_API_KEY или передайте apiKey в конструктор SDK.

Генерируйте ключи API в AWS Console в разделе Claude Platform on AWS → API keys. Выберите Generate a key, затем скопируйте значение ключа. Предоставьте действие IAM aws-external-anthropic:CallWithBearerToken принципалам, которым должно быть разрешено использовать аутентификацию по ключу API.



Краткосрочные ключи API

Для рабочих нагрузок, которым нужно передать учётные данные отдельному процессу (например, шлюзу LLM, бессерверной функции или инструменту, который поддерживает аутентификацию по bearer-токену, но не SigV4), сгенерируйте краткосрочный ключ API из ваших учётных данных AWS вместо создания долгоживущего ключа в AWS Console.

AWS публикует библиотеки генераторов токенов для JavaScript, Python и Java. Каждая библиотека считывает ваши учётные данные AWS через стандартную цепочку поставщиков и возвращает токен с ограниченным сроком действия, который работает с заголовком x-api-key. Срок действия токена по умолчанию составляет 12 часов и ограничен наименьшим из: запрошенной вами длительности, срока действия ваших учётных данных AWS и 12 часов. Инструкции по установке и полные параметры конфигурации см. в README связанных репозиториев.

Передайте сгенерированный токен в SDK так же, как вы передали бы ключ API, сгенерированный в AWS Console:

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")

Если вы можете сгенерировать токен локально, ваш процесс уже имеет учётные данные SigV4, и аутентификация SigV4 обычно является более простым выбором. Используйте краткосрочные ключи, когда процесс, выполняющий вызовы API, отделён от процесса, который хранит учётные данные AWS.

SDK не обновляет краткосрочные ключи автоматически. Когда срок действия токена истекает, сгенерируйте новый и создайте новый клиент. Принципалу, использующему токен, по-прежнему требуется действие IAM aws-external-anthropic:CallWithBearerToken.



Приоритет учётных данных

Специфичный для платформы клиент разрешает аутентификацию в следующем порядке. Имена аргументов различаются в зависимости от соглашений языка: TypeScript и PHP используют camelCase, как показано, Python и Ruby используют snake_case, Go использует PascalCase с заглавными аббревиатурами, а C# и Java используют идиомы свойств или билдеров языка.

1. Аргумент конструктора apiKey → заголовок x-api-key
2. Аргументы конструктора awsAccessKey + awsSecretAccessKey → AWS SigV4
3. Аргумент конструктора awsProfile → AWS SigV4 с именованным профилем
4. Переменная окружения ANTHROPIC_AWS_API_KEY → заголовок x-api-key
5. Цепочка поставщиков учётных данных AWS по умолчанию → AWS SigV4



Разрешение региона

Клиент считывает AWS_REGION из окружения, если aws_region/awsRegion не передан в конструктор, с откатом на AWS_DEFAULT_REGION для совместимости со стандартными SDK AWS. Регион обязателен. Значения по умолчанию нет. В отличие от AnthropicBedrock, который откатывается на us-east-1, клиент AnthropicAWS/AnthropicAws выдаёт ошибку, если не задан ни аргумент конструктора, ни переменная окружения.



Установка SDK

Клиентские SDK Anthropic поддерживают Claude Platform on AWS. Каждый SDK предоставляет специфичный для платформы класс клиента, который обрабатывает подпись SigV4, построение базового URL на основе региона и заголовок anthropic-workspace-id.

pip install -U "anthropic[aws]"



Доступные модели

Следующие модели доступны на Claude Platform on AWS:

Идентификаторы моделей идентичны собственному Claude API. Нет ARN в стиле Bedrock или префиксов anthropic..

Новые модели обычно запускаются на Claude Platform on AWS в тот же день, что и в собственном Claude API.



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

Claude Platform on AWS использует те же конечные точки API, что и собственный Claude API. Различия заключаются в базовом URL, методе аутентификации и обязательном заголовке anthropic-workspace-id, который определяет, на какое рабочее пространство нацелен запрос.

Перед запуском этих примеров выполните шаги из раздела Перед выполнением вызовов API.

from anthropic import AnthropicAWS

client = AnthropicAWS()

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

Клиент считывает AWS_REGION (или AWS_DEFAULT_REGION) и ANTHROPIC_AWS_WORKSPACE_ID из окружения. Вы можете переопределить любой из них, передав aws_region / awsRegion или workspace_id / workspaceId в конструктор. И регион, и идентификатор рабочего пространства обязательны. Конструктор выдаёт ошибку, если какой-либо из них не может быть разрешён.

Значение --aws-sigv4 следует формату aws:amz:<region>:<service>. Имя сервиса SigV4 — aws-external-anthropic, а регион должен совпадать с регионом в URL вашей конечной точки. Несоответствие в любом из них приводит к общей ошибке отклонения подписи, а не к конкретной диагностике.



Контекстное окно

Размеры «context window» (контекстного окна) на Claude Platform on AWS идентичны собственному Claude API. Лимиты для каждой модели см. в разделе Контекстные окна.



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

Claude Platform on AWS использует конечные точки Claude API напрямую, что означает полный паритет функций с собственным Claude API (за исключением случаев, отмеченных в ограничениях функций):

• Доступ к функциям: Поскольку Anthropic управляет обеими платформами, большинство новых функций и бета-заголовков становятся доступными на Claude Platform on AWS без отдельного шага интеграции. Исключения см. в ограничениях функций.
• Бета-функции: Передавайте стандартный заголовок anthropic-beta для доступа к бета-функциям, так же, как и с Claude API.
• Agent Skills: Используйте готовые и пользовательские Agent Skills с тем же параметром container.skills и бета-заголовками, что и в Claude API. Все готовые Skills (PowerPoint, Excel, Word, PDF) работают «из коробки».
• Выполнение кода: Запускайте код в управляемой песочнице Anthropic с помощью инструмента выполнения кода.
• Использование инструментов: Использование компьютера и все другие возможности использования инструментов доступны.
• Расширенное мышление: Включайте расширенное мышление с теми же параметрами, что и в Claude API.
• Потоковая передача: Полная поддержка потоковой передачи SSE для ответов в реальном времени.
• Пакетная обработка: Отправляйте пакетные запросы для высокопроизводительных рабочих нагрузок.
• Кэширование подсказок: Кэшируйте инструменты, системные подсказки и историю сообщений для снижения задержки и стоимости. Все возможности кэширования подсказок (TTL 5 минут, TTL 1 час и автоматическое кэширование) доступны.
• Files API: Загружайте файлы и ссылайтесь на них в разных запросах.
• Ключи шифрования, управляемые клиентом (CMEK): CMEK доступен только с ключами AWS KMS. Ключи Google Cloud KMS и Azure Key Vault не могут быть зарегистрированы. Создавайте, проверяйте и прикрепляйте ключи в Claude Console. Конечные точки Admin API external_keys в настоящее время недоступны. Ключ должен находиться в том же регионе AWS, что и рабочее пространство, к которому он прикреплён.
• Compliance API: Compliance API доступен. Доступ авторизуется через AWS IAM.

Различия в доступности функций по сравнению с Amazon Bedrock см. в сравнительной таблице.



Claude Managed Agents

Claude Managed Agents доступен на Claude Platform on AWS, включая агентов, окружения, сессии, хранилища учётных данных, хранилища памяти, вебхуки, мультиагентную оркестрацию и самостоятельно размещаемые песочницы.

Поведение сессий на Claude Platform on AWS отличается от собственного Claude Managed Agents в одном аспекте:

• Повторная аутентификация автономных сессий: Сессия может работать автономно, без каких-либо пользовательских событий, до 6 часов. После 6 часов сессия требует повторной аутентификации для продолжения. Для повторной аутентификации отправьте любое событие с ролью пользователя в сессию (см. События и потоковая передача). Собственный Claude Managed Agents не имеет ограничения времени работы автономных сессий.



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

Следующие возможности в настоящее время недоступны на Claude Platform on AWS:

• Готовность к HIPAA: Программа готовности к HIPAA от Anthropic недоступна. См. API и хранение данных.

• Admin API: Конечные точки рабочих пространств (создание, получение, список, обновление и архивирование на /v1/organizations/workspaces) доступны. Другие конечные точки Admin API (участники организации, участники рабочих пространств, приглашения, ключи API, отчёты об использовании, отчёты о затратах, отчёты об ограничениях скорости и внешние ключи) в настоящее время недоступны. Вместо этого управляйте ключами CMEK в Claude Console. Вместо этого просматривайте данные об использовании и затратах в 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, по всему миру. Применяется стандартная цена.

Установите географию инференса для каждого запроса с помощью параметра inference_geo:

from anthropic import AnthropicAWS

client = AnthropicAWS()
message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    inference_geo="us",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message)

Если вы опустите inference_geo, запрос использует default_inference_geo рабочего пространства, если он настроен, в противном случае — global.

Элементы управления географией инференса на уровне рабочего пространства (allowed_inference_geos и default_inference_geo) также доступны на Claude Platform on AWS. См. Ограничения на уровне рабочего пространства.



Рабочие пространства

Запросы на инференс и ресурсы в Claude Platform on AWS направляются в рабочее пространство (workspace). Вы передаёте ID рабочего пространства в заголовке anthropic-workspace-id в этих вызовах API. ID рабочих пространств используют формат с тегом wrkspc_, за которым следует буквенно-цифровой идентификатор (например, wrkspc_01AbCdEf23GhIj). См. Получите ID вашего рабочего пространства, если у вас его ещё нет.



Область действия рабочего пространства

Рабочие пространства привязаны к одному региону AWS. Рабочее пространство, созданное в us-west-2, доступно только через конечную точку us-west-2. Использование, квоты, стоимость, файлы, пакеты и Skills агрегируются по каждому рабочему пространству, предоставляя вам разбивку по регионам в Claude Console.

Рабочие пространства также служат основным ресурсом IAM для Claude Platform on AWS. Вы предоставляете или запрещаете доступ к конкретным рабочим пространствам через политики AWS IAM, используя ARN рабочего пространства. Сегмент ресурса в ARN — это тот же ID с префиксом wrkspc_, который вы передаёте в заголовке anthropic-workspace-id:

arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}

Например:

arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj

Примеры политик см. в разделе Политики IAM.



Управление рабочими пространствами

Создавайте дополнительные рабочие пространства, переименовывайте рабочее пространство или архивируйте его на странице Workspaces в AWS Console или с помощью конечных точек рабочих пространств Admin API. Новое рабочее пространство привязывается к региону AWS той конечной точки, которую вы вызываете для его создания (см. Область действия рабочего пространства). Страница Workspaces в Claude Console доступна только для чтения.



Использование Claude Console

Claude Platform on AWS использует стандартную Claude Console по адресу 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. Полный процесс первого входа см. в разделе Настройте свою учётную запись. Вкратце:

1. Примите роль IAM с разрешением aws-external-anthropic:AssumeConsole. См. Действия IAM для Claude Platform on AWS.
2. Перейдите на страницу Claude Platform on AWS в AWS Console.
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 предоставляет доступ на чтение к информации об использовании, стоимости, ограничениях скорости и рабочих пространствах. Обратитесь к вашему представителю Anthropic, чтобы назначить роль Admin или Developer принципалу.



Доступные страницы

Столбец Через шлюз AWS указывает, читает ли и записывает ли страница данные через шлюз AWS (и, следовательно, регулируется ли она действиями IAM). Страницы, отмеченные Нет, читают метаданные уровня организации напрямую из Anthropic и обходят проверки действий IAM.



Переключение организаций

Claude Console не поддерживает переключение организаций для Claude Platform on AWS. Чтобы получить доступ к другой организации, выйдите из системы и повторно аутентифицируйтесь через AWS Console, используя роль IAM для учётной записи AWS этой организации.



Ограничения скорости и квоты

Организации в Claude Platform on AWS размещаются на уровне Start. Anthropic управляет ограничениями скорости напрямую, а не через системы квот AWS.

Организации в Claude Platform on AWS не перемещаются между уровнями использования автоматически. Продвижение по уровням на основе использования применяется к организациям первичного Claude API, а не к организациям, счета которым выставляются через AWS Marketplace. Самостоятельный процесс Request rate limit increase в Claude Console также недоступен: страница Limits вместо этого направляет вас к вашему представителю Anthropic.

Чтобы запросить более высокие лимиты, обратитесь к вашему представителю Anthropic или в поддержку. Включите в ваш запрос следующее:

• Модели, для которых нужно повышение
• Пиковое количество входных токенов в минуту и выходных токенов в минуту для каждой модели (не суточные итоги)
• Приблизительную долю вашего ввода, которая является кэшированным или повторяющимся контекстом (чтения из кэша не учитываются в лимитах входных токенов для большинства моделей; см. cache-aware ITPM)

Уровни использования — это фиксированные ступени: каждый уровень сочетает ограничения скорости с месячным лимитом расходов, и переход на более высокий уровень повышает и то, и другое. Подробности об уровнях и лимитах по моделям см. в разделе Ограничения скорости.



Выставление счетов

Claude Platform on AWS выставляет счета через AWS Marketplace. Использование выражается в Claude Consumption Units (CCU), измеряется почасово и выставляется в счёт ежемесячно по факту в вашем счёте AWS. CCU не являются предоплаченными кредитами. Баланса или обязательств по CCU нет.

Информацию о цене CCU, механике конвертации, применении скидок и ставках за токены по моделям см. в разделе Цены Claude Platform on AWS.



Лимиты расходов

Уровни использования Start, Build и Scale имеют месячный лимит расходов; текущие значения см. в разделе лимиты расходов по уровням. Лимит расходов и ограничения скорости относятся к одному и тому же уровню, поэтому, чтобы повысить лимит, запросите повышение уровня через вашего представителя Anthropic или поддержку (см. Ограничения скорости и квоты).

Вы также можете установить собственный месячный лимит расходов, чтобы ограничить расходы вашей организации:

• Лимит расходов организации: Перейдите в Settings > Billing в Claude Console, чтобы установить месячный лимит расходов. В Claude Platform on AWS лимиты расходов управляются на странице Billing, а не на странице Limits.
• Лимиты расходов рабочих пространств: Устанавливайте месячные лимиты расходов для отдельных рабочих пространств в настройках лимитов каждого рабочего пространства.

Устанавливаемые вами лимиты расходов являются мягкими лимитами: расходы рассчитываются по прейскурантным ценам, и отражение недавнего использования может занять около двух часов.



Мониторинг и логирование

AWS CloudTrail может фиксировать все запросы к Claude Platform on AWS. Операции с рабочими пространствами, хранилищами и вебхуками по умолчанию логируются как события Management. Операции инференса, пакетов, файлов, навыков, моделей, профилей пользователей и Claude Managed Agents (кроме хранилищ и вебхуков) классифицируются как события Data и требуют явной настройки логирования событий данных, что влечёт дополнительные расходы на CloudTrail. Полную классификацию типов событий см. в справочнике действий IAM, а подробности настройки — в документации AWS CloudTrail.



ID запросов

Каждый ответ включает два ID запроса в заголовках ответа:

• ID запроса AWS (x-amzn-requestid): Основной ID, индексируемый в CloudTrail. Используйте его при расследовании запросов с помощью инструментов AWS или при обращении в поддержку AWS.
• ID запроса Anthropic (request-id): Вторичный ID. Используйте его при обращении в поддержку Anthropic.

from anthropic import AnthropicAWS

client = AnthropicAWS()

response = client.messages.with_raw_response.create(
    model="claude-sonnet-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)

Anthropic рекомендует логировать вашу активность как минимум на скользящей 30-дневной основе, чтобы понимать паттерны использования и расследовать проблемы.



Миграция с Amazon Bedrock

Если вы в настоящее время используете Claude в Bedrock, миграция на Claude Platform on AWS требует изменений во всей вашей интеграции. Подпись SigV4 по-прежнему поддерживается, но контекст подписи, базовый URL, формат API, ID моделей, клиент и пакет SDK, формат потоковой передачи, заголовки запросов и доступность регионов — всё это меняется. Claude Platform on AWS также создаёт новую организацию Anthropic. Следующая таблица обобщает различия.



Что меняется

Объём изменений при миграции зависит от того, с какой интеграции Bedrock вы переходите. Следующая таблица показывает как текущую интеграцию Bedrock (Messages API по адресу bedrock-mantle.{region}.api.aws), так и устаревшую интеграцию InvokeModel.

Если вы используете текущую интеграцию Bedrock, формат тела запроса уже соответствует Messages API. Изменения касаются базового URL, имени сервиса SigV4, ID моделей и добавления заголовка anthropic-workspace-id. Если вы используете устаревший InvokeModel или Converse API, вам также потребуется переписать формы запросов и ответов в формат Messages API. Сопоставление форм запросов см. в разделе Claude в Amazon Bedrock (Opus 4.6 и более ранние).



Что вы получаете

• Как правило, доступ к новым моделям и функциям в день выпуска (см. ограничения функций)
• Agent Skills для генерации документов (PowerPoint, Excel, Word, PDF)
• Выполнение кода в управляемой песочнице Anthropic
• Бета-функции через заголовок anthropic-beta (см. ограничения функций)
• Claude Console для видимости квот и аналитики использования
• Прямая поддержка Anthropic
• Аутентификация по ключу API как альтернатива SigV4 (см. Аутентификация по ключу API)



Что остаётся прежним

• Аутентификация AWS IAM (SigV4)
• AWS как сторона, выставляющая счета. Канал выставления счетов меняется с нативного сервиса AWS на AWS Marketplace (см. Коммерческие соображения).
• Погашение обязательств AWS



Подводные камни миграции



Коммерческие соображения

• Условия обслуживания Anthropic: Использование Claude Platform on AWS требует принятия Коммерческих условий обслуживания и Политики использования Anthropic. Если ваша организация ещё не приняла их (например, если вы использовали Claude только через Bedrock), вам будет предложено сделать это во время настройки учётной записи. См. Настройте свою учётную запись.
• Скидки и частные предложения: Согласованные скидки и частные предложения 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:<Action> (например, aws-external-anthropic:CreateInference).



Пример: запрет пакетного инференса

Следующая политика разрешает инференс в реальном времени, блокируя пакетную обработку:

{
  "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.



Управляемые политики

AWS предоставляет пять управляемых политик (AnthropicFullAccess, AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess и AnthropicSelfHostedEnvironmentAccess) для распространённых шаблонов доступа. Действия, предоставляемые каждой политикой, полный список действий IAM, сопоставление маршрутов с действиями и дополнительные примеры политик см. в разделе Действия IAM для Claude Platform on AWS.



Следующие шаги



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