“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.

Resolva com seu agenteCopia um prompt para o Claude Code, o Codex ou qualquer agente que possa usar o Terminal.

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.

Vale para: o Claude Code em um terminal em todas as versões atuais do macOS.Verificado: 29 de outubro de 2026

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_PROXY antes 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

  1. Teste o host da API no mesmo shell.

    curl -I https://api.anthropic.com
  2. Mostre as variáveis de proxy.

    env | grep -i proxy
  3. Execute as verificações dentro do Claude Code.

    /doctor
  4. Teste o nome do host pelo macOS.

    dscacheutil -q host -a name api.anthropic.com

Como corrigir

  1. Se o DNS falhar, corrija-o. Veja DNS não resolve no Mac.

  2. Atrás de um proxy corporativo, defina-o antes de iniciar.

    export HTTPS_PROXY=http://proxy.example.com:8080
  3. Se você usa um gateway, defina ANTHROPIC_BASE_URL com o endereço dele.

  4. Desative a VPN para um teste rápido. Ative de novo depois.

Com o Kilobat

  1. 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.com
  2. Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com diagnose_connection e diagnose_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.