« 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 agentCopie 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.

  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.

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

Vérifié le 29 octobre 2026.