Erreurs courantes de Claude Code et corrections

Index des messages d'erreur

Les messages d'erreur ci-dessous ont été testés sur Claude Code 2.1.299.

400

API Error: 400 {"error":"模型 xxx 不存在或未上线，请前往 https://aicodewith.com/zh/dashboard/pricing 查看可用模型列表 (request_id: …)"}

• •Le nom du modèle est mal orthographié ou le modèle n'est pas disponible : exécutez /model pour le choisir à nouveau, ou vérifiez l'ID du modèle sur la page des modèles.
• •Le contexte est trop long : exécutez /compact pour compresser la conversation, ou /clear pour démarrer une nouvelle session.

401 Authentification

Failed to authenticate. API Error: 401 {"error":"请在请求中提供有效的 API Key。"}

1. Copiez à nouveau la clé depuis le tableau de bord, vérifiez les espaces et retours à la ligne en début/fin, et assurez-vous que la clé n'a pas été supprimée.
2. Placez la clé dans ANTHROPIC_AUTH_TOKEN et laissez ANTHROPIC_API_KEY vide.
3. Dans un nouveau terminal, exécutez echo $ANTHROPIC_API_KEY et supprimez les anciennes valeurs dans ~/.zshrc ou ~/.bashrc.
4. Fermez toutes les sessions Claude Code et rouvrez-les, puis exécutez /status.

403 Clé désactivée

Failed to authenticate. API Error: 403 此 API Key 已被停用，如有疑问请联系我们 https://aicodewith.com/zh/contact

Une fois la clé désactivée ou supprimée, cette erreur apparaît en quelques secondes. Vérifiez l'état de la clé dans le tableau de bord, créez une nouvelle clé et mettez à jour votre configuration ; contactez-nous en cas de question.

Not logged in

Not logged in · Please run /login

Cela signifie que la clé est vide ou non configurée ; cela ne signifie pas que vous devez vous connecter à un compte Claude. Renseignez la clé dans ANTHROPIC_AUTH_TOKEN dans ~/.claude/settings.json et redémarrez Claude Code.

429 Limite de débit

{"error":"当前并发请求过多，请稍后重试 (request_id: …)"}

(Cette erreur a été reproduite avec des requêtes curl simultanées ; l'affichage dans Claude Code peut différer.)

Le paiement à l'usage n'a pas de quota de 5 heures ni hebdomadaire, mais des limites de débit et de concurrence s'appliquent toujours. Lorsque trop de requêtes sont envoyées en même temps, les requêtes excédentaires renvoient 429 ; attendez un instant et réessayez.

• •Fermez les sessions Claude Code supplémentaires et réduisez les sous-agents parallèles ; les scripts et tâches CI qui partagent la même clé comptent aussi.
• •Créez une clé distincte pour chaque personne ou pipeline afin d'identifier plus facilement la source.

overloaded

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}

La requête et la clé sont correctes ; le modèle est simplement occupé à ce moment-là. Le pic est généralement court et ne concerne qu'un modèle spécifique.

• •Attendez un instant et renvoyez ; la conversation ne sera pas perdue.
• •Exécutez /model pour passer à un autre modèle (par exemple, d'Opus à Sonnet) afin de terminer le travail en premier.
• •Vérifiez l'état du canal sur la page des modèles et, si nécessaire, basculez la clé vers un autre canal.

Délai d'attente / connexion interrompue (ECONNRESET)

API Error: Connection dropped (ECONNRESET)

Cette erreur apparaît lorsque le point de terminaison API est inaccessible ou que le domaine est incorrect.

• •Exécutez /status pour confirmer que le point de terminaison API est api.aicodewith.ai, et non l'adresse Anthropic par défaut.
• •Désactivez temporairement votre proxy local ou VPN et réessayez ; les connexions depuis la Chine peuvent fonctionner directement.

Lorsque la clé est incorrecte ou que le réseau est inaccessible, Claude Code réessaie automatiquement pendant environ 3 à 4 minutes, pendant lesquelles l'interface reste vide sans message. Si cela bloque longtemps, vérifiez d'abord la clé et le point de terminaison.

Problèmes d'API tierce (URL de base, configuration non appliquée)

There's an issue with the selected model (...). It may not exist or you may not have access to it. Run --model to pick a different model.

Si ANTHROPIC_BASE_URL est défini sur https://aicodewith.ai, ou contient un chemin incorrect (comme /foo), vous obtiendrez cette erreur. Cela ressemble à un problème de modèle, mais le point de terminaison est en réalité incorrect ; utilisez plutôt https://api.aicodewith.ai.

Les variables d'environnement sont prioritaires sur ~/.claude/settings.json : les anciennes valeurs exportées dans votre terminal remplaceront le fichier de configuration. Après avoir modifié une configuration, fermez toutes les sessions Claude Code (y compris les extensions VS Code et JetBrains) et rouvrez-les. La configuration standard est :

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}

• •ANTHROPIC_BASE_URL ne doit pas inclure /v1 ni de barre oblique finale.
• •Si le premier lancement reste bloqué sur la page de connexion, ajoutez "hasCompletedOnboarding": true dans ~/.claude.json.

Guide d'intégration Claude CodeConfiguration du relais Claude CodeDépannage des erreurs API Claude Haiku

FAQ