---
title: "„curl: (7) Failed to connect“ auf dem Mac · Kilobat Anleitungen"
url: "https://kilobat.app/de/guides/curl-7-failed-to-connect"
description: "curl auf deinem Mac bricht mit „(7) Failed to connect“ ab. Prüfe den Port, den Dienst, eine Firewall, einen Proxy und die Adresse, die curl versucht hat."
---

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

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

## Quellen

- [curl: libcurl-Fehlercodes](https://curl.se/libcurl/c/libcurl-errors.html)

Geprüft am 29. Oktober 2026.

## Verwandte Anleitungen

- [„curl: (6) Could not resolve host“ auf dem Mac](https://kilobat.app/de/guides/curl-could-not-resolve-host): curl-Exit-Code 6 bedeutet, dass curl keine Adresse für den Hostnamen ermitteln konnte.
- [ERR_CONNECTION_REFUSED in Chrome auf dem Mac](https://kilobat.app/de/guides/err-connection-refused): ERR_CONNECTION_REFUSED ist ein Netzwerkfehler von Chrome.
- [Homebrew scheitert mit „curl: (28)“ auf dem Mac](https://kilobat.app/de/guides/homebrew-curl-28-timed-out): Homebrew lädt mit curl herunter.
- [Proxy-Einstellungen blockieren App-Verbindungen auf dem Mac](https://kilobat.app/de/guides/proxy-settings-breaking-apps): Eine Proxy-Einstellung leitet den Datenverkehr über einen anderen Server.
