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.
Claude Code appelle l’API Claude pour les réponses du modèle, donc la plupart des erreurs d’exécution correspondent à un code d’erreur API sous-jacent. Cette page couvre ce que chaque erreur signifie dans Claude Code et comment récupérer. Pour les définitions brutes du code de statut HTTP, consultez la référence des erreurs de la plateforme Claude.
Trouvez votre erreur
Faites correspondre le message que vous voyez à 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 producedsi 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 litYour 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 en streaming au maximum une fois. 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éfinissezCLAUDE_CODE_RETRY_WATCHDOG, le plafond d’une tentative ne s’applique pas. - Une réponse en streaming que le filtre de contenu de sortie de l’API arrête avant que Claude n’ait terminé sa réflexion ou commencé un texte ou un appel d’outil. Claude Code renvoie la requête une fois, dans le budget de tentatives, et affiche Output blocked by content filtering policy si le filtre arrête également la deuxième réponse.
- Les throttles 429 temporaires, mais pas le
429de 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_tokensdépasse la limite de contexte. La renvoyer inchangée échouerait de la même manière, donc Claude Code réessaie avec unmax_tokensré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
401ou403de l’API Anthropic, directement ou via une passerelle LLM, tandis qu’un scriptapiKeyHelperfournit 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.
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_CERTSmanquant, 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 à reboursRetrying 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.
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 :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 againau lieu de coller le tout. - Si l’erreur persiste sans incident signalé, exécutez
/feedbackpour qu’Anthropic puisse enquêter avec les détails de votre demande. Voir Signaler une erreur si/feedbackn’est pas disponible dans votre environnement.
Erreur API : Erreurs 529 Overloaded répétées
L’API est temporairement à capacité pour tous les utilisateurs. Claude Code a déjà réessayé plusieurs fois avant d’afficher ce message :- Vérifiez status.claude.com, ou la page d’état du fournisseur nommée dans le message, pour les avis de capacité
- Réessayez dans quelques minutes
-
Exécutez
/modelet basculez vers un modèle différent pour continuer à travailler, car la capacité est suivie par modèle. Claude Code vous invite à le faire quand un modèle est sous une charge particulièrement élevée, par exempleOpus is experiencing high load, please use /model to switch to Sonnet. 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 litOpus 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.- Réessayez la demande
- Si une connexion réseau lente ou un proxy en est la cause, augmentez
API_TIMEOUT_MScomme 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 demandeAPI_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.
- Première tentative :
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MSquand 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.
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 againau 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_MSafin que la tentative de réessai attende plus longtemps. Sur Amazon Bedrock, augmentez égalementCLAUDE_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_MSafin que la première tentative attende assez longtemps aussi.
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 :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 avecAPI 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 parAPI 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 viaANTHROPIC_BASE_URLouANTHROPIC_AWS_BASE_URLtandis 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 queANTHROPIC_BEDROCK_BASE_URLne sont pas enveloppées par le watchdog d’octet ; voir Watchdogs d’inactivité de streaming.
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.ouThe 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 avecAPI Error: Content block not foundpour un événement supprimé ouAPI Error: Content block already closedpour un événement dupliqué. Pour un événement endommagé avec le repli désactivé, le tour se termine avecAPI Error: Stream event unreadableou l’erreur brute du parseur.
- 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 à envoyercontinuevous-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.
- 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
continuepour 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
-pet rejetait la réponse qu’il avait déjà produite. - Avec
--output-format jsonoustream-json, Claude Code signale ce message dans le champresult. - Pour continuer le tour une fois la connexion stable, reprenez la session et envoyez
continuecomme décrit dans Continuer les conversations.
- 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
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 :Not run · auto mode's check had no usable answer apparaît sous l’appel d’outil au lieu de ce message. Appuyez sur Ctrl+O pour lire le message dans la visionneuse de transcription. Les refus décrits sous Le serveur n’a retourné aucun verdict de sécurité affichent la même ligne. Avant v2.1.296, le message apparaissait sous l’appel sous forme d’erreur rouge.
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
- Réessayez l’action ; cela réussit généralement à la tentative suivante
- Exécutez
claude --debuget répétez l’action pour les détails dans le journal de débogage
-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
-psans--input-format stream-json, Claude Code retourne un résultat d’erreur contenantAgent 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
- 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
- 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
-pnon interactive sans--input-format stream-json, Claude Code retourne un résultat d’erreur contenantAgent aborted: auto mode classifier transcript exceeded context window in headless mode, et l’exécution continue - Ailleurs dans une exécution
-psans--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
- Dans une session interactive, approuvez ou refusez l’action dans la demande qui apparaît
- Dans une session interactive, exécutez
/compactpour 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) :
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 :
- Dans une session interactive, le message apparaît comme un avertissement dans la transcription et le tour se termine
- Dans une exécution
-pnon 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é
- 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=0avant 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
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.- 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
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 :/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 workflow, 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
/configsont séparés, donc désactivez chacun indépendamment. - Pour la limite Opus ou Sonnet, exécutez
/modelet basculez vers un modèle en dehors de cette famille pour continuer à travailler. Chaque modèle a son propre cache de prompt, donc la requête suivante relit toute la conversation sans accès au cache ; consultez Switching models - Exécutez
/usagepour voir vos limites de plan et quand elles se réinitialisent - Exécutez
/usage-creditspour acheter une utilisation supplémentaire sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise. Consultez usage credits for paid plans pour savoir comment cela est facturé. - Pour mettre à niveau votre plan pour des limites de base plus élevées, consultez claude.com/pricing
You've used 85% of your session limit · resets 3:45pm. Pour surveiller votre allocation restante en continu, ajoutez les champs rate_limits à une barre de statut 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./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
/modelet 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
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 requête Fable ne facture les crédits d’utilisation. Quand l’invite de consentement se ferme sans que personne n’y réponde, Claude Code termine le tour avec l’un de ces messages :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 d’une équipe d’agents, 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 un autre prompt 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
/modelpour basculer vers un modèle qui ne facture pas les crédits d’utilisation - Pour vous donner plus de temps, définissez
dialogExpirysur une valeur plus longue ou"never"
Server is temporarily limiting requests
L’API a appliqué un throttle de courte durée sans rapport avec votre quota de plan.- 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.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
/statuset confirmez que les identifiants actifs sont ceux que vous attendez. UnANTHROPIC_API_KEYégaré dans votre environnement peut acheminer les requêtes 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/modelpour 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 requête, 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 requête est une requête que seuls les crédits d’utilisation paient, comme une requête à 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 :
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.
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 Organization settings > Usage si vous gérez la facturation, ou demandez à un administrateur de le faire.
/usage-creditsenvoie 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
/usagepour 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 requêtes jusqu’à ce que la période nommée se réinitialise ou que l’opérateur augmente le plafond. Elle marque chaque réponse429 bloquée x-should-retry: false, donc Claude Code affiche ce message sans réessayer.
blocked_message, ses instructions le suivent. Avant v2.1.225, le message indiquait 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
spend limit unavailable, signifie que la passerelle n’a pas pu lire ses enregistrements de dépenses et a bloqué la requête 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 requêtes avec une clé API Console quand vous aviez l’intention d’utiliser votre abonnement.- Si vous avez un plan Pro, Max, Team ou Enterprise et voyez ceci, exécutez
/statuset vérifiez la ligneAPI key. UnANTHROPIC_API_KEYapprouvé dans votre environnement achemine les requêtes via cette clé au lieu de votre abonnement. Supprimez-le dans le shell actuel et retirez-le de votre profil de shell, puis relancezclaude. Exécutez/loginsi 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. 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.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
/loginpour 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_KEYest 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
apiKeyHelperqui récupère une clé au démarrage - Consultez Priorité d’authentification pour comprendre quels identifiants Claude Code utilise lorsque plusieurs sont présents
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.
- 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_TOKENou 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
/statusdans une session interactive du même environnement pour confirmer quelle source d’identifiants est résolue
Clé API non valide
La variable d’environnementANTHROPIC_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.
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 PowerShellGet-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.envde votre projet sans que vous l’ayez définie explicitement. - Supprimez
ANTHROPIC_API_KEYet exécutez/loginpour 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
/statuspour confirmer quelle source d’identifiants Claude Code utilise réellement
Votre script apiKeyHelper échoue
Claude Code a exécuté la commande de votre paramètreapiKeyHelper 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 keyet 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.
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
apiKeyHelperpour 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
/statuspour voir l’échec et confirmer queapiKeyHelperest la source d’identifiants active. La ligneapiKeyHelperafficheFailingavec 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,/statusn’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
Authenticationdu terminal. Avant la v2.1.212, le panneau s’intitulaitCloud 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à deU+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: un jeton bearer provenant deANTHROPIC_AUTH_TOKENou deCLAUDE_CODE_OAUTH_TOKENInvalid ANTHROPIC_CUSTOM_HEADERS: un nom ou une valeur d’en-tête que vous avez défini dansANTHROPIC_CUSTOM_HEADERS. La description indique le rang de la paireName: Valuefautive, par exempledistinct 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, commeCLAUDE_AGENT_SDK_CLIENT_APP. La description nomme la variable à corriger.
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 :
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 paireName: Valuepar ligne et réécrivez la paire indiquée par le message - Exécutez
/statuspour confirmer quelle source d’identifiants est active
Cette organisation a été désactivée
Claude Code utilise uneANTHROPIC_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.
· 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_KEYdans le shell actuel et retirez-la de votre profil de shell, puis relancezclaude - 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
/statuspour 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é :
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 relancezclaude - Si le message nomme
apiKeyHelper, retirez le paramètreapiKeyHelperde votresettings.json - Exécutez
/loginpour vous connecter avec votre compte claude.ai - Exécutez ensuite
/statuspour 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.
-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.
- 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.- Une variable de fournisseur
CLAUDE_CODE_USE_*, commeCLAUDE_CODE_USE_BEDROCKpour Amazon Bedrock ouCLAUDE_CODE_USE_VERTEXpour Google Cloud’s Agent Platform ANTHROPIC_BASE_URLpointant vers un hôte autre queapi.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 ControlANTHROPIC_UNIX_SOCKETdé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
- Supprimez la variable que nomme le message, comme
CLAUDE_CODE_USE_BEDROCKouANTHROPIC_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é
envdans 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 signaleOAuth 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 :
Claude.ai login expiredetClaude.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ésOAuth 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 nouveauJWT refresh failed: no OAuth token: Claude Code n’a trouvé aucun jeton de connexion enregistré avec lequel renouvelerSigned out of Claude: vous vous êtes déconnecté sur cette machine, par exemple en exécutant/logoutdans un autre terminal, Claude Code n’a donc plus de connexion enregistrée avec laquelle renouveler la connexion
- Exécutez
/loginpour vous reconnecter - Exécutez
/remote-controlpour reconnecter la session. Les messages se terminant parrun /login to restore Remote Controlne nécessitent pas cette étape : Claude Code se reconnecte de lui-même une fois que vous êtes connecté.
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à.
- Exécutez
/remote-controlpour démarrer une nouvelle session Remote Control sous le compte ou l’organisation actuel - Pour revenir en arrière, exécutez
/loginet reconnectez-vous au compte ou à l’organisation précédent. Exécutez ensuite/remote-control.
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 :
- 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.
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 dansCLAUDE_CODE_OAUTH_TOKEN, vous voyez les mêmes messages lorsque ce jeton expire ou est révoqué.
-p) et dans l’Agent SDK, les messages se présentent comme suit, et le code d’erreur structuré est authentication_failed :
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
-pou votre programme Agent SDK utilise une connexion enregistrée, exécutezclaudedans 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 avecANTHROPIC_API_KEYou générez un jeton de longue durée avecclaude 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./statusaffiche ces identifiants sous la forme d’une ligneAuth tokenindiquantCLAUDE_CODE_OAUTH_TOKEN. Générez un nouveau jeton avecclaude setup-tokenet 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 Forbiddenet 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 uneANTHROPIC_API_KEY approuvée, et la solution diffère : commencez donc par exécuter /status pour voir lesquels sont actifs.
- Si
/statusaffiche une ligneAPI keyqui n’est pas marquée comme inutilisée, uneANTHROPIC_API_KEYapprouvée constitue les identifiants actifs et a priorité sur votre connexion, de sorte que/loginne la remplace pas. Renouvelez la clé dans la Claude Console, ou revenez à votre abonnement en exécutantunset ANTHROPIC_API_KEY, ou dans PowerShellRemove-Item Env:ANTHROPIC_API_KEY. - Si
/statusn’affiche que votre connexion, exécutez/loginune 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_URLpointe vers une passerelle LLM, le texte après401est le message de votre passerelle et non celui d’Anthropic, et/loginn’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.
-p) et dans l’Agent SDK, le message se présente comme suit, et le code d’erreur structuré est authentication_failed :
Login expired qui se termine par or re-authenticate your Anthropic profile, consultez Anthropic profile login expired.
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
/loginpour 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
claudedans 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 avecANTHROPIC_API_KEYou générez un jeton de longue durée avecclaude 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 :-p) et dans l’Agent SDK, le message se présente comme suit, et le code d’erreur structuré est server_error :
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.- 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 :
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-tokensur une machine où la connexion fonctionne et définissez le jeton qu’il affiche commeCLAUDE_CODE_OAUTH_TOKENsur cette machine. Sinon, définissezANTHROPIC_API_KEYsur 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/feedbackafin 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 :- 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 :- Exécutez
/loginet 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ètreapiKeyHelperou une clé Console enregistrée par un/loginpré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éfinissentforceLoginMethod 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 :
/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 :
- Pour
Not signed in to the Cloud gateway, exécutez/loginet 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
forceLoginMethodetforceLoginGatewayUrlde ses paramètres gérés
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 :-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
/loginavec ce compte, ou définissez la clé avecANTHROPIC_API_KEY
Connexion au profil Anthropic expirée
Claude Code s’authentifie via un profil d’identifiants Anthropic dont l’identifiant de connexion enregistré a expiré, et le profil ne contient aucun identifiant d’actualisation que Claude Code puisse utiliser pour le renouveler. Claude Code arrête chaque requête localement sans réessayer.- Si le message commence par
Login expired, exécutez/loginpour vous reconnecter - Pour renouveler un profil écrit par la connexion Console sans clé ou par
ant auth loginde la CLI Claude Platform, exécutez/loginsur une machine qui propose la connexion sans clé. Choisissez le compte Anthropic Console, puis Sign in with your Console account. Claude Code remplace l’identifiant expiré dans ce profil - Pour renouveler un profil créé par un autre outil, reconnectez-vous avec cet outil. Si vous choisissez plutôt Sign in with your Console account dans
/login, Claude Code laisse le profil tel quel et crée une clé API - Si un administrateur a provisionné les identifiants du profil, demandez-lui d’en émettre de nouveaux
- Exécutez
/statuspour confirmer la source d’identifiants active et le nom du profil - Pour cesser d’utiliser le profil, supprimez
ANTHROPIC_PROFILEsi vous l’avez définie, puis authentifiez-vous d’une autre manière, par exemple avec/loginouANTHROPIC_API_KEY
- Lorsque Claude Code a découvert le profil à partir de votre répertoire de configuration et que son mode d’authentification est
user_oauth, le message commence parLogin expiredet propose d’abord/login. Claude Code donne à un/loginfonctionnel la priorité sur le profil découvert, puis s’authentifie plutôt avec votre compte claude.ai. De la v2.1.234 à la v2.1.277, cette forme indiquaitAnthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile. Avant la v2.1.234, Claude Code affichait également la formeRe-authenticate your Anthropic profiledans ce cas. - Lorsque vous avez sélectionné le profil avec
ANTHROPIC_PROFILE, le message commence parAnthropic profile login expired.
ANTHROPIC_PROFILE, soit un profil que Claude Code découvre comme profil actif dans votre répertoire de configuration Anthropic, soit un profil 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.
Exigence de scope OAuth
Le jeton stocké est antérieur à un scope de permission dont une fonctionnalité plus récente a besoin :- Exécutez
/loginpour 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 :
- Exécutez
/loginpour 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/mcpsignaleyour claude.ai session token was rejected; la forme saisie/mcp reconnect <server>signale une reconnexion réussie alors que le jeton est toujours rejeté.
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, 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, qui réexécute le helper.
Pour un serveur avec un en-tête Authorization statique dans sa configuration :
/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, 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 :
- Définissez l’
urlde 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ètreiss 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 :
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
issle 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
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 surlocalhost, 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 :
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ébutAWS credentials expired or invalid :
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
awsAuthRefreshest défini, exécutez la commande nommée dans le message, commeaws 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
awsAuthRefreshdé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-identitydans 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 uneAccessDeniedException 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.
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
awsAuthRefreshnommé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-identitypour 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ébutGoogle Cloud credentials expired or invalid :
- 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
gcpAuthRefreshnommée dans le message, ougcloud auth application-default login, et terminez la connexion, puis réessayez - Si vous passez par une passerelle LLM avec
CLAUDE_CODE_SKIP_VERTEX_AUTHdéfini, actualisez le jeton de la passerelle dansANTHROPIC_AUTH_TOKENouANTHROPIC_CUSTOM_HEADERS, puis réessayez - Si vous vous authentifiez avec un fichier de clé de compte de service, vérifiez que
GOOGLE_APPLICATION_CREDENTIALSpointe 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-tokendans le même shell
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ébutGoogle Cloud authentication failed :
- 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
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 :
- 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 nouveauANTHROPIC_FOUNDRY_AUTH_TOKEN, ou exécutezaz loginpour 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
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 Google par défaut de l’application sur la machine où il s’exécute, si bien qu’aucune requête n’a atteint votre fournisseur cloud. Le détail après le· indique la cause précise, comme une session SSO expirée, des identifiants par défaut de l’application manquants signalés par Could not load the default credentials, ou une connexion révoquée signalée par invalid_grant :
-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 myprofileougcloud 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.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-identitydans le même shell avec le mêmeAWS_PROFILE. Si la commande se bloque également, corrigez le profil ; une commandecredential_processqui 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 avecCLAUDE_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 :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 :
unreachable au lieu d’afficher l’un ou l’autre message.
Que faire :
- Exécutez
aws sts get-caller-identitydans 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émarrezclaude en mode interactif, la session s’est ouverte déconnectée de la passerelle :
claude autre que claude auth, Claude Code se ferme plutôt avec ce message lorsque la passerelle n’accepte plus la session :
- Exécutez
/logindans la session et terminez la connexion dans le navigateur - Pour un lancement non interactif, démarrez
claudedans 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é :- Exécutez de nouveau
/loginet 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 :- 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
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.Unable to connect to 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 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, utilisezcurl.exe -I https://api.anthropic.compour que l’aliasInvoke-WebRequestintégré ne soit pas utilisé. - Si vous êtes derrière un proxy d’entreprise, définissez
HTTPS_PROXYavant de lancer Claude Code et consultez Configuration réseau - Si vous routez via une passerelle LLM ou un relais, définissez
ANTHROPIC_BASE_URLsur son adresse. Consultez Connecter Claude Code à une passerelle LLM pour la configuration. - Assurez-vous que votre pare-feu autorise les hôtes listés dans Exigences d’accès réseau
- Les défaillances intermittentes sont automatiquement réessayées ; les défaillances persistantes pointent vers un problème réseau local
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_URLest défini en exécutantecho $ANTHROPIC_BASE_URL, ouecho $env:ANTHROPIC_BASE_URLdans PowerShell, et cherchez-le dans le blocenvde vos fichiers de paramètres. Lorsqu’il est défini, Claude Code envoie les requêtes de modèle à cette adresse au lieu deapi.anthropic.com, donc une valeur résiduelle pointant vers un proxy local ou une passerelle qui ne fonctionne plus produitConnection refusedmême sicurlatteint 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.confpour un serveur de noms inaccessible. WSL en particulier peut hériter d’un résolveur cassé de l’hôte. - Sur macOS, un client VPN qui a été déconnecté ou désinstallé peut laisser une interface de tunnel ou une règle de routage. Vérifiez
ifconfigpour les interfacesutunobsolè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é.
Unable to connect to Anthropic services
Lors de la configuration initiale, Claude Code vérifie qu’il peut atteindreapi.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.
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 endpoints d’Anthropic étaient inaccessibles.
Claude Code ignore également la vérification sur une machine sans paramètres gérés lorsque votre propre ~/.claude/settings.json nomme une passerelle avec forceLoginMethod et forceLoginGatewayUrl. Avant la v2.1.295, Claude Code exécutait la vérification dans ce cas.
À 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
curlet 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 Nouvelles tentatives 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
API returned an empty or malformed response
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.- Une clause
Response:avec le type de contenu, le type de corps, commebody is an HTML pageouempty 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, commenginxoucloudflare, ou porte des en-têtes intermédiaires, commecf-rayouvia, 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é.
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é commenginxoucloudflaresignifie 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=1pour désactiver cette solution de repli, sauf lorsque l’endpoint en streaming lui-même retourne404, où Claude Code bascule toujours sur celle-ci
Streaming response ended before any complete data was received
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.- 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êteContent-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.
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
InvokeModelWithResponseStreamet son en-têteContent-Typesans 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=1masque cette erreur, mais Claude Code ne décode pas un corps binaire sous un en-tête réécrit, donc ces requêtes se rabattent 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.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 nouvelles tentatives 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, sont toujours réessayées.
Pendant /login et la vérification de connectivité au démarrage, la même défaillance produit un message différent :
- 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.- 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.
Le proxy a refusé la connexion
Vous voyez ce message lorsque Claude lit un artefact via le proxy que vous avez défini dansHTTPS_PROXY ou une variable proxy associée. Le contenu des artefacts 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 :
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 logs 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.
- 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écutezcurl.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 artefacts. - Si votre réseau permet à Claude Code d’atteindre l’hôte des artefacts directement, ajoutez
.frame.claudeusercontent.comàNO_PROXY. Gardez l’entrée étroite : une entrée.claudeusercontent.complus large contourne également le proxy pourbridge.claudeusercontent.com, que les organisations avec IP allowlisting doivent garder sur le proxy.
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 :
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
Failed to fetch session from Sessions API
Ce message signifie que Claude Code a trouvé la session cloud que vous avez demandé de récupérer dans votre terminal mais n’a pas pu lire son historique de conversation depuis les serveurs d’Anthropic, et ne l’a donc pas ouverte :claude --teleport, /teleport, ou après avoir choisi la session dans la liste /tasks. claude --teleport <session-id> l’affiche et se ferme avec le code 1.
À faire :
- Exécutez à nouveau le même teleport. S’il échoue de la même manière, signalez le problème
Couldn’t reconnect to your Remote Control session
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-controlpour réessayer la connexion - Démarrez une nouvelle session avec
claude --remote-controlpour créer une nouvelle session Remote Control - Pour les autres messages de démarrage Remote Control, consultez Troubleshoot Remote Control
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écutantclaude 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.
- 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-controlpour démarrer un environnement frais
Couldn’t share the transcript
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é.- Exécutez
/feedbackpour envoyer la transcription avec une description de ce qui s’est passé. Consultez Report an error si/feedbackn’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
Couldn’t send feedback
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.
: 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.
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
/loginet 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
Erreurs de requête
Ces erreurs concernent le contenu de votre requête. La plupart proviennent de l’API après qu’elle ait rejeté la requête ; quelques-unes sont produites localement par Claude Code avant l’envoi de toute requête.Le prompt est trop long
La conversation plus les fichiers joints dépasse la fenêtre de contexte du modèle./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 :
/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 :
/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 prompt le plus récent mot pour mot et résume tout ce qui le précède.
- Dans ce cas, quand la conversation ne se termine pas par votre prompt, Claude Code résume la conversation entière à la place.
/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 une telle conversation, Claude Code ignore la tentative et explique ce qui remplit la requête à la place. Quand l’API ne signale pas les nombres de tokens dans son erreur, le message se lit :
Prompt is too long nu quand il échouait.
Que faire :
- Exécutez
/compactpour résumer les tours antérieurs et libérer de l’espace, ou/clearpour recommencer. Si/compactrépondNot enough messages to compact., la conversation est un échange unique sans rien d’antérieur à résumer, donc l’espace est occupé par ce prompt et ce que Claude Code envoie avec chaque requête : exécutez/clearet 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
/contextpour voir une ventilation de ce qui consomme la fenêtre : prompt système, outils, fichiers mémoire et messages - Désactivez les serveurs MCP que vous n’utilisez pas avec
/mcp disable <name>pour supprimer leurs définitions d’outils du contexte - Réduisez les fichiers mémoire
CLAUDE.mdvolumineux, ou déplacez les instructions dans les règles à 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
/configou avecDISABLE_AUTO_COMPACT, réactivez-la. Si vous la gardez désactivée, exécutez/compactvous-même avant que la fenêtre se remplisse.
Le contexte dépasse la limite de tokens
/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.
/clear au lieu de /compact quand vous avez défini DISABLE_COMPACT.
Que faire :
- Dans une conversation multi-tours, exécutez
/compactpour 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 Le prompt est trop long
/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; 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 ditcompacting cannot make it fitet 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.
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/clearpour 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.- 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 3 000 pixels quand plus de 20 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.- 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.
Request rejected as unprocessable by the model
L’API a refusé la requête, la jugeant impossible à traiter par le modèle. Le message est celui de l’API.- Si le message continue d’apparaître dans une conversation contenant des images ou des documents, retirez-les vous-même. Appuyez deux fois sur Échap pour revenir avant les tours qui les ont ajoutés, ou exécutez
/clearpour repartir de zéro.
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.- Pour les PDF surdimensionnés, demandez à Claude de lire une plage de pages avec l’outil Read au lieu de joindre le fichier entier, ou extrayez le texte avec un outil comme
pdftotextet référencez le fichier de sortie par chemin - Pour les PDF protégés ou invalides, supprimez le mot de passe ou réexportez le fichier depuis son application source, puis réessayez
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êteanthropic-beta, donc l’API a rejeté les champs qui en dépendent.
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=1avant 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é uninput_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.
$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_schemade 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.
Nom d’outil MCP de plus de 128 caractères
Un serveur MCP liste un outil dont le nom complet, commemcp__<server>__<tool>, dépasse les 128 caractères que l’API accepte. Claude Code exclut cet outil de ceux qu’il envoie à Claude, et les autres outils du serveur continuent de fonctionner. Dans une session que vous démarrez avec claude --debug depuis votre shell, Claude Code écrit ce message dans le log de débogage à ~/.claude/debug/<session-id>.txt :
- Si vous maintenez le serveur, raccourcissez le nom de l’outil.
- Si le serveur se trouve dans votre configuration MCP, donnez-lui un nom plus court à cet endroit, comme
dbau lieu deanalytics-database. Mettez ensuite à jour ce qui fait référence au serveur ou à ses outils par l’ancien nom, comme les règles de permission et les matchers de hooks. - Si un plugin regroupe le serveur, le nom complet de l’outil inclut aussi le nom du plugin. Demandez au mainteneur du plugin de raccourcir le nom du serveur ou de l’outil.
API Error: 400 ... tools.N.custom.name: String should have at most 128 characters.
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 :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.
/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.- CLI interactif : exécutez
/modelpour choisir parmi les modèles disponibles pour votre compte. - Mode non interactif (
-p) : passez--modelavec un alias ou un ID valide, ou définissezANTHROPIC_MODEL. Le texte d’erreur afficheRun --modelsur cette surface. - Agent SDK : le texte d’erreur omet l’indice car le modèle est défini par programmation. Définissez
modelsurOptionsen TypeScript ouClaudeAgentOptions(model=...)en Python, et gérez l’erreur structuréemodel_not_foundpour afficher votre propre nouvelle tentative ou sélecteur de modèle. - Utilisez un alias comme
sonnetouopusau 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
/loginsi 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 une chaîne que Claude Code peut utiliser comme modèle, 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 SDKsetModel(), 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 Remote Control. 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é.
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 Remote Control, 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 effectués via Remote Control, donc une chaîne non reconnue était appliquée et échouait à la requête suivante.
Que faire :
- Exécutez
/modelsans 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 que seule 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_URLpersonnalisé, 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 endpoint API. Avec/model <name>, un nom qui ne peut pas du tout être un ID de modèle, comme un nom contenant des espaces, obtient le même message.
Try '...' instead qui nomme l’ID de votre fournisseur pour un modèle de secours.
Que faire :
- Exécutez
/modelsans argument et choisissez parmi les modèles disponibles pour votre compte, ou utilisez un alias de modèle commesonnet, 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, appelezsupportedModels()pour lister les modèles vers lesquels vous pouvez basculer. - Avant v2.1.265,
/modelrejetait aussi l’orthographe d’aliasopusplan[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 SDKsetModel() 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 endpoint API n’a pas reçu de réponse dans les cinq secondes. La session garde son modèle actuel.
Try again.
Que faire :
- Basculez vers le modèle à nouveau
- Si le basculement continue d’échouer, vérifiez que Claude Code peut atteindre votre endpoint 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 :
- 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é.sign out and sign in again au lieu de nommer les commandes.
Que faire :
- Exécutez
/modelet sélectionnez un modèle que votre plan inclut - Si vous avez mis à niveau votre plan récemment et voyez toujours cela, exécutez
/logoutpuis/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 qu’une fois que vous vous êtes réauthentifié. - 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’erreurclaude_code_version_too_old, et le message dit quel minimum s’applique.
- Si vous exécutez
claude updatesur le canal de publication stable, cela ne vous fait pas dépasser la version stable la plus récente, qui peut encore être inférieure au minimum requis. Passez au canal latest, puis mettez à jour à nouveau. Si votre organisation fixe votre canal ou votre version via des paramètres gérés, demandez à votre administrateur de le modifier - Pour le libellé par modèle, vous pouvez continuer à travailler dans la session actuelle en basculant vers un autre modèle : exécutez
/modeldans le CLI, appelezsetModel()sur l’objetQuerydu SDK TypeScript en mode d’entrée en streaming, ou appelezset_model()sur leClaudeSDKClientdu 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’autorisationavailableModels 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 <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 skill 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
/modelpour choisir parmi les modèles que votre organisation autorise. Les modèles restreints sont masqués du sélecteur. - Si le modèle restreint a été défini dans
--model,ANTHROPIC_MODEL, le champmodeld’un fichier de paramètres, ou le frontmattermodeld’un sous-agent, d’un skill 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.
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ésoutyour organization allows only the models listed in "availableModels": une liste d’autorisationavailableModelsgérée avecavailableModelsMatchdéfini à"exact"laisse de côté le modèle auquel l’option Par défaut se résoutClaude 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é
- Pour les libellés
deniedModelsetavailableModels, exécutez/modelet 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
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 de Remote Control plutôt que d’une commande que vous avez tapée, le message se litModel switch blocked by a PreModelSwitch hook sans nommer le modèle cible.
- Une raison qu’un hook a écrite : un hook PreModelSwitch a fourni cette raison quand il a refusé le changement ou demandé une confirmation. Traitez 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 reste bloquée ou augmentez letimeoutde ce hook, puis changez à nouveau.confirmation required, and this session cannot ask: un hook a réponduasksans raison, et une demande de contrôle n’a aucun moyen d’afficher la demande de confirmation. Une commande/modeldans une exécution-psignale 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 les plugins gérés de votre 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 disparu cesse de bloquer ; si elle continue d’échouer, exécutezclaude --debuget changez à nouveau pour capturer les détails, puis corrigez le plugin ou demandez à votre administrateur de le corriger.a PreModelSwitch hook failed before answeringouPreModelSwitch 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écutezclaude --debugpour voir ce qui a échoué, puis changez à nouveau.
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 Enter dans le sélecteur /model, et Claude Code n’a pas pu écrire ce choix dans votre fichier de paramètres utilisateur, ~/.claude/settings.json. Le changement lui-même a été appliqué ; la session en cours s’exécute donc sur le modèle choisi, mais votre valeur par défaut reste inchangée et la prochaine session démarre sur l’ancienne valeur.
can't be written (<code>): l’écriture a échoué avec le code d’erreur du système d’exploitation entre parenthèses, commeEROFSquand le fichier, ou le fichier vers lequel il pointe, 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émodeldans 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é.
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 sur 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é.
Le conseiller est moins performant que le modèle principal actuel
Votre modèle conseiller est classé en dessous du modèle principal de votre session, donc Claude Code conserve la sélection mais n’attache pas le conseiller aux requêtes du modèle principal.- Dans une session interactive, une notification indique
Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor. - Au lancement avec le flag
--advisor, un avertissement indique"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.et la session démarre quand même.
- Choisissez un conseiller mieux classé ou un modèle principal moins bien classé. Choisir un modèle conseiller présente le classement et liste les conseillers acceptés pour chaque modèle principal.
- Laissez le conseiller défini si vous voulez que les sous-agents dont il peut conseiller le modèle continuent à l’utiliser
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.- Exécutez
claude updateet redémarrez Claude Code. Opus 4.7 nécessite v2.1.111 ou ultérieur. Opus 4.8 nécessite v2.1.154 ou ultérieur. Sonnet 5 nécessite v2.1.197 ou ultérieur. 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 - Sur le canal de publication stable, la mise à jour ne vous fait pas dépasser la version stable la plus récente, qui peut encore être antérieure à ces versions. Passez au canal latest, puis mettez à jour
- Si vous ne pouvez pas mettre à jour, exécutez
/modelet 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 dehigh. Le modèle n’accepte pas cette combinaison, donc l’API a rejeté la requête.
· 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 à
highou en dessous. - Réactivez la réflexion, par exemple en supprimant
MAX_THINKING_TOKENSou en retirant"alwaysThinkingEnabled": falsede vos paramètres.
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 dont il sait qu’ils rejettent 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.- Augmentez
CLAUDE_CODE_MAX_OUTPUT_TOKENSau-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.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/rewindne la supprime pas. - Exécutez
/rewind, ou appuyez deux fois sur Échap, pour revenir à un checkpoint avant le tour corrompu et continuer à partir de là. Voir Checkpointing pour la façon dont les checkpoints 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 blocredacted_thinking qu’un tour antérieur dans l’historique de conversation porte.
- Si vous êtes sur v2.1.281 ou antérieur et chaque tour échoue avec cette erreur, exécutez
claude updateet reprenez la session - Si l’erreur persiste, exécutez
/clearpour 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 là où le contenu supprimé se trouvait entre deux blocs de réflexion :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 updateet 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 :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 message 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é son propre message système.
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
/clearpour 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.
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 :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 updateet reprenez la session - Si l’erreur persiste, ou si le message nomme
encrypted_stdout, exécutez/rewindpour revenir à un checkpoint avant le tour qui a ajouté le contenu, ou exécutez/clearpour 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. Si le message inclut la ligneDetails: `[reasoning_extraction]`, voir Les mesures de protection ont signalé une demande portant sur le raisonnement de Claude.
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.
Claude quand aucun modèle n’est enregistré.
La vérification évalue la conversation complète, pas seulement votre prompt le plus récent, 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
/rewindpour revenir à un checkpoint avant le tour qui a déclenché le refus, puis reformulez ou prenez une approche différente. Voir Checkpointing. - Si vous ne pouvez pas identifier quel tour l’a causé, exécutez
/clearpour 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ù le rembobinage est indisponible, réessayez avec un prompt reformulé 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--modelpeut 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 :Details: `[reasoning_extraction]`, voir Les mesures de protection ont signalé une demande portant sur le raisonnement de Claude.
Ce message renvoie vers le Programme de vérification de cybersécurité, qui accorde l’accès pour le travail de cybersécurité légitime. Les modèles dotés du basculement automatique vers un modèle de secours affichent un message différent, sans ce lien ; sur Opus 5.5 et Sonnet 5.5, il s’ouvre avec <model>'s safeguards flagged this session. Cette section explique aussi quand Claude Code change de modèle à la place.
Sur Amazon Bedrock, la plateforme d’agent de Google Cloud et Microsoft Foundry, un signalement 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 ne portait pas sur un sujet de cybersécurité, exécutez
/feedbackpour signaler le faux positif - Pour continuer à travailler dans la même session, appuyez deux fois sur Échap ou exécutez
/rewindpour revenir à un checkpoint avant le tour qui a déclenché le signalement, puis prenez une approche différente. Voir Checkpointing.
Les mesures de protection ont signalé une demande portant sur le raisonnement de Claude
L’API a refusé la requête parce que les mesures de protection l’ont signalée comme demandant au modèle de reproduire son raisonnement interne dans la réponse. L’API nomme cette catégorie de refusreasoning_extraction, et le message de refus inclut cette ligne :
Details.
Que faire :
- Supprimez ou reformulez toute instruction qui demande à Claude d’écrire sa réflexion ou son raisonnement mot pour mot ou dans un format fixe, comme une section
<thinking>, une section de brouillon ou un champreasoningdans une sortie JSON. L’instruction peut se trouver dans votre prompt ou dans une personnalisation que Claude Code charge avec celui-ci, comme CLAUDE.md, un skill, un prompt de sous-agent, un style de sortie ou une description d’outil MCP. - Pour vérifier si une personnalisation est le déclencheur, exécutez
claude --safe-modedans votre terminal pour démarrer une session avec les personnalisations désactivées, puis envoyez le même prompt - Après avoir modifié une personnalisation, démarrez une nouvelle session
- Pour reformuler un prompt que vous avez déjà envoyé, voir Rembobiner et résumer
- Vous pouvez toujours demander à Claude d’expliquer sa réponse. Demandez une courte explication, les éléments qui étayent un résultat ou un résumé des actions qu’il a effectuées. Pour lire des résumés de la réflexion de Claude, voir
showThinkingSummaries. - Pour plus d’exemples, et pour savoir quoi faire si une demande reformulée est toujours refusée, voir Conserver le raisonnement dans les blocs de réflexion
Output blocked by content filtering policy
Le filtre de contenu de sortie de l’API a arrêté la réponse que Claude générait. Le texte du message provient de l’API :- Reformulez votre dernier message ou adoptez une approche différente
- Pour revenir à un checkpoint avant le tour qui a déclenché le blocage, appuyez deux fois sur Échap ou exécutez
/rewind. Voir Checkpointing
Erreurs de ligne de commande
Ces erreurs proviennent de la ligne de commandeclaude 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 également 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 la même invocation de 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.
- Supprimez
-pou--print.--bgprend le prompt comme argument positionnel, doncclaude --bg "<task>"constitue 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
--bget exécutezclaude -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 une même invocation de claude, donc claude se termine avec le code 1 au lieu de démarrer la session :
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 inline 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 tout de même la session.
- Lorsque la valeur commence par
{mais ne s’analyse pas en JSON, ou que le contenu d’un fichier--agentsne s’analyse pas, Claude Code affiche une ligneinvalid JSON:contenant le message propre à l’analyseur JSON - Lorsqu’elle s’analyse mais qu’une définition d’agent ne correspond pas au schéma des sous-agents définis via la CLI, Claude Code affiche une ligne par problème
- Lorsqu’un nom d’agent commence par
-, Claude Code affiche<name>: agent names must not start with '-'
…and N more.
Avec --print, --agents accepte également le chemin d’un fichier JSON à la place de l’objet inline. Avant la v2.1.281, --agents n’acceptait que du JSON inline 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 les suivants :
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 inline, ou ajoutez-ppour 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 inline altéré par votre shell peut également échouer de cette façon. Vérifiez le chemin ou les guillemets et relancez la commande.
- Corrigez chaque problème listé par le message, puis relancez la commande. Consultez les champs acceptés par un sous-agent défini via la CLI.
Impossible de créer des sessions cloud depuis une session --restricted
Lorsque vous démarrez une session avec --restricted, Claude Code refuse d’en 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 :
- 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
claudesans--restrictedet créez la session cloud à partir de celle-ci
--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 politiqueallow_remote_sessions de votre organisation est désactivée, donc les sessions cloud et les commandes qui les utilisent ne sont pas disponibles :
/teleport, /remote-env ou /web-setup. Avant la v2.1.268, la soumission de l’une de ces commandes renvoyait Unknown command à la place.
Si le message nomme plutôt des identifiants utilisés par cette session et se termine par Cloud sessions use your claude.ai login., consultez Cloud sessions use your claude.ai login. Si Claude Code n’a pas du tout pu charger la politique de votre organisation, vous voyez un message différent à 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
Cloud sessions use your claude.ai login
Lorsque le refus lié à la politique nomme des identifiants utilisés par cette session et se termine par cette phrase, Claude Code a vérifié la politique de sessions cloud de l’organisation qui a émis ces identifiants. Cette organisation peut être différente de celle à laquelle appartient votre connexion claude.ai :--cloud ou --teleport. Avant la v2.1.296, Claude Code affichait également dans ce cas la forme qui vous invite à contacter l’administrateur de votre organisation.
Couldn’t verify your organization’s policy for cloud sessions
Ces messages signifient que Claude Code n’a pas pu charger la politique de votre organisation, qu’il vérifie avant de créer, reprendre ou envoyer un message à une session cloud. Tant que la requête de politique n’est pas terminée, le message est le suivant :/teleport ou /web-setup, renvoie également ce message. C’est le cas même lorsque votre shell afficherait une forme Cloud sessions aren't available:, et sa deuxième phrase est Check your network connection, then restart Claude Code and try again.
Une fois que la requête de politique a échoué, le message indique ce qui a échoué. Cela s’applique lorsque vous démarrez, reprenez ou envoyez un message à une session cloud depuis votre shell avec un flag comme --cloud ou --teleport. Sans route vers l’API, il indique :
ANTHROPIC_API_KEY, le message peut aussi les nommer et indiquer de les supprimer :
Couldn't verify.
Que faire :
- Pour le message
Couldn't verify, vérifiez votre connexion réseau et réessayez. Dans une session, redémarrez d’abord Claude Code - Pour un message
Cloud sessions aren't available:, faites ce que requiert sa cause, comme vérifier votre proxy ou supprimer les identifiants qu’il nomme, puis exécutez à nouveau la commande
Rien n’a été mis dans le stash car un dossier a remplacé un fichier suivi
Ce message signifie qu’un dossier de votre checkout se trouve désormais là où se trouvait auparavant un fichier ou un lien suivi par git. Il apparaît après que vous avez choisi l’option de stash lors de la récupération d’une session cloud dans votre terminal, par exemple avecclaude --teleport ou /teleport. Mettre cet état dans le stash pourrait supprimer les fichiers contenus dans le dossier, donc Claude Code refuse le stash et laisse votre checkout et votre index inchangés :
- Faites un commit de la modification ou déplacez le dossier ailleurs, comme l’indique le message, puis relancez le teleport
La valeur de --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 considéré comme invalide.
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 Mio
Le fichier que vous avez passé à--settings dépasse 2 Mio, 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 tel que /dev/zero faisait croître la mémoire sans limite.
--settings qui n’est pas un fichier ordinaire : un périphérique, un FIFO ou un socket renvoie Error: Cannot use settings file (Not a regular file (device, FIFO, or socket)) suivi du chemin, et un répertoire renvoie une raison EISDIR.
Que faire :
- Faites pointer
--settingsvers un fichier de paramètres JSON ordinaire de moins de 2 Mio. 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, donc il se termine 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 sur stderr le code source minifié du bundle et une pile brute ENOENT ... uv_cwd au lieu de ce message.
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 y renvoie Operation not permitted, même avec sudo.
Que faire :
- Placez-vous dans un répertoire existant, comme votre répertoire personnel ou votre répertoire de projet, puis relancez
claude - Si le répertoire a été recréé au même chemin, votre shell conserve toujours le répertoire supprimé. Exécutez
cd "$PWD"ou quittez le répertoire puis revenez-y, puis relancezclaude - Pour
EPERMsur macOS, quittez votre application de terminal avec Cmd+Q, rouvrez-la, revenez dans ce dossier et exécutezclaude. Silsé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 vérifications de sécurité, Claude Code affiche l’échec sur stderr et se termine avec le code 1 au lieu de démarrer la session :
- 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 ce vers quoi pointe un lien, puis redémarrez Claude Code ; pour la formeowned by uid, seul un administrateur ou cet utilisateur peut la supprimer - Pour
is not readable, exécutezchmod 0700sur le répertoire nommé, ou supprimez-le et redémarrez - Dans tous ces cas, définissez
CLAUDE_CODE_TMPDIRsur 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 charge uniquement ses skills, commandes et agents. Avant de les charger, Claude Code vérifie que l’emplacement réel du répertoire, une fois les liens symboliques résolus, se trouve dans le répertoire de travail. Lorsque Claude Code ne peut pas résoudre cet emplacement, il ne charge rien et affiche ce message :
- Vérifiez que le chemin désigne un répertoire réel dans le répertoire de travail, puis relancez
/add-dir - Le message ne modifie pas votre accès aux fichiers ; il signale uniquement que le contenu
.claude/du répertoire n’a pas été chargé
/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 rien changer.
Espace de travail non approuvé au démarrage de Remote Control
Vous avez démarré Remote Control en mode serveur avecclaude 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 souhaitiez l’approuver. Par exemple, l’entrée standard ou la sortie standard de la commande n’est pas un terminal, car l’une d’elles est redirigée ou transmise par un pipe. La commande se termine avec le code 1 :
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 communiqué sa taille. Agrandissez la fenêtre ou passez à une fenêtre de terminal normale, puis relancez 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 ; l’accepter à cet endroit ne peut donc 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.
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. Relancez claude rc pour répondre y.
Que faire :
- Approuvez d’abord le répertoire depuis un terminal : exécutez-y
claude rcet répondezy, ou exécutez-yclaudeet acceptez la boîte de dialogue d’approbation de l’espace de travail, puis relancez votre commande d’origine - Dans votre répertoire personnel, placez-vous dans un répertoire de projet et démarrez Remote Control à cet endroit
Non transmis aux sessions démarrées par Remote Control
Vous avez démarré Remote Control avec un flagclaude global placé avant le verbe remote-control, un flag qui restreindrait ou configurerait les sessions démarrées par Remote Control, tel que --settings, --setting-sources, --permission-mode, --disallowed-tools ou --mcp-config. Un flag placé avant le verbe n’atteint jamais ces sessions. Claude Code refuse alors de démarrer, en nommant le flag :
--verbose, --model, ou un --session-id ou --plugin-dir injecté par un wrapper : il les ignore et Remote Control démarre.
Claude Code refuse également 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 --helples liste - Lorsque le flag refusé est
--permission-mode, exécutezclaude remote-control --permission-mode <mode>pour définir le mode de permission des sessions démarrées par Remote Control
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 flux d’importation était désactivé, donc la commande se termine avec le code 1 au lieu de démarrer l’importation. Avant la v2.1.222, un build dont le flux d’importation était désactivé traitait import comme un prompt et démarrait une session interactive au lieu d’afficher ce message.
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 importpeut afficher ce message même lorsque la fonctionnalité vous est accessible. - 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 de feature flags dans ces sessions, donc
claude importreste indisponible. - Vous avez défini
DISABLE_TELEMETRY,DO_NOT_TRACK,DISABLE_GROWTHBOOKouCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, qui désactivent la récupération des feature flags, doncclaude importreste indisponible.
- Sur une nouvelle installation, démarrez
claude, attendez que la session se charge, quittez, puis relancezclaude import - Lorsque la récupération des feature flags reste désactivée, mettez en place la configuration vous-même : ajoutez des serveurs MCP avec
claude mcp add, et créez les fichiersCLAUDE.md, skills et commandes et sous-agents que vous souhaitez transférer. Le message nomme également~/.claude/settings.json. De la configuration que transfèreclaude 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 propre à 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 que montre la session interactive, donc elle se termine 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.
- Exécutez
claudesans argument. Claude Code détecte le fichier invalide et propose de le réinitialiser. Relancez ensuiteclaude import. - Pour conserver les modifications manuelles que vous avez effectuées, corrigez plutôt la syntaxe JSON de
~/.claude.jsondans un éditeur, puis relancezclaude 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 dansclaude mcp add-from-claude-desktop. La commande importe tout de 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’importation.
claude mcp restreint aux lettres, chiffres, traits d’union et traits de soulignement. Les autres raisons 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.jsonpour n’utiliser que des lettres, chiffres, traits d’union et traits de soulignement, puis relancezclaude mcp add-from-claude-desktop - Ajoutez directement ce serveur avec
claude mcp addouclaude mcp add-jsonsous 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.
- Ajoutez le serveur à une portée dans laquelle vous pouvez écrire :
local,userouproject. Sans--scope, la commande utiliselocal. Consultez Portées d’installation MCP - Pour fournir le serveur à tous les utilisateurs de votre organisation, ajoutez-le à
managedMcpServersdans 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 incluant 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 :
claude mcp add-from-claude-desktop signale chaque serveur que vous sélectionnez comme non importé, avec ce message comme raison. /import signale ce message pour chaque serveur MCP qu’il tente d’ajouter et importe tout de même les autres éléments 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
managedMcpServerss’il s’agit d’un serveur HTTP ou SSE distant
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 Mio ; elle se termine donc avec cette erreur au lieu de lire le fichier.
.mcp.json laissait la commande en attente indéfiniment sans sortie, et un lien symbolique vers un fichier de périphérique tel que /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 de
.mcp.jsondans votre répertoire courant. Remplacez-le par un fichier JSON ordinaire au format de la portée projet, ou supprimez-le, puis relancez 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.
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 relancez 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 figurer ou non sur le disque. Le texte entre parenthèses est l’erreur de cette lecture.
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 ne pouvait pas être confirmée.
Que faire :
- Exécutez
claude mcp get <name>pour vérifier si la modification figure sur le disque. Pour un serveur de portéelocal, exécutez-la depuis le répertoire de projet auquel appartient le serveur, car la portée locale est propre à chaque projet. - Si le serveur est absent après un ajout, ou toujours listé après une suppression, relancez la même commande d’ajout ou de suppression.
Le serveur est hébergé par Anthropic et ne prend pas en charge l’OAuth local
Vous avez lancé une connexion à 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 incluentmicrosoft365.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, aussi bien depuis le panneau /mcp que depuis claude mcp login, car leur connexion ne fonctionne que via claude.ai.
- 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 connecté, 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 leheadersHelper fournit l’en-tête Authorization a répondu à la connexion par 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 bascule pas sur OAuth pour ce serveur :
- Exécutez vous-même la commande
headersHelperde la même manière 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.mcp.jsonde projet, d’un plugin ou d’un fichier d’agent de projet. Vérifiez qu’elle affiche une valeurAuthorizationacceptée par l’endpoint du serveur - Après avoir corrigé le helper ou la source de ses identifiants, sélectionnez le serveur dans
/mcpet choisissez Reconnect
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 tout de 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, et ne produit donc aucune réponse bien que la requête ait été envoyé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 également cette erreur.
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 listdans 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 listener local pour recevoir le callback de connexion. Si le port dont ce listener 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 variableMCP_OAUTH_CALLBACK_PORT ou --callback-port, car sans port fixe, Claude Code choisit un port disponible.
netstat -ano | findstr :<port>.
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 autre URI de redirection auprès du serveur et définissez son port avec
MCP_OAUTH_CALLBACK_PORTou--callback-port, selon celui 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 listener local pour recevoir le callback de connexion. La connexion échoue avec ce message lorsque Claude Code ne parvient pas à lier un port local pour ce listener. Un élément de la machine l’empêche d’écouter sur127.0.0.1, par exemple un logiciel de sécurité ou une politique de sandbox qui interdit les listeners locaux.
- 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 ref locale qui enregistre quelle branche est la branche par défaut de votre remote origin. Lorsque cette ref n’existe pas, les commandes git qui rassemblent le diff échouent et la revue s’arrête avant de commencer.
git log ou un autre git diff à la place. Git crée origin/HEAD uniquement 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 ref est absente dans ces configurations :
- Un checkout à branche unique 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 dépôt que vous n’avez jamais récupéré avec fetch
Shell command permission check failed for pattern "...": la vérification des permissions de la commande ne l’a pas autorisée. Vérifications des permissions sur les commandes injectées explique quels résultats interrompent l’invocation dans chaque mode de permission et comment pré-approuver une commande avecallowed-toolsSkill <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 enshell: powershell. Consultez Comment s’exécutent les commandes injectées
- Créez la ref en nommant la branche par défaut de votre remote :
git remote set-head origin <default-branch>. Cela fonctionne dès que la ref de suivi localeorigin/<default-branch>existe. Si ce n’est pas le cas, comme dans les clones à branche unique, récupérez d’abord la branche : exécutezgit remote set-branches --add origin <branch>, puisgit 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 originpuisgit remote set-head origin --auto, qui demande au remote quelle est sa branche par défaut. Cette commande échoue avecerror: Cannot determine remote HEADlorsque 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 la branche explicitement. Elle échoue avecerror: Not a valid reflorsque 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 ref. Si le remote est vide, poussez d’abord votre branche avecgit push -u origin HEADet nommez cette branche dans la commande set-head ;origin/HEADpointe alors vers la branche que vous venez de pousser, donc/security-reviewvoit un diff vide jusqu’à ce que la branche diverge de celle-ci.
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 plutôt en mode non interactif. 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é ce flag. Passer -p/--print sans prompt et sans rien transmettre sur stdin produit la même erreur partout.
- Pour une utilisation interactive, exécutez
claudedans 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 transmettez-le par un pipe avececho "your question" | claude -p
Claude Code ne peut pas lire le clavier ici
Vous avez exécutéclaude sans -p, ce qui démarre une session interactive, mais son entrée standard n’est pas un terminal. Quelque chose l’a transmise par un pipe ou redirigée, ou le programme qui a lancé claude a fourni son propre flux d’entrée.
Une session interactive a besoin d’un terminal pour lire vos frappes, et le comportement de Claude Code sans terminal dépend de votre plateforme :
- Windows : Claude Code affiche le message sur stderr et se termine avec le code 1 au lieu de démarrer l’interface
- macOS et Linux : Claude Code lit vos frappes depuis
/dev/ttyet démarre la session, avec le texte éventuellement transmis par pipe comme premier prompt. Vous voyez le message lorsque/dev/ttyne peut pas être ouvert, et sa première ligne nomme/dev/ttyà la place de la formulation Windows.
- Pour travailler de manière interactive, exécutez
claudedirectement dans un terminal, sans transmettre son entrée par un pipe ni la rediriger - Pour obtenir une réponse sans l’interface interactive, par exemple depuis un script, ajoutez
-pet fournissez le prompt en argument ou sur stdin, comme dansclaude -p "your question"ouecho "your question" | claude -p. Cela fonctionne également avec--continueet--resume <session-id>.
Raw mode is not supported.
Si vous voyez plutôt Raw mode is not supported pendant claude install, consultez Raw mode is not supported pendant l’installation.
L’entrée ne contenait que des espaces
En mode non interactif, Claude Code refuse un prompt composé uniquement 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 que vous voyez dépend de la provenance du prompt vide :- Argument de prompt ou stdin transmis par pipe pour
claude -p:claudese termine avecError: 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-jsonou 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.
- 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 a transporté 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écutionclaude -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é.
- Vérifiez ce qui est transmis sur stdin. Avec
--input-format stream-json, chaque message doit être une ligne JSON unique terminée par un saut de ligne - Pour envoyer du texte brut à la place, supprimez
--input-format stream-json;claude -plit par défaut un prompt en texte brut depuis stdin
Commande inconnue
Dans une session de terminal interactive, vous avez soumis un nom commençant par/ qui ne correspond à aucune commande de cette session, donc Claude Code signale le nom au lieu d’exécuter quoi que ce soit :
- Une faute de frappe, comme
/heplpour/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-setupet/scheduledétaillent deux cas courants. Certaines commandes répondent par leur propre message lorsque la politique de votre organisation les désactive, commeCloud 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
/ 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
Unknown command.
Claude Code ne traite pas comme une commande tout prompt commençant 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 est un chemin tel que /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 telle que /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 une commande documentée comme inconnue, 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’une 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 ne consomme pas d’exécution gratuite et ne facture pas de crédits d’utilisation. Le message indique les limites en vigueur, la taille de votre diff et les fichiers qui contribuent le plus aux lignes modifiées. Avant la v2.1.216, le message n’affichait que les statistiques brutes du diff.
PR #<N> is too large for ultrareview et indique 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 aux lignes modifiées, donc commencez 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 effectuent 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 se rabat 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 complète n’est pas possible, comme avec le format d’objet SHA-256.
- Vous n’avez pas passé de branche de base : Claude Code a effectué la comparaison 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 qui ne se trouvait pas dans 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 (shallow), il suggère plutôtgit fetch --unshallow origin. Avant la v2.1.221, l’indication suggéraitgit fetch --unshallow originpour chaque branche de base récupérée, et sur un clone complet cette commande échoue avecfatal: --unshallow on a complete repository does not make sense.
- Si une autre branche est votre véritable base, passez-la explicitement :
/code-review ultra <branch> - Si votre clone n’a peut-être pas l’historique complet, exécutez
git fetch --unshallow originet relancez la revue
Votre checkout n’a aucune branche
Un checkout peut avoir des commits mais aucune branche : si vous exécutezgit init suivi de git fetch <url> et git checkout FETCH_HEAD, vous obtenez un HEAD détaché sans aucune ref. Claude Code empaquette votre dépôt sous forme de bundle git pour l’envoyer en vue d’une ultrareview, et il ne peut pas créer de bundle d’un dépôt qui n’a ni branche ni autre ref, donc /code-review ultra et la sous-commande claude ultrareview refusent la revue avant le démarrage de la session cloud.
- 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 clone 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é.
/web-setup n’est pas disponible dans votre session, le message ne mentionne que le lien claude.ai.
Que faire :
- Exécutez
/web-setuppour connecter votre login GitHub CLI à votre compte Claude, ou connectez un compte sur claude.ai/connect-github - Relancez la revue une minute après la connexion
Votre compte GitHub connecté ne voit pas 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 clone 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é.
/web-setup n’est pas disponible dans votre session, le message ne mentionne que l’installation de l’application.
Que faire :
- Si votre CLI
ghlocale peut lire le dépôt, exécutez/web-setuppour connecter ce login à votre compte Claude - Relancez la revue après la modification
La vérification préalable de la GitHub App a échoué de façon transitoire
Vous avez démarré une session cloud depuis un dépôt local, et deux étapes ont échoué simultanément. Claude Code n’a pas pu créer ou envoyer le bundle de votre dépôt. Avant l’envoi, il a vérifié si le service cloud pouvait 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 bloqué le bundle, par exempleCould not upload repo bundle (<error>), et se termine par la phrase de vérification préalable :
- 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 de l’envoi ne bloque plus le lancement
- Si les nouvelles tentatives continuent d’échouer, le début du message indique ce qui a bloqué l’envoi. Lorsque vous pouvez corriger cette cause, corrigez-la afin que la session puisse plutôt démarrer depuis votre dépôt local
Please set up GitHub on https://claude.ai/code même lorsque la vérification GitHub n’avait échoué que de façon transitoire, et un conseil de configuration ne peut pas résoudre un échec transitoire.
L’envoi du dépôt ne peut pas suivre un paramètre git
Vous avez démarré une session cloud qui envoie votre dépôt local, ou une ultrareview d’une branche, et l’envoi ne peut pas suivre l’un des paramètres git qui déterminent quelles règles d’attributs s’appliquent à vos fichiers. Si l’envoi avait lieu en ignorant 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 l’envoi, et rien n’est envoyé :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 :
/schedule, le même message apparaît sous forme de note de configuration qui nomme le dépôt ; cette note n’empêche pas la création de la routine.
Que faire :
- Exécutez
/web-setuppour connecter votre login 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
Une stratégie de votre organisation GitHub bloque Claude
Vous avez exécuté à l’invite de Claude Code une commande qui démarre une session cloud, comme/autofix-pr. Avant de créer la session, Claude Code vérifie l’accès de Claude au dépôt sur GitHub, et GitHub a refusé parce que votre organisation GitHub applique une stratégie qui bloque Claude. Claude Code s’arrête à ce stade et affiche un message qui nomme la stratégie.
Lorsque c’est une liste d’adresses IP autorisées qui bloque l’accès, le message est le suivant :
- Liste d’adresses IP autorisées : demandez à un propriétaire de votre organisation ou entreprise GitHub d’autoriser les adresses IP sortantes d’Anthropic. Consultez Listes d’autorisation et pare-feu GitHub pour connaître les adresses et les paramètres GitHub à modifier.
- Authentification unique : déconnectez GitHub sur claude.ai/customize/connectors, puis reconnectez-le. Lorsque GitHub le demande, cliquez sur Authorize à côté de votre organisation afin que la nouvelle connexion soit autorisée pour son authentification unique.
- Stratégie d’accès conditionnel : demandez à votre administrateur GitHub Enterprise ou Microsoft Entra ID d’autoriser Claude dans cette stratégie
- Après la modification, exécutez à nouveau la commande
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 CLI GitHub, 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 :
- Réautorisez votre connexion à la CLI GitHub avec les scopes
repoetworkflowen exécutantgh auth refresh -h github.com -s repo,workflow, puis autorisez l’organisation lorsque GitHub vous invite à utiliser 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
Admin permissions required dans ce cas.
É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électeurclaude --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 :
/resume dans 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 indiqué dans le message pour réessayer - Sur une version antérieure à la v2.1.285, si la nouvelle tentative échoue de la même manière, exécutez
claude updateet reprenez à nouveau. 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
claudepour 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 correspond :
- ID mal saisi : pour une exécution non interactive, l’ID correspond au champ
session_idde 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/projectsde sorte que deux transcriptions portent le même ID, Claude Code affiche ce message plutôt que de reprendre arbitrairement l’une des copies
- Pour une session interactive, ouvrez le sélecteur de session avec
claude --resumeet appuyez surCtrl+Apour l’étendre à tous les projets de cette machine, puis sélectionnez la session - Les sessions créées avec
claude -pou l’Agent SDK n’apparaissent pas dans le sélecteur ; vérifiez donc à nouveau l’ID par rapport ausession_idaffiché par votre exécution initiale
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 :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 dans une session, votre session actuelle continue de s’exécuter.
Que faire :
- Excluez le dossier qui contient 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é parCLAUDE_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
claude --resume <session-id> se terminait par Failed to resume session <session-id>, et une exécution -p affichait uniquement le texte de l’erreur système, par exemple 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 de rendu et n’enregistre rien. Le message affiché vous indique la cause :
Cannot switch renderers while work is running in the background: des tâches en arrière-plan, comme un shell en arrière-plan ou un sous-agent, sont en cours d’exécution et seraient abandonnées par un redémarrage. Attendez la fin de ces tâches ou arrêtez-les avec/tasks, puis exécutez à nouveau/tui fullscreenou/tui defaultCannot 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 quand même et la session relancée s’exécutait sans elles
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-sourceset--permission-prompt-toolpermission rules set for this session only: une mise à jour des permissions provenant d’un hook ou d’un appelant SDK a ajouté des règles deny ou ask avec la destinationsession. Les règles allow limitées à la session ne déclenchent pas le refus. Un redémarrage les supprime, et Claude Code vous demande à nouveau à la placeask-before-running rules with no command-line form: une mise à jour des permissions provenant d’un hook ou d’un appelant SDK a ajouté des règles ask en plus des règles que Claude Code retransmet sous forme de--allowed-toolset--disallowed-tools. Aucun flag n’existe pour les règles askpermission rules a command line cannot carry intactetadded directories a command line cannot carry intact: une mise à jour des 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 transmettre son texte sous la même valeur
- Dans une session démarrée sans ces restrictions, exécutez
/tui fullscreen, ou/tui defaultpour revenir en arrière. Claude Code y enregistre le paramètretui
Claude Code couldn’t restart
Lorsque ce message indique que votre conversation est enregistrée, la conversation est sur le disque et vous pouvez la reprendre là où elle s’est arrêtée. Claude Code était en train de redémarrer, par exemple pour activer ou désactiver le rendu plein écran après que vous avez exécuté/tui, et n’a pas pu démarrer le nouveau processus ; il s’est donc terminé avec le statut 1 :
/tui était votre première saisie dans une nouvelle session, le message est Claude Code couldn't restart. Start Claude Code again.
Que faire :
- Exécutez à nouveau
claudedans votre shell. Si le message indiquait que votre conversation est enregistrée, exécutez/resumedans la nouvelle session et sélectionnez la conversation. Si elle ne figure pas dans la liste, étendez le sélecteur de session - Si les redémarrages continuent d’échouer, démarrez Claude Code depuis votre shell avec
claude --debug-file claude-debug.log. Si un redémarrage depuis cette session échoue, le fichierclaude-debug.logsitué dans le répertoire de démarrage consigne une ligneFailed to relaunch:contenant l’erreur du système d’exploitation. Incluez cette ligne lorsque vous signalez le problème
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. Sur macOS, cette commande est open, comme dans cet exemple ; sur Windows, il s’agit de rundll32 :
- Ouvrez vous-même Claude Desktop, puis exécutez à nouveau
/desktopouclaude --desktop - Pour lire la sortie d’erreur complète de la commande ayant échoué, activez les logs de débogage avec
/debuget exécutez à nouveau/desktop, ou exécutezclaude --desktop --debug-file <path>, puis consultez le log de débogage
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 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 fichierYour 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 finalesCouldn'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 avec une clé dupliquée peut en être la cause
- 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
/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 le 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 à la place par ce message :
- Exécutez
/skill-doctordans le terminal de la machine sur laquelle la session s’exécute, ou exécutez-yclaude -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 propriétaire du compte, Claude Code ne liste et ne sélectionne que les styles intégrés pour ce tour, et ajoute cet avis chaque fois que la commande liste les styles ou ne reconnaît pas le nom que vous avez indiqué. Le nom d’un style personnalisé reçoit la même réponse qu’un nom qui n’existe pas :
- Choisissez un style intégré, par exemple
/output-style concise - Pour utiliser un style personnalisé, définissez
outputStyledans le fichier.claude/settings.local.jsondu 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 tenté 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 :
- Ajoutez
localaux sources de paramètres de la session et changez à nouveau de style - Définissez la clé
outputStyledans un fichier de paramètres que la session charge, comme.claude/settings.jsondans le projet ou~/.claude/settings.json. Dans le SDK TypeScript, définissez plutôtoutputStyledans l’objetsettingsinline ; consultez Activer un style de sortie
/recap ne s’exécute que lorsque vous le demandez vous-même
La demande/recap ne provient pas de votre propre saisie. Elle est arrivée dans un message relayé dans la session depuis un fil Slack, Teams ou de projet, ou dans un prompt envoyé par une routine ou un autre programme.
Un message relayé reçoit cet avis même si vous l’avez écrit vous-même. Claude Code ne peut pas déterminer qu’un message relayé ou automatisé provient de la personne dont le compte exécute la session ; il répond donc par cet avis au lieu d’un résumé :
/recap que vous transmettez à claude -p, ou que votre propre application Agent SDK envoie à une session qu’elle a lancée, compte comme votre propre saisie.
Que faire :
- Ouvrez vous-même la session et exécutez-y
/recap: dans son terminal, dans l’application Desktop ou l’application mobile, sur claude.ai/code, ou via Remote Control - Si une routine ou un autre programme l’a envoyé, supprimez
/recapde ce prompt
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 :
- Exécutez
claude --version, puisclaude 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 GitHubanthropics. 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.
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 officielgithub.com/anthropics - Si vous publiez une marketplace tierce qui utilisait le nom avant qu’il ne soit réservé, renommez-la et demandez aux utilisateurs de la rajouter à partir de votre source
- Consultez la liste des noms réservés sous 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 :/plugin, claude plugin install, et claude plugin update avertissent :
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 removequ’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 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 :
- Pour conserver une marketplace qu’un fichier de paramètres déclare en ligne avec
"source": "settings", renommez-la avant de supprimer l’ancien nom, car supprimer la marketplace supprime aussi son entrée de vos fichiers de paramètres. Claude Code v2.1.292 ou ultérieur énumère ces étapes dans le message :- Dans chaque fichier de paramètres qui liste la marketplace sous
extraKnownMarketplaces, donnez à la clé de l’entrée et à sonsource.nameun même nouveau nom en ASCII simple qui ne ressemble pas à un nom officiel. Si un administrateur ajoute la marketplace via les paramètres gérés de votre organisation, c’est l’administrateur qui effectue cette étape - Exécutez
claude plugin marketplace remove <old-name>, ou supprimez l’ancien nom dans l’onglet Marketplaces de/plugin. Cela désinstalle aussi ses plugins et supprime leurs données, options et secrets - Redémarrez Claude Code, dans le dossier du projet si le fichier est un fichier de paramètres de projet. Installez ensuite les plugins à partir de la marketplace renommée
- Dans chaque fichier de paramètres qui liste la marketplace sous
- Pour conserver toute autre marketplace, attendez que son responsable la renomme, puis exécutez
claude plugin marketplace update <name> - Pour supprimer la marketplace, exécutez
claude plugin marketplace remove <name>. Cela désinstalle aussi les plugins installés à partir de la marketplace et supprime leurs données, options et secrets - 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 indiqué une nouvelle source de marketplace avec--marketplace <source> sur la commande d’installation, dans une session ou depuis votre shell. Le catalogue que Claude Code a récupéré à partir de cette source porte le même nom 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é.
- 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 MCPheadersHelper 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 :
headersHelper rapporte :
- Pour un hook, ajoutez un tableau
argspour 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 champheadersdu 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 sourcearchive 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é
- Si vous publiez le plugin, recalculez le digest du fichier exact que l’URL sert, par exemple avec
shasum -a 256 my-plugin.zip, ouGet-FileHash -Algorithm SHA256 my-plugin.zipdans PowerShell, et mettez à jour lesha256dans 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 leplugin.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.
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 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 fichiermonitors/monitors.json, ou unSKILL.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
/plugin, l’erreur apparaît sous le plugin et nomme le chemin et le code que le système d’exploitation a retourné :
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 boucleEIOouESTALE: le chemin est sur un montage réseau qui est cassé ou obsolèteEACCES: l’un des répertoires au-dessus du chemin vous refuse la permission de le traverser
- 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-pluginsaprès avoir corrigé le chemin, ou redémarrez Claude Code, pour charger le plugin ou le composant
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 :
claude plugin list affiche le plugin comme failed to load avec :
- Si vous maintenez la marketplace, écrivez la
sourcede 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.
claude plugin install rapporte :
claude plugin install ne rapportait pas cet échec.
Que faire :
- Ouvrez
~/.claude/plugins/known_marketplaces.jsonet 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 avecclaude plugin marketplace add <source>. Claude Code réenregistre les marketplaces que vos paramètres utilisateur ou gérés déclarent dansextraKnownMarketplacesla 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 :
- 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é.
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.claudequi 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
enabledPluginsdans ce fichier vous-même, puis exécutez la désinstallation à nouveau
Erreurs d’outils
Ces erreurs proviennent des appels d’outils 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.No such tool available
Claude a appelé un outil par un nom qui ne figure pas dans la liste d’outils de la session. Claude Code renvoie l’erreur à Claude comme résultat de l’appel d’outil, et le tour continue. Quand Claude Code peut déterminer pourquoi l’outil est manquant, il ajoute après le nom de l’outil une phrase qui donne la raison ou nomme l’outil à appeler à la place, comme dans la deuxième ligne :- Si cela se produit une seule fois, vous n’avez rien à faire. Claude lit l’erreur et le tour continue.
- Si les appels aux outils d’un serveur MCP continuent d’échouer avec cette erreur, exécutez
/mcpdans la session ouclaude mcp listdans votre shell pour vérifier le statut du serveur, et reconnectez un serveur en échec depuis/mcp. Dans l’Agent SDK, consultez Gestion des erreurs.
Agent would be spawned with zero tools
Chaque entrée de la listetools 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
GrpepourGrep. - 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é, ouAgentpour un sous-agent à la limite de profondeur.
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.
- 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
toolsau lieu de lister les outils pour donner au sous-agent chaque outil disponible pour les sous-agents - Pour une liste
toolsqui contient uniquementAgent, augmentez la limite de profondeur ou donnez à l’agent au moins un autre outil : Claude Code retientAgentà 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 refusRead, 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.
and cannot be written à la place.
Que faire :
- Si Claude doit pouvoir modifier le fichier, supprimez ou réduisez la règle de refus
Readdans/permissionsou dans les paramètres - Si le fichier doit rester inchangé, conservez la règle et ajoutez une règle de refus
Editpour 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 :- 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
Path contains null bytes, et l’outil ne s’exécutait jamais.
subagent_type is required
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=1est 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 exclutgeneral-purpose
- 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’autorisationtools: Agent(...), ou supprimezCLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS
Agent type 'general-purpose' not found.
Memory index is over its read limit
Claude a écrit dans l’index de mémoire automatiqueMEMORY.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.
- 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 commandepkill 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.
- 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 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éussisseThe 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’outilThe 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
@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/teamset 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é. L’avis suit le rapport de reprise dans le résultat de l’outil de l’agent d’envoi et nomme la raison. Quand le fichier de définition provenait d’un dossier sans confiance enregistrée, il se lit :.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
claudedans 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àtruedans~/.claude.json, en utilisant la clé exacteprojects["<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 :- 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
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 :- 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
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 le destinataire et, quand le destinataire a donné une raison, ajoute la raison après un tiret :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 permetyou 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éditeurit repeated your previous message: le message était identique à celui que la session d’envoi a envoyé à ce destinataire peu de temps avanta 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
- 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 prompt commence une nouvelle chaîne
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 l’endpoint 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 :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 endpoint 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.
- Généralement rien : les vérifications empêchent un message d’atteindre un endpoint autre que la session à laquelle il a été adressé, et rien n’a été envoyé
- Si
reply target is a symlinkse répète pour une session, vérifiez ce qui a créé un lien à ce chemin de socket de session, montré dans son/statussousPeer 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 :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 boucleit is a symbolic link. Write to the link's target path instead: un lien symbolique se trouve à l’emplacement d’écriture demandé lui-même, par exemple unCLAUDE.mdqui est un lien symbolique versAGENTS.md; le message dirige Claude vers la cible du lienRefusing 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.jsonsymlinké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 emplacementa path one of its Read deny rules is written through changed while the search was being prepared. Retry.: une règle de refusReadpour la recherche nomme un chemin qui passe par un lien symbolique, et ce lien a changé pendant que Claude Code préparait la rechercheit 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’exploitationits 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îcheripgrep 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 binairergà 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
- 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 build 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 le prompt, mettez à niveau vers la v2.1.273 ou ultérieure
- Pour le refus ripgrep, installez ripgrep avec votre gestionnaire de paquets pour que
rgse résout à un chemin absolu surPATH, ou gardez les recherches sous le répertoire de travail
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 :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 :
- 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_TMPDIRdé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-projectdans 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_TMPDIRsur 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 ... (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 libreThe 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 libreCommand output was lost: the temp filesystem at ... is fullou... is out of inodes: le système de fichiers a presque pas d’espace libre, ou manque d’inodes
- 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. Pourout 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_TMPDIRdé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
File is not valid UTF-8
Claude a utilisé l’outil Edit ou NotebookEdit sur un fichier dont les octets ne se décodent pas en UTF-8, et Claude Code a refusé la modification. Rien n’a été écrit, donc le fichier est resté tel quel. Ces outils enregistrent l’intégralité du fichier en UTF-8, ce qui aurait transformé chaque octet qu’ils ne pouvaient pas décoder en caractère de remplacementU+FFFD. Le message apparaît dans le résultat de l’outil :
- Pour conserver le fichier dans son encodage actuel, laissez Claude effectuer la modification avec une commande shell qui lit et écrit le fichier dans cet encodage, comme le message le lui indique
- Pour continuer à modifier le fichier avec l’outil Edit, convertissez-le en UTF-8, ou corrigez les octets invalides dans un fichier censé être en UTF-8, puis demandez à Claude d’effectuer à nouveau la modification
U+FFFD. Sur ces versions, mettez à jour Claude Code.
The source file is not valid UTF-8 text
Claude a essayé de publier un artefact à 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 remplacementU+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 :
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+FFFDpar le caractère qu’une édition, un collage, ou une conversion antérieure a perdu - Pour afficher un
U+FFFDintentionnel sur la page, écrivez-le comme�dans le HTML au lieu du caractère littéral
Not published: that file is on a network share
Claude a essayé de publier un artefact à partir d’un fichier situé à un chemin qui nomme un hôte réseau :- Sur Windows, un chemin
\\server\sharequi ne se trouve pas sous un lecteur réseau mappé que vous avez passé au lancement avec--add-dir - Sur macOS ou Linux, un chemin de montage automatique tel que
/net/<host>/page.html
- Rien, si vous n’avez pas besoin de ce fichier précis : le message indique à Claude de publier plutôt un fichier provenant des propres dossiers de la session
- Pour publier ce fichier précis, copiez-le dans un dossier sur un disque local et demandez à nouveau
- Sur Windows, pour permettre à Claude de publier directement depuis le partage, mappez-le à une lettre de lecteur et passez le lecteur au démarrage de Claude Code. Dans PowerShell, par exemple, exécutez
net use Z: \\server\sharepuisclaude --add-dir Z:\. Claude peut alors publier des fichiers depuis ce lecteur. Ajouter le lecteur en cours de session avec/add-dirne suffit pas. - Sur macOS ou Linux, montez le partage dans un répertoire tel qu’un sous-répertoire de
/mntou/Volumes, et publiez depuis ce chemin au lieu du chemin de montage automatique
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 artefact. 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 :- 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’artefact, 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, commehttp://localhost:3000 ou un nom intranet nu comme http://wiki/. WebFetch refuse ces URL avant d’effectuer une requête :
- Généralement rien : le message pointe Claude vers
curlà travers l’outil Bash, qui peut atteindre les serveurs locaux et intranet
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 :
rate-limited: l’endpoint de vérification a répondu avec HTTP429. 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 rencontrent souvent ce cas, vous pouvez ignorer la vérification avecskipWebFetchPreflight: truedans les paramètres.Unable to verify: la requête de vérification a échoué, a expiré, ou a obtenu un autre statut d’erreur. Si votre réseau bloqueapi.anthropic.com, ajoutez ce domaine à la liste d’autorisation, ou ignorez la vérification avecskipWebFetchPreflight: truedans les paramètres.
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 soumise à la limite de 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 :
- 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 :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 avecCtrl+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 quedocs/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 :
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, PowerShell ou Monitor dans une session isolée dans un worktree, et Claude Code l’a refusée pour l’une de ces raisons :- La commande s’exécuterait dans le checkout principal ou dans un autre worktree. Le message indique que son répertoire de travail
resolved to the shared checkoutouis in a different worktree. - Une commande Bash ou Monitor pointe git vers le checkout principal.
- Claude Code ne peut pas vérifier à partir du texte d’une commande Bash ou Monitor 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.
is isolated in the worktree <path>, but this command, suivi de la raison, par exemple une commande dont Claude Code n’a pas pu vérifier le texte :
- Git pointé vers le checkout principal, ou texte de commande impossible à vérifier : 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 à cause d’une expansion dans son texte, orthographiez la valeur signalée littéralement 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 que vous avez mise en arrière-plan avec← ou /background et qui s’est arrêtée avant d’exécuter un tour qui lui soit propre. Claude Code n’a pas pu trouver la conversation à partir de laquelle vous l’avez déplacée, de sorte que la session n’a rien à reprendre. Le message se termine par la commande claude respawn pour cette session :
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.
Ce qu’il faut faire :
- Pour démarrer la session arrêtée à partir de zéro, exécutez
claude respawn <id>avec l’ID du message, ou appuyez deux fois surEntréesur 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/projectspourrait 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 :running in another terminal: un terminal détient la conversation, par exemple celui où vous l’avez reprise avecclaude --resumeou/resume. La ligne affiche égalementOpen 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é.
- Continuez la conversation dans le processus qui la détient, ou quittez ce processus et ouvrez la ligne à nouveau
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 :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 rmconserve 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>
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 :
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-unpushedque le message a imprimée, ou appuyez deux fois surCtrl+Xsur 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
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 :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 :
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éesur 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 imprimeSession <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
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 :claude attach <id> imprime la cause et quitte :
- Dans la vue agent, appuyez sur
Entréesur 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>, puisclaude attach <id> - Pour une ligne de commande shell, appuyez sur
Ctrl+Xdans la vue agent ou exécutezclaude 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 exempleclaude stop dans un autre terminal. Claude Code garde la session arrêtée :
- 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 :
/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>.mddans le projet de la session, ou à~/.claude/agents/<name>.mdpour 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
Cette session a redémarré après l’échéance de son prochain réveil /loop
Une boucle/loop à rythme autonome dans une session en arrière-plan s’est arrêtée. Le processus de la session s’est terminé pendant que la boucle attendait son prochain réveil, et ce réveil est arrivé à échéance avant le démarrage du processus suivant de la session. Le réveil manqué ne se déclenche pas en retard. La notification indique le retard du réveil au moment où la session a redémarré :
- Pour continuer la boucle, répondez à la session en le précisant, par exemple
keep the loop running. Claude lit la notification avec votre réponse et peut planifier le prochain réveil - Si vous en avez terminé avec la boucle, ne faites rien. Elle s’est déjà arrêtée
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 :
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écutezclaude daemon statusà partir d’un shell - Après avoir corrigé la valeur dans le bloc
envdes paramètres, redémarrez le service en arrière-plan avecclaude daemon stop --anyde 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 commeEUNKNOWN. 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 :
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écuterclaude daemon rundans 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 quenpm 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 :
/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 :
- 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 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 stderravec le code de sortie 1, à chaque démarrage, sur Windows :daemon.locknomme 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.
- 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 statuspour 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 :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 :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.
- Exécutez
claudedans 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 processusclaude 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.
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
claudedans 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 doctordans 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écutableclaude installé sur PATH. L’extension refuse de lancer Claude Code jusqu’à ce qu’elle trouve le claude installé sur PATH.
- 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 processusclaude, 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 :
- Envoyez le message à nouveau. Le message suivant démarre un nouveau processus
claudequi reprend la conversation. - Si cela se répète, exécutez
claudedans 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é
/rewind écrivait et supprimait à travers les liens aux chemins suivis, et ne signalait pas une restauration partielle.
- 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>.txtnomme chaque chemin ignoré lors de l’exécution de la restauration, donc activez la journalisation de débogage avec/debugavant votre prochain rembobinage. Sur macOS ou Linux, vous pouvez plutôt trouver les liens directement :find . -type lpour les liens symboliques etfind . -type f -links +1pour 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.
/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.
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 :- À 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
--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 pourEDQUOT; restaurez l’accès en écriture à l’emplacement de la transcription pourEACCES,EPERM, ouEROFS - 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é avecCLAUDE_CODE_SKIP_PROMPT_HISTORY défini, donc Claude Code n’écrit aucune transcription ou historique d’invite pour celle-ci :
- 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éfinitCLAUDE_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 :
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=1dé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_SESSIONde 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 :- Redémarrez Claude Code. Pour reprendre la conversation, exécutez
claude --resumedans 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.
Les descriptions d’agent dépassent la limite de 15 000 tokens
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 tokens selon l’estimation de Claude Code. Chaque agent compte son nom plus son frontmatterdescription. Claude Code charge chaque agent, que le total dépasse ou non la limite, donc l’avertissement ne change pas ce qui se charge.
- Raccourcissez le frontmatter
descriptionde vos fichiers d’agent, ou demandez à Claude de les raccourcir pour vous. - Supprimez les fichiers d’agent que vous n’utilisez plus.
Le hook a besoin de guillemets autour d’un chemin contenant un espace
Cette notification dans la vue de conversation signifie que le script d’un hook ne s’est pas exécuté parce que son chemin contient un espace et n’est pas entre guillemets. Ce hook est un hookasyncRewake sous forme shell. Dans sa command, un interpréteur tel que python3 est suivi d’un espace réservé de chemin sans guillemets, et le chemin résolu contient un espace.
La notification commence par le nom de l’événement du hook et nomme le script :
- Dans la
commanddu hook qui exécute le script que la notification nomme, entourez le chemin de guillemets doubles. Dans un fichier JSON, écrivez-le sous la forme"command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/check.py\"".
Un skill, une commande ou un workflow n’a pas été chargé parce que son nom est réservé
Un dossier de skill, un frontmattername, un fichier ou un sous-dossier dans .claude/commands/, ou un workflow enregistré utilise le nom anthropic-skills ou un nom qui commence par anthropic-skills:. Claude Code réserve ce nom pour les skills synchronisés 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 :
name: à modifier, ou un workflow à 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.
Nom de skill ou de commande refusé
Cet avis de démarrage signifie que Claude Code a refusé le nom d’au moins un skill ou d’une commande personnalisée, qui n’a donc pas été chargé ou a été chargé sans son champname :
- Non chargé : Claude Code a refusé le nom sous lequel un skill ou une commande est connu, comme le nom de son répertoire ou le nom ou le sous-dossier d’un fichier de commande. Il est absent du menu
/et Claude ne peut pas l’invoquer. Sa ligne dans le journal de débogage indique<name> is not offered. - Champ
nameignoré : Claude Code a refusé lenamedu frontmatter d’un skill. Le skill se charge quand même, mais le menu/n’affiche pas la valeurnameet la saisir n’invoque pas le skill. Sa ligne dans le journal de débogage indique<name value> is not shown for <skill>.
- Démarrez Claude Code avec
claude --debugdepuis votre shell et recherchez[names]dans le journal de débogage. Chaque nom que l’avis compte y a une ligne. La ligne écrit certains caractères cachés sous forme de codes, comme\u{200B}pour une espace de largeur nulle, afin que vous puissiez voir où ils se trouvent. - Supprimez les caractères qu’un nom de skill ne peut pas contenir en renommant le dossier ou le fichier ou en modifiant la ligne
name:, ou raccourcissez un nom de plus de 256 caractères. Redémarrez ensuite la session, sauf si le fichier se trouve dans un répertoire que Claude Code surveille pour détecter les modifications. Pour un skill provenant d’un plugin que vous n’avez pas écrit, demandez à l’auteur du plugin de le renommer.
L’espace de travail n’a pas été approuvé
Claude Code a trouvé des règlespermissions.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.
- Exécutez
claudedans 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éehasTrustDialogAccepteddans~/.claude.jsonen utilisant la cléprojectsexacte que le message imprime. - Si le message nomme
.claude/settings.local.jsonet 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.jsoncomme 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.
- 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 lectures sous ce montage automatique passent toujours par la vérification des chemins réseau. - Les chemins locaux qui atteignent un emplacement réseau via un lien symbolique ou une jonction
\\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 avecclaude --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.
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 exemplenetwork 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.
- 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
/statusouclaude doctorpour le diagnostic complet
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 :- 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 listedeniedModels le bloque, le message lit :
availableModels avec availableModelsMatch défini à "exact" l’omet, le message lit :
- Si vous administrez les paramètres, ajoutez un modèle que vos utilisateurs peuvent exécuter à
availableModels, ou réduisez les entréesdeniedModelsqui bloquent chaque modèle de 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
availableModelsoudeniedModelsgé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 listeallowedProviders, et le fournisseur d’API de la session n’est pas sur la liste ou la session utilise un endpoint 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 :
(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éeallowedProvidersindique quel blocenvde 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 :
- Une entrée
deniedMcpServersqui correspond au serveur, y compris une dans votre propre~/.claude/settings.jsonou le.claude/settings.jsondu projet - Une liste
allowedMcpServersà laquelle le serveur ne correspond pas strictPluginOnlyCustomizationavecmcpverrouillé, qui bloque les serveurs configurés dans~/.claude.jsonet.mcp.jsondisableClaudeAiConnectors, quand le serveur est un connecteur claude.ai
- 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
/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 :- Le chemin du fichier
managed-settings.jsonou un fichier drop-in sousmanaged-settings.d - Le profil des préférences gérées macOS,
per-user managed preferencesoudevice-level managed preferences - La valeur du registre Windows,
Registry: HKLM\SOFTWARE\Policies\ClaudeCode\Settings
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 dans ce cas.
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 indique quand un échec de lecture provoque la fermeture 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.jsonvide compte comme{}et ne bloque pas le lancement. - Si ce n’est pas le cas, 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’administration 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 :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 réservé à root, ne produit pas cette fermeture : 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 ce n’est pas le cas, envoyez le message à votre administrateur. Rien dans vos propres fichiers de paramètres ne cause ou n’efface cette erreur
otelHeadersHelper a échoué
Claude Code affiche cet avertissement comme une notification dans l’interface du terminal, une fois par session interactive, quand le scriptotelHeadersHelper é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 :
- Exécutez
/statuspour 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.
-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 sesheaders 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.
projects que le message imprime est le dossier sur lequel, selon Règles d’autorisation du projet et approbation de l’espace de travail, Claude Code indexe l’approbation. 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
claudedans le dossier que le message nomme, acceptez la boîte de dialogue d’approbation, puis exécutez à nouveau votre commande-pou SDK - Définissez vous-même l’entrée
hasTrustDialogAccepteddans~/.claude.json, en utilisant la cléprojectsexacte 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 formeTool 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 :
- 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 deBash(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
Mismatched parentheses.
N’est pas mis en correspondance par les vérifications de permission de fichier
Claude Code a trouvé une règle de permissionWrite, NotebookEdit, MultiEdit, ou Glob avec un chemin dans l’un de vos fichiers de paramètres, dans les paramètres gérés, ou dans une valeur de flag --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 :
- Remplacez les règles
Write(path),NotebookEdit(path), etMultiEdit(path)héritées parEdit(path). Les règlesEditcouvrent tous les outils d’édition de fichiers. - Sauf dans
--allowedTools, où Claude Code accepte une règleGlobsans avertissement, remplacez les règlesGlob(path)parRead(path). - Corrigez la règle à la source que l’avertissement nomme entre parenthèses : un chemin de fichier de paramètres, ou le flag lui-même pour
--allowed-toolset--disallowed-tools. Un cheminclaude-settings-<hash>.jsonqui n’existe pas sur le disque représente une valeur--settingsen ligne. Corrigez le JSON que vous passez à ce flag. - Laissez telles quelles les règles composées du seul nom d’outil, comme
WriteouGlob. Claude Code les met en correspondance au niveau de l’outil et n’émet pas d’avertissement à leur sujet. - 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.
--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’autorisationBash 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 flag --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 :
- Remplacez le
*avant la sous-commande par la valeur exacte que vous entendez :Bash(git checkout main)à la place deBash(git * main). - Déplacez chaque
*après la sous-commande :Bash(git status *)à la place deBash(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 flag
--allowed-toolslui-même. Un cheminclaude-settings-<hash>.jsonqui n’existe pas sur le disque représente une valeur--settingsen ligne. Corrigez le JSON que vous passez à ce flag. - 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.
--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.
Refuser Bash désactive aussi l’outil PowerShell
Vous avez supprimé l’outil Bash entier, par exemple avec--disallowedTools Bash ou avec une règle de refus Bash ou Bash(*) seule dans l’un de vos fichiers de paramètres. Sur Windows avec Git Bash installé, refuser Bash désactive aussi l’outil PowerShell, donc la session démarre sans aucun outil shell. Claude Code imprime cet avertissement au démarrage :
- Pour que Claude utilise PowerShell, définissez
CLAUDE_CODE_USE_POWERSHELL_TOOLà1dans votre environnement ou dans le blocenvd’un fichier de paramètres, comme le montre Activer l’outil PowerShell. L’outil PowerShell reste alors activé à côté de votre règle de refus Bash. - Pour bloquer des commandes particulières plutôt que l’outil entier, remplacez l’entrée
Bashseule par des règles ciblées telles queBash(git push *)dans le même fichier de paramètres ou le même flag. Claude conserve l’outil Bash, et l’outil PowerShell reste désactivé jusqu’à ce que vous définissiez aussi la variable ou ajoutiez une règle de permissionPowerShellciblée.
--output-format json ou stream-json, Claude Code écrit l’avertissement au journal de débogage au lieu de stderr. Exécutez avec --debug pour le capturer à ~/.claude/debug/<session-id>.txt. Avant la v2.1.287, Claude Code désactivait l’outil PowerShell de la même façon sans imprimer d’avertissement.
crossSessionInbound doit être l’un de accept, hold, refuse
Un fichier de paramètres définitcrossSessionInbound à 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 :
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
ANTHROPIC_FOUNDRY_RESOURCE doit être un nom de ressource Foundry
Vous avez définiANTHROPIC_FOUNDRY_RESOURCE sur autre chose qu’un simple nom de ressource Microsoft Foundry, par exemple l’URL de l’endpoint ou son nom d’hôte. Claude Code a refusé la valeur avant d’envoyer une requête. Le message apparaît à la place de la réponse de Claude, et non comme un avertissement de démarrage :
- Définissez
ANTHROPIC_FOUNDRY_RESOURCEsur le seul nom de la ressource et redémarrez Claude Code. Pour l’endpointhttps://my-resource.services.ai.azure.com/anthropic, le nom estmy-resource. - Pour fournir plutôt l’URL complète de l’endpoint, définissez
ANTHROPIC_FOUNDRY_BASE_URLsur l’URL et supprimezANTHROPIC_FOUNDRY_RESOURCE, puis redémarrez Claude Code. Claude Code n’accepte qu’une seule des deux variables.
La limite de 200K n’est pas appliquée
Vous avez définiCLAUDE_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 à 200K ou moins, donc la conversation peut la dépasser.
- 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=1ou augmenté la fenêtre supposée au-delà de 200K avecCLAUDE_CODE_MAX_CONTEXT_TOKENS. Dans ce cas, le message offre égalementor update to a Claude Code version that recognizes <model>comme un remède. - Une bêta
context-1mdemandée viaANTHROPIC_BETASou le flag--betasdemande toujours à l’API la fenêtre 1M sur un modèle qui accepte cette bêta, tandis que rien ne compacte la session à 200K
- Définissez
CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000, ou le paramètreautoCompactWindowà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, supprimez
CLAUDE_CODE_DISABLE_1M_CONTEXT; l’avertissement signale uniquement que la limite de 200K n’est pas appliquée
--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éemodelOverrides 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 ni ne change de modèle.
[claude-code:unrecognized_model]. Après le préfixe et un espace, Claude Code écrit un objet JSON d’une ligne. Claude Code peut y ajouter des champs 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éequery_source: le chemin de requête qui a utilisé le modèle. Claude Code signalesdkpour une exécution-pet une valeur qui commence paragent:pour un sous-agent.
- 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
--debugpour la capturer à~/.claude/debug/<session-id>.txt
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 ARN mal saisi.
À 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 queopus. Pourmy-proxy-modelde la ligne d’exemple, ajoutez cette entrée :Claude Code traite alorsmy-proxy-modelcommeclaude-opus-4-6et 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 celui des endroits où vous pouvez définir un modèle ou des variables d’alias qui le contient. Si
query_sourcecommence paragent:, corrigez-le plutôt là où vous définissez le modèle du sous-agent.
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 à cet endroit un espace réservé de 0 octet en lecture seule, et le supprime ensuite. Une session tuée avant que ce nettoyage s’exécute, par exemple par SIGKILL, laisse les espaces réservés derrière elle. Les sessions ultérieures les lient à nouveau en lecture seule à chaque démarrage, donc une écriture de paramètres telle que l’enregistrement de « Oui, et ne me le demande plus » échoue là où l’un d’eux se trouve.
- 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écutezclaude doctoraprè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 active 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 été conservé, enregistrez-le à nouveau après la suppression de l’espace réservé
claude doctor ne signalait pas ces fichiers ; les versions antérieures laissent les mêmes espaces réservés derrière elles 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-modelconfiguré prend le relais après une erreur de disponibilité, pour ce tour uniquement, avec un avis dans la transcription - Une vérification de démarrage d’Amazon Bedrock ou de la plateforme Agent de Google Cloud détecte que votre modèle par défaut n’est pas disponible, 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
/model. La configuration du modèle explique quand chaque basculement s’applique.
Vérifiez d’abord ceci :
- Sélection du modèle : exécutez
/modelpour confirmer que vous êtes sur le modèle attendu. Un choix/modelprécédent ou une variable d’environnementANTHROPIC_MODELpeut vous placer sur un modèle plus petit que prévu. - Niveau d’effort : exécutez
/effortpour vérifier le niveau de raisonnement actuel et l’augmenter pour le débogage difficile ou le travail de conception. Les valeurs par défaut varient selon le modèle, vérifiez donc avant de supposer que vous êtes en dessous du maximum. Consultez Ajuster le niveau d’effort pour les valeurs par défaut par modèle et le raccourciultrathink. - Pression contextuelle : exécutez
/contextpour voir le remplissage de la fenêtre. S’il est proche de la capacité, exécutez/compactà un point naturel ou/clearpour recommencer. Consultez Explorer la fenêtre contextuelle pour voir comment l’auto-compact affecte les tours précédents. - Instructions obsolètes : les fichiers
CLAUDE.mdvolumineux ou obsolètes et les définitions d’outils MCP consomment du contexte et peuvent orienter les réponses. La vérification/doctorsignale les fichiers mémoire surdimensionnés et les extensions inutilisées, et/contextaffiche l’utilisation des jetons des outils MCP. Avant la v2.1.205,/doctorouvrait un écran de diagnostics qui signalait les fichiers mémoire surdimensionnés et les définitions de sous-agents.
/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
- Exécutez
/feedbackdans Claude Code pour envoyer la transcription et une description à Anthropic. La commande propose également d’ouvrir un problème GitHub prérempli. 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é,/feedbackenregistre une archive locale que vous pouvez envoyer à votre représentant de compte Anthropic à la place. - Exécutez
claude doctordepuis votre shell pour un diagnostic en lecture seule de votre installation, ou exécutez la vérification/doctordans 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