---
title: "“curl: (7) Failed to connect” no Mac · Guias do Kilobat"
url: "https://kilobat.app/pt/guides/curl-7-failed-to-connect"
description: "O curl no seu Mac para com (7) Failed to connect. Verifique a porta, o serviço, um firewall, um proxy e o endereço que o curl tentou."
---

# “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 agente**Copia 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](https://kilobat.app/pt/guides/recipes/why-cant-it-connect).

## 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](https://kilobat.app/pt/guides/curl-could-not-resolve-host).

## Fontes

- [curl: códigos de erro da libcurl](https://curl.se/libcurl/c/libcurl-errors.html)

Verificado em 29 de outubro de 2026.

## Guias relacionados

- [“curl: (6) Could not resolve host” no Mac](https://kilobat.app/pt/guides/curl-could-not-resolve-host): O código de saída 6 do curl significa que ele não conseguiu obter um endereço para o nome do host.
- [ERR_CONNECTION_REFUSED no Chrome do Mac](https://kilobat.app/pt/guides/err-connection-refused): ERR_CONNECTION_REFUSED é um erro de rede do Chrome.
- [O Homebrew falha com “curl: (28)” no Mac](https://kilobat.app/pt/guides/homebrew-curl-28-timed-out): O Homebrew baixa arquivos com curl.
- [Ajustes de proxy impedem apps de se conectar no Mac](https://kilobat.app/pt/guides/proxy-settings-breaking-apps): Um ajuste de proxy envia tráfego por outro servidor.
