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, plus 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.

À l'exception des erreurs de wrapper et d'IDE, que le programme de lancement imprime plutôt que Claude Code lui-même, ces erreurs et commandes de récupération s'appliquent sur l'ensemble de l'interface CLI, de l'application Desktop et des sessions cloud, car les trois encapsulent le même CLI Claude Code. Pour les autres problèmes spécifiques à la surface, consultez la section dépannage sur la page de cette surface.

Trouvez votre erreur

Faites correspondre le message que vous voyez à une section ci-dessous.

Tentatives automatiques

Claude Code réessaie les défaillances transitoires jusqu'à 10 fois avec un backoff exponentiel avant de vous afficher une erreur. Il ne réessaie pas toujours une défaillance qui arrive au milieu de la réponse de Claude. Lorsque vous voyez l'une des erreurs de cette page, Claude Code a déjà effectué les tentatives qui s'appliquent à cette défaillance.

Claude Code réessaie ces défaillances :

• Les erreurs serveur, les réponses surchargées et les délais d'attente de requête qui arrivent avant que la moindre partie de la réponse de Claude n'ait été envoyée en streaming.
• Une erreur serveur ou une réponse surchargée qui arrive après que Claude a terminé sa réflexion mais avant qu'il n'ait commencé un texte ou un appel d'outil. Claude Code réessaie une erreur serveur à ce stade jusqu'à deux fois. Avant v2.1.284, Claude Code terminait le tour avec l'erreur à ce stade.
• Les connexions interrompues. Lorsqu'une connexion s'interrompt au milieu d'une requête avant que Claude n'ait complété une partie de sa réponse, y compris sa réflexion, Claude Code renvoie la requête avec le même backoff et le tour continue, même si du texte avait déjà commencé à être envoyé en streaming. Lorsqu'elle s'interrompt après que Claude a terminé sa réflexion mais avant qu'il n'ait commencé un texte ou un appel d'outil, Claude Code renvoie plutôt la requête jusqu'à deux fois en succession rapide, et termine le tour avec Connection lost before a response was produced si la connexion continue à s'interrompre à ce stade.
• Une connexion que Claude Code détecte comme ayant été interrompue par votre ordinateur qui s'endort au milieu d'une requête. Claude Code la compte comme une connexion interrompue selon les règles ci-dessus ; une fois que l'étiquette de tentative nomme la raison spécifique, elle lit Connection lost while your computer was asleep, et si le tour se termine après que Claude a terminé sa réflexion mais avant un texte ou un appel d'outil, le message lit Your computer went to sleep before a response was produced.
• Un flux de réponse bloqué, lorsque les en-têtes de réponse sont arrivés mais aucune partie de la réponse de Claude n'est arrivée, ou lorsque Claude a terminé sa réflexion mais n'a pas commencé un texte ou un appel d'outil : Claude Code abandonne la connexion bloquée et renvoie la requête au maximum une fois, en dehors du budget de 10 tentatives ci-dessus. Si la réponse se bloque une deuxième fois après que Claude a terminé sa réflexion mais avant un texte ou un appel d'outil, Claude Code termine le tour avec The response stalled before a response was produced.
• Une requête en streaming à laquelle l'API ne répond jamais avec des en-têtes de réponse, sur une connexion où le délai de premier octet s'exécute : Claude Code l'abandonne à la date limite et la renvoie au maximum une fois par requête de modèle, dans le budget de tentatives, puis termine le tour avec No response from API si cette tentative reste sans réponse aussi. Sur d'autres connexions, la requête attend API_TIMEOUT_MS. Lorsque vous définissez CLAUDE_CODE_RETRY_WATCHDOG, le plafond d'une tentative ne s'applique pas.
• Les throttles 429 temporaires, mais pas le 429 de limite de dépenses d'une passerelle, qui n'est pas un throttle ; voir Spend limit reached.
  • Lorsque vous êtes connecté avec un abonnement claude.ai, cela inclut les throttles 429 qui ne portent pas les en-têtes de quota de votre plan. Avant v2.1.199, Claude Code ne réessayait ces throttles que pour les connexions par clé API et Enterprise.
• Une requête rejetée parce que l'entrée plus max_tokens dépasse la limite de contexte. La renvoyer inchangée échouerait de la même manière, donc Claude Code réessaie avec un max_tokens réduit, et arrête de réessayer et compacte à la place dans deux cas :
  • Lorsqu'aucune réduction ne peut tenir, par exemple lorsque la conversation elle-même remplit presque la fenêtre de contexte.
  • Lorsqu'une tentative ne peut pas réduire davantage max_tokens. Avant v2.1.218, Claude Code pouvait renvoyer une requête réduite qui ne tenait toujours pas, par exemple lorsque le budget de réflexion étendue dépassait le contexte restant, jusqu'à ce que le budget de tentatives s'épuise.
• Des identifiants Google Cloud expirés ou manquants sur Google Cloud's Agent Platform, ou des identifiants AWS qui ne se chargent pas sur votre machine. Claude Code rejette ses identifiants en cache et réessaie jusqu'à deux fois, puis signale l'erreur pour que vous puissiez vous réauthentifier immédiatement, comme décrit sous Could not load AWS or Google Cloud credentials. Avant v2.1.228, Claude Code réessayait des identifiants Google Cloud défaillants à travers le budget de tentatives complet avant d'afficher l'erreur.
• Un 401 ou 403 de l'API Anthropic, directement ou via une passerelle LLM, tandis qu'un script apiKeyHelper fournit les identifiants. Claude Code réexécute le script et réessaie avec sa sortie fraîche, dans le budget de tentatives complet. Lorsque le script lui-même échoue à la réexécution, Claude Code affiche Your apiKeyHelper script is failing à la place.

Avant v2.1.227, Connection lost before a response was produced lisait Connection closed while thinking, before producing a response et The response stalled before a response was produced lisait Response stalled while thinking, before producing a response.

Claude Code ne réessaie pas ces défaillances :

• Une défaillance de validation de certificat TLS, telle qu'un proxy inspectant TLS, un bundle NODE_EXTRA_CA_CERTS manquant, ou un certificat expiré. Claude Code signale l'erreur à la première tentative, pour que vous puissiez corriger la configuration du certificat immédiatement ; voir SSL certificate errors. Claude Code réessaie toujours les conditions TLS transitoires telles qu'un délai d'attente de poignée de main. Avant v2.1.199, Claude Code réessayait les défaillances de certificat à travers le budget de tentatives complet avant d'afficher l'erreur.
• Une erreur serveur, une connexion interrompue, ou un flux bloqué qui arrive après que Claude a complété un bloc de texte ou un appel d'outil, ou en a commencé un après avoir terminé sa réflexion, mais avant de terminer la réponse. Claude Code ne renvoie pas la requête, car cela pourrait exécuter les mêmes appels d'outils deux fois. Il conserve ce que Claude a complété, exécute tous les appels d'outils que Claude a terminés, et continue le tour à partir de leurs résultats. Pour ce que vous voyez dans une session interactive et dans une session non-interactive, lisez The response above may be incomplete. Avant v2.1.199, Claude Code rejetait la sortie partielle et signalait le tour entier comme une erreur lorsqu'une erreur serveur arrivait au milieu du flux.
• Une défaillance qui arrive après que Claude a terminé la réponse : rien n'a besoin d'être réessayé, donc Claude Code conserve la réponse complète et termine le tour normalement.
• Une réponse en streaming Amazon Bedrock avec un type de contenu inattendu, parce que la passerelle ou le proxy réécrivant la réponse réécrirait la nouvelle tentative de la même manière. Nécessite Claude Code v2.1.208 ou ultérieur.
• Une nouvelle tentative sans streaming d'une requête en streaming défaillante qui obtient un statut de succès mais aucun message API Claude dans le corps. Claude Code termine le tour avec cette erreur.
• Une requête que la vérification de politique de votre organisation a refusée, qui apparaît comme une ligne API Error: portant le message de refus. Les administrateurs de votre organisation configurent la vérification avec Inference hooks, une fonctionnalité Claude Enterprise, et le message se termine par les instructions qu'ils ont configurées, ou par défaut vous dit de les contacter. Claude Code ne renvoie pas la requête refusée au même modèle ou à un modèle de secours, parce que le refus concerne le contenu de la requête plutôt que le modèle. Avant v2.1.239, Claude Code pouvait renvoyer une requête refusée, sans streaming ou sur un modèle de secours configuré, avant de vous afficher le refus.

Ce que vous voyez pendant que Claude Code réessaie ou attend

Pendant les nouvelles 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 dès 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. À partir de v2.1.198, elle bascule vers la raison spécifique à partir 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.

À partir de v2.1.198, le conseil du spinner habituel est supprimé pendant les nouvelles tentatives. Une fois que la raison de l'erreur est révélée, si la défaillance est une surcharge 529, la ligne en dessous du 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.

Si aucune donnée n'arrive sur le flux de réponse pendant 20 secondes tandis qu'une requête est toujours en attente, le spinner affiche Waiting for API response · will retry in … · check your network avant que toute nouvelle 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. Après l'abandon, ce que vous voyez dépend de la distance parcourue par la réponse :

• Avant que Claude n'ait complété un bloc de texte ou un appel d'outil, ou en ait commencé un après avoir terminé sa réflexion, Claude Code réessaie la requête ou termine le tour avec une erreur. Automatic retries dit quels blocages il réessaie et combien de fois.
• Après que Claude a complété un bloc de texte ou un appel d'outil, ou en a commencé un après avoir terminé sa réflexion, mais avant que Claude n'ait terminé la réponse, Claude Code conserve ce que Claude a complété, continue le tour à partir de tous les appels d'outils que Claude a terminés, et affiche The response above may be incomplete. Dans une session non-interactive, et pour la réponse d'un sous-agent dans toute session, Claude Code peut d'abord demander à Claude de continuer la réponse ; cette entrée dit quand il le fait et quand vous voyez toujours l'avis là.
• Après que Claude a terminé la réponse, Claude Code termine le tour normalement.

La bannière s'efface d'elle-même une fois que les données reprennent ou qu'une nouvelle tentative réussit. Si elle réapparaît à chaque tentative, traitez-la comme un problème réseau. Avant v2.1.185, la bannière apparaissait après 10 secondes avec un libellé différent.

Pendant que Claude consulte le conseiller, la bannière apparaît après 90 secondes sans données au lieu de 20, parce qu'un long examen du conseiller peut ne rien envoyer pendant bien plus de 20 secondes. Avant v2.1.214, le seuil de 20 secondes s'appliquait également pendant les appels du conseiller, donc la bannière apparaissait pendant les examens du conseiller même lorsque rien n'allait mal.

Ajuster le comportement des nouvelles tentatives

Vous pouvez ajuster le comportement des nouvelles tentatives avec ces variables d'environnement :

Erreurs serveur

La plupart de ces erreurs proviennent du fournisseur d'inférence : le service Anthropic sur l'API Anthropic, et le service derrière l'endpoint de ce fournisseur sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, ou une passerelle personnalisée. Le mode auto ne peut pas déterminer la sécurité d'une action et L'agent s'est arrêté prématurément en raison d'une erreur API couvrent également les causes de votre côté, comme un compte Amazon Bedrock qui ne peut pas invoquer le modèle du classifieur ou un sous-agent qui a atteint une limite d'utilisation.

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 nomment l'état du service de ce fournisseur. Une ANTHROPIC_BASE_URL personnalisée nomme l'hôte de la passerelle.

Une 5xx de l'API elle-même 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.

Quand un proxy, un équilibreur de charge ou une passerelle répond avec une page d'erreur HTML, le message affiche le code d'état et le titre de la page, comme API Error: 502 Bad Gateway. Pour une page sans titre, le message affiche le code d'état et son nom standard à la place. Avant v2.1.281, le code d'état était supprimé quand la page avait un titre, et le balisage brut de la page était imprimé quand elle n'en avait pas.

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 again au lieu de coller le tout.
• Si l'erreur persiste sans incident signalé, exécutez /feedback pour qu'Anthropic puisse enquêter avec les détails de votre demande. Voir Signaler une erreur si /feedback n'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 /model et 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 exemple Opus is experiencing high load, please use /model to switch to Sonnet. Sur les modèles Fable, le message nomme Fable.

  Dans une session que l'application Claude Desktop exécute, comme l'onglet Code ou Cowork, le message se lit Opus is experiencing high load. Switch to Sonnet. et vous basculez les modèles avec le sélecteur de modèle de l'application.

Délai d'attente de la demande dépassé

L'API n'a pas répondu avant la date 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
• Si une connexion réseau lente ou un proxy en est la cause, augmentez API_TIMEOUT_MS comme décrit dans Tentatives automatiques
• Si les délais d'attente sont fréquents et votre réseau est par ailleurs sain, voir Erreurs réseau et de connexion ci-dessous

Aucune réponse de l'API

Claude Code a envoyé une demande de streaming et l'API n'a retourné aucun en-tête de réponse avant la date limite du premier octet, donc Claude Code a annulé la demande au lieu d'attendre le délai d'attente de demande API_TIMEOUT_MS complet, 10 minutes par défaut. Claude Code renvoie la demande au maximum une fois, si le budget de tentatives le permet. Quand la tentative de réessai reste sans réponse, le tour se termine par ce message, qui montre combien de temps chaque tentative a attendu. Quand vous définissez CLAUDE_CODE_RETRY_WATCHDOG, le plafond d'une tentative ne s'applique pas et Claude Code réessaie selon le budget décrit dans Ajuster le comportement de tentative.

API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.

Claude Code définit le délai d'attente des en-têtes de réponse de la première tentative et le délai d'attente de la tentative de réessai séparément :

• Première tentative : CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS quand vous le définissez à 1 ou plus, limité entre 10 secondes et 30 minutes. Sinon, Claude Code utilise le délai d'attente du watchdog au niveau des octets listé dans Watchdogs d'inactivité de streaming, donc les variables qui changent ce délai d'attente changent aussi cette attente. De toute façon, Claude Code ajoute une seconde pour chaque 32 Ko de corps de demande.
• Tentative de réessai : une seconde de moins que API_TIMEOUT_MS, juste sous 10 minutes par défaut, afin que la tentative de réessai puisse dépasser un proxy ou une passerelle qui retient la réponse jusqu'à ce que la génération soit terminée. Sur Amazon Bedrock, la tentative de réessai utilise la même date limite que la première tentative, et le message affiche une durée au lieu de deux.

Aucune attente ne dépasse une seconde de moins qu'un API_TIMEOUT_MS positif, et un API_TIMEOUT_MS positif inférieur à 11 secondes désactive la date limite. Le watchdog au niveau des octets ne démarre qu'une fois les en-têtes de réponse arrivés, donc une réponse qui arrête d'envoyer des octets après cela suit les règles de flux interrompu au lieu de cette date limite.

Que faire :

• Renvoyez votre message. Votre message original est toujours dans la conversation, donc pour un long prompt vous pouvez taper try again au lieu de coller le tout.
• Si cela se répète, traitez-le comme un problème réseau ou proxy.
• Si une passerelle ou un proxy sur votre réseau retient les réponses jusqu'à ce qu'elles soient terminées, augmentez API_TIMEOUT_MS afin que la tentative de réessai attende plus longtemps. Sur Amazon Bedrock, augmentez également CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS.
• Si la première tentative continue à expirer et que la tentative de réessai réussit ensuite, augmentez CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS afin que la première tentative attende assez longtemps aussi.

Avant v2.1.242, Claude Code attendait le délai d'attente de demande API_TIMEOUT_MS complet, 10 minutes par défaut, avant d'échouer une demande de streaming sans réponse. Avant v2.1.261, la tentative de réessai attendait la même date limite que la première tentative et le message n'affichait aucune durée.

La réponse ci-dessus peut être incomplète

Une demande de streaming a échoué alors que la réponse était toujours en cours, après que Claude ait terminé un bloc de texte ou un appel d'outil, ou en ait commencé un après avoir terminé sa réflexion. Le renvoi de la demande pourrait exécuter les mêmes appels d'outil deux fois, donc Claude Code conserve la sortie que Claude a terminée et ajoute cet avis au lieu de rejeter le tour. La variante que vous voyez nomme la cause :

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.
API Error: Part of the response never arrived. The response above may be incomplete.
API Error: The response stream was malformed. The response above may be incomplete.

• 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 lost mid-response : la connexion a été interrompue. Vous voyez également cette variante quand un proxy ou une passerelle termine le corps de la réponse proprement avant que la réponse soit terminée.
• Your computer went to sleep mid-response : Claude Code a détecté que votre ordinateur s'est endormi pendant que la réponse était en streaming. Une fois que votre ordinateur se réveille, Claude Code traite la connexion comme cassée et arrête de la lire.
• Part of the response never arrived : un événement de flux a été supprimé entre l'API et Claude Code, donc un événement ultérieur référençait du contenu qui n'est jamais arrivé. Avant v2.1.281, ce cas terminait le tour avec API Error: Content block not found.
• The response stream was malformed : un événement est arrivé pour un bloc de contenu qui avait déjà terminé, ou un événement est arrivé endommagé. Un événement endommagé est un événement dont les données ne sont pas du JSON valide, dont le contenu est manquant, ou dont le contenu ne correspond pas au type d'événement. Avant v2.1.284, l'erreur brute du parseur, comme une commençant par API Error: JSON Parse error, apparaissait à la place quand un événement avec du JSON invalide arrivait après que Claude ait terminé sa réflexion, un bloc de texte ou un appel d'outil.
• The response stopped arriving : la connexion est restée ouverte mais a arrêté de livrer des données, donc le watchdog d'inactivité de streaming l'a annulée. Avant v2.1.222, Claude Code pouvait également signaler cet échec sur les connexions de passerelle atteintes via ANTHROPIC_BASE_URL ou ANTHROPIC_AWS_BASE_URL tandis que les pings de maintien de connexion du serveur arrivaient toujours, car il ne comptait que les événements de réponse analysés là ; la mise à niveau arrête ces faux positifs sur ces routes. Les passerelles atteintes via une URL de base de fournisseur telle que ANTHROPIC_BEDROCK_BASE_URL ne sont pas enveloppées par le watchdog d'octet ; voir Watchdogs d'inactivité de streaming.

Avant v2.1.227, Connection lost mid-response lisait Connection closed mid-response et The response stopped arriving lisait Response stalled mid-stream.

Quand un événement de flux supprimé, dupliqué ou endommagé arrive avant que Claude ait commencé du texte ou un appel d'outil, vous ne voyez pas cet avis :

• Si Claude avait terminé seulement sa réflexion, Claude Code réédite la demande. Quand les flux réédités se cassent de la même manière, le tour se termine avec Part of the response never arrived and no response was produced. Try again. ou The response stream was malformed and no response was produced. Try again.
• Si rien n'avait terminé, Claude Code renvoie la demande sans streaming à la place. Si vous avez désactivé ce repli avec CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK, le tour se termine avec API Error: Content block not found pour un événement supprimé ou API Error: Content block already closed pour un événement dupliqué. Pour un événement endommagé avec le repli désactivé, le tour se termine avec API Error: Stream event unreadable ou l'erreur brute du parseur.

Dans quatre cas, Claude Code gère l'échec sans afficher cet avis immédiatement :

• Plus tôt dans la réponse, Claude Code réessaie l'échec ou termine le tour avec une erreur différente. Voir Tentatives automatiques.
• Quand l'un de ces échecs arrive après que Claude ait terminé la réponse, Claude Code conserve la réponse complète et termine le tour normalement, sans cet avis. Avant v2.1.222, Claude Code affichait cet avis quand la connexion était interrompue ou bloquée après la fin de la réponse, et signalait le tour comme une erreur même si la réponse était complète.
• Dans une session non interactive, comme une exécution -p, une exécution Agent SDK, ou une session cloud, vous n'avez pas à envoyer continue vous-même quand la réponse coupée est dans la conversation principale et contient du texte mais pas d'appels d'outil : Claude Code conserve la sortie partielle et invite Claude à continuer à partir d'où il s'est arrêté, jusqu'à trois fois de suite. Vous voyez cet avis pour une telle réponse seulement une fois que Claude Code a épuisé ces continuations. Avant v2.1.246, Claude Code terminait un tour non interactif avec cet avis à la première coupure.
• Dans un sous-agent, que la session soit interactive ou non : quand sa réponse coupée contient du texte mais pas d'appels d'outil, Claude Code invite le sous-agent à continuer. L'avis devient le dernier message du sous-agent seulement une fois que ces continuations sont épuisées. Avant v2.1.257, un sous-agent affichait cet avis à la première coupure.

Que faire :

• Dans une session interactive, lisez la réponse qui reste à l'écran : Claude Code conserve chaque bloc que Claude a terminé avant l'erreur, mais rejette un bloc final interrompu quand le tour se termine, donc les dernières phrases ou appels d'outil peuvent manquer. Répondez avec continue pour que Claude reprenne à partir de son dernier bloc terminé.
• En mode non interactif (-p) :
  • Avec la sortie texte par défaut, Claude Code imprime le dernier bloc de texte terminé qu'il détient toujours du début du tour, suivi de ce message. Quand il n'en détient aucun, Claude Code imprime ce message seul, par exemple parce que Claude Code a compacté la conversation en milieu de tour et a effacé ce texte. Avant v2.1.219, Claude Code n'imprimait que ce message dans la sortie texte -p et rejetait la réponse qu'il avait déjà produite.
  • Avec --output-format json ou stream-json, Claude Code signale ce message dans le champ result.
  • Pour continuer le tour une fois la connexion stable, reprenez la session et envoyez continue comme décrit dans Continuer les conversations.

Le mode auto ne peut pas déterminer la sécurité d'une action

Le modèle que le mode auto utilise pour classifier 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 façon dont le classificateur a échoué.

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 du classificateur est indisponible :

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

Quand Claude Code peut déterminer la catégorie d'échec, il nomme la catégorie entre parenthèses après temporarily unavailable, par exemple <model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now. Les catégories sont (rate-limited), (overloaded), (server error), (timed out), et (connection failed). Si (timed out) ou (connection failed) se répète, vérifiez votre connexion ; voir Impossible de se connecter à l'API. Avant v2.1.229, le message ne nommait jamais une catégorie et lisait Wait briefly and then try this action again.

Quand aucune catégorie ne convient, le message apparaît sans catégorie entre parenthèses ; plus d'un échec produit cette forme. Sur Amazon Bedrock, y compris l'endpoint Mantle, il apparaît également quand votre compte AWS ne peut pas invoquer le modèle nommé dans le message, et cet échec se répète à chaque tentative jusqu'à ce que votre compte soit autorisé à accéder au modèle.

Que faire :

• Réessayez après quelques secondes ; Claude voit le même message et réessaie généralement de lui-même. Un échec transitoire n'est pas lié à l'admissibilité du mode auto ; vous n'avez pas besoin de modifier les paramètres
• Si les tentatives continuent à échouer, continuez avec les tâches en lecture seule et revenez à l'action bloquée plus tard
• Sur Amazon Bedrock, si le message revient à chaque tentative, vérifiez que votre compte peut invoquer le modèle qu'il nomme : pour les modèles Amazon Bedrock standard, confirmez que votre politique IAM permet de l'invoquer ; pour les ID de modèle Mantle, contactez votre équipe de compte AWS

Quand une demande de classificateur échoue parce que votre jeton OAuth a expiré ou a été pivoté par une autre session, Claude Code actualise le jeton et réessaie la demande une fois, donc une expiration de jeton courante ne fait pas surface comme ce message. Avant v2.1.216, un jeton expiré ou pivoté échouait à chaque demande de classificateur, et le mode auto refusait chaque action vérifiée avec ce message jusqu'à ce que le jeton soit actualisé.

Quand le classificateur a retourné 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 --debug et répétez l'action pour les détails 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

Claude Code refuse l'action mais dit à Claude que ce n'est pas un jugement que l'action est dangereuse, et de continuer avec d'autres tâches plutôt que de réessayer. Ces refus ne comptent pas vers les seuils de pause du mode auto. Dans une exécution -p non interactive, Claude Code n'arrête pas l'exécution. Ce que Claude reçoit dépend de l'endroit où il a demandé l'action :

• À un sous-agent en arrière-plan dans une exécution -p sans --input-format stream-json, Claude Code retourne un résultat d'erreur contenant Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode
• Partout ailleurs, y compris les sessions interactives et la conversation principale d'une exécution -p, Claude Code retourne ce refus à Claude

Avant v2.1.225, Claude Code comptait ces refus vers les seuils de pause et retournait le même message de rejet qu'un bloc de classificateur authentique.

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
• Réessayer ne servira à rien ; le même contenu de conversation déclenchera le filtre à nouveau
• Dans une session interactive, basculez vers un mode de permission différent afin de pouvoir approuver l'action quand vous y êtes invité
• Commencez une nouvelle conversation sans le contenu déclencheur

Quand la conversation a grandi plus que 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)

Ce qui se passe à l'action dépend de l'endroit où Claude l'a demandée :

• Dans une session interactive, le mode auto bascule sur une demande de permission normale pour cette action afin que vous puissiez l'approuver ou la refuser manuellement
• À un sous-agent en arrière-plan dans une exécution -p non interactive sans --input-format stream-json, Claude Code retourne un résultat d'erreur contenant Agent aborted: auto mode classifier transcript exceeded context window in headless mode, et l'exécution continue
• Ailleurs dans une exécution -p sans --permission-prompt-tool, il n'y a pas de demande de permission sur laquelle se rabattre, donc l'action ne s'exécute pas et l'exécution continue

Que faire :

• Dans une session interactive, approuvez ou refusez l'action dans la demande qui apparaît
• Dans une session interactive, exécutez /compact pour réduire la taille de la conversation afin que les actions suivantes s'adaptent à nouveau à la fenêtre du classificateur

Le serveur n'a retourné aucun verdict de sécurité

Sous examen du classificateur côté serveur, le mode auto refuse une action quand le serveur ne donne aucun verdict pour elle. Le refus nomme une catégorie entre parenthèses quand Claude Code peut en déterminer une, comme (timed out) :

The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.

Le reste du message dit à Claude si une tentative peut aider. Avant certains de ces refus, Claude Code attend afin que la tentative suivante de Claude ne suive pas immédiatement. Pendant l'attente dans une session interactive, le spinner affiche Auto mode check unavailable avec un compte à rebours, et appuyer sur Esc interrompt le tour.

Après dix réponses de suite sans verdict, le mode auto arrête le tour :

Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

Le message d'arrêt apparaît à un endroit différent dans chaque type de session :

• Dans une session interactive, le message apparaît comme un avertissement dans la transcription et le tour se termine
• Dans une exécution -p non interactive, l'exécution se termine et signale une erreur d'exécution. Avec la sortie texte par défaut, le message s'imprime sur stderr.
• Quand un sous-agent a atteint la limite, le sous-agent s'arrête avant de terminer, et Claude reçoit ce qu'il a produit avec une note que le mode auto l'a arrêté

Que faire :

• Envoyez un autre message pour que Claude réessaie. Le compte de réponses recommence.
• Si l'arrêt se répète et que vos demandes passent par une passerelle LLM ou un proxy, vérifiez s'il coupe les réponses de streaming ou les réécrit. L'examen du classificateur côté serveur indique quel comportement de passerelle cause les refus, et le guide de compatibilité de passerelle liste ce qu'il faut transmettre inchangé.
• Définissez CLAUDE_CODE_AUTO_MODE_SERVER=0 avant de démarrer Claude Code pour utiliser ses propres demandes de classificateur à la place. Avant v2.1.281, Claude Code ne lisait pas la variable sur une connexion directe à l'API Anthropic.
• Pour approuver les actions vous-même à la place, basculez hors du mode auto

Avant v2.1.280, Claude Code refusait chaque action d'une réponse sans verdict immédiatement et n'arrêtait jamais le tour.

L'agent s'est arrêté prématurément en raison d'une erreur API

Une 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 retourné à 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 d'erreur après les deux points à sa propre section sur cette page, comme Limites d'utilisation ou Erreurs serveur, 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 texte, Claude reçoit cette sortie partielle marquée comme incomplète au lieu de cette erreur. Un sous-agent dont la seule sortie était des appels d'outil reçoit également cette erreur ; dans v2.1.199 cette forme retournait un résultat partiel vide à la place. Voir Erreurs API dans les sous-agents.

Limites d'utilisation

La plupart des erreurs de cette section signifient qu'un quota lié à votre compte ou à votre plan a été atteint. Trois fonctionnent différemment : Server is temporarily limiting requests est un throttle côté serveur sans rapport avec votre quota de plan, Usage credits required for 1M context est une vérification de droit plutôt qu'un quota épuisé, et The prompt to confirm went unanswered signifie qu'une invite de consentement pour les crédits d'utilisation s'est fermée sans réponse, que le quota ait été atteint ou non.

You've hit your session limit

Les plans d'abonnement incluent une allocation d'utilisation continue. 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
You've hit your Sonnet limit · resets 3:45pm

Claude Code bloque les demandes supplémentaires jusqu'à l'heure de réinitialisation indiquée dans le message. Les limites de session et hebdomadaires sont partagées entre tous les modèles, donc changer de modèle ne restaure pas l'accès. Les limites Opus et Sonnet s'appliquent chacune uniquement aux demandes adressées à cette famille de modèles, donc passer à un modèle en dehors de la famille avec /model vous permet de continuer à travailler.

Dans une session interactive connectée avec un abonnement claude.ai, Claude Code peut également attendre dans la session ouverte et continuer la tâche interrompue peu après la réinitialisation. Consultez Wait for a usage limit to reset pour voir ce que vous voyez, comment démarrer ou annuler une attente, et comment désactiver la continuation automatique. Avant la v2.1.234, Claude Code n'offrait pas cette attente.

L'utilisation compte à la fois pour les allocations de session et hebdomadaires. Une seule rafale d'activité intensive, comme un grand fanout de flux de travail, peut épuiser l'allocation hebdomadaire avant que la fenêtre de session ne se réinitialise.

Ce qu'il faut faire :

• Attendez l'heure de réinitialisation indiquée dans l'erreur
• Dans l'onglet Code de l'application de bureau, la carte de limite de session offre une case à cocher Auto-continue when limits reset. La carte de limite hebdomadaire ne l'offre pas. Quand elle est cochée, l'application de bureau réessaie le tour interrompu après la réinitialisation et affiche l'heure de nouvelle tentative sur la carte. La case à cocher de l'application de bureau et le paramètre Continue automatically at usage limit de la CLI dans /config sont séparés, donc désactivez chacun indépendamment.
• Pour la limite Opus ou Sonnet, exécutez /model et basculez vers un modèle en dehors de cette famille pour continuer à travailler. Chaque modèle a son propre cache de prompt, donc la demande suivante relit toute la conversation sans accès au cache ; consultez Switching models
• Exécutez /usage pour voir vos limites de plan et quand elles se réinitialisent
• Exécutez /usage-credits pour 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 pour des limites de base plus élevées, consultez claude.com/pricing

Avant qu'une fenêtre ne s'épuise, Claude Code peut vous avertir que vous avez utilisé la plupart de celle-ci, avec un message tel que You've used 85% of your session limit · resets 3:45pm. Pour surveiller votre allocation restante en continu, ajoutez les champs rate_limits à une ligne d'état personnalisée, ou dans l'application de bureau, cliquez sur l'anneau d'utilisation à côté du sélecteur de modèle.

Usage credits required for 1M context

Le modèle sélectionné utilise la fenêtre de contexte étendue de 1M tokens, et votre plan ne l'inclut que via les crédits d'utilisation.

API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

Dans une session que l'application Claude Desktop exécute, l'indice ne nomme aucune commande : il pointe vers la page des paramètres d'utilisation de claude.ai, ou sur les plans Team et Enterprise indique d'activer les crédits d'utilisation à claude.ai/admin-settings/usage ou de demander à votre administrateur.

C'est une vérification de droit, pas 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 le contexte 1M directement et lesquels nécessitent des crédits d'utilisation.

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 suivante, 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].

Ce qu'il faut faire :

• Exécutez /model et sélectionnez la variante sans le suffixe [1m] pour revenir à la fenêtre de contexte standard
• Où le message nomme /usage-credits, exécutez-le pour activer la facturation à l'usage pour la variante 1M sur Pro et Max, ou pour demander des crédits d'utilisation à votre administrateur sur Team et Enterprise. Une fois que les crédits d'utilisation sont activés, redémarrez Claude Code ou démarrez une nouvelle session, selon ce que le message indique. Jusqu'à ce moment, la session reste à la limite de contexte standard.
• Si l'erreur persiste après /model, un ID de modèle 1M peut être défini ailleurs. Consultez Setting your model pour les emplacements de configuration à vérifier par ordre de priorité.
• Pour supprimer complètement les variantes 1M du sélecteur de modèle, définissez CLAUDE_CODE_DISABLE_1M_CONTEXT=1

Avant v2.1.268, le message se terminait par run /usage-credits to turn them on, or /model to switch to standard context et ne mentionnait pas le redémarrage.

The prompt to confirm went unanswered

Si votre compte nécessite le consentement des crédits d'utilisation Fable, Claude Code vous demande de confirmer avant qu'une demande Fable ne facture les crédits d'utilisation. Quand l'invite de consentement se ferme sans que personne ne la réponde, Claude Code termine le tour avec l'un de ces messages :

Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

Les messages nomment le modèle Fable de la session, donc sur Fable 5, ils lisent continuing on Fable 5 et Fable 5 now uses usage credits. Avant v2.1.257, le premier message commençait par Fable 5 limit reached.

Cela se produit dans les sessions Remote Control, les sessions en arrière-plan, les sessions de coéquipiers agent team, et les sessions qu'une autre application héberge via l'Agent SDK. Pour savoir quand Claude Code ferme l'invite, consultez Fable and usage credits.

Ce qu'il faut faire :

• Où la session s'exécute, au terminal ou dans l'application qui l'héberge, envoyez une autre invite et répondez à l'invite de consentement quand elle réapparaît. Pour une session en arrière-plan, attachez-vous d'abord à partir de la vue des agents. Renvoyer depuis un client Remote Control affiche ce message à nouveau, car le client ne peut pas afficher l'invite.
• Exécutez /model pour basculer vers un modèle qui ne facture pas les crédits d'utilisation
• Pour vous donner plus de temps, définissez dialogExpiry sur une valeur plus longue ou "never"

Avant v2.1.236, ce message n'apparaissait pas : pendant qu'un client Remote Control était connecté, Claude Code attendait 60 secondes une réponse, puis continuait le tour sur votre modèle par défaut.

Server is temporarily limiting requests

L'API a appliqué un throttle de courte durée sans rapport avec 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. À 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 échouait le tour à la première occurrence ; seules les connexions par clé API et Enterprise le réessayaient.

Ce qu'il faut faire :

• Attendez brièvement et réessayez
• Vérifiez status.claude.com si cela persiste

Request rejected (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 finale nomme 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 le statut du service de ce fournisseur au lieu de la page de statut Anthropic. Un ANTHROPIC_BASE_URL personnalisé nomme l'hôte de la passerelle.

Quand un proxy, un équilibreur de charge ou une passerelle entre Claude Code et l'API répond avec sa propre page HTML 429, le texte après le · est le titre de cette page quand elle en a un, comme Too Many Requests. Avant v2.1.281, l'ensemble du balisage de la page était imprimé après le ·.

Ce qu'il faut faire :

• Exécutez /status et confirmez que les identifiants actifs sont ceux que vous attendez. Un ANTHROPIC_API_KEY égaré 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 basculez vers un modèle plus petit avec /model pour les exécutions scriptées à haut volume

You've hit your monthly spend limit

L'utilisation incluse de votre plan ne peut pas couvrir cette demande, et les crédits d'utilisation qui paieraient autrement pour cela ont atteint une limite de dépenses. Cela se produit quand l'une des fenêtres d'utilisation de votre plan s'est épuisée, ou quand la demande est une demande que seuls les crédits d'utilisation paient, comme une demande à un modèle qui facture aux crédits d'utilisation. Le message nomme la limite qui vous a bloqué. Le texte après le · indique comment augmenter cette limite, et varie selon votre plan et si vous gérez la facturation :

You've hit your monthly spend limit · raise it at claude.ai/settings/usage
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit claude.ai/admin-settings/usage to raise it
You've hit your team's shared budget · ask your admin to raise it at claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

team's shared budget est un budget groupé qu'un administrateur a attribué à un groupe auquel vous appartenez ; le message ne nomme pas le groupe. channel's monthly spend limit est le budget du seul canal Slack dans lequel la session s'exécute, donc votre organisation peut toujours avoir un budget en dehors de celui-ci.

Quand l'une des fenêtres de votre plan est ce qui s'est épuisé, le message indique également quand cette fenêtre se réinitialise, par exemple · your session limit resets 3:45pm, et l'accès revient alors sans que personne n'augmente la limite. Sur les organisations avec facturation basée sur l'utilisation, le message dit usage limit à la place de spend limit, comme dans You've hit your individual usage limit.

Avant v2.1.239, le message ne nommait pas l'heure de réinitialisation de la fenêtre du plan. Avant v2.1.268, le budget groupé d'un groupe produisait le message individual spend limit au lieu de team's shared budget.

Si vous vous connectez via une passerelle d'applications Claude et voyez spend limit reached en minuscules, c'est le plafond de votre opérateur de passerelle ; consultez Spend limit reached.

Ce qu'il faut faire :

• Sur Pro et Max, augmentez votre limite de dépenses mensuelles dans Settings > Usage sur claude.ai, ou exécutez /usage-credits
• Sur Team et Enterprise, augmentez la limite dans Admin settings > Usage si vous gérez la facturation, ou demandez à un administrateur de le faire. /usage-credits envoie cette demande à votre administrateur pour vous
• Pour la limite d'un canal, demandez à un propriétaire d'organisation ou au gestionnaire du canal de l'augmenter sur claude.ai. Consultez Per-channel limits dans la documentation Claude Tag
• Si le message nomme une heure de réinitialisation pour la fenêtre de votre plan, vous pouvez l'attendre à la place
• Exécutez /usage pour voir les fenêtres de votre plan et quand chacune se réinitialise

Spend limit reached

Vous vous connectez via une passerelle d'applications Claude et avez dépassé un plafond de dépenses que votre opérateur de passerelle a défini. La passerelle bloque vos demandes jusqu'à ce que la période nommée se réinitialise ou que l'opérateur augmente le plafond. Elle marque chaque réponse 429 bloquée x-should-retry: false, donc Claude Code affiche ce message sans réessayer.

spend limit reached (daily; resets 2026-08-09 00:00 UTC)

Le message nomme la période du plafond et l'heure de réinitialisation, et quand l'opérateur a configuré un blocked_message, ses instructions le suivent. Avant v2.1.225, le message lisait seulement spend limit reached ; une passerelle sur une version plus ancienne envoie toujours cette forme plus courte.

Ce qu'il faut faire :

• Attendez l'heure de réinitialisation que le message nomme, ou suivez les instructions de l'opérateur si le message les porte
• Demandez à votre opérateur de passerelle d'augmenter le plafond si vous le dépassez régulièrement

Un message connexe, spend limit unavailable, signifie que la passerelle n'a pas pu lire ses enregistrements de dépenses et a bloqué la demande par précaution plutôt que sur votre plafond. Cela s'efface généralement de lui-même ; si cela persiste, informez votre opérateur de passerelle.

Credit balance is too low

Votre organisation Console a épuisé ses crédits prépayés, ou Claude Code envoie vos demandes avec une clé API Console quand vous aviez l'intention d'utiliser votre abonnement.

Credit balance is too low

Ce qu'il faut faire :

• Si vous avez un plan Pro, Max, Team ou Enterprise et voyez ceci, exécutez /status et vérifiez la ligne API key. Un ANTHROPIC_API_KEY approuvé dans votre environnement achemine les demandes via cette clé au lieu de votre abonnement. Désactivez-le dans le shell actuel et supprimez-le de votre profil de shell, puis relancez claude. Exécutez /login si vous ne vous êtes pas encore connecté avec votre abonnement.
• Ajoutez des crédits à platform.claude.com/settings/billing, et envisagez d'activer le rechargement automatique là-bas pour que le solde se remplisse avant d'atteindre zéro
• 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.

Could not update your spend limit

Le serveur a rejeté un changement de limite de dépenses que vous avez effectué à partir de l'invite qui apparaît quand vous atteignez votre limite de dépenses.

Could not update your spend limit: <reason from the server>

Quand le serveur explique le rejet, le message se termine par cette raison, et réessayer la même valeur échoue à nouveau. Quand l'échec n'a pas de raison fournie par le serveur, comme une connexion interrompue, le message lit Could not update your spend limit. Press Enter to retry. et réessayer peut réussir. Avant v2.1.216, Claude Code affichait la forme générique pour chaque échec.

Ce qu'il faut faire :

• Si le message inclut une raison, choisissez une limite qui la satisfait, comme un montant inférieur
• Si le message affiche uniquement la forme générique, réessayez ; l'échec peut être transitoire
• Si le changement continue d'échouer, effectuez-le à partir de vos paramètres de facturation claude.ai dans le navigateur à la place

Erreurs d'authentification

Ces erreurs signifient que Claude Code ne parvient pas à prouver votre identité auprès de l'API. Exécutez /status à tout moment pour voir quels identifiants sont actuellement actifs.

Non connecté

Cette session ne dispose d'aucuns identifiants valides.

Not logged in · Please run /login

Dans une session exécutée par l'application Claude Desktop, comme l'onglet Code ou Cowork, le message indique Authentication required · Sign in again to continue, et vous vous reconnectez depuis l'application.

Si vous vous connectez avec votre compte claude.ai dans une autre fenêtre Claude Code qui utilise le même répertoire de configuration, une session interactive affichant ce message commence à utiliser cette connexion d'elle-même. Vous n'avez pas besoin de la redémarrer.

Avant la v2.1.286 sur macOS, la session pouvait continuer à afficher le message après votre connexion depuis une autre fenêtre. Sur ces versions, redémarrez la session qui affiche le message.

Que faire :

• Exécutez /login pour vous authentifier avec votre abonnement Claude ou votre compte Console
• Si vous vous attendiez à ce qu'une variable d'environnement vous authentifie, vérifiez que ANTHROPIC_API_KEY est définie et exportée dans le shell où vous avez lancé claude
• Pour la CI ou l'automatisation où la connexion interactive n'est pas possible, configurez un script apiKeyHelper qui récupère une clé au démarrage
• Consultez Priorité d'authentification pour comprendre quels identifiants Claude Code utilise lorsque plusieurs sont présents

Si vous êtes invité à vous connecter à plusieurs reprises, consultez Non connecté ou jeton expiré pour les vérifications de l'horloge système et les étapes de récupération du stockage des identifiants sur macOS.

Impossible de déterminer la méthode d'authentification

La session a atteint le client API sans aucuns identifiants. Les sessions en arrière-plan et les sessions cloud affichent ce message lorsque le worker démarre sans identifiants. Les exécutions interactives, -p et Agent SDK signalent la même condition sous la forme Non connecté et n'écrivent cette chaîne que dans leur log de débogage ; si vous l'y avez trouvée, suivez donc plutôt cette entrée.

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

Sur les versions actuelles, l'erreur signifie qu'aucuns identifiants n'étaient disponibles pour le processus worker. Avant la v2.1.174, une session en arrière-plan attribuée à un worker pré-initialisé inactif pouvait échouer de cette manière même lorsque des identifiants valides étaient configurés. Avant la v2.1.176, une session cloud restée inactive avant d'être prise en charge le pouvait aussi. Mettez à jour pour corriger le problème.

Que faire :

• Passez à la v2.1.176 ou ultérieure si ce message apparaît dans une session en arrière-plan ou cloud et que vos identifiants sont déjà configurés
• Vérifiez que ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN ou les identifiants de votre fournisseur cloud sont définis dans l'environnement qui lance le worker, et pas seulement dans votre shell interactif
• Pour l'Agent SDK, consultez la configuration de l'authentification dans le démarrage rapide
• Exécutez /status dans une session interactive du même environnement pour confirmer quelle source d'identifiants est résolue

Clé API non valide

La variable d'environnement ANTHROPIC_API_KEY ou le script apiKeyHelper a renvoyé une clé que l'API a rejetée, ou Claude Code a bloqué une clé provenant de ANTHROPIC_API_KEY avant de l'envoyer.

Invalid API key · Fix external API key

Lorsque le message se poursuit après Fix external API key avec une description telle que Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines)., l'API n'a jamais vu la clé. Claude Code a trouvé un caractère que les en-têtes HTTP ne peuvent pas transporter et a arrêté la requête avant de l'envoyer. Consultez Valeur d'en-tête de requête non valide pour savoir comment lire la description et corriger la valeur.

Que faire :

• Vérifiez l'absence de fautes de frappe et confirmez que la clé n'a pas été révoquée dans la Console
• Dans le même shell, exécutez env | grep ANTHROPIC, ou dans PowerShell Get-ChildItem Env:ANTHROPIC*. Des outils comme direnv, les plugins shell dotenv et les terminaux d'IDE peuvent charger une clé obsolète depuis un fichier .env de votre projet sans que vous l'ayez définie explicitement.
• Supprimez ANTHROPIC_API_KEY et exécutez /login pour utiliser plutôt l'authentification par abonnement
• Si la clé provient d'un script apiKeyHelper, exécutez le script directement pour confirmer qu'il affiche une clé valide sur stdout
• Exécutez /status pour confirmer quelle source d'identifiants Claude Code utilise réellement

Votre script apiKeyHelper échoue

Claude Code a exécuté la commande de votre paramètre apiKeyHelper et n'a pas récupéré de clé. Sans clé, la requête atteint l'API avec des identifiants factices, et l'API la rejette avec une 401. Le panneau Authentication du terminal indique lequel de ces cas s'est produit :

• La commande s'est terminée avec une erreur ou a expiré
• La commande n'a rien affiché sur stdout
• La commande a affiché autre chose que la clé, comme une bannière de connexion ou une ligne de log. Le panneau affiche returned output that cannot be used as an API key et indique ce qui ne va pas, sans répéter la sortie. Avant la v2.1.227, Claude Code envoyait tout ce que la commande affichait, après suppression des espaces environnants.

Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

En mode non interactif, stderr contient également la raison précise, préfixée par apiKeyHelper failed:.

Claude Code réexécute le script et relance la requête jusqu'à deux fois supplémentaires avant d'afficher ce message, de sorte que l'échec apparaît en trois tentatives au maximum. Avant la v2.1.208, Claude Code épuisait tout le budget de nouvelles tentatives en renvoyant la requête avec les identifiants factices, puis signalait une erreur d'authentification 401 générique au lieu de l'échec du script.

Exécuter /login n'aide pas ici : la sortie du helper a priorité sur une connexion enregistrée tant que le paramètre est présent.

Que faire :

• Exécutez directement dans votre shell la commande configurée dans apiKeyHelper pour reproduire l'échec
• Si la commande signale une session expirée, authentifiez-vous à nouveau auprès de votre fournisseur d'identifiants, par exemple en vous reconnectant à votre SSO ou à votre coffre de secrets
• Corrigez la commande pour qu'elle n'affiche que la clé sur stdout, sous la forme d'un seul token d'ASCII imprimable de 16 384 caractères maximum, et qu'elle se termine avec le code 0. Consultez renouveler les identifiants avec apiKeyHelper pour une configuration fonctionnelle.
• Exécutez /status pour voir l'échec et confirmer que apiKeyHelper est la source d'identifiants active. La ligne apiKeyHelper affiche Failing avec le détail du dernier échec, comme le code de sortie et la sortie d'erreur de la commande, et disparaît après la prochaine exécution réussie. Avant la v2.1.274, /status n'affichait que la source d'identifiants, pas l'échec.
• Chaque fois que la commande échoue, son code de sortie et sa sortie d'erreur apparaissent également dans un panneau Authentication du terminal. Avant la v2.1.212, le panneau s'intitulait Cloud authentication.

Valeur d'en-tête de requête non valide

Une valeur que Claude Code s'apprêtait à envoyer comme en-tête de requête contient un caractère que les en-têtes HTTP ne peuvent pas transporter : un saut de ligne, un octet NUL ou un caractère au-delà de U+00FF, comme un guillemet typographique ou une espace de largeur nulle. Claude Code arrête la requête avant tout envoi et nomme la variable ou le paramètre à corriger. La cause habituelle est un identifiant collé depuis un document ou un chat qui contenait un caractère invisible ou un saut de ligne parasite.

Claude Code effectue cette vérification lorsqu'il envoie des requêtes à l'API Claude directement ou via une passerelle LLM. Sur un fournisseur cloud tiers comme Amazon Bedrock, Claude Code ne l'effectue pas avant l'envoi.

Invalid auth token · Fix external auth token
Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
Invalid request header from the environment · Fix the environment variable

La première partie du message dépend de la provenance de la valeur incorrecte :

• Invalid auth token : un jeton bearer provenant de ANTHROPIC_AUTH_TOKEN ou de CLAUDE_CODE_OAUTH_TOKEN
• Invalid ANTHROPIC_CUSTOM_HEADERS : un nom ou une valeur d'en-tête que vous avez défini dans ANTHROPIC_CUSTOM_HEADERS. La description indique le rang de la paire Name: Value fautive, par exemple distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS, sans répéter le nom ni la valeur, puisque vous avez choisi les deux.
• Invalid request header from the environment : une valeur que Claude Code copie dans un en-tête de requête depuis une autre variable d'environnement, comme CLAUDE_AGENT_SDK_CLIENT_APP. La description nomme la variable à corriger.

Claude Code signale une ANTHROPIC_API_KEY incorrecte détectée par cette vérification sous la forme Clé API non valide, avec la même description finale. Il signale des identifiants /login enregistrés incorrects sous la forme Non connecté ; exécutez /login pour en enregistrer de nouveaux. La sortie d'un script apiKeyHelper n'atteint jamais cette vérification : Claude Code la valide lors de l'exécution du script, et une sortie qu'un en-tête HTTP ne peut pas transporter échoue avec Votre script apiKeyHelper échoue.

Après le second ·, le message décrit le problème, comme dans cet exemple complet :

Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).

Les positions comptent les caractères à partir de un. La description est construite à partir de phrases fixes et de nombres de caractères, elle n'inclut donc jamais la valeur elle-même. Elle nomme le caractère fautif uniquement lorsqu'il s'agit d'un caractère invisible ou typographique bien connu, comme une marque d'ordre des octets, une espace de largeur nulle ou un guillemet typographique, et signale tout autre caractère comme a non-ASCII character.

Que faire :

• Redéfinissez la variable ou le paramètre que nomme le message, en retapant les caractères autour de la position signalée plutôt qu'en collant à nouveau depuis la même source
• Pour ANTHROPIC_CUSTOM_HEADERS, conservez une paire Name: Value par ligne et réécrivez la paire indiquée par le message
• Exécutez /status pour confirmer quelle source d'identifiants est active

Cette organisation a été désactivée

Claude Code utilise une ANTHROPIC_API_KEY obsolète provenant d'une organisation Console désactivée. Lorsque vous disposez d'une connexion par abonnement enregistrée, la clé la remplace.

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.

L'indication après le · dépend de vos identifiants enregistrés : la première forme apparaît lorsqu'une connexion /login enregistrée peut prendre le relais une fois la clé supprimée, et la seconde lorsque la clé est votre seul identifiant.

Les variables d'environnement ont priorité sur /login : une clé exportée dans votre profil de shell ou chargée depuis un fichier .env est donc utilisée même si vous disposez d'un abonnement Pro ou Max fonctionnel. En mode non interactif (-p), la clé est toujours utilisée lorsqu'elle est présente.

Que faire :

• Supprimez ANTHROPIC_API_KEY dans le shell actuel et retirez-la de votre profil de shell, puis relancez claude
• Si le message indique Update or unset, vous n'avez aucune connexion enregistrée sur laquelle vous rabattre. Supprimez la clé et exécutez /login, ou remplacez la clé par une clé provenant d'une organisation Console active.
• Exécutez ensuite /status pour confirmer que les identifiants actifs sont ceux de votre abonnement
• Si aucune variable d'environnement n'est définie et que l'erreur persiste, contactez le support ou connectez-vous avec un autre compte.

Votre organisation a désactivé l'authentification par clé API

Ce message nécessite Claude Code v2.1.169 ou ultérieure. L'administrateur de votre organisation Console a désactivé l'authentification par clé API, l'API rejette donc la clé que Claude Code envoie. L'indication de récupération après le · varie selon la provenance de 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
Your organization has disabled API key authentication · Sign in again with your claude.ai account

La dernière forme apparaît dans une session exécutée par l'application Claude Desktop, comme l'onglet Code ou Cowork, où vous vous reconnectez depuis l'application.

Les variables d'environnement et apiKeyHelper ont priorité sur /login : exécuter /login seul n'aide donc pas tant que l'un d'eux fournit encore une clé. Consultez Priorité d'authentification.

Que faire :

• Si le message nomme ANTHROPIC_API_KEY, supprimez-la dans le shell actuel et retirez-la de votre profil de shell ou de votre fichier .env, puis relancez claude
• Si le message nomme apiKeyHelper, retirez le paramètre apiKeyHelper de votre settings.json
• Exécutez /login pour vous connecter avec votre compte claude.ai
• Exécutez ensuite /status pour confirmer que les identifiants actifs sont ceux de votre abonnement et non une clé API
• Si vous avez besoin de l'authentification par clé API pour l'automatisation, demandez à l'administrateur de votre organisation de la réactiver dans la Console

Votre organisation a désactivé l'accès par abonnement Claude

Votre organisation Claude n'autorise pas la connexion à Claude Code avec une connexion par abonnement. Exécuter à nouveau /login avec le même compte renvoie 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

Il s'agit d'un paramètre d'organisation côté serveur, qui ne peut donc pas être remplacé par des paramètres locaux, des variables d'environnement ou des flags CLI.

L'Agent SDK et le mode non interactif -p le signalent avec le code d'erreur oauth_org_not_allowed.

Que faire :

• Demandez à votre administrateur d'activer l'accès à Claude Code pour votre organisation
• Authentifiez-vous avec une clé API Console plutôt qu'avec votre abonnement. Consultez Authentification Claude Console pour la configuration.
• Si vous êtes l'administrateur et 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 Owner de votre organisation Team ou Enterprise a désactivé les routines au niveau de l'organisation. L'erreur apparaît lorsque vous essayez de créer ou d'exécuter une routine, par exemple depuis l'interface Routines sur claude.ai/code. Sur Claude Code v2.1.227 ou ultérieure, le même paramètre masque également /schedule dans la CLI.

Routines are disabled by your organization's policy.

Il s'agit d'un paramètre côté serveur, qui ne peut donc pas être remplacé par des paramètres locaux, des variables d'environnement ou des flags CLI.

Que faire :

• Demandez à un Owner de votre organisation d'activer le bouton Routines sur claude.ai/admin-settings/claude-code
• Pour une tâche planifiée ponctuelle qui ne nécessite pas de routines au niveau de l'organisation, consultez tâches planifiées

Remote Control nécessite l'API Anthropic

La session ne communique pas directement avec l'API Anthropic, ce que Remote Control exige.

Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.

Une seconde phrase explique ce qui a détourné la session de l'API Anthropic ; avant la v2.1.219, le message se limitait à la première phrase. Selon la cause, le message nomme :

• Une variable de fournisseur CLAUDE_CODE_USE_*, comme CLAUDE_CODE_USE_BEDROCK pour Amazon Bedrock ou CLAUDE_CODE_USE_VERTEX pour Google Cloud's Agent Platform
• ANTHROPIC_BASE_URL pointant vers un hôte autre que api.anthropic.com, comme une passerelle LLM ou un proxy, même lorsque vous vous connectez avec claude.ai ; avant la v2.1.196, une URL de base personnalisée ne bloquait pas Remote Control
• ANTHROPIC_UNIX_SOCKET définie, de sorte que la session envoie ses requêtes via un socket local plutôt qu'à api.anthropic.com
• Une connexion à une passerelle cloud d'entreprise effectuée via /login, qui ne prend pas en charge Remote Control et n'a aucune variable à supprimer

Que faire :

• Supprimez la variable que nomme le message, comme CLAUDE_CODE_USE_BEDROCK ou ANTHROPIC_BASE_URL, et redémarrez la session, ou lancez Remote Control depuis une session qui communique directement avec l'API Anthropic
• Si la variable n'est pas définie dans votre shell, vérifiez la clé env dans vos fichiers de paramètres, qui applique des variables d'environnement à chaque session
• Pour ce message et les autres messages de démarrage de Remote Control, consultez Dépannage de Remote Control

Remote Control n'a pas pu actualiser votre connexion

Claude Code fait fonctionner une connexion Remote Control active avec des identifiants de courte durée qu'il obtient et renouvelle à l'aide de votre connexion claude.ai enregistrée. Lorsque claude.ai cesse d'accepter cette connexion, ou que Claude Code n'a plus de connexion enregistrée, Claude Code arrête Remote Control et vous demande de vous reconnecter. L'un ou l'autre échec peut survenir pendant que Claude Code est encore en train de se connecter ou plus tard, lors du renouvellement des identifiants.

Lorsque Claude Code demande au service de connexion d'actualiser votre connexion enregistrée et n'obtient aucune réponse, il maintient Remote Control en fonctionnement et retente l'actualisation tant que les identifiants actuels de la connexion sont encore valides. Une actualisation reste sans réponse lorsque Claude Code ne peut pas joindre le service de connexion, que la requête expire ou que le service échoue sans rejeter votre connexion. Si le service de connexion ne répond toujours pas à l'expiration de ces identifiants, Claude Code arrête Remote Control et signale OAuth token refresh failed.

Lorsque Claude Code arrête Remote Control, il affiche la raison dans un avertissement et dans une ligne de transcription commençant par Remote Control disconnected. Votre session locale continue de fonctionner sans Remote Control. Cette section couvre les lignes suivantes :

Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
Remote Control disconnected — Signed out of Claude — run /login, then /remote-control

Claude Code nomme la cause au milieu du message :

• Claude.ai login expired et Claude.ai login was rejected : claude.ai n'accepte plus votre jeton de connexion enregistré, parce qu'il a expiré ou a été révoqué
• OAuth token unavailable : Claude Code n'avait aucun jeton de connexion enregistré au moment où les identifiants de la connexion devaient être renouvelés
• OAuth token refresh failed : claude.ai a rejeté votre jeton de connexion enregistré pendant que Claude Code se reconnectait, et l'actualisation du jeton n'en a pas produit de nouveau
• JWT refresh failed: no OAuth token : Claude Code n'a trouvé aucun jeton de connexion enregistré avec lequel renouveler
• Signed out of Claude : vous vous êtes déconnecté sur cette machine, par exemple en exécutant /logout dans un autre terminal, Claude Code n'a donc plus de connexion enregistrée avec laquelle renouveler la connexion

Que faire :

• Exécutez /login pour vous reconnecter
• Exécutez /remote-control pour reconnecter la session. Les messages se terminant par run /login to restore Remote Control ne nécessitent pas cette étape : Claude Code se reconnecte de lui-même une fois que vous êtes connecté.

Avant la v2.1.224, OAuth token refresh failed — run /login to re-authenticate s'affichait sous la forme OAuth token refresh failed — re-authenticate, then re-enable Remote Control, et JWT refresh failed: no OAuth token — run /login sous la forme no OAuth token available for recovery (code <N>). Les messages Claude.ai login expired, Claude.ai login was rejected et OAuth token unavailable ont été ajoutés dans la v2.1.225.

Avant la v2.1.238, Claude Code signalait les cas qui affichent désormais Signed out of Claude sous la forme JWT refresh failed: no OAuth token — run /login, et arrêtait Remote Control avec Claude.ai login expired — run /login to restore Remote Control dès qu'une actualisation de connexion restait sans réponse.

Remote Control s'est arrêté parce que le compte connecté a changé

Claude Code affiche cette ligne pendant une session Remote Control lorsque vous vous connectez à un autre compte ou à une autre organisation claude.ai sur cette machine. Vous avez effectué ce changement en dehors de la session Claude Code, par exemple en exécutant /login dans un autre terminal.

Une session Remote Control que vous avez démarrée en étant connecté via /login appartient au compte et à l'organisation claude.ai connectés à ce moment-là.

Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control

Claude Code arrête la session Remote Control dès que claude.ai confirme que le compte ou l'organisation a changé. Votre session locale continue de fonctionner sans Remote Control.

Que faire :

• Exécutez /remote-control pour démarrer une nouvelle session Remote Control sous le compte ou l'organisation actuel
• Pour revenir en arrière, exécutez /login et reconnectez-vous au compte ou à l'organisation précédent. Exécutez ensuite /remote-control.

Avant la v2.1.234, Claude Code ne détectait pas le passage à un autre compte ou à une autre organisation en dehors de la session Claude Code. Claude Code maintenait la session Remote Control connectée jusqu'à ce qu'une requête ultérieure au serveur Remote Control échoue avec Remote Control server rejected the request (HTTP 404). Cet échec pouvait survenir des heures après le changement.

Remote Control s'est arrêté parce que l'application exécutant la session s'est déconnectée ou a changé de compte

Lorsque l'application de bureau Claude ou un IDE héberge votre session, Claude Code obtient son jeton de connexion auprès de cette application plutôt que via /login. Lorsque claude.ai rejette ce jeton, Claude Code en demande un nouveau à l'application. Si l'application répond qu'elle est déconnectée, ou qu'elle est désormais connectée à un autre compte Claude, Claude Code met fin à la session Remote Control et envoie à l'application l'une de ces lignes :

Remote Control stopped — the app running this session is now signed in to a different Claude account
Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on

Votre session locale continue de fonctionner sans Remote Control.

Que faire :

• Si l'application est déconnectée, reconnectez-vous-y, puis réactivez Remote Control dans l'application
• Si l'application a changé de compte, Claude Code ne peut pas poursuivre la session terminée sous le nouveau compte. Démarrez une nouvelle session Remote Control sous ce compte.

Avant la v2.1.238, Claude Code envoyait à l'application, dans les deux cas, les messages run /login listés sous Remote Control n'a pas pu actualiser votre connexion.

Jeton OAuth révoqué ou expiré

Votre connexion enregistrée n'est plus valide. Un jeton révoqué signifie que vous vous êtes déconnecté partout ou qu'un administrateur a retiré l'accès ; un jeton expiré signifie que l'actualisation automatique a échoué en cours de session.

Les deux messages signalent un rejet renvoyé par l'API pour une requête envoyée par Claude Code. Lorsque la connexion enregistrée a déjà été effacée après un échec d'actualisation, vous voyez plutôt Connexion expirée. Si vous vous authentifiez avec un jeton de longue durée dans CLAUDE_CODE_OAUTH_TOKEN, vous voyez les mêmes messages lorsque ce jeton expire ou est révoqué.

OAuth token revoked · Please run /login
Please run /login · API Error: 401 OAuth token has expired ...

En mode non interactif (-p) et dans l'Agent SDK, les messages se présentent comme suit, et le code d'erreur structuré est authentication_failed :

Failed to authenticate: OAuth token revoked. Please log in again or contact your administrator.
Failed to authenticate. API Error: 401 OAuth token has expired ...

Avant la v2.1.287, en mode non interactif et dans l'Agent SDK, le message de révocation indiquait Your account does not have access to Claude. Please login again or contact your administrator.

Que faire :

• Exécutez /login à l'invite de Claude Code pour vous reconnecter
• Si votre commande -p ou votre programme Agent SDK utilise une connexion enregistrée, exécutez claude dans le même environnement, effectuez /login, puis relancez la commande ou le programme. Pour une automatisation qui ne peut pas se connecter de manière interactive, authentifiez-vous avec ANTHROPIC_API_KEY ou générez un jeton de longue durée avec claude setup-token.
• Si vous vous authentifiez avec la variable d'environnement CLAUDE_CODE_OAUTH_TOKEN, Claude Code continue d'envoyer la valeur que vous avez définie après l'échec d'une requête avec une 401, plutôt que de passer au jeton d'une connexion enregistrée. /status affiche ces identifiants sous la forme d'une ligne Auth token indiquant CLAUDE_CODE_OAUTH_TOKEN. Générez un nouveau jeton avec claude setup-token et redémarrez avec celui-ci, ou supprimez la variable et exécutez /login. Avant la v2.1.225, Claude Code pouvait remplacer la valeur de la variable en cours de session par le jeton d'accès de courte durée d'une connexion enregistrée, et la session échouait à nouveau avec des erreurs 401 une fois ce jeton expiré.
• Pour des demandes de connexion répétées d'un lancement à l'autre, consultez les vérifications de l'horloge système et les étapes de récupération du stockage des identifiants sur macOS dans Dépannage
• Pour d'autres échecs, notamment 403 Forbidden et les problèmes de navigateur OAuth, consultez Connexion et authentification

API Error: 401 Invalid authentication credentials

L'API a reconnu le format de vos identifiants mais a rejeté le compte ou l'organisation qui se trouve derrière. Anthropic renvoie ce message lorsque des identifiants ont été récemment révoqués, lorsqu'une organisation a été désactivée ou a retiré votre accès, ou lorsque le compte lui-même a été désactivé ; un jeton expiré n'en est donc pas la cause. Les identifiants peuvent être votre connexion enregistrée ou une ANTHROPIC_API_KEY approuvée, et la solution diffère : commencez donc par exécuter /status pour voir lesquels sont actifs.

Please run /login · API Error: 401 Invalid authentication credentials

Que faire :

• Si /status affiche une ligne API key qui n'est pas marquée comme inutilisée, une ANTHROPIC_API_KEY approuvée constitue les identifiants actifs et a priorité sur votre connexion, de sorte que /login ne la remplace pas. Renouvelez la clé dans la Claude Console, ou revenez à votre abonnement en exécutant unset ANTHROPIC_API_KEY, ou dans PowerShell Remove-Item Env:ANTHROPIC_API_KEY.
• Si /status n'affiche que votre connexion, exécutez /login une fois. Si les identifiants ont été révoqués, une nouvelle connexion les remplace.
• Si le même message revient pour le même compte de connexion, le compte ou l'organisation n'est plus actif. Vérifiez le compte et l'organisation que signale /status, et demandez à l'administrateur de votre organisation de rétablir l'accès.
• Si ANTHROPIC_BASE_URL pointe vers une passerelle LLM, le texte après 401 est le message de votre passerelle et non celui d'Anthropic, et /login n'y change rien. Corrigez plutôt les identifiants qu'attend votre passerelle.

Connexion expirée

Claude Code a tenté de renouveler votre connexion claude.ai enregistrée et le service OAuth a rejeté le jeton d'actualisation stocké ; Claude Code a donc effacé les identifiants enregistrés. Ensuite, chaque requête au modèle s'arrête localement avec ce message avant d'atteindre l'API, car seul /login peut créer de nouveaux identifiants.

Avant la v2.1.206, Claude Code envoyait quand même la requête au modèle avec les identifiants restant dans l'environnement, et chaque modèle échouait alors avec Un problème concerne le modèle sélectionné ou une 401 au lieu d'une invitation à se connecter.

Login expired · Please run /login

En mode non interactif (-p) et dans l'Agent SDK, le message se présente comme suit, et le code d'erreur structuré est authentication_failed :

Failed to authenticate: OAuth session expired and could not be refreshed

Cet état est différent de Jeton OAuth révoqué ou expiré. Ces messages signalent un rejet renvoyé par l'API. Claude Code produit lui-même Login expired pour une connexion qu'il n'a déjà pas réussi à renouveler ; il n'envoie donc aucune requête. Lorsque le renouvellement échoue parce que le compte lui-même est suspendu plutôt que parce que la connexion est obsolète, Claude Code affiche plutôt Votre compte est suspendu.

Les sessions authentifiées avec une clé API, CLAUDE_CODE_OAUTH_TOKEN ou un fournisseur tiers n'utilisent pas la connexion enregistrée et ne voient jamais ce message.

Vous pouvez détecter cet état avant l'échec d'une requête : /status affiche une ligne Login indiquant Expired — log in again, ainsi que l'organisation et l'adresse e-mail enregistrées pour la connexion expirée. La ligne n'apparaît que lorsque la connexion enregistrée constitue vos identifiants actifs et ne peut plus être actualisée. Les sessions authentifiées d'une autre manière n'affichent pas cette ligne, même si une connexion expirée reste enregistrée. Avant la v2.1.210, /status n'indiquait pas dans cet état qu'une connexion avait jamais existé, car les identifiants effacés ne lui laissaient rien à signaler.

Que faire :

• Exécutez /login pour vous reconnecter. Réessayer sans vous connecter affiche le même message à chaque requête.
• Si vous vous connectez avec votre compte claude.ai dans une autre fenêtre Claude Code, consultez Non connecté pour savoir quand cette session commence à utiliser cette connexion d'elle-même.
• En mode non interactif, exécutez claude dans le même environnement, effectuez /login, puis relancez votre commande. Pour une automatisation qui ne peut pas se connecter de manière interactive, authentifiez-vous avec ANTHROPIC_API_KEY ou générez un jeton de longue durée avec claude setup-token.
• Si la connexion continue d'échouer, consultez Connexion et authentification

Impossible d'actualiser votre connexion, car un autre processus Claude Code est en train de l'actualiser

Ce message ne signifie pas que votre connexion a été rejetée. Votre connexion claude.ai enregistrée avait expiré et devait être renouvelée. Un autre processus Claude Code sur la même machine détenait le verrou d'actualisation partagé, ou s'est terminé en le laissant derrière lui, et l'actualisation n'a pas progressé pendant que cette session attendait. Claude Code arrête la requête avant de l'envoyer :

Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login

En mode non interactif (-p) et dans l'Agent SDK, le message se présente comme suit, et le code d'erreur structuré est server_error :

Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

Les sessions authentifiées avec une clé API, CLAUDE_CODE_OAUTH_TOKEN ou un fournisseur tiers n'utilisent pas la connexion enregistrée et ne voient jamais ce message.

Que faire :

• Réessayez dans une minute. Si un autre processus termine l'actualisation en premier, cette session utilise la connexion renouvelée.
• Si le message continue de revenir, fermez les autres fenêtres et processus Claude Code, puis réessayez.
• S'il revient alors qu'aucun autre processus Claude Code n'est en cours d'exécution, exécutez /login. Se reconnecter n'attend pas le verrou d'actualisation.

Impossible d'enregistrer votre connexion

Vous vous êtes connecté avec claude.ai, mais Claude Code n'a pas pu enregistrer la connexion dans son magasin d'identifiants ; la connexion n'a donc pas abouti. Sur macOS, cela peut se produire lorsque le trousseau de session se verrouille, par exemple lors de la mise en veille ou d'une inactivité, après que Claude Code y a déjà lu ou enregistré des identifiants au cours de la même session.

Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
Couldn't save your login. Try logging in again.

La première forme apparaît sur macOS et la seconde partout ailleurs. Un échec transitoire du magasin d'identifiants, comme un délai d'expiration ou un magasin illisible, produit le même message.

Que faire :

• Sur macOS, déverrouillez le trousseau de session, puis exécutez à nouveau /login
• Sur les autres plateformes, exécutez à nouveau /login
• Si la connexion ne s'enregistre toujours pas, consultez Non connecté ou jeton expiré pour la commande de déverrouillage du trousseau et d'autres étapes de récupération du stockage des identifiants

Échec du démarrage du serveur de rappel OAuth

Lorsque /login, claude auth login ou claude setup-token vous connecte via le navigateur, Claude Code ouvre un port d'écoute sur 127.0.0.1 afin que votre navigateur puisse lui renvoyer le résultat de la connexion. Ce message signifie que Claude Code n'a pas pu ouvrir ce port, et la connexion s'arrête avant qu'une fenêtre de navigateur ou une URL de connexion n'apparaisse :

Failed to start OAuth callback server: Failed to start server. Is port 0 in use?

Si votre message se termine par Is port 0 in use?, la tentative d'écoute sur l'adresse de bouclage IPv4 127.0.0.1 a échoué purement et simplement. Comme l'échec survient avant qu'une URL de connexion n'existe, le flux Paste code here if prompted n'est pas disponible comme solution de contournement.

Que faire :

• Pour vous connecter immédiatement sans l'écouteur local : si vous utilisez un abonnement claude.ai, exécutez claude setup-token sur une machine où la connexion fonctionne et définissez le jeton qu'il affiche comme CLAUDE_CODE_OAUTH_TOKEN sur cette machine. Sinon, définissez ANTHROPIC_API_KEY sur une clé provenant de la Claude Console. Priorité d'authentification explique comment Claude Code choisit entre les identifiants.
• Pour utiliser plutôt la connexion par navigateur sur cette machine, Claude Code doit pouvoir écouter sur 127.0.0.1. S'il s'exécute dans un sandbox, vérifiez que la politique du sandbox autorise l'écoute sur les ports locaux, puis exécutez à nouveau /login. S'il devrait pouvoir le faire et que cela échoue toujours, exécutez /feedback afin que le rapport inclue les détails de votre environnement.

Connexion Claude non acceptée

Vous avez tenté de démarrer une session cloud, et le serveur a refusé de la créer avec une 401 : il n'a pas accepté la connexion Claude envoyée par cette machine, généralement parce que la connexion a expiré ou a été révoquée.

La première partie de la ligne est la raison propre du serveur lorsqu'il en fournit une. Sinon, la ligne indique :

Claude login not accepted · Run /login, then try again

Que faire :

• Exécutez /login, terminez la connexion, puis démarrez à nouveau la session

Les artefacts nécessitent une connexion claude.ai

Claude Code a refusé une publication ou une lecture d'artefact parce que la session n'a aucune connexion claude.ai utilisable pour les artefacts.

Chaque forme du message commence par les mêmes mots, suivis d'une solution qui dépend de la manière dont votre session s'authentifie. En l'absence d'identifiants concurrents, il indique :

Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.

Que faire :

• Exécutez /login et sélectionnez Claude account with subscription. L'option Anthropic Console account ne fournit pas d'identifiants claude.ai.
• Lorsque le message nomme des identifiants qui ont priorité, comme ANTHROPIC_API_KEY, un paramètre apiKeyHelper ou une clé Console enregistrée par un /login précédent, supprimez-les comme l'indique le message, puis exécutez /login
• Lorsque le message indique que cette session à distance s'authentifie via la machine qui l'a lancée, connectez-vous à claude.ai sur cette machine, puis reconnectez la session
• Lorsque le message indique que les identifiants sont injectés par l'environnement hôte de la session, vous ne pouvez pas les modifier dans cette session ; démarrez une session connectée à claude.ai
• Consultez Disponibilité pour les autres exigences des artefacts, comme le forfait, le fournisseur de modèle et la politique de l'organisation

La politique de l'administrateur exige une connexion à la passerelle cloud

Les paramètres gérés d'un administrateur sur cette machine définissent forceLoginMethod sur "gateway" ou définissent forceLoginGatewayUrl. Sauf si vous sélectionnez un fournisseur cloud via une variable comme CLAUDE_CODE_USE_BEDROCK, Claude Code n'accepte alors que la connexion à la passerelle des applications Claude. Vous voyez l'un de ces deux messages :

Not signed in to the Cloud gateway — run /login.

Les requêtes au modèle échouent avec ce message lorsque la session n'a pas de connexion à la passerelle, par exemple parce que vous n'avez pas exécuté /login depuis que la politique a atteint la machine.

Si la machine détient également des identifiants émis par Anthropic et que les paramètres gérés définissent forceLoginMethod ou forceLoginOrgUUID, Claude Code se ferme plutôt au démarrage. Ces identifiants peuvent être une variable ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN, un paramètre apiKeyHelper ou une clé API enregistrée par une connexion Claude Console antérieure.

Le message de démarrage nomme les identifiants avec lesquels la session est configurée, l'endroit où ils sont définis et l'étape qui les supprime. Par exemple, avec une variable ANTHROPIC_API_KEY définie dans votre shell, il indique :

Administrator policy requires a Cloud gateway sign-in on this machine, but this session is configured with an API key from ANTHROPIC_API_KEY, which a gateway machine does not accept.

To continue: unset ANTHROPIC_API_KEY (or run in a shell without it), then run claude and sign in with /login.

Que faire :

• Pour Not signed in to the Cloud gateway, exécutez /login et terminez la connexion sur l'écran Cloud gateway
• Pour le message de démarrage, supprimez les identifiants en suivant les étapes à la fin du message
• Si vous pensez que la machine ne devrait pas exiger la passerelle, demandez à l'administrateur qui la gère de retirer forceLoginMethod et forceLoginGatewayUrl de ses paramètres gérés

Avant la v2.1.284, le message de démarrage listait les identifiants possibles au lieu de nommer ceux qui étaient configurés. Il commençait par Administrator policy requires a Cloud gateway sign-in on this machine; the Anthropic-issued credential configured here (ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used. Si vous voyez cette formulation et ne parvenez pas à déterminer quels identifiants supprimer, passez à la v2.1.284 ou ultérieure et relancez claude.

Sur la v2.1.265, une régression affichait également le premier message dans certaines configurations de passerelle LLM et de proxy qui s'authentifient avec une clé API, apiKeyHelper ou des en-têtes personnalisés, même sans exigence de l'administrateur sur la machine. Passez à la v2.1.266 ou ultérieure. Vous n'avez pas besoin de modifier votre configuration.

Avant la v2.1.261, sur les machines qui définissaient forceLoginMethod sur "gateway", Claude Code utilisait une connexion enregistrée résiduelle au lieu de faire échouer les requêtes au modèle, et signalait des identifiants d'environnement configurés avec This machine's managed settings require a first-party login au lieu du message de démarrage.

Votre compte est suspendu

Le compte Claude associé à votre connexion a été suspendu. Claude Code affiche le premier message lorsqu'il tente de renouveler votre connexion enregistrée et apprend la suspension, et le second lorsqu'une connexion que vous effectuez dans le navigateur la signale :

Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted

Se reconnecter avec le même compte ne fait pas disparaître le message, car la suspension porte sur le compte et non sur la connexion. En mode non interactif (-p) et dans l'Agent SDK, le code d'erreur structuré est account_on_hold. Avant la v2.1.235, Claude Code signalait un compte suspendu sous la forme Login expired · Please run /login, dont les étapes de récupération ne peuvent pas lever une suspension.

Que faire :

• Ouvrez le lien du message pour consulter les détails de la suspension ou faire appel
• Si vous disposez d'un autre compte Claude ou d'une clé API non concernés par la suspension, vous pouvez continuer à travailler pendant sa résolution : exécutez /login avec ce compte, ou définissez la clé avec ANTHROPIC_API_KEY

Connexion au profil Anthropic expirée

Claude Code s'authentifie via un profil d'identifiants Anthropic dont les identifiants de connexion enregistrés ont expiré, et le profil ne contient aucun identifiant d'actualisation que Claude Code pourrait utiliser pour les renouveler. Claude Code arrête chaque requête localement sans réessayer, car une nouvelle tentative lirait les mêmes identifiants expirés.

Anthropic profile login expired · Re-authenticate your Anthropic profile
Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile

Ce message n'apparaît que lorsque les identifiants actifs proviennent d'un profil d'identifiants Anthropic, que vous sélectionnez avec la variable d'environnement ANTHROPIC_PROFILE, que Claude Code découvre comme profil actif dans votre répertoire de configuration Anthropic, ou que Claude Code a écrit lorsque vous vous êtes connecté sans clé API. Les sessions qui s'authentifient avec une clé API, un jeton bearer comme ANTHROPIC_AUTH_TOKEN ou un fournisseur tiers ne voient jamais ce message.

Sur une machine qui propose la connexion sans clé, exécutez /login, choisissez le compte Anthropic Console et reconnectez-vous pour renouveler un profil écrit par la connexion Console sans clé ou par ant auth login de la Claude Platform CLI. Claude Code remplace les identifiants expirés dans ce profil. Pour un profil de fédération ou un profil créé par un autre outil, /login ne renouvelle pas les identifiants. La forme que vous voyez dépend de si vous avez sélectionné le profil ou si Claude Code l'a découvert :

• Lorsque vous définissez ANTHROPIC_PROFILE explicitement, le message se termine par Re-authenticate your Anthropic profile.
• Lorsque Claude Code a découvert le profil depuis votre répertoire de configuration, le message propose /login, car Claude Code donne la priorité à un /login fonctionnel sur le profil découvert et s'authentifie alors avec votre compte claude.ai ou Console. Avant la v2.1.234, Claude Code affichait également la forme Re-authenticate your Anthropic profile dans ce cas.

Que faire :

• Reconnectez-vous au profil, puis réessayez : sur une machine qui propose la connexion sans clé, exécutez /login et choisissez le compte Anthropic Console pour un profil écrit par la connexion Console sans clé ou par ant auth login de la Claude Platform CLI ; pour les autres profils, utilisez l'outil qui les a créés
• Si un administrateur a provisionné les identifiants du profil, demandez-lui d'en émettre de nouveaux
• Exécutez /status pour confirmer la source d'identifiants active et le nom du profil
• Pour cesser d'utiliser le profil, supprimez ANTHROPIC_PROFILE si vous l'avez définie, puis authentifiez-vous d'une autre manière, par exemple avec /login ou ANTHROPIC_API_KEY

Exigence de scope OAuth

Le jeton stocké est antérieur à un scope de permission dont une fonctionnalité plus récente a besoin :

OAuth token does not meet scope requirement: user:profile

Que faire :

• Exécutez /login pour obtenir un nouveau jeton avec les scopes actuels. Vous n'avez pas besoin de vous déconnecter au préalable.

claude.ai a rejeté le jeton de session

Une requête d'un connecteur claude.ai a échoué parce que claude.ai a rejeté le jeton de votre connexion Claude Code. Le jeton rejeté est votre connexion, et non l'autorisation propre du connecteur dans claude.ai ; autoriser à nouveau le connecteur ne résout donc pas le problème. Dans /mcp, le connecteur apparaît comme session token rejected et sa vue détaillée indique :

claude.ai rejected the session token. Run /login, then reconnect.

Que faire :

• Exécutez /login pour vous reconnecter
• Reconnectez le connecteur depuis /mcp, ou exécutez /mcp reconnect <server>. Reconnecter avant de vous être reconnecté laisse le connecteur dans le même état. L'option Reconnect du panneau /mcp signale your claude.ai session token was rejected ; la forme saisie /mcp reconnect <server> signale une reconnexion réussie alors que le jeton est toujours rejeté.

Avant la v2.1.222, Claude Code marquait plutôt le connecteur comme nécessitant une authentification, ce qui vous orientait vers le flux d'autorisation du connecteur alors que le mener à terme ne résolvait pas l'état.

Le serveur MCP vous demande de vous reconnecter

Un serveur MCP distant a rejeté les identifiants lors d'un appel d'outil en cours de session, généralement parce qu'une connexion ou un jeton a expiré ou parce que le jeton ne dispose pas d'une permission dont l'outil a besoin. L'appel d'outil échoue, et /mcp marque le serveur comme nécessitant une authentification.

Pour un serveur auquel vous vous connectez depuis Claude Code, y compris un connecteur claude.ai, la connexion a expiré ou a été révoquée :

MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)

Exécutez /mcp, sélectionnez le serveur et reconnectez-vous depuis son menu.

Pour un serveur configuré avec un script headersHelper, Claude Code a déjà réexécuté le helper et relancé l'appel une fois avant d'afficher ceci :

MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)

Vérifiez que le helper renvoie des identifiants que le serveur accepte, puis reconnectez-vous depuis /mcp, qui réexécute le helper.

Pour un serveur avec un en-tête Authorization statique dans sa configuration :

MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)

Mettez à jour la valeur de l'en-tête là où le serveur est configuré, puis reconnectez-vous depuis /mcp.

Avant la v2.1.273, les cas de connexion expirée, de headersHelper et d'en-tête Authorization affichaient tous MCP server "<name>" requires re-authorization (token expired).

Un serveur peut également refuser un appel d'outil avec une erreur HTTP 403 insufficient_scope pour vous demander d'autoriser un scope, parfois un scope que votre jeton liste déjà. Le message nomme ce scope :

MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate

Exécutez /mcp, sélectionnez le serveur et authentifiez-vous à nouveau depuis son menu.

Lorsque la configuration du serveur ne définit ni oauth.scopes ni authServerMetadataUrl, Claude Code demande le scope que le serveur a nommé. Avec l'un ou l'autre de ces paramètres, Claude Code demande plutôt les scopes de ce paramètre. Si vous avez figé oauth.scopes, ajoutez le scope manquant à cette liste avant de vous authentifier à nouveau.

Avant la v2.1.274, ce cas affichait le message needs you to sign in again, et avant la v2.1.273 il affichait requires re-authorization (token expired) comme les autres cas.

L'URL du serveur MCP est manquante ou n'est pas une URL valide

Claude Code a refusé de démarrer une connexion OAuth pour un serveur MCP distant parce que l'url configurée du serveur ne peut pas être analysée comme une URL. Sauf si Claude Code a un problème de configuration plus précis à signaler pour le serveur, exécuter claude mcp login <name> dans votre shell affiche le refus ainsi :

Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.

Que faire :

• Définissez l'url de l'entrée sur l'endpoint réel du serveur là où le serveur est configuré, ou définissez la variable d'environnement que nomme sa référence ${VAR}, puis relancez la connexion.

Incohérence de l'émetteur dans la réponse d'autorisation

Lors d'une connexion OAuth MCP, le serveur d'autorisation a redirigé vers Claude Code avec un paramètre iss qui ne nomme pas l'émetteur que Claude Code attendait d'après les métadonnées OAuth du serveur. Un émetteur incorrect à cette étape correspond à la signature d'une attaque par confusion de serveur d'autorisation (mix-up) ; Claude Code fait donc échouer la connexion au lieu d'échanger le code d'autorisation. Claude Code affiche l'erreur dans le menu du serveur /mcp après la connexion par navigateur :

Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"

expected est l'émetteur indiqué dans les métadonnées OAuth du serveur, et received est la valeur iss que contenait la redirection. Une connexion dont la redirection ne contient aucun paramètre iss passe la vérification, sauf si les métadonnées du serveur définissent authorization_response_iss_parameter_supported, auquel cas Claude Code fait échouer la connexion.

Que faire :

• Relancez la connexion depuis /mcp
• Si l'erreur se répète, signalez-la à l'opérateur du serveur. La correction se fait côté serveur : le serveur d'autorisation doit renvoyer dans le paramètre iss le même émetteur que celui qu'il annonce dans ses métadonnées
• Pour vous connecter pendant la correction du serveur, démarrez Claude Code avec MCP_SDK_GENERATION=v1, dont le runtime n'effectue pas cette vérification. Cela supprime une protection contre les attaques par confusion ; privilégiez donc la correction côté serveur

Avant la v2.1.232, Claude Code n'utilisait le runtime v2 que dans le cadre d'un déploiement progressif ou lorsque vous définissiez MCP_SDK_GENERATION=v2.

Refus d'envoyer des identifiants à un endpoint de jeton non HTTPS

Sur le runtime v2, Claude Code n'envoie une requête de jeton OAuth MCP qu'à un endpoint de jeton servi en HTTPS ou sur localhost, 127.0.0.1 ou ::1. Ce message signifie que l'endpoint de jeton du serveur n'est ni l'un ni l'autre ; Claude Code s'est donc arrêté avant d'envoyer la requête. Cela se produit après la connexion par navigateur, de sorte que l'étape du navigateur réussit d'abord, puis à nouveau chaque fois que Claude Code actualise le jeton du serveur.

Dans sa forme complète, le message provient du MCP SDK et cite l'endpoint de jeton qu'il a refusé. Dans le log de débogage, il suit Error during auth completion: pour une connexion ou Token refresh failed: pour une actualisation. Dans votre shell, claude mcp login <name> l'affiche après Couldn't complete authentication for "<name>":, et dans une session, /mcp l'affiche sous le menu du serveur :

Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).

Claude Code considère comme potentiellement secrète une URL de serveur qui comporte une chaîne de requête ou un long segment de chemin d'apparence aléatoire. Pour un tel serveur, il masque les erreurs de connexion levées par le MCP SDK avant de les afficher ou de les journaliser. Cette erreur se présente alors sous la forme d'un nom court susceptible de changer d'une version à l'autre, comme io, suivi de from the MCP SDK for et de l'URL du serveur masquée. Les autres erreurs du MCP SDK prennent la même forme dans ce cas. Le message masqué ne peut correspondre à cette erreur que lorsque l'endpoint de jeton du serveur est en http:// simple sur une adresse autre que localhost, 127.0.0.1 ou ::1.

Que faire :

• Servez cet endpoint de jeton en HTTPS, par exemple en plaçant le serveur derrière un reverse proxy ou un tunnel qui termine TLS et en configurant le serveur pour annoncer l'adresse https://
• Pour vous connecter sans modifier le serveur, démarrez Claude Code avec MCP_SDK_GENERATION=v1, dont le runtime n'applique pas cette règle et envoie la requête de jeton en HTTP simple. Ce choix dure jusqu'à ce que vous quittiez et s'applique à tous les serveurs. Le runtime v1 ignore également la vérification de l'émetteur ; privilégiez donc le service de l'endpoint en HTTPS

Identifiants AWS expirés ou non valides

Votre jeton de session AWS a expiré ou a été rejeté. Ce message apparaît lors d'une 401 provenant de Claude Platform on AWS ou de l'endpoint Mantle, qui est la manière dont ces fournisseurs signalent un jeton de sécurité expiré.

L'indication d'action au milieu varie selon votre configuration. 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 ...

Avant la v2.1.273, ce message n'apparaissait que lorsque awsAuthRefresh était configuré.

Que faire :

• Si l'indication précise que les identifiants sont gérés par cet environnement, l'application qui a lancé Claude Code détient les identifiants et les autres étapes ici ne s'appliquent pas : réessayez, ou contactez votre administrateur
• Si awsAuthRefresh est défini, exécutez la commande nommée dans le message, comme aws sso login --profile myprofile, dans un autre terminal et terminez la connexion par navigateur, puis réessayez. Sinon, actualisez vous-même les identifiants AWS que vous utilisez : votre connexion SSO, vos clés d'accès, votre clé API ou votre jeton de proxy
• Avec awsAuthRefresh défini dans une session interactive, vous pouvez plutôt exécuter /login, choisir 3rd-party platform, puis sélectionner Claude Platform on AWS · refresh credentials sous Using 3rd-party platforms pour exécuter la même commande sans redémarrer Claude Code. Consultez Configurer les identifiants AWS
• Si l'erreur se répète après la réussite de la commande d'actualisation, confirmez que l'identité est valide en dehors de Claude Code avec aws sts get-caller-identity dans le même shell et le même profil

Échec de l'authentification AWS

Votre fournisseur AWS a renvoyé une 403, ou Amazon Bedrock a renvoyé une 401.

Amazon Bedrock signale un jeton de sécurité expiré par une 403, mais une 403 est aussi sa manière de signaler un refus d'autorisation, comme une AccessDeniedException due à une permission IAM manquante. Claude Code ne peut pas distinguer ces deux causes.

Une 401 provenant d'Amazon Bedrock aboutit également ici plutôt que sous Identifiants AWS expirés ou non valides, car Amazon Bedrock ne signale pas un jeton expiré par une 401. Une 401 provenant de cet endpoint vient généralement d'un autre élément du chemin de la requête, comme un proxy d'entreprise.

Une actualisation des identifiants corrige un jeton expiré mais ne peut pas corriger les autres causes ; le message propose donc 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'indication d'action au milieu varie selon votre configuration. La partie stable est le début AWS authentication failed.

Lorsque la 403 est la réponse d'Amazon Bedrock indiquant que vous n'avez pas accès au modèle avec l'identifiant de modèle spécifié, l'indication vous invite plutôt à activer le modèle pour votre compte et votre région dans la console Amazon Bedrock.

Avant la v2.1.273, ce message n'apparaissait que lorsque awsAuthRefresh était configuré.

Que faire :

• Si l'indication précise que les identifiants sont gérés par cet environnement, l'application qui a lancé Claude Code détient les identifiants et les autres étapes ici ne s'appliquent pas : réessayez, ou contactez votre administrateur
• Actualisez vos identifiants AWS au cas où des identifiants expirés seraient en cause : exécutez la commande awsAuthRefresh nommée dans le message lorsqu'elle est définie, ou actualisez vous-même votre connexion SSO, vos clés d'accès, votre clé API ou votre jeton de proxy
• Si vos identifiants sont à jour, vérifiez que les permissions IAM de Configuration IAM sont attachées à l'identité que vous utilisez et que le modèle sélectionné est activé pour votre compte et votre région
• Exécutez aws sts get-caller-identity pour confirmer quelle identité vos requêtes utilisent

Identifiants Google Cloud expirés ou non valides

Vos identifiants Google Cloud pour Google Cloud's Agent Platform ont expiré ou ont été rejetés : la requête a renvoyé une 401, qui est la manière dont Agent Platform signale l'expiration des identifiants.

L'indication d'action au milieu varie selon votre configuration. La partie stable est le début Google Cloud credentials expired or invalid :

Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...

Que faire :

• Si l'indication précise que les identifiants sont gérés par cet environnement, l'application qui a lancé Claude Code détient les identifiants et les autres étapes ici ne s'appliquent pas : réessayez, ou contactez votre administrateur
• Si vous vous authentifiez avec les identifiants par défaut de l'application, exécutez la commande gcpAuthRefresh nommée dans le message, ou gcloud auth application-default login, et terminez la connexion, puis réessayez
• Si vous passez par une passerelle LLM avec CLAUDE_CODE_SKIP_VERTEX_AUTH défini, actualisez le jeton de la passerelle dans ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_CUSTOM_HEADERS, puis réessayez
• Si vous vous authentifiez avec un fichier de clé de compte de service, vérifiez que GOOGLE_APPLICATION_CREDENTIALS pointe vers une clé valide. Consultez Configurer les identifiants GCP
• Si l'erreur se répète après une actualisation, confirmez que l'identité fonctionne en dehors de Claude Code avec gcloud auth application-default print-access-token dans le même shell

Avant la v2.1.273, une 401 provenant d'Agent Platform affichait plutôt le message générique Please run /login ou Failed to authenticate, qui ne permet pas d'actualiser les identifiants Google Cloud.

Échec de l'authentification Google Cloud

Agent Platform de Google Cloud a renvoyé une erreur 403, qu'il utilise pour les refus d'autorisation plutôt que pour les identifiants expirés. En général, il manque une permission IAM à l'identité avec laquelle vous vous authentifiez, ou le modèle n'est pas activé pour votre projet.

L'indication d'action au milieu varie selon votre configuration. La partie stable est le début Google Cloud authentication failed :

Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...

Que faire :

• Si l'indication précise que les identifiants sont gérés par cet environnement, c'est l'application qui a lancé Claude Code qui détient l'identifiant et les autres étapes ci-dessous ne s'appliquent pas : réessayez ou contactez votre administrateur
• Vérifiez que les rôles décrits dans Configuration IAM sont accordés à l'identité avec laquelle vous vous authentifiez
• Vérifiez que le modèle est activé pour votre projet. Consultez Demander l'accès au modèle

Avant la v2.1.273, une erreur 403 d'Agent Platform affichait à la place le message générique Please run /login ou Failed to authenticate, qui ne permet pas d'actualiser les identifiants Google Cloud.

Échec de l'authentification Microsoft Foundry

Microsoft Foundry a renvoyé une erreur 401 ou 403 : l'identifiant Azure de la requête a été rejeté, ou l'identité associée n'a pas accès à la ressource Foundry. /login ne peut pas générer d'identifiants Azure. L'indication d'action au milieu varie selon votre configuration. La partie stable est le début Microsoft Foundry authentication failed :

Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...

Que faire :

• Si l'indication précise que les identifiants sont gérés par cet environnement, c'est l'application qui a lancé Claude Code qui détient l'identifiant et les autres étapes ci-dessous ne s'appliquent pas : réessayez ou contactez votre administrateur
• Actualisez l'identifiant que vous avez configuré dans Configurer les identifiants Azure : renouvelez ANTHROPIC_FOUNDRY_API_KEY, générez un nouveau ANTHROPIC_FOUNDRY_AUTH_TOKEN, ou exécutez az login pour que la chaîne d'identifiants Microsoft Entra par défaut puisse se reconnecter
• Si l'identifiant est à jour, vérifiez que l'identité a accès à la ressource Foundry. Consultez Configuration Azure RBAC

Avant la v2.1.273, une erreur 401 ou 403 de Microsoft Foundry affichait à la place le message générique Please run /login ou Failed to authenticate, qui ne permet pas d'actualiser les identifiants Azure.

Impossible de charger les identifiants AWS ou Google Cloud

Claude Code n'a pas pu obtenir d'identifiants utilisables à partir de la chaîne de fournisseurs d'identifiants AWS ou de vos identifiants par défaut d'application Google sur la machine où il s'exécute ; aucune requête n'a donc atteint votre fournisseur cloud. Claude Code vide ses identifiants en cache et réessaie deux fois avant d'afficher ce message. Le détail après le · indique la cause précise, par exemple une session SSO expirée, des identifiants par défaut d'application manquants signalés par Could not load the default credentials, ou une connexion révoquée signalée par invalid_grant :

API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.

En mode non interactif avec -p et dans l'Agent SDK, le code d'erreur structuré est cloud_credential_error. Avant la v2.1.267, le message n'affichait que le texte de détail après API Error:, et le code structuré était server_error ou unknown.

Que faire :

• Exécutez la commande de connexion de votre fournisseur, par exemple aws sso login --profile myprofile ou gcloud auth application-default login, puis réessayez. Identifiants Bedrock, Agent Platform ou Foundry non chargés explique comment vérifier les identifiants en dehors de Claude Code
• Si le détail indique AWS default-chain credential resolve timed out, la chaîne s'est bloquée au lieu d'échouer ; suivez plutôt Délai d'expiration de la résolution des identifiants de la chaîne AWS par défaut

Délai d'expiration de la résolution des identifiants de la chaîne AWS par défaut

La chaîne de fournisseurs d'identifiants AWS par défaut n'a pas produit d'identifiants dans un délai de 60 secondes ; Claude Code a donc interrompu la résolution et fait échouer la requête. Ce délai d'expiration est l'une des causes de Impossible de charger les identifiants AWS ou Google Cloud. L'échec concerne la résolution locale des identifiants : la requête n'a jamais atteint Amazon Bedrock, Claude Platform on AWS ni l'endpoint Mantle. Claude Code vide son cache d'identifiants et réessaie avant que cette erreur n'apparaisse ; lorsque vous la voyez, la chaîne s'est donc bloquée lors de plusieurs tentatives.

API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.

Les causes courantes sont une commande credential_process dans votre profil AWS qui attend une saisie qu'elle ne peut pas recevoir, et un conteneur ou une VM dont le service de métadonnées d'instance (IMDS) ne répond jamais à la sonde de la chaîne.

Avant la v2.1.267, le message était API Error: AWS default-chain credential resolve timed out. Avant la v2.1.207, une chaîne bloquée laissait la requête en attente indéfiniment au lieu d'échouer.

Que faire :

• Exécutez aws sts get-caller-identity dans le même shell avec le même AWS_PROFILE. Si la commande se bloque également, corrigez le profil ; une commande credential_process qui demande une saisie interactive en est une cause fréquente.
• Effectuez l'étape de connexion avant de démarrer Claude Code, par exemple aws sso login --profile myprofile
• Si votre chaîne exécute une connexion interactive qui nécessite légitimement plus de 60 secondes, comme une connexion SSO avec MFA via un wrapper tel que aws-vault, augmentez la limite en millisecondes avec CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

Délai d'attente d'AWS expiré lors de la vérification de la configuration Bedrock

Un appel à AWS lors de la vérification des identifiants de l'assistant de configuration Bedrock, comme la recherche d'identifiants ou la vérification d'identité, ne s'est pas terminé dans la limite de 60 secondes. L'assistant cesse d'attendre et fait échouer l'étape de vérification :

Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

Le nombre reflète votre limite : 60 secondes par défaut, ou la valeur que vous avez définie dans CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

Les causes courantes sont un réseau ou un proxy qui bloque les requêtes vers AWS, y compris l'actualisation du jeton SSO, et un assistant d'identifiants qui attend encore une saisie que vous ne voyez pas. N'augmentez la limite que lorsque l'assistant a légitimement besoin de plus de temps.

Une seule requête bloquée vers AWS peut également échouer en raison de son propre délai d'expiration par requête, ce qui affiche un message plus court à la même étape :

A request to AWS timed out. Check your network and proxy settings, then try again.

Lorsque les mêmes délais d'expiration surviennent à l'étape d'épinglage du modèle, l'assistant marque un modèle comme unreachable au lieu d'afficher l'un ou l'autre message.

Que faire :

• Exécutez aws sts get-caller-identity dans le même shell. Si la commande se bloque également, le blocage se situe en dehors de Claude Code, dans votre réseau, votre proxy ou l'assistant d'identifiants de votre profil AWS ; corrigez d'abord ce problème.
• Effectuez toute connexion interactive avant d'ouvrir l'assistant, par exemple aws sso login --profile myprofile
• Si un assistant d'identifiants de votre profil AWS a légitimement besoin de plus de 60 secondes pour vous demander une saisie, augmentez la limite en millisecondes avec CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

Session de passerelle cloud expirée

Vous vous êtes connecté via une passerelle Claude apps, et la session de passerelle enregistrée sur cette machine a expiré et n'a pas pu être renouvelée, ou la passerelle ne l'accepte plus, par exemple après le remplacement du secret JWT de la passerelle. Si cette ligne apparaît lorsque vous démarrez claude en mode interactif, la session s'est ouverte déconnectée de la passerelle :

Cloud gateway session expired — run /login to reconnect.

La même ligne peut apparaître en cours de session lorsque l'identifiant de la passerelle expire et que Claude Code ne parvient pas à le renouveler.

Lors d'une exécution non interactive, d'une session en arrière-plan ou autrement sans surveillance, ou d'une sous-commande claude autre que claude auth, Claude Code se ferme plutôt avec ce message lorsque la passerelle n'accepte plus la session :

Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.

Que faire :

• Exécutez /login dans la session et terminez la connexion dans le navigateur
• Pour un lancement non interactif, démarrez claude dans le même environnement, exécutez /login, puis relancez votre commande

Délai de connexion expiré en attendant votre confirmation

Lors d'une connexion via une passerelle Claude apps, la passerelle a indiqué le compte qui s'est connecté, et Claude Code vous a demandé de le confirmer avant d'enregistrer l'identifiant. Vous avez laissé la confirmation ouverte au-delà de l'expiration propre à la connexion, et la passerelle n'a émis aucun jeton d'actualisation permettant de la renouveler ; Claude Code n'a donc rien enregistré lorsque vous avez continué :

Sign-in timed out while waiting for you to continue. Try again.

Que faire :

• Exécutez de nouveau /login et confirmez le compte avant l'expiration de la connexion

La passerelle a refusé la requête

Vous êtes connecté via une passerelle Claude apps, et une requête a renvoyé une erreur 403 : la passerelle, ou le service en amont derrière elle, l'a refusée. Se reconnecter ne change rien à un refus ; le message vous oriente donc vers l'administrateur de votre passerelle :

Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...

Que faire :

• Demandez à l'administrateur de votre passerelle d'examiner la requête. La fin du message API Error: contient le refus renvoyé par la passerelle
• Pour les administrateurs : une règle de contrôle d'accès sur la passerelle renvoie une erreur 403 que le log d'audit consigne avec sa raison, et un refus d'autorisation du service en amont est transmis conformément à Messages d'erreur en amont

Avant la v2.1.273, une erreur 403 sur une session de passerelle affichait à la place le message générique Please run /login ou Failed to authenticate, et se reconnecter ne levait pas le refus.

Erreurs de réseau et de connexion

La plupart de ces erreurs signifient qu'une requête réseau de Claude Code n'a pas pu atteindre sa destination, ou que quelque chose entre Claude Code et l'API a modifié la réponse en chemin ; lorsqu'une entrée a également une cause locale, comme une écriture d'archive échouée, son corps l'indique. Elles proviennent généralement de votre réseau local, proxy ou 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. Pour les codes d'erreur de connexion courants, le message nomme le type d'échec et conserve le code entre parenthèses :

Unable to connect to API. Check your internet connection
Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
Can't reach the API server — check your internet or DNS (ENOTFOUND)
No internet route — check your connection or VPN (EHOSTUNREACH)
Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
Connection dropped (ECONNRESET)
Request timed out. Check your internet connection and proxy settings

Un code que Claude Code ne reconnaît pas apparaît comme Unable to connect to API suivi du code entre parenthèses. Certains de ces messages peuvent afficher plus d'un code : Connection refused peut afficher ConnectionRefused ou ECONNREFUSED, par exemple, et Can't reach the API server peut afficher ENOTFOUND ou FailedToOpenSocket.

Avant la v2.1.227, chacun de ces messages codés lisait Unable to connect to API suivi du code, par exemple Unable to connect to API (ECONNREFUSED).

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é.

À faire :

• Confirmez que vous pouvez atteindre l'hôte API à partir du même shell en exécutant curl -I https://api.anthropic.com. Sur Windows PowerShell, utilisez curl.exe -I https://api.anthropic.com pour que l'alias Invoke-WebRequest intégré ne soit pas utilisé.
• Si vous êtes derrière un proxy d'entreprise, définissez HTTPS_PROXY avant de lancer Claude Code et consultez Configuration réseau
• Si vous routez via une passerelle LLM ou un relais, définissez ANTHROPIC_BASE_URL sur 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 automatiquement réessayées ; les défaillances persistantes pointent vers 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 :

• Vérifiez si ANTHROPIC_BASE_URL est défini en exécutant echo $ANTHROPIC_BASE_URL, ou echo $env:ANTHROPIC_BASE_URL dans PowerShell, et cherchez-le dans le bloc env de vos fichiers de paramètres. Lorsqu'il est défini, Claude Code envoie les requêtes de modèle à cette adresse au lieu de api.anthropic.com, donc une valeur résiduelle pointant vers un proxy local ou une passerelle qui ne fonctionne plus produit Connection refused même si curl atteint l'API. Supprimez-le de votre profil shell ou de vos paramètres et démarrez Claude Code à partir d'un nouveau terminal.
• Sur Linux et WSL, vérifiez /etc/resolv.conf pour 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 de tunnel ou une règle de routage. Vérifiez ifconfig pour les interfaces utun obsolètes et supprimez l'extension réseau du VPN dans les 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é.

Impossible de se connecter aux services Anthropic

Lors de la configuration initiale, Claude Code vérifie qu'il peut atteindre api.anthropic.com et platform.claude.com avant d'afficher l'étape de connexion. Lorsque l'une des vérifications échoue, Claude Code imprime la raison et se ferme.

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED
Connection to api.anthropic.com timed out after 10 seconds
A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.

Claude Code envoie la vérification via la même configuration proxy que les requêtes API et donne à chaque sonde 10 secondes. Lorsque la sonde échouée a traversé un proxy, le message nomme la variable d'environnement qui l'a configurée, comme HTTPS_PROXY. Avant la v2.1.222, la vérification utilisait un transport proxy différent sans délai d'expiration : derrière une URL proxy avec le schéma https://, elle pouvait se bloquer sur Checking connectivity... indéfiniment puis échouer même si les requêtes API via le même proxy réussissent.

Claude Code ignore cette vérification lorsqu'un fichier de paramètres gérés, une politique MDM ou un assistant de politique définit forceLoginMethod sur "gateway", ou définit forceLoginGatewayUrl sans forceLoginMethod. Avec l'une ou l'autre configuration, Claude Code ouvre l'étape de connexion sur l'écran Cloud gateway plutôt qu'une méthode de connexion Anthropic. Claude Code ignore également la vérification lorsqu'une source de paramètres gérés sur la machine existe mais ne peut pas être lue, car cette source peut contenir la configuration de la passerelle. Avant la v2.1.247, Claude Code exécutait la vérification sous cette configuration aussi, et se fermait avec cette erreur lorsque les points de terminaison d'Anthropic étaient inaccessibles.

À faire :

• Si le message nomme une variable proxy, vérifiez que sa valeur pointe vers le bon proxy et demandez à votre équipe réseau d'autoriser les connexions HTTPS via celui-ci vers l'hôte du message. Consultez Configuration réseau.
• Parcourez les vérifications dans Impossible de se connecter à l'API. Le test curl et les conseils de pare-feu là s'appliquent à cette vérification aussi.
• Si votre réseau est ouvert et l'échec persiste, Claude Code peut ne pas être disponible dans votre pays

Socket is closed

Socket is closed signifie que la connexion transportant une réponse en streaming a été fermée alors que la réponse arrivait toujours. La cause la plus courante est un proxy d'entreprise sur Windows qui abandonne un tunnel établi au milieu de la réponse.

Selon la progression de la réponse, Claude Code réessaye la requête, conserve ce que Claude a produit, ou termine le tour. Consultez Réessais automatiques.

Avant la v2.1.214, Claude Code ne réessayait pas cet échec, et le tour s'arrêtait avec une erreur contenant Socket is closed.

À faire :

• Si vous voyez cette erreur, mettez à jour vers v2.1.214 ou ultérieur avec claude update, puis renvoyez votre message
• Si les tours continuent d'échouer derrière le même proxy après la mise à jour, parcourez Impossible de se connecter à l'API et vérifiez la configuration du proxy dans Configuration réseau

L'API a retourné une réponse vide ou malformée

Claude Code affiche cette erreur lorsque sa nouvelle tentative sans streaming d'une requête en streaming échouée obtient un statut HTTP de succès mais le corps n'est pas un message API Claude : généralement une erreur HTML ou une page de connexion, un corps vide, ou du JSON dans un autre format. Un proxy, une passerelle ou une page de connexion réseau répondant à la place de l'API est la source habituelle. Claude Code ne réessaye pas la requête, et le tour se termine avec cette erreur.

API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.

Après cette ouverture, le message rapporte ce qui est revenu et quelle requête a échoué :

• Une clause Response: avec le type de contenu, le type de corps, comme body is an HTML page ou empty body, sa taille en octets, et si la réponse portait un id de requête Anthropic. Lorsque la réponse nomme un serveur reconnaissable, comme nginx ou cloudflare, ou porte des en-têtes intermédiaires, comme cf-ray ou via, la clause les liste aussi.
• Une phrase nommant l'id de la requête en streaming échouée et l'échec qui a déclenché la nouvelle tentative. Lorsqu'un flux s'était ouvert avant l'échec, il rapporte également combien d'événements de flux sont arrivés et, s'il y en avait, combien de temps le flux avait été silencieux lorsque la tentative a échoué.

Avant la v2.1.234, le message se terminait après intercepting the request.

Avant la v2.1.271, une réponse qui portait un message API valide sous un type de contenu non-JSON comme text/plain terminait également le tour avec cette erreur. Certaines passerelles LLM utilisent ce type de contenu pour la réponse sans streaming.

À faire :

• Lisez la clause Response: pour voir quel système a répondu. Un corps HTML, pas d'id de requête Anthropic, ou un serveur nommé comme nginx ou cloudflare signifie que quelque chose entre Claude Code et l'API a répondu à sa place
• Si vous routez via une passerelle LLM, testez la route avec une requête directe et corrigez le saut qui retourne la réponse non-API
• Sur un réseau avec une page de connexion, comme le Wi-Fi invité, complétez la connexion dans un navigateur, puis réessayez
• Si seule la route sans streaming via votre passerelle est cassée, définissez CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1 pour désactiver ce secours, sauf lorsque le point de terminaison en streaming lui-même retourne 404, où Claude Code se replie toujours

La réponse en streaming s'est terminée avant que des données complètes ne soient reçues

Une réponse en streaming de votre fournisseur de modèle s'est complétée sans livrer de données utilisables, donc Claude Code a renvoyé la requête sans streaming pour terminer le tour. Claude Code affiche l'avertissement une fois par session, dans les sessions interactives uniquement. Avant la v2.1.239, Claude Code réessayait silencieusement sans streaming.

Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.

Claude Code envoie chaque requête affectée deux fois : la tentative en streaming vide et la nouvelle tentative. La cause habituelle est un proxy ou une passerelle qui consomme ou transforme le corps de la réponse en streaming en chemin.

À faire :

• Configurez tout proxy ou passerelle entre Claude Code et votre fournisseur de modèle pour passer les corps de réponse en streaming et leurs en-têtes sans modification
• Sur Amazon Bedrock, consultez Erreurs de streaming derrière une passerelle ou un proxy pour les exigences d'en-tête et de corps

La réponse en streaming Bedrock a un content-type inattendu

Une passerelle ou un proxy entre Claude Code et Amazon Bedrock transforme le corps de la réponse en streaming ou son en-tête Content-Type. Amazon Bedrock diffuse les réponses en tant que application/vnd.amazon.eventstream. Plutôt que de décoder un corps qu'il ne peut pas lire, Claude Code rejette une réponse en streaming réussie qui rapporte un content-type différent. Claude Code ne réessaye pas la requête.

Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

Avant la v2.1.208, la même mauvaise configuration s'affichait comme API Error: Truncated event message received après que la réponse entière ait été mise en mémoire tampon.

À faire :

• Configurez la passerelle pour passer le corps de la réponse InvokeModelWithResponseStream et son en-tête Content-Type sans modification. Un intermédiaire qui réemet le flux en tant qu'événements envoyés par le serveur est une cause courante.
• Définir CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 masque cette erreur, mais Claude Code ne décode pas un corps binaire sous un en-tête réécrit, donc ces requêtes se replient sur un chemin plus lent sans streaming. Consultez Erreurs de streaming derrière une passerelle ou un proxy.

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 (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config

Avant la v2.1.273, les deux messages se terminaient à Check your proxy or corporate SSL certificates, sans le code OpenSSL ou l'indice NODE_EXTRA_CA_CERTS.

À 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 nouvelle tentative complet. Les versions antérieures passaient quelques minutes à réessayer avant de l'afficher. Les conditions TLS transitoires, comme un délai d'expiration de poignée de main, réessaient toujours.

Pendant /login et la vérification de connectivité au démarrage, la même défaillance produit un message différent :

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.

Sur Amazon Bedrock, les requêtes que Claude Code lui-même envoie à AWS, comme les appels de rôle STS et SSO, la découverte de modèle, et les vérifications de l'assistant de configuration, dépendent de la même configuration de certificat. Consultez Erreurs de certificat derrière un proxy qui inspecte TLS.

À faire :

• Exportez le bundle CA de votre organisation et pointez Claude Code vers celui-ci 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

L'hôte n'est pas 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. Les sessions cloud routent 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 à l'intérieur d'une VM en sandbox dont le trafic sortant via le réseau de la session est filtré selon la liste d'autorisation de l'environnement cloud ; les opérations GitHub et le trafic du connecteur MCP utilisent des canaux séparés, c'est pourquoi ils peuvent continuer à fonctionner tandis que d'autres hôtes sont bloqués. L'environnement Default utilise l'accès Trusted, qui permet 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 et bloque les autres domaines sur ce chemin.

À faire :

Ces étapes modifient l'un de vos propres environnements. Un environnement partagé par l'organisation s'ouvre en lecture seule dans le sélecteur, donc demandez à un propriétaire de modifier son accès réseau à partir de la page Cloud environments dans les paramètres d'administration.

• Ouvrez votre environnement pour l'édition, soit à partir du formulaire de routine, soit à partir du sélecteur d'environnement où vous démarrez les sessions cloud.
• Dans la boîte de dialogue Edit 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 voulez un accès sans restriction.
• Cliquez sur Save changes. La prochaine exécution utilise la liste d'autorisation mise à jour. Pour une session cloud qui est déjà ouverte, consultez quand une modification d'accès réseau atteint les sessions existantes.

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.

Le proxy a refusé la connexion

Vous voyez ce message lorsque Claude lit un artifact via le proxy que vous avez défini dans HTTPS_PROXY ou une variable proxy associée. Le contenu des artifacts provient de *.frame.claudeusercontent.com, donc Claude Code envoie d'abord au proxy une requête CONNECT lui demandant d'ouvrir un tunnel vers cet hôte. Lorsque le proxy refuse, rien n'atteint l'hôte, et le message porte le statut HTTP du proxy :

artifact content fetch failed (proxy refused the connection: HTTP 407)
artifact content fetch failed (proxy refused the connection: HTTP 403)
the proxy refused the connection to the artifact's content host (HTTP 502)

Le statut est la réponse du proxy au CONNECT. L'hôte n'a jamais répondu, donc chaque statut pointe vers un correctif différent :

• HTTP 407 : le proxy nécessite des identifiants qu'il n'a pas reçus. Mettez-les dans l'URL du proxy, comme Basic authentication le montre.
• HTTP 403 : le proxy refuse de tunneler vers *.frame.claudeusercontent.com. Demandez à celui qui gère le proxy d'autoriser cet hôte, que Network access requirements liste.
• Tout autre statut, comme HTTP 502 : le proxy n'a pas ouvert le tunnel pour sa propre raison, comme l'échec à atteindre l'hôte. Recherchez le statut dans les journaux du proxy.
• unreadable reply à la place d'un statut : tout ce qui se trouve à l'adresse du proxy n'a pas répondu avec une ligne de statut HTTP. Vérifiez que l'adresse est un proxy HTTP.

À faire :

• Vérifiez l'adresse et les identifiants dans la variable proxy, comme Proxy configuration le décrit, puis exécutez curl -x http://proxy.example.com:8080 -I https://api.anthropic.com à partir du shell dans lequel vous démarrez Claude Code, en utilisant votre propre URL de proxy. Sur Windows PowerShell, exécutez curl.exe. Si cette sonde échoue de la même manière, corrigez d'abord la configuration du proxy. Si elle réussit, le refus est spécifique à l'hôte des artifacts.
• Si votre réseau permet à Claude Code d'atteindre l'hôte des artifacts directement, ajoutez .frame.claudeusercontent.com à NO_PROXY. Gardez l'entrée étroite : une entrée .claudeusercontent.com plus large contourne également le proxy pour bridge.claudeusercontent.com, que les organisations avec IP allowlisting doivent garder sur le proxy.

Avant la v2.1.238, Claude Code rapportait un tunnel refusé comme une erreur réseau générique.

Le service des environnements cloud a retourné une réponse vide ou inattendue

Claude Code demande votre liste d'environnements cloud à plusieurs points, comme lorsque vous créez une session cloud à partir de la CLI ou exécutez /remote-env. Lorsqu'il ne peut pas lire la réponse du serveur, il affiche l'un de ces messages :

The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary — try again in a moment.

Le serveur a accepté la requête mais a répondu avec un corps qui n'est pas la liste des environnements : vide, pas JSON, ou JSON sans la liste. Cela accompagne généralement une perturbation côté service et s'efface de lui-même. Selon la surface qui a demandé la liste, Claude Code peut ajouter un préfixe, comme couldn't list environments: dans la boîte de dialogue /remote-env.

À faire :

• Réessayez l'action. Claude Code demande la liste à nouveau chaque fois
• Si le message continue d'apparaître, vérifiez status.claude.com pour les incidents actifs

Avant la v2.1.236, Claude Code affichait une TypeError JavaScript brute au lieu de ces messages.

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, comme 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.

À faire :

• Exécutez /remote-control pour réessayer la connexion
• Démarrez une nouvelle session avec claude --remote-control pour créer une nouvelle session Remote Control
• Pour les autres messages de démarrage Remote Control, consultez Troubleshoot Remote Control

Si le serveur rapporte à la place que la session précédente est partie, vous ne voyez pas ce message. Claude Code démarre une nouvelle session à sa place ou affiche Previous session is unavailable — run /remote-control to start a new one.

Les sessions se sont terminées alors que cette machine était hors ligne

Claude Code affiche ce message dans le terminal exécutant claude remote-control après que votre machine ait été hors ligne assez longtemps pour que le serveur nettoie l'environnement Remote Control que votre machine servait. Les sessions dans cet environnement se sont terminées, et vous ne pouvez pas les reprendre. Le nombre est le nombre de sessions qui se sont terminées.

2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.

À faire :

• Lorsque Claude Code liste les worktrees conservés sous ce message, récupérez tout travail non validé à partir d'eux
• Exécutez claude remote-control pour démarrer un environnement frais

Impossible de partager la transcription

Après que vous ayez accepté de partager votre transcription de session à partir d'une invite d'enquête, comme l'enquête de qualité de session, Claude Code la télécharge vers Anthropic, ou enregistre une archive locale à la place sur les fournisseurs tiers, sur les sessions de passerelle d'applications Claude, et lorsqu'aucun identifiant Anthropic n'est disponible. Ce message signifie que le partage ne s'est pas complété.

Couldn't share the transcript.

Le téléchargement doit tenir dans une limite de 8 MiB. Sur une longue session, Claude Code supprime progressivement des parties du partage, les paramètres du modèle de la dernière requête d'abord, puis la conversation structurée et les transcriptions des sous-agents, et affiche ce message uniquement lorsqu'aucune version réduite ne peut être envoyée ou qu'une erreur réseau ou serveur arrête le téléchargement. Lorsque Claude Code enregistre une archive locale à la place, le message signifie qu'il n'a pas pu écrire l'archive.

À faire :

• Exécutez /feedback pour envoyer la transcription avec une description de ce qui s'est passé. Consultez Report an error si /feedback n'est pas disponible dans votre environnement
• Si d'autres requêtes échouent aussi, vérifiez votre connexion réseau et consultez Impossible de se connecter à l'API

Impossible d'envoyer des commentaires

Vous avez envoyé un rapport à partir de la boîte de dialogue /feedback, /bug, ou /share et le téléchargement vers Anthropic a échoué. La boîte de dialogue conserve votre texte pour que vous puissiez réessayer.

Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

Le texte après le préfixe nomme ce qui a échoué :

• : not signed in. Run /login, then retry.: la boîte de dialogue télécharge uniquement lorsque Claude Code a trouvé des identifiants Anthropic à son ouverture, et aucun n'était utilisable au moment où vous avez envoyé. Par exemple, vous vous êtes déconnecté sur cette machine entre-temps, ou votre connexion n'a plus pu être actualisée.
• Une parenthèse: (server returned <status>) est le code de réponse du service ; (request timed out) et (couldn't reach the service) sont des défaillances réseau. Lorsque Claude Code ne peut pas nommer une raison, la parenthèse est absente.

Dans la file d'attente des brouillons de commentaires, la même défaillance se termine par The draft is still queued. Try again later. à la place, et le brouillon reste dans la file d'attente pour une autre tentative.

À faire :

• Pour le libellé non-connecté, exécutez /login et envoyez à nouveau
• Sinon, envoyez à nouveau ; si d'autres requêtes échouent aussi, vérifiez votre connexion réseau et consultez Impossible de se connecter à l'API
• Si cela continue d'échouer, déposez le rapport à github.com/anthropics/claude-code/issues, comme le message le dit

Avant la v2.1.281, chaque envoi échouait avec ce message une fois qu'un Stop Remote Control ou un message urgent entre sessions avait arrivé alors que la boîte de dialogue était ouverte. Sur ces versions, fermez la boîte de dialogue, rouvrez-la, et envoyez à nouveau.

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.

L'invite est trop longue

La conversation plus les fichiers joints dépasse la fenêtre de contexte du modèle.

Prompt is too long

Dans une session interactive, Claude Code affiche cette erreur comme :

Context limit reached · /compact or /clear to continue

La ligne nomme uniquement /clear quand DISABLE_COMPACT est défini. Les formes plus longues de l'erreur, comme la forme d'échec de compaction ci-dessous, conservent le libellé Prompt is too long ·. Dans la sortie -p et la transcription, le texte reste Prompt is too long.

Quand vous avez désactivé la compaction automatique dans vos paramètres utilisateur, la ligne dit aussi :

Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on

Le bouton Auto-compact dans /config écrit autoCompactEnabled dans les paramètres utilisateur. L'indice n'apparaît que quand une modification /config prendrait effet. Par exemple, il n'apparaît pas quand DISABLE_AUTO_COMPACT ou DISABLE_COMPACT a désactivé la compaction automatique. Il n'apparaît pas non plus quand une portée de priorité plus élevée, comme les paramètres de projet ou gérés, définit autoCompactEnabled à false. Avant v2.1.235, la ligne ne contenait aucun indice de compaction automatique.

Amazon Bedrock signale cette condition comme Input is too long for requested model., que Claude Code traite de la même manière. Avant v2.1.217, Claude Code ne reconnaissait pas le libellé Bedrock, donc la compaction automatique ne s'est jamais déclenchée et /compact a échoué avec la même erreur.

Une passerelle d'applications Claude signale cette condition comme capability_rejected: prompt_too_long quand une source cloud en amont rejette la requête dans la forme d'erreur propre du fournisseur. Claude Code traite le jeton de la même manière que Prompt is too long. Avant v2.1.228, Claude Code ne reconnaissait pas le jeton, donc la compaction automatique ne s'est pas déclenchée.

Quand la compaction automatique s'est exécutée sur ce tour et a échoué sur une erreur sous-jacente, comme un modèle indisponible ou une défaillance d'authentification, le message nomme cette erreur après un séparateur :

Prompt is too long · automatic compaction failed: <the underlying error>

Résolvez d'abord l'erreur nommée ; /compact échoue sur la même erreur jusqu'à ce que vous le fassiez. Avant v2.1.229, une compaction automatique échouée affichait Prompt is too long sans la cause.

Quand la compaction automatique s'exécute sur cette erreur, elle résume normalement vos échanges les plus anciens et conserve les plus récents. En dernier recours, Claude Code résume différemment :

• Quand il ne peut pas résumer un échange complet, Claude Code conserve votre invite la plus récente mot pour mot et résume tout ce qui la précède.
• Dans ce cas, quand la conversation ne se termine pas par votre invite, Claude Code résume la conversation entière à la place.

Claude Code ignore cette récupération quand le contenu qu'il porterait en avant ne contient aucune réponse du modèle et moins d'environ 1 000 jetons de votre propre texte, comme une courte nouvelle tentative envoyée après un collage surdimensionné. Exécutez /clear pour recommencer. Avant v2.1.269, la compaction échouait chaque fois qu'elle ne pouvait pas résumer un échange complet, donc une session dans cet état rencontrait cette erreur à chaque tour.

Une conversation à un seul échange n'a pas de tours antérieurs à résumer. Quand la compaction automatique aurait dû s'exécuter sur un, Claude Code ignore la tentative et explique ce qui remplit la requête à la place. Quand l'API ne signale pas les nombres de jetons dans son erreur, le message se lit :

Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.

Quand l'API signale les nombres de jetons dans son erreur, Claude Code les compare avec sa propre estimation de la taille de la conversation pour dire lequel est la majorité de la requête : le contenu propre de la conversation, ou le contenu du message système, des définitions d'outils et des pièces jointes que Claude Code envoie avec. Quand le contenu propre de la conversation est la majorité de la requête, le message se lit :

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).

Quand la majorité de la requête est en dehors de la conversation, le message se lit :

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.

Avant v2.1.162, Claude Code tentait la compaction de toute façon et affichait le Prompt is too long nu quand il échouait.

Que faire :

• Exécutez /compact pour résumer les tours antérieurs et libérer de l'espace, ou /clear pour recommencer. Si /compact répond Not enough messages to compact., la conversation est un échange unique sans rien d'antérieur à résumer, donc l'espace est occupé par cette invite et ce que Claude Code envoie avec chaque requête : exécutez /clear et renvoyez avec moins de texte collé ou des pièces jointes plus petites, ou réduisez les définitions d'outils et les fichiers mémoire en utilisant les étapes ci-dessous
• Exécutez /context pour voir une ventilation de ce qui consomme la fenêtre : message 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.md volumineux, ou déplacez les instructions dans les règles à portée de chemin qui se chargent uniquement quand pertinent
• La compaction automatique est activée par défaut et prévient normalement cette erreur. Si vous l'avez désactivée dans /config ou avec DISABLE_AUTO_COMPACT, réactivez-la. Si vous la gardez désactivée, exécutez /compact vous-même avant que la fenêtre se remplisse.

Voir Explorez la fenêtre de contexte pour une vue interactive de la façon dont le contexte se remplit.

Le contexte dépasse la limite de jetons

/context affiche cet avertissement en haut de sa sortie quand la conversation a dépassé la fenêtre de contexte du modèle. Les requêtes échouent avec Prompt is too long jusqu'à ce que vous libériez de l'espace. Une session interactive affiche cette erreur comme la ligne Context limit reached.

Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.

Quand la limite que vous avez dépassée est une fenêtre de compaction, comme la limite 200K sur les modèles 1M-contexte, l'avertissement se lit différemment. Une fenêtre de compaction peut se situer en dessous de la fenêtre de contexte du modèle, donc les requêtes au-delà peuvent encore réussir.

Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.

Les deux formes nomment /clear au lieu de /compact quand vous avez défini DISABLE_COMPACT.

Que faire :

• Dans une conversation multi-tours, exécutez /compact pour résumer les tours antérieurs et libérer de l'espace. Pour recommencer à la place, exécutez /clear
• Pour plus de façons de réduire l'utilisation, voir L'invite est trop longue

Avant v2.1.216, /context affichait l'utilisation au-dessus de 100 % sans ligne d'avertissement expliquant ce que cela signifiait ou comment récupérer.

Requête trop grande

Le corps de la requête brute a dépassé la limite de 32 Mo de l'API avant la tokenisation, généralement en raison de contenu collé volumineux, de résultats d'outils ou de pièces jointes. Cette limite est distincte de la fenêtre de contexte.

Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.

Quand la requête est allée directement à l'API Claude et que l'API elle-même l'a rejetée, Claude Code mesure la conversation et formule le message selon que la récupération peut fonctionner. Via un proxy, une passerelle ou un fournisseur cloud, vous obtenez le message général. Les formes mesurées :

• Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents). : les images ou documents ont poussé la requête au-delà de la limite. Claude Code réessaie en les supprimant.
• Request too large for the API's 32MB request limit : les messages seuls dépassent la limite, donc le message dit compacting cannot make it fit et Claude Code ne réessaie pas. En mode non-interactif, le message vous dit de réduire l'entrée ou de démarrer une nouvelle session à la place.

Avant v2.1.212, les conversations avec assez d'images accumulées échouaient à chaque tour avec Request too large (max 32MB). Double press esc to go back and try with a smaller file. Avant v2.1.229, Claude Code affichait le conseil sur les pièces jointes pour chaque rejet, même quand la compaction ne pouvait pas aider.

Que faire :

• Si le message dit compacting cannot make it fit, appuyez deux fois sur Échap pour revenir en arrière au-delà du tour qui a ajouté le contenu volumineux, ou exécutez /clear pour recommencer
• Sinon, exécutez /compact, qui supprime les images et pièces jointes accumulées
• 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, voir L'image était trop grande ci-dessous

L'image était trop grande

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

Claude Code remplace l'image non traitée par un espace réservé textuel et réessaie, donc 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 revenir en arrière au-delà du tour où l'image a été ajoutée.

Que 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 quand 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.
Unable to resize image — it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
Unable to resize image — it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.

Claude Code redimensionne normalement les grandes images automatiquement. Ces erreurs signifient que l'image n'a pas pu être décodée ou redimensionnée pour tenir dans les limites de l'API.

Que 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 pour ces formats à partir de l'en-tête du fichier, sans décoder l'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.
• Si le message nomme une cause, comme un JPEG CMYK, un WebP animé ou un fichier possiblement endommagé, réenregistrez l'image dans le format que le message suggère et joignez-la à nouveau.

Erreurs PDF

Le PDF que vous avez joint n'a pas pu être traité. Les messages sont affichés ici dans leur forme non-interactive ; dans une session interactive, ils vous invitent plutôt à appuyer deux fois sur Échap et à réessayer.

PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
PDF is password protected. Try using a CLI tool to extract or convert the PDF.
The PDF file was not valid. Try converting it to text first (e.g., pdftotext).

Que 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 pdftotext et 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

Quand Claude lit une plage de pages à partir d'un PDF avec l'outil Read, la lecture peut échouer avec un message différent :

pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.

Les lectures de plage de pages rendent les pages avec pdftoppm. Installez poppler-utils avec la commande que le message donne, ou sur d'autres plates-formes une version poppler qui met pdftoppm sur votre PATH. Voir Comportement de l'outil Read pour savoir quels PDF sont lus par plage de pages.

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, donc l'API a rejeté les champs qui en dépendent.

API Error: 400 ... Extra inputs are not permitted ... context_management

Claude Code envoie des champs réservés aux bêtas, comme context_management, accompagnés d'un en-tête anthropic-beta qui les active. Quand une passerelle transfère le corps mais supprime l'en-tête, l'API voit des champs qu'elle ne reconnaît pas.

Que faire :

• Configurez votre passerelle pour transférer l'en-tête anthropic-beta. Voir transmission de fonctionnalités pour ce que les passerelles doivent transférer.
• En dernier recours, définissez CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 avant de lancer. Désactiver les capacités de pré-version couvre la portée exacte.

Le schéma d'entrée de l'outil est invalide

Un outil dans la requête a déclaré un input_schema qui échoue la validation JSON Schema de l'API, donc l'API a rejeté la requête entière. Le nombre après tools. est la position de l'outil défaillant dans la liste d'outils de la requête, pas un nom que vous pouvez rechercher.

API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'

La première forme signifie que le schéma n'est pas un brouillon JSON Schema valide 2020-12. La seconde signifie qu'un nom de propriété de niveau supérieur ne correspond pas au motif que le message cite.

Claude Code exclut les outils MCP dont le schéma d'entrée échouerait cette validation quand il charge les outils d'un serveur, donc les requêtes ne contiennent normalement jamais un.

Sur un déploiement où la récupération de drapeaux est désactivée, ou sur une machine dont les drapeaux ne sont jamais arrivés, Claude Code enregistre dans le journal du serveur quel outil serait rejeté mais l'envoie de toute façon, donc cette erreur peut toujours se produire.

L'erreur peut aussi se produire pour un outil dont le schéma déclare un dialecte JSON Schema autre que le brouillon 2020-12 dans $schema. Claude Code ne vérifie pas ces schémas par rapport au méta-schéma JSON Schema, bien que la vérification du nom de propriété de niveau supérieur s'applique toujours.

Avant v2.1.216, aucun déploiement n'exécutait les vérifications d'exclusion.

Que faire :

• Si votre version de Claude Code est antérieure à v2.1.216, exécutez claude update.
• Supprimez ou désactivez le serveur MCP qui déclare le schéma invalide. L'erreur nomme l'outil uniquement par position. Sur v2.1.216 ou ultérieur, vérifiez le journal de chaque serveur pour une ligne nommant un outil dont le schéma d'entrée serait rejeté. Si aucun journal n'en nomme un, désactivez les serveurs un par un.
• Si vous maintenez le serveur, corrigez le input_schema de l'outil. Le schéma doit être un JSON Schema valide, et les noms de propriété de niveau supérieur doivent faire 1 à 64 caractères et utiliser uniquement des lettres ASCII et des chiffres, _, . et -. Voir Outils avec schémas d'entrée invalides.

tool\_use.name dépasse 200 caractères

Un appel d'outil dans l'historique de conversation porte un nom plus long que les 200 caractères que l'API accepte dans une requête :

API Error: 400 ... tool_use.name: String should have at most 200 characters

Claude Code coupe un tel nom à 200 caractères quand la réponse arrive et quand il charge une conversation enregistrée, donc l'appel échoue avec une erreur d'outil ordinaire No such tool available et la conversation continue sans cette erreur API.

Que faire :

• Exécutez claude update, puis reprenez la conversation. La version mise à jour répare le nom trop long quand elle charge la transcription, donc une conversation qui était bloquée fonctionne à nouveau.

Avant v2.1.281, le nom trop long restait dans l'historique et l'API rejetait chaque requête qui renvoyait la conversation, y compris /compact et --resume, donc cette erreur se répétait et la conversation était bloquée.

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, affiché ici dans 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.

Que faire :

• CLI interactif : exécutez /model pour choisir parmi les modèles disponibles pour votre compte.
• Mode non-interactif (-p) : passez --model avec un alias ou un ID valide, ou définissez ANTHROPIC_MODEL. Le texte d'erreur affiche Run --model sur cette surface.
• Agent SDK : le texte d'erreur omet l'indice car le modèle est défini par programmation. Définissez model sur Options en TypeScript ou ClaudeAgentOptions(model=...) en Python, et gérez l'erreur structurée model_not_found pour afficher votre propre nouvelle tentative ou sélecteur de modèle.
• Utilisez un alias comme sonnet ou opus au lieu d'un ID complet versionné. Les alias se résolvent à une valeur par défaut maintenue afin qu'ils ne deviennent pas obsolètes. Voir Configuration du modèle.
• Si le mauvais modèle continue de revenir dans le CLI, un ID obsolète est défini quelque part. Vérifiez les endroits où vous pouvez définir un modèle dans l'ordre de priorité et supprimez la valeur obsolète.
• Claude Code signale une connexion claude.ai expirée comme Connexion expirée, pas comme cette erreur. Avant v2.1.206, une connexion expirée qui ne pouvait plus être actualisée échouait chaque modèle avec cette erreur ; exécutez /login si vous voyez cela sur une version plus ancienne.
• Pour les déploiements de la plateforme d'agent de Google Cloud, voir Dépannage de la plateforme d'agent de Google Cloud.

Le modèle n'est pas un ID de modèle reconnu

La chaîne que vous avez passée à un changement de modèle n'est pas un alias de modèle, un ID de modèle que Claude Code peut utiliser, donc il a refusé le changement sans envoyer de requête et la session garde son modèle actuel. Vous pouvez obtenir cette erreur quand un modèle est défini via la méthode Agent SDK setModel(), par une application qui exécute le CLI Claude Code pour vous, comme l'application de bureau, ou quand vous choisissez un modèle à partir d'un appareil connecté via Contrôle à distance. 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 "Sonnet5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

Dans cet exemple, une application a envoyé le nom d'affichage Sonnet 5, que le message répète sans son espace. L'indice de fin nomme l'alias ou l'ID de modèle le plus proche. Quand rien n'est assez proche, il se lit Run /model to see available models. à la place. Dans une session que l'application de bureau démarre pour vous, l'indice sans correspondance se lit Switch to a different model.

Quand vous basculez via l'Agent SDK ou une application sur l'API Anthropic, seule une chaîne qui ne peut pas être un ID de modèle obtient cette erreur, comme un nom d'affichage ou une chaîne vide.

Quand vous choisissez un modèle à partir d'un appareil de contrôle à distance, Claude Code vérifie la chaîne localement. Toute chaîne qui n'est pas un alias de modèle, un modèle que Claude Code liste ou que vous avez configuré, ou un ID qui commence par claude- obtient cette erreur, un ID mal tapé comme claud-sonnet-5 inclus. Avant v2.1.260, cette vérification ne couvrait pas les choix de contrôle à distance, donc une chaîne non reconnue était appliquée et échouait à la requête suivante.

Que faire :

• Exécutez /model sans argument pour ouvrir le sélecteur et choisir parmi les modèles disponibles pour votre compte, puis passez 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, ou passez l'ID complet du modèle à la place. Le serveur peut toujours exiger une version minimale de Claude Code pour ce modèle ; voir Claude Code ne supporte pas ce modèle.
• Un modèle enregistré avant v2.1.200 n'est pas réparé par cette vérification. Si une valeur obsolète continue de revenir, supprimez-la des emplacements listés sous Définir votre modèle.
• Sur tout fournisseur autre que l'API Anthropic, ou derrière une passerelle ou un ANTHROPIC_BASE_URL personnalisé, seule une chaîne vide obtient cette erreur. Claude Code peut toujours écrire la ligne de diagnostic de modèle non reconnu au moment de la requête, sur chaque fournisseur.

Modèle non trouvé

Vous avez choisi un modèle par nom et Claude Code n'a pas pu confirmer qu'un modèle avec ce nom existe. Quand le nom n'est pas un alias de modèle ou une autre orthographe que Claude Code accepte localement, Claude Code le vérifie avec une requête API minimale, et cette erreur est généralement la réponse de votre point de terminaison API. Avec /model <name>, un nom qui ne peut pas du tout être un ID de modèle, comme un contenant des espaces, obtient le même message.

Model 'claude-opus-9' not found

Sur les fournisseurs avec des ID de modèle spécifiques au fournisseur, le message peut ajouter une suggestion Try '...' instead qui nomme l'ID de votre fournisseur pour un modèle de secours.

Que faire :

• Exécutez /model sans argument et choisissez parmi les modèles disponibles pour votre compte, ou utilisez un alias de modèle comme sonnet, qui se résout à une valeur par défaut maintenue
• Si vous avez tapé un ID complet, vérifiez-le par rapport au catalogue de modèles de votre fournisseur. Un modèle nouvellement lancé peut être disponible sur l'API Anthropic avant que votre fournisseur ou région ne l'offre.
• Dans l'Agent SDK, setModel() échoue avec ce message et la session continue de s'exécuter sur son modèle précédent. Dans le SDK TypeScript, appelez supportedModels() pour lister les modèles vers lesquels vous pouvez basculer.
• Avant v2.1.265, /model rejetait aussi l'orthographe d'alias opusplan[1m] avec cette erreur. Sur ces versions, mettez à jour Claude Code, ou définissez le modèle dans paramètres ou avec --model à la place.

Impossible de confirmer le modèle avec l'API

Vous avez basculé les modèles via la méthode Agent SDK setModel() ou une application qui exécute le CLI Claude Code pour vous, comme l'application de bureau, et la requête qui confirme l'ID du modèle avec votre point de terminaison API n'a pas reçu de réponse dans les cinq secondes. La session garde son modèle actuel.

Couldn't confirm model "claude-sonnet-5" with the API. Try again, or run /model to see available models.

Dans une session que l'application de bureau démarre pour vous, le message se termine à Try again.

Que faire :

• Basculez vers le modèle à nouveau
• Si le basculement continue d'échouer, vérifiez que Claude Code peut atteindre votre point de terminaison API ; voir Erreurs de réseau et de connexion

Erreur API lors de la vérification du modèle choisi

Vous avez choisi un modèle avec /model <name>, ou une application connectée à la session a demandé le changement. L'API a refusé la requête minimale que Claude Code envoie pour vérifier le modèle, pour une raison qui n'a pas d'entrée propre, comme une limite de débit ou une erreur serveur. La session garde son modèle actuel, et le message se termine en disant ainsi :

API error: 429 <the server's explanation> · model not changed

Le milieu du message est le statut HTTP et l'explication propre du serveur.

Que faire :

• Agissez sur l'explication du serveur ; pour une limite de débit ou un statut 5xx, attendez et choisissez le modèle à nouveau
• Les refus avec leur propre libellé sont couverts par les entrées environnantes, comme Modèle non trouvé et Le modèle est restreint par les paramètres de votre organisation

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. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.

Dans une session que l'application Claude Desktop exécute, le message dit de sign out and sign in again au lieu de nommer les commandes.

Que faire :

• Exécutez /model et sélectionnez un modèle que votre plan inclut
• Si vous avez mis à niveau votre plan récemment et voyez toujours cela, exécutez /logout puis /login. Le jeton stocké reflète votre plan au moment où vous vous êtes connecté, donc la mise à niveau sur claude.ai ne prend effet dans une session existante que jusqu'à ce que vous vous réauthentifiiez.
• Voir claude.com/pricing pour savoir quels modèles chaque plan inclut

Claude Code ne supporte pas ce modèle

L'API a refusé la requête avec un 400 parce que votre version de Claude Code est en dessous d'un minimum requis. Soit le modèle que vous avez sélectionné nécessite une version plus récente, que le serveur vérifie par modèle, soit la politique de votre organisation en nécessite une. Le 400 porte le code d'erreur claude_code_version_too_old, et le message dit quel minimum s'applique.

API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.

Le libellé de la politique organisationnelle se lit :

API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.

La version que l'API vérifie est celle signalée par le binaire Claude Code qui a fait la requête.

Que faire :

Mettez à jour ce binaire, puis démarrez une nouvelle session. D'où le binaire provient décide comment, sauf dans un environnement auto-hébergé :

• Pour le libellé par modèle, vous pouvez continuer à travailler dans la session actuelle en basculant vers un autre modèle : exécutez /model dans le CLI, appelez setModel() sur l'objet Query du SDK TypeScript en mode d'entrée en continu, ou appelez set_model() sur le ClaudeSDKClient du SDK Python
• Pour le libellé de la politique organisationnelle, mettez à jour avant de continuer

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 les paramètres gérés l'excluent via une liste d'autorisation availableModels ou une liste deniedModels. L'avis apparaît au démarrage quand --model, ANTHROPIC_MODEL ou le paramètre model a nommé le modèle restreint, et il nomme le modèle que la session utilise à la place. Si les paramètres gérés ne laissent aucun modèle autorisé pour la session à utiliser, voir Les paramètres gérés bloquent le modèle par défaut. L'avis de substitution peut aussi apparaître en milieu de session après qu'un administrateur désactive le modèle sur lequel une session s'exécute dans la console d'administration claude.ai.

Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

Taper /model <name> pour un modèle restreint est rejeté et la session garde son modèle actuel. Pour un modèle désactivé dans la console d'administration, le rejet se lit Model '<name>' is restricted by your organization's settings. Run /model to choose a different model. Pour un modèle que les paramètres gérés excluent, il se lit Model '<name>' is not available. Your organization restricts model selection.

Un avis préfixé avec un nom d'agent, de compétence ou de commande signifie que la restriction s'appliquait au modèle demandé du sous-agent : le sous-agent s'exécute sur le modèle substitué et le modèle de votre session est inchangé. Avant v2.1.223, Claude Code affichait l'avis uniquement pour les sous-agents lancés avec l'outil Agent.

Claude Code traite un alias de famille de modèles, l'un de opus, sonnet, haiku ou fable, comme une demande pour cette famille plutôt que pour 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 les paramètres de votre organisation permettent, et l'avis de substitution nomme cette version. Claude Code rejette /model <alias> uniquement quand 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 quand une version plus ancienne de la même famille était autorisée.

Que faire :

• Exécutez /model pour 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, le champ model d'un fichier de paramètres, ou le frontmatter model d'un sous-agent, d'une compétence ou d'une commande, supprimez ou mettez à jour cette valeur afin que l'avis ne se reproduise pas
• Si vous avez besoin d'accès au modèle restreint, demandez à votre administrateur d'organisation de l'activer. Voir Restrictions de modèle organisationnel.

Impossible de basculer vers le modèle par défaut

Vous avez choisi le modèle par défaut, par exemple en sélectionnant la ligne Par défaut dans le sélecteur /model ou en tapant /model default. Claude Code a refusé le changement, donc la session garde son modèle actuel.

Can't switch to the default model: your organization's managed settings block it (claude-opus-4-6) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".

Le libellé après le deux-points nomme ce qui a bloqué le changement :

• your organization's managed settings block it ... in "deniedModels" : une liste de refus gérée bloque le modèle auquel l'option Par défaut se résout
• your organization allows only the models listed in "availableModels" : une liste d'autorisation availableModels gérée avec availableModelsMatch défini à "exact" laisse de côté le modèle auquel l'option Par défaut se résout
• Claude Code couldn't read your organization's managed settings to check which models they allow : les paramètres gérés n'ont pas pu être lus, et Claude Code refuse le changement plutôt que de l'appliquer non vérifié

Que faire :

• Pour les libellés deniedModels et availableModels, exécutez /model et choisissez un modèle que votre organisation autorise par nom
• Demandez à votre administrateur de mettre à jour le paramètre géré que le message nomme
• Pour le libellé couldn't read, redémarrez Claude Code ; si cela continue de se produire, demandez à votre administrateur de vérifier les paramètres gérés

Si une session échoue plutôt à démarrer avec un message Claude Code can't start sous ces paramètres gérés, voir Les paramètres gérés bloquent le modèle par défaut.

Le changement de modèle a été bloqué par un hook PreModelSwitch

Un hook PreModelSwitch n'a pas approuvé le changement de modèle que vous ou un client avez demandé, donc la session garde son modèle actuel. Quand le changement provenait d'un hôte Agent SDK ou Contrôle à distance plutôt que d'une commande que vous avez tapée, le message se lit Model switch blocked by a PreModelSwitch hook sans nommer le modèle cible.

Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.

La raison après le deux-points dit ce qui a refusé le changement :

• Une raison qu'un hook a écrite : un hook PreModelSwitch a fourni cette raison quand il a refusé le changement ou demandé une confirmation. Adressez ce qu'il demande, ou choisissez un modèle que vos hooks autorisent.
• PreModelSwitch hook <name> did not respond before its timeout : un hook qui ne répond pas avant son délai d'expiration bloque le changement. Corrigez la commande qui pend ou augmentez le timeout de ce hook, puis changez à nouveau.
• confirmation required, and this session cannot ask : un hook a répondu ask sans raison, et une demande de contrôle n'a aucun moyen d'afficher l'invite de confirmation. Un changement /model dans une exécution -p signale la même condition avec (run /model interactively to confirm) après la raison. Effectuez le changement à partir d'une session interactive, ou changez la décision du hook pour ce modèle.
• so organization-managed PreModelSwitch hooks could not be checked : Claude Code n'a pas pu dire quels hooks PreModelSwitch vos plugins gérés d'organisation livrent, par exemple parce qu'un plugin géré n'a pas pu se charger. L'un de ces hooks pourrait bloquer le changement, donc Claude Code refuse plutôt que d'appliquer le changement non vérifié. Le début de la raison nomme ce qui a échoué. Claude Code re-vérifie à chaque tentative de changement, donc une défaillance qui a depuis été effacée cesse de bloquer ; si elle continue d'échouer, exécutez claude --debug et changez à nouveau pour capturer les détails, puis corrigez le plugin ou demandez à votre administrateur de le corriger.
• a PreModelSwitch hook failed before answering ou PreModelSwitch hooks were cancelled (the control stream closed) before answering : l'exécution du hook s'est terminée sans verdict, et Claude Code ne traite pas cela comme une approbation. Exécutez claude --debug pour voir ce qui a échoué, puis changez à nouveau.

Avant v2.1.260, le refus du plugin géré se lisait plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log. Claude Code a réessayé le chargement du plugin une fois puis a refusé les changements ultérieurs dans la session, même quand votre organisation ne gérait aucun plugin. Redémarrez la session pour exécuter le chargement du plugin à nouveau sur ces versions.

Impossible de l'enregistrer comme valeur par défaut

Vous avez choisi un modèle à enregistrer comme valeur par défaut, par exemple avec /model <name> ou Entrée dans le sélecteur /model, et Claude Code n'a pas pu écrire le choix dans votre fichier de paramètres utilisateur, ~/.claude/settings.json. Le changement lui-même s'est appliqué, donc la session actuelle s'exécute sur le modèle que vous avez choisi, mais votre valeur par défaut est inchangée et la session suivante démarre sur l'ancienne valeur.

Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)

La raison après le chemin du fichier dit ce qui a échoué :

• can't be written (<code>) : l'écriture a échoué avec le code d'erreur du système d'exploitation entre parenthèses, comme EROFS quand le fichier, ou le fichier auquel il se lie, se trouve sur un système de fichiers qui refuse les écritures. Rendez le fichier inscriptible et changez à nouveau. Si un autre outil génère le fichier, définissez la clé model dans cet outil à la place ; voir Un changement que vous avez fait dans Claude Code est perdu dans les nouvelles sessions.
• isn't valid JSON : le fichier sur le disque ne s'analyse pas, et Claude Code le laisse intact plutôt que de remplacer le contenu qu'il ne peut pas relire. Corrigez l'erreur de syntaxe, puis changez à nouveau ; voir Corriger un fichier de paramètres cassé.

Un avis se terminant par couldn't confirm it was saved as your default (~/.claude/settings.json is still being written) signifie que l'écriture n'avait pas terminé après trois secondes. Elle continue en arrière-plan, donc la valeur par défaut peut toujours être enregistrée ; vérifiez quel modèle votre session suivante démarre, ou exécutez /model <name> à nouveau.

Avant v2.1.265, l'avis disait que le modèle était saved as your default for new sessions même quand l'écriture a échoué.

thinking.type.enabled n'est pas supporté pour ce modèle

Votre version de Claude Code est plus ancienne que le minimum pour le modèle sélectionné. Le 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.

Que faire :

• Exécutez claude update et 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. Opus 5 nécessite v2.1.219 ou ultérieur. Opus 5.5 nécessite v2.1.280 ou ultérieur. Sonnet 5.5 nécessite v2.1.284 ou ultérieur
• Si vous ne pouvez pas mettre à jour, exécutez /model et sélectionnez Opus 4.6 ou Sonnet 4.6 à la place
• Si vous rencontrez cela dans l'Agent SDK, mettez à jour 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. Opus 5 nécessite TypeScript SDK v0.3.219 ou ultérieur. Opus 5.5 nécessite TypeScript SDK v0.3.280 ou ultérieur. Sonnet 5.5 nécessite TypeScript SDK v0.3.284 ou ultérieur

L'effort n'est pas disponible avec la réflexion désactivée

Vous avez désactivé la réflexion étendue et avez exécuté à un niveau d'effort au-dessus de high. Le modèle n'accepte pas cette combinaison, donc l'API a rejeté la requête.

API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)

L'indice après le · varie selon la session : dans une session non-interactive, il se lit use --effort high (or the effortLevel setting), et dans une session que l'application Claude Desktop exécute, il se lit you can lower effort to High.

Que faire :

• Abaissez le niveau d'effort à high ou en dessous.
• Réactivez la réflexion, par exemple en désactivant MAX_THINKING_TOKENS ou en supprimant "alwaysThinkingEnabled": false de vos paramètres.

Avant v2.1.242, Claude Code affichait le message propre de l'API : API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking. Avant v2.1.251, Claude Code envoyait la requête au niveau d'effort que vous avez défini, donc Opus 5 rejetait chaque requête au-dessus de high avec la réflexion désactivée. Claude Code envoie maintenant l'effort high à la place aux modèles qu'il sait rejeter la combinaison, comme Opus 5.

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, donc il n'y a pas de place pour la réponse réelle.

API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

Que faire :

• Augmentez CLAUDE_CODE_MAX_OUTPUT_TOKENS au-dessus du budget de réflexion
• Voir Réflexion étendue pour la façon dont 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.

API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation.
API Error: 400 duplicate tool_use ID in conversation history. 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

Tous les 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.

Que faire :

• 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 /rewind ne 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à. Voir Points de contrôle pour la façon dont les points de contrôle sont créés et restaurés.

Données invalides dans le bloc redacted\_thinking

L'API a refusé la requête avec un 400 parce qu'elle ne pouvait pas accepter un bloc redacted_thinking qu'un tour antérieur dans l'historique de conversation porte.

API Error: 400 ... Invalid `data` in `redacted_thinking` block

Claude Code laisse la réflexion antérieure de la conversation en dehors de la requête et réessaie une fois, donc la session continue sans afficher l'erreur. Avant v2.1.282, Claude Code gardait le bloc refusé, et chaque tour ultérieur échouait avec la même erreur.

Que faire :

• Si vous êtes sur v2.1.281 ou antérieur et chaque tour échoue avec cette erreur, exécutez claude update et reprenez la session
• Si l'erreur persiste, exécutez /clear pour démarrer une conversation qui ne porte pas le bloc

Contenu d'outil non supporté supprimé

Quand Claude Code se connecte directement à l'API Anthropic et charge ou prévisualise une session enregistrée, il supprime le contenu d'outil que l'API Anthropic n'accepte pas et laisse cette ligne où le contenu supprimé s'asseyait entre deux blocs de réflexion :

[Unsupported tool content removed]

Un tel contenu atteint un fichier de session quand quelque chose d'autre que l'API Anthropic a répondu dans le format de l'API, généralement un proxy tiers défini via ANTHROPIC_BASE_URL qui traduit les appels d'outils d'un autre fournisseur. Claude Code le supprime uniquement quand la session se connecte directement à l'API Anthropic, et charge l'historique enregistré tel qu'il est quand la session s'exécute via un proxy ou sur un autre fournisseur. Avant v2.1.246, Claude Code renvoyait l'utilisation d'outil et son résultat à l'API, et chaque tour de la session reprise échouait avec une erreur 400 comme messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ....

Que faire :

• Aucune action nécessaire quand vous voyez la ligne d'espace réservé. La session continue sans le contenu supprimé.
• Si chaque tour d'une session reprise échoue avec l'erreur 400 à la place, exécutez claude update et reprenez la session à nouveau. Les versions antérieures à v2.1.246 ne suppriment pas le contenu.

role 'system' doit précéder un message 'assistant'

L'API a refusé la requête avec un 400 parce qu'un message système se trouve à une position dans la conversation qu'elle n'accepte pas :

API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...

Claude Code envoie une partie de son texte de rappel et de pièce jointe comme des messages système à l'intérieur de la conversation. Quand l'API refuse la position d'un, Claude Code réessaie la requête une fois avec ce texte envoyé comme des messages utilisateur ordinaires à la place. Les libellés de placement frère de l'API, comme use the top-level 'system' parameter for the initial system prompt, obtiennent la même récupération.

Quand l'erreur apparaît, le message système refusé n'est pas un que Claude Code peut supprimer. Cela signifie généralement qu'un proxy ou une passerelle LLM entre Claude Code et l'API a ajouté un message système de son propre ou réordonné la conversation.

Que faire :

• Si l'erreur se répète à chaque tour derrière un proxy ou une passerelle configurée via ANTHROPIC_BASE_URL, connectez-vous sans le proxy pour confirmer la source, et signalez l'erreur à celui qui l'exploite
• Exécutez /clear pour démarrer une conversation nouvelle. Si l'erreur revient là aussi, la cause est sur le chemin de la requête, pas dans la conversation enregistrée.

Avant v2.1.280, Claude Code ne reconnaissait pas ce libellé, donc l'erreur apparaissait aussi quand le message système refusé était un que Claude Code lui-même envoyait, et chaque tour ultérieur de la conversation échouait de la même manière.

Contenu chiffré invalide dans le bloc search\_result

L'API a refusé la requête avec un 400 parce que l'historique de conversation contient du contenu de recherche web hébergé qu'elle ne peut pas déchiffrer. Le libellé nomme le champ qu'elle ne peut pas lire :

API Error: 400 ... Invalid `encrypted_content` in `search_result` block
API Error: 400 ... Invalid `encrypted_index` in `text` block
API Error: 400 ... Failed to decrypt web search result content
API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block

Les résultats de l'outil de recherche web hébergé de l'API portent des champs chiffrés que seule l'API peut lire. L'encrypted_stdout nomme la sortie d'un programme d'exécution de code hébergé qui a lu de tels résultats, que l'API chiffre aussi. L'API refuse une requête qui rejoue du contenu qu'elle ne peut pas déchiffrer, comme du contenu produit pour une organisation différente.

L'outil WebSearch propre de Claude Code enregistre les résultats de recherche en texte brut, donc ces blocs atteignent généralement une conversation via un proxy ou une passerelle LLM qui a exécuté la recherche web hébergée elle-même.

Pour les trois libellés de recherche web, Claude Code laisse les appels de recherche, les résultats et les citations en dehors de ce qu'il envoie et réessaie la requête une fois, donc la session continue sans afficher l'erreur. Le libellé encrypted_stdout n'a pas une telle récupération, donc ce message vous atteint toujours. Avant v2.1.282, Claude Code gardait aussi les blocs de recherche web refusés, et chaque tour ultérieur et /compact échouaient de la même manière.

Que faire :

• Si vous êtes sur v2.1.281 ou antérieur et chaque tour échoue avec l'un des libellés de recherche web, exécutez claude update et reprenez la session
• Si l'erreur persiste, ou le message nomme encrypted_stdout, exécutez /rewind pour revenir à un point de contrôle avant le tour qui a ajouté le contenu, ou exécutez /clear pour démarrer une conversation qui ne le porte pas
• Si vous exécutez Claude Code derrière un proxy ou une passerelle, signalez l'erreur à celui qui l'exploite

Refus de la politique d'utilisation

L'API a refusé de répondre parce que le contenu de la conversation a déclenché une vérification de la Politique d'utilisation.

Le message inclut un ID de requête et un ID de message que vous pouvez citer au support si vous pensez que le refus est incorrect.

API Error: Opus 4.6 can't help with this. Start a new session to continue.

Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup

Le message nomme le modèle qui a refusé, ou Claude quand aucun modèle n'est enregistré.

La vérification évalue la conversation complète, pas seulement votre invite la plus récente, donc envoyer un nouveau message dans la même session réactive généralement le même refus. La même chose s'applique après la sortie et la réouverture de la session avec --continue ou --resume, puisque la transcription sur le disque contient toujours le contenu déclencheur. Sur Amazon Bedrock, la plateforme d'agent de Google Cloud et Microsoft Foundry, ce message couvre aussi les requêtes que les mesures de sécurité du modèle ont signalées comme un sujet de cybersécurité. Voir Les mesures de sécurité ont signalé un sujet de cybersécurité.

Avant v2.1.219, le message se lisait 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.

Que faire :

• Appuyez deux fois sur Échap ou exécutez /rewind pour revenir à un point de contrôle avant le tour qui a déclenché le refus, puis reformulez ou prenez une approche différente. Voir Points de contrôle.
• Si vous ne pouvez pas identifier quel tour l'a causé, exécutez /clear pour démarrer une conversation nouvelle dans le même projet. Votre conversation précédente est préservée sur le disque et reste disponible dans /resume.
• En mode non-interactif (-p), où la rembobinage est indisponible, réessayez avec une invite reformulée dans une nouvelle session sans --continue. Les vérifications de politique varient selon le modèle, donc basculer vers un modèle différent avec --model peut aussi 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's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude

Le message se lie au Programme de vérification de cybersécurité, qui accorde l'accès pour le travail de cybersécurité légitime. Sur Opus 5.5 et Sonnet 5.5, le message s'ouvre avec <model>'s safeguards flagged this session à la place. Quand la catégorie signalée a un modèle de secours disponible, Claude Code bascule les modèles plutôt que d'afficher cette erreur.

Sur Amazon Bedrock, la plateforme d'agent de Google Cloud et Microsoft Foundry, un drapeau de cybersécurité produit le message de refus de la politique d'utilisation à la place.

La protection elle-même est côté serveur et antérieure à v2.1.203 ; les versions client depuis lors ont changé uniquement le libellé du message. De v2.1.203 à v2.1.218, le message se lisait <model> 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: suivi du même lien du centre d'aide, et les sessions interactives ajoutaient If you were not engaging in a cybersecurity topic, please send feedback via /feedback. Avant v2.1.203, il se 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.

Que faire :

• Si votre travail nécessite ce contenu, postulez pour l'accès via le Programme de vérification de cybersécurité
• Si votre requête n'était pas sur un sujet de cybersécurité, exécutez /feedback pour signaler le faux positif
• Pour continuer à travailler dans la même session, appuyez deux fois sur Échap ou exécutez /rewind pour revenir à un point de contrôle avant le tour qui a déclenché le drapeau, puis prenez une approche différente. Voir 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 avec peu de 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 sur la 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 brute 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 avec peu de 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 ou claude update téléchargeait le binaire Claude Code, et les tentatives de reconnexion n'ont pas fonctionné. 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ète, comme un 404, n'est pas réessayée car le serveur a déjà répondu. Avant la v2.1.202, une seule connexion interrompue échouait le téléchargement immédiatement avec l'erreur brute 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 indique 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 imparti ne se terminera pas lors d'une tentative immédiate non plus. Les étapes ci-dessous s'appliquent aux deux messages.

Un proxy ou une passerelle peut fermer un long transfert avant qu'il ne se termine, et le binaire Claude Code est un gros téléchargement.

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_PROXY avant d'exécuter le programme d'installation ou claude 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 ligne de commande claude et de ses sous-commandes, d'un nom de commande que vous soumettez dans le prompt, et de commandes telles que /security-review qui rassemblent du contexte en exécutant des commandes shell avant l'exécution de leur prompt. Elles proviennent aussi de /tui, qui relance la CLI.

Conflit entre `--bg` et `--print`

Ce message nécessite Claude Code v2.1.198 ou une version ultérieure. Vous avez combiné --bg avec -p ou --print dans le même appel claude. --bg démarre une session en arrière-plan à laquelle vous vous rattachez ensuite avec claude agents, tandis que --print s'exécute en mode non interactif et ne démarre jamais la session interactive à laquelle claude agents se rattache. Avant la v2.1.198, cette combinaison créait silencieusement une tâche en arrière-plan à laquelle il était impossible de se rattacher.

--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>'`.

Que faire :

• Supprimez -p ou --print. --bg prend le prompt comme argument positionnel, donc claude --bg "<task>" est la commande complète. Consultez Lancer de nouveaux agents depuis votre shell.
• Pour exécuter le prompt en mode non interactif et afficher le résultat au lieu de créer une session en arrière-plan, supprimez --bg et exécutez claude -p "<task>"

Conflit entre un flag de prompt système et sa forme fichier

Vous avez passé --append-subagent-system-prompt avec --append-subagent-system-prompt-file dans un même appel claude, donc claude se termine avec le code 1 au lieu de démarrer la session :

Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.

Avant la v2.1.283, claude se terminait de la même façon lorsque vous passiez --system-prompt avec --system-prompt-file, ou --append-system-prompt avec --append-system-prompt-file, car ces paires entraient en conflit au lieu de se combiner. Sur ces versions, le message nomme la paire que vous avez combinée.

Que faire :

• Conservez une seule forme du flag et supprimez l'autre. Pour combiner un fichier de prompt fixe avec du texte propre à chaque exécution, fusionnez le texte dans le fichier avant le lancement au lieu de passer les deux flags

Configuration `--agents` invalide

La valeur que vous avez passée à --agents est invalide, donc claude se termine avec le code 1 au lieu de démarrer la session. Lorsque vous passez --safe-mode ou définissez CLAUDE_CODE_SAFE_MODE, Claude Code ignore entièrement --agents. Avec --resume ou --continue, une valeur JSON en ligne n'est pas vérifiée et la session démarre ; une valeur lue depuis un fichier est vérifiée à chaque lancement. Avant la v2.1.242, Claude Code démarrait quand même la session.

Error: Invalid --agents configuration:
<what failed>

Ce qui suit la première ligne dépend de la manière dont la valeur a échoué. Claude Code exécute ces vérifications dans l'ordre et s'arrête à la première qui échoue. Si votre valeur présente deux types de problèmes, vous ne voyez le second qu'après avoir corrigé le premier :

1. Lorsque la valeur commence par { mais n'est pas analysable en JSON, ou que le contenu d'un fichier --agents n'est pas analysable, Claude Code affiche une ligne invalid JSON: contenant le message propre à l'analyseur JSON
2. Lorsqu'elle est analysable mais qu'une définition d'agent ne correspond pas au schéma des sous-agents définis par la CLI, Claude Code affiche une ligne par problème
3. Lorsqu'un nom d'agent commence par -, Claude Code affiche <name>: agent names must not start with '-'

Lorsqu'il y a plus de 20 lignes de problèmes, Claude Code affiche les 20 premières et remplace le reste par …and N more.

Avec --print, --agents accepte aussi le chemin d'un fichier JSON à la place de l'objet en ligne. Avant la v2.1.281, --agents n'acceptait que du JSON en ligne et traitait un chemin de fichier comme du JSON invalide. La forme fichier a ses propres refus, affichés à la place de ce message, notamment ceux-ci :

• Error: --agents takes a JSON object, or a file path only with --print (-p) : Claude Code a lu la valeur comme un chemin de fichier dans une session interactive. Passez les définitions en JSON en ligne, ou ajoutez -p pour les lire depuis un fichier.
• Error: --agents file not found: <path> : aucun fichier n'existe à ce chemin. Une valeur qui ne commence pas par { et qui n'est pas du JSON valide est lue comme un chemin, donc du JSON en ligne altéré par votre shell peut aussi échouer de cette façon. Vérifiez le chemin ou les guillemets et exécutez à nouveau la commande.

Que faire :

• Corrigez chaque problème listé par le message, puis exécutez à nouveau la commande. Consultez les champs acceptés par un sous-agent défini par la CLI.

Les sessions cloud ne peuvent pas être créées depuis une session `--restricted`

Lorsque vous démarrez une session avec --restricted, Claude Code refuse d'y créer des sessions cloud, car la nouvelle session s'exécuterait en dehors du processus restreint et n'appliquerait pas le mode restreint. Claude Code refuse côté client, avant de contacter le serveur, donc aucune session cloud n'est créée :

Cloud sessions cannot be created from a --restricted session: they would not enforce it.

Que faire :

• Exécutez la tâche localement dans la session restreinte
• Si vous contrôlez la manière dont la session a été lancée, démarrez une nouvelle session claude sans --restricted et créez la session cloud depuis celle-ci

Avant la v2.1.248, Claude Code n'avait pas de flag --restricted ; les versions antérieures rejettent le flag lui-même avec une erreur d'option inconnue.

Les sessions cloud sont désactivées par la politique de votre organisation

La politique allow_remote_sessions de votre organisation est désactivée, donc les sessions cloud et les commandes qui les utilisent ne sont pas disponibles :

Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.

Le message apparaît lorsque vous créez une session cloud depuis le terminal et lorsque vous soumettez une commande qui nécessite les sessions cloud, comme /teleport, /remote-env ou /web-setup. Avant la v2.1.268, soumettre l'une de ces commandes renvoyait Unknown command à la place.

Il s'agit d'une politique d'organisation côté serveur, elle ne peut donc pas être outrepassée par des paramètres locaux, des variables d'environnement ou des flags de la CLI.

Si Claude Code n'a pas encore chargé la politique de votre organisation ou ne parvient pas à la récupérer, ces commandes répondent Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again. à la place.

Que faire :

• Demandez à un Owner de votre organisation d'activer les sessions cloud dans les paramètres d'administration de Claude Code sur claude.ai/admin-settings/claude-code
• Si le message indique que la politique n'a pas pu être vérifiée, vérifiez votre connexion réseau, puis redémarrez Claude Code et réessayez

La valeur `--json-schema` n'est pas un JSON Schema valide

Le schéma que vous avez passé à --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 second deux-points est le diagnostic du validateur et nomme le mot-clé ou l'emplacement en échec. 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 effectue 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.

Que faire :

• Corrigez la partie du schéma nommée par le diagnostic, puis relancez la commande
• Consultez Obtenir une sortie structurée pour un schéma et une commande fonctionnels

Le fichier de paramètres dépasse la limite de 2 MiB

Le fichier que vous avez passé à --settings dépasse 2 MiB, donc claude se termine avec le code 1 au démarrage au lieu de le charger. Avant la v2.1.214, Claude Code lisait le fichier sans vérifier sa taille, et un fichier de plusieurs gigaoctets ou un fichier de périphérique comme /dev/zero faisait croître la mémoire sans limite.

Error: Settings file exceeds the 2MiB limit: /path/to/settings.json

Claude Code rejette de la même façon un chemin --settings qui n'est pas un fichier ordinaire : un périphérique, une FIFO ou un socket signale Error: Cannot use settings file (Not a regular file (device, FIFO, or socket)) suivi du chemin, et un répertoire signale un motif EISDIR.

Que faire :

• Faites pointer --settings vers un fichier de paramètres JSON ordinaire de moins de 2 MiB. Consultez Paramètres pour le format.

Le répertoire courant n'existe plus

Vous avez démarré claude depuis un répertoire qui a été supprimé ou déplacé après que votre shell y est entré, par exemple un worktree ou un répertoire temporaire supprimé par un autre shell. Claude Code ne peut pas lire son répertoire de travail, il se termine donc avec le code 1 avant de démarrer la session, en mode interactif comme en mode non interactif. Avant la v2.1.239, Claude Code plantait en affichant le source minifié du bundle et une pile brute ENOENT ... uv_cwd sur stderr au lieu de ce message.

The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.

La cause et la solution sont les mêmes pour les deux formes.

Lorsque Claude Code ne peut pas lire le répertoire de travail pour une autre raison, comme un changement de permissions, le message nomme le code d'erreur à la place : Can't read the current directory (EACCES). Start Claude Code from a different directory.

Sur macOS, EPERM pour un répertoire situé dans ~/Desktop, ~/Documents, ~/Downloads ou iCloud Drive signifie généralement que macOS bloque l'accès de votre application de terminal à ce dossier. Les autres commandes qui lisent ce dossier échouent de la même façon : ls à cet endroit signale Operation not permitted, même avec sudo.

Que faire :

• Placez-vous dans un répertoire qui existe, comme votre répertoire personnel ou votre répertoire de projet, puis exécutez à nouveau claude
• Si le répertoire a été recréé au même chemin, votre shell conserve toujours celui qui a été supprimé. Exécutez cd "$PWD" ou quittez le répertoire et revenez-y, puis exécutez à nouveau claude
• Pour EPERM sur macOS, quittez votre application de terminal avec Cmd+Q, rouvrez-la, retournez dans ce dossier et exécutez claude. Si ls échoue toujours dans ce dossier, ouvrez Réglages Système > Confidentialité et sécurité > Fichiers et dossiers, activez le dossier pour votre application de terminal, puis rouvrez le terminal

Répertoire temporaire refusé ou impossible à créer

Sur macOS et Linux, Claude Code crée au démarrage un répertoire temporaire privé, claude-<uid>, dans le répertoire temporaire du système ou dans celui défini par CLAUDE_CODE_TMPDIR. Lorsque le répertoire ne peut pas être créé, ou qu'une entrée déjà présente à ce chemin échoue aux contrôles de sécurité, Claude Code affiche l'échec sur stderr et se termine avec le code 1 au lieu de démarrer la session :

ENOSPC: no space left on device, mkdir '/tmp/claude-501'

Temp directory /tmp/claude-501 is not a directory (may be an attacker-planted symlink). Refusing to use it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Temp directory /tmp/claude-501 is owned by uid 502, expected 501. Refusing to use it — another user may have pre-created it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Que faire :

• Pour ENOSPC, libérez de l'espace disque sur le volume qui contient le répertoire temporaire
• Pour les formes Refusing to use it, supprimez l'entrée nommée elle-même, et non la cible d'un lien, puis redémarrez Claude Code ; pour la forme owned by uid, seul un administrateur ou cet utilisateur peut la supprimer
• Pour is not readable, exécutez chmod 0700 sur le répertoire nommé, ou supprimez-le et redémarrez
• Dans tous ces cas, définissez CLAUDE_CODE_TMPDIR sur un répertoire que vous contrôlez et redémarrez Claude Code, sans toucher au chemin refusé

Le répertoire n'a pas pu être résolu vers un emplacement réel

Vous avez exécuté /add-dir pour un sous-répertoire de votre répertoire de travail, et Claude Code n'a pas pu résoudre le répertoire vers son emplacement réel.

Vous avez déjà accès aux fichiers d'un sous-répertoire du répertoire de travail, donc /add-dir ne charge que ses skills, commandes et agents. Avant de les charger, Claude Code vérifie que l'emplacement réel du répertoire, après résolution des liens symboliques, se trouve dans le répertoire de travail. Lorsque Claude Code ne parvient pas à résoudre cet emplacement, il ne charge rien et affiche ce message :

packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.

Que faire :

• Vérifiez que le chemin désigne un répertoire réel dans le répertoire de travail, puis exécutez à nouveau /add-dir
• Le message ne modifie pas votre accès aux fichiers ; il signale seulement que le contenu .claude/ du répertoire n'a pas été chargé

Avant la v2.1.261, ce message apparaissait aussi pour chaque /add-dir <subdirectory> lorsque le répertoire de travail se trouvait sur un montage automatique /net/<host>, où Claude Code refuse par conception de résoudre les chemins ; le répertoire était correct et réessayer ne pouvait pas aider.

Espace de travail non approuvé au démarrage de Remote Control

Vous avez démarré le mode serveur de Remote Control avec claude remote-control ou son alias claude rc dans un répertoire que vous n'avez pas approuvé, et la commande n'a pas pu vous demander si vous vouliez l'approuver. Par exemple, l'entrée standard ou la sortie standard de la commande n'est pas un terminal parce que l'une d'elles est redirigée ou envoyée dans un pipe. La commande se termine avec le code 1 :

Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.

Deux variantes qui commencent aussi par Error: Workspace not trusted. apparaissent dans un terminal trop petit pour afficher ce qu'active l'approbation du répertoire, ou dans un terminal qui n'a pas signalé sa taille. Agrandissez la fenêtre ou passez à une fenêtre de terminal normale, puis exécutez à nouveau claude rc.

Dans votre répertoire personnel, le message est différent, car la boîte de dialogue d'approbation de l'espace de travail n'enregistre jamais l'approbation pour le répertoire personnel, donc l'accepter à cet endroit ne peut pas satisfaire cette vérification. Avant la v2.1.214, le répertoire personnel affichait le message ci-dessus, dont le conseil ne peut pas aboutir à cet endroit.

Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).

Si vous répondez n ou appuyez sur Entrée à la question Trust <directory>?, la commande affiche un message Remote Control did not start qui nomme le répertoire et se termine avec le code 1. Exécutez à nouveau claude rc pour répondre y.

Que faire :

• Approuvez d'abord le répertoire depuis un terminal : exécutez claude rc à cet endroit et répondez y, ou exécutez claude à cet endroit et acceptez la boîte de dialogue d'approbation de l'espace de travail, puis exécutez à nouveau votre commande d'origine
• Dans votre répertoire personnel, placez-vous dans un répertoire de projet et démarrez Remote Control depuis celui-ci

Avant la v2.1.284, la commande ne posait jamais la question, même dans un terminal.

Non transmis aux sessions démarrées par Remote Control

Vous avez démarré Remote Control avec un flag global de claude placé avant le verbe remote-control, qui restreindrait ou configurerait les sessions démarrées par Remote Control, comme --settings, --setting-sources, --permission-mode, --disallowed-tools ou --mcp-config. Un flag placé avant le verbe n'atteint jamais ces sessions. Claude Code refuse donc de démarrer, en nommant le flag :

Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).

Claude Code ne refuse pas les flags globaux qu'il est sans danger d'ignorer, comme --verbose, --model, ou un --session-id ou --plugin-dir injecté par un wrapper : il les ignore et Remote Control démarre.

Claude Code refuse aussi de démarrer pour un flag global qu'il ne reconnaît pas encore comme sans danger, donc un flag ajouté dans une version plus récente peut apparaître dans ce message jusqu'à ce qu'une version ultérieure le marque comme sans danger.

Que faire :

• Retirez le flag placé avant le verbe et passez les options propres à Remote Control après celui-ci ; claude remote-control --help les liste
• Lorsque le flag refusé est --permission-mode, exécutez claude remote-control --permission-mode <mode> pour définir le mode de permission des sessions démarrées par Remote Control

Avant la v2.1.248, claude remote-control n'acceptait pas ses propres flags lorsqu'un flag global venait en premier, et la commande échouait avec une erreur unknown option.

claude import n'est pas encore disponible dans ce build

Vous avez exécuté claude import, et Claude Code a constaté que le processus d'import était désactivé, donc la commande se termine avec le code 1 au lieu de démarrer l'import. Avant la v2.1.222, un build avec le processus d'import désactivé traitait import comme un prompt et démarrait une session interactive au lieu d'afficher ce message.

`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.

Claude Code active claude import via un feature flag qu'il récupère auprès d'Anthropic et met en cache sur le disque. Ce message signifie que la valeur en cache est désactivée. La cause est généralement l'une des suivantes :

• Vous n'avez pas démarré de session depuis l'installation, donc Claude Code n'a pas encore récupéré le flag. Le premier claude import peut afficher ce message même lorsque la fonctionnalité vous est disponible.
• Vous utilisez Claude Code via Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry ou Claude Platform on AWS, ou via une passerelle Claude apps. Claude Code ne récupère pas les feature flags dans ces sessions, donc claude import reste indisponible.
• Vous avez défini DISABLE_TELEMETRY, DO_NOT_TRACK, DISABLE_GROWTHBOOK ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, qui désactivent la récupération des feature flags, donc claude import reste indisponible.

Que faire :

• Sur une nouvelle installation, démarrez claude, attendez que la session se charge, quittez, puis exécutez à nouveau claude import
• Lorsque la récupération des feature flags reste désactivée, configurez vous-même l'environnement : ajoutez des serveurs MCP avec claude mcp add, et créez les fichiers CLAUDE.md, les skills et commandes et les sous-agents que vous souhaitez transférer. Le message nomme aussi ~/.claude/settings.json. De la configuration que transfère claude import, ce fichier ne contient que le mode de permission ; Claude Code n'y lit pas les serveurs MCP.

Impossible de lire la configuration de Claude Code

Vous avez exécuté claude import alors que Claude Code ne parvenait pas à analyser ~/.claude.json, le fichier dans lequel il stocke votre connexion et l'état de chaque projet. La sous-commande lit ce fichier pour vérifier la disponibilité, mais n'affiche pas la boîte de dialogue de récupération qu'affiche la session interactive, elle se termine donc avec le code 1. Avant la v2.1.222, claude import avec un fichier de configuration illisible démarrait une session interactive, dont la boîte de dialogue de récupération prenait en charge le fichier.

Could not read Claude Code config — run `claude` with no arguments to recover it.

Que faire :

• Exécutez claude sans arguments. Claude Code détecte le fichier invalide et propose de le réinitialiser. Exécutez ensuite à nouveau claude import.
• Pour conserver les modifications manuelles que vous avez apportées, corrigez plutôt la syntaxe JSON de ~/.claude.json dans un éditeur, puis relancez claude import

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 quand même 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 en échec arrêtait l'import.

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 le motif. Le plus courant est la vérification du nom : Claude Desktop autorise dans les noms de serveurs des caractères, comme les espaces et les points, que claude mcp limite aux lettres, chiffres, traits d'union et tirets bas. Les autres motifs incluent une configuration de serveur qui échoue à la validation et un serveur bloqué par la politique MCP de votre organisation.

Que faire :

• Renommez le serveur dans claude_desktop_config.json pour n'utiliser que des lettres, chiffres, traits d'union et tirets bas, puis exécutez à nouveau claude mcp add-from-claude-desktop
• Ajoutez ce serveur directement avec claude mcp add ou claude mcp add-json sous un nom valide. Consultez Importer des serveurs MCP depuis Claude Desktop.

Impossible d'ajouter un serveur MCP à la portée managed

Vous avez exécuté claude mcp add ou claude mcp add-json avec --scope managed. Cette portée contient les serveurs que votre organisation fournit via le paramètre géré managedMcpServers. Claude Code les lit uniquement depuis les paramètres gérés, donc la commande ne peut pas écrire de serveur dans cette portée.

Cannot add MCP server to scope: managed

Que faire :

• Ajoutez le serveur à une portée dans laquelle vous pouvez écrire : local, user ou project. Sans --scope, la commande utilise local. Consultez Portées d'installation MCP
• Pour fournir le serveur à tous les utilisateurs de votre organisation, ajoutez-le à managedMcpServers dans les paramètres gérés que vous déployez

Impossible d'ajouter un serveur MCP lorsque les paramètres gérés n'autorisent que les serveurs de plugins

Vous avez exécuté claude mcp add ou claude mcp add-json alors que les paramètres gérés de votre organisation définissent strictPluginOnlyCustomization sur true ou sur une liste qui inclut mcp. Avec ce paramètre, Claude Code ne charge pas les serveurs MCP depuis ~/.claude.json ou .mcp.json, donc la commande se termine avec le code 1 au lieu d'enregistrer un serveur qui ne se chargerait jamais :

Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available.

claude mcp add-from-claude-desktop signale chaque serveur que vous sélectionnez comme non importé, avec ce message comme motif. /import signale ce message pour chaque serveur MCP qu'il tente d'ajouter et importe quand même les autres éléments qu'il a trouvés.

Avant la v2.1.284, ces commandes enregistraient le serveur et signalaient un succès, et le serveur ne se chargeait jamais.

Que faire :

• Installez un plugin qui fournit le serveur
• Demandez à votre administrateur de distribuer le serveur dans un plugin, ou de le fournir via managedMcpServers s'il s'agit d'un serveur distant HTTP ou SSE

Impossible de lire .mcp.json

Une commande qui lit le fichier .mcp.json du projet, comme claude mcp add ou claude mcp add-json avec --scope project, ou claude mcp remove, a constaté que le fichier de votre répertoire courant n'est pas un fichier ordinaire ou dépasse 2 MiB, elle se termine donc avec cette erreur au lieu de lire le fichier.

Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.

Avant la v2.1.257, une FIFO à l'emplacement .mcp.json laissait la commande en attente indéfiniment sans aucune sortie, et un lien symbolique vers un fichier de périphérique comme /dev/zero faisait croître la mémoire jusqu'à ce que le processus soit tué.

Que faire :

• Vérifiez ce qui se trouve à l'emplacement .mcp.json dans votre répertoire courant. Remplacez-le par un fichier JSON ordinaire au format de portée projet, ou supprimez-le, puis exécutez à nouveau la commande.

Le serveur MCP n'a pas été enregistré ou supprimé

Vous avez exécuté claude mcp add, claude mcp add-json ou claude mcp remove pour un serveur de portée user ou local. Les deux portées sont stockées dans ~/.claude.json, et la modification ne figure pas dans ce fichier lorsque Claude Code le relit après l'écriture. La commande se termine avec cette erreur au lieu de sa ligne de succès.

MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.

Après une suppression, le message indique was not removed from et se termine par then remove the server again. Pour un serveur de portée local, le chemin est suivi du répertoire de projet auquel appartient l'entrée, sous la forme (local scope for /path/to/project).

Avant la v2.1.283, claude mcp add, claude mcp add-json et claude mcp remove signalaient un succès même lorsque la modification n'atteignait pas le fichier.

Que faire :

• Rendez accessible en écriture le fichier nommé par le message, ou exécutez la commande en dehors du sandbox, puis exécutez à nouveau la même commande d'ajout ou de suppression.

Le serveur MCP n'a peut-être pas été enregistré ou supprimé

Vous avez exécuté claude mcp add, claude mcp add-json ou claude mcp remove pour un serveur de portée user ou local, et Claude Code n'a pas pu relire ~/.claude.json pour confirmer la modification. La modification peut être ou ne pas être sur le disque. Le texte entre parenthèses est l'erreur renvoyée par cette lecture.

MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.

Après une suppression, le message indique may not have been removed et se termine par then remove the server again if it is still listed.

Avant la v2.1.283, les commandes signalaient un succès même lorsque la modification n'avait pas pu être confirmée.

Que faire :

• Exécutez claude mcp get <name> pour vérifier si la modification est sur le disque. Pour un serveur de portée local, exécutez-la depuis le répertoire de projet auquel appartient le serveur, puisque la portée locale est propre à chaque projet.
• Si le serveur est absent après un ajout, ou toujours listé après une suppression, exécutez à nouveau la même commande d'ajout ou de suppression.

Le serveur est hébergé par Anthropic et ne prend pas en charge OAuth en local

Vous avez lancé une connexion pour un serveur MCP dont l'URL pointe vers un hôte de connecteur hébergé par Anthropic qui s'authentifie via un fournisseur d'identité tiers. Ces hôtes incluent microsoft365.mcp.claude.com, gmail.mcp.claude.com et gcal.mcp.claude.com. Claude Code refuse de démarrer son flux OAuth local pour ces hôtes, depuis le panneau /mcp comme depuis claude mcp login, car leur connexion ne fonctionne que via claude.ai.

"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.

Que faire :

• Supprimez votre entrée avec claude mcp remove <name>, afin qu'elle ne puisse pas masquer le connecteur claude.ai à la même URL
• Après l'avoir supprimée, connectez le service sur claude.ai/customize/connectors, en étant connecté au compte que vous utilisez dans Claude Code. Une fois la connexion établie, le connecteur apparaît automatiquement dans Claude Code si votre méthode d'authentification active est une connexion par abonnement claude.ai

Le serveur a rejeté l'en-tête Authorization généré par le headersHelper configuré

Un serveur MCP dont le headersHelper fournit l'en-tête Authorization a répondu à la connexion avec un HTTP 401 ou 403, donc Claude Code signale l'échec de la connexion. Comme le helper fournit l'en-tête Authorization, Claude Code ne se rabat pas sur OAuth pour ce serveur :

Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.

Claude Code réexécute le helper à chaque tentative de connexion, donc une nouvelle tentative après un rejet transitoire, comme une situation de concurrence lors de la rotation d'un jeton, peut réussir avec de nouveaux identifiants.

Que faire :

• Exécutez vous-même la commande headersHelper de la même façon que Claude Code : depuis le répertoire dans lequel Claude Code l'exécute, avec les variables d'environnement que Claude Code définit pour elle, et sans les variables d'identifiants que Claude Code supprime pour un serveur provenant d'un fichier .mcp.json de projet, d'un plugin ou d'un fichier d'agent de projet. Vérifiez qu'elle affiche une valeur Authorization acceptée par l'endpoint du serveur
• Après avoir corrigé le helper ou la source de ses identifiants, sélectionnez le serveur dans /mcp et choisissez Reconnect

Avant la v2.1.248, Claude Code lançait la découverte OAuth pour un serveur dont le helper fournissait l'en-tête Authorization. Cette découverte pouvait échouer avec Incompatible auth server: does not support dynamic client registration au lieu de signaler les identifiants rejetés.

Outil de demande de permission MCP introuvable

L'outil que vous avez passé à --permission-prompt-tool ne figurait pas parmi les outils MCP connectés lorsque l'exécution a eu besoin pour la première fois d'une décision de permission, soit parce que son serveur ne s'est jamais connecté, soit parce qu'aucun serveur connecté n'expose d'outil portant ce nom. Claude Code envoie quand même votre prompt : l'exécution en mode non interactif se termine avec cette erreur, et le code de sortie 1, au premier appel d'outil, elle ne produit donc aucune réponse bien que la requête ait été effectuée. Avant le premier prompt, Claude Code attend que ce serveur se connecte, jusqu'au délai d'expiration de connexion par serveur de 30 secondes défini par MCP_TIMEOUT. Avant la v2.1.206, le démarrage n'attendait pas la fin de la connexion du serveur, donc un serveur sain mais lent à démarrer produisait aussi cette erreur.

Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

La liste après Available MCP tools: nomme les outils MCP qui étaient connectés.

Que faire :

• Vérifiez que le serveur démarre et reste connecté : exécutez claude mcp list dans le même répertoire et confirmez que le serveur est listé comme connecté
• Confirmez que le nom de l'outil correspond au nom mcp__<server>__<tool> exposé par le serveur
• Si le serveur a besoin de plus de 30 secondes pour démarrer, augmentez MCP_TIMEOUT

Le port de callback OAuth est déjà utilisé

Lorsque vous vous connectez à un serveur MCP distant avec OAuth, Claude Code démarre un écouteur local pour recevoir le callback de connexion. Si le port dont cet écouteur a besoin est occupé par un autre processus, la connexion échoue avec ce message. Cela se produit surtout avec un port de callback fixe défini via la variable MCP_OAUTH_CALLBACK_PORT ou --callback-port, puisque sans cela Claude Code choisit un port disponible.

OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.

Sur Windows, la commande suggérée est netstat -ano | findstr :<port> à la place.

Que faire :

• Exécutez la commande du message pour trouver le processus qui occupe le port, puis arrêtez-le ou attendez qu'il se termine
• Si un autre programme a besoin de ce port en permanence, enregistrez une URI de redirection différente auprès du serveur et définissez son port avec MCP_OAUTH_CALLBACK_PORT ou --callback-port, selon ce que vous utilisez
• Relancez ensuite la connexion, par exemple en sélectionnant le serveur dans /mcp

Aucun port disponible pour la redirection OAuth

Lorsque vous vous connectez à un serveur MCP distant avec OAuth, Claude Code démarre un écouteur local pour recevoir le callback de connexion. La connexion échoue avec ce message lorsque Claude Code ne parvient pas à lier un port local pour cet écouteur. Un élément de la machine l'empêche d'écouter sur 127.0.0.1, par exemple un logiciel de sécurité ou une politique de sandbox qui interdit les écouteurs locaux.

No available ports for OAuth redirect

Avant la v2.1.268, Claude Code ne basculait pas sur un port attribué par le système d'exploitation, donc le message apparaissait aussi lorsque seuls les ports qu'il choisissait lui-même ne pouvaient pas être liés. Cela peut se produire sur des hôtes Windows où Hyper-V réserve des plages de ports qui couvrent les ports parmi lesquels Claude Code choisit.

Que faire :

• Vérifiez si un logiciel de sécurité ou une politique de sandbox empêche les processus d'écouter sur 127.0.0.1, et autorisez Claude Code à lier un port local
• Relancez ensuite la connexion, par exemple en sélectionnant le serveur dans /mcp

/security-review échoue sans origin/HEAD

/security-review construit son contexte de revue en calculant le diff de votre branche par rapport à origin/HEAD, la référence locale qui indique quelle branche est la branche par défaut sur votre remote origin. Lorsque cette référence n'existe pas, les commandes git qui rassemblent le diff échouent et la revue s'arrête avant de commencer.

Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
fatal: ambiguous argument 'origin/HEAD...': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

Le message peut citer git log ou une autre commande git diff à la place. Git ne crée origin/HEAD que lorsque le remote annonce une branche par défaut et que votre refspec de fetch la couvre, ce que fait un git clone complet d'un remote contenant des commits. La référence est absente dans ces configurations :

• Un checkout mono-branche ou de CI, qui récupère une refspec trop étroite
• Un remote dont le HEAD côté serveur pointe vers une branche que personne n'a poussée
• Un dépôt sans remote origin, ou un remote que vous n'avez jamais récupéré

Claude Code affiche la même erreur pour tout skill qui injecte du contexte dynamique, et une commande injectée en échec interrompt l'invocation de ce skill. Deux messages apparentés apparaissent avant même l'exécution de la commande :

• Shell command permission check failed for pattern "..." : la vérification de permission de la commande ne l'a pas autorisée. Vérifications de permission sur les commandes injectées explique quels résultats interrompent l'exécution dans chaque mode de permission et comment pré-approuver une commande avec allowed-tools
• Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found : le frontmatter du skill exige bash sur une machine qui n'en dispose pas. Installez Git for Windows ou modifiez le frontmatter en shell: powershell. Consultez Comment les commandes injectées s'exécutent

Que faire :

• Créez la référence en nommant la branche par défaut de votre remote : git remote set-head origin <default-branch>. Cela fonctionne dès lors que la référence de suivi locale origin/<default-branch> existe. Si ce n'est pas le cas, comme dans les clones mono-branche, récupérez d'abord la branche : exécutez git remote set-branches --add origin <branch>, puis git fetch origin, puis relancez la commande set-head. Relancez /security-review.
• Si vous préférez ne pas nommer la branche, exécutez git fetch origin puis git remote set-head origin --auto, qui demande au remote quelle est sa branche par défaut. Cette commande échoue avec error: Cannot determine remote HEAD lorsque le remote n'annonce aucune branche par défaut, parce qu'il est vide ou que son HEAD pointe vers une branche que personne n'a poussée ; nommez alors explicitement la branche. Elle échoue avec error: Not a valid ref lorsque votre clone ne récupère pas cette branche ; élargissez d'abord la refspec comme indiqué ci-dessus.
• Si le dépôt n'a pas de remote, ajoutez-en un avec git remote add origin <url> et effectuez un fetch avant de créer la référence. Si le remote est vide, poussez d'abord votre branche avec git push -u origin HEAD et nommez cette branche dans la commande set-head ; origin/HEAD pointe alors vers la branche que vous venez de pousser, donc /security-review voit un diff vide jusqu'à ce que la branche diverge.

Une entrée doit être fournie lors de l'utilisation de `--print`

claude seul a besoin que stdout soit un terminal pour démarrer l'interface interactive. Lorsque stdout est redirigé, ou que la console n'est pas un vrai terminal, comme PowerShell ISE et certains volets de sortie d'IDE, claude s'exécute en mode non interactif à la place. Il s'agit du même mode que claude -p, qui exige un prompt, donc le message nomme --print même si vous n'avez pas passé le flag. Passer -p/--print sans prompt et sans rien envoyer sur stdin produit la même erreur partout.

Error: Input must be provided either through stdin or as a prompt argument when using --print

Que faire :

• Pour une utilisation interactive, exécutez claude dans un vrai terminal : Windows Terminal ou la console PowerShell plutôt qu'ISE, et le terminal intégré de votre IDE plutôt qu'un volet de sortie
• Pour une utilisation ponctuelle, passez le prompt : claude -p "your question", ou envoyez-le via un pipe avec echo "your question" | claude -p

L'entrée ne contenait que des espaces

En mode non interactif, Claude Code refuse un prompt composé entièrement d'espaces, de tabulations ou de sauts de ligne au lieu de l'envoyer, car l'API rejette les messages sans texte visible. Le message affiché dépend de la provenance du prompt vide :

• Argument de prompt ou stdin envoyé via un pipe pour claude -p : claude se termine avec Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print
• Message soumis à une session --input-format stream-json ou Agent SDK en cours : Claude Code termine le tour sans appeler le modèle et la session reste utilisable. Le refus arrive sous forme de message informatif et comme texte de résultat du tour : Blank prompt — the message was only whitespace, so nothing was sent to the model.

Avant la v2.1.229, Claude Code envoyait le message composé uniquement d'espaces à l'API, qui rejetait la requête avec une erreur 400.

Que faire :

• Incluez du texte visible dans le prompt. Si un script construit le prompt à partir d'une variable ou d'un fichier, vérifiez que la source n'est pas vide avant d'appeler Claude Code.

L'entrée stream-json contenait plus de 256M caractères sans saut de ligne

Votre programme a envoyé plus de 268 435 456 caractères sur stdin sans saut de ligne à une exécution claude -p --input-format stream-json, donc Claude Code affiche cette erreur sur stderr et se termine avec le code 1 au lieu de mettre davantage d'entrée en mémoire tampon. Le message exprime cette limite sous la forme 256M. Avant la v2.1.257, Claude Code mettait une telle entrée en mémoire tampon sans limite, faisant croître la mémoire jusqu'à ce que le processus plante ou soit tué.

Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.

Une entrée aussi longue sans saut de ligne signifie généralement que le producteur n'est pas du tout un producteur stream-json, par exemple un fichier binaire ou une sortie de log en texte brut envoyé par erreur via un pipe. Un seul message dépassant la limite échoue à la même vérification.

Que faire :

• Vérifiez ce qui est envoyé sur stdin. Avec --input-format stream-json, chaque message doit être une seule ligne JSON terminée par un saut de ligne
• Pour envoyer du texte brut à la place, supprimez --input-format stream-json ; claude -p lit par défaut un prompt en texte brut depuis stdin

Commande inconnue

Dans une session de terminal interactive, vous avez soumis un nom / qui ne correspond à aucune commande de cette session, donc Claude Code signale le nom au lieu d'exécuter quoi que ce soit :

Unknown command: /hepl. Did you mean /help?

Claude Code suggère le nom de commande ou l'alias le plus proche listé par le menu dans cette session. Lorsque rien n'est proche, le message se termine après le nom. La cause est généralement l'une des suivantes :

• Une faute de frappe, comme /hepl pour /help. Comment le menu des commandes fait correspondre ce que vous tapez explique comment choisir une correspondance proche avant de soumettre
• Une commande qui existe mais n'est pas disponible dans cette session parce qu'une condition n'est pas remplie, comme votre plateforme, votre forfait ou votre méthode d'authentification. Les entrées de dépannage pour /web-setup et /schedule détaillent deux cas courants. Certaines commandes répondent avec leur propre message lorsque la politique de votre organisation les désactive, comme Cloud sessions are disabled by your organization's policy
• Une commande provenant d'un plugin ou d'un serveur MCP qui n'est pas installé ou connecté dans cette session

Claude Code ne répond de cette façon à un nom / sans correspondance que dans une session de terminal interactive. Dans toutes les autres sessions, il envoie plutôt le prompt à Claude comme un message normal, avec une note indiquant que la commande ne s'est pas exécutée et une liste des commandes que Claude peut exécuter dans la session. Ces sessions incluent :

• Les exécutions -p
• Les applications Agent SDK
• L'onglet Code de l'application Desktop
• Le panneau de chat de l'extension VS Code
• Les sessions cloud et les routines

Pour une commande intégrée qui ne peut pas s'exécuter dans l'une de ces sessions, Claude Code répond quand même que la commande n'est pas disponible au lieu de l'envoyer à Claude. Avant la v2.1.274, seules les sessions cloud et les routines envoyaient un nom sans correspondance à Claude. Avant la v2.1.273, elles répondaient aussi Unknown command.

Claude Code ne traite pas comme une commande chaque prompt qui commence par /. Il envoie le prompt à Claude comme un message normal lorsque le premier mot après le / commence par un signe de ponctuation, comme le /-- qui ouvre un commentaire de documentation Lean, ou qu'il s'agit d'un chemin comme /var/log/syslog.

Avant la v2.1.236, si vous appuyiez sur Enter alors que le menu des commandes listait une correspondance proche du nom saisi, Claude Code exécutait cette correspondance, donc une faute de frappe comme /hepl exécutait /help au lieu de produire ce message.

Que faire :

• Exécutez le nom suggéré, ou tapez / suivi d'une partie du nom pour voir ce qui est disponible dans cette session
• Si Claude Code signale comme inconnue une commande documentée, consultez sa ligne dans la référence des commandes pour connaître la condition qu'elle indique

Le diff est trop volumineux pour ultrareview

Le diff entre votre branche et la branche de base, y compris les modifications non commitées et indexées, dépasse les limites de taille d'un ultrareview, donc /code-review ultra et la sous-commande claude ultrareview refusent la revue avant le démarrage de la session cloud. Une revue refusée n'utilise pas d'exécution gratuite et ne facture pas de crédits d'utilisation. Le message nomme les limites en vigueur, la taille de votre diff et les fichiers qui contribuent le plus de lignes modifiées. Avant la v2.1.216, le message n'affichait que les statistiques brutes du diff.

Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.

La revue d'une pull request applique les mêmes limites ; cette forme du message commence par PR #<N> is too large for ultrareview et nomme le nombre de fichiers et de lignes de la PR.

Que faire :

• Passez une branche de base plus proche de votre travail, comme /code-review ultra develop, afin que la revue ne couvre que le diff par rapport à cette branche
• Divisez la modification en branches plus petites et faites la revue de chacune. Les fichiers nommés par le message contribuent le plus de lignes modifiées, commencez donc par les déplacer dans leur propre branche.

Impossible de trouver la merge-base avec la branche de base

/code-review ultra et la sous-commande claude ultrareview font la revue du diff entre votre branche et une branche de base, ce qui nécessite un commit commun aux deux. Lorsque git merge-base n'en trouve aucun, Claude Code refuse la revue avant le démarrage de la session cloud. Sur un clone dont Claude Code peut vérifier qu'il est complet, avec au moins une branche, il bascule sur la revue de chaque fichier suivi au lieu de refuser. Vous voyez ce refus lorsque la branche de base est introuvable, lorsque Claude Code ne peut pas vérifier que votre clone est complet, ou dans les rares dépôts où le diff de l'arborescence entière n'est pas possible, comme avec le format d'objets SHA-256.

Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.

L'indication après la première phrase dépend de ce que Claude Code a observé :

• Vous n'avez pas passé de branche de base : Claude Code a comparé avec la branche par défaut du dépôt et suggère de passer explicitement votre branche de base, comme dans l'exemple ci-dessus
• Vous avez passé une branche de base déjà présente dans votre clone : l'indication est Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)
• Vous avez passé une branche de base absente de votre clone : Claude Code l'a récupérée depuis origin avant la comparaison. L'indication est <branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`) ; lorsque Claude Code ne peut pas déterminer si votre clone est superficiel, il suggère git fetch --unshallow origin à la place. Avant la v2.1.221, l'indication suggérait git fetch --unshallow origin pour chaque branche de base récupérée, et sur un clone complet cette commande échoue avec fatal: --unshallow on a complete repository does not make sense.

Que faire :

• Si une autre branche est votre véritable branche de base, passez-la explicitement : /code-review ultra <branch>
• Si votre clone n'a peut-être pas l'historique complet, exécutez git fetch --unshallow origin et relancez la revue

Votre checkout n'a aucune branche

Un checkout peut avoir des commits mais aucune branche : si vous exécutez git init suivi de git fetch <url> et git checkout FETCH_HEAD, vous obtenez un HEAD détaché sans aucune référence. Claude Code empaquette votre dépôt sous forme de bundle git pour le téléverser en vue d'un ultrareview, et il ne peut pas empaqueter un dépôt qui n'a ni branches ni autres références, donc /code-review ultra et la sous-commande claude ultrareview refusent la revue avant le démarrage de la session cloud.

Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.

Avant la v2.1.221, Claude Code tentait de faire la revue de chaque fichier suivi dans ce checkout, et le téléversement échouait.

Que faire :

• Créez une branche sur votre commit actuel avec git checkout -b <name>, puis relancez la revue

Aucun compte GitHub n'est connecté à votre compte Claude

Vous avez exécuté /code-review ultra <PR#> ou claude ultrareview <PR#>, et avant de créer la session cloud, Claude Code demande au serveur si le compte GitHub connecté à votre compte Claude peut accéder au dépôt de la PR. Aucun compte n'est connecté, ou la connexion a expiré, donc le clonage dans le cloud échouerait et Claude Code refuse le lancement. Claude Code ne consomme pas d'exécution gratuite et ne facture pas de crédits d'utilisation pour un lancement refusé.

Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).

Lorsque /web-setup n'est pas disponible dans votre session, le message ne nomme que le lien claude.ai.

Que faire :

• Exécutez /web-setup pour connecter votre connexion GitHub CLI à votre compte Claude, ou connectez un compte sur claude.ai/connect-github
• Relancez la revue une minute après la connexion

Avant la v2.1.248, Claude Code ne vérifiait pas cela avant le lancement.

Votre compte GitHub connecté ne peut pas voir le dépôt

Vous avez exécuté /code-review ultra <PR#> ou claude ultrareview <PR#>, et le compte GitHub connecté à votre compte Claude ne peut pas lire le dépôt de la PR, donc le clonage dans le cloud échouerait et Claude Code refuse le lancement. Claude Code ne consomme pas d'exécution gratuite et ne facture pas de crédits d'utilisation pour un lancement refusé.

Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.

Lorsque /web-setup n'est pas disponible dans votre session, le message ne nomme que l'installation de l'application.

Que faire :

• Si votre CLI gh locale peut lire le dépôt, exécutez /web-setup pour connecter cette connexion à votre compte Claude
• Relancez la revue après la modification

Avant la v2.1.248, Claude Code ne vérifiait pas cela avant le lancement.

La vérification préalable de la GitHub App a échoué de manière transitoire

Vous avez démarré une session cloud depuis un dépôt local, et deux étapes ont échoué ensemble. Claude Code n'a pas pu construire ou téléverser le bundle de votre dépôt. Avant le téléversement, il a vérifié si le service cloud peut cloner le dépôt depuis GitHub, et au lieu d'une réponse définitive, cette vérification s'est terminée par une erreur qu'une nouvelle tentative pourrait résoudre, comme une erreur réseau, un délai d'expiration ou une erreur serveur temporaire. Le message complet commence par ce qui a empêché le bundle, par exemple Could not upload repo bundle (<error>), et se termine par la phrase concernant la vérification préalable :

Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead

Que faire :

• Relancez la commande après un moment. Lorsque la vérification GitHub réussit, Claude Code peut démarrer la session à partir d'un clone GitHub, donc l'échec du téléversement ne bloque plus le lancement
• Si les nouvelles tentatives continuent d'échouer, le début du message nomme ce qui a empêché le téléversement. Lorsque cette cause est quelque chose que vous pouvez corriger, corrigez-la afin que la session puisse démarrer à partir de votre dépôt local

Avant la v2.1.251, Claude Code terminait le message par Please set up GitHub on https://claude.ai/code même lorsque la vérification GitHub n'avait échoué que de manière transitoire, et un conseil de configuration ne peut pas résoudre un échec transitoire.

Le téléversement du dépôt ne peut pas suivre un paramètre git

Vous avez démarré une session cloud qui téléverse votre dépôt local, ou un ultrareview d'une branche, et le téléversement ne peut pas suivre l'un des paramètres git qui déterminent quelles règles d'attributs s'appliquent à vos fichiers. Si le téléversement se poursuivait en manquant une règle, un fichier que git transforme avant de le stocker, comme un fichier chiffré par un filtre clean, pourrait atteindre le cloud tel qu'il est sur le disque. Claude Code refuse donc le téléversement, et rien n'est téléversé :

Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.

Le message nomme le paramètre et l'endroit où il est défini, et se termine par la solution correspondant à votre cas. Le même refus apparaît pour core.attributesFile et attr.tree, chacun avec sa propre solution.

Le message peut nommer un fichier de configuration que votre configuration git inclut via une directive include ou includeIf, même lorsque la condition de cette directive ne s'applique pas à ce dépôt.

Que faire :

• Appliquez la solution indiquée dans la dernière phrase du message

GitHub n'est pas connecté à votre compte Claude

Vous avez démarré une session cloud depuis votre dépôt local, par exemple avec /autofix-pr. Aucun compte GitHub n'est connecté à votre compte Claude, ou la connexion a expiré, donc Claude Code refuse le lancement :

GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github

Lorsque vous créez une routine avec /schedule, le même message apparaît sous forme de note de configuration qui nomme le dépôt ; la note n'empêche pas la création de la routine.

Que faire :

• Exécutez /web-setup pour connecter votre connexion GitHub CLI à votre compte Claude, ou connectez un compte sur claude.ai/connect-github. Consultez Options d'authentification GitHub pour connaître les différences entre les deux.
• Relancez la commande une minute après la connexion

Avant la v2.1.268, Claude Code signalait cette situation comme un échec temporaire de la vérification de la Claude GitHub App et suggérait de réessayer ou d'installer l'application ; aucune de ces actions ne connecte de compte GitHub.

Autorisation d'authentification unique requise

Vous avez exécuté /install-github-app et choisi un dépôt dont l'organisation impose l'authentification unique SAML. Avant la configuration, Claude Code vérifie votre accès au dépôt avec la GitHub CLI, et GitHub a refusé cette vérification parce que votre jeton gh n'est pas encore autorisé pour l'organisation. L'assistant affiche l'avertissement avec les étapes d'autorisation :

Single sign-on authorization needed
<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.

Que faire :

• Réautorisez votre connexion GitHub CLI avec les scopes repo et workflow en exécutant gh auth refresh -h github.com -s repo,workflow, et autorisez l'organisation lorsque GitHub vous le demande pour l'authentification unique
• Si vous vous authentifiez avec un jeton d'accès personnel dans GH_TOKEN, ouvrez github.com/settings/tokens, sélectionnez Configure SSO sur le jeton et autorisez l'organisation
• Exécutez à nouveau /install-github-app

Avant la v2.1.273, Claude Code affichait l'avertissement Admin permissions required pour cette situation à la place.

Échec de la reprise de la conversation

Claude Code n'a pas pu lire ou traiter la transcription enregistrée de la session que vous avez sélectionnée dans le sélecteur claude --resume, il met donc fin au processus plutôt que de continuer dans un état partiellement chargé. Le message inclut la commande pour réessayer :

Failed to resume the conversation.
Run claude --resume <session-id> to retry, or claude to start a new session.

Claude Code se termine avec le code 1 après avoir affiché le message. Le sélecteur /resume au sein d'une session en cours signale plutôt Failed to resume conversation dans la conversation, et votre session actuelle continue de s'exécuter. Avant la v2.1.216, une reprise échouée depuis le sélecteur claude --resume restait indéfiniment sur l'indicateur Resuming conversation… au lieu d'afficher ce message.

Que faire :

• Exécutez claude --resume <session-id> avec l'ID de session du message pour réessayer
• Sur une version antérieure à la v2.1.285, si la nouvelle tentative échoue de la même façon, exécutez claude update et reprenez à nouveau la session. Ces versions font échouer la reprise lorsque la transcription enregistrée contient une entrée qu'elles ne savent pas lire.
• Si la nouvelle tentative échoue encore, exécutez claude pour démarrer une nouvelle session

Aucune conversation trouvée avec l'ID de session

Vous avez transmis un ID de session à claude --resume <session-id> et aucune transcription enregistrée ne lui correspondait :

No conversation found with session ID: <session-id>

Claude Code se termine avec le code 1 après avoir affiché le message. Claude Code recherche l'ID d'abord dans le projet actuel, puis dans tous les autres projets de cette machine. Avant la v2.1.223, la recherche s'arrêtait au répertoire du projet actuel et à ses worktrees git ; reprenez donc la session depuis le répertoire dans lequel elle a travaillé en dernier.

Causes courantes :

• ID mal saisi : pour une exécution non interactive, l'ID correspond au champ session_id de la sortie --output-format json
• Transcription supprimée : Claude Code supprime les transcriptions après la période de rétention, 30 jours par défaut, selon les règles de nettoyage de rétention
• Machine différente : Claude Code stocke les transcriptions localement ; reprenez donc la session sur la machine où elle s'est exécutée
• Copies en double : si vous avez copié un répertoire de projet sous ~/.claude/projects de sorte que deux transcriptions portent le même ID, Claude Code affiche ce message plutôt que de reprendre arbitrairement l'une des copies

Que faire :

• Pour une session interactive, ouvrez le sélecteur de sessions avec claude --resume et appuyez sur Ctrl+A pour l'étendre à tous les projets de cette machine, puis sélectionnez la session
• Les sessions créées avec claude -p ou l'Agent SDK n'apparaissent pas dans le sélecteur ; vérifiez donc à nouveau l'ID par rapport au session_id affiché par votre exécution d'origine

Windows a signalé une erreur (EBADF) lorsque Claude Code a lu le fichier de transcription de cette session

Vous avez repris une session sous Windows, son fichier de transcription enregistré s'est ouvert normalement, puis sa lecture a échoué avec l'erreur système EBADF. L'erreur système n'indique pas pourquoi la lecture a échoué ; le message suggère donc des causes probables et des solutions à essayer :

Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.

Le message suit la ligne d'échec propre à la commande, comme Failed to resume session <session-id>. Une commande claude --resume ou claude -p se termine avec le code 1 après l'avoir affiché. Après /resume au sein d'une session, votre session actuelle continue de s'exécuter.

Que faire :

• Excluez le dossier contenant vos transcriptions de session des logiciels qui analysent ou interceptent les lectures de fichiers, tels que les outils de sécurité, de chiffrement ou de gestion des terminaux. Les transcriptions se trouvent par défaut sous %USERPROFILE%\.claude\projects, ou sous le répertoire désigné par CLAUDE_CONFIG_DIR
• Si vous ne pouvez pas ajouter d'exclusion, ajoutez plutôt Claude Code aux applications autorisées de ce logiciel
• Reprenez à nouveau la session

Avant la v2.1.282, l'échec ne s'accompagnait d'aucune explication : claude --resume <session-id> se terminait sur Failed to resume session <session-id>, et une exécution -p n'affichait que le texte de l'erreur système, comme Failed to resume session: EBADF: bad file descriptor, read.

Impossible de changer de moteur de rendu dans cette session

Lorsque vous changez de moteur de rendu, Claude Code redémarre son processus. Vous avez exécuté /tui dans une session que Claude Code refuse de redémarrer ; il ne change donc pas de moteur et n'enregistre rien. Le message que vous voyez vous indique la cause :

• Cannot switch renderers while work is running in the background : vous avez des tâches en arrière-plan qu'un redémarrage abandonnerait, comme un shell en arrière-plan ou un sous-agent. Attendez la fin de ces tâches ou arrêtez-les avec /tasks, puis exécutez à nouveau /tui fullscreen ou /tui default
• Cannot switch renderers in this session : la session comporte des restrictions que Claude Code ne peut pas transmettre au processus redémarré. Avant la v2.1.234, Claude Code redémarrait malgré tout et la session relancée s'exécutait sans elles

Dans le message sur les restrictions, la partie entre parenthèses nomme les restrictions détectées par Claude Code :

Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.

Chaque raison que le message peut afficher entre parenthèses :

• launch flags: a custom system prompt, a tool allowlist, or restricted settings : vous avez démarré la session avec un flag que Claude Code ne retransmet pas au processus redémarré. Ces flags incluent --system-prompt, --system-prompt-file, --append-system-prompt-file, une liste d'autorisation --tools, --setting-sources et --permission-prompt-tool
• permission rules set for this session only : une mise à jour de permissions provenant d'un hook ou d'un appelant SDK a ajouté des règles de refus ou de demande avec la destination session. Les règles d'autorisation limitées à la session ne déclenchent pas le refus. Un redémarrage les supprime, et Claude Code vous demande à nouveau à la place
• ask-before-running rules with no command-line form : une mise à jour de permissions provenant d'un hook ou d'un appelant SDK a ajouté des règles de demande en plus des règles que Claude Code retransmet sous forme de --allowed-tools et --disallowed-tools. Aucun flag n'existe pour les règles de demande
• permission rules a command line cannot carry intact et added directories a command line cannot carry intact : une mise à jour de permissions a ajouté une règle ou un chemin de répertoire en cours de session. La ligne de commande du processus redémarré ne peut pas transporter son texte sous la même valeur

Que faire :

• Dans une session démarrée sans ces restrictions, exécutez /tui fullscreen, ou /tui default pour revenir en arrière. Claude Code y enregistre le paramètre tui

Impossible d'ouvrir Claude Desktop

Vous avez exécuté /desktop ou son alias /app dans une session, ou claude --desktop dans votre shell, et la commande système qu'utilise Claude Code pour ouvrir Claude Desktop a échoué. Après /desktop, la session reste dans le terminal ; claude --desktop affiche le message sans le préfixe Error: et se termine avec le statut 1.

Le texte entre parenthèses nomme la commande qui a échoué, avec son statut de sortie et la première ligne de sa sortie d'erreur lorsqu'elle les a produits. Sous macOS, cette commande est open, comme dans cet exemple ; sous Windows, il s'agit de rundll32 :

Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.

Que faire :

• Ouvrez vous-même Claude Desktop, puis exécutez à nouveau /desktop ou claude --desktop
• Pour lire la sortie d'erreur complète de la commande ayant échoué, activez la journalisation de débogage avec /debug et exécutez à nouveau /desktop, ou exécutez claude --desktop --debug-file <path>, puis consultez le log de débogage

Avant la v2.1.285, le message se terminait par Open Claude Desktop and run /desktop again. Avant la v2.1.275, il s'agissait de Failed to open Claude Desktop. Please try opening it manually. et il n'indiquait pas ce qui avait échoué.

/terminal-setup a laissé votre keymap Zed inchangé

Vous avez exécuté /terminal-setup dans Zed, et Claude Code n'a pas pu terminer la mise à jour de votre fichier Zed keymap.json ; il a donc laissé le fichier tel quel.

Chaque message nomme le chemin de votre keymap et se termine par le bloc de raccourci clavier à ajouter vous-même :

Couldn't update your Zed keymap, so it was left unchanged.
To add the binding yourself, add this block to the keymap array in <path to keymap.json>:
{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }

La première ligne du message nomme la cause :

• Couldn't read your Zed keymap, so it was left unchanged. : Claude Code n'a pas pu lire le fichier, par exemple en raison des permissions du fichier
• Your Zed keymap isn't a readable list of keybindings, so it was left unchanged. : le fichier a été lu correctement mais ne s'analyse pas comme un tableau de blocs de raccourcis clavier, même en autorisant les commentaires // et les virgules finales
• Couldn't back up your Zed keymap; not modifying it. : Claude Code n'a pas pu copier le fichier vers une sauvegarde .bak à côté de celui-ci ; il n'a donc rien modifié
• Couldn't update your Zed keymap, so it was left unchanged. : le résultat fusionné n'a pas été validé comme un keymap valide contenant le raccourci ; Claude Code l'a donc abandonné au lieu de l'écrire. Un bloc de raccourci clavier contenant une clé en double peut en être la cause

Que faire :

• Copiez le bloc du message dans le tableau de premier niveau de votre keymap.json, au chemin indiqué par le message
• Pour isn't a readable list of keybindings, corrigez l'erreur de syntaxe, ou faites de la valeur de premier niveau du fichier un tableau, puis exécutez à nouveau /terminal-setup

Avant la v2.1.247, /terminal-setup ne pouvait pas analyser un keymap Zed utilisant des commentaires // ou des virgules finales, et il remplaçait l'intégralité du fichier par son seul raccourci tout en signalant ce raccourci comme installé. Pour restaurer un keymap remplacé par une version antérieure, utilisez le fichier de sauvegarde .bak décrit dans Saisir des prompts multilignes.

Les rapports d'utilisation des skills ne sont pas disponibles sur cette connexion

Vous avez exécuté /skill-doctor via Remote Control, depuis votre téléphone ou votre navigateur. Claude Code n'envoie pas le rapport d'utilisation des skills via Remote Control et répond par ce message à la place :

Skill usage reports are not available on this connection.

Que faire :

• Exécutez /skill-doctor dans le terminal de la machine sur laquelle la session s'exécute, ou exécutez-y claude -p "/skill-doctor"

Les styles de sortie personnalisés ne peuvent pas être sélectionnés via Remote Control

Vous avez exécuté /output-style depuis l'application mobile ou le web via Remote Control, ou la commande est arrivée dans un message relayé dans la session. Comme un tel tour peut ne pas provenir du titulaire du compte, Claude Code n'y liste et n'y sélectionne que les styles intégrés, et ajoute cet avertissement chaque fois que la commande liste les styles ou ne reconnaît pas le nom que vous avez indiqué. Un nom de style personnalisé obtient la même réponse qu'un nom inexistant :

Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.

Que faire :

• Choisissez un style intégré, par exemple /output-style concise
• Pour utiliser un style personnalisé, définissez outputStyle dans le fichier .claude/settings.local.json du projet, ou exécutez /output-style <style> dans le terminal propre à la session, si elle en possède un

Les styles de sortie sont enregistrés dans les paramètres locaux, que cette session ne charge pas

Vous avez essayé de changer de style de sortie avec /output-style <style> ou /config outputStyle=<style> dans une session dont les sources de paramètres excluent local. Par exemple, une session Agent SDK dont le settingSources omet "local", ou une session CLI démarrée avec une valeur --setting-sources qui omet local. Les deux commandes enregistrent le style dans .claude/settings.local.json, un fichier qu'une telle session ne relit jamais ; Claude Code refuse donc au lieu d'écrire un paramètre qui n'aurait aucun effet :

Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.

Que faire :

• Ajoutez local aux sources de paramètres de la session et changez à nouveau de style
• Définissez la clé outputStyle dans un fichier de paramètres que la session charge, comme .claude/settings.json dans le projet ou ~/.claude/settings.json. Dans le SDK TypeScript, définissez plutôt outputStyle dans l'objet settings en ligne ; consultez Activer un style de sortie

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.

plugin eval is currently in early access

Vous avez exécuté claude plugin eval ou claude plugin eval init et il a quitté avec le code 1 avec l'un de ces messages avant de faire quoi que ce soit :

`plugin eval` is currently in early access

`plugin eval` is currently unavailable

Le premier message signifie que votre build est plus ancien que v2.1.269, la première version où la commande est généralement disponible. Le second signifie qu'Anthropic a désactivé la commande côté serveur ; rien sur votre machine ne la réactive.

Que faire :

• Exécutez claude --version, puis claude update, et exécutez la commande à nouveau dans une nouvelle session. Consultez les exigences pour les évaluations de plugins
• Si vous voyez le second message sur une build actuelle, réessayez plus tard après un autre claude update

Marketplace is registered from an untrusted source

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, donc la marketplace et les plugins installés à partir de celle-ci cessent de se charger. Avant v2.1.205, 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.

Pour une marketplace dont la source n'est pas un référentiel GitHub ou une URL Git, comme un répertoire local, la phrase du milieu se lit can only be used with GitHub sources from the 'anthropics' organization à la place. claude plugin marketplace add exécute la même vérification et refuse un nom réservé avec Failed to add marketplace: suivi de la même phrase de nom réservé.

Que faire :

• Si la marketplace est déjà enregistrée, exécutez claude plugin marketplace remove <name>, puis ajoutez-la à nouveau à partir du référentiel officiel github.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 Marketplace schema

Marketplace name is another spelling of a reserved name

Le nom de la marketplace n'est pas lui-même un nom réservé, mais Claude Code le traite comme une autre orthographe d'un. Reserved names énumère les orthographes qui comptent comme un nom réservé. Claude Code refuse un tel nom quand vous ajoutez la marketplace :

Failed to add marketplace: "claude.code.plugins" is another spelling of "claude-code-plugins", a reserved marketplace name.

Quand une marketplace est déjà enregistrée sous un tel nom, son entrée cesse de se charger, et /plugin, claude plugin install, et claude plugin update avertissent :

known_marketplaces.json has an entry named "claude.code.plugins", another spelling of the reserved marketplace name "claude-code-plugins", so it is ignored. Remove it with: claude plugin marketplace remove claude.code.plugins

Quand le nom aurait besoin de guillemets shell, le refus au moment de l'ajout se lit This marketplace's name is another spelling of "<reserved>", a reserved marketplace name. It is not exactly the reserved name it appears to be.

Que faire :

• Renommez la marketplace en un nom qui n'orthographie pas un nom réservé et ajoutez-la à nouveau
• Pour l'avertissement d'entrée ignorée, exécutez la commande claude plugin marketplace remove qu'il donne, ou supprimez l'entrée de ~/.claude/plugins/known_marketplaces.json

Claude Code refuses the marketplace name

Le nom d'une marketplace enregistrée usurpe l'identité d'une marketplace officielle d'Anthropic selon les règles que cette section énumère.

Si une marketplace a été enregistrée sous un tel nom avant que la vérification ne la bloque, la marketplace et les plugins installés à partir de celle-ci cessent de se charger, car Claude Code vérifie le nom chaque fois qu'il lit le catalogue de la marketplace. Quand le nom imite un nom officiel, claude plugin list et l'onglet Errors de /plugin rapportent chaque plugin affecté avec un message qui commence :

Claude Code refuses the marketplace name "anthropic-plugins-v2"

Pour un nom qui imite, l'erreur de la marketplace elle-même se lit Claude Code refuses this marketplace's name: it looks like one of Anthropic's own à la place. claude plugin marketplace add refuse tout nom qui usurpe l'identité avec Marketplace name impersonates an official Anthropic/Claude marketplace.

Avant v2.1.282, claude plugin list et /plugin rapportaient les plugins d'un nom qui imite comme échoués à charger aussi, sans nommer le nom de la marketplace comme la cause.

Que faire :

• Exécutez claude plugin marketplace remove <name>. Cela désinstalle aussi les plugins installés à partir de la marketplace et supprime leurs données sauvegardées
• Pour conserver la marketplace à la place, attendez que son responsable la renomme, puis exécutez claude plugin marketplace update <name>
• Si vous publiez la marketplace, renommez-la dans votre marketplace.json ; les utilisateurs mettent alors à jour la marketplace au lieu de la supprimer

Marketplace is already added from a different source

Vous avez confirmé l'ajout d'une marketplace via /plugin install <plugin> --marketplace <source>, et le catalogue que Claude Code a récupéré à partir de cette source se nomme lui-même de la même façon qu'une marketplace que vous avez déjà ajoutée à partir d'une source différente. Claude Code conserve la marketplace existante au lieu de la remplacer, et le plugin n'est pas installé.

Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

Que faire :

• Si la marketplace que vous avez déjà ajoutée est celle que vous voulez, installez à partir de celle-ci par nom : /plugin install <plugin>@<name>
• Pour basculer vers la nouvelle source, exécutez /plugin marketplace remove <name>, puis réessayez l'installation

Plugin command references user\_config in a shell command

Un hook de plugin, un monitor, ou une commande MCP headersHelper référence une option de plugin ${user_config.KEY}, et la chaîne substituée serait passée à un shell. Une valeur configurée contenant $(...), des backticks, ou ; s'exécuterait comme du code là-bas, donc Claude Code refuse de démarrer le composant au lieu de substituer la valeur. La vérification s'exécute sur le modèle de commande, donc l'erreur apparaît même quand aucune valeur n'est encore configurée. Avant v2.1.207, la valeur était substituée dans la commande shell.

La formulation dépend de quelle surface a référencé l'option. Un hook de forme shell rapporte :

Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}

Un monitor rapporte :

Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.

Un MCP headersHelper rapporte :

headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).

Que faire :

• Pour un hook, ajoutez un tableau args pour qu'il s'exécute en forme exec, où chaque ${user_config.KEY} devient un argument sans shell entre les deux. Ou supprimez la référence et lisez la variable d'environnement $CLAUDE_PLUGIN_OPTION_<KEY> à l'intérieur du script
• Pour un monitor, supprimez la référence et faites en sorte que le script monitor lise la valeur à partir d'un fichier de configuration
• Pour un headersHelper, déplacez ${user_config.KEY} dans le champ headers du serveur, qui n'est pas analysé par shell, ou lisez la valeur à l'intérieur du script helper

Plugin archive integrity check failed

L'entrée de marketplace du plugin utilise une source archive avec une épingle sha256, et le digest du fichier téléchargé ne correspond pas à l'épingle. Claude Code refuse l'installation, donc rien ne change dans le cache du plugin. L'inadéquation a trois causes possibles :

• Le fichier à l'URL a changé après que l'auteur ait calculé l'épingle
• L'auteur a entré le mauvais digest dans l'entrée de marketplace
• L'URL sert un fichier différent de celui que l'auteur a épinglé

Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.

Que faire :

• Si vous publiez le plugin, recalculez le digest du fichier exact que l'URL sert, par exemple avec shasum -a 256 my-plugin.zip, ou Get-FileHash -Algorithm SHA256 my-plugin.zip dans PowerShell, et mettez à jour le sha256 dans l'entrée de marketplace
• Si vous installez le plugin, exécutez /plugin marketplace update <name> pour actualiser le catalogue au cas où l'entrée aurait été corrigée, puis réessayez l'installation
• Si les digests ne correspondent toujours pas après une actualisation, demandez au propriétaire de la marketplace quel fichier il a épinglé avant d'installer

Path escapes plugin directory

Un chemin de composant de plugin, déclaré dans le plugin.json du plugin ou dans son entrée de marketplace, se résout en dehors du répertoire du plugin. Claude Code supprime ce chemin et charge le reste du plugin. Le nom du composant dans le message, comme commands ou hooks, nomme le champ qui a déclaré le chemin.

commands path escapes plugin directory: ./../shared.md

Dans la sortie de la commande claude plugin, la même erreur se lit Path escapes plugin directory: ./../shared.md (commands).

Claude Code rejette à la fois un chemin qui pointe en dehors du plugin tel qu'écrit, comme ../shared-utils, et un lien symbolique qui mène en dehors du plugin et n'en est pas un que les règles de lien symbolique de marketplace permettent. Pour un lien symbolique, le message indique également où le chemin se résout :

commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory

Sur macOS et Linux, Claude Code rejette également un chemin de composant qui contient une barre oblique inverse n'importe où dedans, même quand le chemin reste à l'intérieur du plugin. Un plugin dont les chemins de composant utilisent des séparateurs de style Windows se charge sur Windows et déclenche ce rejet sur les autres plates-formes :

commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform

Avant v2.1.251, Claude Code chargeait un chemin commands déclaré dans une entrée de marketplace même quand il pointait en dehors du répertoire du plugin.

Avant v2.1.257, la vérification ne regardait que l'orthographe du chemin, pas où un lien symbolique mène.

Que faire :

• Déplacez le fichier référencé à l'intérieur du répertoire du plugin et pointez le chemin vers lui avec un chemin relatif ./
• Si le chemin est un lien symbolique vers un fichier en dehors du plugin, remplacez le lien symbolique par une copie du fichier
• Si le message dit que le chemin contient une barre oblique inverse, écrivez le chemin avec des barres obliques avant, par exemple ./commands/deploy.md
• Pour partager des fichiers avec d'autres plugins dans la même marketplace, liez-les avec un lien symbolique à l'intérieur du répertoire du plugin, en suivant les règles de lien symbolique

Path could not be checked

Claude Code a demandé au système d'exploitation si un chemin de plugin existe et a reçu une erreur autre que « non trouvé », donc il ne charge pas ce que le chemin nomme. La quantité du plugin qui se charge dépend du chemin qui a échoué :

• L'un des emplacements de composant par défaut d'un plugin, comme le dossier skills/, le fichier monitors/monitors.json, ou un SKILL.md à la racine du plugin : les autres composants du plugin se chargent toujours
• Le répertoire du plugin lui-même : rien de ce plugin ne se charge

Vous ne voyez pas cette erreur pour un chemin qui n'existe pas du tout. Dans /plugin, l'erreur apparaît sous le plugin et nomme le chemin et le code que le système d'exploitation a retourné :

skills path could not be checked: /home/user/my-plugin/skills (ELOOP)

Dans claude plugin list, la même erreur se lit Path not found: /home/user/my-plugin/skills (skills, ELOOP).

Les causes qui produisent cette erreur incluent :

• ELOOP : un lien symbolique dans le chemin pointe sur lui-même ou forme une boucle
• EIO ou ESTALE : le chemin est sur un montage réseau qui est cassé ou obsolète
• EACCES : l'un des répertoires au-dessus du chemin vous refuse la permission de le traverser

Que faire :

• Remplacez un lien symbolique qui pointe sur lui-même par un vrai dossier, ou supprimez-le
• Si le chemin est sur un montage réseau, remontez le partage
• Si le code est EACCES, restaurez votre permission d'exécution sur les répertoires au-dessus du chemin
• Exécutez /reload-plugins après avoir corrigé le chemin, ou redémarrez Claude Code, pour charger le plugin ou le composant

Avant v2.1.265, Claude Code traitait un dossier de composant par défaut qu'il ne pouvait pas vérifier comme absent et chargeait le plugin sans ce composant, sans erreur.

Marketplace entry path does not stay inside the marketplace directory

L'entrée de marketplace du plugin déclare un chemin source que Claude Code ne peut pas résoudre à un emplacement à l'intérieur du répertoire de la marketplace elle-même, donc le plugin ne s'installe pas ou ne se charge pas. Le refus couvre :

• Un chemin d'entrée qui est absolu, grimpe en dehors de la marketplace avec .., ou est orthographié comme un chemin réseau
• Sur macOS et Linux, un chemin d'entrée qui contient une barre oblique inverse n'importe où après le ./ initial
• Une entrée dans une marketplace récupérée à partir d'une source distante, comme git ou une URL, qui atteint sa cible via un lien symbolique se résolvant en dehors du répertoire de la marketplace
• Une entrée relative dans une marketplace ajoutée à partir d'une URL directe vers son marketplace.json : Claude Code télécharge uniquement ce fichier, donc aucun fichier de plugin local n'existe pour que le chemin nomme. Consultez Plugins with relative paths fail in URL-based marketplaces

claude plugin install rapporte le refus comme ceci :

Cannot install my-plugin@my-marketplace: its marketplace entry path does not stay inside the marketplace directory (an absolute, climbing, network-shaped, backslash-containing or link-traversing entry, an entry of a fetched marketplace that resolves or opens outside its tree — or a relative entry in a url-catalog marketplace, which has no local directory)

Quand une entrée d'un plugin déjà installé échoue la même vérification, claude plugin list affiche le plugin comme failed to load avec :

Plugin source path refused: ./my-plugin does not stay inside its marketplace directory. Check that the marketplace entry has a plain relative path.

Que faire :

• Si vous maintenez la marketplace, écrivez la source de l'entrée comme un chemin relatif simple avec des barres obliques avant, comme ./plugins/my-plugin, et gardez tout lien symbolique qu'il traverse pointé à l'intérieur du répertoire de la marketplace
• Si vous avez ajouté la marketplace à partir d'une URL directe, les entrées relatives ne peuvent pas se résoudre. Demandez à l'auteur de la marketplace d'utiliser une autre source de plugin, ou ajoutez la marketplace à partir de son référentiel git à la place

Failed to load marketplace configuration

Claude Code garde les marketplaces de plugins que vous avez ajoutées dans un fichier de registre à ~/.claude/plugins/known_marketplaces.json. Une commande de plugin qui a besoin du registre, comme claude plugin install, échoue avec l'un de deux messages quand Claude Code ne peut pas utiliser le fichier :

• Failed to load marketplace configuration : le fichier n'est pas un JSON valide, ou ne peut pas être lu. Un fichier vide échoue de cette façon aussi.
• Marketplace configuration file is corrupted : le fichier est un JSON valide mais son contenu ne correspond pas au schéma du registre.

Avec un fichier vide, claude plugin install rapporte :

✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF

Avant v2.1.246, claude plugin install ne rapportait pas cet échec.

Que faire :

• Ouvrez ~/.claude/plugins/known_marketplaces.json et réparez le JSON, ou corrigez les entrées que le message nomme comme ne correspondant pas au schéma du registre
• Si vous ne pouvez pas le réparer, supprimez le fichier ou remplacez son contenu par {}, puis rajoutez chaque marketplace avec claude plugin marketplace add <source>. Claude Code réenregistre les marketplaces que vos paramètres utilisateur ou gérés déclarent dans extraKnownMarketplaces la prochaine fois que vous le démarrez dans un dossier que vous avez approuvé.

Plugin is required by your organization

Vous avez exécuté claude plugin disable, ou utilisé l'onglet Installed de /plugin, pour désactiver un plugin synchronisé à partir de claude.ai que votre organisation marque comme requis :

Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.

Claude Code ne sauvegarde rien et le plugin reste activé.

Quand vous essayez de désactiver un plugin dont un plugin requis dépend, Claude Code refuse de la même façon, avec un message nommant le plugin requis qui en a besoin.

Que faire :

• Demandez à un administrateur de votre organisation claude.ai de modifier le statut requis du plugin sur claude.ai

Plugin was not uninstalled

Vous avez exécuté claude plugin uninstall, ou choisi Uninstall dans l'onglet Installed de /plugin, et la désinstallation s'est arrêtée avec un message commençant par "<plugin>" was not uninstalled:. Si le texte après ce deux-points commence par installed_plugins.json au lieu de nommer un fichier de paramètres, la cause est du contenu dans installed_plugins.json que cette version de Claude Code ne peut pas lire. Pour cette forme, consultez installed_plugins.json holds a record this version can't read.

Quand Claude Code a supprimé l'entrée du plugin de enabledPlugins et a relancé les fichiers de paramètres de cette portée, soit le plugin était toujours activé là, soit un fichier qui pourrait l'activer ne pouvait pas être lu ou vérifié. Supprimer les options sauvegardées du plugin, les secrets et les données tandis qu'une entrée de paramètres pourrait le réactiver les perdrait, donc la désinstallation s'arrête à la place : le plugin reste installé et rien qu'il a sauvegardé n'est supprimé.

✘ Failed to uninstall plugin "formatter": "formatter" was not uninstalled: it is still switched on in /home/user/project/.claude/settings.local.json, although the settings change reported no error. It is still installed. Take it out of "enabledPlugins" in that file yourself, then uninstall it again.

Le milieu du message nomme le fichier et la cause :

• it is still switched on in <file>, although the settings change reported no error : l'écriture des paramètres a rapporté le succès mais l'entrée est toujours là quand le fichier est relancé
• it is still switched on in <file>, and the settings change failed (<error>) : le fichier ne pouvait pas être sauvegardé, pour la raison entre parenthèses
• <file> is there and could not be read : le fichier existe mais ne pouvait pas être lu comme paramètres, par exemple parce qu'il n'est pas un JSON valide, donc il peut toujours activer le plugin
• <file> (not read: it is on a network path or is a link to one, or could not be checked) : Claude Code n'a pas lu le fichier de paramètres du projet ou local parce que le fichier, ou le dossier .claude qui le contient, est un lien qui mène à un emplacement réseau, ou parce qu'il ne pouvait pas examiner ce chemin

claude plugin uninstall quitte avec le code 1, et avec --json le résultat porte failureCode: "settings_still_on". /plugin affiche le même message.

Que faire :

• Suivez la dernière phrase du message : réparez ou remplacez le fichier de paramètres qu'il nomme, ou supprimez l'entrée du plugin de enabledPlugins dans ce fichier vous-même, puis exécutez la désinstallation à nouveau

Erreurs d'outils

Ces erreurs proviennent des outils intégrés de Claude. Claude corrige la plupart des erreurs d'outils de lui-même. Quand l'une d'elles nécessite une modification de votre part, la liste Que faire de cette erreur indique ce qu'il faut modifier.

Agent would be spawned with zero tools

Chaque entrée de la liste tools du sous-agent n'a pas correspondu à un outil utilisable, donc Claude Code a refusé de lancer le sous-agent : sans outils, il ne pouvait pas agir. Le message regroupe vos entrées par ce qui s'est mal passé :

• Unrecognized : l'entrée ne correspond à aucun nom d'outil, généralement une faute de frappe comme Grpe pour Grep.
• Not available to subagents : l'entrée nomme un outil réel que les sous-agents ne peuvent pas utiliser. Les sous-agents en arrière-plan conservent un ensemble d'outils intégrés plus petit, donc une entrée qui ne peut être utilisée que par un sous-agent au premier plan se retrouve ici quand le sous-agent s'exécuterait en arrière-plan, ce qui est le comportement par défaut. Si vous listez Agent, le message le signale dans le groupe suivant à la place.
• Matched no tools in this session : l'entrée est valide mais aucun outil de la session actuelle ne correspond actuellement, comme mcp__github__* sans serveur MCP GitHub connecté, ou Agent pour un sous-agent à la limite de profondeur.

Omettre le champ tools ne déclenche jamais ce refus. Si vous laissez la liste tools vide, ou si disallowedTools supprime chaque entrée, Claude Code ignore également le refus et lance le sous-agent sans outils.

Avant la v2.1.208, le sous-agent était lancé sans outils et pouvait retourner un résultat vide ou confus.

Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.

Que faire :

• Corrigez chaque entrée que l'erreur nomme par rapport aux outils disponibles pour les sous-agents
• Supprimez les entrées pour les outils que la session n'a pas, comme les outils MCP d'un serveur qui n'est pas connecté
• Pour un outil que les sous-agents en arrière-plan abandonnent, comme CronCreate, supprimez l'entrée. Pour conserver l'outil, désactivez le mode fork et demandez à Claude d'exécuter le sous-agent au premier plan
• Supprimez le champ tools au lieu de lister les outils pour donner au sous-agent chaque outil disponible pour les sous-agents
• Pour une liste tools qui contient uniquement Agent, augmentez la limite de profondeur ou donnez à l'agent au moins un autre outil : Claude Code retient Agent à cette limite, donc une liste avec rien d'autre dedans se résout à aucun outil

File is covered by a Read deny rule

L'outil Edit ou Write a été appelé sur un chemin correspondant à une règle de refus Read, y compris la création d'un nouveau fichier à ce chemin. Les deux outils modifient le contenu que Claude doit pouvoir relire, donc Claude Code refuse l'appel avant tout accès au fichier. NotebookEdit n'est pas couvert par les règles de refus Read. Avant la v2.1.228, la règle bloquait uniquement l'outil Edit, et avant la v2.1.208, seule une règle de refus Edit bloquait les modifications.

File is covered by a Read deny rule in your permission settings and cannot be edited.

Quand Claude Code refuse l'outil Write, le message se termine par and cannot be written à la place.

Que faire :

• Si Claude doit pouvoir modifier le fichier, supprimez ou réduisez la règle de refus Read dans /permissions ou dans les paramètres
• Si le fichier doit rester inchangé, conservez la règle et ajoutez une règle de refus Edit pour le même chemin pour bloquer également l'outil NotebookEdit

Path cannot contain null bytes

Un appel d'outil de fichier avait un argument de chemin ou de motif contenant un octet nul, que les systèmes de fichiers et les outils de recherche ne peuvent pas accepter. Read, Write, Edit, NotebookEdit, Glob, et Grep vérifient cela, et le message nomme l'outil et l'argument :

Read file_path cannot contain null bytes (\0). Remove the null byte and try again.

L'appel d'outil échoue, Claude voit l'erreur, et le tour continue.

Que faire :

• Rien de votre côté : l'erreur est retournée à Claude comme le résultat de l'outil, et le message lui-même indique à Claude de supprimer l'octet nul et de réessayer

Avant la v2.1.281, un octet nul dans un chemin Read, Write, Edit, ou NotebookEdit terminait tout le tour avec une erreur nommant Path contains null bytes, et l'outil ne s'exécutait jamais.

subagent\_type is required

subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...

Claude a appelé l'outil Agent sans subagent_type, et cette session n'a pas de sous-agent polyvalent sur lequel se replier. C'est le cas dans deux configurations :

• CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1 est défini en mode non interactif, ce qui supprime chaque sous-agent intégré
• L'agent du thread principal de la session a une liste d'autorisation tools: Agent(...) qui exclut general-purpose

Que faire :

• Généralement rien : le message liste les sous-agents que la session a, donc Claude peut réessayer avec l'un d'eux
• Si Claude continue d'échouer, ajoutez general-purpose à la liste d'autorisation tools: Agent(...), ou désactivez CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS

Avant la v2.1.235, le même appel échouait avec Agent type 'general-purpose' not found.

Memory index is over its read limit

Claude a écrit dans l'index de mémoire automatique MEMORY.md et l'a laissé au-delà de l'une de ses limites de lecture : 200 lignes ou 25 Ko. L'écriture a réussi, mais seules les 200 premières lignes ou 25 Ko, selon ce qui vient en premier, se chargent au début d'une session, donc tout ce qui dépasse la limite est supprimé à chaque fois que l'index est lu. Avant la v2.1.210, un index dépassant la limite était silencieusement tronqué au prochain chargement sans signal au moment de l'écriture.

Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.

Seul le contenu qui se charge compte pour les limites. Le frontmatter YAML et les commentaires HTML au niveau des blocs sont supprimés avant le chargement de l'index, donc ils sont exclus de la mesure. Avant la v2.1.211, Claude Code mesurait le fichier brut, et le frontmatter ou les commentaires pouvaient déclencher cette erreur même quand le contenu chargé s'adaptait.

Claude Code remet l'erreur à Claude après l'écriture plutôt que de l'imprimer comme une bannière dans votre terminal, donc vous ne la remarquerez peut-être que dans la transcription.

Quand l'écriture de Claude rapproche le fichier d'une limite sans la dépasser, Claude Code retourne un rappel plus doux pour compacter l'index au lieu de cette erreur.

Que faire :

• Laissez Claude réécrire MEMORY.md, ou demandez-lui : gardez une ligne par entrée, déplacez les détails dans les fichiers de sujet, et fusionnez ou supprimez les entrées obsolètes
• Pour réduire l'index vous-même, voir Audit and edit your memory

pkill pattern matches the Claude Code process

Une commande pkill dans un appel d'outil Bash a utilisé un motif, généralement avec -f, qui correspond au processus Claude Code lui-même, donc Claude Code refuse la commande au lieu de laisser la session se terminer. Claude Code teste le motif avec pgrep avant d'exécuter pkill et refuse quand son propre ID de processus est dans le résultat. La vérification s'exécute uniquement sur Linux ; sur macOS, pkill s'exécute sans modification. Avant la v2.1.214, la commande s'exécutait, et un motif correspondant tuait la session Claude Code en cours de tour.

pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.

Le refus apparaît dans le résultat de l'outil Bash plutôt que comme une bannière dans votre terminal, et Claude ajuste généralement la commande de lui-même.

Que faire :

• Réduisez le motif pour qu'il ne corresponde qu'au processus prévu, par exemple le chemin complet du binaire cible plutôt qu'une courte sous-chaîne
• Pour arrêter les processus démarrés par le shell actuel, utilisez pkill -P $$ avec le motif, ce qui limite la correspondance aux processus enfants du shell

Failed to write to a teammate's inbox

Claude Code n'a pas pu écrire un message dans la boîte aux lettres d'un coéquipier sous ~/.claude/teams/{team-name}/inboxes/, donc le destinataire n'a rien reçu. L'écriture échoue quand Claude Code ne peut pas créer ou mettre à jour le fichier, par exemple parce que le disque est plein, le répertoire n'est pas accessible en écriture, ou un autre agent détient le verrou de la boîte aux lettres trop longtemps. Avant la v2.1.224, Claude Code signalait le message comme envoyé même quand l'écriture échouait.

L'erreur apparaît dans le résultat de l'outil de l'agent d'envoi plutôt que comme une bannière dans votre terminal, et son texte indique à Claude de réessayer :

Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.

Les messages de protocole structurés de l'équipe d'agents échouent de la même manière, et l'erreur nomme le message non livré : quand Claude Code ne peut pas écrire une approbation de plan, un rejet de plan, une demande d'arrêt, ou un rejet d'arrêt, l'erreur se lit Failed to write the <message> to <name>'s inbox — nothing was sent. L'plan approval dans cette liste est la décision du responsable approuvant le plan d'un coéquipier ; la soumission du plan du coéquipier est le message séparé plan approval request. Ce message et deux autres messages de protocole portent leur propre texte de message et conséquence :

• Failed to write the plan approval request to the lead's inbox — plan not submitted; try again : le plan du coéquipier n'a jamais atteint le responsable, et le coéquipier reste en mode plan jusqu'à ce qu'une resoumission réussisse
• The permission request could not be delivered to the team lead (mailbox write failed) : la demande de permission du coéquipier n'a jamais atteint le responsable, donc personne n'a approuvé l'appel d'outil
• The confirmation could not be written to team-lead's inbox. : l'approbation d'arrêt elle-même a pris effet et le coéquipier sort ; seule la confirmation au responsable manque

Quand vous messagez vous-même un coéquipier, en tapant @name suivi du message dans la session du responsable, le même échec apparaît comme une notification, Couldn't write to @name's inbox — message not sent. Try again., et Claude Code garde votre texte dans la boîte de saisie pour que vous puissiez l'envoyer à nouveau.

Que faire :

• Demandez à l'expéditeur de renvoyer le message ; la contention pour le verrou de la boîte aux lettres est transitoire et s'efface à la nouvelle tentative
• Vérifiez l'espace disque libre, et vérifiez que ~/.claude/teams et les fichiers sous celui-ci sont accessibles en écriture par votre utilisateur

Teammate's agent definition was not restored

Claude a messagé un coéquipier d'équipe d'agents arrêté, et Claude Code l'a ramené sans réappliquer la définition du sous-agent à partir de laquelle il a été généré, parce que son fichier de définition provenait d'un dossier sans confiance enregistrée. L'avis suit le rapport de reprise dans le résultat de l'outil de l'agent d'envoi :

Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.

La vérification s'applique à une définition dans le répertoire .claude/agents/ du projet ou d'un répertoire --add-dir, et accepter le dialogue de confiance pour un dossier parent ne le satisfait pas.

Que faire :

• Exécutez claude dans le dossier que le journal de débogage nomme et acceptez le dialogue de confiance. La définition est réappliquée la prochaine fois que Claude Code ramène le coéquipier ; vous n'avez pas besoin de redémarrer la session du responsable
• Ou définissez l'entrée hasTrustDialogAccepted à true dans ~/.claude.json, en utilisant la clé exacte projects["<path>"] que le journal de débogage imprime

Message too large for cross-session delivery

Le message inter-sessions de Claude à une autre de vos sessions sur cette machine était trop long à envoyer. Claude Code l'a refusé, et la session de réception n'a rien reçu. Le refus apparaît dans le résultat de l'outil de la session d'envoi, pas comme une bannière dans votre terminal. Il nomme les deux tailles et comment faire tenir le message :

Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.

Renvoyer le même texte échoue de la même manière.

Que faire :

• Demandez à Claude de résumer le message, ou de mettre le contenu en masse dans un fichier et d'envoyer le chemin du fichier
• Demandez à Claude de diviser le contenu sur plusieurs messages plus courts

Avant la v2.1.235, Claude Code signalait un message surdimensionné comme envoyé. La session de réception l'a supprimé sans le lire.

Too many messages to this session just now

Claude a envoyé une rafale rapide de messages inter-sessions à l'une de vos sessions sur cette machine, et la rafale a atteint ce que la boîte aux lettres de cette session accepte. Claude Code a refusé l'envoi suivant, et la session de réception n'a rien reçu de celui-ci. Le refus apparaît dans le résultat de l'outil de la session d'envoi, pas comme une bannière dans votre terminal :

Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.

Que faire :

• Généralement rien : Claude regroupe le contenu restant en un seul message, ou attend avant d'envoyer plus
• Si vous avez vous-même déclenché la rafale, demandez à Claude de combiner ce qui reste en un seul message

Avant la v2.1.236, Claude Code signalait ces envois comme envoyés. La session de réception les a supprimés sans les lire.

Cross-session message was dropped at the recipient session's inbox

Claude a envoyé un message inter-sessions à une autre de vos sessions sur cette machine, et la boîte aux lettres de cette session l'a rejeté avant que Claude dans cette session le lise. La ligne nomme l'adresse du destinataire et, quand le destinataire a donné une raison, ajoute la raison après un tiret :

Cross-session message was dropped at the recipient session's inbox (recipient: uds:/tmp/cc-socks/13605.sock) and not delivered — its queue of undelivered peer messages was full. Claude was told not to resend right away.

Une ligne peut couvrir plusieurs messages rejetés. Elle commence alors au pluriel, par exemple Cross-session messages (12) were dropped. Pour trouver à quelle session appartient une adresse, comparez-la avec la ligne Peer address que /status affiche dans chaque session.

Après le tiret, la ligne donne une ou plusieurs de ces raisons :

• its queue of undelivered peer messages was full : le destinataire tenait déjà autant de messages non livrés d'autres sessions que sa file d'attente le permet
• you sent faster than that session accepts : les messages de la session d'envoi sont arrivés plus vite que le destinataire n'accepte d'un expéditeur
• it repeated your previous message : le message était identique à celui que la session d'envoi a envoyé à ce destinataire peu de temps avant
• a relay loop between sessions was cut : le message continuait une chaîne de sessions se messagant les unes les autres, et la chaîne avait traversé le destinataire trop de fois ou s'était allongée trop

Que faire :

• Supposez que le destinataire n'a jamais vu les messages rejetés. Claude Code dit la même chose à Claude, et lui dit d'inclure tout ce qui compte toujours dans un message ultérieur au lieu de renvoyer immédiatement
• Si vos sessions s'envoient des mises à jour fréquentes, demandez à Claude d'envoyer moins de messages, plus volumineux, comme un rapport quand une session termine son travail
• Pour a relay loop between sessions was cut, tapez l'instruction suivante dans l'une des sessions vous-même. Un message que Claude envoie en réponse à votre propre invite commence une nouvelle chaîne

Avant la v2.1.238, la session d'envoi n'a reçu aucun rapport quand la boîte aux lettres du destinataire a rejeté un message.

Refusing to send a cross-session message

Avant que Claude Code écrive un message inter-sessions à une autre de vos sessions sur cette machine, il vérifie que la socket de la boîte aux lettres de la session cible est le point de terminaison auquel le message a été adressé. Quand une vérification échoue, Claude Code refuse l'envoi dans la session d'envoi, et la session cible ne reçoit rien. Pour un message que Claude envoie, le refus apparaît dans le résultat de l'outil de la session d'envoi :

Failed to send to api-worker: Refusing to send: reply target is a symlink

Le texte après Refusing to send: nomme la vérification qui a échoué :

• reply target is a symlink : un lien symbolique se trouve au chemin de la socket de la session cible. Claude Code ne livre pas à travers, parce qu'un lien là-bas pourrait rediriger le message vers un point de terminaison que la session cible n'a pas créé.
• cannot vet reply target : Claude Code n'a pas pu inspecter le chemin cible du tout, par exemple parce que la lecture a échoué avec une erreur de permission.

Que faire :

• Généralement rien : les vérifications empêchent un message d'atteindre un point de terminaison autre que la session à laquelle il a été adressé, et rien n'a été envoyé
• Si reply target is a symlink se répète pour une session, vérifiez ce qui a créé un lien à ce chemin de socket de session, montré dans son /status sous Peer address

Refusing to read, write, or search a path

Claude Code vérifie les règles de permission du chemin d'un fichier, puis confirme cette résolution à nouveau quand l'outil ouvre le fichier ou démarre la recherche. Quand il ne peut pas confirmer que le chemin mène toujours à l'emplacement que la vérification a approuvé, Claude Code refuse l'opération au lieu de la suivre. Le refus apparaît dans le résultat de l'outil :

Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.

Chaque refus nomme sa raison :

• its symlink resolution changed after permission was checked : un lien symbolique le long du chemin, ou à une racine de recherche Grep ou Glob, a été remplacé entre la vérification de permission et l'opération. Dans un refus de lecture, la phrase entre parenthèses nomme quelle comparaison a échoué.
• its parent-directory symlink resolution changed after permission was checked : un répertoire par lequel le chemin d'écriture passe ne se résout plus à l'emplacement approuvé
• where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve) : Claude Code n'a pas pu suivre le chemin à un emplacement final sur le disque, par exemple parce que les liens symboliques sur celui-ci forment une boucle
• it is a symbolic link. Write to the link's target path instead : un lien symbolique se trouve à l'emplacement d'écriture approuvé lui-même, par exemple un CLAUDE.md qui est un lien symbolique vers AGENTS.md ; le message dirige Claude vers la cible du lien
• Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly. : la même condition attrapée quand un autre écrivain ouvre le fichier, comme une écriture vers un .mcp.json symlinké
• Refusing to write into symlinked directory: <path> : le répertoire qui contient le fichier est lui-même un lien symbolique, par exemple le répertoire .claude/ d'un projet lié à un autre emplacement
• a path one of its Read deny rules is written through changed while the search was being prepared. Retry. : une règle de refus Read pour la recherche nomme un chemin qui passe par un lien symbolique, et ce lien a changé pendant que Claude Code préparait la recherche
• it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently. : la racine de recherche existe mais n'a pas pu être ouverte ; le code entre parenthèses est l'erreur du système d'exploitation
• its permission check expired before it ran (too many concurrent file operations). Retry. : Claude Code a évincé l'enregistrement d'approbation sous de nombreuses opérations de fichiers simultanées avant que l'outil l'utilise ; réessayer exécute une vérification de permission fraîche
• ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration : Claude Code n'a pas pu résoudre le binaire rg à un chemin absolu, donc il refuse les recherches en dehors du répertoire de travail plutôt que d'en exécuter une que vos règles de refus ne couvrent pas

Que faire :

• Généralement rien : le refus atteint Claude comme le résultat de l'outil, et l'opération refusée ne s'exécute pas
• Si un refus de lien symbolique se répète sur un chemin, trouvez ce qui continue de réécrire un lien là-bas, comme un outil de construction ou un observateur de fichiers, ou demandez à Claude d'utiliser le chemin résolu du fichier au lieu du lien
• Si ce refus apparaît pour chaque fichier pendant que Claude Code s'exécute sur Windows à l'intérieur d'un AppContainer ou d'un sandbox à jeton restreint, mettez à niveau vers la v2.1.265 ou ultérieure
• Si un refus de lecture apparaît sur macOS pour un fichier que rien ne réécrit, comme une capture d'écran glissée dans l'invite, mettez à niveau vers la v2.1.273 ou ultérieure
• Pour le refus ripgrep, installez ripgrep avec votre gestionnaire de paquets pour que rg se résout à un chemin absolu sur PATH, ou gardez les recherches sous le répertoire de travail

Avant la v2.1.251, Claude Code ne revérifiait la résolution d'un chemin que pour les écritures de fichiers, donc un lien remplacé après la vérification de permission pouvait rediriger une lecture ou une recherche vers un emplacement différent sans message. Parmi ceux-ci, seuls les refus d'écriture du répertoire parent, à travers le lien symbolique, et du répertoire symlinké apparaissent sur les versions antérieures.

Avant la v2.1.280, le refus where it leads on disk could not be determined n'apparaissait pas.

Task output swap refused

Claude Code enregistre la sortie de chaque commande Bash dans un fichier sous son répertoire temporaire. Chaque fois qu'il ouvre l'un de ces fichiers, il vérifie que le chemin mène toujours au fichier qu'il a créé, sans lien symbolique, lien physique supplémentaire, ou répertoire déplacé le redirigeant. Ce message signifie que cette vérification a échoué, donc Claude Code a refusé l'opération plutôt que d'écrire ou de lire la sortie à travers ce chemin. Le message apparaît dans le résultat de l'outil Bash :

task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.

Le texte entre parenthèses nomme la vérification qui a échoué. Les raisons telles que output symlink was re-pointed, output file identity changed, et not a regular file signalent toutes la même condition : quelque chose au chemin de sortie ou le long de celui-ci n'est plus le fichier que Claude Code a créé. Seules certaines raisons portent une phrase To recover:.

Si la vérification échoue pendant qu'une commande s'exécute toujours, Claude Code arrête la commande, et son résultat signale :

Command killed: its output file was replaced or could no longer be verified

Que faire :

• Mettez à niveau vers la v2.1.260 ou ultérieure. Les versions antérieures affichaient parfois ce message quand aucun lien ou répertoire déplacé n'était présent
• Redémarrez Claude Code avec CLAUDE_CODE_TMPDIR défini sur un répertoire frais
• Ou vérifiez le répertoire de votre projet sous le répertoire temporaire de Claude Code, /private/tmp/claude-501/-Users-you-my-project dans le message d'exemple. Si ce chemin est un lien symbolique, ou un répertoire qui ne devrait pas être là, supprimez le lien ou le répertoire lui-même plutôt que la cible du lien, et redémarrez Claude Code
• Si le refus se répète, un processus remplace, lie, ou supprime des entrées sous le répertoire temporaire de Claude Code pendant que la session s'exécute. Définissez CLAUDE_CODE_TMPDIR sur un répertoire que rien d'autre ne gère et redémarrez

Disk quota or temp filesystem is full

Claude Code enregistre la sortie de chaque commande Bash et PowerShell dans un fichier sous son répertoire temporaire. Quand une commande se termine avec un code non nul et aucune sortie du tout, Claude Code vérifie si le système de fichiers contenant ce fichier est à court d'espace ou d'inodes, ou si votre quota disque sur celui-ci est utilisé. Si c'est le cas, un diagnostic apparaît dans le résultat de la commande à la place de la sortie vide :

Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.

Le message nomme ce qui a manqué :

• Your disk quota is full ... (EDQUOT) : votre propre quota sur ce système de fichiers est utilisé. Un quota peut être plein alors que le système de fichiers affiche toujours de l'espace libre
• The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC) : le système de fichiers, ou votre quota sur celui-ci, n'a pas d'espace libre
• Command output was lost: the temp filesystem at ... is full ou ... is out of inodes : le système de fichiers a presque pas d'espace libre, ou manque d'inodes

Que faire :

• Supprimez les fichiers que vous n'avez plus besoin sur le système de fichiers qui contient le répertoire temporaire de Claude Code. Pour EDQUOT, supprimez les fichiers qui comptent pour votre propre quota. Pour out of inodes, supprimez de nombreux fichiers plutôt que quelques gros, puisque chaque fichier prend un inode quelle que soit sa taille
• Ou redémarrez Claude Code avec CLAUDE_CODE_TMPDIR défini sur un répertoire sur un système de fichiers avec de la place
• Puis demandez à Claude d'exécuter la commande à nouveau. La sortie qu'elle a imprimée a été perdue, pas tronquée

The source file is not valid UTF-8 text

Claude a essayé de publier un artifact à partir d'un fichier dont les octets ne se décodent pas en texte, ou dont le texte contient déjà le caractère de remplacement U+FFFD, donc Claude Code a refusé la publication avant de télécharger quoi que ce soit. Le message apparaît dans le résultat de l'outil Artifact et nomme la première position à corriger :

file_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published.

file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as �), then publish again. Nothing was published.

Claude Code décode le fichier en UTF-8, ou en UTF-16 quand il commence par une marque d'ordre des octets UTF-16 little-endian. Quand un tel fichier UTF-16 ne se décode pas, le premier message nomme UTF-16 et vous dit toujours de réécrire le fichier en UTF-8. Quand plus de positions suivent celle nommée, le message ajoute un compte tel que (+2 more) après la position.

Que faire :

• Généralement rien : Claude réécrit le fichier et publie à nouveau
• Si le fichier est un que vous avez écrit ou exporté, enregistrez-le à nouveau en UTF-8, et remplacez chaque U+FFFD par le caractère qu'une édition, un collage, ou une conversion antérieure a perdu
• Pour afficher un U+FFFD intentionnel sur la page, écrivez-le comme � dans le HTML au lieu du caractère littéral

Avant la v2.1.267, Claude Code téléchargeait un tel fichier sans le vérifier, et le serveur refusait la publication à la place.

Reading a local file from outside the connected folders in a Cowork session

Dans une session Cowork s'exécutant sur votre machine dans l'application Claude Desktop, Claude a nommé un fichier local pour un artifact. Claude Code n'a pas pu confirmer que le fichier est un fichier ordinaire à l'intérieur des dossiers connectés de la session : le chemin se trouve en dehors de ces dossiers, passe par un lien symbolique, ou est orthographié d'une manière qui peut nommer un fichier différent de celui qu'il semble être. Lire un tel fichier nécessite votre approbation, et dans une session qui ne peut pas vous montrer la carte d'approbation, comme une définie pour ignorer toutes les approbations, Claude Code refuse la lecture.

Le refus apparaît dans le résultat de l'outil Artifact ; quand le fichier n'a pas pu être examiné du tout, il nomme cet échec à la place :

Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.

cannot read file_path (ENOENT) — the file could not be examined, and no one can answer the approval card in this Cowork session. Check that the file exists as a plain file inside the connected folders, then retry with that path.

Que faire :

• Généralement rien : le message indique à Claude d'utiliser un fichier ordinaire à l'intérieur des dossiers connectés à la place
• Pour mettre ce fichier exact dans l'artifact, copiez-le dans l'un des dossiers connectés de la session en tant que fichier régulier, pas un lien symbolique, et demandez à nouveau

WebFetch cannot fetch localhost

Claude a appelé WebFetch avec une URL dont le nom d'hôte n'a pas de point, comme http://localhost:3000 ou un nom intranet nu comme http://wiki/. WebFetch refuse ces URL avant de faire une demande :

WebFetch cannot fetch localhost or other hostnames without a dot. To reach a local server, use Bash with curl instead.

Que faire :

• Généralement rien : le message pointe Claude vers curl à travers l'outil Bash, qui peut atteindre les serveurs locaux et intranet

Avant la v2.1.268, WebFetch signalait ces URL avec une erreur générique Invalid URL.

WebFetch domain safety check failed

Avant de récupérer une URL, WebFetch envoie le nom d'hôte de l'URL à api.anthropic.com pour le vérifier par rapport à la liste de blocage de sécurité de domaine d'Anthropic. Si la vérification ne peut pas se terminer, WebFetch ne peut pas confirmer que le domaine est sûr, donc il ne récupère pas la page et le résultat de l'outil porte l'un de ces messages à la place :

The safety check for domain example.com is rate-limited (too many domain checks from this network; the limit is shared and can stay exhausted for minutes). Do not retry WebFetch in a loop or sleep to wait it out; continue without this page and report that its safety check was rate-limited. A single later attempt is fine; if that is rate-limited too, stop.

Unable to verify if domain example.com is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai.

• rate-limited : le point de terminaison de vérification a répondu avec HTTP 429. Le message indique à Claude de continuer sans la page et de réessayer au maximum une fois plus tard. Claude Code ne met pas en cache une vérification échouée, donc une récupération ultérieure de ce domaine exécute la vérification à nouveau. Si les sessions sur votre réseau frappent cela souvent, vous pouvez ignorer la vérification avec skipWebFetchPreflight: true dans les paramètres.
• Unable to verify : la demande de vérification a échoué, a expiré, ou a obtenu un autre statut d'erreur. Si votre réseau bloque api.anthropic.com, autorisez ce domaine, ou ignorez la vérification avec skipWebFetchPreflight: true dans les paramètres.

Avant la v2.1.286, le message limité en débit se lisait The safety check for domain example.com is temporarily rate-limited (too many domain checks from this network). Retry after about a minute; retrying sooner will fail the same way.. Avant la v2.1.285, une vérification limitée en débit était signalée avec le message Unable to verify à la place.

Erreurs de session en arrière-plan

Les sessions en arrière-plan s'exécutent sans terminal interactif qui leur soit propre, de sorte que les commandes qui en ont besoin se comportent différemment là-bas. Ces messages apparaissent dans la transcription d'une session en arrière-plan, dans le terminal qui s'y attache, dans la session ou le shell à partir duquel vous envoyez, ou, pour les entrées worktree-guard ci-dessous, dans toute session isolée dans un worktree ou exécutant un sous-agent isolé par worktree ; lorsqu'un message est spécifique à une surface, son entrée le précise.

Commandes refusées dans une session en arrière-plan

Les commandes qui ouvrent un dialogue interactif ne peuvent pas le faire tant qu'aucun terminal n'est attaché à une session en arrière-plan. /install-github-app, la liste des paramètres /mcp, et les actions d'authentification dans le menu du serveur MCP répondent par un message. Pour /install-github-app et la liste des paramètres /mcp, la session apparaît également sous Needs input dans la vue agent pour que vous puissiez la trouver, l'attacher et exécuter la commande à nouveau. Tant qu'un terminal est attaché, ces commandes fonctionnent normalement.

Avant v2.1.216, la session n'apparaissait pas sous Needs input après /install-github-app ou la liste des paramètres /mcp était refusée. Dans v2.1.213 à v2.1.215, les commandes fonctionnaient toujours tant qu'un terminal était attaché, et le message de refus vous disait d'attacher et d'exécuter la commande à nouveau. De v2.1.208 à v2.1.212, Claude Code les refusait même tant qu'un terminal était attaché, avec un message tel que Can't open MCP settings in a background session ; sur ces versions, exécutez la commande à partir d'une session claude ordinaire à la place, ou mettez à jour. Avant v2.1.208, ils ouvraient leur dialogue à l'intérieur de la session en arrière-plan. En v2.1.208 uniquement, Claude Code refusait également le sélecteur /model dans une session en arrière-plan, et /upgrade imprimait l'URL de mise à jour au lieu d'ouvrir un navigateur.

La formulation nomme la commande. La liste des paramètres /mcp rapporte :

Can't open MCP settings while no terminal is attached to this background session. This session now shows "needs input" in agent view — open it and run /mcp to manage servers, or use `/mcp enable|disable|reconnect <server>` to steer without the panel.

Ce qu'il faut faire :

• Attachez-vous à la session à partir de la vue agent et exécutez la commande à nouveau
• Ou utilisez le formulaire que le message nomme, tel que /mcp reconnect <server>, /mcp enable, ou /mcp disable, qui fonctionnent sans attacher

Écriture ou commande bloquée car le chemin ne peut pas être résolu de manière sûre

Claude a adressé un fichier ou un répertoire de travail par une orthographe que la garde d'isolation worktree ne peut pas résoudre en un seul emplacement vérifiable. La garde vérifie les écritures et les répertoires de travail des commandes dans toute session isolée dans un worktree, interactive ou en arrière-plan, et dans les sous-agents isolés par worktree. Elle résout les liens symboliques avant de vérifier que l'opération n'atteint pas le checkout partagé, et lorsque la résolution échoue, elle bloque l'opération plutôt que de la laisser y atterrir. Le message nomme les formes de chemin qu'elle refuse et comment réessayer :

This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.

Une commande bloquée rapporte la même cause pour son répertoire de travail et se termine par re-run the command from its direct symlink-free path. Avant v2.1.217, la garde comparait les orthographes de chemin sans résoudre les liens symboliques, de sorte que ces orthographes n'étaient pas bloquées et une écriture acheminée par un lien symbolique pouvait atterrir dans le checkout partagé.

Ce qu'il faut faire :

• Généralement rien : le message complet va à Claude comme une erreur d'outil, et Claude réessaye avec le chemin direct qu'il nomme. Pour une édition de fichier bloquée, la vue de conversation affiche uniquement une courte ligne Error editing file ; le message complet apparaît dans la vue de transcription, que vous ouvrez avec Ctrl+O. Une commande bloquée l'imprime dans sa sortie de commande.
• Si le blocage se répète sur le même fichier, le chemin passe probablement par un lien symbolique commité dont la cible contient .., tel que docs/current -> ../README.md ; demandez à Claude d'éditer le fichier cible par son chemin réel au lieu de passer par le lien

Écriture ou commande bloquée car le chemin nomme un emplacement réseau

Claude a adressé un fichier ou un répertoire de travail par un chemin qui nomme un lecteur qui n'est pas sur votre machine, un partage UNC tel que \\server\share\file ou un chemin d'automontage /net, tandis que le checkout de la session est sur un disque local. La même garde d'isolation worktree ne peut pas vérifier qu'un tel chemin reste en dehors du checkout partagé, de sorte qu'elle bloque l'opération. L'isolation de la session dans un worktree ne lève pas le blocage. Le message nomme la forme de chemin à utiliser à la place :

This write was blocked because the path is network-shaped (a UNC share or /net automount spelling) while this session's checkout is local. Isolating cannot unblock it. If the file is genuinely inside the worktree /path/to/worktree, address it by its local, plainly-spelled path instead.

Une commande bloquée rapporte la même cause pour son répertoire de travail et se termine par re-run the command from its local, plainly-spelled path. Avant v2.1.217, la garde comparait uniquement le texte du chemin, de sorte que l'adressage d'un fichier à l'intérieur du checkout par un chemin UNC ou /net n'était pas bloqué.

Ce qu'il faut faire :

• Généralement rien : Claude réessaye avec l'orthographe locale que le message demande

Commande bloquée par les vérifications d'isolation worktree

Claude a exécuté une commande Bash ou Monitor dans une session isolée dans un worktree, et Claude Code l'a refusée pour l'une de deux raisons :

• La commande pointe git vers le checkout principal.
• Claude Code ne peut pas vérifier à partir du texte de la commande que tout git que la commande exécute reste à l'intérieur du worktree. Une commande qui ne nomme jamais git peut toujours être refusée pour cette raison, car l'expansion d'une indirection de variable telle que ${!name} ou l'exécution d'une substitution de fonction Bash telle que ${ command; } produit une valeur à l'exécution qui peut elle-même être une commande.

Le milieu du message nomme ce qui n'a pas pu être vérifié :

This session is isolated in the worktree /path/to/worktree, but this command evaluates ${!x@P} arithmetically inside a construct too complex to verify, which can run a command hidden in a variable's value. Refusing to run it — a worktree-isolated session's git operations must target its own worktree. Split it into plain, separate commands and run them from /path/to/worktree.

Ce qu'il faut faire :

• Généralement rien : Claude lit le message et réécrit la commande de la manière que sa phrase finale demande
• Si une commande que vous avez demandée continue d'être refusée, orthographiez la valeur signalée littéralement : remplacez l'indirection ou la substitution par sa valeur, et exécutez git comme sa propre commande simple à partir de l'intérieur du worktree
• Pour agir sur le checkout principal à dessein, exécutez la commande vous-même dans un terminal en dehors de la session

Cette session n'a pas de transcription enregistrée

Vous vous êtes attaché à une session en arrière-plan arrêtée qui a été mise en arrière-plan à partir d'une autre conversation avec ← ou /background et arrêtée avant que sa première réponse ne soit terminée. Jusqu'à ce que cette première réponse soit terminée, la conversation vit toujours uniquement dans la session à partir de laquelle elle a été mise en arrière-plan, de sorte que claude attach refuse de démarrer la session arrêtée plutôt que de commencer une conversation vierge sous le même ID de session. Le message se termine par la commande claude respawn pour cette session :

This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.

L'ouverture de la même ligne de session dans la vue agent affiche Press enter again to restart this session fresh sous la liste à la place, et une deuxième Entrée sur la ligne redémarre la session avec une conversation vide. Avant v2.1.212, l'ouverture de la ligne affichait le message de refus sans aucun moyen de redémarrer à partir de la vue agent. Avant v2.1.211, l'ouverture de la session arrêtée démarrait silencieusement cette conversation vierge et pouvait réexécuter le prompt original de la session.

Ce qu'il faut faire :

• La conversation que vous avez mise en arrière-plan est intacte : reprenez-la avec claude --resume ou continuez à travailler dedans
• Pour démarrer la session arrêtée à nouveau, exécutez claude respawn <id> avec l'ID du message, ou appuyez deux fois sur Entrée sur sa ligne dans la vue agent
• Si la session a terminé une réponse et vous voyez toujours ce refus sur une version antérieure à v2.1.214, un dossier illisible dans ~/.claude/projects pourrait faire manquer à l'analyse de transcription la conversation enregistrée ; mettez à jour vers v2.1.214 ou ultérieur, qui tolère les dossiers illisibles lors de l'analyse

Cette session s'exécute dans un autre terminal

Vous avez ouvert la ligne d'une session arrêtée dans la vue agent, et sa conversation enregistrée est déjà ouverte dans un autre processus Claude Code en direct sur cette machine, de sorte que Claude Code refuse de démarrer un deuxième processus qui écrirait dans la même transcription. Le message que vous voyez dépend de ce qui détient la conversation :

Can't open — this session is running in another terminal
This conversation is already open in another running Claude session — use that one, or close it and try again

• running in another terminal : un terminal détient la conversation, par exemple celui où vous l'avez reprise avec claude --resume ou /resume. La ligne affiche également Open in a terminal.
• already open in another running Claude session : un autre processus Claude Code non interactif la détient, par exemple un processus de session en arrière-plan pour la même conversation qui n'a pas encore quitté.

Claude Code enregistre une réponse que vous avez tapée lors de l'ouverture de la ligne et l'envoie comme le prompt suivant de la session lorsque la session démarre ensuite.

Ce qu'il faut faire :

• Continuez la conversation dans le processus qui la détient, ou quittez ce processus et ouvrez la ligne à nouveau

Avant v2.1.248, seul le refus already open in another running Claude session existait : une conversation reprise dans un terminal ne comptait pas comme ouverte, et l'ouverture de la ligne démarrait un deuxième processus Claude Code écrivant dans la même conversation.

La conversation enregistrée de cette session n'est plus sur le disque

Vous avez ouvert une session en arrière-plan qui s'est terminée alors que le service en arrière-plan était arrêté, et le nettoyage de transcription a depuis supprimé sa conversation enregistrée, par exemple après que la machine a été éteinte pendant des semaines. L'ouverture d'une telle ligne reprend normalement sa conversation enregistrée. Sans rien à reprendre, Claude Code refuse plutôt que de réexécuter le prompt original de la session sans demander :

This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` deletes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.

claude attach <id> imprime ce texte. Dans la vue agent, le pied de page est plus court et se termine par ctrl+x deletes the row.

Ce qu'il faut faire :

• Exécutez claude rm <id> pour supprimer la ligne. Lorsque l'un des cas conservés s'applique, claude rm conserve la ligne et le worktree à la place et nomme la raison
• Pour exécuter à nouveau le prompt original de la session en tant que nouvelle conversation, exécutez claude respawn <id>

Avant v2.1.248, l'ouverture d'une telle ligne réexécutait le prompt original de la session au lieu de refuser, ramenant une tâche vieille de plusieurs semaines au premier plan.

Le worktree a des commits qui ne sont poussés nulle part

Vous avez essayé de supprimer une session en arrière-plan dont le worktree contient des commits dont Claude Code ne peut pas confirmer qu'ils sont enregistrés ailleurs. Claude Code conserve le worktree et la ligne de session plutôt que de détruire les commits sans les voir. claude rm nomme la branche et les commits non poussés, et dit comment procéder :

kept 7c5dcf5d — its worktree is still at “/home/you/project/.claude/worktrees/fix-login”
  2 unpushed commits on “claude/fix-login”: a1b2c3d “Fix login flow” and 1 more. They exist on no remote, so deleting the worktree would lose them.
  push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef

Lorsque Claude Code ne peut pas résumer les commits, la ligne de détail indique The worktree has unpushed commits à la place. Dans la vue agent, la ligne de la session affiche not deleted avec la même raison.

Les commits sur un dépôt distant ne bloquent pas la suppression. Les commits sur la copie locale de la branche par défaut de votre dépôt distant origin non plus, tant que cette branche est extraite dans votre checkout principal, le répertoire du dépôt lui-même plutôt qu'un worktree.

Ce qu'il faut faire :

• Pour conserver les commits, poussez la branche du worktree, ou fusionnez-la dans la branche par défaut extraite dans votre checkout principal, puis supprimez la session à nouveau
• Pour abandonner les commits, exécutez la commande claude rm <id> --discard-unpushed que le message a imprimée, ou appuyez deux fois sur Ctrl+X sur la ligne de la session dans la vue agent à nouveau. Cela supprime la session et le worktree ainsi que sa branche, les commits non poussés et les modifications non commitées. Si le worktree a gagné un commit depuis le refus, Claude Code le conserve à nouveau et affiche l'état mis à jour
• Lorsque le message dit que le worktree est également enregistré par une autre session terminée, la suppression à nouveau ne le supprime pas : poussez les commits, puis supprimez la session à nouveau

Avant v2.1.268, claude rm mettait le résumé du commit sur la ligne kept elle-même. Lorsque claude rm ne pouvait pas résumer les commits, la ligne kept indiquait worktree has commits that are not pushed anywhere à la place du résumé.

Avant v2.1.260, le message ne nommait pas la branche ou les commits, et la suppression à nouveau était refusée de la même manière : supprimer la session sans pousser signifiait supprimer le worktree vous-même avec git worktree remove --force <path>, puis exécuter claude rm <id> à nouveau.

Avant v2.1.248, la branche par défaut extraite dans votre checkout principal ne comptait pas : une branche que vous aviez déjà fusionnée là-bas déclenchait toujours ce refus jusqu'à ce que ses commits atteignent un dépôt distant.

Le processus hôte du terminal est mort

Chaque terminal de session en arrière-plan s'exécute dans un processus hôte sous le service en arrière-plan, et ce processus est mort alors que le service maintenait toujours sa connexion, de sorte que la session n'a pas pu être atteinte.

Sur Linux et WSL, le service en arrière-plan vérifie chaque processus hôte toutes les quelques secondes, marque la session comme échouée lorsque le processus a quitté mais sa connexion au service ne s'est jamais fermée, et affiche la raison sur sa ligne dans la vue agent :

terminal host process died — press Enter to restart

À partir du shell, claude attach <id> redémarre une session déjà marquée comme échouée pour un hôte mort, et sinon imprime la cause et quitte :

Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.

La conversation est enregistrée de toute façon.

Une ligne exécutant une commande shell à la place affiche terminal host process died — its output is gone; the command was not run again, et claude attach imprime This command's terminal host process died — its output is gone and the command was not run again. Claude Code ne réexécute jamais la commande pour vous.

Ce qu'il faut faire :

• Dans la vue agent, appuyez sur Entrée sur la ligne échouée ; la session redémarre sur un nouveau processus hôte et la conversation reprend
• À partir du shell, exécutez claude attach <id> à nouveau. Claude Code imprime Session <id>'s terminal host died — restarting it on a fresh one… et rouvre la session
• Vous ne pouvez pas redémarrer une ligne de commande shell de cette manière ; envoyez la commande à nouveau pour la réexécuter

Avant v2.1.247, un processus hôte mort pouvait passer chaque vérification de vivacité que le service en arrière-plan exécutait, de sorte que l'ouverture de la session affichait opening… · esc to cancel indéfiniment et claude attach <id> attendait sans signaler d'erreur.

La session ne répond pas

Vous avez ouvert une session en arrière-plan et le service en arrière-plan a accepté l'ouverture, mais aucune sortie n'est arrivée pendant environ dix secondes, de sorte que Claude Code conclut que le processus relayant le terminal de la session ne peut pas fournir de sortie, et termine la tentative au lieu d'attendre.

Dans la vue agent, Claude Code propose un redémarrage dans le pied de page :

Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).

À partir du shell, claude attach <id> imprime la cause et quitte :

Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).

Claude Code ne redémarre jamais une ligne exécutant une commande shell pour vous, car un redémarrage réexécuterait la commande.

Ce qu'il faut faire :

• Dans la vue agent, appuyez sur Entrée sur la même ligne à nouveau. Claude Code arrête le processus qui ne répond pas et redémarre la session, et la conversation reprend. Rien n'est arrêté sans cette deuxième pression
• À partir du shell, exécutez claude stop <id>, puis claude attach <id>
• Pour une ligne de commande shell, appuyez sur Ctrl+X dans la vue agent ou exécutez claude stop <id> pour l'arrêter ; envoyez la commande à nouveau pour la réexécuter

La session a été arrêtée pendant que le respawn était en vol

Vous avez ouvert une session en arrière-plan dont le processus n'était pas en cours d'exécution, et tandis que Claude Code la redémarrait, un autre processus Claude Code l'a arrêtée, par exemple claude stop dans un autre terminal. Claude Code garde la session arrêtée :

Session <id> was stopped while the respawn was in flight

L'ouverture d'une session que vous venez d'envoyer, tandis que son processus démarre toujours, attend le processus à la place. Avant v2.1.246, l'ouverture à ce moment-là pouvait l'arrêter et afficher ce message.

Ce qu'il faut faire :

• Si vous n'avez pas arrêté la session, ouvrez sa ligne à nouveau dans la vue agent ou exécutez claude respawn <id> pour la redémarrer
• Si vous l'avez arrêtée vous-même, rien ne reste à faire : la session reste arrêtée

L'agent de session n'est plus disponible

Vous avez repris une session qui exécutait un agent personnalisé, démarré avec --agent ou le paramètre agent, et Claude Code n'a pas trouvé d'agent portant ce nom. Il recherche d'abord le répertoire original de la session, lorsque vous avez approuvé cet espace de travail, puis le répertoire à partir duquel vous reprenez. La session reprend toujours, mais avec les outils par défaut, de sorte que les restrictions d'outils de l'agent ne s'appliquent plus :

This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.

L'avertissement nomme uniquement les répertoires que Claude Code a recherchés, et il apparaît dans la conversation reprise que vous réveilliez une session en arrière-plan, exécutiez /resume ou claude --resume, ou repreniez en mode non interactif, où il va également à stderr. Les sessions utilisant --input-format stream-json ne l'affichent pas, car le SDK Agent fournit les agents après le démarrage.

Claude Code n'enregistre pas la solution de repli dans la session, de sorte que l'avertissement se répète à chaque reprise jusqu'à ce que vous agissiez. L'agent claude intégré ne déclenche pas l'avertissement, puisque se rabattre sur l'ensemble d'outils par défaut ne change rien pour lui. Avant v2.1.216, Claude Code continuait silencieusement en tant qu'agent par défaut, et la recherche couvrait uniquement le répertoire à partir duquel vous repreniez, de sorte qu'un agent limité au projet était perdu à chaque reprise à partir d'un autre répertoire.

Ce qu'il faut faire :

• Recréez le fichier d'agent à .claude/agents/<name>.md dans le projet de la session, ou à ~/.claude/agents/<name>.md pour un agent personnel, puis reprenez à nouveau
• Ou reprenez avec --agent <name> nommant un agent qui existe, pour exécuter la session en tant que cet agent à la place
• Si l'agent est limité au projet et vous n'avez pas approuvé le répertoire original de la session, exécutez Claude Code là une fois, acceptez le dialogue de confiance, puis reprenez à nouveau

Erreurs du lanceur CLAUDE\_CODE\_PROCESS\_WRAPPER

CLAUDE_CODE_PROCESS_WRAPPER est défini, et sa valeur ne peut pas être utilisée, de sorte que Claude Code refuse de démarrer le processus affecté plutôt que de l'exécuter sans le lanceur. Les problèmes de configuration sont signalés avec un message qui commence par le nom de la variable et énonce la raison, par exemple :

CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file

Un lanceur qui démarre mais quitte sans se remplacer par Claude Code fait échouer la session qu'il démarrait, et la ligne de la session dans la vue agent rapporte que le lanceur must exec, not daemonize, suivi de tout ce que le lanceur a imprimé. Une session qui ne peut pas démarrer ou atteindre le service en arrière-plan à cause du lanceur rapporte le problème du lanceur comme la raison à l'intérieur de Couldn't reach the background service (...).

Ce qu'il faut faire :

• Définissez la variable sur le chemin absolu d'un exécutable qui se termine en appelant exec "$@". Voir le contrat du lanceur pour le contrat complet
• Vérifiez /status, qui affiche la commande de lancement résolue dans son entrée Self-exec et avertit lorsque le service en arrière-plan en cours d'exécution ne correspond pas, ou exécutez claude daemon status à partir d'un shell
• Après avoir corrigé la valeur dans le bloc env des paramètres, redémarrez le service en arrière-plan avec claude daemon stop --any de sorte que le prochain envoi démarre un service enveloppé

EUNKNOWN au démarrage d'une session en arrière-plan

Windows a refusé de démarrer un programme avec un code d'erreur qui n'a pas de nom standard, de sorte que l'échec apparaît comme EUNKNOWN. Le déclencheur habituel est une politique de restriction logicielle, telle que Group Policy ou AppLocker, bloquant le programme en cours de démarrage. L'erreur apparaît lorsque vous démarrez une session en arrière-plan avec /background ou claude --bg :

Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'

Sur certains comptes, le message dit daemon à la place de background service.

Sur une installation npm, un EUNKNOWN qui apparaît tandis que npm install -g @anthropic-ai/claude-code remplace le binaire a la même cause que EACCES lors d'une réinstallation et s'efface lorsque vous réessayez après la fin de l'installation.

Claude Code démarre le service en arrière-plan via PowerShell de sorte que le service survive à la fermeture du terminal, en utilisant PowerShell 7 lorsqu'il est installé et Windows PowerShell 5.1 sinon. Lorsqu'aucun PowerShell ne peut s'exécuter, Claude Code démarre le service directement à la place, de sorte qu'une politique qui bloque uniquement PowerShell ne cause pas cette erreur.

Avant v2.1.212, Claude Code utilisait uniquement Windows PowerShell 5.1 pour démarrer le service, de sorte que toute machine où Group Policy bloquait PowerShell 5.1 échouait avec Couldn't start the session — EUNKNOWN: unknown error, uv_spawn, même avec PowerShell 7 installé.

Ce qu'il faut faire :

• Si le message indique Couldn't start the session, mettez à jour vers v2.1.212 ou ultérieur. Sur les versions antérieures, vous pouvez également exécuter claude daemon run dans un terminal séparé en premier, puis démarrer la session en arrière-plan à nouveau. Cette commande exécute le service en arrière-plan au premier plan du terminal, de sorte que le service dure uniquement tant que ce terminal reste ouvert.
• Si une installation npm remplaçait le binaire, attendez qu'elle se termine, puis démarrez la session en arrière-plan à nouveau
• Si l'erreur apparaît sur v2.1.212 ou ultérieur tandis qu'aucune installation npm n'est en cours, vérifiez auprès de votre administrateur Windows si une politique de restriction bloque l'exécutable Claude Code
• Si le service en arrière-plan s'arrête lorsque vous fermez le terminal, Claude Code l'a démarré sans PowerShell. Installez PowerShell 7, ou demandez à votre administrateur de débloquer PowerShell, de sorte que le service puisse survivre au terminal.

EACCES au démarrage d'une session en arrière-plan

Claude Code n'a pas pu exécuter son propre binaire pour démarrer le service en arrière-plan qui héberge les sessions en arrière-plan. Sur une installation npm, cela signifie généralement que npm install -g @anthropic-ai/claude-code remplaçait le binaire à ce moment-là, que vous l'ayez exécuté ou que la mise à jour automatique l'ait fait. L'erreur apparaît lorsque vous ouvrez une session à partir de la vue agent :

Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'

Lorsque vous démarrez une session avec /background ou claude --bg, la même raison apparaît à l'intérieur de Couldn't reach the background service (...). Pendant la même fenêtre de réinstallation, l'erreur peut nommer un autre code à la place, tel que ENOENT ou ENOEXEC, ou EUNKNOWN ou EPERM sur Windows ; un EUNKNOWN qui persiste à travers les tentatives a une cause différente.

Sur une installation npm, Claude Code attend que la réinstallation se termine et réessaye de lui-même : jusqu'à dix secondes, et jusqu'à deux minutes tandis qu'une installation npm de Claude Code est visiblement toujours en cours sur la machine, ce qui couvre un autre processus Claude Code téléchargeant une mise à jour. Lorsque l'installation dépasse cette attente, l'échec nomme la mise à jour au lieu du code d'erreur nu :

Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes

Avant v2.1.257, l'attente s'arrêtait à dix secondes dans tous les cas, de sorte que cette erreur apparaissait tandis qu'un autre processus Claude Code téléchargeait toujours une mise à jour. Avant v2.1.246, Claude Code échouait immédiatement, sans attendre.

Ce qu'il faut faire :

• Attendez quelques secondes, puis ouvrez la session ou envoyez à nouveau. Lorsque le message dit que Claude Code est en cours de mise à jour, réessayez après la fin de la mise à jour.
• Si l'erreur persiste tandis qu'aucune installation npm n'est en cours, votre utilisateur ne peut pas exécuter le binaire installé. Vérifiez ses permissions et celles de son répertoire, ou réinstallez Claude Code.

Le service en arrière-plan a quitté avant de devenir accessible

Le processus que Claude Code a démarré en tant que service en arrière-plan a quitté avant d'accepter les connexions, de sorte que Claude Code n'a pas pu ouvrir votre session. Lorsque le service a imprimé une erreur avant de quitter, la raison entre parenthèses donne le code de sortie ou le signal et la première ligne que le service a imprimée, qui nomme ce qui l'a arrêté :

Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'

Lorsque vous ouvrez une session à partir de la vue agent, la même raison suit Couldn't start the background service —. Lorsque le service n'a rien imprimé avant de quitter, le message dit nothing on stderr à la place.

Claude Code rapporte l'échec avec la ligne d'erreur du service. Avant v2.1.246, l'échec n'apparaissait qu'après une attente de 45 secondes, comme background service did not become reachable within 45s, sans la ligne d'erreur du service.

Deux raisons citées ont des causes connues :

• Error: claude native binary not installed. : une installation npm remplaçait le binaire Claude Code à ce moment-là, de sorte que le service exécutait l'espace réservé npm à la place. Réessayez après la fin de l'installation ; si la ligne persiste sans installation en cours, complétez l'installation npm. Avant v2.1.257, une auto-mise à jour npm macOS produisait cet échec à chaque démarrage pendant la fenêtre d'installation.
• nothing on stderr avec le code de sortie 1, à chaque démarrage, sur Windows : daemon.lock nomme un processus que Claude Code ne peut ni signaler ni prouver qu'il est parti, de sorte que chaque nouveau service conclut qu'un autre détient le verrou et quitte. Un verrou dont l'auteur Claude Code peut prouver qu'il est parti est remplacé de lui-même et ne produit pas cet échec. Lorsque l'échec se répète à chaque démarrage, supprimez ~/.claude/daemon.lock, puis ouvrez la session ou envoyez à nouveau. Avant v2.1.257, un tel verrou bloquait chaque démarrage jusqu'à ce que vous supprimiez le fichier.

Ce qu'il faut faire :

• Si le message cite une ligne, corrigez ce qu'elle nomme, puis ouvrez la session ou envoyez à nouveau. La tentative suivante démarre le service à nouveau
• Exécutez claude daemon status pour vérifier si un service s'exécute maintenant

Le répertoire de travail n'existe plus au démarrage d'une session en arrière-plan

Le répertoire dans lequel vous avez démarré une session en arrière-plan a été supprimé tandis que la session démarrait. Claude Code ne démarre pas la session, et le message nomme le répertoire manquant :

Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)

Avant v2.1.257, la session semblait démarrer puis s'affichait dans la vue agent comme une ligne échouée avec la même raison.

Avant v2.1.281, ce message apparaissait également lorsque le répertoire était déjà parti avant que vous ne démarriez la session. Ce cas rapporte could not be resolved on disk.

Ce qu'il faut faire :

• Recréez le répertoire que le message nomme, ou envoyez à partir d'un répertoire qui existe, puis réessayez

La confiance de l'espace de travail n'est pas accordée lors de l'envoi d'une session en arrière-plan

Vous avez démarré ou redémarré une session en arrière-plan dans un répertoire que vous n'avez pas approuvé, et le dialogue de confiance de l'espace de travail n'a pas pu apparaître pour vous le demander. Claude Code ne démarre pas la session :

Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.

À partir d'un terminal dans le répertoire de la session lui-même, la même commande affiche le dialogue de confiance à la place et démarre la session une fois que vous acceptez. Ce message apparaît là où aucun dialogue ne peut apparaître, comme dans un script, ou lorsque vous redémarrez une session à partir d'un répertoire autre que le sien.

Deux variantes nomment une cause différente :

• The home directory is trusted one session at a time : le répertoire de la session est votre répertoire personnel. Claude Code ne sauvegarde jamais la confiance pour le répertoire personnel, de sorte que l'acceptation du dialogue là-bas dans une session antérieure ne compte pas.
• <path> could not be resolved on disk : Claude Code n'a pas pu trouver le répertoire de la session sur le disque.

Avant v2.1.286, sur Windows, ce message pouvait également apparaître dans un répertoire que vous aviez déjà approuvé, si son enregistrement de confiance avait été sauvegardé avec le chemin dans une casse différente. Mettez à jour vers v2.1.286 ou ultérieur.

Ce qu'il faut faire :

• Exécutez claude dans le répertoire que le message nomme et acceptez le dialogue de confiance, puis exécutez la commande à nouveau
• Pour le message du répertoire personnel, exécutez la commande à partir d'un terminal dans votre répertoire personnel de sorte que le dialogue puisse apparaître, ou démarrez la session à partir d'un répertoire de projet à la place
• Pour le message could not be resolved on disk, recréez le répertoire, ou démarrez une nouvelle session à partir d'un répertoire qui existe

Erreurs du wrapper et de l'IDE

Ces erreurs proviennent du programme qui a lancé Claude Code pour vous, comme une extension IDE ou une application Agent SDK, plutôt que de Claude Code lui-même.

Le processus Claude Code s'est fermé avec le code N

Le processus claude sous-jacent s'est fermé avec un code non nul. Le code de sortie seul ne dit pas ce qui a échoué : l'erreur réelle se trouve dans la sortie du processus lui-même, que le wrapper ajoute s'il en a capturé une, sinon il la conserve dans ses journaux.

Error: Claude Code process exited with code 1

Sur Windows, la version native peut se fermer avec le code 4294967295 juste après la fin d'un tour. Quand cette sortie se produit à une limite de tour, sans message en attente et sans tâche de fond en cours d'exécution, l'extension VS Code ferme la session silencieusement au lieu d'afficher cette erreur. Votre message suivant reprend la conversation.

Avant la v2.1.273, l'extension affichait l'erreur pour cette sortie à chaque limite de tour, même si rien n'était perdu.

Ce qu'il faut faire :

• Dans VS Code, suivez le lien View output logs affiché avec l'erreur pour voir l'échec sous-jacent
• Dans une application Agent SDK, capturez l'erreur autour de votre boucle de messages. Les entrées sous CLI process exit couvrent ce que votre code reçoit dans chaque langage SDK.
• Exécutez claude dans un terminal dans le même projet. L'échec se reproduit généralement là avec son vrai message d'erreur, que vous pouvez ensuite rechercher sur cette page.
• Exécutez claude doctor dans un terminal pour vérifier l'installation et la configuration

Impossible de localiser la CLI Claude sur PATH

L'extension VS Code affiche cette erreur sur Windows quand vous ouvrez Claude Code dans le terminal intégré, le shell du terminal est PowerShell, et l'extension ne peut pas trouver l'exécutable claude installé sur PATH. L'extension refuse de lancer Claude Code jusqu'à ce qu'elle trouve le claude installé sur PATH.

Failed to run Claude Code: Error: Could not locate the Claude CLI on PATH. Launching by name in a PowerShell terminal would run a 'claude' from the open folder instead of the installed CLI, so the launch was blocked. Make sure the Claude CLI's install directory is on your system PATH (not only your PowerShell profile), then restart VS Code and try again. VS Code reads PATH when it starts, so PATH changes take effect only after a restart.

Ce qu'il faut faire :

• Ouvrez une nouvelle fenêtre PowerShell en dehors de VS Code et exécutez where.exe claude. Si elle n'affiche pas de chemin, la CLI n'est pas sur votre PATH : ajoutez son répertoire d'installation en suivant Verify your PATH. Si elle affiche un chemin, l'entrée provient de votre profil PowerShell ou d'une modification de PATH que VS Code n'a pas encore détectée ; les deux étapes suivantes couvrent ces cas.
• Définissez l'entrée PATH comme variable d'environnement utilisateur ou système, pas dans votre profil PowerShell. L'extension n'exécute pas votre profil, donc une modification de PATH qui ne se trouve que là ne l'atteint jamais.
• Redémarrez VS Code après avoir modifié PATH. L'extension vérifie le PATH que VS Code a capturé au démarrage, donc une modification de PATH ne prend effet qu'après un redémarrage.

La connexion à Claude Code s'est terminée avant la fin de ce message

L'extension VS Code a envoyé votre message au processus claude, et la connexion s'est terminée sans erreur avant que le processus l'acknowledge ou le termine. L'extension ne peut pas dire si le message a été traité, donc elle vous demande de l'envoyer à nouveau :

The connection to Claude Code ended before this message completed — it may not have been processed, so please send it again.

Ce qu'il faut faire :

• Envoyez le message à nouveau. Le message suivant démarre un nouveau processus claude qui reprend la conversation.
• Si cela se répète, exécutez claude dans un terminal dans le même projet. Un échec qui continue à terminer le processus se reproduit généralement là avec son vrai message d'erreur.

Avertissements et erreurs de rembobinage

Ces messages proviennent d'une restauration de code /rewind. « Restored the code, but skipped N files » est un avertissement indiquant que Claude Code a ignoré certains chemins. « No files were restored » est une erreur signifiant qu'aucun fichier n'a été restauré.

Restored the code, but skipped files

Une restauration de code /rewind a ignoré un ou plusieurs chemins suivis au lieu de les écrire ou de les supprimer. Claude Code ignore un chemin quand :

• il est, ou est devenu, un lien symbolique, un lien physique, ou un autre fichier non régulier
• son répertoire a changé depuis le point de contrôle
• sa sauvegarde ne peut pas être lue en toute sécurité

Les chemins ignorés conservent leur contenu actuel. Avant la v2.1.216, /rewind écrivait et supprimait à travers les liens aux chemins suivis, et ne signalait pas une restauration partielle.

Restored the code, but skipped 2 files: the tracked path is (or became) a link or other non-regular file, its directory changed since the checkpoint, or its backup could not be safely read. Skipped files were left untouched — run with --debug for the paths.

Que faire :

• Identifiez les fichiers qui ont été ignorés pour pouvoir traiter chacun d'eux avec les étapes ci-dessous. Le message ne donne qu'un nombre ; le journal de débogage à ~/.claude/debug/<session-id>.txt nomme chaque chemin ignoré lors de l'exécution de la restauration, donc activez la journalisation de débogage avec /debug avant votre prochain rembobinage. Sur macOS ou Linux, vous pouvez plutôt trouver les liens directement : find . -type l pour les liens symboliques et find . -type f -links +1 pour les fichiers liés physiquement.
• Si un fichier ignoré est un lien que vous avez créé intentionnellement, comme un fichier de configuration géré par un gestionnaire de dotfiles ou un fichier lié physiquement par des outils comme pnpm, le rembobinage a laissé son contenu intact. Pour annuler les modifications de la session, demandez à Claude d'inverser la modification ou modifiez le fichier vous-même
• Si vous n'avez pas créé le lien, inspectez le chemin avant de faire confiance à son contenu

No files were restored

Claude Code affiche ce message quand vous restaurez du code avec /rewind et qu'il ne peut restaurer aucun des fichiers de ce point de contrôle. Pour chaque fichier, soit la sauvegarde que Claude Code a enregistrée avant de le modifier est manquante, soit Claude Code n'a pas pu écrire ou supprimer le fichier.

Failed to restore the code:
No files were restored: 1 file failed (backup missing, or the file could not be updated)

Claude Code supprime les sauvegardes d'une session lors du balayage de rétention, par défaut environ 30 jours après que la session en ait enregistré une pour la dernière fois. Si vous reprenez une session après cela, /rewind liste toujours ses points de contrôle, mais le rembobinage vers l'un d'eux peut échouer avec cette erreur. Si le message dit aussi « N paths were skipped for link safety », consultez Restored the code, but skipped files pour ces chemins.

Quand vous créez une branche d'une session, par exemple avec --fork-session ou /branch, Claude Code copie les sauvegardes de la session d'origine dans la branche. Quand Claude Code ne peut pas copier une sauvegarde, par exemple parce que le disque est plein, cette sauvegarde est manquante dans la branche. Le rembobinage vers un point de contrôle qui en a besoin peut échouer avec cette erreur.

Que faire :

• Annulez les modifications d'une autre manière : demandez à Claude d'inverser ses modifications, ou restaurez les fichiers à partir du contrôle de version. Quand les sauvegardes sont parties, exécuter /rewind à nouveau échoue de la même manière.
• Si Claude Code n'a pas pu écrire ou supprimer un fichier, corrigez ce qui bloque l'écriture, comme les permissions de fichier, puis exécutez /rewind à nouveau.
• Pour conserver les sauvegardes plus longtemps dans les futures sessions, augmentez cleanupPeriodDays.

Avant la v2.1.260, Claude Code ignorait silencieusement les fichiers dont les sauvegardes étaient manquantes, et le rembobinage semblait réussir.

Avertissements d'enregistrement de session

Claude Code affiche ces avertissements sur une ligne persistante sous la zone de saisie lorsqu'il n'enregistre pas votre transcription de session. La session continue de fonctionner de toute façon ; les avertissements vous indiquent que la session peut être manquante lors d'une utilisation ultérieure de --resume.

Les écritures de transcription échouent

Claude Code enregistre la transcription sur le disque au fur et à mesure que vous travaillez, et ses écritures dans le fichier de transcription échouent. Le message nomme la cause avec le code d'erreur sous-jacent, par exemple un disque plein :

Transcript writes are failing (disk full — ENOSPC) · recent messages may not be saved for resume

L'avertissement apparaît à différents moments selon l'erreur :

• À la première défaillance pour les conditions qui ne s'effacent pas d'elles-mêmes : un disque plein, un quota de disque dépassé, un système de fichiers en lecture seule, un chemin dépassant la limite de longueur du système de fichiers, ou, sur macOS et Linux, une erreur de permission
• Après des défaillances répétées s'étendant sur au moins une minute pour tout le reste, y compris les erreurs de permission sur Windows, où une analyse antivirus peut échouer une seule écriture qui réussit ensuite à la nouvelle tentative

Avant la v2.1.217, Claude Code supprimait les écritures défaillantes sans avertissement, et une --resume ultérieure manquant de messages récents était le premier signe.

Que faire :

• Corrigez la condition que le code d'erreur nomme : libérez l'espace disque pour ENOSPC ; augmentez ou effacez le quota pour EDQUOT ; restaurez l'accès en écriture à l'emplacement de la transcription pour EACCES, EPERM, ou EROFS
• L'avertissement s'efface de lui-même à la prochaine écriture réussie ; aucun redémarrage n'est nécessaire
• Les messages envoyés pendant que l'avertissement s'affichait peuvent toujours être manquants lorsque vous reprenez la session ultérieurement

L'enregistrement de la transcription est désactivé car CLAUDE\_CODE\_SKIP\_PROMPT\_HISTORY est défini

Cette session a démarré avec CLAUDE_CODE_SKIP_PROMPT_HISTORY défini, donc Claude Code n'écrit aucune transcription ou historique d'invite pour celle-ci :

Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set · --resume will not find this session; if unintended, unset it and restart

La variable est une exclusion intentionnelle pour les sessions scriptées éphémères, mais elle peut également atteindre une session via un profil shell, un script wrapper, ou un processus parent qui l'a exportée.

Que faire :

• Si vous avez défini la variable intentionnellement, aucune action n'est nécessaire ; l'avis confirme que la session n'apparaîtra pas dans --resume, --continue, ou l'historique de la flèche vers le haut
• Si ce n'est pas le cas, supprimez la variable du shell ou du script qui lance claude, puis démarrez une nouvelle session. Les messages de la session actuelle ne sont pas enregistrés rétroactivement.

L'enregistrement de la transcription est désactivé en raison d'un marqueur CLAUDE\_CODE\_CHILD\_SESSION hérité

Claude Code définit CLAUDE_CODE_CHILD_SESSION dans les sous-processus qu'il génère, et traite une session interactive qui l'hérite comme imbriquée : Claude Code n'enregistre aucune transcription pour celle-ci, donc les sessions que Claude lui-même démarre ne remplissent pas votre liste --resume. Cet avis signifie que votre session actuelle a hérité du marqueur :

Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker · restart with CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 to keep future transcripts

L'avis est attendu lorsque vous avez exécuté claude depuis l'intérieur d'une autre session Claude Code ; il signale une mauvaise classification lorsque le marqueur a fui à travers un intermédiaire de longue durée, par exemple un terminal, une session screen, ou un lanceur qu'une session Claude Code a initialement démarré.

À l'intérieur de tmux, Claude Code détecte un marqueur qui est arrivé via l'environnement global du serveur tmux et continue d'enregistrer, donc cet avis n'apparaît pas pour ce cas.

Que faire :

• Si vous avez démarré cette session depuis l'intérieur d'une autre session Claude Code intentionnellement, aucune action n'est nécessaire
• Si c'est une session de niveau supérieur, quittez et redémarrez avec CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 défini. L'enregistrement s'applique à partir du redémarrage, donc les messages envoyés avant celui-ci ne sont pas enregistrés.
• Pour corriger les lancements futurs depuis le même terminal ou lanceur, supprimez CLAUDE_CODE_CHILD_SESSION de son environnement

Avertissements de configuration

Claude Code écrit la plupart de ces messages sur stderr, et non dans la conversation, et les écrit principalement au démarrage. Une entrée le précise quand son message apparaît ailleurs, par exemple dans le journal de débogage ou comme un avis de démarrage dans la vue de conversation, ou à un autre moment, par exemple la ligne de diagnostic de modèle non reconnu au moment de la requête.

Claude Code s'est fermé après une erreur d'interface irrécupérable

Claude Code imprime ce message quand il se ferme parce que son interface de terminal a rencontré une erreur dont elle ne peut pas se rétablir, dans l'un ou l'autre rendu. La deuxième phrase n'apparaît que si l'erreur s'est produite pendant le démarrage du rendu plein écran :

Claude Code exited after an unrecoverable interface error (<error>). It happened while the fullscreen renderer was starting, so the next launch will use the classic renderer (CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 forces that any time).

À faire :

• Redémarrez Claude Code. Pour reprendre la conversation, exécutez claude --resume dans le même répertoire.
• Si le message nomme le rendu plein écran, Rendu en plein écran indique ce que le prochain lancement fait, ce qui dépend de la façon dont vous avez activé le plein écran, et comment réessayer le plein écran ou conserver le rendu classique.

Avant la v2.1.236, Claude Code se fermait sans imprimer de message après ce type d'erreur.

Les descriptions d'agent dépassent la limite de 15 000 jetons

Claude Code affiche cet avertissement comme un avis de démarrage dans la vue de conversation plutôt que sur stderr. Les descriptions combinées de vos sous-agents, à l'exception des agents intégrés, dépassent 15 000 jetons selon l'estimation de Claude Code. Chaque agent compte son nom plus son frontmatter description. Claude Code charge chaque agent, que le total dépasse ou non la limite, donc l'avertissement ne change pas ce qui se charge.

Agent descriptions are over the 15.0k-token limit (~16.2k tokens) · ask Claude to trim agent descriptions in .claude/agents/

À faire :

• Raccourcissez le frontmatter description de vos fichiers d'agent, ou demandez à Claude de les raccourcir pour vous.
• Supprimez les fichiers d'agent que vous n'utilisez plus.

Une compétence, une commande ou un flux de travail n'a pas été chargé parce que son nom est réservé

Un dossier de compétence, un frontmatter name, un fichier ou un sous-dossier dans .claude/commands/, ou un flux de travail enregistré utilise le nom anthropic-skills ou un nom qui commence par anthropic-skills:. Claude Code réserve ce nom pour les compétences synchronisées depuis claude.ai et ne charge pas cet élément.

Claude Code affiche cet avertissement comme un avis de démarrage dans la vue de conversation plutôt que sur stderr :

Not loaded: rename .claude/skills/anthropic-skills, then restart — its name uses "anthropic-skills", a name reserved for the skills synced from your claude.ai account

L'avis nomme ce qu'il faut changer pour le premier élément qu'il a refusé : un dossier ou un fichier à renommer, une ligne name: à modifier, ou un flux de travail à renommer. Quand plus d'un élément a été refusé, l'avis se termine par un nombre tel que · 2 more, et le journal de débogage nomme chacun.

À faire :

• Renommez l'élément que l'avis nomme, ou modifiez la ligne name: vers laquelle il pointe, puis redémarrez la session.

Avant la v2.1.282, Claude Code chargeait les compétences et les commandes avec ces noms.

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.

À faire :

• Exécutez claude dans le répertoire et acceptez la boîte de dialogue d'approbation. Règles d'autorisation du projet et approbation de l'espace de travail indique quel dossier cette acceptation couvre.
• En mode non interactif avec -p, aucune boîte de dialogue n'est affichée. Définissez l'entrée hasTrustDialogAccepted dans ~/.claude.json en utilisant la clé projects exacte que le message imprime.
• Si le message nomme .claude/settings.local.json et que vous avez démarré Claude Code en dehors d'un dépôt git ou dans votre répertoire personnel, mettez à jour vers la v2.1.200 ou ultérieure. Les versions 2.1.196 à 2.1.199 ont traité votre propre .claude/settings.local.json comme fourni par le dépôt dans ces espaces de travail. Sur la v2.1.207 et ultérieure, la mise à jour ne suffit pas en dehors d'un dépôt git si vous n'avez pas approuvé le dossier : déterminer qu'un dossier ne se trouve pas dans un dépôt exécute git, et Claude Code n'exécute cette vérification qu'après que vous acceptiez la boîte de dialogue d'approbation, donc utilisez la première étape. Votre répertoire personnel et tout autre répertoire de configuration sont exempts et n'attendent pas la boîte de dialogue. Consultez Règles d'autorisation du projet et approbation de l'espace de travail.

Le répertoire de travail est un chemin réseau

Claude Code n'ajoute pas les chemins réseau comme répertoires de travail. La recherche d'un chemin réseau peut contacter l'hôte qu'il nomme, et sur Windows, ce contact peut envoyer vos identifiants à l'hôte, donc Claude Code refuse le chemin sans le rechercher. Vous voyez ce message quand vous exécutez /add-dir avec un tel chemin, ou comme un avertissement au démarrage. Quand il apparaît au démarrage, Claude Code démarre sans ce répertoire.

\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).

Les chemins que Claude Code refuse de cette façon incluent :

• Les partages UNC tels que \\server\share
• Les chemins de montage automatique tels que /net/<host>, sauf si vous avez lancé Claude Code à partir d'un répertoire sous le montage automatique de cet hôte
• Les chemins locaux qui atteignent un emplacement réseau via un lien symbolique ou une jonction

Les lettres de lecteur mappées et les chemins \\wsl$ ne comptent pas comme des chemins réseau.

À faire :

• Sur Windows, mappez le partage à une lettre de lecteur, par exemple avec net use Z: \\server\share, et passez le lecteur au lancement avec claude --add-dir Z:\.
• Sur macOS ou Linux, montez le partage à un chemin local et ajoutez ce chemin à la place.
• Si le chemin se trouve dans permissions.additionalDirectories, supprimez-le du fichier de paramètres qui le répertorie.

Avant la v2.1.257, Claude Code acceptait un chemin réseau accessible comme répertoire de travail.

Les paramètres gérés à distance n'ont pas pu être chargés

Votre session est éligible pour les paramètres gérés par le serveur, mais Claude Code n'a pas pu les récupérer ou n'a pas pu appliquer ce que le serveur a renvoyé, donc il affiche cet avertissement dans les sessions interactives.

La cause entre parenthèses nomme ce qui a échoué, par exemple network error, request timed out, ou authentication rejected (401). La cause no setting in the server response could be applied as written signifie que le serveur a répondu mais aucun des paramètres qu'il a renvoyés n'a réussi la validation. Avant la v2.1.282, cette cause lisait server returned invalid settings.

Le reste de la ligne indique la politique sur laquelle la session s'exécute :

• Paramètres mis en cache à partir d'une récupération antérieure réussie : Claude Code exécute la session sur cette politique mise en cache, sauf les variables d'environnement retenues, et la ligne lit using cached policy.
• Pas de cache : Claude Code exécute la session sans paramètres gérés par le serveur, et la ligne lit no remote policy applied.

À faire :

• Agissez sur la cause que le message nomme : pour une cause réseau, vérifiez que cette machine peut atteindre api.anthropic.com ; pour une cause d'authentification, vérifiez votre connexion avec /status
• Pour no setting in the server response could be applied as written, demandez à votre administrateur de corriger les paramètres sur le serveur
• Exécutez /status ou claude doctor pour le diagnostic complet

Avant la v2.1.248, Claude Code ne signalait une récupération de paramètres échouée que dans le journal de débogage.

Les paramètres gérés n'ont pas été approuvés

Les paramètres gérés par le serveur de votre organisation incluent des paramètres qui nécessitent votre approbation, et vous avez refusé la boîte de dialogue d'approbation de sécurité, donc Claude Code se ferme sans les appliquer :

Managed settings were not approved; exiting without applying them.

À faire :

• Redémarrez Claude Code et approuvez la boîte de dialogue pour continuer selon les paramètres de votre organisation. Une boîte de dialogue refusée n'est pas mémorisée, donc elle réapparaît au prochain démarrage.
• Si vous n'êtes pas sûr d'un paramètre que la boîte de dialogue répertorie, demandez à celui qui maintient les paramètres gérés de votre organisation avant d'approuver

Les paramètres gérés bloquent le modèle par défaut

Les paramètres gérés de votre organisation bloquent le modèle auquel l'option Par défaut se résout et chaque modèle auquel il pourrait rétrograder. Une session qui démarrerait sur l'option Par défaut se ferme au démarrage au lieu d'exécuter un modèle bloqué. Le message que vous voyez dépend du paramètre qui le bloque. Quand une liste deniedModels le bloque, le message lit :

Claude Code can't start: your organization's managed settings block the default model (claude-opus-5-5) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".

Quand une liste availableModels avec availableModelsMatch défini à "exact" l'omet, le message lit :

Claude Code can't start: your organization allows only the models listed in "availableModels", and none of them can be used as the default model (claude-opus-5-5 isn't listed). Ask your administrator to update "availableModels".

À faire :

• Si vous administrez les paramètres, ajoutez un modèle que vos utilisateurs peuvent exécuter à availableModels, ou réduisez les entrées deniedModels qui bloquent chaque secours. Bloquer des modèles ou des versions spécifiques décrit comment l'option Par défaut rétrograde
• Si vous ne les administrez pas, envoyez le message à votre administrateur. Vos propres fichiers de paramètres ne peuvent pas élargir une liste availableModels ou deniedModels gérée

Les paramètres gérés ne permettent pas ce fournisseur d'API

Les paramètres gérés de votre organisation définissent une liste allowedProviders, et le fournisseur d'API de la session n'est pas sur la liste ou la session utilise un point de terminaison qui n'est pas épinglé de la façon que cette entrée exige. Claude Code refuse au démarrage, avant une connexion, ou quand la session contacte ensuite l'API. Le message commence par les fournisseurs autorisés :

Your organization's managed settings allow Claude Code to use: Anthropic API, Amazon Bedrock.

Quand la liste est vide, le message lit à la place :

Your organization's managed settings allow Claude Code to use no API provider at all (allowedProviders is an empty list), so it cannot start on this machine.

Quand chaque entrée n'est pas reconnue, la parenthèse lit (allowedProviders lists only unrecognized entries) à la place.

À faire :

• Suivez les étapes To continue: du message
• Si vous administrez les paramètres, les lignes du message commençant par Admins: nomment l'entrée à ajouter ou la valeur à épingler, et l'entrée allowedProviders indique quel bloc env de quelle source peut l'épingler

Le serveur MCP est bloqué par la politique gérée par l'entreprise

Vous avez sélectionné Reconnect sur un serveur dans /mcp, ou vous avez réactivé un serveur désactivé là, et un paramètre qui restreint les serveurs MCP bloque ce serveur. Claude Code refuse de le connecter et affiche :

MCP server <name> is blocked by enterprise managed policy

N'importe lequel de ces paramètres peut produire le message :

• Une entrée deniedMcpServers qui correspond au serveur, y compris une dans votre propre ~/.claude/settings.json ou le .claude/settings.json du projet
• Une liste allowedMcpServers que le serveur ne correspond pas
• strictPluginOnlyCustomization avec mcp verrouillé, qui bloque les serveurs configurés dans ~/.claude.json et .mcp.json
• disableClaudeAiConnectors, quand le serveur est un connecteur claude.ai

À faire :

• Vérifiez vos propres fichiers de paramètres utilisateur et projet pour l'un de ces paramètres et modifiez-le ou supprimez-le
• Si aucun de vos propres paramètres n'explique le blocage, demandez à votre administrateur quel paramètre géré bloque le serveur

Avant la v2.1.257, Reconnect et réactiver dans /mcp pouvaient connecter un serveur qu'une mise à jour de politique en cours de session avait bloqué.

Le document des paramètres gérés n'a pas pu être analysé

Votre organisation déploie des paramètres gérés, et l'un des documents déployés est présent mais ne peut pas être analysé comme un objet JSON, donc Claude Code se ferme avec le code 1 au démarrage au lieu de s'exécuter sans la politique que le document porte. La ligne nomme la source échouée avant le message :

/Library/Application Support/ClaudeCode/managed-settings.json: Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.

La source est l'une des suivantes :

• Le chemin du fichier managed-settings.json ou un fichier drop-in sous managed-settings.d
• Le profil des préférences gérées macOS, per-user managed preferences ou device-level managed preferences
• La valeur du registre Windows, Registry: HKLM\SOFTWARE\Policies\ClaudeCode\Settings

Trouver les entrées que Claude Code a supprimées répertorie ce qui rend chaque source non analysable.

Claude Code refuse de démarrer même quand une autre source d'administrateur fournit une politique valide. Vous voyez cette erreur dans les sessions interactives, claude -p, les sessions du SDK Agent, les sessions en arrière-plan, et la plupart des sous-commandes, y compris claude doctor. Le refus échoue fermé à dessein : les paramètres dans un document que Claude Code ne peut pas analyser ne peuvent pas être appliqués, et le démarrage quand même exécuterait les sessions sans les contrôles de l'organisation.

Un problème de schéma dans un document analysable ne produit pas cette erreur. Trouver les entrées que Claude Code a supprimées couvre ce que Claude Code fait avec un.

Quand un répertoire managed-settings.d/ existe mais ne peut pas être répertorié, Claude Code signale Managed settings drop-in directory could not be read: suivi de l'erreur sous-jacente à la place. Trouver les entrées que Claude Code a supprimées couvre quand une défaillance de lecture se ferme au démarrage.

À faire :

• Si vous administrez la machine, corrigez le document nommé pour qu'il s'analyse comme un objet JSON, ou supprimez le fichier, le profil ou la valeur du registre. Un managed-settings.json vide compte comme {} et ne bloque pas le lancement.
• Si vous ne le faites pas, demandez à votre administrateur de corriger le document déployé. Rien dans vos propres fichiers de paramètres ne cause ou n'efface cette erreur.

Impossible de lire les paramètres de politique gérée

Votre organisation déploie des paramètres gérés, et l'une des sources déployées existe mais n'a pas pu être lue, pour une raison telle qu'une erreur d'E/S plutôt que le système d'exploitation refusant la lecture. Sans autre source d'administrateur fournissant une politique, Claude Code se ferme au démarrage plutôt que de s'exécuter sans la politique que la source peut porter :

Unable to read managed policy settings.
This machine may require organization login enforcement, but the policy file failed to load.
Contact your administrator.

Detail: <source>: <reason>

Dans le même état, les flux de connexion, les requêtes API d'une session déjà en cours d'exécution, et le serveur claude gateway sont refusés avec une variante de la première ligne qui nomme allowedProviders.

Une lecture que le système d'exploitation a refusée, par exemple sur un fichier root uniquement, ne produit pas cette sortie : la session démarre sans les politiques de cette source. Pour une source qui ne peut pas être analysée, Claude Code se ferme avec un message différent nommant la source.

À faire :

• Si vous administrez la machine, corrigez le problème que la ligne Detail: nomme pour que la source déployée puisse être lue, ou supprimez la source
• Si vous ne le faites pas, envoyez le message à votre administrateur. Rien dans vos propres fichiers de paramètres ne cause ou n'efface cette erreur

Avant la v2.1.285, seules les sessions connectées avec les identifiants claude.ai ou Claude Console se fermaient avec ce message, et une lecture que le système d'exploitation a refusée le produisait aussi.

otelHeadersHelper a échoué

Claude Code affiche cet avertissement comme une notification dans l'interface du terminal, une fois par session interactive, quand le script otelHeadersHelper échoue ou imprime une sortie qui ne répond pas aux exigences du script.

Pendant que le script continue d'échouer, les exportations échouent et votre backend de télémétrie ne reçoit rien de la session.

Le texte après See /status: indique ce qui a échoué, par exemple le code de sortie du script suivi de sa sortie d'erreur :

otelHeadersHelper failed; telemetry is not being exported. See /status: exited 1: token service unreachable

À faire :

• Exécutez /status pour lire le détail de l'échec.
• Corrigez le script pour qu'il se termine avec 0 en moins de 30 secondes et imprime un objet JSON de valeurs d'en-tête de chaîne sur stdout. Consultez exigences du script.
• Si votre organisation déploie le script via les paramètres gérés, demandez à celui qui les maintient de le corriger.

En mode non interactif avec -p, le même échec apparaît sur stderr comme otelHeadersHelper failed (OpenTelemetry export headers unavailable): <error> à la place.

headersHelper non exécuté

Claude Code a connecté un serveur MCP avec ses headers statiques seuls et a ignoré le headersHelper du serveur, car l'assistant est une commande shell et le dossier n'a pas d'approbation enregistrée. Un dossier obtient une approbation enregistrée quand vous définissez son entrée dans ~/.claude.json à la main ou, en dehors de votre répertoire personnel, quand vous acceptez la boîte de dialogue d'approbation pour lui dans une session interactive. Consultez Approuver un dossier avant l'exécution de son headersHelper pour savoir quels serveurs cette vérification s'applique à.

Claude Code écrit cette ligne en mode non interactif uniquement, une fois par serveur. Dans une session interactive, il écrit le même refus au journal de débogage à la place.

MCP server 'internal-api': headersHelper not run — this workspace has no persisted trust; accept the trust dialog here once interactively, or set projects["/Users/you/project"].hasTrustDialogAccepted in /Users/you/.claude.json.

La clé projects que le message imprime est le dossier Règles d'autorisation du projet et approbation de l'espace de travail indique que Claude Code clé l'approbation sur. Accepter la boîte de dialogue d'approbation pour un dossier parent ne satisfait pas la vérification, et une session -p ou SDK ne la satisfait pas non plus.

À faire :

• Exécutez claude dans le dossier que le message nomme, acceptez la boîte de dialogue d'approbation, puis exécutez à nouveau votre commande -p ou SDK
• Définissez vous-même l'entrée hasTrustDialogAccepted dans ~/.claude.json, en utilisant la clé projects exacte que le message imprime
• Si vous avez démarré la session dans votre répertoire personnel, travaillez à partir d'un répertoire de projet que vous avez approuvé. Quand vous acceptez la boîte de dialogue d'approbation dans votre répertoire personnel, Claude Code conserve cette approbation pour la session actuelle uniquement.

Règle Tool(content) mal formée

Une règle de permission dans l'un de vos fichiers de paramètres n'a pas la forme Tool ou Tool(content), par exemple parce que du texte suit la parenthèse fermante ou l'une des parenthèses manque. Claude Code ignore la règle et la répertorie dans la boîte de dialogue des paramètres invalides quand une session interactive démarre, et dans la sortie de claude doctor :

Invalid permission rule "Bash(ls) x" was skipped: Malformed Tool(content) rule. Rules take the form Tool or Tool(content) and must end at the closing ")"; parentheses inside the content are literal

À faire :

• Dans le fichier de paramètres répertorié avec le message, réécrivez la règle pour qu'elle se termine à sa parenthèse fermante, par exemple Bash(ls *) à la place de Bash(ls) x
• Laissez les parenthèses à l'intérieur du contenu telles qu'elles sont. Elles sont littérales, donc une règle telle que Edit(./Finance (2024)/**) est valide sans échappement

Avant la v2.1.260, Claude Code signalait une règle avec des parenthèses non appariées comme Mismatched parentheses.

N'est pas mis en correspondance par les vérifications de permission de fichier

Claude Code a trouvé une règle Write, NotebookEdit, MultiEdit, ou Glob permission avec un chemin dans l'un de vos fichiers de paramètres, dans les paramètres gérés, ou dans une valeur de drapeau --allowedTools, --disallowedTools, ou --settings. Il vérifie les permissions de fichier uniquement par rapport aux règles Edit et Read, donc il ne consulte jamais une règle de chemin qui nomme l'un des autres outils de fichier. Il conserve la règle et ne change rien d'autre ; l'avertissement nomme la règle, sa source entre parenthèses, et le remplacement à écrire :

Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).

À faire :

• Remplacez les règles Write(path), NotebookEdit(path), et MultiEdit(path) héritées par Edit(path). Les règles Edit couvrent tous les outils d'édition de fichiers.
• Sauf dans --allowedTools, où Claude Code accepte une règle Glob sans avertissement, remplacez les règles Glob(path) par Read(path).
• Corrigez la règle à la source que l'avertissement nomme entre parenthèses : un chemin de fichier de paramètres, ou le drapeau lui-même pour --allowed-tools et --disallowed-tools. Un chemin claude-settings-<hash>.json qui n'existe pas sur le disque représente une valeur --settings en ligne. Corrigez le JSON que vous passez à ce drapeau.
• Laissez les règles de nom d'outil nu telles que Write ou Glob seules. Claude Code les met en correspondance au niveau de l'outil et ne les avertit pas.
• Si la source lit managed policy settings, transmettez l'avertissement à celui qui maintient vos paramètres gérés, car vous ne pouvez pas l'effacer vous-même.

Dans une session en arrière-plan ou avec --output-format json ou stream-json, Claude Code écrit l'avertissement au journal de débogage au lieu de stderr, donc la sortie lue par machine reste propre. Exécutez avec --debug pour la capturer à ~/.claude/debug/<session-id>.txt. Avant la v2.1.210, Claude Code acceptait ces règles sans avertissement.

A un caractère générique avant le reste de la commande

Claude Code a trouvé une règle d'autorisation Bash dont le * vient avant un mot ultérieur qui détermine quelle commande c'est, par exemple Bash(git * main) ou Bash(git -C * status *), dans l'un de vos fichiers de paramètres, dans les paramètres gérés, ou dans une valeur de drapeau --allowedTools ou --settings. Le * correspond à n'importe quel texte, y compris les options insérées à cette position : Bash(git * main) approuve également git -c core.fsmonitor=<script> diff main, où -c fait exécuter à git un programme que la commande nomme. Modèles de caractères génériques montre les règles de correspondance.

L'avertissement existe pour que vous puissiez affiner une règle dont le caractère générique est plus large que vous ne l'aviez prévu. Claude Code conserve la règle et ne change rien à la façon dont elle correspond ; l'avertissement nomme la règle et sa source entre parenthèses :

Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).

À faire :

• Remplacez le * avant la sous-commande par la valeur exacte que vous entendez : Bash(git checkout main) à la place de Bash(git * main).
• Déplacez chaque * après la sous-commande : Bash(git status *) à la place de Bash(git -C * status *). Écrivez une règle par sous-commande que vous voulez autoriser.
• Corrigez la règle à la source que l'avertissement nomme entre parenthèses : un chemin de fichier de paramètres, ou le drapeau --allowed-tools lui-même. Un chemin claude-settings-<hash>.json qui n'existe pas sur le disque représente une valeur --settings en ligne. Corrigez le JSON que vous passez à ce drapeau.
• Si la source lit managed policy settings, transmettez l'avertissement à celui qui maintient vos paramètres gérés, car vous ne pouvez pas l'effacer vous-même.

Claude Code n'avertit pas les règles de refus et de demande avec la même forme : il refuse ou demande les commandes supplémentaires qu'elles correspondent plutôt que de les approuver. Il n'avertit pas non plus les règles dont la sous-commande vient avant le premier *, par exemple Bash(git commit *), ou les règles dans lesquelles aucun mot autre qu'une option ne suit le *, par exemple Bash(git *), ou les règles de préfixe :* telles que Bash(git:*).

Dans une session en arrière-plan ou avec --output-format json ou stream-json, Claude Code écrit l'avertissement au journal de débogage au lieu de stderr, donc la sortie lue par machine reste propre. Exécutez avec --debug pour la capturer à ~/.claude/debug/<session-id>.txt. Avant la v2.1.246, Claude Code acceptait ces règles sans avertissement.

crossSessionInbound doit être l'un de accept, hold, refuse

Un fichier de paramètres définit crossSessionInbound à une valeur que Claude Code ne reconnaît pas, par exemple la faute de frappe "reject". La deuxième phrase de l'avertissement dépend du fichier qui contient la valeur ; dans un fichier utilisateur, projet, local, ou --settings, elle lit :

"crossSessionInbound" must be one of "accept", "hold", "refuse"; received "reject". This value was ignored; while it is present, cross-session messages are held for your approval instead of being delivered. Set it to one of the values above.

Dans les paramètres gérés, Claude Code traite la valeur non reconnue comme refuse, la valeur la plus restrictive, et l'avertissement dit que les messages entre sessions sont rejetés jusqu'à ce qu'un administrateur le corrige. Pour savoir comment la retenue se combine avec les valeurs dans vos autres fichiers de paramètres, consultez crossSessionInbound.

À faire :

• Définissez la clé à "accept", "hold", ou "refuse", ou supprimez-la
• Quand l'avertissement nomme les paramètres gérés, demandez à l'administrateur de corriger la valeur

Avant la v2.1.248, Claude Code ignorait une valeur non reconnue sans avertissement.

La limite de 200K n'est pas appliquée

Vous avez défini CLAUDE_CODE_DISABLE_1M_CONTEXT=1, ce qui fait normalement que la compaction automatique maintient les sessions sur les modèles à contexte 1M à une fenêtre de 200K, mais aucun seuil de compaction ne limite cette session à ou en dessous de 200K, donc la conversation peut dépasser.

CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it. To enforce it, set CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 (or the autoCompactWindow setting).

Claude Code applique la limite de 200K de lui-même pour chaque modèle qu'il reconnaît comme ayant une fenêtre native de 1M, et pour les ID de modèle qu'il ne reconnaît pas, il compacte à la fenêtre qu'il suppose. L'avertissement apparaît quand une autre configuration défait cette application :

• L'ID du modèle n'est pas un que Claude Code reconnaît, par exemple un alias de passerelle LLM, et vous avez défini CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 ou augmenté la fenêtre supposée au-delà de 200K avec CLAUDE_CODE_MAX_CONTEXT_TOKENS. Dans ce cas, le message offre également or update to a Claude Code version that recognizes <model> comme un remède.
• Un context-1m bêta demandé via ANTHROPIC_BETAS ou le drapeau --betas demande toujours à l'API la fenêtre 1M sur un modèle qui accepte cette bêta, tandis que rien ne compacte la session à 200K

À faire :

• Définissez CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000, ou le paramètre autoCompactWindow à 200000, pour que la compaction automatique compacte à la limite de 200K
• Si le message nomme un ID de modèle que cette version ne reconnaît pas, exécutez claude update. Une version qui reconnaît l'ID comme un modèle à contexte 1M applique la limite sans configuration supplémentaire.
• Si vous voulez que la session utilise la fenêtre complète du modèle à la place, désactivez CLAUDE_CODE_DISABLE_1M_CONTEXT ; l'avertissement signale uniquement que la limite de 200K n'est pas appliquée

Dans une session en arrière-plan ou avec --output-format json ou stream-json, Claude Code écrit l'avertissement au journal de débogage au lieu de stderr.

ID de modèle non reconnu sur une requête

Claude Code a envoyé une requête pour un ID de modèle que votre version de Claude Code ne reconnaît pas, et n'a trouvé aucune entrée modelOverrides qui mappe cet ID à un modèle qu'elle reconnaît. Claude Code envoie toujours la requête avec l'ID tel que vous l'avez configuré, et ne se ferme pas ou ne change pas de modèle.

[claude-code:unrecognized_model] {"model":"my-proxy-model","query_source":"sdk"}

Dans un script ou un harnais qui lit stderr, mettez en correspondance le préfixe [claude-code:unrecognized_model]. Après le préfixe et un espace, Claude Code écrit un objet JSON d'une ligne. Claude Code peut ajouter des champs à celui-ci dans une version ultérieure, donc ignorez tout champ que vous n'attendez pas. Il écrit au moins ces deux :

• model : la chaîne de modèle telle que vous l'avez configurée
• query_source : le chemin de requête qui a utilisé le modèle. Claude Code signale sdk pour une exécution -p et une valeur qui commence par agent: pour un sous-agent.

Claude Code écrit la ligne à l'un de deux endroits, selon la façon dont vous l'exécutez :

• En mode non interactif avec -p, Claude Code l'écrit sur stderr sous chaque --output-format, pour que vous puissiez analyser stdout sans filtrer la ligne
• Dans une session interactive ou une session en arrière-plan, Claude Code l'écrit au journal de débogage à la place ; exécutez avec --debug pour la capturer à ~/.claude/debug/<session-id>.txt

Claude Code écrit la ligne une fois par chaîne de modèle par processus. Il écrit une ligne séparée pour chaque ID non reconnu supplémentaire, par exemple un qu'un sous-agent ou une fonctionnalité en arrière-plan utilise.

Claude Code n'écrit pas la ligne pour les ID de fournisseur qu'il résout à un modèle qu'il reconnaît, par exemple les ID Amazon Bedrock us.anthropic.claude-..., les ID de la plateforme d'agent de Google Cloud avec un suffixe de version @, et les noms de déploiement Microsoft Foundry qui contiennent un ID de modèle Claude. Claude Code vérifie le modèle derrière un ARN de profil d'inférence d'application Amazon Bedrock plutôt que l'ARN lui-même. Il n'écrit pas de ligne pour un ARN qu'il ne peut pas résoudre, par exemple un mal orthographié.

À faire :

• Si vous avez défini l'ID à dessein, par exemple un alias de passerelle LLM, ajoutez une entrée modelOverrides à votre fichier de paramètres avec l'ID comme sa valeur. Utilisez un ID de modèle Anthropic comme clé, pas un alias de famille tel que opus. Pour my-proxy-model de la ligne d'exemple, ajoutez cette entrée :

  {
    "modelOverrides": {
      "claude-opus-4-6": "my-proxy-model"
    }
  }
  

  Claude Code traite alors my-proxy-model comme claude-opus-4-6 et arrête d'écrire la ligne.

• Si l'ID nomme un modèle plus récent que votre version de Claude Code, exécutez claude update

• Si l'ID est une faute de frappe, corrigez-le dans l'un des endroits où vous pouvez définir un modèle ou les variables d'alias qui le contiennent. Si query_source commence par agent:, corrigez-le plutôt où vous définissez le modèle du sous-agent.

Avant la v2.1.233, Claude Code n'écrivait pas de ligne quand il envoyait une requête pour un ID de modèle qu'il ne reconnaissait pas.

Fichiers de masque de sandbox obsolètes laissés par une session tuée

claude doctor imprime cet avertissement dans ses diagnostics, et /status répertorie la même ligne. Il apparaît sur Linux et WSL2 quand le sandboxing est activé avec l'isolation du système de fichiers activée.

Pendant qu'une commande en sandbox s'exécute, le sandbox maintient un refus d'écriture sur un fichier qui n'existe pas encore en créant un espace réservé de 0 octet en lecture seule là, et le supprime après. Une session tuée avant que ce nettoyage s'exécute, par exemple par SIGKILL, laisse les espaces réservés derrière. Les sessions ultérieures les lient en lecture seule à nouveau à chaque démarrage, donc une écriture de paramètres telle que l'enregistrement de « Oui, et ne me le demande plus » échoue où l'un se trouve.

- Stale sandbox mask files left by a killed session: /home/you/project/.claude/settings.local.json
  Fix: Remove each with `rm <path>` while no other Claude Code session is running in that project — a 0-byte read-only file where a settings file belongs makes "Yes, and don't ask again" fail to save, and the sandbox binds it read-only again on every start

À faire :

• Quittez toute autre session Claude Code s'exécutant dans ce projet, puis supprimez chaque fichier répertorié avec rm. L'avertissement nomme jusqu'à trois fichiers et compte le reste, donc réexécutez claude doctor après la suppression jusqu'à ce que l'avertissement ne réapparaisse plus. Un espace réservé que le sandbox d'une autre session utilise toujours est une partie vivante de la protection en écriture de cette session
• Si un choix de permission que vous avez enregistré avec « Oui, et ne me le demande plus » n'a pas collé, enregistrez-le à nouveau après la suppression de l'espace réservé

Avant la v2.1.257, claude doctor ne signalait pas ces fichiers ; les versions antérieures laissent les mêmes espaces réservés derrière quand une session est tuée.

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 ces cas :

• Un --fallback-model configuré 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, ou votre compte perd l'accès à celui-ci en cours de session
• Le basculement automatique du modèle sur Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 et Opus 5 déplace la session vers le modèle de secours de la catégorie signalée, lorsque cette catégorie en possède un, 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 /model pour confirmer que vous êtes sur le modèle attendu. Un choix /model précédent ou une variable d'environnement ANTHROPIC_MODEL peut vous placer sur un modèle plus petit que prévu.
• Niveau d'effort : exécutez /effort pour 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 raccourci ultrathink.
• Pression contextuelle : exécutez /context pour voir le remplissage de la fenêtre. S'il est proche de la capacité, exécutez /compact à un point naturel ou /clear pour 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.md volumineux ou obsolètes et les définitions d'outils MCP consomment du contexte et peuvent orienter les réponses. La vérification /doctor signale les fichiers mémoire surdimensionnés et les extensions inutilisées, et /context affiche l'utilisation des jetons des outils MCP. Avant la v2.1.205, /doctor ouvrait un écran de diagnostics qui signalait les fichiers mémoire surdimensionnés et les définitions de sous-agents.

Lorsqu'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 incorrecte 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.

Si Claude vous avertit d'une injection d'invite suspectée, ou refuse une demande en raison d'une injection suspectée, et que le texte nommé par l'avertissement est un contexte que Claude Code ajoute automatiquement à la conversation plutôt que du contenu de fichier ou web, exécutez claude update et réessayez. Si l'avertissement se répète après la mise à jour, signalez-le plutôt que de coller le contenu signalé dans l'invite. Avant la v2.1.201, Sonnet 5 refusait certaines demandes de la même manière.

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 /feedback dans Claude Code pour envoyer la transcription et une description à Anthropic. La commande propose également d'ouvrir un problème GitHub prérempli. L'envoi à Anthropic nécessite une authentification. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et d'autres fournisseurs tiers, ou lorsqu'aucune identifiant Anthropic n'est configuré, /feedback enregistre une archive locale que vous pouvez envoyer à votre représentant de compte Anthropic à la place.
• Exécutez claude doctor depuis votre shell pour un diagnostic en lecture seule de votre installation, ou exécutez la vérification /doctor dans Claude Code pour trouver et corriger les problèmes de configuration
• Vérifiez status.claude.com pour les incidents actifs
• Recherchez les problèmes existants sur GitHub