« curl: (7) Failed to connect » sur Mac

Le code de sortie 7 de curl signale une étape en échec. La documentation de curl dit : « Failed to connect() to host or proxy. »

Réglez-le avec votre agentCopie un prompt pour Claude Code, Codex ou tout agent capable d’utiliser Terminal.

Mon Mac a ce problème : « curl: (7) Failed to connect » sur Mac. Lis https://kilobat.app/fr/guides/curl-7-failed-to-connect.md et résous-le avec moi. Installe la CLI Kilobat si elle manque : brew install seifip/kilobat/kilobat. Lance toi-même les vérifications Terminal et kilobat du guide et dis-moi ce que tu trouves. Liste les étapes que moi seul peux faire. Demande-moi avant de modifier un réglage.

S’applique à : le curl fourni avec macOS et le curl de Homebrew, sur toutes les versions actuelles de macOS.Vérifié le 29 octobre 2026

Symptômes

  • Terminal affiche curl: (7) Failed to connect to host port 443.
  • Le texte ajoute souvent « Couldn’t connect to server » ou « Connection refused ».
  • Les scripts et les installateurs s’arrêtent avec le code de sortie 7.

Causes probables

  • Rien n’écoute sur le port. Le service est arrêté ou utilise un autre port.
  • Un coupe-feu ou un proxy. Un coupe-feu peut refuser la connexion. curl échoue aussi quand un proxy est défini et injoignable.
  • Une adresse incorrecte. L’hôte ou le port de l’URL est faux. Une variable d’un script peut être vide.
  • Une route IPv6 ou VPN. curl peut essayer une adresse que le réseau ne peut pas atteindre.

Comment vérifier

  1. Affichez l’URL exacte. Vérifiez l’hôte et le port.

  2. Lancez curl avec le détail. Les premières lignes montrent l’adresse qui a échoué.

    curl -v https://example.com
  3. Testez le port.

    nc -vz example.com 443
  4. Affichez les variables de proxy.

    env | grep -i proxy

Comment corriger

  1. Démarrez le service s’il est à vous. Utilisez le port qu’il indique.

  2. Forcez l’IPv4 pour tester un défaut d’IPv6.

    curl -4 -v https://example.com
  3. Supprimez un proxy incorrect.

    unset https_proxy http_proxy
  4. Désactivez le VPN pour un court test. Réactivez-le ensuite.

Avec Kilobat

  1. Le diagnostic de connexion de Kilobat teste l’adresse couche par couche : réseau, proxy, DNS, règles, IPv4, IPv6, TLS et serveur. Il nomme la couche qui a échoué.

    kilobat why https://example.com
  2. Ces vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec diagnose_connection et diagnose_network. Consultez Trouver pourquoi un site ou une API ne se connecte pas.

Questions

Le code de sortie 7 signifie-t-il que l’hôte est en panne ?

Pas toujours. curl n’a pas pu se connecter à l’hôte ou au proxy. Trouvez lequel avec curl -v.

Quelle différence avec (6) ?

Le code de sortie 6 signifie que le nom d’hôte n’a pas été résolu. Le code 7 signifie que la connexion a échoué. Voir « curl: (6) Could not resolve host » sur Mac.

Sources

Vérifié le 29 octobre 2026.