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

Claude Code
API Error (Connection error.) · Unable to connect to API (ECONNREFUSED) · Request timed out

Correctif étape par étape

  1. 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. 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. 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. 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ômeCause probable
ECONNREFUSED ou ENOTFOUNDHôte incorrect, ou DNS/proxy le bloque
Échoue uniquement sur VPN ou réseau d'entrepriseRègles de pare-feu ou de proxy
Expire uniquement sur les réponses longuesDélai d'attente trop court pour le réseau
Fonctionne avec curl, échoue dans Claude CodeParamè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).

État et prix des modèlesContacter le supportDocumentation

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

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.