Claude Apps Gateway para AWS: controle centralizado do Claude Code e Claude Desktop

O problema de escalar o Claude em times de desenvolvimento

Empresas que adotam o Claude Code e o Claude Desktop em larga escala enfrentam um desafio comum de governança: cada desenvolvedor precisa de uma credencial individual, as configurações precisam ser distribuídas manualmente para cada máquina, e o controle de gastos fica fragmentado por equipe. Sem um ponto central de controle, a governança acaba dependendo de soluções improvisadas por cada time.

Para resolver esse cenário, a AWS e a Anthropic anunciaram o Claude apps gateway para AWS — um plano de controle auto-hospedado que oferece às organizações um único ponto de gestão para acesso, políticas e custos do Claude Code e do Claude Desktop.

Como o gateway funciona

O gateway é entregue pela Anthropic dentro do mesmo binário do Claude Code CLI que os desenvolvedores já utilizam. Ele roda como um único container sem estado (stateless) na infraestrutura da organização, apoiado por um banco de dados PostgreSQL que armazena o estado de autenticação de curta duração e os contadores de limite de requisições.

Como o gateway e o cliente são construídos em conjunto, o fluxo de /login já é compatível com o gateway nativamente. O cliente aplica as configurações gerenciadas automaticamente no momento do login, e as políticas são aplicadas de forma consistente em cada requisição.

O processo de entrada e saída de colaboradores segue os fluxos de identidade já existentes na organização. Para conceder acesso, basta adicionar o desenvolvedor ao Provedor de Identidade (IdP). Para revogar, basta removê-lo — a sessão expira dentro do tempo de vida do token configurado, que é de uma hora por padrão. Nenhuma credencial de longa duração fica armazenada nas máquinas dos desenvolvedores.

As cinco responsabilidades centrais do gateway

Identidade

O gateway se conecta a qualquer Provedor de Identidade compatível com o padrão Conexão OpenID (OIDC). Após o desenvolvedor autenticar via logon único (SSO) pelo navegador, o gateway emite um token de curta duração que o CLI usa em todas as requisições subsequentes.

Políticas

As configurações gerenciadas são definidas uma única vez no servidor. Os clientes recebem as políticas no momento do login, e o gateway as aplica em cada requisição. É possível ajustar modelos permitidos, permissões de ferramentas e configurações padrão de forma centralizada, com escopo por grupo do IdP.

Telemetria

O cliente registra uma métrica de uso para cada requisição, e o gateway a repassa via Protocolo OpenTelemetry (OTLP) para um coletor configurado pela organização — como Amazon CloudWatch, Amazon Managed Service for Prometheus ou uma plataforma de terceiros. A organização controla para onde a telemetria vai e por quanto tempo ela é retida.

Roteamento

O gateway armazena a credencial de upstream e roteia as requisições de inferência para o Amazon Bedrock ou para o Claude Platform on AWS em nome dos desenvolvedores, com failover opcional entre regiões da AWS ou entre múltiplas contas.

Limites de gastos

É possível definir limites de gastos diários, semanais e mensais por organização, grupo ou usuário. Quando um desenvolvedor ultrapassa seu limite, o gateway bloqueia novas requisições até que o período seja reiniciado ou um administrador eleve o teto.

Configuração e infraestrutura

O gateway lê um único arquivo YAML na inicialização. A configuração mínima para produção com Amazon Bedrock contém seis seções, e as credenciais sensíveis ficam em variáveis de ambiente. O upstream do Bedrock usa a função IAM do container, eliminando a necessidade de credenciais estáticas.

listen:
  host: 0.0.0.0
  port: 8080
  public_url: https://claude-gateway.internal.yourcompany.com

oidc:
  issuer: https://<your-idp>/
  client_id: <your-client-id>
  client_secret: ${OIDC_CLIENT_SECRET}
  allowed_email_domains: [yourcompany.com]

session:
  jwt_secret: ${GATEWAY_JWT_SECRET}
  ttl_hours: 1

store:
  postgres_url: ${GATEWAY_POSTGRES_URL}

upstreams:
  - provider: bedrock
    region: us-east-1
    auth: {}

auto_include_builtin_models: true

Para rotear via Claude Platform on AWS em vez do Bedrock, basta substituir o bloco upstreams:

upstreams:
  - provider: anthropicAws
    region: us-east-1
    workspace_id: wrkspc_...
    auth: {} # AWS default credential chain (IAM role)

Nesse caso, os IDs de modelo são os mesmos da API da Anthropic (como claude-sonnet-5 e claude-opus-4-8), sem necessidade de ARNs do Amazon Bedrock ou perfis de inferência.

O gateway roda como um container stateless na rede privada da organização, podendo ser implantado no Amazon Elastic Container Service (Amazon ECS), no Amazon Elastic Kubernetes Service (Amazon EKS) ou no Amazon Elastic Compute Cloud (Amazon EC2). Ele fica atrás de um Balanceador de Carga de Aplicação interno com certificado de Segurança da Camada de Transporte (TLS) emitido pelo AWS Certificate Manager. O Amazon Relational Database Service (Amazon RDS) para PostgreSQL armazena o estado de autenticação de curta duração. Os desenvolvedores acessam o gateway pela rede privada, e o gateway usa uma função IAM de tarefa para chamar o provedor upstream em nome deles.

Experiência do desenvolvedor no dia a dia

Após a implantação do gateway, os desenvolvedores executam claude /login. Os administradores distribuem um arquivo de configurações gerenciadas para as máquinas dos desenvolvedores via ferramenta de gerenciamento de dispositivos, que já preenche a URL do gateway automaticamente. O desenvolvedor pressiona Enter, um navegador abre com o SSO corporativo, e a autenticação está concluída.

A sessão é renovada silenciosamente em segundo plano usando tokens de atualização OIDC, mantendo os desenvolvedores autenticados entre reinicializações sem precisar repetir o login. Se um usuário for removido do IdP, a sessão expira na próxima renovação.

No uso cotidiano, a experiência com o Claude Code é idêntica à de qualquer outro método de autenticação. Cada requisição é autenticada pelo gateway, roteada pelo upstream configurado e governada pelas políticas definidas centralmente — tudo de forma transparente para o desenvolvedor. O seletor de modelos exibe apenas os modelos permitidos pela política. Além do controle de modelos, as políticas podem restringir permissões de ferramentas (como escrita de arquivos ou acesso à web), aplicar regras que os desenvolvedores não podem sobrescrever localmente, e distribuir variáveis de ambiente ou hooks para padronizar fluxos de trabalho entre times. O uso é atribuído à identidade de cada desenvolvedor, e os gastos são contabilizados contra o limite individual.

Duas opções de implantação

O Claude apps gateway para AWS pode ser implantado de duas formas:

• Com Amazon Bedrock: as requisições de inferência passam pelo Amazon Bedrock nas regiões configuradas, mantendo os mesmos controles de privacidade e tratamento de dados de qualquer outra carga de trabalho do Bedrock na conta. Indicado quando os dados precisam permanecer dentro do perímetro de segurança da AWS.
• Com Claude Platform on AWS: as requisições são processadas pela Anthropic, com os controles do gateway e a experiência nativa da plataforma Claude, mas com autenticação e faturamento pela AWS. Indicado para quem quer acesso à experiência nativa da Anthropic.

Conclusão

O Claude apps gateway para AWS resolve um problema real de governança em times que adotam ferramentas de IA generativa em escala. Com ele, identidade, políticas e custos passam a ser gerenciados de um único lugar, sem credenciais de longa duração nas máquinas dos desenvolvedores e sem depender de soluções improvisadas por equipe. Por ser auto-hospedado, pode ser implantado em qualquer região da AWS e configurado para roteamento entre regiões e contas.

Para começar, baixe o Claude Code CLI e consulte a documentação do Claude apps gateway.

Fonte

Introducing Claude apps gateway for AWS (https://aws.amazon.com/blogs/machine-learning/introducing-claude-apps-gateway-for-aws/)