Esta página fornece uma visão geral das opções de implantação disponíveis e ajuda você a escolher a configuração certa para sua organização.

​
Comparação de provedores

RecursoAnthropicAmazon BedrockGoogle Vertex AI
RegiõesPaíses suportadosMúltiplas regiões AWSMúltiplas regiões GCP
Cache de promptHabilitado por padrãoHabilitado por padrãoEntre em contato com o Google para habilitação
AutenticaçãoChave APICredenciais AWS (IAM)Credenciais GCP (OAuth/Conta de Serviço)
Rastreamento de custosDashboardAWS Cost ExplorerGCP Billing
Recursos empresariaisEquipes, monitoramento de usoPolíticas IAM, CloudTrailFunções IAM, Cloud Audit Logs

​
Provedores de nuvem

Amazon Bedrock

Use modelos Claude através da infraestrutura AWS com autenticação baseada em IAM e monitoramento nativo AWS

Google Vertex AI

Acesse modelos Claude via Google Cloud Platform com segurança e conformidade de nível empresarial

​
Infraestrutura corporativa

Proxy Corporativo

Configure o Claude Code para funcionar com os servidores proxy da sua organização e requisitos SSL/TLS

Gateway LLM

Implante acesso centralizado a modelos com rastreamento de uso, orçamento e log de auditoria

​
Visão geral da configuração

O Claude Code suporta opções de configuração flexíveis que permitem combinar diferentes provedores e infraestrutura:

Entenda a diferença entre:

  • Proxy corporativo: Um proxy HTTP/HTTPS para roteamento de tráfego (definido via HTTPS_PROXY ou HTTP_PROXY)
  • Gateway LLM: Um serviço que lida com autenticação e fornece endpoints compatíveis com provedores (definido via ANTHROPIC_BASE_URL, ANTHROPIC_BEDROCK_BASE_URL, ou ANTHROPIC_VERTEX_BASE_URL)

Ambas as configurações podem ser usadas em conjunto.

​
Usando Bedrock com proxy corporativo

Roteie o tráfego do Bedrock através de um proxy HTTP/HTTPS corporativo:

# Habilitar Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

# Configurar proxy corporativo
export HTTPS_PROXY='https://proxy.example.com:8080'

​
Usando Bedrock com Gateway LLM

Use um serviço de gateway que fornece endpoints compatíveis com Bedrock:

# Habilitar Bedrock
export CLAUDE_CODE_USE_BEDROCK=1

# Configurar gateway LLM
export ANTHROPIC_BEDROCK_BASE_URL='https://your-llm-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1  # Se o gateway lida com autenticação AWS

​
Usando Vertex AI com proxy corporativo

Roteie o tráfego do Vertex AI através de um proxy HTTP/HTTPS corporativo:

# Habilitar Vertex
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

# Configurar proxy corporativo
export HTTPS_PROXY='https://proxy.example.com:8080'

​
Usando Vertex AI com Gateway LLM

Combine modelos Google Vertex AI com um gateway LLM para gerenciamento centralizado:

# Habilitar Vertex
export CLAUDE_CODE_USE_VERTEX=1

# Configurar gateway LLM
export ANTHROPIC_VERTEX_BASE_URL='https://your-llm-gateway.com/vertex'
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1  # Se o gateway lida com autenticação GCP

​
Configuração de autenticação

O Claude Code usa o ANTHROPIC_AUTH_TOKEN para os cabeçalhos Authorization e Proxy-Authorization quando necessário. As flags SKIP_AUTH (CLAUDE_CODE_SKIP_BEDROCK_AUTH, CLAUDE_CODE_SKIP_VERTEX_AUTH) são usadas em cenários de gateway LLM onde o gateway lida com a autenticação do provedor.

​
Escolhendo a configuração de implantação certa

Considere estes fatores ao selecionar sua abordagem de implantação:

​
Acesso direto ao provedor

Melhor para organizações que:

  • Querem a configuração mais simples
  • Têm infraestrutura AWS ou GCP existente
  • Precisam de monitoramento e conformidade nativos do provedor

​
Proxy corporativo

Melhor para organizações que:

  • Têm requisitos de proxy corporativo existentes
  • Precisam de monitoramento de tráfego e conformidade
  • Devem rotear todo o tráfego através de caminhos de rede específicos

​
Gateway LLM

Melhor para organizações que:

  • Precisam de rastreamento de uso entre equipes
  • Querem alternar dinamicamente entre modelos
  • Requerem limitação de taxa personalizada ou orçamentos
  • Precisam de gerenciamento de autenticação centralizado

​
Depuração

Ao depurar sua implantação:

  • Use o comando slash claude /status. Este comando fornece observabilidade sobre qualquer configuração de autenticação, proxy e URL aplicada.
  • Defina a variável de ambiente export ANTHROPIC_LOG=debug para registrar solicitações.

​
Melhores práticas para organizações

  1. Recomendamos fortemente investir em documentação para que o Claude Code entenda sua base de código. Muitas organizações fazem um arquivo CLAUDE.md (que também chamamos de memória) na raiz do repositório que contém a arquitetura do sistema, como executar testes e outros comandos comuns, e melhores práticas para contribuir com a base de código. Este arquivo é tipicamente verificado no controle de origem para que todos os usuários possam se beneficiar dele. Saiba mais.
  2. Se você tem um ambiente de desenvolvimento personalizado, descobrimos que criar uma maneira de “um clique” para instalar o Claude Code é fundamental para aumentar a adoção em uma organização.
  3. Encoraje novos usuários a experimentar o Claude Code para perguntas e respostas sobre a base de código, ou em correções de bugs menores ou solicitações de recursos. Peça ao Claude Code para fazer um plano. Verifique as sugestões do Claude e dê feedback se estiver fora do caminho. Com o tempo, conforme os usuários entendem melhor este novo paradigma, eles serão mais eficazes em deixar o Claude Code executar de forma mais agêntica.
  4. Equipes de segurança podem configurar permissões gerenciadas para o que o Claude Code pode e não pode fazer, que não podem ser sobrescritas pela configuração local. Saiba mais.
  5. MCP é uma ótima maneira de dar ao Claude Code mais informações, como conectar-se a sistemas de gerenciamento de tickets ou logs de erro. Recomendamos que uma equipe central configure servidores MCP e verifique uma configuração .mcp.json na base de código para que todos os usuários se beneficiem. Saiba mais.

Na Anthropic, confiamos no Claude Code para impulsionar o desenvolvimento em todas as bases de código da Anthropic. Esperamos que você goste de usar o Claude Code tanto quanto nós!

​
Próximos passos