---
title: "« Unable to connect to API » dans Claude Code sur Mac · Guides Kilobat"
url: "https://kilobat.app/fr/guides/claude-code-unable-to-connect-to-api"
description: "Claude Code sur votre Mac affiche Unable to connect to API. Vérifiez votre connexion, un VPN qui bloque l’hôte de l’API et un proxy que vous devez définir."
---

# « Unable to connect to API » dans Claude Code sur Mac

Claude Code affiche Unable to connect to API quand une requête n’atteint pas api.anthropic.com. La documentation de Claude Code cite comme causes courantes l’absence d’accès à Internet, un VPN qui bloque l’hôte ou un proxy d’entreprise non défini.

**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 : « Unable to connect to API » dans Claude Code sur Mac. Lis https://kilobat.app/fr/guides/claude-code-unable-to-connect-to-api.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 à : Claude Code dans un terminal, sur toutes les versions actuelles de macOS. · Vérifié le 29 octobre 2026

## Symptômes

- Claude Code affiche `Unable to connect to API. Check your internet connection`.
- Le message peut se terminer par un code, comme ENOTFOUND, EHOSTUNREACH ou ECONNRESET.
- Les requêtes échouent, mais d’autres apps peuvent fonctionner.

## Causes probables

- **Pas d’accès à Internet.** Le Mac est hors ligne ou n’a pas de DNS.
- **Un VPN qui bloque l’hôte de l’API.** La documentation de Claude Code le cite comme cause courante.
- **Un proxy non défini.** Un proxy d’entreprise obligatoire doit être défini avec `HTTPS_PROXY` avant le lancement.
- **Un proxy qui refuse le tunnel.** ERR_PROXY_TUNNEL signifie que le proxy a refusé le tunnel. Vérifiez ses identifiants et qu’il autorise cet hôte.

## Comment vérifier

1. Testez l’hôte de l’API depuis le même shell.

   ```
   curl -I https://api.anthropic.com
   ```
2. Affichez les variables de proxy.

   ```
   env | grep -i proxy
   ```
3. Lancez les vérifications dans Claude Code.

   ```
   /doctor
   ```
4. Testez le nom d’hôte via macOS.

   ```
   dscacheutil -q host -a name api.anthropic.com
   ```

## Comment corriger

1. Si le DNS échoue, corrigez-le. Voir [Le DNS ne résout pas les noms sur Mac](https://kilobat.app/fr/guides/dns-server-not-found).
2. Derrière un proxy d’entreprise, définissez-le avant de lancer.

   ```
   export HTTPS_PROXY=http://proxy.example.com:8080
   ```
3. Si vous utilisez une passerelle, définissez `ANTHROPIC_BASE_URL` sur son adresse.
4. Désactivez le VPN pour un court test. Réactivez-le ensuite.

## Avec Kilobat

1. Le diagnostic de connexion de Kilobat teste l’hôte de l’API couche par couche : réseau, proxy, DNS, règles, IPv4, IPv6, TLS et serveur.

   ```
   kilobat why https://api.anthropic.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 entre parenthèses est-il important ?**

Oui. ENOTFOUND renvoie au DNS, EHOSTUNREACH à une route, ECONNRESET à une réinitialisation, ERR_PROXY_TUNNEL à un proxy.

**Dois-je redémarrer Claude Code après avoir défini une variable ?**

Oui. La page sur la configuration réseau précise qu’une session en cours ne prend pas en compte les changements ultérieurs du shell.

## Sources

- [Claude Code : référence des erreurs](https://code.claude.com/docs/en/errors.md)
- [Claude Code : configuration réseau en entreprise](https://code.claude.com/docs/en/network-config.md)

Vérifié le 29 octobre 2026.

## Guides associés

- [« Request timed out » dans Claude Code sur Mac](https://kilobat.app/fr/guides/claude-code-request-timed-out): Claude Code affiche Request timed out quand l’API ne répond pas avant le délai de connexion.
- [« Unable to connect to API: SSL certificate verification failed » sur Mac](https://kilobat.app/fr/guides/claude-code-ssl-certificate-verification-failed): Claude Code affiche ce message quand un certificat vient d’une autorité à laquelle il ne fait pas confiance.
- [« 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.
- [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.
