Claude Platform on AWS

O Claude Platform on AWS oferece a experiência completa da plataforma Anthropic, incluindo a Messages API, Agent Skills, execução de código e recursos beta, acessíveis através da sua conta AWS. Diferentemente do Amazon Bedrock, onde a AWS opera a pilha de inferência, a Anthropic opera o Claude Platform on AWS. A AWS fornece a camada de autenticação (SigV4 ou chave de API), controle de acesso baseado em IAM e integração de faturamento através do AWS Marketplace.



Como funciona a integração da plataforma

Os modelos Claude são executados em infraestrutura gerenciada pela Anthropic. Esta é uma integração comercial para faturamento e acesso através da AWS. A Anthropic é a processadora de dados para entradas e saídas de inferência. A AWS processa metadados de faturamento e identidade sob o modelo de marketplace. Clientes que usam o Claude através do Claude Platform on AWS estão sujeitos aos termos de uso de dados da Anthropic.

O Claude Platform on AWS tem as seguintes características operacionais: os dados podem não residir na AWS, a inferência pode ser roteada para a nuvem primária da Anthropic, e os subserviços podem mudar sem aviso prévio. Defina o parâmetro inference_geo por requisição para fixar a inferência em uma geografia específica.

O Claude Platform on AWS segue a mesma política de retenção de dados da Claude API primária. Zero Data Retention (ZDR) está disponível mediante solicitação. Entre em contato com seu representante de conta da Anthropic para habilitá-lo para sua organização.



Claude Platform on AWS vs Amazon Bedrock

Ambas as ofertas permitem que você use o Claude através da AWS, mas diferem em arquitetura, superfície de API e disponibilidade de recursos.

Se você precisa do Claude operado pela AWS, consulte Claude no Amazon Bedrock. O Claude Platform on AWS usa um pool de capacidade separado tanto da Claude API primária quanto do Amazon Bedrock. Você pode executar cargas de trabalho em mais de uma plataforma e fazer failover entre elas.

O AWS PrivateLink é suportado para conectar sua VPC ao endpoint do Claude Platform on AWS.

Quando escolher o Bedrock: Organizações em setores regulamentados que exigem conformidade FedRAMP High, IL4, IL5 ou HIPAA-ready, ou que precisam que a AWS seja a única processadora de dados, devem usar o Claude no Amazon Bedrock. O Bedrock é executado inteiramente em infraestrutura controlada pela AWS, com a AWS como parte operadora.

Qual oferta você está usando? O Claude está disponível através de vários produtos distintos:

• Claude Platform on AWS (esta página): A plataforma Claude API faturada através do AWS Marketplace. Gerenciada no Claude Console e no AWS Console.
• Claude no Amazon Bedrock: Um serviço nativo da AWS. Gerenciado no console do Amazon Bedrock e faturado como uso de serviço AWS.
• Claude Enterprise adquirido através do AWS Marketplace: Um plano do claude.ai (o produto de chat Claude), não uma plataforma de API. Gerenciado em claude.ai, e seu comportamento de conta e migração difere do que esta página descreve. Consulte a Central de Ajuda do Claude.
• Contas diretas da Anthropic: A Claude API primária e planos do claude.ai faturados pela Anthropic. Gerenciados no Claude Console e em claude.ai.



Configurar sua conta

A configuração do Claude Platform on AWS acontece em quatro fases: inscrever-se na página de serviço do AWS Console, concluir a configuração da sua organização Anthropic, anotar seu ID de workspace e fazer login no Claude Console.



Migrando de uma organização Anthropic existente

Inscrever-se no Claude Platform on AWS sempre provisiona uma nova organização Anthropic vinculada à sua conta AWS. Não há conversão in-place: uma organização existente, como uma organização da Claude API primária, não pode se tornar uma organização do Claude Platform on AWS.

Planeje a migração de uma organização existente como uma transição para uma nova:

• Crie a nova organização primeiro. Inscreva-se através do AWS Console (consulte Configurar sua conta). Se sua migração envolve uma oferta privada, conclua a inscrição antes que a oferta seja aceita: descontos são aplicados a partir da aceitação, não retroativamente. Consulte Ofertas privadas.
• Recrie acesso e configuração. Chaves de API, workspaces e configurações do Claude Console não são transferidos de uma organização existente. Crie workspaces na nova organização e mude suas aplicações para a autenticação do Claude Platform on AWS.
• Atualize sua integração. O Claude Platform on AWS serve a Claude API (/v1/{endpoint}), então os formatos de requisição e resposta permanecem inalterados em relação à Claude API primária. O que muda é a URL base, o método de autenticação e o cabeçalho obrigatório anthropic-workspace-id; consulte Fazendo requisições. Alguns recursos da plataforma diferem; consulte Recursos não suportados.
• Faça a transição no seu próprio ritmo. A nova organização é independente da sua organização existente, e ambas podem servir tráfego em paralelo. Não há necessidade de uma transição abrupta: migre as cargas de trabalho gradualmente até que todo o seu tráfego esteja na nova organização.

Uma vez que a nova organização esteja em execução, as diferenças se concentram em faturamento e autenticação, que são tratados através da AWS:

• Faturamento passa para o AWS Marketplace: o uso é faturado em Claude Consumption Units em vez de créditos pré-pagos (consulte Faturamento), e limites de gastos são gerenciados na página Billing em vez da página Limits (consulte Limites de gastos). Durante a transição, o faturamento permanece separado: a organização existente continua sendo faturada como é hoje.
• Autenticação e acesso passam para a AWS: requisições são autenticadas com credenciais AWS ou com chaves de API geradas no AWS Console, não no Claude Console (consulte Autenticação). A associação à organização é gerenciada através do AWS IAM em vez do Claude Console (consulte Páginas disponíveis), e os SDKs de cliente da Anthropic fornecem classes de cliente específicas da plataforma (consulte Instalar um SDK).
• Uso diário da API funciona da mesma forma que na Claude API primária, exceto onde indicado nas limitações de recursos. Antes de migrar tráfego de produção, verifique seus limites de taxa: novas organizações são colocadas no tier Start, e aumentos de limite passam pelo seu representante de conta da Anthropic (consulte Limites de taxa e cotas).

Para organizações Claude Enterprise (claude.ai), que se comportam de forma diferente, consulte a comparação de ofertas.



Solução de problemas na configuração da conta

• "Sign-up failed: Failed to enable OutboundWebIdentityFederation": Se você vir este banner no primeiro envio, escolha Continue novamente. A habilitação do IAM pode levar um momento para entrar em vigor.
• Nenhum indicador de progresso durante a inscrição: A inscrição leva alguns minutos. A página mostra um banner estático Sign-up in progress sem barra de progresso enquanto a AWS provisiona sua conta.
• "Signed in as a different account" após seguir o link de configuração: Escolha Log out and continue. A página reautentica você com o endereço de e-mail que você inseriu.
• Mensagem "Not found" durante o login: Esta mensagem pode aparecer brevemente durante o redirecionamento. Você pode descartá-la.
• Página de uso não mostra dados após sua primeira chamada de API: Dados de uso podem levar alguns minutos para aparecer no Claude Console.
• "Outbound web identity federation is disabled" na sua primeira chamada de API: Habilite a federação uma vez por conta. Consulte Habilitar federação de identidade web de saída.



Antes de fazer chamadas de API

Certifique-se de ter:

1. Uma conta AWS ativa com uma assinatura do Claude Platform on AWS (consulte Configurar sua conta)
2. A AWS CLI instalada e configurada
3. Federação de identidade web de saída habilitada na sua conta AWS, uma etapa de configuração única (consulte Habilitar federação de identidade web de saída)
4. Seu ID de workspace (consulte Obter seu ID de workspace)
5. Permissão IAM para chamar a API: a ação aws-external-anthropic:CreateInference no seu workspace, além de aws-external-anthropic:CallWithBearerToken se você autenticar com uma chave de API (consulte Políticas IAM)



Habilitar federação de identidade web de saída

O gateway do Claude Platform on AWS chama sts:GetWebIdentityToken no lado do servidor para gerar um JWT que encaminha para a Anthropic. Esse recurso do STS está desabilitado por padrão em todas as contas AWS. Habilite-o uma vez por conta:

aws iam enable-outbound-web-identity-federation

Se a resposta for [ERROR] (FeatureEnabled) ... already enabled, a configuração já está ativada para sua conta e você pode prosseguir. Verifique e recupere a URL do emissor da sua conta:

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



Obter seu ID de workspace

Você cria um workspace a partir do AWS Console após concluir a configuração da conta (consulte Configurar sua conta). Workspaces são vinculados a uma única região AWS. Você pode encontrar o ID do workspace no Claude Console em Workspaces ou na seção Workspaces da página de serviço do AWS Console.

Defina as variáveis de ambiente ANTHROPIC_AWS_WORKSPACE_ID e AWS_REGION para que os clientes SDK as leiam automaticamente:

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

A região é obrigatória. O cliente SDK gera um erro se nenhuma região for definida. Passe aws_region/awsRegion para o construtor, ou defina AWS_REGION (ou AWS_DEFAULT_REGION). Todas as regiões comerciais da AWS são suportadas.



Autenticação

O Claude Platform on AWS suporta dois métodos de autenticação: AWS IAM com assinatura de requisição Signature Version 4 (SigV4) (primário) e autenticação por chave de API. Ambos usam a mesma URL base e formato de requisição.



Autenticação SigV4

SigV4 é o caminho nativo para empresas e se integra com suas políticas, funções e auditoria AWS IAM existentes. Configure credenciais AWS usando qualquer método suportado pela cadeia padrão de provedores de credenciais da AWS:

• Variáveis de ambiente (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN)
• Arquivo de credenciais compartilhado (~/.aws/credentials)
• Arquivo de configuração compartilhado (~/.aws/config) incluindo SSO e credential_process
• Identidade web (AWS_WEB_IDENTITY_TOKEN_FILE e AWS_ROLE_ARN) para IRSA e GitHub Actions
• Credenciais de contêiner ECS
• Serviço de metadados de instância EC2 (IMDS)

Verifique se suas credenciais estão funcionando:

aws sts get-caller-identity



Autenticação por chave de API

Para caminhos de integração mais simples (desenvolvimento local e scripts), você pode autenticar com uma chave de API em vez de SigV4. Defina a variável de ambiente ANTHROPIC_AWS_API_KEY ou passe apiKey para o construtor do SDK.

Gere chaves de API no AWS Console em Claude Platform on AWS → API keys. Escolha Generate a key e copie o valor da chave. Conceda a ação IAM aws-external-anthropic:CallWithBearerToken aos principals que devem ter permissão para usar autenticação por chave de API.



Chaves de API de curto prazo

Para cargas de trabalho que precisam passar uma credencial para um processo separado (como um gateway de LLM, uma função serverless ou uma ferramenta que suporta autenticação por bearer token mas não SigV4), gere uma chave de API de curto prazo a partir de suas credenciais AWS em vez de provisionar uma chave de longa duração no AWS Console.

A AWS publica bibliotecas geradoras de token para JavaScript, Python e Java. Cada biblioteca lê suas credenciais AWS através da cadeia padrão de provedores e retorna um token com tempo limitado que funciona com o cabeçalho x-api-key. A duração do token tem padrão de 12 horas e é limitada ao menor valor entre a duração solicitada, a expiração de suas credenciais AWS e 12 horas. Consulte os READMEs dos repositórios vinculados para instalação e opções completas de configuração.

Passe o token gerado para o SDK da mesma forma que você passaria uma chave de API gerada no 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")

Se você pode gerar o token localmente, seu processo já tem credenciais SigV4, e a autenticação SigV4 geralmente é a escolha mais simples. Use chaves de curto prazo quando o processo que faz chamadas de API for separado do processo que detém as credenciais AWS.

O SDK não atualiza chaves de curto prazo automaticamente. Quando um token expira, gere um novo e construa um novo cliente. O principal que usa o token ainda precisa da ação IAM aws-external-anthropic:CallWithBearerToken.



Precedência de credenciais

O cliente específico da plataforma resolve a autenticação na seguinte ordem. Os nomes dos argumentos variam conforme a convenção da linguagem: TypeScript e PHP usam camelCase como mostrado, Python e Ruby usam snake_case, Go usa PascalCase com acrônimos em maiúsculas, e C# e Java usam os idiomas de propriedade ou builder da linguagem.

1. Argumento do construtor apiKey → cabeçalho x-api-key
2. Argumentos do construtor awsAccessKey + awsSecretAccessKey → AWS SigV4
3. Argumento do construtor awsProfile → AWS SigV4 com perfil nomeado
4. Variável de ambiente ANTHROPIC_AWS_API_KEY → cabeçalho x-api-key
5. Cadeia padrão de provedores de credenciais AWS → AWS SigV4



Resolução de região

O cliente lê AWS_REGION do ambiente se aws_region/awsRegion não for passado para o construtor, recorrendo a AWS_DEFAULT_REGION para compatibilidade com os SDKs padrão da AWS. A região é obrigatória. Não há padrão de fallback. Diferentemente do AnthropicBedrock, que recorre a us-east-1, o cliente AnthropicAWS/AnthropicAws gera um erro se nem o argumento do construtor nem a variável de ambiente estiverem definidos.



Instalar um SDK

Os SDKs de cliente da Anthropic suportam o Claude Platform on AWS. Cada SDK fornece uma classe de cliente específica da plataforma que lida com assinatura SigV4, construção de URL base baseada em região e o cabeçalho anthropic-workspace-id.

pip install -U "anthropic[aws]"



Modelos disponíveis

Os seguintes modelos estão disponíveis no Claude Platform on AWS:

Os IDs de modelo são idênticos aos da Claude API primária. Não há ARNs no estilo Bedrock ou prefixos anthropic..

Novos modelos normalmente são lançados no Claude Platform on AWS no mesmo dia que na Claude API primária.



Fazendo requisições

O Claude Platform on AWS usa os mesmos endpoints de API que a Claude API primária. As diferenças são a URL base, o método de autenticação e um cabeçalho obrigatório anthropic-workspace-id que identifica qual workspace a requisição tem como alvo.

Antes de executar estes exemplos, conclua as etapas em Antes de fazer chamadas de 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)

O cliente lê AWS_REGION (ou AWS_DEFAULT_REGION) e ANTHROPIC_AWS_WORKSPACE_ID do ambiente. Você pode substituir qualquer um deles passando aws_region / awsRegion ou workspace_id / workspaceId para o construtor. Tanto a região quanto o ID do workspace são obrigatórios. O construtor gera um erro se qualquer um deles não puder ser resolvido.

O valor de --aws-sigv4 segue o formato aws:amz:<region>:<service>. O nome do serviço SigV4 é aws-external-anthropic, e a região deve corresponder à região na URL do seu endpoint. Uma incompatibilidade em qualquer um deles produz um erro genérico de rejeição de assinatura em vez de um diagnóstico específico.



Janela de contexto

Os tamanhos de "context window" (janela de contexto) no Claude Platform on AWS são idênticos aos da Claude API primária. Consulte Janelas de contexto para limites por modelo.



Suporte a recursos

O Claude Platform on AWS usa endpoints da Claude API diretamente, o que significa que você obtém paridade completa de recursos com a Claude API primária (exceto onde indicado nas limitações de recursos):

• Acesso a recursos: Como a Anthropic opera ambas as plataformas, a maioria dos novos recursos e cabeçalhos beta fica disponível no Claude Platform on AWS sem uma etapa de integração separada. Consulte limitações de recursos para exceções.
• Recursos beta: Passe o cabeçalho padrão anthropic-beta para acessar recursos beta, assim como você faria com a Claude API.
• Agent Skills: Use Agent Skills pré-construídas e personalizadas com o mesmo parâmetro container.skills e cabeçalhos beta da Claude API. Todas as Skills pré-construídas (PowerPoint, Excel, Word, PDF) funcionam imediatamente.
• Execução de código: Execute código no sandbox gerenciado da Anthropic usando a ferramenta de execução de código.
• Uso de ferramentas: Computer use e todas as outras capacidades de uso de ferramentas estão disponíveis.
• Pensamento estendido: Habilite o pensamento estendido com os mesmos parâmetros da Claude API.
• Streaming: Suporte completo a streaming SSE para respostas em tempo real.
• Processamento em lote: Envie requisições em lote para cargas de trabalho de alto throughput.
• Cache de prompt: Armazene em cache ferramentas, prompts do sistema e histórico de mensagens para reduzir latência e custo. Todas as capacidades de cache de prompt (TTL de 5 minutos, TTL de 1 hora e cache automático) estão disponíveis.
• Files API: Faça upload e referencie arquivos entre requisições.
• Chaves de criptografia gerenciadas pelo cliente (CMEK): CMEK está disponível apenas com chaves do AWS KMS. Chaves do Google Cloud KMS e do Azure Key Vault não podem ser registradas. Crie, valide e anexe chaves no Claude Console. Os endpoints external_keys da Admin API não estão disponíveis atualmente. A chave deve estar na mesma região AWS que o workspace ao qual está anexada.
• Compliance API: A Compliance API está disponível. O acesso é autorizado através da ação ListComplianceActivities do AWS IAM.

Consulte a tabela de comparação para diferenças de disponibilidade de recursos em relação ao Amazon Bedrock.



Claude Managed Agents

O Claude Managed Agents está disponível no Claude Platform on AWS, incluindo agentes, ambientes, sessões, cofres de credenciais, armazenamentos de memória, webhooks, orquestração multiagente e sandboxes auto-hospedados.

O comportamento de sessão no Claude Platform on AWS difere do Claude Managed Agents primário de uma forma:

• Reautenticação de sessão autônoma: Uma sessão pode ser executada de forma autônoma, sem nenhum evento de usuário, por até 6 horas. Após 6 horas, a sessão requer reautenticação antes de continuar. Para reautenticar, envie qualquer evento de função de usuário para a sessão (consulte Eventos e streaming). O Claude Managed Agents primário não tem limite de tempo de execução de sessão autônoma.



Recursos não suportados

As seguintes capacidades não estão disponíveis atualmente no Claude Platform on AWS:

• Prontidão para HIPAA: O programa HIPAA-ready da Anthropic não está disponível. Consulte API e retenção de dados.

• Admin API: Endpoints de workspace (criar, obter, listar, atualizar e arquivar em /v1/organizations/workspaces) estão disponíveis. Outros endpoints da Admin API (membros da organização, membros do workspace, convites, chaves de API, relatórios de uso, relatórios de custo, relatórios de limite de taxa e chaves externas) não estão disponíveis atualmente. Gerencie chaves CMEK no Claude Console em vez disso. Visualize dados de uso e custo no Claude Console em vez disso. O AWS IAM gerencia a associação à organização.
• Gerenciamento de membros do workspace: Adicionar ou remover usuários de workspaces individuais não está disponível. Políticas AWS IAM em ARNs de workspace controlam o acesso.
• Workspace do Claude Code e Analytics API: O workspace do Claude Code com limites de taxa automáticos não está disponível. O uso do Claude Code aparece na visualização geral de uso em vez de uma tela dedicada.
• Autenticação OAuth: Não suportada. Use autenticação SigV4 ou por chave de API.
• Fast mode: Não disponível no Claude Platform on AWS.
• Endpoints de API compatíveis com OpenAI: Não disponíveis no Claude Platform on AWS.
• Túneis MCP: Apenas servidores MCP expostos pela internet pública são suportados.



Residência de dados

O Claude Platform on AWS suporta as seguintes geografias de inferência:

• US: A inferência permanece dentro de data centers dos EUA. Um multiplicador de preço de 1,1x é aplicado.
• Global: A inferência pode ser roteada para qualquer data center operado pela Anthropic no mundo. Preços padrão são aplicados.

Defina a geografia de inferência por requisição com o parâmetro 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)

Se você omitir inference_geo, a requisição usa o default_inference_geo do workspace se um estiver configurado, caso contrário global.

Controles de geografia de inferência no nível do workspace (allowed_inference_geos e default_inference_geo) também estão disponíveis no Claude Platform on AWS. Consulte Restrições no nível do workspace.



Workspaces

As requisições de inferência e de recursos na Claude Platform on AWS têm como alvo um workspace. Você passa o ID do workspace no cabeçalho anthropic-workspace-id nessas chamadas de API. Os IDs de workspace usam o formato com prefixo wrkspc_ seguido de um identificador alfanumérico (por exemplo, wrkspc_01AbCdEf23GhIj). Consulte Obter o ID do seu workspace se você ainda não o tiver.



Escopo de workspace

Workspaces são vinculados a uma única região da AWS. Um workspace criado em us-west-2 só pode ser acessado através do endpoint us-west-2. Uso, cotas, custo, arquivos, batches e Skills são todos agregados por workspace, fornecendo detalhamentos por região no Claude Console.

Workspaces também servem como o recurso IAM principal para a Claude Platform on AWS. Você concede ou nega acesso a workspaces específicos através de políticas do AWS IAM usando o ARN do workspace. O segmento de recurso do ARN é o mesmo ID com prefixo wrkspc_ que você passa no cabeçalho anthropic-workspace-id:

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

Por exemplo:

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

Consulte Políticas IAM para exemplos de políticas.



Gerenciando workspaces

Crie workspaces adicionais, renomeie um workspace ou arquive um workspace na página Workspaces do AWS Console ou com os endpoints de workspace da Admin API. Um novo workspace é vinculado à região da AWS do endpoint que você chama para criá-lo (consulte Escopo de workspace). A página Workspaces do Claude Console é somente leitura.



Usando o Claude Console

A Claude Platform on AWS usa o Claude Console padrão em platform.claude.com. Quando você faz login a partir do AWS Console, um indicador Account managed by AWS aparece no canto inferior esquerdo da barra lateral do Claude Console, e o Console é delimitado à sua organização da Claude Platform on AWS. Ele fornece análises de uso, detalhamentos de custo, visibilidade de limites de taxa, visibilidade de workspaces e páginas para gerenciar arquivos, Agent Skills, jobs de batch e recursos do Claude Managed Agents (agentes, sessões, ambientes, cofres de credenciais, armazenamentos de memória e webhooks).



Fazendo login

O acesso ao Claude Console é federado através do AWS IAM. Consulte Configurar sua conta para o fluxo completo de primeiro login. Em resumo:

1. Assuma uma função IAM com a permissão aws-external-anthropic:AssumeConsole. Consulte Ações IAM para Claude Platform on AWS.
2. Navegue até a página Claude Platform on AWS no AWS Console.
3. Escolha Open Claude Console. O AWS Console emite um JWT e redireciona você para platform.claude.com.
4. No primeiro login, você é solicitado a fornecer um endereço de e-mail. Insira seu e-mail de trabalho. A plataforma provisiona seu usuário do Claude Console just-in-time.

Duas funções do Claude Console estão disponíveis: Admin e Developer. A função Admin concede acesso a todas as páginas e configurações do Claude Console disponíveis para a Claude Platform on AWS. A função Developer concede acesso de leitura a informações de uso, custo, limites de taxa e workspaces. Entre em contato com seu representante de conta da Anthropic para atribuir a função Admin ou Developer a um principal.



Páginas disponíveis

A coluna Através do gateway AWS indica se a página lê e grava dados através do gateway AWS (e, portanto, é governada por ações IAM). Páginas marcadas como Não leem metadados no nível da organização diretamente da Anthropic e ignoram as verificações de ações IAM.



Alternando entre organizações

O Claude Console não oferece suporte à alternância de organizações para a Claude Platform on AWS. Para acessar uma organização diferente, saia e reautentique através do AWS Console usando a função IAM da conta AWS dessa organização.



Limites de taxa e cotas

Organizações na Claude Platform on AWS são colocadas no tier Start. A Anthropic gerencia os limites de taxa diretamente, não através dos sistemas de cotas da AWS.

Organizações na Claude Platform on AWS não avançam entre tiers de uso automaticamente. O avanço de tier baseado em uso se aplica a organizações first-party da Claude API, não a organizações faturadas através do AWS Marketplace. O fluxo de autoatendimento Request rate limit increase no Claude Console também não está disponível: a página Rate limits direciona você ao seu representante de conta da Anthropic.

Para solicitar limites mais altos, entre em contato com seu representante de conta da Anthropic ou com o suporte da Anthropic. Inclua o seguinte em sua solicitação:

• Os modelos para os quais você precisa de aumento
• Pico de tokens de entrada por minuto e tokens de saída por minuto para cada modelo (não totais diários)
• A proporção aproximada da sua entrada que é contexto em cache ou repetido (leituras de cache não contam para os limites de tokens de entrada na maioria dos modelos; consulte ITPM com reconhecimento de cache)

Os tiers de uso são etapas fixas: cada tier combina limites de taxa com um teto de gastos mensal, e passar para um tier mais alto aumenta ambos. Para detalhes de tiers e limites por modelo, consulte Limites de taxa.



Faturamento

A Claude Platform on AWS fatura através do AWS Marketplace. O uso é denominado em Claude Consumption Units (CCUs), medido por hora e faturado mensalmente em atraso na sua fatura da AWS. CCUs não são créditos pré-pagos. Não há saldo ou compromisso de CCU.

Para o preço de CCU, mecânica de conversão, aplicação de descontos e taxas de token por modelo, consulte Preços da Claude Platform on AWS.



Limites de gastos

Os tiers de uso Start, Build e Scale carregam cada um um teto de gastos mensal; consulte os tetos de gastos por tier para os valores atuais. O teto de gastos e os limites de taxa pertencem ao mesmo tier, então, para aumentar o teto, solicite um aumento de tier através do seu representante de conta da Anthropic ou do suporte (consulte Limites de taxa e cotas).

Você também pode definir seu próprio limite de gastos mensal para limitar o que sua organização gasta:

• Limite de gastos da organização: Vá para Settings > Billing no Claude Console para definir um limite de gastos mensal.
• Limites de gastos de workspace: Defina limites de gastos mensais para workspaces individuais nas configurações de Spend limits de cada workspace.

Os limites de gastos que você define são limites flexíveis: os gastos são calculados com base nos preços de tabela e podem levar cerca de duas horas para refletir o uso recente.



Monitoramento e logging

O AWS CloudTrail pode capturar todas as requisições para a Claude Platform on AWS. Operações de workspace, compliance, cofre e webhook são registradas como eventos de Management por padrão. Operações de inferência, batch, arquivo, skill, modelo, perfil de usuário e Claude Managed Agents (exceto cofres e webhooks) são classificadas como eventos de Data e exigem configuração explícita de logging de eventos de dados, o que incorre em cobranças adicionais do CloudTrail. Consulte a referência de ações IAM para a classificação completa de tipos de eventos e a documentação do AWS CloudTrail para detalhes de configuração.



IDs de requisição

Cada resposta inclui dois IDs de requisição nos cabeçalhos de resposta:

• ID de requisição da AWS (x-amzn-requestid): O ID primário, indexado no CloudTrail. Use este ao investigar requisições através de ferramentas da AWS ou ao entrar em contato com o suporte da AWS.
• ID de requisição da Anthropic (request-id): O ID secundário. Use este ao entrar em contato com o suporte da 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)

A Anthropic recomenda registrar sua atividade em uma base contínua de pelo menos 30 dias para entender padrões de uso e investigar problemas.



Migrando do Amazon Bedrock

Se você atualmente usa Claude no Bedrock, migrar para a Claude Platform on AWS requer mudanças em toda a sua integração. A assinatura SigV4 continua sendo suportada, mas o contexto de assinatura, URL base, formato de API, IDs de modelo, cliente e pacote do SDK, formato de streaming, cabeçalhos de requisição e disponibilidade de região mudam. A Claude Platform on AWS também provisiona uma nova organização da Anthropic. A tabela a seguir resume as diferenças.



O que muda

O delta de migração depende de qual integração do Bedrock você está vindo. A tabela a seguir mostra tanto a integração atual do Bedrock (Messages API em bedrock-mantle.{region}.api.aws) quanto a integração legada InvokeModel.

Se você está na integração atual do Bedrock, o formato do corpo da requisição já é a Messages API. As mudanças são a URL base, o nome de serviço SigV4, os IDs de modelo e a adição do cabeçalho anthropic-workspace-id. Se você está na API legada InvokeModel ou Converse, também precisará reescrever os formatos de requisição e resposta para o formato da Messages API. Consulte Claude on Amazon Bedrock (Opus 4.6 e anteriores) para o mapeamento de formato de requisição.



O que você ganha

• Acesso tipicamente no mesmo dia a novos modelos e recursos (consulte limitações de recursos)
• Agent Skills para geração de documentos (PowerPoint, Excel, Word, PDF)
• Execução de código no sandbox gerenciado da Anthropic
• Recursos beta através do cabeçalho anthropic-beta (consulte limitações de recursos)
• Claude Console para visibilidade de cotas e análises de uso
• Suporte direto da Anthropic
• Autenticação por chave de API como alternativa ao SigV4 (consulte Autenticação por chave de API)



O que permanece igual

• Autenticação AWS IAM (SigV4)
• AWS como a parte faturadora. O canal de faturamento muda de serviço nativo da AWS para AWS Marketplace (consulte Considerações comerciais).
• Retirada de compromisso da AWS



Armadilhas de migração



Considerações comerciais

• Termos de serviço da Anthropic: Usar a Claude Platform on AWS requer aceitar os Termos de Serviço Comerciais e a Política de Uso da Anthropic. Se sua organização ainda não aceitou esses termos (por exemplo, se você só usou Claude através do Bedrock), você será solicitado durante a configuração da conta. Consulte Configurar sua conta.
• Descontos e ofertas privadas: Descontos negociados e ofertas privadas do AWS Marketplace não são transferidos automaticamente entre o Bedrock e a Claude Platform on AWS. Trabalhe com seu representante de conta da Anthropic para configurar termos comerciais para a Claude Platform on AWS.



Políticas IAM

A Claude Platform on AWS integra-se com o AWS IAM para controle de acesso. Você concede ou nega acesso a ações de API específicas em workspaces específicos usando a sintaxe padrão de políticas IAM.

O nome de serviço SigV4 e o namespace de ação IAM é aws-external-anthropic. As ações seguem o padrão aws-external-anthropic:<Action> (por exemplo, aws-external-anthropic:CreateInference).



Exemplo: negar inferência em batch

A política a seguir permite inferência em tempo real enquanto bloqueia o processamento em batch:

{
  "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": "*"
    }
  ]
}

A ação GetBatchInference autoriza tanto a rota de metadados de batch quanto a rota de resultados de batch. Negá-la bloqueia ambas as leituras. Para uma política somente de Deny adequada para cargas de trabalho sensíveis a ZDR, consulte Bloqueio de recursos para um workspace sensível a ZDR.



Políticas gerenciadas

A AWS fornece cinco políticas gerenciadas (AnthropicFullAccess, AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess e AnthropicSelfHostedEnvironmentAccess) para padrões de acesso comuns. Para as ações que cada política concede, a lista completa de ações IAM, o mapeamento de rota para ação e exemplos adicionais de políticas, consulte Ações IAM para Claude Platform on AWS.



Próximos passos



Recursos adicionais