Guia de estabilidade de rede do Claude Code

O Claude Code funciona em banda larga residencial, redes corporativas, proxies controlados ou gateways corporativos em conformidade. Para contas comuns, uma rede estável há bastante tempo e com titularidade clara costuma ser melhor do que VPNs públicas, pools de proxies compartilhados ou IPs de saída de VPS que mudam com frequência. Antes de configurar, verifique o tipo e a pontuação de risco do seu IP atual com uma verificação de limpeza.

A variação de IP causada por uma rediscagem natural do provedor geralmente é diferente de uma conta que salta entre países. O que pesa mais é alternar com frequência entre vários países, ASNs e dispositivos em pouco tempo — isso aumenta a chance de acionar uma revisão de segurança da conta.

O QUIC (UDP 443) é mais propenso a perda de pacotes, timeouts ou encaminhamento inesperado em alguns proxies ou firewalls corporativos. Se você notar desconexões intermitentes, tente desativar o QUIC ou forçar o tráfego relacionado ao Claude somente por TCP e teste de novo.

"network": "tcp"
# ou desative o QUIC no nível do cliente

Clientes diferentes podem ter características diferentes no handshake TLS. Se uma cadeia de proxy altera o comportamento do TLS, injeta certificados ou usa uma impressão digital de cliente muito anormal, isso pode causar falhas de conexão ou verificações extras. Prefira clientes consolidados e configurações TLS padrão.

"tls": {
  "fingerprint": "chrome"
}

O resolvedor de DNS, a saída HTTP e a saída do navegador devem, de preferência, vir do mesmo caminho de rede. Se o DNS resolve localmente enquanto o HTTP passa por um proxy, a região resolvida e a região de acesso podem não coincidir. É possível usar DoH/DoT confiáveis, mas o essencial é confirmar que as suas regras de roteamento cobrem de fato o tráfego de DNS.

"dns": {
  "servers": ["https://1.1.1.1/dns-query"]
}

Se um proxy ou uma regra de roteamento cobre só o IPv4, o tráfego IPv6 pode seguir outro caminho, fazendo com que HTTP / DNS / WebRTC vejam uma saída inconsistente. Nem sempre é preciso desativar o IPv6, mas vale verificar antes a consistência do dual-stack. Veja os riscos do IPv6 dual-stack para mais detalhes.

ipv6 = false
# ou, no proxy, domainStrategy: "UseIPv4"

A documentação oficial lista o acesso de rede do Claude Code como incluindo pelo menos api.anthropic.com, claude.ai, statsig.anthropic.com e sentry.io. Recomenda-se criar regras de roteamento dedicadas para esses domínios, para facilitar o diagnóstico e a auditoria. Veja as regras de roteamento do Claude Code.

O Claude Web, o login, a documentação e os recursos estáticos podem usar CDNs ou serviços de terceiros diferentes conforme as versões mudam. Não fixe só um domínio principal — trate os domínios obrigatórios oficiais como base e depois use capturas de pacotes locais ou logs para acrescentar os domínios de recursos estáticos realmente acessados.

Ciclos frequentes de desconexão e reconexão aumentam a latência e dificultam o diagnóstico da cadeia de proxy. Os clientes de proxy podem ativar um TCP keep-alive razoável; ativar ou não a multiplexação de conexões (mux) depende da qualidade da linha — se houver travamentos na multiplexação ou limitação de conexão única, desative-a e compare.

Não envolva as chamadas do Claude Code com um grande número de workers simultâneos por cima. Concorrência excessiva pode acionar limites de taxa, filas de conexão ou limitação do gateway corporativo; o limite real depende do plano da sua conta, da política da organização e das respostas da API.

Dê prioridade a uma saída com baixa perda de pacotes, baixo jitter e caminho estável até a API da Anthropic — não olhe só a distância geográfica. Use uma verificação de vazamentos junto com a latência real das requisições do Claude Code para avaliar.