« 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.
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.
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_PROXYavant 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
Testez l’hôte de l’API depuis le même shell.
curl -I https://api.anthropic.comAffichez les variables de proxy.
env | grep -i proxyLancez les vérifications dans Claude Code.
/doctorTestez le nom d’hôte via macOS.
dscacheutil -q host -a name api.anthropic.com
Comment corriger
Si le DNS échoue, corrigez-le. Voir Le DNS ne résout pas les noms sur Mac.
Derrière un proxy d’entreprise, définissez-le avant de lancer.
export HTTPS_PROXY=http://proxy.example.com:8080Si vous utilisez une passerelle, définissez
ANTHROPIC_BASE_URLsur son adresse.Désactivez le VPN pour un court test. Réactivez-le ensuite.
Avec Kilobat
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.comCes vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec
diagnose_connectionetdiagnose_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.