Primeiros Passos com o Claude Platform na AWS
Cobrança consolidada, controle de acesso nativo via IAM, auditoria com CloudTrail e acesso no mesmo dia a novos modelos Claude. Tudo sem sair do ecossistema AWS.
Introdução
Claude Platform on AWS é uma integração nativa anunciada em maio de 2026 que dá às organizações acesso à plataforma completa de desenvolvimento da Anthropic diretamente através de sua conta AWS existente. Isso inclui a Messages API, Claude Console, Agent Skills, code execution, batch processing e recursos em beta de acesso antecipado.
Diferente do Amazon Bedrock , onde a AWS opera a stack de inferência e atua como único processador de dados, o Claude Platform on AWS é operado pela Anthropic. A AWS fornece a camada de autenticação (SigV4 ou API key), controle de acesso baseado em IAM, billing consolidado via AWS Marketplace e logging de auditoria através do CloudTrail. Isso significa que seu time pode acessar as capacidades mais recentes do Claude no mesmo dia em que são lançadas, sem gerenciar uma conta Anthropic separada, contrato de fornecedor ou sistema de cobrança.
Se você leu nosso artigo anterior sobre Como Configurar o Claude Code com Amazon Bedrock , este guia apresenta uma abordagem alternativa. Enquanto o Bedrock mantém todos os dados dentro do perímetro de segurança da AWS e está sujeito aos programas de compliance da AWS, o Claude Platform on AWS oferece acesso no mesmo dia aos modelos e recursos mais recentes diretamente da Anthropic. Escolha a opção que melhor se adequa aos requisitos da sua organização.
Este guia orienta você na subscrição do Claude Platform on AWS, configuração de acesso e conexão do Claude Code para validar a integração.
Se seus requisitos de compliance exigem que a AWS seja o único processador de dados ou que as cargas de trabalho permaneçam dentro dos limites de FedRAMP High, IL4, IL5, SOC ou HIPAA, você deve usar o Claude on Amazon Bedrock . Esses programas não se aplicam ao Claude Platform on AWS, onde a inferência é processada pela Anthropic fora do perímetro de segurança da AWS.
Pré-requisitos
Antes de começar, certifique-se de que os seguintes itens estão em ordem:
- Uma conta AWS ativa onde o Claude Platform on AWS será provisionado. Usar uma conta dedicada por ambiente (production, staging, development) é recomendado.
- O AWS CLI v2 instalado e configurado com credenciais que tenham permissões IAM suficientes. Verifique com:
1
2
aws --version
aws sts get-caller-identity
- Permissões IAM para o usuário de setup:
iam:CreatePolicy,iam:AttachRolePolicye permissões de subscription no AWS Marketplace (aws-marketplace:Subscribe).
Step 1: Preparar IAM Policies (Opcional)
Este passo demonstra como configurar o acesso IAM para uma AWS Organization que usa o AWS IAM Identity Center para gerenciar o acesso dos usuários. Nesta configuração, os perfis de acesso são concedidos através de Permission Sets no IAM Identity Center, e as policies são anexadas ao Permission Set que concede acesso à workload account (a conta onde o Claude Platform on AWS está provisionado), não na conta de gerenciamento (root).
Se sua organização concede aos usuários acesso administrativo à workload account diretamente, este passo não é necessário. No entanto, usar acesso administrativo completo traz riscos significativos de segurança, pois concede permissões muito além do necessário para o Claude Platform on AWS. A abordagem abaixo é projetada para empresas com separação de papéis bem definida, onde um desenvolvedor pode receber acesso exclusivamente ao Claude sem privilégios mais amplos na AWS.
1.1 Entender o IAM Namespace
Todas as IAM actions do Claude Platform on AWS usam o namespace
aws-external-anthropic. As actions seguem o padrão aws-external-anthropic:<Action>. As principais actions incluem:aws-external-anthropic:CreateInference(chamadas de API em tempo real)aws-external-anthropic:CreateBatchInference(jobs de batch processing)aws-external-anthropic:AssumeConsole(acesso federado ao Claude Console)aws-external-anthropic:CallWithBearerToken(autenticação por API key)
1.2 Criar um Permission Set com AnthropicFullAccess
Execute este passo na conta de gerenciamento (onde o IAM Identity Center está configurado).
Para este tutorial, usaremos a AWS managed policy
AnthropicFullAccess, que concede aws-external-anthropic:* em todos os recursos. Isso fornece acesso completo a todos os recursos do Claude Platform on AWS incluindo inferência, batch processing, upload de arquivos, gerenciamento de workspaces e federação ao console.1.2.1. No console do IAM Identity Center, crie um novo Permission Set (por exemplo,
AnthropicPlatformAdmin).1.2.2. Em AWS managed policies, anexe
AnthropicFullAccess.1.2.3. Atribua este Permission Set ao grupo ou usuários desejados para a workload account.
Para ambientes produtivos, siga o princípio de privilégio mínimo criando policies com escopo que concedam apenas as actions que sua carga de trabalho precisa. A documentação de IAM policies fornece exemplos para acesso somente de inferência, isolamento por workspace, federação ao console e bloqueio de batch processing.
1.3 Referência de AWS Managed Policies
No momento da escrita, o console da AWS fornece três managed policies para o Claude Platform on AWS:
AnthropicFullAccessAnthropicReadOnlyAccessAnthropicLimitedAccess
É recomendado seguir o princípio de privilégio mínimo ao conceder acesso. Para construir uma policy customizada, planeje quais actions específicas seus usuários precisarão com base em seus papéis e responsabilidades.
Para os fins deste tutorial, como os leitores podem ter diferentes necessidades, usaremos
AnthropicFullAccess para conceder acesso completo aos recursos do Claude Platform on AWS que estamos explorando aqui (e nada além disso). Para ambientes produtivos, você deve restringir as permissões ainda mais. Consulte a documentação de IAM policies para entender as actions disponíveis e construir policies adequadas ao seu caso de uso.Step 2: Inscrever-se no Claude Platform on AWS
2.1 Navegar até a Página do Serviço
2.1.1. Abra o AWS Management Console e faça login com a conta que você designou para o Claude Platform on AWS.
2.1.2. Na barra de busca no topo, digite
Claude Platform on AWS e selecione o serviço nos resultados.
Resultado da busca no AWS Console mostrando o serviço Claude Platform on AWS disponível para seleção
2.2 Iniciar a Inscrição
2.2.1. Na página do serviço Claude Platform on AWS, clique no botão Get started.
Captura de tela da página do serviço Claude Platform on AWS no AWS Console exibindo a descrição do serviço, benefícios e o botão Get started para iniciar a ativação
2.2.2. Uma mensagem "Let's get started" aparecerá, explicando que a ativação do Claude Platform on AWS pode levar alguns minutos e pode exigir um redirecionamento para o site da Anthropic. Revise o alerta informativo sobre seu conteúdo ser processado pela Anthropic fora da AWS.
2.3 Aguardar o Provisionamento
Na página seguinte, um banner "Setup in progress" indica que isso pode levar alguns minutos. Um email de confirmação do AWS Marketplace será enviado para o endereço de email da sua conta AWS. Você pode sair desta página com segurança e voltar mais tarde.
Tela de provisionamento em andamento após clicar em Continue, indicando que o processo pode levar alguns minutos
Após a conclusão, você será redirecionado automaticamente para platform.claude.com/partner-signup para completar a configuração da sua organização Anthropic.
Se sua organização possui uma oferta privada pré-negociada com a Anthropic, consulte Private offers para detalhes sobre como aplicar seu desconto antes de se inscrever.
Step 3: Configurar Sua Organização Anthropic (Opcional)
Se sua organização Anthropic não foi criada automaticamente durante o Step 2, você será redirecionado para platform.claude.com/partner-signup para completar a configuração manualmente. Pule este passo se sua organização já foi provisionada ao final do processo de inscrição.
3.1 Informar o Email do Proprietário da Organização
3.1.1. Na página "Build on the Claude Platform", insira o endereço de email corporativo da pessoa que será a proprietária da organização Anthropic. Normalmente é um líder técnico, engenheiro de plataforma ou arquiteto de soluções.
3.1.2. Clique em Get started.
Página onde o proprietário da organização informa seu email corporativo para vincular a organização Anthropic à conta AWS
3.1.3. Uma mensagem "Thank you" aparecerá, instruindo você a verificar seu email para os próximos passos.
3.2 Verificar o Email
Você receberá dois emails:
- Uma confirmação do AWS Marketplace confirmando que a oferta foi aceita e o acordo foi criado para o produto "Claude Platform".
- Um email de configuração da Anthropic (Claude Console) com um botão para configurar sua organização. Este link expira em 24 horas.
Email de verificação enviado pela Anthropic com link para completar a configuração da organização, válido por 24 horas
3.2.1. Abra o email da Anthropic e clique no botão Set up your organization.
3.3 Preencher o Formulário de Detalhes da Organização
Você será levado à página "Let's get your organization details", que mostra o ID da sua conta AWS vinculada no topo. Preencha os seguintes campos:
- Organization name: O nome legal da sua empresa ou nome do time.
- What type of entity is your organization?: Enterprise, Small or medium business, Government institution, Non-profit, Academic institution ou Other.
- Where is your organization?: Selecione seu país.
- Will the Claude API be used in countries outside of this location?: Se sim, especifique os países adicionais.
- Are you building for internal customers, external customers or both?: Selecione a opção apropriada.
- What are you planning on using the Claude API for?: Descreva seus casos de uso pretendidos (ex: Coding, Data Analysis, Customer Support, Knowledge Retrieval).
- Will Claude be used to provide legal, medical, or financial advice to consumers?: Yes ou No.
- Will you be using our API in any products or services intended for users under age 18?: Yes ou No.
Formulário completo de detalhes da organização vinculada à conta AWS, incluindo informações sobre localização, tipo de uso e finalidade da API
Clique em Complete setup.
3.4 Confirmar que a Organização Foi Criada
Após completar a configuração, você será redirecionado de volta ao AWS Console. Um banner verde confirma: "You're all set. You can now access Claude Platform using AWS credentials."
A página do serviço agora mostra uma navegação lateral com: Access, API keys, Quickstart e Workspaces. Você também verá um aviso para criar um workspace antes de usar os recursos do Claude Platform.
Tela de confirmação no AWS Console indicando que a configuração foi concluída com sucesso e que o usuário já pode acessar o Claude Platform usando credenciais AWS
Esta organização Anthropic é totalmente separada de qualquer organização existente que sua empresa possa ter com a Anthropic (por exemplo, uma organização Claude Enterprise adquirida através do AWS Marketplace). API keys, workspaces e configurações do Claude Console de uma organização Anthropic first-party não são transferidos.
3.5 Criar Seu Primeiro Workspace
Como esta é uma organização nova, ela não possui workspaces ainda. Você verá um alerta amarelo: "No workspaces found. Create a workspace first before using Claude Platform features." Um workspace é necessário para todas as chamadas de API, pois serve como a unidade principal para escopo de IAM, rastreamento de uso e alocação de billing. Clique no botão Create workspace para provisionar seu primeiro workspace.
Step 4: Acessar o Claude Console
Acesse o Claude Console a partir da mesma página Access no AWS Console.
4.1 Selecionar um Role e Fazer Login
Na página Access, na seção "Role", selecione o role que deseja usar:
- Developer: Acesso somente leitura a todos os recursos.
- Admin: Acesso completo a todos os recursos.
Selecione Admin para acesso completo durante a configuração inicial e clique no botão Sign in.
Página de acesso onde o usuário seleciona o role Admin para obter acesso completo e clica em Sign in para ser redirecionado ao Claude Console
4.2 Verificar Acesso ao Claude Console
Você será redirecionado para o Claude Console em platform.claude.com/dashboard . O dashboard exibe um prompt "Start building with Claude" com opções para obter uma API key e monitorar o uso. A barra lateral esquerda mostra seções para Build (Files, Skills, Batches), Managed Agents (Quickstart, Agents, Sessions, Environments, Credential vaults, Memory stores), Analytics e Manage.
Confirme o indicador "Account managed by AWS" no canto inferior esquerdo da barra lateral. Isso verifica que você está operando na organização Claude Platform on AWS vinculada à sua conta AWS.
Dashboard do Claude Console confirmando que a organização é gerenciada pela AWS, com acesso a todas as funcionalidades da plataforma
4.3 Visualizar Seu Workspace
Na barra lateral do Claude Console, clique no dropdown de workspace (canto superior esquerdo, mostrando a região). Você verá o workspace "Quickstart" que foi criado no Step 3.
Visualização do workspace Quickstart criado automaticamente durante o processo de setup, vinculado à região us-east-1
4.4 Gerenciar Workspaces
Para visualizar e gerenciar seus workspaces, clique na seta para baixo ao lado do nome da sua organização no canto inferior esquerdo do Claude Console, depois navegue até Organization Settings e selecione Workspaces.
Navegação até a área de gerenciamento de workspaces através do menu Organization Settings no canto inferior esquerdo do Claude Console
No console de gerenciamento de Workspaces, você pode ver todos os workspaces existentes. Para arquivar um workspace que não precisa mais, clique no menu de três pontos ao lado dele e selecione Archive Workspace. Arquivar é útil ao descomissionar um ambiente de teste ou limpar workspaces que não estão mais em uso.
Área de gerenciamento de workspaces onde é possível visualizar os workspaces existentes e arquivar aqueles que não são mais necessários
Step 5: Habilitar Outbound Web Identity Federation
Este é um passo de configuração única por conta, necessário antes que qualquer chamada de API possa ser feita. Sem ele, toda requisição falhará com o erro: "Outbound web identity federation is disabled for your account."
5.1 Entender Por Que Este Passo é Necessário
O Claude Platform on AWS usa outbound web identity federation para que o gateway da AWS possa chamar
sts:GetWebIdentityToken do lado do servidor e gerar um JWT que é encaminhado à infraestrutura da Anthropic para autenticar as requisições. Esta capacidade do STS está desabilitada por padrão em toda conta AWS.5.2 Habilitar Outbound Web Identity Federation
Execute o seguinte comando AWS CLI uma vez na workload account onde o Claude Platform on AWS está provisionado. Este comando requer a permissão
iam:EnableOutboundWebIdentityFederation, portanto use um profile que tenha acesso IAM na workload account:1
aws iam enable-outbound-web-identity-federation --profile <your-iam-profile>
5.3 Verificar se Está Habilitado
1
aws iam get-outbound-web-identity-federation-info
Se você receber
[ERROR] (FeatureEnabled) ... already enabled, a configuração já está ativa e você pode prosseguir. O comando acima também retorna a URL do issuer da conta, que é usada internamente pelo SDK.Step 6: Configurar o Claude Code
Com a subscrição ativa e o workspace provisionado, você pode agora configurar o Claude Code para usar suas credenciais do Claude Platform on AWS. A abordagem é similar ao que cobrimos em Como Configurar o Claude Code com Amazon Bedrock , mas com variáveis de ambiente diferentes.
6.1 Localizar Seu Workspace ID
6.1.1. Navegue até a página do serviço Claude Platform on AWS no AWS Console.
6.1.2. Na navegação lateral, clique em Workspaces.
6.1.3. Seu workspace será listado. O workspace ID segue o formato
wrkspc_01AbCdEf23GhIj. Copie este valor.
Localização do workspace ID na página Workspaces do AWS Console, valor necessário para configurar as variáveis de ambiente do Claude Code
6.2 Definir Variáveis de Ambiente
Você pode exportar as variáveis diretamente no seu terminal para um teste rápido, ou adicioná-las ao seu arquivo de configuração do shell (
~/.zshrc, ~/.bashrc) para configuração persistente:1
2
3
4
5
# Claude Platform on AWS
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID='<your-workspace-id>'
export AWS_REGION=us-east-1
export AWS_PROFILE=<your-aws-profile>
Substitua
<your-workspace-id> pelo valor copiado no passo anterior, e <your-aws-profile> pelo profile do AWS CLI que possui as permissões AnthropicFullAccess.Se você adicionou as variáveis ao
~/.zshrc, reinicie seu terminal ou execute source ~/.zshrc para aplicar as alterações.6.3 Autenticar com AWS SSO
Antes de iniciar o Claude Code, certifique-se de que sua sessão AWS está ativa:
1
aws sso login --profile <your-aws-profile>
Step 7: Validar a Integração
7.1 Iniciar o Claude Code
Abra um terminal e execute:
1
claude
Você deve ver a tela de boas-vindas indicando Claude Platform on AWS como o API provider.
7.2 Verificar Status
Dentro do Claude Code, digite
/status para confirmar a configuração:
Resultado do comando /status confirmando que o Claude Code está configurado corretamente para usar o Claude Platform on AWS com o workspace e região esperados
Verifique que:
- API provider mostra
Claude Platform on AWS - Workspace ID corresponde ao seu workspace
- AWS region mostra
us-east-1
7.3 Executar uma Query de Teste
Envie uma mensagem simples para confirmar que a inferência está funcionando:
1
Hello! Can you briefly explain what AWS is?
Se você receber uma resposta, a integração está totalmente operacional. Seu uso do Claude Code agora é cobrado através da sua conta AWS via AWS Marketplace.
Validação final da integração com uma query de teste simples, confirmando que a inferência está operacional e o billing é processado via AWS Marketplace
Conclusão
Você se inscreveu com sucesso no Claude Platform on AWS, configurou sua organização e workspace, e conectou o Claude Code para usar suas credenciais AWS para autenticação e billing. A partir daqui você pode usar o Claude Code no seu fluxo de trabalho diário com a mesma experiência da API first-party da Anthropic, mantendo o billing consolidado na sua conta AWS.
Links de Referência
- Guia Oficial do Usuário AWS
- Documentação da Plataforma Anthropic
- Claude Code on Claude Platform on AWS
- Referência de IAM Actions
- Documentação de IAM Policies
- Detalhes de Preços
- Console Claude Platform on AWS
Mantenha-se Conectado
Se este guia foi útil, siga para mais conteúdo sobre IA, segurança em nuvem e automação AWS:
- LinkedIn: https://www.linkedin.com/in/biagolini
- Medium: https://medium.com/@biagolini
- GitHub: https://github.com/biagolini
- YouTube (PT-BR): https://www.youtube.com/@BiagoliniTech
Enjoyed reading this content? Let the author know!
Your likes, comments, shares, and saves help creators reach more builders.
Loading recommendations
Loading article