Configuração de proxy corporativo
Aprenda como configurar o Claude Code para funcionar com servidores proxy corporativos, incluindo configuração de variáveis de ambiente, autenticação e manipulação de certificados SSL/TLS.
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:
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:
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:
Requisitos de acesso à rede
O Claude Code requer acesso às seguintes URLs:
api.anthropic.com
- Endpoints da API Claudestatsig.anthropic.com
- Telemetria e métricassentry.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.