Claude Platform на AWS предоставляет вам полный опыт работы с платформой Anthropic, включая Messages API, Agent Skills, выполнение кода и бета-функции, доступные через вашу учётную запись AWS. В отличие от Amazon Bedrock, где AWS управляет стеком инференса, Claude Platform на AWS управляется компанией Anthropic. AWS предоставляет уровень аутентификации (SigV4 или ключ API), управление доступом на основе IAM и интеграцию биллинга через AWS Marketplace.
SDK от Anthropic поддерживают Claude Platform на AWS.
Модели Claude работают на инфраструктуре, управляемой Anthropic. Это коммерческая интеграция для биллинга и доступа через AWS. Anthropic является обработчиком данных для входных и выходных данных инференса; AWS обрабатывает метаданные биллинга и идентификации в рамках модели маркетплейса. На клиентов, использующих Claude через Claude Platform на AWS, распространяются условия использования данных Anthropic. Anthropic продолжает обеспечивать свои лидирующие в отрасли обязательства по безопасности и защите данных.
Обратите внимание на следующие операционные характеристики: данные могут не находиться в AWS; инференс может направляться в основное облако Anthropic; подсервисы могут меняться «под капотом» без уведомления. Устанавливайте параметр inference_geo для каждого запроса, чтобы закрепить инференс за определённой географией.
Claude Platform на AWS следует той же политике хранения данных, что и собственный Claude API. Режим «Zero Data Retention» (ZDR) доступен по запросу. Свяжитесь с вашим представителем Anthropic, чтобы включить его для вашей организации.
Оба предложения позволяют использовать Claude через AWS, но они существенно различаются по архитектуре, поверхности API и доступности функций.
| Аспект | Claude Platform на AWS | Claude в Amazon Bedrock | Amazon Bedrock (устаревший) |
|---|---|---|---|
| Кто управляет стеком | Anthropic | AWS | AWS |
| Поверхность API | Claude API (/v1/{endpoint}) | Messages API по адресу /anthropic/v1/messages | Bedrock Converse / InvokeModel |
| Доступность функций | Как правило, в тот же день, что и Claude API (см. ограничения функций) | Согласно графику выпуска Amazon Bedrock | Согласно графику выпуска Amazon Bedrock |
| Agent Skills | Доступно (бета) | Недоступно (требуется выполнение кода) | Недоступно |
| Бета-функции | Передаются через заголовки anthropic-beta (см. ограничения функций) | Заголовок anthropic-beta не поддерживается | Заголовок anthropic-beta не поддерживается |
| Аутентификация | AWS IAM / SigV4 или ключ API | AWS IAM / SigV4 | AWS IAM / SigV4 или bearer-токен (только SDK для C#, Go и Java) |
| Биллинг | AWS Marketplace | AWS (нативный сервис) | AWS (нативный сервис) |
| Базовый URL | aws-external-anthropic.{region}.api.aws | bedrock-mantle.{region}.api.aws | bedrock-runtime.{region}.amazonaws.com |
| SDK-клиент | Класс клиента, специфичный для платформы (например, AnthropicAWS в Python), в бета-версии | AnthropicBedrockMantle | AnthropicBedrock / Bedrock SDK |
| Консоль | Claude Console (platform.claude.com, доступ через AWS Console) | Bedrock Console | Bedrock Console |
| Ограничения скорости и квоты | Управляются Anthropic | Управляются AWS | Управляются AWS |
| Обработчик данных инференса | Anthropic | AWS | AWS |
Если вам нужен Claude под управлением AWS, см. Claude в Amazon Bedrock. Claude Platform на AWS использует отдельный пул мощностей, отличный как от собственного Claude API, так и от Amazon Bedrock. Вы можете запускать рабочие нагрузки на нескольких платформах и переключаться между ними при сбоях.
AWS PrivateLink поддерживается для подключения вашего VPC к конечной точке Claude Platform на AWS.
Когда выбирать Bedrock: Организациям в регулируемых отраслях, которым требуется соответствие FedRAMP High, IL4, IL5 или готовность к HIPAA, либо которым необходимо, чтобы AWS был единственным обработчиком данных, следует использовать Claude в Amazon Bedrock. Bedrock работает полностью на инфраструктуре, контролируемой AWS, где AWS является управляющей стороной.
Настройка Claude Platform на AWS происходит в четыре этапа: регистрация на странице сервиса в AWS Console, завершение настройки организации Anthropic, получение идентификатора рабочего пространства и вход в Claude Console.
Регистрация через AWS Console создаёт новую организацию Anthropic, привязанную к вашей учётной записи AWS. Эта организация отделена от любых существующих организаций вашей компании в Anthropic, включая организации Claude Enterprise, приобретённые через AWS Marketplace. Ключи API, рабочие пространства и настройки Claude Console из собственной организации Anthropic не переносятся.
Если у вас есть существующее частное предложение Amazon Bedrock, свяжитесь с вашим представителем Anthropic или AWS перед регистрацией, чтобы ваша скидка применялась с первого запроса. Скидки не могут быть применены задним числом к использованию, понесённому до принятия вашего частного предложения. См. Частные предложения.
Зарегистрируйтесь в AWS Console
На странице отобразится баннер Sign-up in progress. Оставайтесь на странице. Регистрация занимает несколько минут, пока AWS обрабатывает подписку AWS Marketplace за вас, после чего вы будете автоматически перенаправлены.
Если у вашей организации есть частное предложение от Anthropic, консоль найдёт его и предложит вам принять его в AWS Marketplace. Подробности см. в разделе Частные предложения.
Если вы используете Claude Platform на AWS, ваш контент (например, подсказки и ответы) обрабатывается Anthropic за пределами AWS. См. политики использования данных Anthropic для получения подробной информации о том, как обрабатываются и хранятся контент и метаданные.
Настройте вашу организацию Anthropic
После завершения регистрации вы будете перенаправлены на platform.claude.com/partner-signup.
Завершение настройки создаёт вашу организацию Anthropic и принимает Коммерческие условия обслуживания и Политику использования Anthropic. На странице сервиса в AWS Console теперь отображается левая навигация с разделами Home, API keys, Quickstart и Workspaces.
Создайте рабочее пространство и запишите его идентификатор
После завершения настройки AWS Console предложит вам создать рабочее пространство. См. раздел Рабочие пространства для получения подробной информации о привязке к региону, ограничении ресурсов IAM и создании дополнительных рабочих пространств.
Найдите идентификатор рабочего пространства в разделе Workspaces на странице сервиса Claude Platform on AWS в AWS Console или в Claude Console. Идентификаторы рабочих пространств используют формат wrkspc_, за которым следует буквенно-цифровой идентификатор.
Войдите в Claude Console
Доступ к Claude Console федерируется через AWS IAM:
aws-external-anthropic:AssumeConsole. См. Действия IAM для Claude Platform на AWS.platform.claude.com.Когда вы вошли через AWS Console, Claude Console ограничивается вашей организацией Claude Platform на AWS. Индикатор Account managed by AWS отображается в левом нижнем углу боковой панели Claude Console.
Убедитесь, что у вас есть:
Шлюз Claude Platform на 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Без этого шага каждый запрос возвращает "Outbound web identity federation is disabled for your account". Это самая распространённая ошибка настройки.
Вы создаёте рабочее пространство из 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 на AWS поддерживает два метода аутентификации: AWS IAM с подписью запросов SigV4 (основной) и аутентификацию по ключу API. Оба используют один и тот же базовый URL и формат запроса.
SigV4 — это нативный для корпоративной среды путь, который интегрируется с вашими существующими политиками, ролями и аудитом AWS IAM. Настройте учётные данные AWS любым методом, поддерживаемым цепочкой поставщиков учётных данных AWS по умолчанию:
AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN)~/.aws/credentials)~/.aws/config), включая SSO и credential_processAWS_WEB_IDENTITY_TOKEN_FILE и AWS_ROLE_ARN) для IRSA и GitHub ActionsПроверьте, что ваши учётные данные работают:
aws sts get-caller-identityДля более простых путей интеграции (локальная разработка и скрипты) вы можете аутентифицироваться с помощью ключа 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 для Claude Platform на AWS управляются в AWS Console, а не в Claude Console. Ключи, созданные в стандартной Claude Console (для доступа к собственному API), не работают с конечной точкой Claude Platform на AWS.
Для рабочих нагрузок, которым необходимо передать учётные данные отдельному процессу (например, 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 используют идиомы свойств или билдеров соответствующего языка).
apiKey → заголовок x-api-keyawsAccessKey + awsSecretAccessKey → AWS SigV4awsProfile → AWS SigV4 с именованным профилемANTHROPIC_AWS_API_KEY → заголовок x-api-keyКлиент считывает AWS_REGION из окружения, если aws_region/awsRegion не передан в конструктор, с откатом на AWS_DEFAULT_REGION для совместимости со стандартными AWS SDK. Регион обязателен; значения по умолчанию нет. В отличие от AnthropicBedrock, который откатывается на us-east-1, клиент AnthropicAWS/AnthropicAws выдаёт ошибку, если не установлен ни аргумент конструктора, ни переменная окружения.
Клиентские SDK от Anthropic поддерживают Claude Platform на AWS. Каждый SDK предоставляет класс клиента, специфичный для платформы, который обрабатывает подпись SigV4, построение базового URL на основе региона и заголовок anthropic-workspace-id.
SDK-клиенты для Claude Platform на AWS находятся в бета-версии.
Следующие модели доступны на Claude Platform на AWS:
| Модель | Идентификатор модели |
|---|---|
| Claude Fable 5 | claude-fable-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 Sonnet 4.6 | claude-sonnet-4-6 |
| Claude Opus 4.5 | claude-opus-4-5 |
| Claude Sonnet 4.5 | claude-sonnet-4-5 |
| Claude Haiku 4.5 | claude-haiku-4-5 |
Идентификаторы моделей идентичны собственному Claude API. Нет ARN в стиле Bedrock или префиксов anthropic..
Новые модели запускаются на Claude Platform на AWS одновременно с собственным Claude API.
Переходите на более новую модель Claude? В Claude Code выполните команду /claude-api migrate, чтобы применить замену идентификаторов моделей и критические изменения параметров по всей вашей кодовой базе. Навык определяет, на какую облачную платформу ориентирован ваш код, и корректирует форматы идентификаторов моделей и изменения функций для этой платформы. См. Переход на более новую модель Claude.
Claude Platform на AWS использует те же конечные точки API, что и собственный Claude API. Различия заключаются в базовом URL, методе аутентификации и обязательном заголовке anthropic-workspace-id, который идентифицирует, на какое рабочее пространство нацелен запрос.
from anthropic import AnthropicAWS
client = AnthropicAWS()
message = client.messages.create(
model="claude-sonnet-4-6",
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 в конструктор. И регион, и идентификатор рабочего пространства обязательны. Конструктор выдаёт ошибку, если идентификатор рабочего пространства не может быть разрешён; отсутствующий регион также вызывает ошибку.
Заголовок x-amz-security-token (cURL) требуется только для временных учётных данных, таких как роли IAM, SSO или STS. Опустите его при использовании долгосрочных учётных данных пользователя IAM. SDK-клиенты обрабатывают это автоматически в зависимости от источника учётных данных.
Значение --aws-sigv4 следует формату aws:amz:<region>:<service>. Имя сервиса SigV4 — aws-external-anthropic, а регион должен совпадать с регионом в URL вашей конечной точки. Несоответствие в любом из них приводит к общей ошибке отклонения подписи, а не к конкретной диагностике.
Размеры контекстного окна на Claude Platform на AWS идентичны собственному Claude API. См. Контекстные окна для ограничений по моделям.
Claude Platform на AWS использует конечные точки Claude API напрямую, что означает полный паритет функций с собственным Claude API (за исключением случаев, указанных в ограничениях функций):
anthropic-beta для доступа к бета-функциям, так же как и с Claude API.container.skills и бета-заголовками, что и в Claude API. Все готовые навыки (PowerPoint, Excel, Word, PDF) работают из коробки.external_keys в настоящее время недоступны. Ключ должен находиться в том же регионе AWS, что и рабочее пространство, к которому он прикреплён.См. сравнительную таблицу для различий в доступности функций по сравнению с Amazon Bedrock.
Claude Managed Agents доступен на Claude Platform на AWS, включая агентов, окружения, сессии, хранилища учётных данных, хранилища памяти, вебхуки, мультиагентную оркестрацию и самостоятельно размещаемые песочницы.
Поведение сессий на Claude Platform на AWS отличается от собственного Claude Managed Agents в одном аспекте:
Следующие возможности в настоящее время недоступны на Claude Platform на AWS:
/v1/organizations/workspaces) доступны. Другие конечные точки Admin API (участники организации, участники рабочих пространств, приглашения, ключи API, отчёты об использовании, отчёты о затратах, отчёты об ограничениях скорости и внешние ключи) в настоящее время недоступны. Управляйте ключами CMEK в Claude Console. Просматривайте данные об использовании и затратах в Claude Console. Членством в организации управляет AWS IAM.GET /v1/environments/{id}/work, которая выводит список ожидающих работ для самостоятельно размещаемой песочницы, в настоящее время недоступна. Другие конечные точки работ (poll, ack, heartbeat, stop, post results, получение по элементу и статистика) работают нормально.Claude Platform на AWS поддерживает следующие географии инференса:
Регион AWS, к которому привязано ваше рабочее пространство, определяет, какую конечную точку шлюза вы вызываете и где ограничены ресурсы на стороне AWS (IAM, CloudTrail, биллинг). Он не закрепляет место выполнения инференса модели. Чтобы закрепить инференс за определённой географией, установите inference_geo для каждого запроса или настройте значение по умолчанию для рабочего пространства.
Устанавливайте географию инференса для каждого запроса с помощью параметра inference_geo:
Параметр inference_geo поддерживается на Claude Opus 4.6, Claude Sonnet 4.6 и более поздних моделях. Запросы с inference_geo на Claude Opus 4.5, Claude Sonnet 4.5 или Claude Haiku 4.5 возвращают ошибку 400. См. Резидентность данных для получения подробной информации о доступности моделей.
from anthropic import AnthropicAWS
client = AnthropicAWS()
message = client.messages.create(
model="claude-sonnet-4-6",
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 на AWS. См. Ограничения на уровне рабочего пространства.
Запросы инференса и ресурсов на Claude Platform на AWS нацелены на рабочее пространство. Вы передаёте идентификатор рабочего пространства в заголовке anthropic-workspace-id при этих вызовах API. Идентификаторы рабочих пространств используют формат с тегом wrkspc_, за которым следует буквенно-цифровой идентификатор (например, wrkspc_01AbCdEf23GhIj). См. Получение идентификатора рабочего пространства, если у вас его ещё нет.
Рабочие пространства привязаны к одному региону AWS. Рабочее пространство, созданное в us-west-2, может быть доступно только через конечную точку us-west-2. Использование, квоты, затраты, файлы, пакеты и навыки — всё это агрегируется по рабочему пространству, что даёт вам разбивку по регионам в Claude Console.
Рабочие пространства также служат основным ресурсом IAM для Claude Platform на AWS. Вы предоставляете или запрещаете доступ к конкретным рабочим пространствам через политики AWS IAM, используя ARN рабочего пространства. Сегмент ресурса ARN — это тот же идентификатор с префиксом 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 Platform на AWS использует стандартную Claude Console по адресу platform.claude.com. Когда вы входите из AWS Console, индикатор Account managed by AWS отображается в левом нижнем углу боковой панели Claude Console, и консоль ограничивается вашей организацией Claude Platform на AWS. Она предоставляет аналитику использования, разбивку затрат, видимость ограничений скорости, видимость рабочих пространств и страницы для управления файлами, Agent Skills, пакетными заданиями и ресурсами Claude Managed Agents (агенты, сессии, окружения, хранилища учётных данных, хранилища памяти и вебхуки).
Доступ к Claude Console федерируется через AWS IAM. См. Настройка учётной записи для полного процесса первого входа. Вкратце:
aws-external-anthropic:AssumeConsole. См. Действия IAM для Claude Platform на AWS.platform.claude.com.Доступны две роли Claude Console: Admin и Developer. Роль Admin предоставляет доступ ко всем страницам и настройкам Claude Console, доступным для Claude Platform на AWS. Роль Developer предоставляет доступ на чтение к информации об использовании, затратах, ограничениях скорости и рабочих пространствах. Свяжитесь с вашим представителем Anthropic, чтобы назначить роль Admin или Developer принципалу.
Столбец Through AWS gateway (Через шлюз AWS) указывает, выполняет ли страница чтение и запись данных через шлюз AWS (и, следовательно, регулируется ли она действиями IAM). Страницы с пометкой No (Нет) считывают метаданные уровня организации напрямую из Anthropic и обходят проверки действий IAM.
| Страница | Доступна | Через шлюз AWS | Примечания |
|---|---|---|---|
| Usage | Да | Нет | Просмотр использования токенов по модели, рабочему пространству и измерению. Данные могут появиться через несколько минут после запроса. |
| Cost | Да | Нет | Просмотр разбивки затрат по модели и рабочему пространству. AWS Cost Explorer показывает агрегированную строку Claude Consumption Unit (CCU). |
| Limits | Да | Нет | Просмотр ограничений скорости (только чтение). |
| Workspaces | Да | Нет | Просмотр рабочих пространств по регионам (только чтение). |
| Files | Да | Да | Просмотр загруженных файлов и управление ими. |
| Skills | Да | Да | Просмотр Agent Skills и управление ими. |
| Batches | Да | Да | Просмотр заданий пакетной обработки и управление ими. |
| Agents | Да | Да | Просмотр определений агентов и управление ими. |
| Sessions | Да | Да | Просмотр сессий агентов и истории событий. |
| Environments | Да | Да | Просмотр конфигураций облачной песочницы для сессий и управление ими. |
| Credential vaults | Да | Да | Просмотр хранилищ учётных данных для аутентификации сессий и управление ими. |
| Memory stores | Да | Да | Просмотр постоянной памяти агентов и управление ею. |
| Webhooks | Да | Да | Просмотр конечных точек вебхуков и управление ими в разделе Settings → Webhooks. |
| API keys | Нет | Н/Д | Управляйте ключами API в AWS Console (Claude Platform on AWS → API keys). См. Аутентификация по ключу API. |
| Members | Нет | Н/Д | Неприменимо. Доступом управляет AWS IAM. |
| Billing | Нет | Н/Д | Неприменимо. Выставлением счетов и инвойсингом управляет AWS Marketplace. Просматривайте разбивку затрат на странице Cost. |
| Claude Code | Нет | Н/Д | Просматривайте использование Claude Code на странице Usage. |
Claude Console не поддерживает переключение организаций для Claude Platform on AWS. Чтобы получить доступ к другой организации, выйдите из системы и повторно аутентифицируйтесь через AWS Console, используя роль IAM для учётной записи AWS этой организации.
Claude Platform on AWS назначает ограничения скорости уровня Tier 1 при регистрации. Anthropic управляет ограничениями скорости напрямую, а не через системы квот AWS.
В отличие от собственного Claude API, автоматическое повышение уровня не применяется. Если вам нужны более высокие лимиты, обратитесь к вашему представителю Anthropic. Подробности об уровнях и лимитах для каждой модели см. в разделе Ограничения скорости.
Claude Platform on AWS выставляет счета через AWS Marketplace. Использование измеряется в единицах «Claude Consumption Unit» (единица потребления Claude), или CCU, учитывается ежечасно и выставляется ежемесячно по факту в вашем счёте AWS. CCU не являются предоплаченными кредитами; баланса CCU или обязательств по ним не существует.
Цену CCU, механику конвертации, применение скидок и тарифы на токены для каждой модели см. в разделе Цены на Claude Platform on AWS.
AWS CloudTrail может фиксировать все запросы к Claude Platform on AWS. Операции с рабочими пространствами, хранилищами и вебхуками по умолчанию логируются как события управления (Management events). Операции вывода, пакетной обработки, файлов, навыков, моделей, профилей пользователей и Claude Managed Agents (кроме хранилищ и вебхуков) классифицируются как события данных (Data events) и требуют явной настройки логирования событий данных, что влечёт дополнительные расходы на CloudTrail. Полную классификацию типов событий см. в справочнике по действиям IAM, а подробности настройки — в документации AWS CloudTrail.
Каждый ответ содержит два идентификатора запроса в заголовках ответа:
x-amzn-requestid): основной идентификатор, индексируемый в CloudTrail. Используйте его при исследовании запросов через инструменты AWS или при обращении в поддержку AWS.request-id): вторичный идентификатор. Используйте его при обращении в поддержку Anthropic.from anthropic import AnthropicAWS
client = AnthropicAWS()
response = client.messages.with_raw_response.create(
model="claude-sonnet-4-6",
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 дней, чтобы понимать закономерности использования и расследовать возможные проблемы.
AWS CloudTrail настраивается в вашей учётной записи AWS. Включение логирования не предоставляет AWS или Anthropic доступ к вашему контенту сверх того, что необходимо для выставления счетов и работы сервиса.
Если вы в настоящее время используете Claude на Bedrock, миграция на Claude Platform on AWS требует изменений во всей вашей интеграции. Подписывание SigV4 по-прежнему поддерживается, но контекст подписывания, базовый URL, формат API, идентификаторы моделей, клиент и пакет SDK, формат потоковой передачи, заголовки запросов и доступность регионов — всё это меняется. В следующей таблице приведена сводка различий.
Объём изменений при миграции зависит от того, с какой интеграции Bedrock вы переходите. В следующей таблице показаны как текущая интеграция Bedrock (Messages API по адресу bedrock-mantle.{region}.api.aws), так и устаревшая интеграция InvokeModel.
| Аспект | С Claude в Amazon Bedrock | С Amazon Bedrock (устаревшая) | На 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-opus-4-6 | anthropic.claude-opus-4-6-v1 (с необязательным префиксом us./global.) | claude-opus-4-6 |
| Клиент SDK | AnthropicBedrockMantle | AnthropicBedrock / Bedrock SDK | Клиент для конкретной платформы (см. Установка SDK), в бета-версии |
| Пакет SDK | anthropic[bedrock], @anthropic-ai/bedrock-sdk и другие | anthropic[bedrock], @anthropic-ai/bedrock-sdk или AWS SDK | anthropic[aws], @anthropic-ai/aws-sdk и другие (см. Установка SDK) |
| Имя сервиса SigV4 | bedrock-mantle | bedrock | aws-external-anthropic |
| Формат потоковой передачи | SSE | AWS EventStream | SSE (как в Claude API) |
| Заголовок рабочего пространства | Неприменимо | Неприменимо | Требуется anthropic-workspace-id |
| Доступность регионов | См. регионы Amazon Bedrock | См. регионы Amazon Bedrock | Все коммерческие регионы AWS |
Если вы используете текущую интеграцию Bedrock, формат тела запроса уже соответствует Messages API; изменения касаются базового URL, имени сервиса SigV4, идентификаторов моделей и добавления заголовка anthropic-workspace-id. Если вы используете устаревший InvokeModel или Converse API, вам также потребуется переписать форматы запросов и ответов в формат Messages API. Сопоставление форматов запросов см. в разделе Claude на Amazon Bedrock (устаревшая версия).
anthropic-beta (см. ограничения функций)Сначала включите исходящую федерацию веб-идентичности. Если ваша учётная запись AWS ранее не использовала Claude Platform on AWS, вы должны включить исходящую федерацию веб-идентичности один раз для каждой учётной записи перед отправкой запросов. Без этого шага все запросы завершаются ошибкой федерации (точную ошибку и способ устранения см. в разделе Включение исходящей федерации веб-идентичности). Для Bedrock этот шаг не требуется.
Zero Data Retention (ZDR) на Claude Platform on AWS включается по запросу. На Bedrock обработчиком данных является AWS, и Anthropic не сохраняет входные или выходные данные вывода; программа ZDR от Anthropic там не применяется. На Claude Platform on AWS Anthropic обрабатывает данные вывода как независимый обработчик данных, и ZDR работает по модели собственного Claude API: она доступна по запросу через вашего представителя Anthropic. Подтвердите подключение к ZDR перед миграцией производственных рабочих нагрузок, зависящих от гарантий хранения данных.
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.
ListWorkspaces имеет область действия на уровне учётной записи, поэтому оно указано в отдельном операторе Allow с "Resource": "*". Указание ARN рабочего пространства для действия с областью действия на уровне учётной записи не имеет эффекта (см. Автоматизация подготовки).
Эта политика предполагает аутентификацию AWS SigV4. Если субъект аутентифицируется с помощью ключа API, также добавьте aws-external-anthropic:CallWithBearerToken в оператор Allow с "Resource": "*". CallWithBearerToken — это действие уровня аутентификации без маршрута, которое не привязывается к ARN рабочего пространства. Шаблон с двумя операторами см. в разделе Изоляция рабочих пространств для каждого клиента.
AWS предоставляет пять управляемых политик (AnthropicFullAccess, AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess и AnthropicSelfHostedEnvironmentAccess) для распространённых шаблонов доступа. Действия, предоставляемые каждой политикой, полный список действий IAM, сопоставление маршрутов с действиями и дополнительные примеры политик см. в разделе Действия IAM для Claude Platform on AWS.
Was this page helpful?