---
title: "« curl: (7) Failed to connect » sur Mac · Guides Kilobat"
url: "https://kilobat.app/fr/guides/curl-7-failed-to-connect"
description: "curl sur votre Mac s’arrête avec (7) Failed to connect. Vérifiez le port, le service, un coupe-feu, un proxy et l’adresse que curl a essayée."
---

# « 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 agent**Copie 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](https://kilobat.app/fr/guides/recipes/why-cant-it-connect).

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

## Sources

- [curl : codes d’erreur de libcurl](https://curl.se/libcurl/c/libcurl-errors.html)

Vérifié le 29 octobre 2026.

## Guides associés

- [« curl: (6) Could not resolve host » sur Mac](https://kilobat.app/fr/guides/curl-could-not-resolve-host): Le code de sortie 6 de curl signifie que curl n’a pas pu obtenir d’adresse pour le nom d’hôte.
- [ERR_CONNECTION_REFUSED dans Chrome sur Mac](https://kilobat.app/fr/guides/err-connection-refused): ERR_CONNECTION_REFUSED est une erreur réseau de Chrome.
- [Homebrew échoue avec « curl: (28) » sur Mac](https://kilobat.app/fr/guides/homebrew-curl-28-timed-out): Homebrew télécharge avec curl.
- [Des réglages de proxy empêchent les apps de se connecter sur un Mac](https://kilobat.app/fr/guides/proxy-settings-breaking-apps): Un réglage de proxy fait passer le trafic par un autre serveur.
