Visão geral da implantação empresarial

Aprenda como o Claude Code pode se integrar com vários serviços de terceiros e infraestrutura para atender aos requisitos de implantação empresarial.

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

Recurso	Anthropic	Amazon Bedrock	Google Vertex AI
Regiões	Países suportados	Múltiplas regiões AWS	Múltiplas regiões GCP
Cache de prompt	Habilitado por padrão	Habilitado por padrão	Habilitado por padrão
Autenticação	Chave API	Credenciais AWS (IAM)	Credenciais GCP (OAuth/Conta de Serviço)
Rastreamento de custos	Dashboard	AWS Cost Explorer	GCP Billing
Recursos empresariais	Equipes, monitoramento de uso	Políticas IAM, CloudTrail	Funçõ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

• Configure Amazon Bedrock para implantação nativa do AWS
• Configure Google Vertex AI para implantação GCP
• Configure Rede Empresarial para requisitos de rede
• Implante Gateway LLM para gerenciamento empresarial
• Configurações para opções de configuração e variáveis de ambiente