Claude no Amazon Bedrock (Opus 4.7 e posteriores)

Este guia orienta você na configuração e na realização de chamadas de API para o Claude no Amazon Bedrock. O Claude no Amazon Bedrock é executado em infraestrutura gerenciada pela AWS com zero acesso de operador (o pessoal da Anthropic não tem acesso à infraestrutura de inferência), permitindo que você crie aplicações sensíveis inteiramente dentro do limite de segurança da AWS, usando o mesmo formato da Messages API que você usa com a API própria da Anthropic.

Acesso

O Amazon Bedrock define critérios de acesso para cada modelo Claude individualmente. Claude Fable 5.1, Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5, Claude Opus 4.7 e Claude Haiku 4.5 estão abertos a todos os clientes do Amazon Bedrock. Para os critérios atuais de qualquer outro modelo, verifique o acesso a modelos do Amazon Bedrock no console da AWS. O Claude Mythos Preview requer um convite por meio do Project Glasswing. Para disponibilidade por região, consulte Regiões.

Pré-requisitos

Antes de começar, certifique-se de ter:

• Uma conta da AWS com acesso a modelos do Amazon Bedrock habilitado para os modelos Claude que você pretende usar.
• A AWS CLI instalada e configurada (opcional, para gerenciamento de credenciais).

O Claude Mythos Preview requer adicionalmente uma conta da AWS dedicada que tenha sido incluída na lista de permissões pela equipe do Bedrock Marketplace. Seu executivo de contas da Anthropic pode enviar o ID da sua conta para inclusão na lista de permissões (normalmente processado em até 24 horas), e a AWS envia um e-mail de boas-vindas quando o processo é concluído.

Autenticação

O Claude no Amazon Bedrock oferece suporte a três caminhos de autenticação. Escolha o que melhor se adapta aos seus requisitos de segurança.

Função de serviço do Bedrock (recomendado)

Use uma função de serviço do Bedrock com chaves gerenciadas pela AWS para o acesso mais seguro e de longa duração:

1. 1

   Administrador: provisionar a função de serviço

   Um administrador da AWS provisiona uma função de serviço do Bedrock e concede aos desenvolvedores a permissão iam:PassRole no ARN da função de serviço.

2. 2

   Desenvolvedor: passar a função

   Ao chamar a API, o Bedrock assume a função de serviço em seu nome. Consulte a documentação do Amazon Bedrock para saber como associar a função às suas requisições.

Funções assumidas do IAM

Para acesso federado por identidade com sessão máxima de 12 horas:

1. 1

   Administrador: configurar a função do IAM

   Crie uma função do IAM com escopo restrito aos seus modelos Claude. A política de confiança nomeia seu provedor de identidade (SAML, OIDC ou AWS Identity Center). A política de permissões concede bedrock-mantle:CreateInference apenas nos ARNs de modelo permitidos.

2. 2

   Desenvolvedor: autenticar e assumir

   Autentique-se por meio do seu provedor de identidade corporativo e, em seguida, assuma a função do IAM. O AWS STS emite credenciais temporárias que o SDK ou a CLI usa para assinar as requisições.

Tokens bearer

Para acesso de curto prazo sem funções do IAM (máximo de 12 horas, opção menos preferida):

1. 1

   Administrador: restringir tipos de token

   Bloqueie chaves de longo prazo anexando uma política que negue bedrock:CallWithBearerToken, a menos que a condição bedrock:BearerTokenType corresponda a um token de curto prazo.

2. 2

   Desenvolvedor: gerar um token

   Use a CLI aws-bedrock-token-generator para gerar um token bearer. Passe-o no cabeçalho x-api-key em cada requisição.

Instalar um SDK

Os SDKs de cliente da Anthropic oferecem suporte ao Claude no Amazon Bedrock por meio de um pacote ou módulo específico para o Bedrock.

pip install -U "anthropic[bedrock]"

Fazendo sua primeira requisição

O endpoint segue o padrão https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. Diferentemente da integração baseada em InvokeModel, este endpoint usa streaming SSE padrão e o mesmo formato de corpo de requisição da API própria da Anthropic.

O SDK resolve as credenciais e a região usando a precedência padrão da AWS: argumentos do construtor, depois variáveis de ambiente (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), depois o arquivo de configuração da AWS e a cadeia de credenciais (SSO, funções assumidas, função de tarefa do ECS, IMDS).

from anthropic import AnthropicBedrockMantle

client = AnthropicBedrockMantle(aws_region="us-east-1")

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

print(next(block.text for block in message.content if block.type == "text"))

Modelos compatíveis

Os IDs de modelo no Claude no Amazon Bedrock têm o prefixo de provedor anthropic.. As capacidades e os comportamentos dos modelos estão documentados na página Visão geral dos modelos.

Use o Claude Code 2.1.255 ou posterior com o Claude Fable 5.1 no Amazon Bedrock; execute claude update para atualizar.

Suporte a recursos

Para a lista completa de recursos com disponibilidade no Amazon Bedrock, consulte Visão geral dos recursos.

Destaques dos recursos compatíveis

• Messages API (/anthropic/v1/messages)
• Prompt caching (cache de prompt)
• Pensamento
• Tool use (uso de ferramentas), incluindo a ferramenta Bash, a ferramenta de uso do computador, a ferramenta de memória e a ferramenta de editor de texto
• Citações

Recursos não compatíveis

• Saídas estruturadas
• Fontes de entrada (fontes de URL para imagens e documentos, Files API)
• Ferramentas do lado do servidor (execução de código, pesquisa na web, busca na web, advisor)
• Infraestrutura de agentes (Agent Skills, conector MCP, chamada programática de ferramentas)
• Endpoints de API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Fallback do lado do servidor (o parâmetro fallbacks; use o padrão de fallback do lado do cliente em vez disso)
• Conjuntos de ferramentas de uso do computador e uso do navegador (computer_toolset_20260801 e browser_toolset_20260801 não estão disponíveis atualmente no Amazon Bedrock; as versões beta da ferramenta de uso do computador continuam disponíveis)

Regiões

O Claude no Amazon Bedrock está disponível nas seguintes regiões da AWS. O Amazon Bedrock oferece dois tipos de endpoint:

• Global: roteamento dinâmico entre todas as regiões disponíveis para máxima disponibilidade. Sem acréscimo de preço.
• Regional: o endpoint é resolvido para a única região da AWS que você especificar, para requisitos de residência de dados. Os endpoints regionais têm um acréscimo de preço de 10% em relação aos endpoints globais. Para rotear entre várias regiões dentro de uma geografia, use um perfil de inferência (US, EU, JP ou AU). As regiões marcadas como Somente na região na tabela oferecem suporte ao roteamento direto para uma única região sem um perfil de inferência.

O endpoint global está disponível para Claude Fable 5.1, Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 e Claude Haiku 4.5. Para o Claude Fable 5.1, os endpoints regionais estão atualmente disponíveis apenas em us-east-1. O Claude Mythos Preview é somente regional e está disponível em us-east-1.

Cotas

A cota padrão é de 2 milhões de tokens de entrada por minuto (TPM). Você pode solicitar até 5 milhões de TPM de entrada e 500.000 TPM de saída sem aprovação adicional da Anthropic. A AWS aplica limites de requisições por minuto (RPM) no lado do Bedrock; entre em contato com o suporte da AWS para ajustes de RPM.

Retenção de dados

O tratamento de dados para esta oferta é regido pelo Amazon Bedrock. Para detalhes, consulte Proteção de dados no Amazon Bedrock.

Monitoramento e registro de logs

O Claude no Amazon Bedrock emite logs tanto para o CloudWatch quanto para o CloudTrail. A Anthropic recomenda reter os logs de atividade em uma base contínua de pelo menos 30 dias para entender os padrões de uso e investigar possíveis problemas.

Suporte

Para suporte, entre em contato com bedrock-ant-eap@amazon.com. Inclua o ID da sua conta da AWS e o request-id de quaisquer respostas de API com falha.