“curl: (7) Failed to connect” auf dem Mac

Der curl-Exit-Code 7 meldet einen fehlgeschlagenen Schritt. Die curl-Dokumentation sagt: “Failed to connect() to host or proxy.”

Mit deinem Agenten behebenKopiert einen Prompt für Claude Code, Codex oder jeden Agenten, der das Terminal nutzen kann.

Mein Mac hat dieses Problem: „curl: (7) Failed to connect“ auf dem Mac. Lies https://kilobat.app/de/guides/curl-7-failed-to-connect.md und geh es mit mir durch. Installiere die Kilobat-CLI, falls sie fehlt: brew install seifip/kilobat/kilobat. Führe die Terminal- und kilobat-Checks aus der Anleitung selbst aus und sag mir, was du findest. Liste die Schritte auf, die nur ich erledigen kann. Frag nach, bevor du eine Einstellung änderst.

Gilt für: das mit macOS gelieferte curl und das curl von Homebrew, unter allen aktuellen macOS-Versionen.Geprüft: 29. Oktober 2026

Symptome

  • Das Terminal zeigt curl: (7) Failed to connect to host port 443.
  • Der Text ergänzt oft „Couldn't connect to server“ oder „Connection refused“.
  • Skripte und Installer brechen mit dem Exit-Code 7 ab.

Mögliche Ursachen

  • Nichts lauscht am Port. Der Dienst ist aus, oder er nutzt einen anderen Port.
  • Eine Firewall oder ein Proxy. Eine Firewall kann die Verbindung ablehnen. curl scheitert auch, wenn ein Proxy gesetzt, aber nicht erreichbar ist.
  • Eine falsche Adresse. Host oder Port in der URL sind falsch. Eine Variable in einem Skript kann leer sein.
  • Eine IPv6- oder VPN-Route. curl versucht möglicherweise eine Adresse, die das Netzwerk nicht erreicht.

So prüfst du es

  1. Gib die genaue URL aus. Prüfe Host und Port.

  2. Führe curl mit Details aus. Die ersten Zeilen zeigen die Adresse, die gescheitert ist.

    curl -v https://example.com
  3. Teste den Port.

    nc -vz example.com 443
  4. Zeige die Proxy-Variablen an.

    env | grep -i proxy

So behebst du es

  1. Starte den Dienst, wenn es deiner ist. Nutze den Port, den er ausgibt.

  2. Erzwinge IPv4, um einen IPv6-Fehler zu testen.

    curl -4 -v https://example.com
  3. Entferne einen falschen Proxy.

    unset https_proxy http_proxy
  4. Schalte das VPN für einen kurzen Test aus. Schalte es danach wieder ein.

Mit Kilobat

  1. Der Verbindungsdoktor von Kilobat testet die Adresse Schicht für Schicht: Netzwerk, Proxy, DNS, Regeln, IPv4, IPv6, TLS und Server. Er nennt die Schicht, die fehlgeschlagen ist.

    kilobat why https://example.com
  2. Diese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit diagnose_connection und diagnose_network aus. Siehe Herausfinden, warum eine Website oder API keine Verbindung bekommt.

Fragen

Heißt Exit-Code 7, dass der Host ausgefallen ist?

Nicht immer. curl konnte den Host oder den Proxy nicht erreichen. Finde mit curl -v heraus, welchen.

Was ist der Unterschied zu (6)?

Exit-Code 6 heißt, dass der Hostname nicht aufgelöst wurde. Code 7 heißt, dass die Verbindung scheiterte. Siehe “curl: (6) Could not resolve host” auf dem Mac.

Quellen

Geprüft am 29. Oktober 2026.