Claude Code · Dépannage
Erreur de connexion à l'API Claude Code : délais d'attente et correctifs
Une erreur de connexion signifie que Claude Code n'a jamais reçu de réponse de l'API : la requête ne l'a pas atteinte, ou la réponse a mis trop de temps. Contrairement aux erreurs 4xx et 5xx, la cause est généralement le chemin réseau ou l'adresse du point de terminaison.
Dernière vérification
Le texte de l'erreur
API Error (Connection error.) · Unable to connect to API (ECONNREFUSED) · Request timed outCorrectif étape par étape
1. Vérifiez l'adresse
Exécutez /status. Le point de terminaison doit être api.aicodewith.ai en https, sans /v1 ni fautes de frappe.
~/.claude/settings.json{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_API_KEY": "", "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai" } }2. Testez le réseau
Exécutez curl -I https://api.aicodewith.ai dans le même terminal. S'il se bloque ou échoue, le problème vient du réseau, pas de Claude Code.
3. Proxy et pare-feu
Si vous utilisez un proxy, exportez HTTPS_PROXY dans ce terminal (ou ajoutez-le au bloc env). Les pare-feu d'entreprise peuvent nécessiter l'autorisation de api.aicodewith.ai.
4. Augmentez le délai d'attente
Pour les requêtes lentes ou longues, ajoutez "API_TIMEOUT_MS": "600000" au bloc env et redémarrez.
Causes courantes
| Symptôme | Cause probable |
|---|---|
| ECONNREFUSED ou ENOTFOUND | Hôte incorrect, ou DNS/proxy le bloque |
| Échoue uniquement sur VPN ou réseau d'entreprise | Règles de pare-feu ou de proxy |
| Expire uniquement sur les réponses longues | Délai d'attente trop court pour le réseau |
| Fonctionne avec curl, échoue dans Claude Code | Paramètres de proxy différents entre les shells ou l'IDE |
Les requêtes échouées sont-elles facturées ?
Les requêtes échouées (4xx/5xx, délais d'attente, connexions interrompues) ne sont pas facturées — vous n'êtes facturé que pour les requêtes qui aboutissent avec succès. Si une défaillance en amont est automatiquement réessayée et réussit, vous êtes facturé une fois.
Toujours en échec ?
- Consultez la page du modèle sur aicodewith : elle montre l'état récent de chaque canal.
- Recherchez la requête dans les enregistrements d'utilisation de votre tableau de bord pour voir son modèle, son statut et son coût.
- Envoyez un e-mail à support@aicodewith.com avec l'heure de l'erreur, le modèle et le texte de l'erreur (jamais votre clé API complète).
FAQ
Que signifie « API Error (Connection error) » dans Claude Code ?
Claude Code n'a pas pu atteindre l'API ou n'a pas reçu de réponse à temps. Vérifiez l'URL de base, puis le réseau, le proxy et le pare-feu.
Comment définir un proxy pour Claude Code ?
Exportez HTTPS_PROXY dans le terminal à partir duquel vous lancez Claude Code, ou ajoutez-le au bloc env dans ~/.claude/settings.json.
Comment augmenter le délai d'attente de Claude Code ?
Définissez API_TIMEOUT_MS (en millisecondes) dans le bloc env de settings.json et redémarrez Claude Code.
Une erreur de connexion est-elle due à ma clé ?
Non. Les problèmes de clé renvoient 401. Une erreur de connexion signifie qu'aucune réponse HTTP n'est arrivée.
Pourquoi cela fonctionne-t-il avec curl mais pas dans mon IDE ?
L'IDE peut ne pas hériter des paramètres de proxy de votre shell. Mettez HTTPS_PROXY dans le bloc env de settings.json afin que chaque client Claude Code l'utilise.
Suis-je facturé pour les requêtes échouées ?
Les requêtes échouées (4xx/5xx, délais d'attente, connexions interrompues) ne sont pas facturées — vous n'êtes facturé que pour les requêtes qui aboutissent avec succès. Si une défaillance en amont est automatiquement réessayée et réussit, vous êtes facturé une fois.
Prêt à essayer ?
La facturation est par token, à partir d'un solde prépayé. Des limites de débit et de concurrence s'appliquent, et vous pouvez définir des plafonds de dépenses quotidiens, mensuels ou totaux pour chaque clé API.
Rubriques connexes
Sources
- Documentation Claude Code : erreurs
- Documentation Claude Code : paramètres
- Documentation API Anthropic : erreurs
Claude et Claude Code sont des marques d'Anthropic PBC. aicodewith est une plateforme indépendante et n'est ni affiliée à ni approuvée par Anthropic. Les formats d'erreur sont cités de Claude Code et peuvent changer. Vérifié le 2026-10-10.