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ãoHabilitado por padrã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 do AWS

Google Vertex AI

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

​
Infraestrutura corporativa

Rede Empresarial

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 registro 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 o cabeçalho 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. Invista em documentação e memória

Recomendamos fortemente investir em documentação para que o Claude Code entenda sua base de código. As organizações podem implantar arquivos CLAUDE.md em vários níveis:
  • Em toda a organização: Implante em diretórios do sistema como /Library/Application Support/ClaudeCode/CLAUDE.md (macOS) para padrões de toda a empresa
  • Nível de repositório: Crie arquivos CLAUDE.md nas raízes dos repositórios contendo arquitetura do projeto, comandos de build e diretrizes de contribuição. Faça check-in destes no controle de versão para que todos os usuários se beneficiem Saiba mais.

​
2. Simplifique a implantação

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. Comece com uso guiado

Encoraje novos usuários a experimentar o Claude Code para Q&A da 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. Configure políticas de segurança

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. Aproveite MCP para integrações

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 faça check-in de 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