“Unable to connect to API” no Claude Code do Mac
O Claude Code exibe Unable to connect to API quando uma solicitação não chega a api.anthropic.com. A documentação do Claude Code cita como causas comuns a falta de acesso à internet, uma VPN que bloqueia o host ou um proxy corporativo não definido.
Meu Mac está com este problema: “Unable to connect to API” no Claude Code do Mac. Leia https://kilobat.app/pt/guides/claude-code-unable-to-connect-to-api.md e resolva comigo. Instale a CLI do Kilobat se ela estiver faltando: brew install seifip/kilobat/kilobat. Execute você mesmo as verificações do Terminal e do kilobat do guia e me diga o que encontrar. Liste os passos que só eu posso fazer. Pergunte antes de alterar qualquer ajuste.
Sintomas
- O Claude Code exibe
Unable to connect to API. Check your internet connection. - A mensagem pode terminar com um código, como ENOTFOUND, EHOSTUNREACH ou ECONNRESET.
- As solicitações falham, mas outros apps podem funcionar.
Possíveis causas
- Sem acesso à internet. O Mac está offline ou sem DNS.
- Uma VPN que bloqueia o host da API. A documentação do Claude Code lista isso como uma causa comum.
- Um proxy não definido. Um proxy corporativo obrigatório precisa de
HTTPS_PROXYantes de iniciar. - Um proxy que recusa o túnel. ERR_PROXY_TUNNEL significa que o proxy recusou o túnel. Verifique as credenciais dele e se ele permite este host.
Como verificar
Teste o host da API no mesmo shell.
curl -I https://api.anthropic.comMostre as variáveis de proxy.
env | grep -i proxyExecute as verificações dentro do Claude Code.
/doctorTeste o nome do host pelo macOS.
dscacheutil -q host -a name api.anthropic.com
Como corrigir
Se o DNS falhar, corrija-o. Veja DNS não resolve no Mac.
Atrás de um proxy corporativo, defina-o antes de iniciar.
export HTTPS_PROXY=http://proxy.example.com:8080Se você usa um gateway, defina
ANTHROPIC_BASE_URLcom o endereço dele.Desative a VPN para um teste rápido. Ative de novo depois.
Com o Kilobat
O diagnóstico de conexão do Kilobat testa o host da API camada por camada: rede, proxy, DNS, regras, IPv4, IPv6, TLS e o servidor.
kilobat why https://api.anthropic.comEssas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com
diagnose_connectionediagnose_network. Consulte Descubra por que um site ou API não conecta.
Perguntas
O código entre parênteses é importante?
Sim. ENOTFOUND aponta para DNS, EHOSTUNREACH para uma rota, ECONNRESET para uma reinicialização da conexão e ERR_PROXY_TUNNEL para um proxy.
Preciso reiniciar o Claude Code depois de definir uma variável?
Sim. A página de configuração de rede diz que uma sessão em execução não recebe mudanças feitas depois no shell.
Fontes
Verificado em 29 de outubro de 2026.