O Claude Code suporta configurações padrão de proxy HTTP/HTTPS através de variáveis de ambiente. Isso permite que você roteie todo o tráfego do Claude Code através dos servidores proxy da sua organização para fins de segurança, conformidade e monitoramento.

Configuração básica de proxy

Variáveis de ambiente

O Claude Code respeita as variáveis de ambiente padrão de proxy:

# 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

O Claude Code atualmente não suporta a variável de ambiente NO_PROXY. Todo o tráfego será roteado através do proxy configurado.

O Claude Code não suporta proxies SOCKS.

Autenticação

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.

Problemas de certificado SSL

Se o seu proxy usa certificados SSL personalizados, você pode encontrar erros de certificado.

Certifique-se de definir o caminho correto do pacote de certificados:

export SSL_CERT_FILE=/path/to/certificate-bundle.crt
export NODE_EXTRA_CA_CERTS=/path/to/certificate-bundle.crt

Requisitos de acesso à rede

O Claude Code requer acesso às seguintes URLs:

  • api.anthropic.com - Endpoints da API Claude
  • statsig.anthropic.com - Telemetria e métricas
  • sentry.io - Relatório de erros

Certifique-se de que essas URLs estejam na lista de permissões na configuração do seu proxy e nas regras de firewall. Isso é especialmente importante ao usar o Claude Code em ambientes de rede containerizados ou restritos.

Recursos adicionais