Référence des erreurs
Consultez les messages d'erreur d'exécution de Claude Code avec leur signification et comment les corriger.
Cette page répertorie les erreurs d'exécution que Claude Code affiche et comment récupérer de chacune d'elles, ainsi que ce qu'il faut vérifier lorsque les réponses semblent incorrectes sans erreur. Pour les erreurs d'installation telles que command not found ou les défaillances TLS lors de la configuration, consultez Dépannage de l'installation et de la connexion.
Ces erreurs et les commandes de récupération s'appliquent sur l'ensemble de l'interface CLI, l'application Desktop et Claude Code sur le web, car les trois encapsulent le même CLI Claude Code. Pour les problèmes spécifiques à une surface, consultez la section dépannage sur la page de cette surface.
Claude Code appelle l'API Claude pour les réponses du modèle, donc la plupart des erreurs d'exécution correspondent à un code d'erreur API sous-jacent. Cette page couvre ce que chaque erreur signifie dans Claude Code et comment récupérer. Pour les définitions brutes du code de statut HTTP, consultez la référence des erreurs de la plateforme Claude.
Trouvez votre erreur
Faites correspondre le message que vous voyez dans votre terminal à une section ci-dessous.
| Message | Section |
|---|---|
API Error: 500 Internal server error |
Erreurs serveur |
API Error: Repeated 529 Overloaded errors |
Erreurs serveur |
Request timed out |
Erreurs serveur, ou Réseau si le message mentionne votre connexion Internet |
Server error mid-response. The response above may be incomplete. |
Erreurs serveur |
Connection closed mid-response / Response stalled mid-stream |
Erreurs serveur |
<model> is temporarily unavailable, so auto mode cannot determine the safety of... |
Erreurs serveur |
Auto mode could not evaluate this action and is blocking it for safety |
Erreurs serveur |
Auto mode classifier transcript exceeded context window |
Erreurs serveur |
Agent terminated early due to an API error |
Erreurs serveur |
You've hit your session limit / You've hit your weekly limit |
Limites d'utilisation |
Usage credits required for 1M context |
Limites d'utilisation |
Server is temporarily limiting requests |
Limites d'utilisation |
Request rejected (429) |
Limites d'utilisation |
Credit balance is too low |
Limites d'utilisation |
Not logged in · Please run /login |
Authentification |
Could not resolve authentication method |
Authentification |
Invalid API key |
Authentification |
This organization has been disabled |
Authentification |
Your organization has disabled API key authentication |
Authentification |
Your organization has disabled Claude subscription access |
Authentification |
Routines are disabled by your organization's policy |
Authentification |
Remote Control is only available when using Claude via api.anthropic.com |
Authentification |
OAuth token revoked / OAuth token has expired |
Authentification |
does not meet scope requirement user:profile |
Authentification |
AWS credentials expired or invalid |
Authentification |
AWS authentication failed |
Authentification |
Unable to connect to API |
Réseau |
Waiting for API response · will retry in |
Tentatives automatiques, ou Réseau si le problème persiste |
SSL certificate verification failed |
Réseau |
SSL certificate error (...) during login or startup |
Réseau |
403 with x-deny-reason: host_not_allowed in a cloud or routine session |
Réseau |
Couldn't reconnect to your Remote Control session |
Réseau |
Prompt is too long |
Erreurs de requête |
Error during compaction: Conversation too long |
Erreurs de requête |
Request too large |
Erreurs de requête |
Image was too large |
Erreurs de requête |
Unable to resize image |
Erreurs de requête |
PDF too large / PDF is password protected |
Erreurs de requête |
Extra inputs are not permitted |
Erreurs de requête |
There's an issue with the selected model |
Erreurs de requête |
Model ... is not a recognized model id |
Erreurs de requête |
Claude Opus is not available with the Claude Pro plan |
Erreurs de requête |
Model ... is restricted by your organization's settings |
Erreurs de requête |
thinking.type.enabled is not supported for this model |
Erreurs de requête |
max_tokens must be greater than thinking.budget_tokens |
Erreurs de requête |
API Error: 400 due to tool use concurrency issues |
Erreurs de requête |
Claude Code is unable to respond to this request, which appears to violate our Usage Policy |
Erreurs de requête |
<model> has safety measures that flagged this message for a cybersecurity topic |
Erreurs de requête |
Installation was killed before it could finish (exit code 137) |
Erreurs d'installation |
The connection dropped while downloading the update |
Erreurs d'installation |
Download timed out: exceeded the total deadline |
Erreurs d'installation |
--bg and --print conflict |
Erreurs de ligne de commande |
Error: --json-schema is not a valid JSON Schema |
Erreurs de ligne de commande |
Could not import <server>: <reason> |
Erreurs de ligne de commande |
Marketplace "<name>" is registered from an untrusted source |
Erreurs de plugin |
Ignoring N permissions.allow entries from ... this workspace has not been trusted |
Avertissements de configuration |
| Responses seem lower quality than usual | Qualité des réponses |
Tentatives automatiques
Claude Code réessaie les défaillances transitoires avant de vous afficher une erreur. Les erreurs serveur, les réponses surchargées, les délais d'attente des requêtes, les accélérateurs 429 temporaires et les connexions interrompues sont tous réessayés jusqu'à 10 fois avec un backoff exponentiel. {/* min-version: 2.1.198 /}À partir de la v2.1.198, cela couvre les connexions qui se déconnectent au milieu d'une réponse avant que toute sortie visible n'ait été diffusée : Claude Code réédite la requête avec le même backoff et le tour continue au lieu de s'arrêter avec une erreur de connexion. {/ min-version: 2.1.199 */}À partir de la v2.1.199, les accélérateurs 429 temporaires qui ne portent pas les en-têtes de quota de votre plan sont également réessayés lorsque vous êtes connecté avec un abonnement claude.ai ; les versions antérieures les réessayaient uniquement pour les connexions par clé API et Enterprise.
Deux classes de défaillances ne sont pas réessayées, car une tentative ne peut pas réussir :
- {/* min-version: 2.1.199 */}À partir de la v2.1.199, une défaillance de validation de certificat TLS, telle qu'un proxy inspectant TLS, un bundle
NODE_EXTRA_CA_CERTSmanquant ou un certificat expiré, échoue à la première tentative pour que le correctif apparaisse immédiatement au lieu d'après le budget de tentative complet. Consultez Erreurs de certificat SSL. Les conditions TLS transitoires telles qu'un délai d'attente de poignée de main réessaient toujours. - {/* min-version: 2.1.199 */}À partir de la v2.1.199, une erreur serveur qui arrive après que Claude a déjà diffusé une sortie visible conserve la réponse partielle et ajoute un avis de réponse incomplète au lieu de réessayer, car réexécuter la requête pourrait exécuter les mêmes appels d'outils deux fois. Les versions antérieures ont rejeté la sortie partielle et ont signalé le tour comme une erreur.
Lors des tentatives, le spinner affiche un compte à rebours Retrying in Ns · attempt x/y après une étiquette d'erreur. L'étiquette nomme la raison spécifique de la première tentative pour les défaillances sur lesquelles vous pouvez agir immédiatement : le réseau est en panne, une poignée de main TLS a échoué, ou vous avez atteint une limite de débit. Pour les autres erreurs, elle lit API error au début. {/* min-version: 2.1.198 */}À partir de la v2.1.198, elle bascule vers la raison spécifique de la troisième tentative, ou à la tentative finale lorsque CLAUDE_CODE_MAX_RETRIES permet moins de trois ; les versions antérieures ne basculent qu'à la tentative finale.
{/* min-version: 2.1.198 */}À partir de la v2.1.198, l'indice de spinner habituel est supprimé lors des tentatives. Une fois que la raison de l'erreur est révélée, si la défaillance est un surcharge 529, la ligne sous le compte à rebours nomme également où vérifier l'état du service : status.claude.com sur l'API Anthropic, ou l'hôte du fournisseur ou de la passerelle nommé dans le message sur d'autres configurations.
{/* min-version: 2.1.185 */}Si aucune donnée n'arrive sur le flux de réponse pendant 20 secondes alors qu'une requête est toujours en attente, le spinner affiche Waiting for API response · will retry in … · check your network avant que toute tentative n'ait commencé. La requête n'a pas encore échoué : le compte à rebours s'exécute jusqu'au point où Claude Code abandonne la connexion bloquée et réessaie, de sorte que la bannière s'efface d'elle-même une fois que les données reprennent ou que la tentative réussit. À partir de la v2.1.185, le seuil est de 20 secondes ; les versions antérieures affichent la bannière après 10 secondes avec un libellé différent. Si elle réapparaît à chaque tentative, traitez-la comme un problème réseau.
Lorsque vous voyez l'une des erreurs de cette page, ces tentatives ont déjà été épuisées, sauf si elle appartient à une classe qui n'est pas réessayée, telle qu'une défaillance de validation de certificat. Vous pouvez ajuster le comportement avec ces variables d'environnement :
| Variable | Par défaut | Effet |
|---|---|---|
CLAUDE_CODE_MAX_RETRIES |
10 | Nombre de tentatives de réessai. {/* min-version: 2.1.186 /}Limité à 15 à partir de la v2.1.186 ; {/ min-version: 2.1.199 */}à partir de la v2.1.199 CLAUDE_CODE_RETRY_WATCHDOG augmente la valeur par défaut et supprime le plafond. Réduisez-le pour afficher les défaillances plus rapidement dans les scripts. |
CLAUDE_CODE_RETRY_WATCHDOG |
non défini | Définissez sur 1 dans les sessions sans surveillance telles que les tâches CI pour réessayer les erreurs de capacité 429 et 529 indéfiniment au lieu d'échouer après CLAUDE_CODE_MAX_RETRIES tentatives. {/* min-version: 2.1.199 */}À partir de la v2.1.199, il augmente également le nombre de tentatives par défaut pour les autres erreurs transitoires, telles que les erreurs serveur, les délais d'attente et les connexions interrompues, à 300, environ trois heures de backoff, et supprime le plafond de 15 sur CLAUDE_CODE_MAX_RETRIES si vous définissez cette variable explicitement. |
API_TIMEOUT_MS |
600000 | Délai d'attente par requête en millisecondes. Augmentez-le pour les réseaux lents ou les proxies. |
Erreurs serveur
Ces erreurs proviennent du fournisseur d'inférence plutôt que de votre compte ou de votre demande. Sur l'API Anthropic, cela signifie l'infrastructure Anthropic. Sur Amazon Bedrock, la plateforme Agent de Google Cloud, Microsoft Foundry ou une passerelle personnalisée, cela signifie l'infrastructure de ce fournisseur.
Erreur API : 500 Erreur serveur interne
Claude Code affiche le code d'état et le message d'erreur de l'API pour toute réponse 5xx. L'exemple ci-dessous montre une réponse 500 sur l'API Anthropic :
API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.
La phrase finale indique où vérifier l'état du service et varie selon le fournisseur. Les configurations Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry indiquent l'état du service de ce fournisseur. Une ANTHROPIC_BASE_URL personnalisée indique l'hôte de la passerelle.
Cela indique une défaillance inattendue à l'intérieur de l'API. Elle n'est pas causée par votre prompt, vos paramètres ou votre compte.
Que faire :
- Vérifiez status.claude.com, ou la page d'état du fournisseur nommée dans le message, pour les incidents actifs
- Attendez une minute, puis renvoyez votre message. Votre message original est toujours dans la conversation, donc pour un long prompt vous pouvez taper
try againau lieu de coller le tout. - Si l'erreur persiste sans incident signalé, exécutez
/feedbackpour qu'Anthropic puisse enquêter avec les détails de votre demande. Consultez Report an error si/feedbackn'est pas disponible dans votre environnement.
Erreur API : Erreurs 529 Overloaded répétées
L'API est temporairement à capacité pour tous les utilisateurs. Claude Code a déjà réessayé plusieurs fois avant d'afficher ce message :
API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.
La phrase finale varie selon le fournisseur de la même manière que l'erreur 500 ci-dessus.
Un 529 n'est pas votre limite d'utilisation et ne compte pas contre votre quota.
Que faire :
- Vérifiez status.claude.com, ou la page d'état du fournisseur nommée dans le message, pour les avis de capacité
- Réessayez dans quelques minutes
- Exécutez
/modelet basculez vers un modèle différent pour continuer à travailler, car la capacité est suivie par modèle. Claude Code vous invite à le faire quand un modèle est sous une charge particulièrement élevée, par exempleOpus is experiencing high load, please use /model to switch to Sonnet.
Délai d'attente de la demande dépassé
L'API n'a pas répondu avant la limite de connexion.
Request timed out
Cela peut se produire pendant les périodes de charge élevée ou quand le modèle génère une réponse très volumineuse. Le délai d'attente de demande par défaut est de 10 minutes.
Que faire :
- Réessayez la demande
- Pour les tâches longues, divisez le travail en prompts plus petits
- Si un réseau lent ou un proxy en est la cause, augmentez
API_TIMEOUT_MScomme décrit dans Automatic retries - Si les délais d'attente sont fréquents et votre réseau est par ailleurs sain, consultez Network and connection errors ci-dessous
La réponse ci-dessus peut être incomplète
Une réponse en streaming a échoué après que Claude ait déjà produit une sortie visible. Le renvoi de la demande pourrait exécuter les mêmes appels d'outils deux fois, donc Claude Code conserve ce qui a déjà été diffusé en streaming et ajoute cet avis à la place de rejeter le tour. La variante que vous voyez indique la cause :
API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection closed mid-response. The response above may be incomplete.
API Error: Response stalled mid-stream. The response above may be incomplete.
- {/* min-version: 2.1.199 */}
Server error mid-response: une erreur serveur surchargée ou 5xx en milieu de flux. Cette variante nécessite Claude Code v2.1.199 ou ultérieur ; avant cela, ce cas rejetait la sortie partielle et signalait le tour entier comme une erreur. Connection closed mid-response: la connexion a été interrompue.Response stalled mid-stream: le flux a cessé d'envoyer des données.
Que faire :
- Lisez la réponse qui a été diffusée en streaming. Rien n'a été perdu, mais les dernières phrases ou appels d'outils peuvent manquer.
- Répondez avec
continuepour que Claude reprenne là où il s'est arrêté - Si la même erreur apparaît avant toute sortie visible, Claude Code réessaye la demande au lieu de la finaliser. Consultez Automatic retries.
Le mode auto ne peut pas déterminer la sécurité d'une action
Le modèle que le mode auto utilise pour classer les actions n'a pas pu produire une décision, donc le mode auto n'a pas approuvé l'action automatiquement. Le message que vous voyez dépend de la raison de l'échec du classificateur.
Les lectures, recherches et modifications à l'intérieur de votre répertoire de travail ignorent le classificateur, donc elles continuent à fonctionner dans tous ces cas.
Quand le modèle classificateur est surchargé :
<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.
Que faire :
- Réessayez après quelques secondes ; Claude voit le même message et réessaye généralement de lui-même
- Si les tentatives continuent d'échouer, continuez avec les tâches en lecture seule et revenez à l'action bloquée plus tard
- C'est transitoire et sans rapport avec l'admissibilité du mode auto ; vous n'avez pas besoin de modifier les paramètres
Quand le classificateur a renvoyé une réponse non analysable :
Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details
Que faire :
- Réessayez l'action ; cela réussit généralement à la tentative suivante
- Exécutez
claude --debuget répétez l'action pour voir la réponse du classificateur sous-jacente dans le journal de débogage
Quand une vérification de sécurité API distincte a bloqué la demande du classificateur en raison du contenu de la conversation antérieure :
Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details
Que faire :
- Ce n'est pas une décision concernant votre action. Le contenu déjà dans votre conversation a déclenché un filtre de sécurité sur l'API quand le mode auto a envoyé la conversation au classificateur
- Le renvoi n'aidera pas ; le même contenu de conversation déclenchera le filtre à nouveau
- Basculez vers un mode de permission différent pour pouvoir approuver l'action quand vous y êtes invité, ou commencez une nouvelle conversation sans le contenu déclencheur
Quand la conversation a grandi au-delà de la fenêtre de contexte du classificateur :
Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
Dans une session interactive, le mode auto revient à une invite de permission normale pour cette action afin que vous puissiez l'approuver ou la refuser manuellement. En mode non-interactif, l'exécution s'arrête car la transcription ne fait que croître et le renvoi ne peut pas réussir.
Que faire :
- Approuvez ou refusez l'action dans l'invite qui apparaît
- Exécutez
/compactpour réduire la taille de la conversation afin que les actions suivantes s'adaptent à nouveau à la fenêtre du classificateur
Agent terminé prématurément en raison d'une erreur API
{/* min-version: 2.1.199 */}La demande API d'un sous-agent a échoué de manière terminale, par exemple parce qu'une limite d'utilisation a été atteinte ou que les tentatives pour une erreur serveur ont épuisé, donc le sous-agent s'est arrêté avant de terminer sa tâche. Ce message nécessite Claude Code v2.1.199 ou ultérieur ; avant cela, le texte d'erreur API était renvoyé à Claude comme s'il s'agissait du résultat du sous-agent.
Agent terminated early due to an API error: <error detail>
Que faire :
- Faites correspondre le détail de l'erreur après les deux points à sa propre section sur cette page, telle que Usage limits ou Server errors, et suivez les étapes de cette section
- Une fois que l'erreur sous-jacente est résolue, demandez à Claude de réessayer la tâche ou de reprendre le sous-agent
Quand une limite de débit, une surcharge ou une erreur serveur interrompt un sous-agent au premier plan qui a déjà produit une sortie textuelle, Claude reçoit cette sortie partielle marquée comme incomplète au lieu de cette erreur. {/* min-version: 2.1.200 */}Un sous-agent dont la seule sortie était des appels d'outils reçoit également cette erreur ; en v2.1.199, cela renvoyait un résultat partiel vide à la place. Consultez API errors in subagents.
Limites d'utilisation
Ces erreurs signifient qu'un quota lié à votre compte ou à votre plan a été atteint. Elles sont distinctes des erreurs serveur, qui affectent tout le monde.
Vous avez atteint votre limite de session
Les plans d'abonnement incluent une allocation d'utilisation glissante. Quand elle s'épuise, vous voyez l'un de ces messages :
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
Claude Code bloque les demandes supplémentaires jusqu'à l'heure de réinitialisation indiquée dans le message.
À faire :
- Attendez l'heure de réinitialisation indiquée dans l'erreur
- Exécutez
/usagepour voir les limites de votre plan et quand elles se réinitialisent - Exécutez
/usage-creditspour acheter une utilisation supplémentaire sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise. Consultez usage credits for paid plans pour savoir comment cela est facturé. - Pour mettre à niveau votre plan vers des limites de base plus élevées, consultez claude.com/pricing
Pour surveiller votre allocation restante avant d'atteindre la limite, ajoutez les champs rate_limits à une ligne d'état personnalisée, ou dans l'application Desktop, cliquez sur l'anneau d'utilisation à côté du sélecteur de modèle.
Crédits d'utilisation requis pour le contexte 1M
Le modèle sélectionné utilise la fenêtre de contexte étendue 1M-token, et votre plan ne l'inclut que par le biais de crédits d'utilisation.
API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context
Il s'agit d'une vérification de droit, et non d'un épuisement de quota. Elle se déclenche même quand vos allocations de session et hebdomadaires ont de la capacité restante. Consultez Extended context pour voir quels plans incluent directement le contexte 1M et lesquels nécessitent des crédits d'utilisation.
{/* min-version: 2.1.172 */}Quand cette erreur apparaît au milieu d'une conversation parce que le contexte a dépassé 200K tokens, Claude Code compacte automatiquement la conversation en dessous de la limite de contexte standard et maintient la session à cette limite par la suite, donc aucune action n'est nécessaire. Sur les versions antérieures à v2.1.172, l'erreur s'est répétée à chaque demande ultérieure, y compris /compact ; exécutez /clear sur ces versions pour récupérer. Les étapes ci-dessous s'appliquent quand vous avez explicitement sélectionné un modèle [1m].
À faire :
- Exécutez
/modelet sélectionnez la variante sans le suffixe[1m]pour revenir à la fenêtre de contexte standard - Exécutez
/usage-creditspour activer la facturation mesurée pour la variante 1M sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise - Si l'erreur persiste après
/model, un ID de modèle 1M peut être défini ailleurs. Consultez There's an issue with the selected model pour les emplacements de configuration à vérifier par ordre de priorité. - Pour supprimer entièrement les variantes 1M du sélecteur de modèle, définissez
CLAUDE_CODE_DISABLE_1M_CONTEXT=1
Le serveur limite temporairement les demandes
L'API a appliqué un throttle de courte durée qui n'est pas lié à votre quota de plan.
API Error: Server is temporarily limiting requests (not your usage limit)
Claude Code les distingue de votre limite de plan par l'absence des en-têtes de quota unifiés qu'une réponse de limite réelle porte. {/* min-version: 2.1.199 */}À partir de v2.1.199, ceci est réessayé automatiquement avec backoff avant d'être affiché, quelle que soit votre méthode d'authentification. Sur les versions antérieures, une session connectée avec un abonnement claude.ai a échoué le tour à la première occurrence ; seules les authentifications par clé API et Enterprise l'ont réessayé.
À faire :
- Attendez brièvement et réessayez
- Vérifiez status.claude.com si cela persiste
Demande rejetée (429)
Vous avez atteint la limite de débit configurée pour votre clé API, votre projet Amazon Bedrock ou votre projet Google Cloud.
API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.
La phrase de fin indique où vérifier la santé du service et varie selon le fournisseur. Les configurations Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry nomment la page d'état du service de ce fournisseur au lieu de la page d'état Anthropic. Une ANTHROPIC_BASE_URL personnalisée nomme l'hôte de la passerelle.
À faire :
- Exécutez
/statuset confirmez que les identifiants actifs sont ceux que vous attendez. UneANTHROPIC_API_KEYégarée dans votre environnement peut acheminer les demandes via une clé de niveau inférieur au lieu de votre abonnement. - Vérifiez votre console de fournisseur pour les limites actives et demandez un niveau supérieur si nécessaire
- Pour les clés API Anthropic, consultez la référence des limites de débit pour savoir comment fonctionnent les niveaux et comment définir des plafonds par espace de travail
- Réduisez la concurrence : abaissez
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, évitez d'exécuter de nombreux sous-agents parallèles, ou passez à un modèle plus petit avec/modelpour les exécutions scriptées à haut volume
Le solde de crédit est trop faible
Votre organisation Console a épuisé ses crédits prépayés.
Credit balance is too low
À faire :
- Ajoutez des crédits sur platform.claude.com/settings/billing, et envisagez d'activer le rechargement automatique pour que le solde se reconstitue avant d'atteindre zéro
- Passez à l'authentification par abonnement avec
/loginsi vous avez un plan Pro, Max, Team ou Enterprise - Définissez des plafonds de dépenses par espace de travail dans la Console pour empêcher un seul projet de drainer le solde de l'organisation. Consultez Manage costs effectively.
Erreurs d'authentification
Ces erreurs signifient que Claude Code ne peut pas prouver votre identité à l'API. Exécutez /status à tout moment pour voir quelle credential est actuellement active.
Non connecté
Aucune credential valide n'est disponible pour cette session.
Not logged in · Please run /login
À faire :
- Exécutez
/loginpour vous authentifier avec votre abonnement Claude ou votre compte Console - Si vous vous attendiez à ce qu'une variable d'environnement vous authentifie, confirmez que
ANTHROPIC_API_KEYest définie et exportée dans le shell où vous avez lancéclaude - Pour l'intégration continue ou l'automatisation où la connexion interactive n'est pas possible, configurez un script
apiKeyHelperqui récupère une clé au démarrage - Consultez Précédence d'authentification pour comprendre quelle credential Claude Code utilise quand plusieurs sont présentes
Si vous êtes invité à vous connecter à plusieurs reprises, consultez Non connecté ou token expiré pour les corrections d'horloge système et de Keychain macOS.
Impossible de résoudre la méthode d'authentification
La session a atteint le client API sans aucune credential. Cela apparaît dans les sessions en arrière-plan, les sessions cloud et les contextes Agent SDK où la vérification de connexion interactive ne s'exécute pas avant la première requête.
Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted
{/* min-version: 2.1.174 */}Avant la v2.1.174, une session en arrière-plan ou cloud assignée à un worker pré-initialisé inactif pouvait échouer de cette façon même quand des credentials valides étaient configurées. Mettez à jour pour récupérer. Sur les versions actuelles, l'erreur signifie qu'aucune credential n'était disponible pour le processus worker.
À faire :
- Mettez à jour vers la v2.1.174 ou ultérieure si cela apparaît dans une session en arrière-plan ou cloud et que vos credentials sont déjà configurées
- Confirmez que
ANTHROPIC_API_KEY,CLAUDE_CODE_OAUTH_TOKENou vos credentials du fournisseur cloud sont définis dans l'environnement qui lance le worker, pas seulement dans votre shell interactif - Pour l'Agent SDK, consultez configuration de l'authentification
- Exécutez
/statusdans une session interactive dans le même environnement pour confirmer quelle source de credential se résout
Clé API invalide
La variable d'environnement ANTHROPIC_API_KEY ou le script apiKeyHelper a retourné une clé que l'API a rejetée.
Invalid API key · Fix external API key
À faire :
- Vérifiez les fautes de frappe et confirmez que la clé n'a pas été révoquée dans la Console
- Exécutez
env | grep ANTHROPICdans le même shell. Des outils comme direnv, les plugins shell dotenv et les terminaux IDE peuvent charger une clé obsolète à partir d'un fichier.envdans votre projet sans que vous la définissiez explicitement. - Déconfigurez
ANTHROPIC_API_KEYet exécutez/loginpour utiliser l'authentification par abonnement à la place - Si la clé provient d'un script
apiKeyHelper, exécutez le script directement pour confirmer qu'il imprime une clé valide sur stdout - Exécutez
/statuspour confirmer quelle source de credential Claude Code utilise réellement
Cette organisation a été désactivée
Une ANTHROPIC_API_KEY obsolète d'une organisation Console désactivée remplace votre connexion par abonnement.
Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
API Error: 400 ... This organization has been disabled.
Les variables d'environnement ont la priorité sur /login, donc une clé exportée dans votre profil shell ou chargée à partir d'un fichier .env est utilisée même quand vous avez un abonnement Pro ou Max fonctionnant. En mode non-interactif (-p), la clé est toujours utilisée quand elle est présente.
À faire :
- Déconfigurez
ANTHROPIC_API_KEYdans le shell actuel et supprimez-la de votre profil shell, puis relancezclaude - Exécutez
/statusaprès pour confirmer que la credential active est votre abonnement - Si aucune variable d'environnement n'est définie et que l'erreur persiste, l'organisation désactivée est celle liée à votre
/login. Contactez le support ou connectez-vous avec un compte différent.
Votre organisation a désactivé l'authentification par clé API
Ce message nécessite Claude Code v2.1.169 ou ultérieur. L'administrateur de votre organisation Console a désactivé l'authentification par clé API, donc l'API rejette la clé que Claude Code envoie. L'indice de récupération après le · varie selon d'où provient la clé :
Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
Les variables d'environnement et apiKeyHelper ont la priorité sur /login, donc exécuter /login seul n'aide pas tant que l'un ou l'autre fournit toujours une clé. Consultez Précédence d'authentification.
À faire :
- Si le message nomme
ANTHROPIC_API_KEY, déconfigurez-la dans le shell actuel et supprimez-la de votre profil shell ou fichier.env, puis relancezclaude - Si le message nomme
apiKeyHelper, supprimez le paramètreapiKeyHelperde votresettings.json - Exécutez
/loginpour vous connecter avec votre compte claude.ai - Exécutez
/statusaprès pour confirmer que la credential active est votre abonnement plutôt qu'une clé API - Si vous avez besoin de l'authentification par clé API pour l'automatisation, demandez à votre administrateur d'organisation de la réactiver dans la Console
Votre organisation a désactivé l'accès à l'abonnement Claude
Votre organisation Claude ne permet pas de se connecter à Claude Code avec une connexion par abonnement. Exécuter /login à nouveau avec le même compte retourne la même erreur.
Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
C'est un paramètre d'organisation côté serveur, donc il ne peut pas être remplacé à partir des paramètres locaux, des variables d'environnement ou des drapeaux CLI.
L'Agent SDK et le mode non-interactif -p présentent cela comme le code d'erreur oauth_org_not_allowed.
À faire :
- Demandez à votre administrateur d'activer l'accès à Claude Code pour votre organisation
- Authentifiez-vous avec une clé API Console au lieu de votre abonnement. Consultez Authentification Claude Console pour la configuration.
- Si vous êtes l'administrateur et que vous ne voyez pas d'option pour activer l'accès, contactez le support Anthropic
Les routines sont désactivées par la politique de votre organisation
Un propriétaire de votre organisation Team ou Enterprise a désactivé les routines au niveau de l'organisation. L'erreur apparaît quand vous essayez de créer ou d'exécuter une routine, y compris à partir de /schedule et de l'interface utilisateur Routines sur claude.ai/code.
Routines are disabled by your organization's policy.
C'est un paramètre côté serveur, donc il ne peut pas être remplacé à partir des paramètres locaux, des variables d'environnement ou des drapeaux CLI.
À faire :
- Demandez à un propriétaire de votre organisation d'activer le bouton bascule Routines sur claude.ai/admin-settings/claude-code
- Pour un travail programmé ponctuel qui ne nécessite pas de routines au niveau de l'organisation, consultez tâches programmées
Remote Control nécessite l'API Anthropic
La session ne parle pas directement à l'API Anthropic, donc il n'y a pas de backend claude.ai pour que Remote Control s'apparie avec.
Remote Control is only available when using Claude via api.anthropic.com.
Cela apparaît sur Amazon Bedrock, la plateforme Agent de Google Cloud et Microsoft Foundry. {/* min-version: 2.1.196 */}À partir de la v2.1.196, cela apparaît également quand ANTHROPIC_BASE_URL pointe vers un hôte autre que api.anthropic.com, comme une passerelle LLM ou un proxy, même quand vous vous connectez avec claude.ai.
À faire :
- Déconfigurez
ANTHROPIC_BASE_URLet redémarrez la session, ou démarrez Remote Control à partir d'une session qui parle directement à l'API Anthropic - Pour ce message et les autres messages de démarrage de Remote Control, consultez Dépannage de Remote Control
Token OAuth révoqué ou expiré
Votre connexion enregistrée n'est plus valide. Un token révoqué signifie que vous vous êtes déconnecté partout ou qu'un administrateur a supprimé l'accès ; un token expiré signifie que l'actualisation automatique a échoué en cours de session.
OAuth token revoked · Please run /login
OAuth token has expired · Please run /login
API Error: 401 ... authentication_error
À faire :
- Exécutez
/loginpour vous reconnecter - Si l'erreur revient dans la même session après réauthentification, exécutez d'abord
/logoutpour effacer complètement le token stocké, puis/login - Pour les invites répétées à vous connecter entre les lancements, consultez les vérifications d'horloge système et de Keychain macOS dans Dépannage
- Pour les autres défaillances incluant
403 Forbiddenet les problèmes de navigateur OAuth, consultez Connexion et authentification
Exigence de portée OAuth
Le token stocké est antérieur à une portée de permission qu'une fonctionnalité plus récente nécessite. Vous voyez cela le plus souvent à partir de /usage et de l'indicateur d'utilisation de la ligne d'état :
OAuth token does not meet scope requirement: user:profile
À faire :
- Exécutez
/loginpour obtenir un nouveau token avec les portées actuelles. Vous n'avez pas besoin de vous déconnecter d'abord.
Les credentials AWS ont expiré ou sont invalides
{/* min-version: 2.1.198 */}Ce message nécessite Claude Code v2.1.198 ou ultérieur et n'apparaît que quand awsAuthRefresh est défini dans votre fichier de paramètres. Votre token de session AWS a expiré ou a été rejeté, et l'actualisation automatique que Claude Code a déjà exécutée n'a pas produit une credential que l'API accepte. Cela apparaît sur un 401 de Claude Platform on AWS ou du point de terminaison Mantle, c'est ainsi que ces fournisseurs signalent un token de sécurité expiré.
L'indice d'action au milieu nomme la commande awsAuthRefresh de vos paramètres, donc il varie. La partie stable est le début AWS credentials expired or invalid :
AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
Sans awsAuthRefresh configuré, le même 401 affiche le message générique Please run /login à la place, qui ne peut pas actualiser les credentials AWS.
À faire :
- Exécutez la commande
awsAuthRefreshnommée dans le message, commeaws sso login --profile myprofile, dans un autre terminal et complétez la connexion au navigateur, puis réessayez - Dans une session interactive, exécutez
/login, choisissez plateforme tierce, puis sélectionnez Claude Platform on AWS · refresh credentials sous Utilisation de plateformes tierces pour exécuter la même commande sans redémarrer Claude Code. Consultez Configurer les credentials AWS - Si l'erreur se répète après que la commande d'actualisation réussisse, confirmez que l'identité est valide en dehors de Claude Code avec
aws sts get-caller-identitydans le même shell et profil
L'authentification AWS a échoué
{/* min-version: 2.1.198 */}Ce message nécessite Claude Code v2.1.198 ou ultérieur et n'apparaît que quand awsAuthRefresh est défini dans votre fichier de paramètres. Votre fournisseur AWS a retourné un 403, ou Amazon Bedrock a retourné un 401.
Claude Code ne peut pas dire quelle cause vous avez atteinte. Amazon Bedrock signale un token de sécurité expiré comme un 403, mais un 403 est aussi comment il signale un refus d'autorisation, comme une AccessDeniedException d'une permission IAM manquante ou d'un modèle qui n'est pas activé pour votre compte.
Un 401 d'Amazon Bedrock atterrit également ici plutôt que sous Les credentials AWS ont expiré ou sont invalides, car Amazon Bedrock ne signale pas un token expiré comme un 401. Un 401 de ce point de terminaison provient généralement de quelque chose d'autre dans le chemin de la requête, comme un proxy d'entreprise.
Une actualisation de credential corrige un token expiré et ne peut pas corriger les autres causes, donc le message offre les deux :
AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
L'indice d'action au milieu nomme la commande awsAuthRefresh de vos paramètres, donc il varie. La partie stable est le début AWS authentication failed.
À faire :
- Exécutez la commande
awsAuthRefreshnommée dans le message, ouaws sso login, au cas où une credential expirée serait la cause - Si vos credentials sont actuelles, confirmez que les permissions IAM dans Configuration IAM sont attachées à l'identité que vous utilisez et que le modèle sélectionné est activé pour votre compte et région
- Exécutez
aws sts get-caller-identitypour confirmer quelle identité vos requêtes utilisent ; unAWS_PROFILEobsolète ou un profil par défaut est une cause courante d'une incompatibilité de permission
Erreurs de réseau et de connexion
Ces erreurs signifient qu'une requête réseau de Claude Code n'a pas pu atteindre sa destination. Elles proviennent généralement de votre réseau local, d'un proxy, d'un pare-feu, ou de la politique réseau de l'environnement cloud.
Impossible de se connecter à l'API
La connexion TCP à l'API a échoué ou ne s'est jamais complétée.
Unable to connect to API. Check your internet connection
Unable to connect to API (ECONNREFUSED)
Unable to connect to API (ECONNRESET)
Unable to connect to API (ETIMEDOUT)
fetch failed
Request timed out. Check your internet connection and proxy settings
Les causes courantes incluent l'absence d'accès à Internet, un VPN qui bloque api.anthropic.com, ou un proxy d'entreprise requis qui n'est pas configuré.
Que faire :
- Confirmez que vous pouvez atteindre l'hôte API depuis le même shell en exécutant
curl -I https://api.anthropic.com. Sur Windows PowerShell, utilisezcurl.exe -I https://api.anthropic.compour que l'aliasInvoke-WebRequestintégré ne soit pas utilisé. - Si vous êtes derrière un proxy d'entreprise, définissez
HTTPS_PROXYavant de lancer Claude Code et consultez Configuration réseau - Si vous routez via une passerelle LLM ou un relais, définissez
ANTHROPIC_BASE_URLsur son adresse. Consultez Connecter Claude Code à une passerelle LLM pour la configuration. - Assurez-vous que votre pare-feu autorise les hôtes listés dans Exigences d'accès réseau
- Les défaillances intermittentes sont réessayées automatiquement ; les défaillances persistantes indiquent un problème réseau local
Si curl réussit mais que Claude Code échoue toujours, la cause est généralement quelque chose entre le runtime et le réseau plutôt que le réseau lui-même :
- Sur Linux et WSL, vérifiez
/etc/resolv.confpour un serveur de noms inaccessible. WSL en particulier peut hériter d'un résolveur cassé de l'hôte. - Sur macOS, un client VPN qui a été déconnecté ou désinstallé peut laisser une interface tunnel ou une règle de routage. Vérifiez
ifconfigpour les interfacesutunobsolètes et supprimez l'extension réseau du VPN dans Paramètres système. - Docker Desktop et les runtimes de conteneurs similaires peuvent intercepter le trafic sortant. Quittez-les et réessayez pour exclure cette possibilité.
Erreurs de certificat SSL
Un proxy ou un appareil de sécurité sur votre réseau intercepte le trafic TLS avec son propre certificat, et Claude Code ne lui fait pas confiance.
Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
Unable to connect to API: Self-signed certificate detected
{/* min-version: 2.1.199 */}À partir de la v2.1.199, une défaillance de validation de certificat n'est pas réessayée, donc cette erreur apparaît à la première tentative au lieu d'après le budget de retry complet. Les versions antérieures ont passé quelques minutes à réessayer avant de l'afficher. Les conditions TLS transitoires, telles qu'un délai d'expiration de poignée de main, sont toujours réessayées.
Pendant /login et la vérification de connectivité au démarrage, la même défaillance est signalée avec le code OpenSSL et le correctif en ligne :
SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.
Que faire :
- Exportez le bundle CA de votre organisation et pointez Claude Code dessus avec
NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem - Consultez Configuration réseau pour les instructions de configuration complètes
- Ne définissez pas
NODE_TLS_REJECT_UNAUTHORIZED=0, qui désactive entièrement la validation de certificat
Hôte non autorisé dans une session cloud
Une requête HTTP sortante d'une session cloud ou d'une routine a été bloquée par la politique réseau de l'environnement.
HTTP 403
x-deny-reason: host_not_allowed
Vous pouvez également voir un certificat TLS qui ne correspond pas au certificat réel de la destination. L'environnement cloud route le trafic sortant via un proxy qui applique la politique réseau, donc un certificat non correspondant signifie que le proxy a terminé la connexion, pas la destination.
Ce n'est pas un problème réseau côté client. Les sessions cloud et les routines s'exécutent dans un environnement en sandbox dont le trafic sortant est filtré selon la liste d'autorisation de l'environnement. L'environnement Default utilise l'accès Trusted, qui autorise la liste d'autorisation par défaut des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants, mais bloque tout le reste.
Que faire :
- Ouvrez la routine pour la modifier, ou démarrez une session cloud. Sélectionnez l'icône cloud affichant le nom de votre environnement, tel que Default, pour ouvrir le sélecteur. Survolez votre environnement et cliquez sur l'icône des paramètres.
- Dans la boîte de dialogue Update cloud environment, changez Network access de Trusted à Custom, puis ajoutez le domaine bloqué à Allowed domains. Entrez un domaine par ligne. Cochez Also include default list of common package managers pour conserver la liste d'autorisation par défaut aux côtés de vos domaines personnalisés. Sélectionnez Full à la place si vous souhaitez un accès sans restriction.
- Cliquez sur Save changes. La prochaine exécution utilise la liste d'autorisation mise à jour.
Consultez Network access pour les niveaux d'accès et la liste d'autorisation par défaut. Les sessions CLI locales ne sont pas affectées par cette politique.
Impossible de se reconnecter à votre session Remote Control
Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
La reprise avec claude --resume ou claude --continue se reconnecte à la session Remote Control enregistrée dans cette conversation. Ce message signifie que la reconnexion a échoué pour une raison qui peut être temporaire, telle qu'une interruption réseau ou une erreur serveur, donc Claude Code ne peut pas confirmer si la session distante existe toujours. Votre session locale continue de s'exécuter sans Remote Control.
Que faire :
- Exécutez
/remote-controlpour réessayer la connexion - Démarrez Claude Code sans
--resumepour créer une nouvelle session Remote Control - Pour les autres messages de démarrage Remote Control, consultez Dépanner Remote Control
Vous ne verrez pas ce message lorsque le serveur confirme que la session précédente n'existe plus ; Claude Code en crée une nouvelle dans ce cas. {/* min-version: 2.1.200 */}Avant la v2.1.200, toute défaillance de reconnexion créait une nouvelle session Remote Control, ce qui laissait des sessions supplémentaires dans la liste des sessions sur claude.ai/code.
Erreurs de requête
Ces erreurs concernent le contenu de votre requête. La plupart proviennent de l'API après qu'elle ait rejeté la requête ; quelques-unes sont produites localement par Claude Code avant l'envoi de toute requête.
Le prompt est trop long
La conversation plus les fichiers joints dépassent la fenêtre de contexte du modèle.
Prompt is too long
À faire :
- Exécutez
/compactpour résumer les tours précédents et libérer de l'espace, ou/clearpour recommencer à zéro - Exécutez
/contextpour voir une ventilation de ce qui consomme la fenêtre : prompt système, outils, fichiers mémoire et messages - Désactivez les serveurs MCP que vous n'utilisez pas avec
/mcp disable <name>pour supprimer leurs définitions d'outils du contexte - Réduisez les fichiers mémoire
CLAUDE.mdvolumineux, ou déplacez les instructions dans les règles limitées au chemin qui se chargent uniquement lorsqu'elles sont pertinentes - Les sous-agents héritent de chaque définition d'outil MCP de la session parent, ce qui peut remplir leur fenêtre de contexte avant le premier tour. Désactivez les serveurs MCP que vous n'utilisez pas avant de générer des sous-agents.
- L'auto-compact est activé par défaut et empêche normalement cette erreur. Si vous avez défini
DISABLE_AUTO_COMPACT, réactivez-le ou exécutez/compactmanuellement avant que la fenêtre ne se remplisse.
Consultez Explorez la fenêtre de contexte pour une vue interactive de la façon dont le contexte se remplit.
Erreur lors de la compaction : Conversation trop longue
/compact lui-même a échoué car il n'y a pas assez d'espace libre dans le contexte pour contenir le résumé qu'il produit.
Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
Cela peut se produire lorsque la fenêtre est déjà pleine au moment où l'auto-compact se déclenche, ou lorsque vous exécutez /compact après avoir vu Prompt is too long.
À faire :
- Appuyez deux fois sur Échap pour ouvrir la liste des messages et revenir plusieurs tours en arrière. Cela supprime les messages les plus récents du contexte. Ensuite, exécutez
/compactà nouveau. - Si revenir en arrière ne libère pas assez d'espace, exécutez
/clearpour démarrer une nouvelle session. Votre conversation précédente est conservée et peut être rouverte avec/resume.
Requête trop volumineuse
Le corps de la requête brute a dépassé la limite d'octets de l'API avant la tokenisation, généralement en raison d'un fichier volumineux collé ou d'une pièce jointe.
Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.
Il s'agit d'une limite de taille sur la requête HTTP, distincte de la limite de la fenêtre de contexte.
À faire :
- Appuyez deux fois sur Échap et revenez en arrière au-delà du tour qui a ajouté le contenu surdimensionné
- Référencez les fichiers volumineux par chemin au lieu de coller leur contenu, afin que Claude puisse les lire par morceaux
- Pour les images, consultez L'image était trop volumineuse ci-dessous
L'image était trop volumineuse
Une image collée ou jointe dépasse les limites de taille ou de dimension de l'API.
Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size
{/* min-version: 2.1.142 */}Claude Code remplace l'image non traitée par un espace réservé textuel et réessaie, de sorte que les messages suivants réussissent. Sur les versions antérieures à 2.1.142, une image collée pouvait rester dans la conversation et répéter la même erreur à chaque message suivant. Pour récupérer sur ces versions, appuyez deux fois sur Échap et revenez en arrière au-delà du tour où l'image a été ajoutée.
À faire :
- Redimensionnez l'image avant de la coller. L'API accepte les images jusqu'à 8 000 pixels sur le côté le plus long pour une seule image, ou 2 000 pixels lorsque de nombreuses images sont en contexte.
- Prenez une capture d'écran plus serrée de la région pertinente au lieu de l'écran complet
Impossible de redimensionner l'image
Claude Code n'a pas pu réduire une image jointe avant de l'envoyer à l'API.
Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
Claude Code redimensionne normalement les grandes images automatiquement. Ces erreurs signifient que le processeur d'image natif n'a pas pu se charger ou a renvoyé une erreur, de sorte que l'image n'a pas pu être redimensionnée pour s'adapter aux limites de l'API.
À faire :
- Si le message vous demande de convertir l'image, convertissez-la en PNG, JPEG, GIF ou WebP et joignez-la à nouveau. Claude Code peut vérifier les dimensions de ces formats sans le processeur d'image.
- Si le message signale une limite de dimension ou de taille, redimensionnez ou recompressez l'image en dessous de cette limite avant de la joindre.
Erreurs PDF
Le PDF que vous avez joint n'a pas pu être traité.
PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.
PDF is password protected. Try removing protection or extracting text first.
The PDF file was not valid. Try converting to a different format first.
À faire :
- Pour les PDF surdimensionnés, demandez à Claude de lire une plage de pages avec l'outil Read au lieu de joindre le fichier entier, ou extrayez le texte avec un outil comme
pdftotextet référencez le fichier de sortie par chemin - Pour les PDF protégés ou invalides, supprimez le mot de passe ou réexportez le fichier depuis son application source, puis réessayez
Les entrées supplémentaires ne sont pas autorisées
Un proxy ou une passerelle LLM entre Claude Code et l'API a supprimé l'en-tête de requête anthropic-beta, de sorte que l'API a rejeté les champs qui en dépendent.
API Error: 400 ... Extra inputs are not permitted ... context_management
API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples
API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header
Claude Code envoie des champs bêta uniquement tels que context_management, effort et les input_examples d'outils aux côtés d'un en-tête anthropic-beta qui les active. Lorsqu'une passerelle transfère le corps mais supprime l'en-tête, l'API voit des champs qu'elle ne reconnaît pas.
À faire :
- Configurez votre passerelle pour transférer l'en-tête
anthropic-beta. Consultez feature pass-through pour savoir ce que les passerelles doivent transférer. - En dernier recours, définissez
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1avant de lancer. Cela désactive les fonctionnalités qui nécessitent l'en-tête bêta afin que les requêtes réussissent via une passerelle qui ne peut pas le transférer.
Il y a un problème avec le modèle sélectionné
Le nom du modèle configuré n'a pas été reconnu ou votre compte n'a pas accès à celui-ci. À partir de v2.1.160, l'indice de fin, montré ici sous sa forme interactive, varie selon la surface.
There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.
À faire :
- CLI interactif : exécutez
/modelpour choisir parmi les modèles disponibles pour votre compte. - Mode non interactif (
-p) : passez--modelavec un alias ou un ID valide, ou définissezANTHROPIC_MODEL. Le texte d'erreur afficheRun --modelsur cette surface. - Agent SDK : le texte d'erreur omet l'indice car le modèle est défini par programmation. Définissez
modelsurOptionsen TypeScript ouClaudeAgentOptions(model=...)en Python, et gérez l'erreur structuréemodel_not_foundpour afficher votre propre retry ou sélecteur de modèle. - Utilisez un alias tel que
sonnetouopusau lieu d'un ID complet avec version. Les alias se résolvent en une valeur par défaut maintenue afin qu'ils ne deviennent pas obsolètes. Consultez Configuration du modèle. - Si le mauvais modèle continue à revenir dans la CLI, un ID obsolète est défini quelque part. Vérifiez dans l'ordre de priorité : l'indicateur
--model, la variable d'environnementANTHROPIC_MODEL, puis le champmodeldans.claude/settings.local.json, le.claude/settings.jsonde votre projet, et~/.claude/settings.json. Supprimez la valeur obsolète et Claude Code revient à la valeur par défaut de votre compte. - Pour les déploiements Google Cloud's Agent Platform, consultez Dépannage de Google Cloud's Agent Platform.
Le modèle n'est pas un ID de modèle reconnu
La chaîne de modèle que vous avez transmise à un changement de modèle n'est pas un alias de modèle, un ID de modèle que cette version de Claude Code connaît, ou un ID qui commence par claude-. Les causes habituelles sont une faute de frappe dans l'ID, un nom d'affichage tel que Sonnet 5 où l'ID claude-sonnet-5 est attendu, ou un alias que seules les versions plus récentes de Claude Code reconnaissent. Claude Code rejette immédiatement le changement. Avant v2.1.200, Claude Code enregistrait la chaîne et échouait à la requête suivante avec Il y a un problème avec le modèle sélectionné.
Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?
L'indice de fin nomme l'alias ou l'ID de modèle le plus proche. Lorsque rien n'est assez proche, il lit Run /model to see available models. à la place.
Claude Code produit cette erreur localement au moment où le changement est demandé, avant toute requête API. Elle s'applique lorsqu'un modèle est défini via la méthode Agent SDK setModel() ou par une application telle que l'application de bureau qui exécute la CLI Claude Code pour vous.
À faire :
- Exécutez
/modelsans argument pour ouvrir le sélecteur et choisir parmi les modèles disponibles pour votre compte, puis transmettez l'alias ou l'ID affiché là - Si vous avez utilisé un alias qu'une version plus récente de Claude Code supporte, exécutez
claude update. Un ID complet qui commence parclaude-réussit cette vérification même lorsque le modèle est plus récent que votre version de Claude Code, donc la mise à niveau n'est pas nécessaire pour ceux-ci. - Un modèle enregistré avant v2.1.200 n'est pas réparé par cette vérification. Si une valeur obsolète continue à revenir, supprimez-la des emplacements listés sous Il y a un problème avec le modèle sélectionné.
- La vérification s'exécute uniquement sur l'API Anthropic. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS, et derrière une passerelle LLM ou une
ANTHROPIC_BASE_URLpersonnalisée, votre fournisseur ou passerelle définit les noms de modèles, de sorte que Claude Code accepte n'importe quelle chaîne et la transmet.
Claude Opus n'est pas disponible avec le plan Claude Pro
Votre plan d'abonnement actif n'inclut pas le modèle que vous avez sélectionné.
Claude Opus is not available with the Claude Pro plan · Select a different model in /model
À faire :
- Exécutez
/modelet sélectionnez un modèle que votre plan inclut - Si vous avez récemment mis à niveau votre plan et voyez toujours ceci, exécutez
/logoutpuis/login. Le jeton stocké reflète votre plan au moment où vous vous êtes connecté, de sorte que la mise à niveau sur le web ne prend effet dans une session existante que lorsque vous vous réauthentifiez. - Consultez claude.com/pricing pour voir quels modèles chaque plan inclut
Le modèle est restreint par les paramètres de votre organisation
Votre administrateur d'organisation a désactivé ce modèle dans la console d'administration claude.ai, ou il est exclu par une liste d'autorisation availableModels dans les paramètres gérés. Lorsque le modèle restreint a été défini avec --model, ANTHROPIC_MODEL, ou le paramètre model, Claude Code substitue un modèle autorisé et continue. Taper /model <name> pour un modèle restreint est rejeté avec Run /model to choose a different model. et la session conserve son modèle actuel.
Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
Claude Code traite un alias de famille de modèles, l'un de opus, sonnet, haiku, ou fable, comme une demande de cette famille plutôt que de sa version la plus récente. Sur l'API Anthropic et sur Claude Platform on AWS, un alias de famille restreint se résout à la version la plus récente de la famille que votre organisation et la liste d'autorisation availableModels permettent, et l'avis de substitution nomme cette version. Claude Code rejette /model <alias> uniquement lorsque chaque version de la famille est restreinte. Avant v2.1.205, un alias de famille était substitué ou rejeté en fonction de sa version la plus récente seule, même lorsqu'une version plus ancienne de la même famille était autorisée.
À faire :
- Exécutez
/modelpour choisir parmi les modèles que votre organisation autorise. Les modèles restreints sont masqués du sélecteur. - Si le modèle restreint a été défini dans
--model,ANTHROPIC_MODEL, ou le champmodeld'un fichier de paramètres, supprimez ou mettez à jour cette valeur afin que l'avis ne se reproduise pas à chaque lancement - Si vous avez besoin d'accès au modèle restreint, demandez à votre administrateur d'organisation de l'activer. Consultez Restrictions de modèle d'organisation.
thinking.type.enabled n'est pas supporté pour ce modèle
Votre version de Claude Code est plus ancienne que le minimum pour Sonnet 5, Opus 4.8, ou Opus 4.7. La CLI a envoyé une configuration de réflexion que le modèle n'accepte plus.
API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
À faire :
- Exécutez
claude updateet redémarrez Claude Code. Opus 4.7 nécessite v2.1.111 ou ultérieur. Opus 4.8 nécessite v2.1.154 ou ultérieur. Sonnet 5 nécessite v2.1.197 ou ultérieur - Si vous ne pouvez pas mettre à niveau, exécutez
/modelet sélectionnez Opus 4.6 ou Sonnet 4.6 à la place - {/* min-version: agent-sdk@0.3.197 */}Si vous rencontrez ceci dans l'Agent SDK, mettez à niveau le package SDK à la place. Opus 4.8 nécessite TypeScript SDK v0.3.154 ou ultérieur et Python SDK v0.2.88 ou ultérieur. Sonnet 5 nécessite TypeScript SDK v0.3.197 ou ultérieur
Le budget de réflexion dépasse la limite de sortie
Le budget de réflexion étendue configuré dépasse la longueur de réponse maximale, il n'y a donc pas de place pour la réponse réelle.
API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
Claude Code ajuste ces valeurs automatiquement sur l'API Anthropic. Vous voyez généralement cette erreur sur Amazon Bedrock ou Google Cloud's Agent Platform lorsque MAX_THINKING_TOKENS est défini plus haut que la limite de sortie du fournisseur, ou lorsque le mode plan augmente le budget de réflexion.
À faire :
- Abaissez
MAX_THINKING_TOKENS, ou augmentezCLAUDE_CODE_MAX_OUTPUT_TOKENSau-dessus du budget de réflexion - Consultez Réflexion étendue pour savoir comment le budget interagit avec la longueur de sortie
Décalage de bloc d'utilisation d'outil ou de réflexion
L'historique de conversation a atteint l'API dans un état incohérent, généralement après qu'un appel d'outil ait été interrompu ou qu'un tour ait été modifié en cours de flux.
API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified
Les trois variantes signifient la même chose : la séquence de blocs tool_use, tool_result et thinking dans l'historique ne correspond plus à ce que l'API attend.
À faire :
- {/* max-version: 2.1.155 */}Si vous utilisez Opus 4.7 ou Opus 4.8, exécutez d'abord
claude update. Les versions antérieures à v2.1.156 peuvent déclencher cette erreur lors de l'utilisation normale d'outils, et/rewindne la supprime pas. - Exécutez
/rewind, ou appuyez deux fois sur Échap, pour revenir à un point de contrôle avant le tour corrompu et continuer à partir de là. Consultez Points de contrôle pour savoir comment les points de contrôle sont créés et restaurés.
Refus de la politique d'utilisation
L'API a refusé de répondre car le contenu de la conversation a déclenché une vérification de la Politique d'utilisation. Le message inclut un ID de requête que vous pouvez citer au support si vous pensez que le refus est incorrect.
API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.
La vérification évalue la conversation complète, pas seulement votre dernier prompt, de sorte que l'envoi d'un nouveau message dans la même session réactive généralement le même refus. Il en va de même après la sortie et la réouverture de la session avec --continue ou --resume, puisque la transcription sur disque contient toujours le contenu déclencheur. Sur Amazon Bedrock, Google Cloud's Agent Platform, et Microsoft Foundry, ce message couvre également les requêtes que les mesures de sécurité du modèle ont signalées comme un sujet de cybersécurité. Consultez Les mesures de sécurité ont signalé un sujet de cybersécurité.
À faire :
- Appuyez deux fois sur Échap ou exécutez
/rewindpour revenir à un point de contrôle avant le tour qui a déclenché le refus, puis reformulez ou adoptez une approche différente. Consultez Points de contrôle. - Si vous ne pouvez pas identifier quel tour l'a causé, exécutez
/clearpour démarrer une nouvelle conversation dans le même projet. Votre conversation précédente est conservée sur disque et reste disponible dans/resume. - En mode non interactif (
-p), où la rembobinage n'est pas disponible, réessayez avec un prompt reformulé dans une nouvelle session sans--continue. Les vérifications de politique varient selon le modèle, de sorte que le passage à un modèle différent avec--modelpeut également résoudre le refus dans certains cas.
Les mesures de sécurité ont signalé un sujet de cybersécurité
Les mesures de sécurité du modèle ont signalé le contenu de la conversation comme un sujet de cybersécurité. Le message nomme le modèle qui a signalé la requête :
API Error: Opus 4.8 has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.
If you were not engaging in a cybersecurity topic, please send feedback via /feedback.
Le message renvoie au Programme de vérification de la cybersécurité, qui accorde l'accès pour les travaux de cybersécurité légitimes. La protection elle-même est côté serveur et antérieure à v2.1.203 ; cette version a changé uniquement la formulation du message et la page vers laquelle il renvoie.
Ce que vous voyez dépend de votre fournisseur et de votre mode :
- Sur Amazon Bedrock, Google Cloud's Agent Platform, et Microsoft Foundry, un drapeau de cybersécurité produit le message Refus de la politique d'utilisation à la place.
- Le mode non interactif omet la phrase
/feedback.
{/* max-version: 2.1.202 */}Avant v2.1.203, le message lisait <model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption: suivi d'un lien de formulaire d'exemption.
À faire :
- Si votre travail nécessite ce contenu, demandez l'accès via le Programme de vérification de la cybersécurité
- Si votre requête n'était pas sur un sujet de cybersécurité, exécutez
/feedbackpour signaler le faux positif - Pour continuer à travailler dans la même session, appuyez deux fois sur Échap ou exécutez
/rewindpour revenir à un point de contrôle avant le tour qui a déclenché le drapeau, puis adoptez une approche différente. Consultez Points de contrôle.
Erreurs d'installation
Ces erreurs apparaissent lors de l'installation ou de la mise à jour de Claude Code, à partir du script d'installation, claude install, ou claude update. Pour les problèmes de command not found, PATH, permission et TLS lors de la configuration, consultez Dépannage de l'installation et de la connexion.
L'installation a été interrompue avant de pouvoir se terminer
Le script d'installation signale quand l'étape claude install est terminée par un signal. Sur Linux, le code de sortie 137 signifie que le processus a reçu SIGKILL, et sur un hôte à faible mémoire, c'est généralement le tueur de mémoire insuffisante (OOM) du noyau. Le script affiche cette explication et se termine avec le code 137 :
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.
Pour tout autre signal fatal, et pour le code de sortie 137 sur macOS, le script affiche Installation was killed before it could finish (exit code <N>) avec le code de sortie réel et omet l'explication de mémoire insuffisante. Le message provient du script d'installation que macOS et Linux utilisent, qui couvre également les installations à l'intérieur de WSL ; les scripts d'installation Windows natifs ne l'affichent jamais. Avant la v2.1.200, le script se terminait avec seulement la ligne Killed du shell.
Que faire :
- Arrêtez les autres processus pour libérer de la mémoire, puis relancez le programme d'installation
- Ajoutez de l'espace d'échange ou passez à une instance plus grande. Consultez Installation interrompue sur les serveurs Linux à faible mémoire pour les commandes de fichier d'échange.
La connexion s'est interrompue lors du téléchargement de la mise à jour
La connexion au serveur de téléchargement s'est fermée pendant que claude install, claude update, ou le programme de mise à jour automatique récupérait le binaire Claude Code, et les tentatives n'ont pas récupéré. Claude Code réessaie le téléchargement quand la connexion s'interrompt, le transfert s'arrête, ou le fichier téléchargé échoue sa somme de contrôle, jusqu'à trois tentatives au total. Une erreur HTTP complétée, comme un 404, n'est pas réessayée car le serveur a déjà répondu. {/* min-version: 2.1.202 */}Avant la v2.1.202, une seule connexion interrompue échouait le téléchargement immédiatement avec l'erreur simple aborted au lieu de réessayer.
The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
Le texte entre parenthèses nomme quelle tentative a échoué et l'erreur réseau sous-jacente. claude update précède le message avec Error: Failed to install native update sur stderr.
Un téléchargement qui reste connecté mais ne se termine pas dans les 10 minutes échoue avec Download timed out: exceeded the total deadline à la place. Claude Code ne réessaie pas un téléchargement qui a expiré, car une connexion trop lente pour se terminer dans le délai ne se terminera pas lors d'une tentative immédiate non plus. Les étapes ci-dessous s'appliquent aux deux messages. Avant la v2.1.205, le même délai de 10 minutes était signalé comme le générique timeout of 600000ms exceeded du client HTTP.
La cause habituelle est un proxy ou une passerelle qui ferme un long transfert avant qu'il ne se termine. Le binaire Claude Code est un grand téléchargement, donc une limite de connexion proxy qui n'affecte jamais le trafic API normal peut quand même l'interrompre.
Que faire :
- Exécutez
claude updateà nouveau. Sur un réseau par ailleurs sain, le téléchargement réussit généralement à la prochaine exécution. Pour le message d'expiration, exécutez-le à nouveau à partir d'un réseau plus rapide ou moins limité. - Si votre réseau nécessite un proxy, définissez
HTTPS_PROXYavant d'exécuter le programme d'installation ouclaude update. Consultez Vérifier la connectivité réseau. - Si un proxy d'entreprise continue de fermer le transfert, demandez à votre équipe réseau d'autoriser le téléchargement complet depuis
downloads.claude.ai. Consultez Exigences d'accès réseau. - Exécutez
claude doctorà partir de votre shell pour les diagnostics d'installation
Erreurs de ligne de commande
Ces erreurs proviennent de la commande claude et de ses sous-commandes. Claude Code les affiche avant d'exécuter votre prompt ou d'envoyer une requête API.
Conflit entre --bg et --print
Ce message nécessite Claude Code v2.1.198 ou version ultérieure. Vous avez combiné --bg avec -p ou --print dans la même invocation claude. --bg démarre une session en arrière-plan à laquelle vous vous connectez ultérieurement avec claude agents, tandis que --print s'exécute de manière non interactive et ne démarre jamais la session interactive à laquelle claude agents se connecte. Avant la v2.1.198, cette combinaison créait silencieusement un travail en arrière-plan qui ne pouvait jamais être attaché.
--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.
Ce qu'il faut faire :
- Supprimez
-pou--print.--bgprend le prompt comme argument positionnel, doncclaude --bg "<task>"est la commande complète. Voir Dispatch new agents from your shell. - Pour exécuter le prompt de manière non interactive et imprimer le résultat au lieu de créer une session en arrière-plan, supprimez
--bget exécutezclaude -p "<task>"
La valeur --json-schema n'est pas un JSON Schema valide
Le schéma que vous avez transmis à --json-schema en mode non interactif a échoué la compilation JSON Schema, donc claude se termine avec le code 1 au lieu d'exécuter le prompt. Avant la v2.1.205, un schéma invalide produisait une sortie non structurée sans erreur, et tout schéma utilisant le mot-clé format était traité comme invalide.
Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
Le texte après le deuxième deux-points est le diagnostic du validateur et nomme le mot-clé ou l'emplacement qui a échoué. Les schémas qui utilisent le mot-clé format, comme "format": "email", sont valides : Claude Code accepte format comme annotation et ne l'applique pas.
Claude Code exécute deux vérifications avant la compilation du schéma : il rejette une valeur qui n'est pas du JSON analysable avec Error: --json-schema is not valid JSON, et du JSON valide qui n'est pas un objet avec Error: --json-schema must be a JSON object.
Ce qu'il faut faire :
- Corrigez la partie du schéma que le diagnostic nomme, puis réexécutez la commande
- Si le diagnostic est
schema too large, réduisez l'imbrication du schéma et la réutilisation de$ref - Voir Get structured output pour un schéma et une commande fonctionnels
Impossible d'importer un serveur depuis Claude Desktop
Claude Code n'a pas pu ajouter l'un des serveurs que vous avez sélectionnés dans claude mcp add-from-claude-desktop. La commande importe toujours les autres serveurs sélectionnés et affiche une ligne par serveur qu'elle n'a pas pu ajouter. Avant la v2.1.205, le premier serveur qui a échoué a arrêté l'importation et aucun des serveurs sélectionnés n'a été ajouté.
Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
Le texte après le nom du serveur est la raison. La plus courante est la vérification du nom : Claude Desktop autorise les caractères dans les noms de serveurs, tels que les espaces et les points, que claude mcp restreint aux lettres, chiffres, traits d'union et traits de soulignement. D'autres raisons incluent une configuration de serveur qui échoue la validation et un serveur bloqué par la politique MCP de votre organisation.
Ce qu'il faut faire :
- Renommez le serveur dans
claude_desktop_config.jsonpour utiliser uniquement des lettres, des chiffres, des traits d'union et des traits de soulignement, puis exécutezclaude mcp add-from-claude-desktopà nouveau - Ajoutez ce serveur directement avec
claude mcp addouclaude mcp add-jsonsous un nom valide. Voir Import MCP servers from Claude Desktop.
Erreurs de plugin
Ces erreurs proviennent de la configuration des plugins et des marketplaces. Pour les problèmes de plugin qui ne produisent pas l'un des messages de cette page, comme une URL de marketplace qui ne se charge pas ou un plugin qui s'installe mais n'apparaît pas, consultez Dépannage des plugins.
Marketplace enregistrée à partir d'une source non fiable
La marketplace est enregistrée sous un nom qui est réservé aux marketplaces officielles d'Anthropic, mais sa source enregistrée n'est pas un référentiel GitHub anthropics. Claude Code revérifie les noms réservés chaque fois qu'il charge ou actualise une marketplace, de sorte que la marketplace et les plugins installés à partir de celle-ci cessent de se charger. Avant la v2.1.205, le nom n'était vérifié que lors de l'ajout de la marketplace, de sorte qu'une entrée enregistrée avant que son nom ne soit réservé continuait à se charger.
Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.
À faire :
- Exécutez
claude plugin marketplace remove <name>, puis ajoutez à nouveau la marketplace à partir du référentiel officielgithub.com/anthropics - Si vous publiez une marketplace tierce qui utilisait le nom avant qu'il ne soit réservé, renommez-la et demandez aux utilisateurs de la rajouter à partir de votre source
- Consultez la liste des noms réservés sous Schéma de marketplace
Avertissements de configuration
Claude Code écrit ces messages sur stderr au démarrage plutôt que d'afficher une erreur dans la conversation. Ils signalent la configuration qu'il a lue mais n'a pas appliquée.
L'espace de travail n'a pas été approuvé
Claude Code a trouvé des règles permissions.allow ou des entrées permissions.additionalDirectories dans le fichier .claude/settings.json ou .claude/settings.local.json du projet et ne les a pas appliquées, car les règles d'autorisation des paramètres du projet nécessitent l'approbation de l'espace de travail. Le nombre, le nom du paramètre et le fichier nommé dans le message varient selon votre configuration. Les règles deny et ask ne sont pas affectées.
Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.
Que faire :
- Exécutez
claudedans le répertoire et acceptez la boîte de dialogue d'approbation. {/* min-version: 2.1.200 */}La boîte de dialogue s'affiche même si un répertoire parent est déjà approuvé, répertorie les règles retenues et vous permet de refuser et de continuer à travailler sans elles. Avant la v2.1.200, aucune boîte de dialogue n'apparaissait dans cette situation, donc cette étape ne pouvait pas être complétée là. - En mode non interactif avec
-p, aucune boîte de dialogue n'est affichée. Définissez l'entréehasTrustDialogAccepteddans~/.claude.jsonen utilisant la cléprojectsexacte que le message affiche. - {/* min-version: 2.1.200 */}Si le message nomme
.claude/settings.local.jsonet que vous avez démarré Claude Code en dehors d'un référentiel git ou dans votre répertoire personnel, mettez à jour vers la v2.1.200 ou une version ultérieure. Les versions 2.1.196 à 2.1.199 ont traité votre propre.claude/settings.local.jsoncomme fournie par le référentiel dans ces espaces de travail. Voir Règles d'autorisation du projet et approbation de l'espace de travail.
Les réponses semblent de qualité inférieure à la normale
Si les réponses de Claude semblent moins performantes que prévu mais qu'aucune erreur n'est affichée, la cause est généralement l'état de la conversation plutôt que le modèle lui-même. Claude Code ne change pas silencieusement les versions de modèle. Il peut basculer vers un modèle de secours dans trois cas spécifiques :
- Un
--fallback-modelconfiguré prend le relais après une erreur de disponibilité, pour ce tour uniquement, avec un avis dans la transcription - Une vérification de démarrage d'Amazon Bedrock ou de la plateforme Agent de Google Cloud détecte que votre modèle par défaut n'est pas disponible
- Le basculement automatique du modèle sur Fable 5 déplace la session vers le modèle Opus par défaut et affiche un avis dans la transcription
La vérification de sélection du modèle ci-dessous détecte les deuxième et troisième cas ; le premier apparaît comme un avis de transcription plutôt qu'un changement de /model. La configuration du modèle explique quand chaque basculement s'applique.
Vérifiez d'abord ceci :
- Sélection du modèle : exécutez
/modelpour confirmer que vous êtes sur le modèle attendu. Un choix/modelprécédent ou une variable d'environnementANTHROPIC_MODELpeut vous placer sur un modèle plus petit que prévu. - Niveau d'effort : exécutez
/effortpour vérifier le niveau de raisonnement actuel et l'augmenter pour le débogage difficile ou le travail de conception. Les valeurs par défaut varient selon le modèle, vérifiez donc avant de supposer que vous êtes en dessous du maximum. Consultez Ajuster le niveau d'effort pour les valeurs par défaut par modèle et le raccourciultrathink. - Pression contextuelle : exécutez
/contextpour voir le remplissage de la fenêtre. S'il est proche de la capacité, exécutez/compactà un point naturel ou/clearpour recommencer. Consultez Explorer la fenêtre contextuelle pour voir comment l'auto-compact affecte les tours précédents. - Instructions obsolètes : les fichiers
CLAUDE.mdvolumineux ou obsolètes et les définitions d'outils MCP consomment du contexte et peuvent orienter les réponses. {/* min-version: 2.1.205 */}Le/doctorsignale les fichiers mémoire surdimensionnés et les extensions inutilisées, et/contextaffiche l'utilisation des jetons des outils MCP. Avant la v2.1.205,/doctorouvrait un écran de diagnostics qui signalait les fichiers mémoire surdimensionnés et les définitions de sous-agents.
Quand une réponse s'avère incorrecte, revenir en arrière fonctionne généralement mieux que de répondre avec des corrections. Appuyez deux fois sur Échap ou exécutez /rewind pour revenir avant le mauvais tour, puis reformulez l'invite avec plus de détails. Corriger dans le fil de discussion conserve la mauvaise tentative en contexte, ce qui peut ancrer les réponses ultérieures à celle-ci. Consultez Checkpointing.
Si la qualité semble toujours mauvaise après vérification des éléments ci-dessus, exécutez /feedback et décrivez ce que vous attendiez par rapport à ce que vous avez obtenu. Les commentaires soumis de cette manière incluent la transcription de la conversation, ce qui est le moyen le plus rapide pour Anthropic de diagnostiquer une véritable régression. Consultez Signaler une erreur si /feedback n'est pas disponible dans votre environnement.
{/* min-version: 2.1.201 */}Si Sonnet 5 refuse une demande et cite une injection d'invite suspectée sur Claude Code v2.1.200 ou antérieur, exécutez claude update pour récupérer le correctif v2.1.201.
Signaler une erreur
Pour les erreurs provenant de composants non couverts par cette page, consultez le guide pertinent :
- Le serveur MCP n'a pas pu se connecter ou s'authentifier : MCP
- Le script hook a échoué ou a bloqué un outil : Déboguer les hooks
- Erreur de permission ou erreurs du système de fichiers lors de l'installation : Dépanner l'installation et la connexion
Si une erreur n'est pas répertoriée ici ou si la correction suggérée ne vous aide pas :
- Exécutez
/feedbackdans Claude Code pour envoyer la transcription et une description à Anthropic. La commande propose également d'ouvrir un problème GitHub prérempli. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et d'autres fournisseurs tiers,/feedbackenregistre une archive locale que vous pouvez envoyer à votre représentant de compte Anthropic. - Exécutez
claude doctordepuis votre shell pour un diagnostic en lecture seule de votre installation, ou exécutez le diagnostic/doctordans Claude Code pour trouver et corriger les problèmes de configuration - Consultez status.claude.com pour les incidents actifs
- Recherchez les problèmes existants sur GitHub