User's blog

Como usar Claude Code com Amazon Bedrock em ambientes regulados

Written by

Make.com Service User

in

IA assistida para ambientes regulados: o que a AWS está oferecendo

A disponibilização dos modelos Claude Opus 5.5 e Claude Sonnet 5.5 no Amazon Bedrock dentro das regiões AWS GovCloud (US) representa uma novidade relevante para equipes que trabalham com cargas de trabalho sujeitas a requisitos regulatórios. Isso inclui organizações que precisam cumprir normas como o ITAR (Regulamento Internacional sobre Tráfego de Armas) e outras obrigações de conformidade governamental.

Em termos de certificações, o Claude Sonnet 5 já possui certificação FedRAMP Classe D (anteriormente chamada de High) e autorização DoD Nível de Impacto 4 e 5 (IL4/IL5). Já os modelos Claude Opus 5.5 e Claude Sonnet 5.5 possuem certificação FedRAMP Classe D no Amazon Bedrock — vale sempre verificar o status atual de certificação dos modelos diretamente na documentação oficial.

O objetivo desta publicação é mostrar como usar esses modelos no Amazon Bedrock dentro do AWS GovCloud (US) em conjunto com o Claude Code, a ferramenta de codificação agêntica da Anthropic, para acelerar tarefas de desenvolvimento sem abrir mão dos controles de conformidade.

Amazon Bedrock no AWS GovCloud (US)

As regiões AWS GovCloud (US) foram projetadas especificamente para clientes norte-americanos com necessidades elevadas de conformidade. Nelas, é possível executar cargas de trabalho de IA generativa em ambientes sensíveis mantendo os controles exigidos por regulamentações governamentais.

O Amazon Bedrock nesse ambiente oferece recursos de segurança como:

  • Proteção de dados integrada: o conteúdo dos clientes não é armazenado, registrado nem utilizado para treinar modelos da AWS ou compartilhado com terceiros.
  • Certificação FedRAMP Classe D e caminhos de autorização DoD CSP SRG IL4/IL5, atendendo aos requisitos de conformidade de agências governamentais. Consulte a página de conformidade dos modelos do Amazon Bedrock para o status atualizado.
  • Integração com os controles de segurança e frameworks de conformidade disponíveis no AWS GovCloud (US), mantendo os mesmos padrões de segurança das demais regiões AWS.

Dois endpoints disponíveis

O Amazon Bedrock no AWS GovCloud (US) oferece dois endpoints distintos, ambos alimentados pelo mesmo mecanismo de inferência Mantle com arquitetura de Acesso Zero ao Operador (ZOA):

  • bedrock-runtime: utiliza o SDK da AWS (APIs InvokeModel e Converse) e suporta Amazon Bedrock Guardrails, Amazon Bedrock Knowledge Bases, Agentes e registro de invocações. É a opção recomendada para a maioria das aplicações novas, especialmente as que precisam de trilhas de auditoria. Está disponível nas duas regiões do AWS GovCloud (US-West e US-East).
  • bedrock-mantle: suporta nativamente a API de Mensagens da Anthropic e oferece acesso a capacidades como ferramentas server-side, inferência em segundo plano e Projetos. Disponível apenas no AWS GovCloud (US-West).

Ambos os endpoints estão disponíveis para Claude Opus 5.5, Claude Sonnet 5.5 e Claude Sonnet 5.

O que é o Claude Code

O Claude Code é a ferramenta de codificação agêntica da Anthropic. Ela lê a base de código do projeto, edita arquivos, executa comandos e se integra às ferramentas de desenvolvimento. Funciona diretamente no terminal, em IDEs (Ambientes de Desenvolvimento Integrado) como VS Code e JetBrains, e em segundo plano via Claude Agent SDK.

Entre as principais capacidades do Claude Code estão:

  • Escrever código e corrigir bugs em múltiplos arquivos da base de código.
  • Responder perguntas sobre arquitetura e lógica do código.
  • Executar e corrigir testes, linting e outros comandos.
  • Navegar pelo histórico do Git, resolver conflitos de merge e criar commits e pull requests.
  • Conectar-se a ferramentas e fontes de dados externas com o Protocolo de Contexto de Modelo (MCP), incluindo a Interface de Linha de Comando da AWS (AWS CLI), Terraform e Kubernetes.
  • Criar sub-agentes que trabalham em partes diferentes de uma tarefa ao mesmo tempo.
  • Personalizar comportamento com arquivos de memória CLAUDE.md, skills para fluxos de trabalho repetíveis e hooks para automação pré/pós-ação.
  • Automatizar tarefas recorrentes e integrar com pipelines de Integração e Entrega Contínua (CI/CD) via GitHub Actions ou GitLab CI/CD.

Para se aprofundar, a Anthropic disponibiliza tutoriais do Claude Code e um guia de boas práticas para codificação agêntica.

Como configurar o Claude Code com Amazon Bedrock no AWS GovCloud (US)

Pré-requisitos

  • Uma conta AWS GovCloud (US) com acesso ao Amazon Bedrock.
  • Funções e permissões de Gerenciamento de Identidade e Acesso da AWS (IAM) adequadas. No mínimo, a política IAM deve incluir:
    • Para bedrock-runtime: bedrock:InvokeModel, bedrock:InvokeModelWithResponseStream, bedrock:ListInferenceProfiles e bedrock:GetInferenceProfile.
    • Para bedrock-mantle: bedrock-mantle:CreateInference, bedrock-mantle:GetProject, bedrock-mantle:ListProjects e bedrock-mantle:ListModels. Alternativamente, anexe a política gerenciada AmazonBedrockMantleInferenceAccess.
  • Acesso aos modelos do Amazon Bedrock habilitado para Claude Opus 5.5, Claude Sonnet 5.5 e Claude Sonnet 5 na conta AWS GovCloud (US).
  • AWS CLI configurado com credenciais de sessão válidas usando chaves de API de curto prazo ou login via AWS SSO.

Instalação do Claude Code

Após configurar a AWS CLI com suas credenciais, instale o Claude Code usando um dos métodos abaixo:

  • macOS, Linux, WSL: curl -fsSL https://claude.ai/install.sh | bash
  • Windows PowerShell: irm https://claude.ai/install.ps1 | iex
  • Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  • Homebrew (macOS/Linux): brew install --cask claude-code

Para métodos adicionais de instalação, consulte a documentação de instalação do Claude Code.

Opção A: Assistente de configuração interativo (recomendado)

Navegue até o projeto e inicie o Claude Code:

cd your-code-project
claude

Execute o assistente de login com /login. No prompt, selecione 3rd-party platform e depois Amazon Bedrock. Siga as instruções para escolher o método de autenticação, a região (us-gov-west-1) e fixar os modelos. A configuração é salva automaticamente no arquivo de configurações. Se já tiver o Claude Code configurado anteriormente, use /setup-bedrock para reabrir o assistente.

Opção B: Configuração manual por variáveis de ambiente

Para implantações automatizadas ou corporativas, defina as seguintes variáveis de ambiente:

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION='us-gov-west-1'
export ANTHROPIC_MODEL='us-gov.anthropic.claude-sonnet-5-5'

Para usar o Claude Opus 5.5 como modelo principal:

export ANTHROPIC_MODEL='us-gov.anthropic.claude-opus-5-5'

Para fixar versões específicas dos modelos em implantações de equipe:

export ANTHROPIC_DEFAULT_OPUS_MODEL='us-gov.anthropic.claude-opus-5-5'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us-gov.anthropic.claude-sonnet-5-5'

Em seguida, navegue até o projeto e inicie o Claude Code:

cd your-code-project
claude

Opção C: Usando o endpoint Bedrock Mantle

Para rotear o Claude Code pelo endpoint Mantle:

export CLAUDE_CODE_USE_MANTLE=1
export AWS_REGION='us-gov-west-1'

Quando ambos os endpoints são necessários na mesma sessão:

export CLAUDE_CODE_USE_BEDROCK=1
export CLAUDE_CODE_USE_MANTLE=1

Atenção: Guardrails e registro de invocações estão disponíveis exclusivamente pelo endpoint bedrock-runtime. Para implantações que exigem esses recursos de conformidade, use o bedrock-runtime (Opções A ou B).

Verificando a configuração

Confirme que o Claude Code está rodando verificando a mensagem Welcome to Claude Code! no terminal. Execute o comando /status para confirmar o modelo e o provedor. A linha do provedor deve exibir Amazon Bedrock ou Amazon Bedrock (Mantle), dependendo da configuração. Para mais detalhes, consulte a documentação sobre Claude Code no Amazon Bedrock.

Considerações para implantação organizacional

Com o Claude Code disponível para uso geral, o próximo passo é definir como implantá-lo em toda a organização. Alguns pontos importantes a considerar:

  • Identidade e acesso centralizado: use o AWS IAM Identity Center para governar centralmente o acesso ao Claude Code. Isso garante que apenas desenvolvedores autorizados tenham acesso e permite o uso de credenciais temporárias baseadas em função, eliminando a necessidade de chaves de acesso estáticas. Antes de abrir o Claude Code, configure a AWS CLI com um perfil do IAM Identity Center: aws configure sso --profile <PROFILE_NAME> e faça login com aws sso login --profile <PROFILE_NAME>.
  • Configuração automatizada: considere automatizar as variáveis de ambiente padrão para que o Claude Code se conecte automaticamente ao Amazon Bedrock. As organizações podem começar com instruções de autoatendimento para desenvolvedores ou usar arquivos de configuração para gerenciamento centralizado.
  • Implantações empresariais de grande escala: considere implementar a Orientação para Claude Code com Amazon Bedrock. Essa orientação ajuda organizações a implantar o Claude Code mantendo controle rigoroso sobre o acesso a recursos de IA, conectando-se à infraestrutura de identidade existente e fornecendo observabilidade sobre produtividade e padrões de uso.
  • Cotas de serviço: revise as cotas de serviço e defina os valores adequados de tokens por minuto (TPM) e requisições por minuto (RPM) com base no número de desenvolvedores ativos. Siga as recomendações de limites de taxa para orientação.
  • Fixação de versões de modelos: fixe versões específicas dos modelos para implantações consistentes em equipe. Sem fixação, aliases como sonnet e opus resolvem para os padrões internos do Claude Code, que podem mudar entre versões. O Claude Code usa Claude Opus 5.5 como modelo principal por padrão, portanto uma implantação sem fixação será cobrada pela taxa por token do Opus. Para manter equipes no Claude Sonnet 5.5, defina ANTHROPIC_MODEL com o ID completo do modelo. No AWS GovCloud (US), use o prefixo us-gov. para IDs de perfis de inferência entre regiões.
  • Monitoramento de custos: sessões do Claude Code podem ser intensivas em tokens, especialmente com Claude Opus 5.5, que tem custo por token mais alto que o Claude Sonnet 5.5. Implemente guardrails de tokens por usuário para aplicar limites diários por desenvolvedor, com alertas nos limiares de 80% e 100%. Esse padrão usa Amazon CloudWatch, AWS Lambda e Amazon DynamoDB para rastrear e aplicar limites em tempo quase real. Use prompt caching para reduzir custos e melhorar tempos de resposta — opções de TTL de 5 minutos e 1 hora estão disponíveis para modelos suportados. Considere usar Claude Sonnet 5.5 como padrão para equipes (menor custo) e reservar o Claude Opus 5.5 para tarefas que exigem raciocínio mais profundo ou execuções autônomas mais longas. Consulte o Guia de Implementação de Monitoramento do Claude Code para padrões adicionais de observabilidade.
  • Permissões, memória e servidores MCP: equipes de segurança podem configurar permissões gerenciadas para o que o Claude Code pode ou não fazer — configurações que não podem ser sobrescritas por configurações locais. Além disso, configure arquivos de memória CLAUDE.md nos projetos para adicionar automaticamente fluxos de trabalho comuns, convenções de estilo e padrões de codificação da organização. Implante o arquivo CLAUDE.md em um diretório corporativo para que todos os desenvolvedores herdem a mesma base. Use hooks para aplicar automações pré/pós-ação, como formatação automática ou verificações de lint.
  • Escolha do endpoint adequado: o endpoint bedrock-runtime suporta Guardrails, registro de invocações e inferência entre regiões nas duas regiões do AWS GovCloud (US). O endpoint bedrock-mantle suporta nativamente a API de Mensagens da Anthropic e está disponível no AWS GovCloud (US-West). Como Guardrails e registro de invocações são exclusivos do bedrock-runtime, para implantações que exigem trilhas de auditoria completas e filtragem de conteúdo, o bedrock-runtime é o recomendado.
  • Avaliação de segurança: realize uma avaliação de segurança completa antes da implantação. O Amazon Bedrock protege a camada de inferência, mas o Claude Code roda nas máquinas locais dos desenvolvedores e requer avaliação e gestão de risco separadas. Aplique controles como permissões gerenciadas, registro de invocações e limites de tokens por usuário, assim como faria com qualquer outro software de terceiros no ambiente.

Conclusão

A disponibilização do Claude Opus 5.5 e do Claude Sonnet 5.5 no Amazon Bedrock dentro do AWS GovCloud (US) oferece às organizações um caminho alinhado à conformidade para desenvolvimento assistido por IA em cargas de trabalho reguladas. Cada modelo tem seu perfil:

  • Claude Sonnet 5, com certificação FedRAMP Classe D e autorização DoD IL4/IL5, oferece a maior cobertura de conformidade para ambientes mais sensíveis.
  • Claude Sonnet 5.5, com certificação FedRAMP Classe D, representa um avanço em codificação e trabalho de conhecimento a um custo por tarefa menor.
  • Claude Opus 5.5, com certificação FedRAMP Classe D, traz raciocínio mais profundo e capacidades de execução autônoma mais longas para cargas de trabalho onde esse nível de certificação é suficiente.

Combinado com o Claude Code, equipes podem adotar fluxos de trabalho de codificação agêntica diretamente no terminal, na IDE ou em pipelines de CI/CD, mantendo os dados dentro da infraestrutura do AWS GovCloud (US). A escolha entre o endpoint bedrock-runtime — para suporte completo a Guardrails e logging — ou o bedrock-mantle — para acesso nativo à API de Mensagens da Anthropic — permite adaptar a implantação aos requisitos de conformidade e operacionais de cada organização.

Saiba mais

Fonte

Supercharge regulated workloads with Claude Code and Amazon Bedrock (https://aws.amazon.com/blogs/machine-learning/supercharge-regulated-workloads-with-claude-code-and-amazon-bedrock/)

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *

More posts