Teapot Router / Documentation
Dépannage Claude Code : connexion, 401 et quota
Associez l'erreur à la solution : réseau et proxy, clé et URL, solde et quota — trois vérifications pour trois familles de pannes.
Ouvrir l’espaceConnexion ou délai dépassé : vérifiez d'abord le réseau
- Le CLI n'hérite pas du proxy système. Lancez `echo $https_proxy` — si c'est vide, exportez-le puis réessayez.
- L'extension VSCode a sa propre pile réseau et n'hérite pas forcément du proxy ni des variables d'environnement — configurez le proxy dans l'extension.
- Avec un endpoint personnalisé, vérifiez ANTHROPIC_BASE_URL (caractères ou barres obliques en trop) ; ne mélangez pas l'URL officielle et celle d'une passerelle.
Si ça marche sur un autre réseau (partage mobile) mais pas chez vous, c'est purement réseau — pas la clé.
401 ou 403 : vérifiez la clé et l'adresse
- Le 401 vient souvent de la clé : copie incomplète (espaces), révoquée ou expirée, ou clé d'un autre fournisseur.
- Avec un endpoint personnalisé, clé et adresse vont par paire — la clé d'un fournisseur contre l'URL d'un autre donnera toujours 401.
- Un nom de champ mal orthographié dans le env de settings.js peut replier silencieusement sur l'endpoint par défaut : configuré en apparence, officiel en réalité.
Une clé révoquée ne se réactive jamais ; redémarrez le client après un changement de clé.
429, quota et modèle introuvable
- Le 429 est une limite de débit : attendez la fenêtre ou réduisez la concurrence.
- « Quota insuffisant » a deux niveaux : le solde du compte et la limite propre de la clé — cette limite plafonne l'usage, ce n'est pas un crédit supplémentaire.
- « Modèle introuvable » : vérifiez que l'ID de modèle du client correspond exactement (casse, version) au catalogue Modèles.
Chaque requête (modèle/tokens/coût) est dans l'historique d'utilisation — après l'erreur, rapprochez une entrée pour vérifier qu'aucune retry silencieux n'a double-facturé.