“curl: (7) Failed to connect” no Mac

O código de saída 7 do curl indica uma etapa que falhou. A documentação do curl diz: “Failed to connect() to host or proxy.”

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: “curl: (7) Failed to connect” no Mac. Leia https://kilobat.app/pt/guides/curl-7-failed-to-connect.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.

Aplica-se ao curl incluído no macOS e ao curl do Homebrew em todas as versões atuais do macOS.Verificado: 29 de outubro de 2026

Sintomas

  • O Terminal mostra curl: (7) Failed to connect to host port 443.
  • O texto costuma acrescentar “Couldn't connect to server” ou “Connection refused”.
  • Scripts e instaladores param com o código de saída 7.

Possíveis causas

  • Nada escuta na porta. O serviço está fora do ar ou usa outra porta.
  • Um firewall ou proxy. Um firewall pode recusar a conexão. O curl também falha quando há um proxy definido e inacessível.
  • Um endereço incorreto. O host ou a porta no URL está errado. Uma variável em um script pode estar vazia.
  • Uma rota IPv6 ou de VPN. O curl pode tentar um endereço que a rede não alcança.

Como verificar

  1. Imprima o URL exato. Verifique o host e a porta.

  2. Execute o curl com detalhes. As primeiras linhas mostram o endereço que falhou.

    curl -v https://example.com
  3. Teste a porta.

    nc -vz example.com 443
  4. Mostre as variáveis de proxy.

    env | grep -i proxy

Como corrigir

  1. Inicie o serviço se ele for seu. Use a porta que ele imprime.

  2. Force IPv4 para testar uma falha de IPv6.

    curl -4 -v https://example.com
  3. Remova um proxy incorreto.

    unset https_proxy http_proxy
  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 endereço camada por camada: rede, proxy, DNS, regras, IPv4, IPv6, TLS e o servidor. Ele aponta a camada que falhou.

    kilobat why https://example.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 de saída 7 significa que o host está fora do ar?

Nem sempre. O curl não conseguiu se conectar ao host ou ao proxy. Descubra qual com curl -v.

Qual é a diferença para o (6)?

O código de saída 6 significa que o nome do host não foi resolvido. O código 7 significa que a conexão falhou. Veja “curl: (6) Could not resolve host” no Mac.

Fontes

Verificado em 29 de outubro de 2026.