O Claude Code suporta várias configurações de rede e segurança empresarial através de variáveis de ambiente. Isso inclui roteamento de tráfego através de servidores proxy corporativos, confiança em Autoridades de Certificação (CA) personalizadas e autenticação com certificados Transport Layer Security (mTLS) mútuos para segurança aprimorada.
Todas as variáveis de ambiente mostradas nesta página também podem ser configuradas em settings.json. Configuração de proxy
Variáveis de ambiente
O Claude Code respeita as variáveis de ambiente de proxy padrão:
# Proxy HTTPS (recomendado)
export HTTPS_PROXY=https://proxy.example.com:8080
# Proxy HTTP (se HTTPS não estiver disponível)
export HTTP_PROXY=http://proxy.example.com:8080
# Ignorar proxy para solicitações específicas - formato separado por espaço
export NO_PROXY="localhost 192.168.1.1 example.com .example.com"
# Ignorar proxy para solicitações específicas - formato separado por vírgula
export NO_PROXY="localhost,192.168.1.1,example.com,.example.com"
# Ignorar proxy para todas as solicitações
export NO_PROXY="*"
O Claude Code não suporta proxies SOCKS.
Autenticação básica
Se o seu proxy requer autenticação básica, inclua as credenciais na URL do proxy:
export HTTPS_PROXY=http://username:password@proxy.example.com:8080
Evite codificar senhas diretamente em scripts. Use variáveis de ambiente ou armazenamento seguro de credenciais em vez disso.
Para proxies que requerem autenticação avançada (NTLM, Kerberos, etc.), considere usar um serviço LLM Gateway que suporte seu método de autenticação.
Certificados CA personalizados
Se o seu ambiente empresarial usa CAs personalizadas para conexões HTTPS (seja através de um proxy ou acesso direto à API), configure o Claude Code para confiar nelas:
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
Autenticação mTLS
Para ambientes empresariais que requerem autenticação de certificado de cliente:
# Certificado de cliente para autenticação
export CLAUDE_CODE_CLIENT_CERT=/path/to/client-cert.pem
# Chave privada do cliente
export CLAUDE_CODE_CLIENT_KEY=/path/to/client-key.pem
# Opcional: Frase secreta para chave privada criptografada
export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"
Requisitos de acesso à rede
O Claude Code requer acesso às seguintes URLs:
api.anthropic.com - Endpoints da API Claudeclaude.ai - Salvaguardas WebFetchstatsig.anthropic.com - Telemetria e métricassentry.io - Relatório de erros
Certifique-se de que essas URLs estejam na lista de permissões em sua configuração de proxy e regras de firewall. Isso é especialmente importante ao usar o Claude Code em ambientes containerizados ou de rede restrita.
Recursos adicionais
