Claude Code suporta várias configurações de rede e segurança empresariais através de variáveis de ambiente. Isso inclui rotear o tráfego através de servidores proxy corporativos, confiar em Autoridades de Certificação (CA) personalizadas e autenticar com certificados de Transport Layer Security (mTLS) mútuo 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
Claude Code respeita 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
# Contornar proxy para solicitações específicas - formato separado por espaço
export NO_PROXY="localhost 192.168.1.1 example.com .example.com"
# Contornar proxy para solicitações específicas - formato separado por vírgula
export NO_PROXY="localhost,192.168.1.1,example.com,.example.com"
# Contornar proxy para todas as solicitações
export NO_PROXY="*"
Claude Code não suporta proxies SOCKS.
Autenticação básica
Se seu proxy exigir autenticação básica, inclua credenciais na URL do proxy:
export HTTPS_PROXY=http://username:password@proxy.example.com:8080
Evite codificar senhas em scripts. Use variáveis de ambiente ou armazenamento seguro de credenciais.
Para proxies que exigem 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 seu ambiente empresarial usa CAs personalizadas para conexões HTTPS (seja através de um proxy ou acesso direto à API), configure Claude Code para confiar nelas:
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
Autenticação mTLS
Para ambientes empresariais que exigem 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 de acesso para chave privada criptografada
export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"
Requisitos de acesso à rede
Claude Code requer acesso aos seguintes URLs:
api.anthropic.com - Endpoints da API Claudeclaude.ai - Proteções de WebFetchstatsig.anthropic.com - Telemetria e métricassentry.io - Relatório de erros
Certifique-se de que esses URLs estejam na lista de permissões em sua configuração de proxy e regras de firewall. Isso é especialmente importante ao usar Claude Code em ambientes de rede containerizados ou restritos.
Recursos adicionais
