Claude Platform на AWS

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

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

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

Anthropic использует инфраструктуру AWS для обработки ваших запросов к API, выполнения инференса модели и хранения содержимого вашего рабочего пространства (например, подсказок, выходных данных, файлов, Skills и пакетов). Для рабочих пространств, созданных до 18 сентября 2026 года, 00:00 UTC, Anthropic может обрабатывать запросы, хранить данные и выполнять инференс за пределами AWS. В обоих случаях используемые подсервисы могут меняться без уведомления. Чтобы закрепить инференс за определенным географическим регионом, задавайте параметр inference_geo в каждом запросе.

Claude Platform on AWS следует той же политике хранения данных, что и собственный Claude API от Anthropic. «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.

1. 1

   Зарегистрируйтесь в AWS Console

   1. Откройте AWS Console и перейдите на страницу сервиса Claude Platform on AWS.
   2. Выберите Sign up.
   3. На странице регистрации ознакомьтесь с условиями (Лицензионным соглашением с конечным пользователем Anthropic, Уведомлением о конфиденциальности AWS и Клиентским соглашением AWS) и установите флажок согласия.
   4. Выберите Continue.

   На странице появится баннер Sign-up in progress. Не покидайте страницу. Регистрация занимает несколько минут: за это время AWS оформит для вас подписку в AWS Marketplace, после чего вы будете автоматически перенаправлены.

   Если у вашей организации есть частное предложение от Anthropic, консоль найдет его и предложит принять его в AWS Marketplace. Подробнее см. в разделе Частные предложения.

2. 2

   Настройте организацию 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.

3. 3

   Создайте рабочее пространство и запишите его идентификатор

   После завершения настройки AWS Console предложит создать рабочее пространство. Подробнее о привязке к региону, ограничении области ресурсов IAM и создании дополнительных рабочих пространств см. в разделе Рабочие пространства.

   Идентификатор рабочего пространства можно найти в разделе Workspaces на странице сервиса Claude Platform on AWS в AWS Console или в Claude Console. Идентификаторы рабочих пространств имеют формат wrkspc_, за которым следует буквенно-цифровой идентификатор.

4. 4

   Войдите в Claude Console

   Доступ к Claude Console предоставляется через федерацию с AWS IAM:

   1. Примите роль IAM с разрешением aws-external-anthropic:AssumeConsole. См. Действия IAM для Claude Platform on AWS.
   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 (см. Настройка учетной записи). Если переход связан с частным предложением, завершите регистрацию до принятия предложения: скидки действуют с момента принятия и не применяются задним числом. См. Частные предложения.
• Заново настройте доступ и конфигурацию. Ключи API, рабочие пространства и настройки Claude Console из существующей организации не переносятся. Создайте рабочие пространства в новой организации и переведите свои приложения на аутентификацию Claude Platform on AWS.
• Обновите интеграцию. Claude Platform on AWS обслуживает Claude API (/v1/{endpoint}), поэтому структура запросов и ответов такая же, как в собственном Claude API от Anthropic. Меняются базовый URL, метод аутентификации и заголовок anthropic-workspace-id в запросах инференса и запросах к ресурсам; см. Выполнение запросов. Некоторые функции платформы отличаются; см. Неподдерживаемые функции.
• Переключайтесь в удобном для вас темпе. Новая организация не зависит от существующей, и обе могут обслуживать трафик параллельно. Резкое переключение не требуется: переносите рабочие нагрузки постепенно, пока весь трафик не окажется в новой организации.

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

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

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

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

• «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: включите федерацию (один раз для каждой учетной записи). См. Включение исходящей федерации веб-идентификации.

Перед выполнением вызовов 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 издателя (issuer) для вашей учетной записи:

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 при создании клиента или задайте 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 по умолчанию:

• Переменные окружения (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 или передайте api_key при создании клиента.

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

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

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

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.

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

Клиент для конкретной платформы определяет аутентификацию в следующем порядке, начиная с того, что вы передаёте при его создании:

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

Определение региона

Клиент считывает AWS_REGION из окружения, если вы не задали aws_region, а при его отсутствии использует AWS_DEFAULT_REGION для совместимости со стандартными AWS SDK. Регион обязателен, и значения по умолчанию нет: AnthropicAWS выдаёт ошибку, если не задан ни аргумент конструктора, ни переменная окружения.

Установка SDK

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

pip install -U "anthropic[aws]"

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

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

Идентификаторы моделей совпадают с идентификаторами в собственном Claude API от Anthropic. ARN в стиле Bedrock и префиксы anthropic. не используются.

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

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

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

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

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)

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

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

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

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

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

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

• Доступ к функциям: поскольку Anthropic управляет обеими платформами, большинство новых функций и бета-заголовков становятся доступны в Claude Platform on AWS без отдельного шага интеграции. Исключения см. в разделе ограничения функций.
• Бета-функции: передавайте стандартный заголовок anthropic-beta для доступа к бета-функциям так же, как в Claude API.
• Agent Skills: используйте готовые и пользовательские Agent Skills с тем же параметром container.skills, что и в Claude API. Все готовые Skills (PowerPoint, Excel, Word, PDF) работают сразу.
• Выполнение кода: запускайте код в управляемой песочнице Anthropic с помощью инструмента выполнения кода.
• Использование инструментов: все возможности «tool use» (использование инструментов) доступны, кроме наборов инструментов для использования компьютера и браузера; см. Неподдерживаемые функции.
• Размышления: адаптивные размышления, параметр effort и, на поддерживающих их моделях, «extended thinking» (расширенные размышления) работают с теми же параметрами, что и в Claude API.
• Потоковая передача: полная поддержка «streaming» (потоковая передача) через SSE для ответов в реальном времени.
• Пакетная обработка: отправляйте пакетные запросы для высокопроизводительных рабочих нагрузок.
• Кэширование подсказок: кэшируйте инструменты, системные подсказки и историю сообщений, чтобы снизить задержку и стоимость. Доступны все возможности «prompt caching» (кэширования подсказок): TTL 5 минут, TTL 1 час и автоматическое кэширование.
• Files API: загружайте файлы и ссылайтесь на них в разных запросах.
• «Customer-managed encryption keys» (ключи шифрования, управляемые клиентом), или CMEK: CMEK доступны только с ключами AWS KMS. Ключи Google Cloud KMS и Azure Key Vault зарегистрировать нельзя. Ключ должен быть однорегиональным ключом KMS в той же учётной записи и том же регионе AWS, что и рабочее пространство, к которому он прикреплён, а его политика ключа должна предоставлять доступ субъекту сервиса aws-external-anthropic.amazonaws.com; см. Настройка CMEK в Claude Platform on AWS. Регистрируйте и прикрепляйте ключи в Claude Console; также доступны конечные точки внешних ключей, авторизуемые через действия IAM. Отдельного шага проверки нет: ключ неявно проверяется при прикреплении к рабочему пространству (вызов прикрепления выполняет цикл шифрования/расшифровки), поэтому проблема с политикой ключа проявляется при прикреплении, а не при регистрации.
• Compliance API: Compliance API доступен. Доступ авторизуется через действие ListComplianceActivities 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 Managed Agents сессии как в облачных, так и в самостоятельно размещаемых окружениях могут прикреплять хранилища памяти.
• Аутентификация воркеров в самостоятельно размещаемых окружениях: воркер проходит аутентификацию с помощью AWS IAM (SigV4) или ключа API, созданного в AWS Console, а не ключа среды. Ключи среды, созданные в Claude Console, не работают с конечной точкой Claude Platform on AWS.

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

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

• Готовность к HIPAA: программа Anthropic с поддержкой HIPAA недоступна. См. API и хранение данных.
• Наборы инструментов для использования компьютера и браузера: computer_toolset_20260801 и browser_toolset_20260801 в настоящее время недоступны на Claude Platform on AWS. Бета-версии инструмента использования компьютера остаются доступными для моделей, перечисленных в разделе Более ранние версии инструмента.

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

Задайте географию инференса для отдельного запроса с помощью параметра inference_geo:

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)

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

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

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

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

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. Этим конечным точкам не требуется заголовок anthropic-workspace-id. Операции создания и получения списка действуют на уровне организации. Операции получения, обновления и архивирования принимают ID рабочего пространства в пути URL. Новое рабочее пространство привязывается к региону AWS той конечной точки, через которую вы его создаёте (см. Область действия рабочих пространств). С ролью Admin вы также можете создавать, переименовывать и архивировать рабочие пространства на странице 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. В ней доступны:

• аналитика использования и разбивка затрат;
• просмотр «rate limits» (ограничений скорости);
• управление рабочими пространствами;
• страницы для управления файлами, 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 даёт доступ на чтение к информации об использовании, затратах, ограничениях скорости и рабочих пространствах. Чтобы назначить роль Admin или Developer субъекту (principal), обратитесь к представителю Anthropic, который ведёт вашу учётную запись.

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

Столбец Через шлюз 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 могут автоматически переходить на более высокий уровень использования по мере накопления истории оплаченных счетов AWS Marketplace. Процесс самообслуживания Request tier increase в Claude Console недоступен: вместо этого страница Rate limits направляет вас к вашему представителю Anthropic.

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

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

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

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

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

Цену CCU, механизм пересчёта, применение скидок и тарифы на токены для каждой модели см. в разделе Цены Claude Platform on AWS.

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

У каждого из уровней использования Start, Build и Scale есть ежемесячный «spend cap» (потолок расходов). Текущие значения см. в разделе потолки расходов по уровням. Когда использование вашей организации за календарный месяц достигает потолка её уровня, запросы API завершаются ошибкой превышения потолка расходов. Так продолжается до 00:00 UTC первого дня следующего месяца, и повторные попытки до этого момента не помогут. Потолок расходов и ограничения скорости относятся к одному и тому же уровню. Чтобы повысить потолок или восстановить доступ после его достижения, запросите повышение уровня. Для этого обратитесь к представителю Anthropic, который ведёт вашу учётную запись, или в службу поддержки Anthropic (см. Ограничения скорости и квоты).

Вы также можете задать собственные ежемесячные «spend limits» (лимиты расходов) ниже потолка. Сначала добавьте хотя бы одного получателя в разделе Email recipients на странице Billing. Затем:

• Лимит расходов организации: перейдите в Settings > Billing в Claude Console и задайте ежемесячный лимит расходов.
• Лимиты расходов рабочих пространств: на странице Workspaces (platform.claude.com/settings/workspaces) в Claude Console выберите рабочее пространство. В открывшейся панели нажмите Spend limits.

Когда использование достигает заданного вами лимита, запросы завершаются ошибкой HTTP 400 (см. ошибку лимита расходов). Так продолжается до 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, а подробности настройки — в документации 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-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;
• формат «streaming» (потоковой передачи);
• заголовки запросов и доступность регионов.

Кроме того, Claude Platform on AWS создаёт новую организацию Anthropic. Различия сведены в таблице ниже.

Что меняется

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

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

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

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

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

• Аутентификация AWS IAM (SigV4)
• AWS как сторона, выставляющая счета. Канал выставления счетов меняется с нативного сервиса AWS на AWS Marketplace (см. Коммерческие аспекты).
• Зачёт использования в счёт обязательств перед AWS (AWS commitment retirement)

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

Коммерческие аспекты

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

• действия, которые предоставляет каждая политика;
• полный список действий IAM;
• сопоставление маршрутов с действиями;
• дополнительные примеры политик.

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

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