6 6
7> Consultez les messages d'erreur d'exécution de Claude Code avec leur signification et comment les corriger.7> Consultez les messages d'erreur d'exécution de Claude Code avec leur signification et comment les corriger.
8 8
9Cette page répertorie les erreurs d'exécution que Claude Code affiche et comment récupérer de chacune d'elles, ainsi que ce qu'il faut vérifier lorsque les réponses semblent incorrectes sans erreur. Pour les erreurs d'installation telles que `command not found` ou les défaillances TLS lors de la configuration, consultez [Dépannage de l'installation et de la connexion](/fr/troubleshoot-install).9Cette page répertorie les erreurs d'exécution que Claude Code affiche et comment récupérer de chacune d'elles, ainsi que ce qu'il faut vérifier lorsque les réponses semblent incorrectes sans erreur. Pour les erreurs d'installation telles que `command not found` ou les défaillances TLS lors de la configuration, consultez [Dépannage de l'installation et de la connexion](/docs/fr/troubleshoot-install).
10 10
11Ces erreurs et les commandes de récupération s'appliquent sur l'ensemble de l'interface CLI, l'[application Desktop](/fr/desktop) et [Claude Code sur le web](/fr/claude-code-on-the-web), car les trois encapsulent le même CLI Claude Code. Pour les problèmes spécifiques à une surface, consultez la section dépannage sur la page de cette surface.11Ces erreurs et les commandes de récupération s'appliquent sur l'ensemble de l'interface CLI, l'[application Desktop](/docs/fr/desktop) et [Claude Code sur le web](/docs/fr/claude-code-on-the-web), car les trois encapsulent le même CLI Claude Code. Pour les problèmes spécifiques à une surface, consultez la section dépannage sur la page de cette surface.
12 12
13<Note>13<Note>
14 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](https://platform.claude.com/docs/en/api/errors).14 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](https://platform.claude.com/docs/en/api/errors).
97 Tentatives automatiques97 Tentatives automatiques
98</h2>98</h2>
99 99
100Claude Code réessaie les défaillances transitoires avant de vous afficher une erreur. Les erreurs serveur, les réponses surchargées, les délais d'attente des requêtes, les accélérateurs 429 temporaires et les connexions interrompues sont tous réessayés jusqu'à 10 fois avec un backoff exponentiel. {/* min-version: 2.1.198 */}À partir de la v2.1.198, cela couvre les connexions qui se déconnectent au milieu d'une réponse avant que toute sortie visible n'ait été diffusée : Claude Code réédite la requête avec le même backoff et le tour continue au lieu de s'arrêter avec une erreur de connexion. {/* min-version: 2.1.199 */}À partir de la v2.1.199, les accélérateurs 429 temporaires qui ne portent pas les en-têtes de quota de votre plan sont également réessayés lorsque vous êtes connecté avec un abonnement claude.ai ; les versions antérieures les réessayaient uniquement pour les connexions par clé API et Enterprise.100Claude Code réessaie les défaillances transitoires avant de vous afficher une erreur. Les erreurs serveur, les réponses surchargées, les délais d'attente des requêtes, les accélérateurs 429 temporaires et les connexions interrompues sont tous réessayés jusqu'à 10 fois avec un backoff exponentiel. À partir de la v2.1.198, cela couvre les connexions qui se déconnectent au milieu d'une réponse avant que toute sortie visible n'ait été diffusée : Claude Code réédite la requête avec le même backoff et le tour continue au lieu de s'arrêter avec une erreur de connexion. À partir de la v2.1.199, les accélérateurs 429 temporaires qui ne portent pas les en-têtes de quota de votre plan sont également réessayés lorsque vous êtes connecté avec un abonnement claude.ai ; les versions antérieures les réessayaient uniquement pour les connexions par clé API et Enterprise.
101 101
102Certaines classes de défaillances ne sont pas réessayées, car une tentative ne peut pas réussir :102Certaines classes de défaillances ne sont pas réessayées, car une tentative ne peut pas réussir :
103 103
104* {/* min-version: 2.1.199 */}À partir de la v2.1.199, une défaillance de validation de certificat TLS, telle qu'un proxy inspectant TLS, un bundle `NODE_EXTRA_CA_CERTS` manquant ou un certificat expiré, échoue à la première tentative pour que le correctif apparaisse immédiatement au lieu d'après le budget de tentative complet. Consultez [Erreurs de certificat SSL](#ssl-certificate-errors). Les conditions TLS transitoires telles qu'un délai d'attente de poignée de main réessaient toujours.104* À partir de la v2.1.199, une défaillance de validation de certificat TLS, telle qu'un proxy inspectant TLS, un bundle `NODE_EXTRA_CA_CERTS` manquant ou un certificat expiré, échoue à la première tentative pour que le correctif apparaisse immédiatement au lieu d'après le budget de tentative complet. Consultez [Erreurs de certificat SSL](#ssl-certificate-errors). Les conditions TLS transitoires telles qu'un délai d'attente de poignée de main réessaient toujours.
105* {/* min-version: 2.1.199 */}À partir de la v2.1.199, une erreur serveur qui arrive après que Claude a déjà diffusé une sortie visible conserve la réponse partielle et ajoute un [avis de réponse incomplète](#the-response-above-may-be-incomplete) au lieu de réessayer, car réexécuter la requête pourrait exécuter les mêmes appels d'outils deux fois. Les versions antérieures ont rejeté la sortie partielle et ont signalé le tour comme une erreur.105* À partir de la v2.1.199, une erreur serveur qui arrive après que Claude a déjà diffusé une sortie visible conserve la réponse partielle et ajoute un [avis de réponse incomplète](#the-response-above-may-be-incomplete) au lieu de réessayer, car réexécuter la requête pourrait exécuter les mêmes appels d'outils deux fois. Les versions antérieures ont rejeté la sortie partielle et ont signalé le tour comme une erreur.
106* {/* min-version: 2.1.208 */}Une [réponse de streaming Amazon Bedrock avec un type de contenu inattendu](#bedrock-streaming-response-has-an-unexpected-content-type) échoue à la première tentative, car la passerelle ou le proxy réécrivant la réponse réécrirait la tentative de la même manière. Nécessite Claude Code v2.1.208 ou version ultérieure.106* Une [réponse de streaming Amazon Bedrock avec un type de contenu inattendu](#bedrock-streaming-response-has-an-unexpected-content-type) échoue à la première tentative, car la passerelle ou le proxy réécrivant la réponse réécrirait la tentative de la même manière. Nécessite Claude Code v2.1.208 ou version ultérieure.
107 107
108Lors des tentatives, le spinner affiche un compte à rebours `Retrying in Ns · attempt x/y` après une étiquette d'erreur. L'étiquette nomme la raison spécifique de la première tentative pour les défaillances sur lesquelles vous pouvez agir immédiatement : le réseau est en panne, une poignée de main TLS a échoué, ou vous avez atteint une limite de débit. Pour les autres erreurs, elle lit `API error` au début. {/* min-version: 2.1.198 */}À partir de la v2.1.198, elle bascule vers la raison spécifique de la troisième tentative, ou à la tentative finale lorsque `CLAUDE_CODE_MAX_RETRIES` permet moins de trois ; les versions antérieures ne basculent qu'à la tentative finale.108Lors des tentatives, le spinner affiche un compte à rebours `Retrying in Ns · attempt x/y` après une étiquette d'erreur. L'étiquette nomme la raison spécifique de la première tentative pour les défaillances sur lesquelles vous pouvez agir immédiatement : le réseau est en panne, une poignée de main TLS a échoué, ou vous avez atteint une limite de débit. Pour les autres erreurs, elle lit `API error` au début. À partir de la v2.1.198, elle bascule vers la raison spécifique de la troisième tentative, ou à la tentative finale lorsque `CLAUDE_CODE_MAX_RETRIES` permet moins de trois ; les versions antérieures ne basculent qu'à la tentative finale.
109 109
110{/* min-version: 2.1.198 */}À partir de la v2.1.198, l'indice de spinner habituel est supprimé lors des tentatives. Une fois que la raison de l'erreur est révélée, si la défaillance est une surcharge 529, la ligne sous le compte à rebours nomme également où vérifier l'état du service : `status.claude.com` sur l'API Anthropic, ou l'hôte du fournisseur ou de la passerelle nommé dans le message sur d'autres configurations.110À partir de la v2.1.198, l'indice de spinner habituel est supprimé lors des tentatives. Une fois que la raison de l'erreur est révélée, si la défaillance est une surcharge 529, la ligne sous le compte à rebours nomme également où vérifier l'état du service : `status.claude.com` sur l'API Anthropic, ou l'hôte du fournisseur ou de la passerelle nommé dans le message sur d'autres configurations.
111 111
112{/* min-version: 2.1.185 */}Si aucune donnée n'arrive sur le flux de réponse pendant 20 secondes alors qu'une requête est toujours en attente, le spinner affiche `Waiting for API response · will retry in … · check your network` avant que toute tentative n'ait commencé. La requête n'a pas encore échoué : le compte à rebours s'exécute jusqu'au point où Claude Code abandonne la connexion bloquée et réessaie, de sorte que la bannière s'efface d'elle-même une fois que les données reprennent ou que la tentative réussit. À partir de la v2.1.185, le seuil est de 20 secondes ; les versions antérieures affichent la bannière après 10 secondes avec un libellé différent. Si elle réapparaît à chaque tentative, traitez-la comme un [problème réseau](#unable-to-connect-to-api).112Si aucune donnée n'arrive sur le flux de réponse pendant 20 secondes alors qu'une requête est toujours en attente, le spinner affiche `Waiting for API response · will retry in … · check your network` avant que toute tentative n'ait commencé. La requête n'a pas encore échoué : le compte à rebours s'exécute jusqu'au point où Claude Code abandonne la connexion bloquée et réessaie, de sorte que la bannière s'efface d'elle-même une fois que les données reprennent ou que la tentative réussit. À partir de la v2.1.185, le seuil est de 20 secondes ; les versions antérieures affichent la bannière après 10 secondes avec un libellé différent. Si elle réapparaît à chaque tentative, traitez-la comme un [problème réseau](#unable-to-connect-to-api).
113 113
114Lorsque vous voyez l'une des erreurs de cette page, ces tentatives ont déjà été épuisées, sauf si elle appartient à une classe qui n'est pas réessayée, telle qu'une défaillance de validation de certificat. Vous pouvez ajuster le comportement avec ces variables d'environnement :114Lorsque vous voyez l'une des erreurs de cette page, ces tentatives ont déjà été épuisées, sauf si elle appartient à une classe qui n'est pas réessayée, telle qu'une défaillance de validation de certificat. Vous pouvez ajuster le comportement avec ces variables d'environnement :
115 115
116| Variable | Par défaut | Effet |116| Variable | Par défaut | Effet |
117| :------------------------------------------- | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |117| :------------------------------------------- | :--------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
118| [`CLAUDE_CODE_MAX_RETRIES`](/fr/env-vars) | 10 | Nombre de tentatives de réessai. {/* min-version: 2.1.186 */}Limité à 15 à partir de la v2.1.186 ; {/* min-version: 2.1.199 */}à partir de la v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` augmente la valeur par défaut et supprime le plafond. Réduisez-le pour afficher les défaillances plus rapidement dans les scripts. |118| [`CLAUDE_CODE_MAX_RETRIES`](/docs/fr/env-vars) | 10 | Nombre de tentatives de réessai. Limité à 15 à partir de la v2.1.186 ; à partir de la v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` augmente la valeur par défaut et supprime le plafond. Réduisez-le pour afficher les défaillances plus rapidement dans les scripts. |
119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/fr/env-vars) | non défini | Définissez sur `1` dans les sessions sans surveillance telles que les tâches CI pour réessayer les erreurs de capacité `429` et `529` indéfiniment au lieu d'échouer après `CLAUDE_CODE_MAX_RETRIES` tentatives. {/* min-version: 2.1.199 */}À partir de la v2.1.199, il augmente également le nombre de tentatives par défaut pour les autres erreurs transitoires, telles que les erreurs serveur, les délais d'attente et les connexions interrompues, à 300, environ trois heures de backoff, et supprime le plafond de 15 sur `CLAUDE_CODE_MAX_RETRIES` si vous définissez cette variable explicitement. |119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/fr/env-vars) | non défini | Définissez sur `1` dans les sessions sans surveillance telles que les tâches CI pour réessayer les erreurs de capacité `429` et `529` indéfiniment au lieu d'échouer après `CLAUDE_CODE_MAX_RETRIES` tentatives. À partir de la v2.1.199, il augmente également le nombre de tentatives par défaut pour les autres erreurs transitoires, telles que les erreurs serveur, les délais d'attente et les connexions interrompues, à 300, environ trois heures de backoff, et supprime le plafond de 15 sur `CLAUDE_CODE_MAX_RETRIES` si vous définissez cette variable explicitement. |
120| [`API_TIMEOUT_MS`](/fr/env-vars) | 600000 | Délai d'attente par requête en millisecondes. Augmentez-le pour les réseaux lents ou les proxies. |120| [`API_TIMEOUT_MS`](/docs/fr/env-vars) | 600000 | Délai d'attente par requête en millisecondes. Augmentez-le pour les réseaux lents ou les proxies. |
121 121
122<h2 id="server-errors">122<h2 id="server-errors">
123 Erreurs serveur123 Erreurs serveur
196API Error: Response stalled mid-stream. The response above may be incomplete.196API Error: Response stalled mid-stream. The response above may be incomplete.
197```197```
198 198
199* {/* min-version: 2.1.199 */}`Server error mid-response` : une erreur serveur surchargée ou 5xx en milieu de flux. Cette variante nécessite Claude Code v2.1.199 ou ultérieur ; avant cela, ce cas rejetait la sortie partielle et signalait le tour entier comme une erreur.199* `Server error mid-response` : une erreur serveur surchargée ou 5xx en milieu de flux. Cette variante nécessite Claude Code v2.1.199 ou ultérieur ; avant cela, ce cas rejetait la sortie partielle et signalait le tour entier comme une erreur.
200* `Connection closed mid-response` : la connexion a été interrompue.200* `Connection closed mid-response` : la connexion a été interrompue.
201* `Response stalled mid-stream` : le flux a cessé d'envoyer des données.201* `Response stalled mid-stream` : le flux a cessé d'envoyer des données.
202 202
210 Le mode auto ne peut pas déterminer la sécurité d'une action210 Le mode auto ne peut pas déterminer la sécurité d'une action
211</h3>211</h3>
212 212
213Le modèle que [le mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) utilise pour classer les actions n'a pas pu produire une décision, donc le mode auto n'a pas approuvé l'action automatiquement. Le message que vous voyez dépend de la raison de l'échec du classificateur.213Le modèle que [le mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) utilise pour classer les actions n'a pas pu produire une décision, donc le mode auto n'a pas approuvé l'action automatiquement. Le message que vous voyez dépend de la raison de l'échec du classificateur.
214 214
215Les lectures, recherches et modifications à l'intérieur de votre répertoire de travail ignorent le classificateur, donc elles continuent à fonctionner dans tous ces cas.215Les lectures, recherches et modifications à l'intérieur de votre répertoire de travail ignorent le classificateur, donc elles continuent à fonctionner dans tous ces cas.
216 216
224 224
225* Réessayez après quelques secondes ; Claude voit le même message et réessaye généralement de lui-même225* Réessayez après quelques secondes ; Claude voit le même message et réessaye généralement de lui-même
226* Si les tentatives continuent d'échouer, continuez avec les tâches en lecture seule et revenez à l'action bloquée plus tard226* Si les tentatives continuent d'échouer, continuez avec les tâches en lecture seule et revenez à l'action bloquée plus tard
227* C'est transitoire et sans rapport avec [l'admissibilité du mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) ; vous n'avez pas besoin de modifier les paramètres227* C'est transitoire et sans rapport avec [l'admissibilité du mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) ; vous n'avez pas besoin de modifier les paramètres
228 228
229Quand le classificateur a renvoyé une réponse non analysable :229Quand le classificateur a renvoyé une réponse non analysable :
230 230
247 247
248* 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 classificateur248* 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
249* Le renvoi n'aidera pas ; le même contenu de conversation déclenchera le filtre à nouveau249* Le renvoi n'aidera pas ; le même contenu de conversation déclenchera le filtre à nouveau
250* Basculez vers un [mode de permission](/fr/permission-modes) différent pour pouvoir approuver l'action quand vous y êtes invité, ou commencez une nouvelle conversation sans le contenu déclencheur250* Basculez vers un [mode de permission](/docs/fr/permission-modes) différent pour pouvoir approuver l'action quand vous y êtes invité, ou commencez une nouvelle conversation sans le contenu déclencheur
251 251
252Quand la conversation a grandi au-delà de la fenêtre de contexte du classificateur :252Quand la conversation a grandi au-delà de la fenêtre de contexte du classificateur :
253 253
255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
256```256```
257 257
258Dans une session interactive, le mode auto revient à une invite de permission normale pour cette action afin que vous puissiez l'approuver ou la refuser manuellement. En [mode non-interactif](/fr/headless), l'exécution s'arrête car la transcription ne fait que croître et le renvoi ne peut pas réussir.258Dans une session interactive, le mode auto revient à une invite de permission normale pour cette action afin que vous puissiez l'approuver ou la refuser manuellement. En [mode non-interactif](/docs/fr/headless), l'exécution s'arrête car la transcription ne fait que croître et le renvoi ne peut pas réussir.
259 259
260**Que faire :**260**Que faire :**
261 261
266 Agent terminé prématurément en raison d'une erreur API266 Agent terminé prématurément en raison d'une erreur API
267</h3>267</h3>
268 268
269{/* min-version: 2.1.199 */}La demande API d'un [sous-agent](/fr/sub-agents) a échoué de manière terminale, par exemple parce qu'une limite d'utilisation a été atteinte ou que les tentatives pour une erreur serveur ont épuisé, donc le sous-agent s'est arrêté avant de terminer sa tâche. Ce message nécessite Claude Code v2.1.199 ou ultérieur ; avant cela, le texte d'erreur API était renvoyé à Claude comme s'il s'agissait du résultat du sous-agent.269La demande API d'un [sous-agent](/docs/fr/sub-agents) a échoué de manière terminale, par exemple parce qu'une limite d'utilisation a été atteinte ou que les tentatives pour une erreur serveur ont épuisé, donc le sous-agent s'est arrêté avant de terminer sa tâche. Ce message nécessite Claude Code v2.1.199 ou ultérieur ; avant cela, le texte d'erreur API était renvoyé à Claude comme s'il s'agissait du résultat du sous-agent.
270 270
271```text theme={null}271```text theme={null}
272Agent terminated early due to an API error: <error detail>272Agent terminated early due to an API error: <error detail>
275**Que faire :**275**Que faire :**
276 276
277* Faites correspondre le détail de l'erreur après les deux points à sa propre section sur cette page, telle que [Usage limits](#usage-limits) ou [Server errors](#server-errors), et suivez les étapes de cette section277* Faites correspondre le détail de l'erreur après les deux points à sa propre section sur cette page, telle que [Usage limits](#usage-limits) ou [Server errors](#server-errors), et suivez les étapes de cette section
278* Une fois que l'erreur sous-jacente est résolue, demandez à Claude de réessayer la tâche ou de [reprendre le sous-agent](/fr/sub-agents#resume-subagents)278* Une fois que l'erreur sous-jacente est résolue, demandez à Claude de réessayer la tâche ou de [reprendre le sous-agent](/docs/fr/sub-agents#resume-subagents)
279 279
280Quand une limite de débit, une surcharge ou une erreur serveur interrompt un sous-agent au premier plan qui a déjà produit une sortie textuelle, Claude reçoit cette sortie partielle marquée comme incomplète au lieu de cette erreur. {/* min-version: 2.1.200 */}Un sous-agent dont la seule sortie était des appels d'outils reçoit également cette erreur ; en v2.1.199, cela renvoyait un résultat partiel vide à la place. Consultez [API errors in subagents](/fr/sub-agents#api-errors-in-subagents).280Quand une limite de débit, une surcharge ou une erreur serveur interrompt un sous-agent au premier plan qui a déjà produit une sortie textuelle, Claude reçoit cette sortie partielle marquée comme incomplète au lieu de cette erreur. Un sous-agent dont la seule sortie était des appels d'outils reçoit également cette erreur ; en v2.1.199, cela renvoyait un résultat partiel vide à la place. Consultez [API errors in subagents](/docs/fr/sub-agents#api-errors-in-subagents).
281 281
282<h2 id="usage-limits">282<h2 id="usage-limits">
283 Limites d'utilisation283 Limites d'utilisation
309* Exécutez `/usage-credits` pour acheter une utilisation supplémentaire sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise. Consultez [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) pour savoir comment cela est facturé.309* Exécutez `/usage-credits` pour acheter une utilisation supplémentaire sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise. Consultez [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) pour savoir comment cela est facturé.
310* Pour mettre à niveau votre plan vers des limites de base plus élevées, consultez [claude.com/pricing](https://claude.com/pricing)310* Pour mettre à niveau votre plan vers des limites de base plus élevées, consultez [claude.com/pricing](https://claude.com/pricing)
311 311
312Pour surveiller votre allocation restante avant d'atteindre la limite, ajoutez les champs `rate_limits` à une [ligne d'état personnalisée](/fr/statusline#rate-limit-usage), ou dans l'application Desktop, cliquez sur l'[anneau d'utilisation](/fr/desktop#check-usage) à côté du sélecteur de modèle.312Pour surveiller votre allocation restante avant d'atteindre la limite, ajoutez les champs `rate_limits` à une [ligne d'état personnalisée](/docs/fr/statusline#rate-limit-usage), ou dans l'application Desktop, cliquez sur l'[anneau d'utilisation](/docs/fr/desktop#check-usage) à côté du sélecteur de modèle.
313 313
314<h3 id="usage-credits-required-for-1m-context">314<h3 id="usage-credits-required-for-1m-context">
315 Crédits d'utilisation requis pour le contexte 1M315 Crédits d'utilisation requis pour le contexte 1M
321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context
322```322```
323 323
324Il s'agit d'une vérification de droit, et non d'un épuisement de quota. Elle se déclenche même quand vos allocations de session et hebdomadaires ont de la capacité restante. Consultez [Extended context](/fr/model-config#extended-context) pour voir quels plans incluent directement le contexte 1M et lesquels nécessitent des crédits d'utilisation.324Il s'agit d'une vérification de droit, et non d'un épuisement de quota. Elle se déclenche même quand vos allocations de session et hebdomadaires ont de la capacité restante. Consultez [Extended context](/docs/fr/model-config#extended-context) pour voir quels plans incluent directement le contexte 1M et lesquels nécessitent des crédits d'utilisation.
325 325
326{/* min-version: 2.1.172 */}Quand cette erreur apparaît au milieu d'une conversation parce que le contexte a dépassé 200K tokens, Claude Code compacte automatiquement la conversation en dessous de la limite de contexte standard et maintient la session à cette limite par la suite, donc aucune action n'est nécessaire. Sur les versions antérieures à v2.1.172, l'erreur s'est répétée à chaque demande ultérieure, y compris `/compact` ; exécutez `/clear` sur ces versions pour récupérer. Les étapes ci-dessous s'appliquent quand vous avez explicitement sélectionné un modèle `[1m]`.326Quand cette erreur apparaît au milieu d'une conversation parce que le contexte a dépassé 200K tokens, Claude Code compacte automatiquement la conversation en dessous de la limite de contexte standard et maintient la session à cette limite par la suite, donc aucune action n'est nécessaire. Sur les versions antérieures à v2.1.172, l'erreur s'est répétée à chaque demande ultérieure, y compris `/compact` ; exécutez `/clear` sur ces versions pour récupérer. Les étapes ci-dessous s'appliquent quand vous avez explicitement sélectionné un modèle `[1m]`.
327 327
328**À faire :**328**À faire :**
329 329
330* Exécutez `/model` et sélectionnez la variante sans le suffixe `[1m]` pour revenir à la fenêtre de contexte standard330* Exécutez `/model` et sélectionnez la variante sans le suffixe `[1m]` pour revenir à la fenêtre de contexte standard
331* Exécutez `/usage-credits` pour activer la facturation mesurée pour la variante 1M sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise331* Exécutez `/usage-credits` pour activer la facturation mesurée pour la variante 1M sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise
332* Si l'erreur persiste après `/model`, un ID de modèle 1M peut être défini ailleurs. Consultez [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) pour les emplacements de configuration à vérifier par ordre de priorité.332* Si l'erreur persiste après `/model`, un ID de modèle 1M peut être défini ailleurs. Consultez [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) pour les emplacements de configuration à vérifier par ordre de priorité.
333* Pour supprimer entièrement les variantes 1M du sélecteur de modèle, définissez [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/fr/env-vars)333* Pour supprimer entièrement les variantes 1M du sélecteur de modèle, définissez [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/fr/env-vars)
334 334
335<h3 id="server-is-temporarily-limiting-requests">335<h3 id="server-is-temporarily-limiting-requests">
336 Le serveur limite temporairement les demandes336 Le serveur limite temporairement les demandes
342API Error: Server is temporarily limiting requests (not your usage limit)342API Error: Server is temporarily limiting requests (not your usage limit)
343```343```
344 344
345Claude Code les distingue de votre limite de plan par l'absence des en-têtes de quota unifiés qu'une réponse de limite réelle porte. {/* min-version: 2.1.199 */}À partir de v2.1.199, ceci est [réessayé automatiquement](#automatic-retries) avec backoff avant d'être affiché, quelle que soit votre méthode d'authentification. Sur les versions antérieures, une session connectée avec un abonnement claude.ai a échoué le tour à la première occurrence ; seules les authentifications par clé API et Enterprise l'ont réessayé.345Claude Code les distingue de votre limite de plan par l'absence des en-têtes de quota unifiés qu'une réponse de limite réelle porte. À partir de v2.1.199, ceci est [réessayé automatiquement](#automatic-retries) avec backoff avant d'être affiché, quelle que soit votre méthode d'authentification. Sur les versions antérieures, une session connectée avec un abonnement claude.ai a échoué le tour à la première occurrence ; seules les authentifications par clé API et Enterprise l'ont réessayé.
346 346
347**À faire :**347**À faire :**
348 348
366* Exécutez `/status` et confirmez que les identifiants actifs sont ceux que vous attendez. Une `ANTHROPIC_API_KEY` égarée dans votre environnement peut acheminer les demandes via une clé de niveau inférieur au lieu de votre abonnement.366* Exécutez `/status` et confirmez que les identifiants actifs sont ceux que vous attendez. Une `ANTHROPIC_API_KEY` égarée dans votre environnement peut acheminer les demandes via une clé de niveau inférieur au lieu de votre abonnement.
367* Vérifiez votre console de fournisseur pour les limites actives et demandez un niveau supérieur si nécessaire367* Vérifiez votre console de fournisseur pour les limites actives et demandez un niveau supérieur si nécessaire
368* Pour les clés API Anthropic, consultez la [référence des limites de débit](https://platform.claude.com/docs/en/api/rate-limits) pour savoir comment fonctionnent les niveaux et comment définir des plafonds par espace de travail368* Pour les clés API Anthropic, consultez la [référence des limites de débit](https://platform.claude.com/docs/en/api/rate-limits) pour savoir comment fonctionnent les niveaux et comment définir des plafonds par espace de travail
369* Réduisez la concurrence : abaissez [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/fr/env-vars), évitez d'exécuter de nombreux sous-agents parallèles, ou passez à un modèle plus petit avec `/model` pour les exécutions scriptées à haut volume369* Réduisez la concurrence : abaissez [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/fr/env-vars), évitez d'exécuter de nombreux sous-agents parallèles, ou passez à un modèle plus petit avec `/model` pour les exécutions scriptées à haut volume
370 370
371<h3 id="credit-balance-is-too-low">371<h3 id="credit-balance-is-too-low">
372 Le solde de crédit est trop faible372 Le solde de crédit est trop faible
382 382
383* Ajoutez des crédits sur [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), et envisagez d'activer le rechargement automatique pour que le solde se reconstitue avant d'atteindre zéro383* Ajoutez des crédits sur [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), et envisagez d'activer le rechargement automatique pour que le solde se reconstitue avant d'atteindre zéro
384* Passez à l'authentification par abonnement avec `/login` si vous avez un plan Pro, Max, Team ou Enterprise384* Passez à l'authentification par abonnement avec `/login` si vous avez un plan Pro, Max, Team ou Enterprise
385* 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](/fr/costs).385* 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](/docs/fr/costs).
386 386
387<h2 id="authentication-errors">387<h2 id="authentication-errors">
388 Erreurs d'authentification388 Erreurs d'authentification
404 404
405* Exécutez `/login` pour vous authentifier avec votre abonnement Claude ou votre compte Console405* Exécutez `/login` pour vous authentifier avec votre abonnement Claude ou votre compte Console
406* Si vous vous attendiez à ce qu'une variable d'environnement vous authentifie, confirmez que `ANTHROPIC_API_KEY` est définie et exportée dans le shell où vous avez lancé `claude`406* Si vous vous attendiez à ce qu'une variable d'environnement vous authentifie, confirmez que `ANTHROPIC_API_KEY` est définie et exportée dans le shell où vous avez lancé `claude`
407* Pour l'intégration continue ou l'automatisation où la connexion interactive n'est pas possible, configurez un script [`apiKeyHelper`](/fr/settings#available-settings) qui récupère une clé au démarrage407* Pour l'intégration continue ou l'automatisation où la connexion interactive n'est pas possible, configurez un script [`apiKeyHelper`](/docs/fr/settings#available-settings) qui récupère une clé au démarrage
408* Consultez [Précédence d'authentification](/fr/authentication#authentication-precedence) pour comprendre quelle credential Claude Code utilise quand plusieurs sont présentes408* Consultez [Précédence d'authentification](/docs/fr/authentication#authentication-precedence) pour comprendre quelle credential Claude Code utilise quand plusieurs sont présentes
409 409
410Si vous êtes invité à vous connecter à plusieurs reprises, consultez [Non connecté ou token expiré](/fr/troubleshoot-install#not-logged-in-or-token-expired) pour les corrections d'horloge système et de Keychain macOS.410Si vous êtes invité à vous connecter à plusieurs reprises, consultez [Non connecté ou token expiré](/docs/fr/troubleshoot-install#not-logged-in-or-token-expired) pour les corrections d'horloge système et de Keychain macOS.
411 411
412<h3 id="could-not-resolve-authentication-method">412<h3 id="could-not-resolve-authentication-method">
413 Impossible de résoudre la méthode d'authentification413 Impossible de résoudre la méthode d'authentification
414</h3>414</h3>
415 415
416La session a atteint le client API sans aucune credential. Cela apparaît dans les [sessions en arrière-plan](/fr/agent-view), les sessions cloud et les contextes Agent SDK où la vérification de connexion interactive ne s'exécute pas avant la première requête.416La session a atteint le client API sans aucune credential. Cela apparaît dans les [sessions en arrière-plan](/docs/fr/agent-view), les sessions cloud et les contextes Agent SDK où la vérification de connexion interactive ne s'exécute pas avant la première requête.
417 417
418```text theme={null}418```text theme={null}
419Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted419Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted
420```420```
421 421
422{/* min-version: 2.1.174 */}Avant la v2.1.174, une session en arrière-plan ou cloud assignée à un worker pré-initialisé inactif pouvait échouer de cette façon même quand des credentials valides étaient configurées. Mettez à jour pour récupérer. Sur les versions actuelles, l'erreur signifie qu'aucune credential n'était disponible pour le processus worker.422Avant la v2.1.174, une session en arrière-plan ou cloud assignée à un worker pré-initialisé inactif pouvait échouer de cette façon même quand des credentials valides étaient configurées. Mettez à jour pour récupérer. Sur les versions actuelles, l'erreur signifie qu'aucune credential n'était disponible pour le processus worker.
423 423
424**À faire :**424**À faire :**
425 425
426* Mettez à jour vers la v2.1.174 ou ultérieure si cela apparaît dans une session en arrière-plan ou cloud et que vos credentials sont déjà configurées426* Mettez à jour vers la v2.1.174 ou ultérieure si cela apparaît dans une session en arrière-plan ou cloud et que vos credentials sont déjà configurées
427* Confirmez que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` ou vos credentials du fournisseur cloud sont définis dans l'environnement qui lance le worker, pas seulement dans votre shell interactif427* Confirmez que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` ou vos credentials du fournisseur cloud sont définis dans l'environnement qui lance le worker, pas seulement dans votre shell interactif
428* Pour l'Agent SDK, consultez [configuration de l'authentification](/fr/agent-sdk/overview#get-started)428* Pour l'Agent SDK, consultez [configuration de l'authentification](/docs/fr/agent-sdk/overview#get-started)
429* Exécutez `/status` dans une session interactive dans le même environnement pour confirmer quelle source de credential se résout429* Exécutez `/status` dans une session interactive dans le même environnement pour confirmer quelle source de credential se résout
430 430
431<h3 id="invalid-api-key">431<h3 id="invalid-api-key">
443* Vérifiez les fautes de frappe et confirmez que la clé n'a pas été révoquée dans la [Console](https://platform.claude.com/settings/keys)443* Vérifiez les fautes de frappe et confirmez que la clé n'a pas été révoquée dans la [Console](https://platform.claude.com/settings/keys)
444* Exécutez `env | grep ANTHROPIC` dans le même shell. Des outils comme direnv, les plugins shell dotenv et les terminaux IDE peuvent charger une clé obsolète à partir d'un fichier `.env` dans votre projet sans que vous la définissiez explicitement.444* Exécutez `env | grep ANTHROPIC` dans le même shell. Des outils comme direnv, les plugins shell dotenv et les terminaux IDE peuvent charger une clé obsolète à partir d'un fichier `.env` dans votre projet sans que vous la définissiez explicitement.
445* Déconfigurez `ANTHROPIC_API_KEY` et exécutez `/login` pour utiliser l'authentification par abonnement à la place445* Déconfigurez `ANTHROPIC_API_KEY` et exécutez `/login` pour utiliser l'authentification par abonnement à la place
446* Si la clé provient d'un script [`apiKeyHelper`](/fr/settings#available-settings), exécutez le script directement pour confirmer qu'il imprime une clé valide sur stdout446* Si la clé provient d'un script [`apiKeyHelper`](/docs/fr/settings#available-settings), exécutez le script directement pour confirmer qu'il imprime une clé valide sur stdout
447* Exécutez `/status` pour confirmer quelle source de credential Claude Code utilise réellement447* Exécutez `/status` pour confirmer quelle source de credential Claude Code utilise réellement
448 448
449<h3 id="your-apikeyhelper-script-is-failing">449<h3 id="your-apikeyhelper-script-is-failing">
450 Votre script apiKeyHelper échoue450 Votre script apiKeyHelper échoue
451</h3>451</h3>
452 452
453La commande configurée dans le paramètre [`apiKeyHelper`](/fr/settings#available-settings) s'est terminée avec une erreur, a expiré ou n'a rien imprimé sur stdout. Sans une clé du script, la requête atteint l'API avec une credential d'espace réservé, et l'API la rejette avec `401`.453La commande configurée dans le paramètre [`apiKeyHelper`](/docs/fr/settings#available-settings) s'est terminée avec une erreur, a expiré ou n'a rien imprimé sur stdout. Sans une clé du script, la requête atteint l'API avec une credential d'espace réservé, et l'API la rejette avec `401`.
454 454
455```text theme={null}455```text theme={null}
456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
457```457```
458 458
459Claude Code réexécute le script et réessaie la requête jusqu'à deux fois de plus avant d'afficher ce message, donc l'échec apparaît dans trois tentatives. {/* min-version: 2.1.208 */}Avant la v2.1.208, Claude Code dépensait le [budget de retry](#automatic-retries) complet en renvoyant la requête avec la credential d'espace réservé et signalait ensuite une erreur d'authentification générique `401` au lieu de l'échec du script.459Claude Code réexécute le script et réessaie la requête jusqu'à deux fois de plus avant d'afficher ce message, donc l'échec apparaît dans trois tentatives. Avant la v2.1.208, Claude Code dépensait le [budget de retry](#automatic-retries) complet en renvoyant la requête avec la credential d'espace réservé et signalait ensuite une erreur d'authentification générique `401` au lieu de l'échec du script.
460 460
461Exécuter `/login` n'aide pas ici : la sortie du helper [prend la priorité](/fr/authentication#authentication-precedence) sur une connexion enregistrée tant que le paramètre est présent.461Exécuter `/login` n'aide pas ici : la sortie du helper [prend la priorité](/docs/fr/authentication#authentication-precedence) sur une connexion enregistrée tant que le paramètre est présent.
462 462
463**À faire :**463**À faire :**
464 464
465* Exécutez la commande configurée dans `apiKeyHelper` directement dans votre shell pour reproduire l'échec465* Exécutez la commande configurée dans `apiKeyHelper` directement dans votre shell pour reproduire l'échec
466* Si la commande signale une session expirée, réauthentifiez-vous auprès de votre fournisseur de credential, par exemple en vous reconnectant à votre SSO ou à votre coffre-fort de secrets466* Si la commande signale une session expirée, réauthentifiez-vous auprès de votre fournisseur de credential, par exemple en vous reconnectant à votre SSO ou à votre coffre-fort de secrets
467* Corrigez la commande pour qu'elle imprime la clé sur stdout et se termine avec le code 0. Consultez [rotation des credentials avec apiKeyHelper](/fr/llm-gateway-connect#rotate-credentials-with-apikeyhelper) pour une configuration fonctionnelle.467* Corrigez la commande pour qu'elle imprime la clé sur stdout et se termine avec le code 0. Consultez [rotation des credentials avec apiKeyHelper](/docs/fr/llm-gateway-connect#rotate-credentials-with-apikeyhelper) pour une configuration fonctionnelle.
468* Exécutez `/status` pour confirmer que `apiKeyHelper` est la source de credential active. Chaque fois que la commande échoue, son code de sortie et sa sortie d'erreur apparaissent dans un panneau `Cloud authentication` dans le terminal.468* Exécutez `/status` pour confirmer que `apiKeyHelper` est la source de credential active. Chaque fois que la commande échoue, son code de sortie et sa sortie d'erreur apparaissent dans un panneau `Cloud authentication` dans le terminal.
469 469
470<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">
499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
500```500```
501 501
502Les variables d'environnement et `apiKeyHelper` ont la priorité sur `/login`, donc exécuter `/login` seul n'aide pas tant que l'un ou l'autre fournit toujours une clé. Consultez [Précédence d'authentification](/fr/authentication#authentication-precedence).502Les variables d'environnement et `apiKeyHelper` ont la priorité sur `/login`, donc exécuter `/login` seul n'aide pas tant que l'un ou l'autre fournit toujours une clé. Consultez [Précédence d'authentification](/docs/fr/authentication#authentication-precedence).
503 503
504**À faire :**504**À faire :**
505 505
506* Si le message nomme `ANTHROPIC_API_KEY`, déconfigurez-la dans le shell actuel et supprimez-la de votre profil shell ou fichier `.env`, puis relancez `claude`506* Si le message nomme `ANTHROPIC_API_KEY`, déconfigurez-la dans le shell actuel et supprimez-la de votre profil shell ou fichier `.env`, puis relancez `claude`
507* Si le message nomme `apiKeyHelper`, supprimez le paramètre [`apiKeyHelper`](/fr/settings#available-settings) de votre `settings.json`507* Si le message nomme `apiKeyHelper`, supprimez le paramètre [`apiKeyHelper`](/docs/fr/settings#available-settings) de votre `settings.json`
508* Exécutez `/login` pour vous connecter avec votre compte claude.ai508* Exécutez `/login` pour vous connecter avec votre compte claude.ai
509* Exécutez `/status` après pour confirmer que la credential active est votre abonnement plutôt qu'une clé API509* Exécutez `/status` après pour confirmer que la credential active est votre abonnement plutôt qu'une clé API
510* Si vous avez besoin de l'authentification par clé API pour l'automatisation, demandez à votre administrateur d'organisation de la réactiver dans la Console510* Si vous avez besoin de l'authentification par clé API pour l'automatisation, demandez à votre administrateur d'organisation de la réactiver dans la Console
526**À faire :**526**À faire :**
527 527
528* Demandez à votre administrateur d'activer l'accès à Claude Code pour votre organisation528* Demandez à votre administrateur d'activer l'accès à Claude Code pour votre organisation
529* Authentifiez-vous avec une clé API Console au lieu de votre abonnement. Consultez [Authentification Claude Console](/fr/authentication#claude-console-authentication) pour la configuration.529* Authentifiez-vous avec une clé API Console au lieu de votre abonnement. Consultez [Authentification Claude Console](/docs/fr/authentication#claude-console-authentication) pour la configuration.
530* Si vous êtes l'administrateur et que vous ne voyez pas d'option pour activer l'accès, contactez le [support Anthropic](https://support.claude.com)530* Si vous êtes l'administrateur et que vous ne voyez pas d'option pour activer l'accès, contactez le [support Anthropic](https://support.claude.com)
531 531
532<h3 id="routines-are-disabled-by-your-organizations-policy">532<h3 id="routines-are-disabled-by-your-organizations-policy">
533 Les routines sont désactivées par la politique de votre organisation533 Les routines sont désactivées par la politique de votre organisation
534</h3>534</h3>
535 535
536Un propriétaire de votre organisation Team ou Enterprise a désactivé les routines au niveau de l'organisation. L'erreur apparaît quand vous essayez de créer ou d'exécuter une routine, y compris à partir de `/schedule` et de l'interface utilisateur [Routines](/fr/routines) sur claude.ai/code.536Un propriétaire de votre organisation Team ou Enterprise a désactivé les routines au niveau de l'organisation. L'erreur apparaît quand vous essayez de créer ou d'exécuter une routine, y compris à partir de `/schedule` et de l'interface utilisateur [Routines](/docs/fr/routines) sur claude.ai/code.
537 537
538```text theme={null}538```text theme={null}
539Routines are disabled by your organization's policy.539Routines are disabled by your organization's policy.
544**À faire :**544**À faire :**
545 545
546* Demandez à un propriétaire de votre organisation d'activer le bouton bascule **Routines** sur [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)546* Demandez à un propriétaire de votre organisation d'activer le bouton bascule **Routines** sur [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
547* Pour un travail programmé ponctuel qui ne nécessite pas de routines au niveau de l'organisation, consultez [tâches programmées](/fr/scheduled-tasks)547* Pour un travail programmé ponctuel qui ne nécessite pas de routines au niveau de l'organisation, consultez [tâches programmées](/docs/fr/scheduled-tasks)
548 548
549<h3 id="remote-control-requires-the-anthropic-api">549<h3 id="remote-control-requires-the-anthropic-api">
550 Remote Control nécessite l'API Anthropic550 Remote Control nécessite l'API Anthropic
551</h3>551</h3>
552 552
553La session ne parle pas directement à l'API Anthropic, donc il n'y a pas de backend claude.ai pour que [Remote Control](/fr/remote-control) s'apparie avec.553La session ne parle pas directement à l'API Anthropic, donc il n'y a pas de backend claude.ai pour que [Remote Control](/docs/fr/remote-control) s'apparie avec.
554 554
555```text theme={null}555```text theme={null}
556Remote Control is only available when using Claude via api.anthropic.com.556Remote Control is only available when using Claude via api.anthropic.com.
557```557```
558 558
559Cela apparaît sur Amazon Bedrock, la plateforme Agent de Google Cloud et Microsoft Foundry. {/* min-version: 2.1.196 */}À partir de la v2.1.196, cela apparaît également quand [`ANTHROPIC_BASE_URL`](/fr/env-vars) pointe vers un hôte autre que `api.anthropic.com`, comme une [passerelle LLM](/fr/llm-gateway) ou un proxy, même quand vous vous connectez avec claude.ai.559Cela apparaît sur Amazon Bedrock, la plateforme Agent de Google Cloud et Microsoft Foundry. À partir de la v2.1.196, cela apparaît également quand [`ANTHROPIC_BASE_URL`](/docs/fr/env-vars) pointe vers un hôte autre que `api.anthropic.com`, comme une [passerelle LLM](/docs/fr/llm-gateway) ou un proxy, même quand vous vous connectez avec claude.ai.
560 560
561**À faire :**561**À faire :**
562 562
563* Déconfigurez `ANTHROPIC_BASE_URL` et redémarrez la session, ou démarrez Remote Control à partir d'une session qui parle directement à l'API Anthropic563* Déconfigurez `ANTHROPIC_BASE_URL` et redémarrez la session, ou démarrez Remote Control à partir d'une session qui parle directement à l'API Anthropic
564* Pour ce message et les autres messages de démarrage de Remote Control, consultez [Dépannage de Remote Control](/fr/remote-control#troubleshooting)564* Pour ce message et les autres messages de démarrage de Remote Control, consultez [Dépannage de Remote Control](/docs/fr/remote-control#troubleshooting)
565 565
566<h3 id="oauth-token-revoked-or-expired">566<h3 id="oauth-token-revoked-or-expired">
567 Token OAuth révoqué ou expiré567 Token OAuth révoqué ou expiré
581 581
582* Exécutez `/login` pour vous reconnecter582* Exécutez `/login` pour vous reconnecter
583* Si l'erreur revient dans la même session après réauthentification, exécutez d'abord `/logout` pour effacer complètement le token stocké, puis `/login`583* Si l'erreur revient dans la même session après réauthentification, exécutez d'abord `/logout` pour effacer complètement le token stocké, puis `/login`
584* Pour les invites répétées à vous connecter entre les lancements, consultez les vérifications d'horloge système et de Keychain macOS dans [Dépannage](/fr/troubleshoot-install#not-logged-in-or-token-expired)584* Pour les invites répétées à vous connecter entre les lancements, consultez les vérifications d'horloge système et de Keychain macOS dans [Dépannage](/docs/fr/troubleshoot-install#not-logged-in-or-token-expired)
585* Pour les autres défaillances incluant `403 Forbidden` et les problèmes de navigateur OAuth, consultez [Connexion et authentification](/fr/troubleshoot-install#login-and-authentication)585* Pour les autres défaillances incluant `403 Forbidden` et les problèmes de navigateur OAuth, consultez [Connexion et authentification](/docs/fr/troubleshoot-install#login-and-authentication)
586 586
587<h3 id="login-expired">587<h3 id="login-expired">
588 Connexion expirée588 Connexion expirée
589</h3>589</h3>
590 590
591Claude Code a essayé de renouveler votre connexion claude.ai ou Claude Console enregistrée et le service OAuth a rejeté le token d'actualisation stocké, donc Claude Code a effacé les credentials enregistrées. Après cela, chaque requête s'arrête localement avant d'atteindre l'API, car seul `/login` peut créer de nouvelles credentials. {/* min-version: 2.1.206 */}Avant la v2.1.206, Claude Code envoyait la requête de toute façon avec quelle que soit la credential restante dans l'environnement, et chaque modèle échouait ensuite avec [Il y a un problème avec le modèle sélectionné](#theres-an-issue-with-the-selected-model) ou un 401 au lieu d'une invite à se connecter.591Claude Code a essayé de renouveler votre connexion claude.ai ou Claude Console enregistrée et le service OAuth a rejeté le token d'actualisation stocké, donc Claude Code a effacé les credentials enregistrées. Après cela, chaque requête s'arrête localement avant d'atteindre l'API, car seul `/login` peut créer de nouvelles credentials. Avant la v2.1.206, Claude Code envoyait la requête de toute façon avec quelle que soit la credential restante dans l'environnement, et chaque modèle échouait ensuite avec [Il y a un problème avec le modèle sélectionné](#theres-an-issue-with-the-selected-model) ou un 401 au lieu d'une invite à se connecter.
592 592
593```text theme={null}593```text theme={null}
594Login expired · Please run /login594Login expired · Please run /login
595```595```
596 596
597En [mode non-interactif](/fr/headless) (`-p`) et l'[Agent SDK](/fr/agent-sdk/overview), le message se lit comme suit, et le code d'erreur structuré est `authentication_failed` :597En [mode non-interactif](/docs/fr/headless) (`-p`) et l'[Agent SDK](/docs/fr/agent-sdk/overview), le message se lit comme suit, et le code d'erreur structuré est `authentication_failed` :
598 598
599```text theme={null}599```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed600Failed to authenticate: OAuth session expired and could not be refreshed
602 602
603Ce n'est pas le même état que [Token OAuth révoqué ou expiré](#oauth-token-revoked-or-expired). Ces messages signalent un 401 que l'API a retourné. Claude Code lui-même produit `Login expired` pour une connexion qu'il a déjà échoué à renouveler, donc il n'envoie aucune requête.603Ce n'est pas le même état que [Token OAuth révoqué ou expiré](#oauth-token-revoked-or-expired). Ces messages signalent un 401 que l'API a retourné. Claude Code lui-même produit `Login expired` pour une connexion qu'il a déjà échoué à renouveler, donc il n'envoie aucune requête.
604 604
605Les sessions authentifiées avec une clé API, [`CLAUDE_CODE_OAUTH_TOKEN`](/fr/env-vars) ou un fournisseur tiers n'utilisent pas la connexion enregistrée et ne voient jamais ce message.605Les sessions authentifiées avec une clé API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/fr/env-vars) ou un fournisseur tiers n'utilisent pas la connexion enregistrée et ne voient jamais ce message.
606 606
607**À faire :**607**À faire :**
608 608
609* Exécutez `/login` pour vous reconnecter. Réessayer sans vous connecter affiche le même message à chaque requête.609* Exécutez `/login` pour vous reconnecter. Réessayer sans vous connecter affiche le même message à chaque requête.
610* En mode non-interactif, exécutez `claude` dans le même environnement, complétez `/login`, puis réexécutez votre commande. Pour l'automatisation qui ne peut pas se connecter de manière interactive, authentifiez-vous avec `ANTHROPIC_API_KEY` ou [générez un token de longue durée avec `claude setup-token`](/fr/authentication#generate-a-long-lived-token).610* En mode non-interactif, exécutez `claude` dans le même environnement, complétez `/login`, puis réexécutez votre commande. Pour l'automatisation qui ne peut pas se connecter de manière interactive, authentifiez-vous avec `ANTHROPIC_API_KEY` ou [générez un token de longue durée avec `claude setup-token`](/docs/fr/authentication#generate-a-long-lived-token).
611* Si la connexion continue d'échouer, consultez [Connexion et authentification](/fr/troubleshoot-install#login-and-authentication)611* Si la connexion continue d'échouer, consultez [Connexion et authentification](/docs/fr/troubleshoot-install#login-and-authentication)
612 612
613<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">
614 Exigence de portée OAuth614 Exigence de portée OAuth
628 Les credentials AWS ont expiré ou sont invalides628 Les credentials AWS ont expiré ou sont invalides
629</h3>629</h3>
630 630
631{/* min-version: 2.1.198 */}Ce message nécessite Claude Code v2.1.198 ou ultérieur et n'apparaît que quand [`awsAuthRefresh`](/fr/amazon-bedrock#advanced-credential-configuration) est défini dans votre fichier de paramètres. Votre token de session AWS a expiré ou a été rejeté, et l'actualisation automatique que Claude Code a déjà exécutée n'a pas produit une credential que l'API accepte. Cela apparaît sur un 401 de [Claude Platform on AWS](/fr/claude-platform-on-aws) ou du [point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint), c'est ainsi que ces fournisseurs signalent un token de sécurité expiré.631Ce message nécessite Claude Code v2.1.198 ou ultérieur et n'apparaît que quand [`awsAuthRefresh`](/docs/fr/amazon-bedrock#advanced-credential-configuration) est défini dans votre fichier de paramètres. Votre token de session AWS a expiré ou a été rejeté, et l'actualisation automatique que Claude Code a déjà exécutée n'a pas produit une credential que l'API accepte. Cela apparaît sur un 401 de [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) ou du [point de terminaison Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint), c'est ainsi que ces fournisseurs signalent un token de sécurité expiré.
632 632
633L'indice d'action au milieu nomme la commande `awsAuthRefresh` de vos paramètres, donc il varie. La partie stable est le début `AWS credentials expired or invalid` :633L'indice d'action au milieu nomme la commande `awsAuthRefresh` de vos paramètres, donc il varie. La partie stable est le début `AWS credentials expired or invalid` :
634 634
641**À faire :**641**À faire :**
642 642
643* Exécutez la commande `awsAuthRefresh` nommée dans le message, comme `aws sso login --profile myprofile`, dans un autre terminal et complétez la connexion au navigateur, puis réessayez643* Exécutez la commande `awsAuthRefresh` nommée dans le message, comme `aws sso login --profile myprofile`, dans un autre terminal et complétez la connexion au navigateur, puis réessayez
644* Dans une session interactive, exécutez `/login`, choisissez **plateforme tierce**, puis sélectionnez **Claude Platform on AWS · refresh credentials** sous **Utilisation de plateformes tierces** pour exécuter la même commande sans redémarrer Claude Code. Consultez [Configurer les credentials AWS](/fr/claude-platform-on-aws#1-configure-aws-credentials)644* Dans une session interactive, exécutez `/login`, choisissez **plateforme tierce**, puis sélectionnez **Claude Platform on AWS · refresh credentials** sous **Utilisation de plateformes tierces** pour exécuter la même commande sans redémarrer Claude Code. Consultez [Configurer les credentials AWS](/docs/fr/claude-platform-on-aws#1-configure-aws-credentials)
645* Si l'erreur se répète après que la commande d'actualisation réussisse, confirmez que l'identité est valide en dehors de Claude Code avec `aws sts get-caller-identity` dans le même shell et profil645* Si l'erreur se répète après que la commande d'actualisation réussisse, confirmez que l'identité est valide en dehors de Claude Code avec `aws sts get-caller-identity` dans le même shell et profil
646 646
647<h3 id="aws-authentication-failed">647<h3 id="aws-authentication-failed">
648 L'authentification AWS a échoué648 L'authentification AWS a échoué
649</h3>649</h3>
650 650
651{/* min-version: 2.1.198 */}Ce message nécessite Claude Code v2.1.198 ou ultérieur et n'apparaît que quand [`awsAuthRefresh`](/fr/amazon-bedrock#advanced-credential-configuration) est défini dans votre fichier de paramètres. Votre fournisseur AWS a retourné un 403, ou [Amazon Bedrock](/fr/amazon-bedrock) a retourné un 401.651Ce message nécessite Claude Code v2.1.198 ou ultérieur et n'apparaît que quand [`awsAuthRefresh`](/docs/fr/amazon-bedrock#advanced-credential-configuration) est défini dans votre fichier de paramètres. Votre fournisseur AWS a retourné un 403, ou [Amazon Bedrock](/docs/fr/amazon-bedrock) a retourné un 401.
652 652
653Claude Code ne peut pas dire quelle cause vous avez atteinte. Amazon Bedrock signale un token de sécurité expiré comme un 403, mais un 403 est aussi comment il signale un refus d'autorisation, comme une `AccessDeniedException` d'une permission IAM manquante ou d'un modèle qui n'est pas activé pour votre compte.653Claude Code ne peut pas dire quelle cause vous avez atteinte. Amazon Bedrock signale un token de sécurité expiré comme un 403, mais un 403 est aussi comment il signale un refus d'autorisation, comme une `AccessDeniedException` d'une permission IAM manquante ou d'un modèle qui n'est pas activé pour votre compte.
654 654
665**À faire :**665**À faire :**
666 666
667* Exécutez la commande `awsAuthRefresh` nommée dans le message, ou `aws sso login`, au cas où une credential expirée serait la cause667* Exécutez la commande `awsAuthRefresh` nommée dans le message, ou `aws sso login`, au cas où une credential expirée serait la cause
668* Si vos credentials sont actuelles, confirmez que les permissions IAM dans [Configuration IAM](/fr/amazon-bedrock#iam-configuration) sont attachées à l'identité que vous utilisez et que le modèle sélectionné est activé pour votre compte et région668* Si vos credentials sont actuelles, confirmez que les permissions IAM dans [Configuration IAM](/docs/fr/amazon-bedrock#iam-configuration) sont attachées à l'identité que vous utilisez et que le modèle sélectionné est activé pour votre compte et région
669* Exécutez `aws sts get-caller-identity` pour confirmer quelle identité vos requêtes utilisent ; un `AWS_PROFILE` obsolète ou un profil par défaut est une cause courante d'une incompatibilité de permission669* Exécutez `aws sts get-caller-identity` pour confirmer quelle identité vos requêtes utilisent ; un `AWS_PROFILE` obsolète ou un profil par défaut est une cause courante d'une incompatibilité de permission
670 670
671<h3 id="aws-default-chain-credential-resolve-timed-out">671<h3 id="aws-default-chain-credential-resolve-timed-out">
672 Le délai d'expiration de la résolution des credentials de la chaîne par défaut AWS a expiré672 Le délai d'expiration de la résolution des credentials de la chaîne par défaut AWS a expiré
673</h3>673</h3>
674 674
675Le fournisseur de credentials de la chaîne par défaut AWS n'a pas produit de credentials dans les 60 secondes, donc Claude Code a arrêté la résolution et a échoué la requête. L'échec est une résolution de credentials locale : la requête n'a jamais atteint [Amazon Bedrock](/fr/amazon-bedrock), [Claude Platform on AWS](/fr/claude-platform-on-aws) ou le [point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint). Claude Code efface son [cache de credentials](/fr/amazon-bedrock#credential-caching-and-resolution-timeout) et réessaie avant que cette erreur ne fasse surface, donc au moment où vous la voyez, la chaîne s'est bloquée sur des tentatives répétées.675Le fournisseur de credentials de la chaîne par défaut AWS n'a pas produit de credentials dans les 60 secondes, donc Claude Code a arrêté la résolution et a échoué la requête. L'échec est une résolution de credentials locale : la requête n'a jamais atteint [Amazon Bedrock](/docs/fr/amazon-bedrock), [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) ou le [point de terminaison Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint). Claude Code efface son [cache de credentials](/docs/fr/amazon-bedrock#credential-caching-and-resolution-timeout) et réessaie avant que cette erreur ne fasse surface, donc au moment où vous la voyez, la chaîne s'est bloquée sur des tentatives répétées.
676 676
677```text theme={null}677```text theme={null}
678API Error: AWS default-chain credential resolve timed out678API Error: AWS default-chain credential resolve timed out
679```679```
680 680
681Les causes courantes sont une commande `credential_process` dans votre profil AWS qui attend une entrée 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. {/* min-version: 2.1.207 */}Avant la v2.1.207, une chaîne bloquée laissait la requête en attente indéfiniment au lieu d'échouer avec ce message.681Les causes courantes sont une commande `credential_process` dans votre profil AWS qui attend une entrée 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.207, une chaîne bloquée laissait la requête en attente indéfiniment au lieu d'échouer avec ce message.
682 682
683**À faire :**683**À faire :**
684 684
685* Exécutez `aws sts get-caller-identity` dans le même shell avec le même `AWS_PROFILE`. S'il se bloque également, corrigez le profil ; une commande `credential_process` qui demande de manière interactive est une cause courante.685* Exécutez `aws sts get-caller-identity` dans le même shell avec le même `AWS_PROFILE`. S'il se bloque également, corrigez le profil ; une commande `credential_process` qui demande de manière interactive est une cause courante.
686* Complétez l'étape de connexion avant de démarrer Claude Code, par exemple `aws sso login --profile myprofile`, pour que la chaîne se résolve à partir du cache SSO local au lieu d'attendre un flux de navigateur686* Complétez l'étape de connexion avant de démarrer Claude Code, par exemple `aws sso login --profile myprofile`, pour que la chaîne se résolve à partir du cache SSO local au lieu d'attendre un flux de navigateur
687* Si votre chaîne exécute une connexion interactive qui a légitimement besoin de plus de 60 secondes, comme SSO avec MFA via un wrapper comme `aws-vault`, augmentez la limite en millisecondes avec [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/fr/env-vars)687* Si votre chaîne exécute une connexion interactive qui a légitimement besoin de plus de 60 secondes, comme SSO avec MFA via un wrapper comme `aws-vault`, augmentez la limite en millisecondes avec [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/fr/env-vars)
688 688
689<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">
690 Erreurs de réseau et de connexion690 Erreurs de réseau et de connexion
712**Que faire :**712**Que faire :**
713 713
714* Confirmez que vous pouvez atteindre l'hôte API depuis le même shell en exécutant `curl -I https://api.anthropic.com`. Sur Windows PowerShell, utilisez `curl.exe -I https://api.anthropic.com` pour que l'alias `Invoke-WebRequest` intégré ne soit pas utilisé.714* Confirmez que vous pouvez atteindre l'hôte API depuis le même shell en exécutant `curl -I https://api.anthropic.com`. Sur Windows PowerShell, utilisez `curl.exe -I https://api.anthropic.com` pour que l'alias `Invoke-WebRequest` intégré ne soit pas utilisé.
715* Si vous êtes derrière un proxy d'entreprise, définissez `HTTPS_PROXY` avant de lancer Claude Code et consultez [Configuration réseau](/fr/network-config)715* Si vous êtes derrière un proxy d'entreprise, définissez `HTTPS_PROXY` avant de lancer Claude Code et consultez [Configuration réseau](/docs/fr/network-config)
716* Si vous routez via une passerelle LLM ou un relais, définissez [`ANTHROPIC_BASE_URL`](/fr/env-vars) sur son adresse. Consultez [Connecter Claude Code à une passerelle LLM](/fr/llm-gateway-connect) pour la configuration.716* Si vous routez via une passerelle LLM ou un relais, définissez [`ANTHROPIC_BASE_URL`](/docs/fr/env-vars) sur son adresse. Consultez [Connecter Claude Code à une passerelle LLM](/docs/fr/llm-gateway-connect) pour la configuration.
717* Assurez-vous que votre pare-feu autorise les hôtes listés dans [Exigences d'accès réseau](/fr/network-config#network-access-requirements)717* Assurez-vous que votre pare-feu autorise les hôtes listés dans [Exigences d'accès réseau](/docs/fr/network-config#network-access-requirements)
718* Les défaillances intermittentes sont [réessayées automatiquement](#automatic-retries) ; les défaillances persistantes indiquent un problème réseau local718* Les défaillances intermittentes sont [réessayées automatiquement](#automatic-retries) ; les défaillances persistantes indiquent un problème réseau local
719 719
720Si `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 :720Si `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 :
727 La réponse de streaming Bedrock a un content-type inattendu727 La réponse de streaming Bedrock a un content-type inattendu
728</h3>728</h3>
729 729
730Une passerelle ou un proxy entre Claude Code et [Amazon Bedrock](/fr/amazon-bedrock) transforme le corps de la réponse de streaming ou son en-tête `Content-Type`. Amazon Bedrock diffuse les réponses en tant que `application/vnd.amazon.eventstream`, et Claude Code rejette une réponse de streaming réussie qui signale un content-type différent au lieu de décoder un corps qu'il ne peut pas lire. La requête n'est pas réessayée.730Une passerelle ou un proxy entre Claude Code et [Amazon Bedrock](/docs/fr/amazon-bedrock) transforme le corps de la réponse de streaming ou son en-tête `Content-Type`. Amazon Bedrock diffuse les réponses en tant que `application/vnd.amazon.eventstream`, et Claude Code rejette une réponse de streaming réussie qui signale un content-type différent au lieu de décoder un corps qu'il ne peut pas lire. La requête n'est pas réessayée.
731 731
732```text theme={null}732```text theme={null}
733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
734```734```
735 735
736{/* min-version: 2.1.208 */}Avant la v2.1.208, la même mauvaise configuration s'affichait sous la forme `API Error: Truncated event message received` après que la réponse entière ait été mise en mémoire tampon.736Avant la v2.1.208, la même mauvaise configuration s'affichait sous la forme `API Error: Truncated event message received` après que la réponse entière ait été mise en mémoire tampon.
737 737
738**Que faire :**738**Que faire :**
739 739
740* Configurez la passerelle pour transmettre le corps de la réponse `InvokeModelWithResponseStream` et son en-tête `Content-Type` sans modification. Un intermédiaire qui réemet le flux sous forme d'événements envoyés par le serveur est une cause courante.740* Configurez la passerelle pour transmettre le corps de la réponse `InvokeModelWithResponseStream` et son en-tête `Content-Type` sans modification. Un intermédiaire qui réemet le flux sous forme d'événements envoyés par le serveur est une cause courante.
741* Si la passerelle réécrit uniquement l'en-tête et transmet le corps binaire intact, définissez [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/fr/env-vars) pour ignorer la vérification jusqu'à ce que la passerelle soit corrigée. Consultez [Erreurs de streaming derrière une passerelle ou un proxy](/fr/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).741* Si la passerelle réécrit uniquement l'en-tête et transmet le corps binaire intact, définissez [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/fr/env-vars) pour ignorer la vérification jusqu'à ce que la passerelle soit corrigée. Consultez [Erreurs de streaming derrière une passerelle ou un proxy](/docs/fr/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
742 742
743<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">
744 Erreurs de certificat SSL744 Erreurs de certificat SSL
751Unable to connect to API: Self-signed certificate detected751Unable to connect to API: Self-signed certificate detected
752```752```
753 753
754{/* min-version: 2.1.199 */}À partir de la v2.1.199, une défaillance de validation de certificat n'est pas réessayée, donc cette erreur apparaît à la première tentative au lieu d'après le [budget de retry](#automatic-retries) complet. Les versions antérieures ont passé quelques minutes à réessayer avant de l'afficher. Les conditions TLS transitoires, telles qu'un délai d'expiration de poignée de main, sont toujours réessayées.754À partir de la v2.1.199, une défaillance de validation de certificat n'est pas réessayée, donc cette erreur apparaît à la première tentative au lieu d'après le [budget de retry](#automatic-retries) complet. Les versions antérieures ont passé quelques minutes à réessayer avant de l'afficher. Les conditions TLS transitoires, telles qu'un délai d'expiration de poignée de main, sont toujours réessayées.
755 755
756Pendant `/login` et la vérification de connectivité au démarrage, la même défaillance est signalée avec le code OpenSSL et le correctif en ligne :756Pendant `/login` et la vérification de connectivité au démarrage, la même défaillance est signalée avec le code OpenSSL et le correctif en ligne :
757 757
762**Que faire :**762**Que faire :**
763 763
764* Exportez le bundle CA de votre organisation et pointez Claude Code dessus avec `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`764* Exportez le bundle CA de votre organisation et pointez Claude Code dessus avec `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`
765* Consultez [Configuration réseau](/fr/network-config#custom-ca-certificates) pour les instructions de configuration complètes765* Consultez [Configuration réseau](/docs/fr/network-config#custom-ca-certificates) pour les instructions de configuration complètes
766* Ne définissez pas `NODE_TLS_REJECT_UNAUTHORIZED=0`, qui désactive entièrement la validation de certificat766* Ne définissez pas `NODE_TLS_REJECT_UNAUTHORIZED=0`, qui désactive entièrement la validation de certificat
767 767
768<h3 id="host-not-allowed-in-a-cloud-session">768<h3 id="host-not-allowed-in-a-cloud-session">
778 778
779Vous pouvez également voir un certificat TLS qui ne correspond pas au certificat réel de la destination. L'environnement cloud route le trafic sortant via un proxy qui applique la politique réseau, donc un certificat non correspondant signifie que le proxy a terminé la connexion, pas la destination.779Vous pouvez également voir un certificat TLS qui ne correspond pas au certificat réel de la destination. L'environnement cloud route le trafic sortant via un proxy qui applique la politique réseau, donc un certificat non correspondant signifie que le proxy a terminé la connexion, pas la destination.
780 780
781Ce n'est pas un problème réseau côté client. Les sessions cloud et les [routines](/fr/routines) s'exécutent dans un environnement en sandbox dont le trafic sortant est filtré selon la liste d'autorisation de l'environnement. L'environnement **Default** utilise l'accès **Trusted**, qui autorise la [liste d'autorisation par défaut](/fr/claude-code-on-the-web#default-allowed-domains) des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants, mais bloque tout le reste.781Ce n'est pas un problème réseau côté client. Les sessions cloud et les [routines](/docs/fr/routines) s'exécutent dans un environnement en sandbox dont le trafic sortant est filtré selon la liste d'autorisation de l'environnement. L'environnement **Default** utilise l'accès **Trusted**, qui autorise la [liste d'autorisation par défaut](/docs/fr/claude-code-on-the-web#default-allowed-domains) des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants, mais bloque tout le reste.
782 782
783**Que faire :**783**Que faire :**
784 784
785* Ouvrez la routine pour la modifier, ou démarrez une session cloud. Sélectionnez l'icône cloud affichant le nom de votre environnement, tel que **Default**, pour ouvrir le sélecteur. Survolez votre environnement et cliquez sur l'icône des paramètres.785* Ouvrez la routine pour la modifier, ou démarrez une session cloud. Sélectionnez l'icône cloud affichant le nom de votre environnement, tel que **Default**, pour ouvrir le sélecteur. Survolez votre environnement et cliquez sur l'icône des paramètres.
786* Dans la boîte de dialogue **Update cloud environment**, changez **Network access** de **Trusted** à **Custom**, puis ajoutez le domaine bloqué à **Allowed domains**. Entrez un domaine par ligne. Cochez **Also include default list of common package managers** pour conserver la [liste d'autorisation par défaut](/fr/claude-code-on-the-web#default-allowed-domains) aux côtés de vos domaines personnalisés. Sélectionnez **Full** à la place si vous souhaitez un accès sans restriction.786* Dans la boîte de dialogue **Update cloud environment**, changez **Network access** de **Trusted** à **Custom**, puis ajoutez le domaine bloqué à **Allowed domains**. Entrez un domaine par ligne. Cochez **Also include default list of common package managers** pour conserver la [liste d'autorisation par défaut](/docs/fr/claude-code-on-the-web#default-allowed-domains) aux côtés de vos domaines personnalisés. Sélectionnez **Full** à la place si vous souhaitez un accès sans restriction.
787* Cliquez sur **Save changes**. La prochaine exécution utilise la liste d'autorisation mise à jour.787* Cliquez sur **Save changes**. La prochaine exécution utilise la liste d'autorisation mise à jour.
788 788
789Consultez [Network access](/fr/claude-code-on-the-web#network-access) pour les niveaux d'accès et la liste d'autorisation par défaut. Les sessions CLI locales ne sont pas affectées par cette politique.789Consultez [Network access](/docs/fr/claude-code-on-the-web#network-access) pour les niveaux d'accès et la liste d'autorisation par défaut. Les sessions CLI locales ne sont pas affectées par cette politique.
790 790
791<h3 id="couldnt-reconnect-to-your-remote-control-session">791<h3 id="couldnt-reconnect-to-your-remote-control-session">
792 Impossible de se reconnecter à votre session Remote Control792 Impossible de se reconnecter à votre session Remote Control
796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
797```797```
798 798
799La reprise avec `claude --resume` ou `claude --continue` se reconnecte à la session [Remote Control](/fr/remote-control) enregistrée dans cette conversation. Ce message signifie que la reconnexion a échoué pour une raison qui peut être temporaire, telle qu'une interruption réseau ou une erreur serveur, donc Claude Code ne peut pas confirmer si la session distante existe toujours. Votre session locale continue de s'exécuter sans Remote Control.799La reprise avec `claude --resume` ou `claude --continue` se reconnecte à la session [Remote Control](/docs/fr/remote-control) enregistrée dans cette conversation. Ce message signifie que la reconnexion a échoué pour une raison qui peut être temporaire, telle qu'une interruption réseau ou une erreur serveur, donc Claude Code ne peut pas confirmer si la session distante existe toujours. Votre session locale continue de s'exécuter sans Remote Control.
800 800
801**Que faire :**801**Que faire :**
802 802
803* Exécutez `/remote-control` pour réessayer la connexion803* Exécutez `/remote-control` pour réessayer la connexion
804* Démarrez Claude Code sans `--resume` pour créer une nouvelle session Remote Control804* Démarrez Claude Code sans `--resume` pour créer une nouvelle session Remote Control
805* Pour les autres messages de démarrage Remote Control, consultez [Dépanner Remote Control](/fr/remote-control#troubleshooting)805* Pour les autres messages de démarrage Remote Control, consultez [Dépanner Remote Control](/docs/fr/remote-control#troubleshooting)
806 806
807Vous ne verrez pas ce message lorsque le serveur confirme que la session précédente n'existe plus ; Claude Code en crée une nouvelle dans ce cas. {/* min-version: 2.1.200 */}Avant la v2.1.200, toute défaillance de reconnexion créait une nouvelle session Remote Control, ce qui laissait des sessions supplémentaires dans la liste des sessions sur claude.ai/code.807Vous ne verrez pas ce message lorsque le serveur confirme que la session précédente n'existe plus ; Claude Code en crée une nouvelle dans ce cas. Avant la v2.1.200, toute défaillance de reconnexion créait une nouvelle session Remote Control, ce qui laissait des sessions supplémentaires dans la liste des sessions sur claude.ai/code.
808 808
809<h2 id="request-errors">809<h2 id="request-errors">
810 Erreurs de requête810 Erreurs de requête
827* Exécutez `/compact` pour résumer les tours précédents et libérer de l'espace, ou `/clear` pour recommencer à zéro827* Exécutez `/compact` pour résumer les tours précédents et libérer de l'espace, ou `/clear` pour recommencer à zéro
828* Exécutez `/context` pour voir une ventilation de ce qui consomme la fenêtre : prompt système, outils, fichiers mémoire et messages828* Exécutez `/context` pour voir une ventilation de ce qui consomme la fenêtre : prompt système, outils, fichiers mémoire et messages
829* Désactivez les serveurs MCP que vous n'utilisez pas avec `/mcp disable <name>` pour supprimer leurs définitions d'outils du contexte829* Désactivez les serveurs MCP que vous n'utilisez pas avec `/mcp disable <name>` pour supprimer leurs définitions d'outils du contexte
830* Réduisez les fichiers mémoire `CLAUDE.md` volumineux, ou déplacez les instructions dans les [règles limitées au chemin](/fr/memory#path-specific-rules) qui se chargent uniquement lorsqu'elles sont pertinentes830* Réduisez les fichiers mémoire `CLAUDE.md` volumineux, ou déplacez les instructions dans les [règles limitées au chemin](/docs/fr/memory#path-specific-rules) qui se chargent uniquement lorsqu'elles sont pertinentes
831* Les sous-agents héritent de chaque définition d'outil MCP de la session parent, ce qui peut remplir leur fenêtre de contexte avant le premier tour. Désactivez les serveurs MCP que vous n'utilisez pas avant de générer des sous-agents.831* Les sous-agents héritent de chaque définition d'outil MCP de la session parent, ce qui peut remplir leur fenêtre de contexte avant le premier tour. Désactivez les serveurs MCP que vous n'utilisez pas avant de générer des sous-agents.
832* L'auto-compact est activé par défaut et empêche normalement cette erreur. Si vous avez défini [`DISABLE_AUTO_COMPACT`](/fr/env-vars), réactivez-le ou exécutez `/compact` manuellement avant que la fenêtre ne se remplisse.832* L'auto-compact est activé par défaut et empêche normalement cette erreur. Si vous avez défini [`DISABLE_AUTO_COMPACT`](/docs/fr/env-vars), réactivez-le ou exécutez `/compact` manuellement avant que la fenêtre ne se remplisse.
833 833
834Consultez [Explorez la fenêtre de contexte](/fr/context-window) pour une vue interactive de la façon dont le contexte se remplit.834Consultez [Explorez la fenêtre de contexte](/docs/fr/context-window) pour une vue interactive de la façon dont le contexte se remplit.
835 835
836<h3 id="error-during-compaction-conversation-too-long">836<h3 id="error-during-compaction-conversation-too-long">
837 Erreur lors de la compaction : Conversation trop longue837 Erreur lors de la compaction : Conversation trop longue
879API Error: 400 ... image dimensions exceed max allowed size879API Error: 400 ... image dimensions exceed max allowed size
880```880```
881 881
882{/* min-version: 2.1.142 */}Claude Code remplace l'image non traitée par un espace réservé textuel et réessaie, de sorte que les messages suivants réussissent. Sur les versions antérieures à 2.1.142, une image collée pouvait rester dans la conversation et répéter la même erreur à chaque message suivant. Pour récupérer sur ces versions, appuyez deux fois sur Échap et revenez en arrière au-delà du tour où l'image a été ajoutée.882Claude Code remplace l'image non traitée par un espace réservé textuel et réessaie, de sorte que les messages suivants réussissent. Sur les versions antérieures à 2.1.142, une image collée pouvait rester dans la conversation et répéter la même erreur à chaque message suivant. Pour récupérer sur ces versions, appuyez deux fois sur Échap et revenez en arrière au-delà du tour où l'image a été ajoutée.
883 883
884**À faire :**884**À faire :**
885 885
939 939
940**À faire :**940**À faire :**
941 941
942* Configurez votre passerelle pour transférer l'en-tête `anthropic-beta`. Consultez [feature pass-through](/fr/llm-gateway-protocol#feature-pass-through) pour savoir ce que les passerelles doivent transférer.942* Configurez votre passerelle pour transférer l'en-tête `anthropic-beta`. Consultez [feature pass-through](/docs/fr/llm-gateway-protocol#feature-pass-through) pour savoir ce que les passerelles doivent transférer.
943* En dernier recours, définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/fr/env-vars) avant de lancer. Cela désactive les fonctionnalités qui nécessitent l'en-tête bêta afin que les requêtes réussissent via une passerelle qui ne peut pas le transférer.943* En dernier recours, définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/fr/env-vars) avant de lancer. Cela désactive les fonctionnalités qui nécessitent l'en-tête bêta afin que les requêtes réussissent via une passerelle qui ne peut pas le transférer.
944 944
945<h3 id="theres-an-issue-with-the-selected-model">945<h3 id="theres-an-issue-with-the-selected-model">
946 Il y a un problème avec le modèle sélectionné946 Il y a un problème avec le modèle sélectionné
955**À faire :**955**À faire :**
956 956
957* **CLI interactif** : exécutez `/model` pour choisir parmi les modèles disponibles pour votre compte.957* **CLI interactif** : exécutez `/model` pour choisir parmi les modèles disponibles pour votre compte.
958* **Mode non interactif (`-p`)** : passez `--model` avec un alias ou un ID valide, ou définissez [`ANTHROPIC_MODEL`](/fr/env-vars). Le texte d'erreur affiche `Run --model` sur cette surface.958* **Mode non interactif (`-p`)** : passez `--model` avec un alias ou un ID valide, ou définissez [`ANTHROPIC_MODEL`](/docs/fr/env-vars). Le texte d'erreur affiche `Run --model` sur cette surface.
959* **Agent SDK** : le texte d'erreur omet l'indice car le modèle est défini par programmation. Définissez [`model` sur `Options`](/fr/agent-sdk/typescript#options) en TypeScript ou [`ClaudeAgentOptions(model=...)`](/fr/agent-sdk/python#claudeagentoptions) en Python, et gérez l'erreur structurée `model_not_found` pour afficher votre propre retry ou sélecteur de modèle.959* **Agent SDK** : le texte d'erreur omet l'indice car le modèle est défini par programmation. Définissez [`model` sur `Options`](/docs/fr/agent-sdk/typescript#options) en TypeScript ou [`ClaudeAgentOptions(model=...)`](/docs/fr/agent-sdk/python#claudeagentoptions) en Python, et gérez l'erreur structurée `model_not_found` pour afficher votre propre retry ou sélecteur de modèle.
960* Utilisez un alias tel que `sonnet` ou `opus` au lieu d'un ID complet avec version. Les alias se résolvent en une valeur par défaut maintenue afin qu'ils ne deviennent pas obsolètes. Consultez [Configuration du modèle](/fr/model-config).960* Utilisez un alias tel que `sonnet` ou `opus` au lieu d'un ID complet avec version. Les alias se résolvent en une valeur par défaut maintenue afin qu'ils ne deviennent pas obsolètes. Consultez [Configuration du modèle](/docs/fr/model-config).
961* Si le mauvais modèle continue à revenir dans la CLI, un ID obsolète est défini quelque part. Vérifiez dans [l'ordre de priorité](/fr/model-config#setting-your-model) : l'indicateur `--model`, la variable d'environnement `ANTHROPIC_MODEL`, puis le champ `model` dans `.claude/settings.local.json`, le `.claude/settings.json` de votre projet, et `~/.claude/settings.json`. Supprimez la valeur obsolète et Claude Code revient à la valeur par défaut de votre compte.961* Si le mauvais modèle continue à revenir dans la CLI, un ID obsolète est défini quelque part. Vérifiez dans [l'ordre de priorité](/docs/fr/model-config#setting-your-model) : l'indicateur `--model`, la variable d'environnement `ANTHROPIC_MODEL`, puis le champ `model` dans `.claude/settings.local.json`, le `.claude/settings.json` de votre projet, et `~/.claude/settings.json`. Supprimez la valeur obsolète et Claude Code revient à la valeur par défaut de votre compte.
962* {/* min-version: 2.1.206 */}Claude Code signale une connexion claude.ai expirée comme [Connexion expirée](#login-expired), pas comme cette erreur. Avant v2.1.206, une connexion expirée qui ne pouvait plus être actualisée échouait avec chaque modèle avec cette erreur ; exécutez `/login` si vous voyez cela sur une version plus ancienne.962* Claude Code signale une connexion claude.ai expirée comme [Connexion expirée](#login-expired), pas comme cette erreur. Avant v2.1.206, une connexion expirée qui ne pouvait plus être actualisée échouait avec chaque modèle avec cette erreur ; exécutez `/login` si vous voyez cela sur une version plus ancienne.
963* Pour les déploiements Google Cloud's Agent Platform, consultez [Dépannage de Google Cloud's Agent Platform](/fr/google-vertex-ai#troubleshooting).963* Pour les déploiements Google Cloud's Agent Platform, consultez [Dépannage de Google Cloud's Agent Platform](/docs/fr/google-vertex-ai#troubleshooting).
964 964
965<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">
966 Le modèle n'est pas un ID de modèle reconnu966 Le modèle n'est pas un ID de modèle reconnu
974 974
975L'indice de fin nomme l'alias ou l'ID de modèle le plus proche. Lorsque rien n'est assez proche, il lit `Run /model to see available models.` à la place.975L'indice de fin nomme l'alias ou l'ID de modèle le plus proche. Lorsque rien n'est assez proche, il lit `Run /model to see available models.` à la place.
976 976
977Claude Code produit cette erreur localement au moment où le changement est demandé, avant toute requête API. Elle s'applique lorsqu'un modèle est défini via la méthode [Agent SDK](/fr/agent-sdk/typescript) `setModel()` ou par une application telle que l'[application de bureau](/fr/desktop) qui exécute la CLI Claude Code pour vous.977Claude Code produit cette erreur localement au moment où le changement est demandé, avant toute requête API. Elle s'applique lorsqu'un modèle est défini via la méthode [Agent SDK](/docs/fr/agent-sdk/typescript) `setModel()` ou par une application telle que l'[application de bureau](/docs/fr/desktop) qui exécute la CLI Claude Code pour vous.
978 978
979**À faire :**979**À faire :**
980 980
981* Exécutez `/model` sans argument pour ouvrir le sélecteur et choisir parmi les modèles disponibles pour votre compte, puis transmettez l'alias ou l'ID affiché là981* Exécutez `/model` sans argument pour ouvrir le sélecteur et choisir parmi les modèles disponibles pour votre compte, puis transmettez l'alias ou l'ID affiché là
982* Si vous avez utilisé un alias qu'une version plus récente de Claude Code supporte, exécutez `claude update`. Un ID complet qui commence par `claude-` réussit cette vérification même lorsque le modèle est plus récent que votre version de Claude Code, donc la mise à niveau n'est pas nécessaire pour ceux-ci.982* Si vous avez utilisé un alias qu'une version plus récente de Claude Code supporte, exécutez `claude update`. Un ID complet qui commence par `claude-` réussit cette vérification même lorsque le modèle est plus récent que votre version de Claude Code, donc la mise à niveau n'est pas nécessaire pour ceux-ci.
983* Un modèle enregistré avant v2.1.200 n'est pas réparé par cette vérification. Si une valeur obsolète continue à revenir, supprimez-la des emplacements listés sous [Il y a un problème avec le modèle sélectionné](#theres-an-issue-with-the-selected-model).983* Un modèle enregistré avant v2.1.200 n'est pas réparé par cette vérification. Si une valeur obsolète continue à revenir, supprimez-la des emplacements listés sous [Il y a un problème avec le modèle sélectionné](#theres-an-issue-with-the-selected-model).
984* La vérification s'exécute uniquement sur l'API Anthropic. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/fr/claude-platform-on-aws), et derrière une [passerelle LLM](/fr/llm-gateway) ou une `ANTHROPIC_BASE_URL` personnalisée, votre fournisseur ou passerelle définit les noms de modèles, de sorte que Claude Code accepte n'importe quelle chaîne et la transmet.984* La vérification s'exécute uniquement sur l'API Anthropic. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), et derrière une [passerelle LLM](/docs/fr/llm-gateway) ou une `ANTHROPIC_BASE_URL` personnalisée, votre fournisseur ou passerelle définit les noms de modèles, de sorte que Claude Code accepte n'importe quelle chaîne et la transmet.
985 985
986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">
987 Claude Opus n'est pas disponible avec le plan Claude Pro987 Claude Opus n'est pas disponible avec le plan Claude Pro
1003 Le modèle est restreint par les paramètres de votre organisation1003 Le modèle est restreint par les paramètres de votre organisation
1004</h3>1004</h3>
1005 1005
1006Votre administrateur d'organisation a désactivé ce modèle dans la console d'administration claude.ai, ou il est exclu par une liste d'autorisation [`availableModels`](/fr/model-config#restrict-model-selection) dans les paramètres gérés. Lorsque le modèle restreint a été défini avec `--model`, `ANTHROPIC_MODEL`, ou le paramètre `model`, Claude Code substitue un modèle autorisé et continue. Taper `/model <name>` pour un modèle restreint est rejeté avec `Run /model to choose a different model.` et la session conserve son modèle actuel.1006Votre administrateur d'organisation a désactivé ce modèle dans la console d'administration claude.ai, ou il est exclu par une liste d'autorisation [`availableModels`](/docs/fr/model-config#restrict-model-selection) dans les paramètres gérés. Lorsque le modèle restreint a été défini avec `--model`, `ANTHROPIC_MODEL`, ou le paramètre `model`, Claude Code substitue un modèle autorisé et continue. Taper `/model <name>` pour un modèle restreint est rejeté avec `Run /model to choose a different model.` et la session conserve son modèle actuel.
1007 1007
1008```text theme={null}1008```text theme={null}
1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
1010```1010```
1011 1011
1012Claude Code traite un alias de famille de modèles, l'un de `opus`, `sonnet`, `haiku`, ou `fable`, comme une demande de cette famille plutôt que de sa version la plus récente. Sur l'API Anthropic et sur [Claude Platform on AWS](/fr/claude-platform-on-aws), un alias de famille restreint se résout à la version la plus récente de la famille que votre organisation et la liste d'autorisation `availableModels` permettent, et l'avis de substitution nomme cette version. Claude Code rejette `/model <alias>` uniquement lorsque chaque version de la famille est restreinte. Avant v2.1.205, un alias de famille était substitué ou rejeté en fonction de sa version la plus récente seule, même lorsqu'une version plus ancienne de la même famille était autorisée.1012Claude Code traite un alias de famille de modèles, l'un de `opus`, `sonnet`, `haiku`, ou `fable`, comme une demande de cette famille plutôt que de sa version la plus récente. Sur l'API Anthropic et sur [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), un alias de famille restreint se résout à la version la plus récente de la famille que votre organisation et la liste d'autorisation `availableModels` permettent, et l'avis de substitution nomme cette version. Claude Code rejette `/model <alias>` uniquement lorsque chaque version de la famille est restreinte. Avant v2.1.205, un alias de famille était substitué ou rejeté en fonction de sa version la plus récente seule, même lorsqu'une version plus ancienne de la même famille était autorisée.
1013 1013
1014**À faire :**1014**À faire :**
1015 1015
1016* Exécutez `/model` pour choisir parmi les modèles que votre organisation autorise. Les modèles restreints sont masqués du sélecteur.1016* Exécutez `/model` pour choisir parmi les modèles que votre organisation autorise. Les modèles restreints sont masqués du sélecteur.
1017* Si le modèle restreint a été défini dans `--model`, `ANTHROPIC_MODEL`, ou le champ `model` d'un fichier de paramètres, supprimez ou mettez à jour cette valeur afin que l'avis ne se reproduise pas à chaque lancement1017* Si le modèle restreint a été défini dans `--model`, `ANTHROPIC_MODEL`, ou le champ `model` d'un fichier de paramètres, supprimez ou mettez à jour cette valeur afin que l'avis ne se reproduise pas à chaque lancement
1018* Si vous avez besoin d'accès au modèle restreint, demandez à votre administrateur d'organisation de l'activer. Consultez [Restrictions de modèle d'organisation](/fr/model-config#organization-model-restrictions).1018* Si vous avez besoin d'accès au modèle restreint, demandez à votre administrateur d'organisation de l'activer. Consultez [Restrictions de modèle d'organisation](/docs/fr/model-config#organization-model-restrictions).
1019 1019
1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">
1021 thinking.type.enabled n'est pas supporté pour ce modèle1021 thinking.type.enabled n'est pas supporté pour ce modèle
1031 1031
1032* Exécutez `claude update` et redémarrez Claude Code. Opus 4.7 nécessite v2.1.111 ou ultérieur. Opus 4.8 nécessite v2.1.154 ou ultérieur. Sonnet 5 nécessite v2.1.197 ou ultérieur1032* Exécutez `claude update` et redémarrez Claude Code. Opus 4.7 nécessite v2.1.111 ou ultérieur. Opus 4.8 nécessite v2.1.154 ou ultérieur. Sonnet 5 nécessite v2.1.197 ou ultérieur
1033* Si vous ne pouvez pas mettre à niveau, exécutez `/model` et sélectionnez Opus 4.6 ou Sonnet 4.6 à la place1033* Si vous ne pouvez pas mettre à niveau, exécutez `/model` et sélectionnez Opus 4.6 ou Sonnet 4.6 à la place
1034* {/* min-version: agent-sdk@0.3.197 */}Si vous rencontrez ceci dans l'[Agent SDK](/fr/agent-sdk/overview), mettez à niveau le package SDK à la place. Opus 4.8 nécessite TypeScript SDK v0.3.154 ou ultérieur et Python SDK v0.2.88 ou ultérieur. Sonnet 5 nécessite TypeScript SDK v0.3.197 ou ultérieur1034* Si vous rencontrez ceci dans l'[Agent SDK](/docs/fr/agent-sdk/overview), mettez à niveau le package SDK à la place. Opus 4.8 nécessite TypeScript SDK v0.3.154 ou ultérieur et Python SDK v0.2.88 ou ultérieur. Sonnet 5 nécessite TypeScript SDK v0.3.197 ou ultérieur
1035 1035
1036<h3 id="thinking-budget-exceeds-output-limit">1036<h3 id="thinking-budget-exceeds-output-limit">
1037 Le budget de réflexion dépasse la limite de sortie1037 Le budget de réflexion dépasse la limite de sortie
1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
1044```1044```
1045 1045
1046Claude Code ajuste ces valeurs automatiquement sur l'API Anthropic. Vous voyez généralement cette erreur sur Amazon Bedrock ou Google Cloud's Agent Platform lorsque [`MAX_THINKING_TOKENS`](/fr/env-vars) est défini plus haut que la limite de sortie du fournisseur, ou lorsque le mode plan augmente le budget de réflexion.1046Claude Code ajuste ces valeurs automatiquement sur l'API Anthropic. Vous voyez généralement cette erreur sur Amazon Bedrock ou Google Cloud's Agent Platform lorsque [`MAX_THINKING_TOKENS`](/docs/fr/env-vars) est défini plus haut que la limite de sortie du fournisseur, ou lorsque le mode plan augmente le budget de réflexion.
1047 1047
1048**À faire :**1048**À faire :**
1049 1049
1050* Abaissez `MAX_THINKING_TOKENS`, ou augmentez [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/fr/env-vars) au-dessus du budget de réflexion1050* Abaissez `MAX_THINKING_TOKENS`, ou augmentez [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/fr/env-vars) au-dessus du budget de réflexion
1051* Consultez [Réflexion étendue](/fr/model-config#extended-thinking) pour savoir comment le budget interagit avec la longueur de sortie1051* Consultez [Réflexion étendue](/docs/fr/model-config#extended-thinking) pour savoir comment le budget interagit avec la longueur de sortie
1052 1052
1053<h3 id="tool-use-or-thinking-block-mismatch">1053<h3 id="tool-use-or-thinking-block-mismatch">
1054 Décalage de bloc d'utilisation d'outil ou de réflexion1054 Décalage de bloc d'utilisation d'outil ou de réflexion
1066 1066
1067**À faire :**1067**À faire :**
1068 1068
1069* {/* max-version: 2.1.155 */}Si vous utilisez Opus 4.7 ou Opus 4.8, exécutez d'abord `claude update`. Les versions antérieures à v2.1.156 peuvent déclencher cette erreur lors de l'utilisation normale d'outils, et `/rewind` ne la supprime pas.1069* Si vous utilisez Opus 4.7 ou Opus 4.8, exécutez d'abord `claude update`. Les versions antérieures à v2.1.156 peuvent déclencher cette erreur lors de l'utilisation normale d'outils, et `/rewind` ne la supprime pas.
1070* Exécutez `/rewind`, ou appuyez deux fois sur Échap, pour revenir à un point de contrôle avant le tour corrompu et continuer à partir de là. Consultez [Points de contrôle](/fr/checkpointing) pour savoir comment les points de contrôle sont créés et restaurés.1070* Exécutez `/rewind`, ou appuyez deux fois sur Échap, pour revenir à un point de contrôle avant le tour corrompu et continuer à partir de là. Consultez [Points de contrôle](/docs/fr/checkpointing) pour savoir comment les points de contrôle sont créés et restaurés.
1071 1071
1072<h3 id="usage-policy-refusal">1072<h3 id="usage-policy-refusal">
1073 Refus de la politique d'utilisation1073 Refus de la politique d'utilisation
1079API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.1079API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.
1080```1080```
1081 1081
1082La vérification évalue la conversation complète, pas seulement votre dernier prompt, de sorte que l'envoi d'un nouveau message dans la même session réactive généralement le même refus. Il en va de même après la sortie et la réouverture de la session avec `--continue` ou `--resume`, puisque la transcription sur disque contient toujours le contenu déclencheur. Sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), et [Microsoft Foundry](/fr/microsoft-foundry), ce message couvre également les requêtes que les mesures de sécurité du modèle ont signalées comme un sujet de cybersécurité. Consultez [Les mesures de sécurité ont signalé un sujet de cybersécurité](#safety-measures-flagged-a-cybersecurity-topic).1082La vérification évalue la conversation complète, pas seulement votre dernier prompt, de sorte que l'envoi d'un nouveau message dans la même session réactive généralement le même refus. Il en va de même après la sortie et la réouverture de la session avec `--continue` ou `--resume`, puisque la transcription sur disque contient toujours le contenu déclencheur. Sur [Amazon Bedrock](/docs/fr/amazon-bedrock), [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai), et [Microsoft Foundry](/docs/fr/microsoft-foundry), ce message couvre également les requêtes que les mesures de sécurité du modèle ont signalées comme un sujet de cybersécurité. Consultez [Les mesures de sécurité ont signalé un sujet de cybersécurité](#safety-measures-flagged-a-cybersecurity-topic).
1083 1083
1084**À faire :**1084**À faire :**
1085 1085
1086* Appuyez deux fois sur Échap ou exécutez `/rewind` pour revenir à un point de contrôle avant le tour qui a déclenché le refus, puis reformulez ou adoptez une approche différente. Consultez [Points de contrôle](/fr/checkpointing).1086* Appuyez deux fois sur Échap ou exécutez `/rewind` pour revenir à un point de contrôle avant le tour qui a déclenché le refus, puis reformulez ou adoptez une approche différente. Consultez [Points de contrôle](/docs/fr/checkpointing).
1087* Si vous ne pouvez pas identifier quel tour l'a causé, exécutez `/clear` pour démarrer une nouvelle conversation dans le même projet. Votre conversation précédente est conservée sur disque et reste disponible dans `/resume`.1087* Si vous ne pouvez pas identifier quel tour l'a causé, exécutez `/clear` pour démarrer une nouvelle conversation dans le même projet. Votre conversation précédente est conservée sur disque et reste disponible dans `/resume`.
1088* En [mode non interactif](/fr/headless) (`-p`), où la rembobinage n'est pas disponible, réessayez avec un prompt reformulé dans une nouvelle session sans `--continue`. Les vérifications de politique varient selon le modèle, de sorte que le passage à un modèle différent avec `--model` peut également résoudre le refus dans certains cas.1088* En [mode non interactif](/docs/fr/headless) (`-p`), où la rembobinage n'est pas disponible, réessayez avec un prompt reformulé dans une nouvelle session sans `--continue`. Les vérifications de politique varient selon le modèle, de sorte que le passage à un modèle différent avec `--model` peut également résoudre le refus dans certains cas.
1089 1089
1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">
1091 Les mesures de sécurité ont signalé un sujet de cybersécurité1091 Les mesures de sécurité ont signalé un sujet de cybersécurité
1103 1103
1104Ce que vous voyez dépend de votre fournisseur et de votre mode :1104Ce que vous voyez dépend de votre fournisseur et de votre mode :
1105 1105
1106* Sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), et [Microsoft Foundry](/fr/microsoft-foundry), un drapeau de cybersécurité produit le message [Refus de la politique d'utilisation](#usage-policy-refusal) à la place.1106* Sur [Amazon Bedrock](/docs/fr/amazon-bedrock), [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai), et [Microsoft Foundry](/docs/fr/microsoft-foundry), un drapeau de cybersécurité produit le message [Refus de la politique d'utilisation](#usage-policy-refusal) à la place.
1107* [Le mode non interactif](/fr/headless) omet la phrase `/feedback`.1107* [Le mode non interactif](/docs/fr/headless) omet la phrase `/feedback`.
1108 1108
1109{/* max-version: 2.1.202 */}Avant v2.1.203, le message lisait `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` suivi d'un lien de formulaire d'exemption.1109Avant v2.1.203, le message lisait `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` suivi d'un lien de formulaire d'exemption.
1110 1110
1111**À faire :**1111**À faire :**
1112 1112
1113* Si votre travail nécessite ce contenu, demandez l'accès via le [Programme de vérification de la cybersécurité](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)1113* Si votre travail nécessite ce contenu, demandez l'accès via le [Programme de vérification de la cybersécurité](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)
1114* Si votre requête n'était pas sur un sujet de cybersécurité, exécutez `/feedback` pour signaler le faux positif1114* Si votre requête n'était pas sur un sujet de cybersécurité, exécutez `/feedback` pour signaler le faux positif
1115* Pour continuer à travailler dans la même session, appuyez deux fois sur Échap ou exécutez `/rewind` pour revenir à un point de contrôle avant le tour qui a déclenché le drapeau, puis adoptez une approche différente. Consultez [Points de contrôle](/fr/checkpointing).1115* Pour continuer à travailler dans la même session, appuyez deux fois sur Échap ou exécutez `/rewind` pour revenir à un point de contrôle avant le tour qui a déclenché le drapeau, puis adoptez une approche différente. Consultez [Points de contrôle](/docs/fr/checkpointing).
1116 1116
1117<h2 id="installation-errors">1117<h2 id="installation-errors">
1118 Erreurs d'installation1118 Erreurs d'installation
1119</h2>1119</h2>
1120 1120
1121Ces erreurs apparaissent lors de l'installation ou de la mise à jour de Claude Code, à partir du [script d'installation](/fr/setup#install-claude-code), `claude install`, ou `claude update`. Pour les problèmes de `command not found`, PATH, permission et TLS lors de la configuration, consultez [Dépannage de l'installation et de la connexion](/fr/troubleshoot-install).1121Ces erreurs apparaissent lors de l'installation ou de la mise à jour de Claude Code, à partir du [script d'installation](/docs/fr/setup#install-claude-code), `claude install`, ou `claude update`. Pour les problèmes de `command not found`, PATH, permission et TLS lors de la configuration, consultez [Dépannage de l'installation et de la connexion](/docs/fr/troubleshoot-install).
1122 1122
1123<h3 id="installation-was-killed-before-it-could-finish">1123<h3 id="installation-was-killed-before-it-could-finish">
1124 L'installation a été interrompue avant de pouvoir se terminer1124 L'installation a été interrompue avant de pouvoir se terminer
1136**Que faire :**1136**Que faire :**
1137 1137
1138* Arrêtez les autres processus pour libérer de la mémoire, puis relancez le programme d'installation1138* Arrêtez les autres processus pour libérer de la mémoire, puis relancez le programme d'installation
1139* Ajoutez de l'espace d'échange ou passez à une instance plus grande. Consultez [Installation interrompue sur les serveurs Linux à faible mémoire](/fr/troubleshoot-install#install-killed-on-low-memory-linux-servers) pour les commandes de fichier d'échange.1139* Ajoutez de l'espace d'échange ou passez à une instance plus grande. Consultez [Installation interrompue sur les serveurs Linux à faible mémoire](/docs/fr/troubleshoot-install#install-killed-on-low-memory-linux-servers) pour les commandes de fichier d'échange.
1140 1140
1141<h3 id="the-connection-dropped-while-downloading-the-update">1141<h3 id="the-connection-dropped-while-downloading-the-update">
1142 La connexion s'est interrompue lors du téléchargement de la mise à jour1142 La connexion s'est interrompue lors du téléchargement de la mise à jour
1143</h3>1143</h3>
1144 1144
1145La connexion au serveur de téléchargement s'est fermée pendant que `claude install`, `claude update`, ou le [programme de mise à jour automatique](/fr/setup#auto-updates) récupérait le binaire Claude Code, et les tentatives n'ont pas récupéré. Claude Code réessaie le téléchargement quand la connexion s'interrompt, le transfert s'arrête, ou le fichier téléchargé échoue sa somme de contrôle, jusqu'à trois tentatives au total. Une erreur HTTP complétée, comme un 404, n'est pas réessayée car le serveur a déjà répondu. {/* min-version: 2.1.202 */}Avant la v2.1.202, une seule connexion interrompue échouait le téléchargement immédiatement avec l'erreur simple `aborted` au lieu de réessayer.1145La connexion au serveur de téléchargement s'est fermée pendant que `claude install`, `claude update`, ou le [programme de mise à jour automatique](/docs/fr/setup#auto-updates) récupérait le binaire Claude Code, et les tentatives n'ont pas récupéré. Claude Code réessaie le téléchargement quand la connexion s'interrompt, le transfert s'arrête, ou le fichier téléchargé échoue sa somme de contrôle, jusqu'à trois tentatives au total. Une erreur HTTP complétée, comme un 404, n'est pas réessayée car le serveur a déjà répondu. Avant la v2.1.202, une seule connexion interrompue échouait le téléchargement immédiatement avec l'erreur simple `aborted` au lieu de réessayer.
1146 1146
1147```text theme={null}1147```text theme={null}
1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
1157**Que faire :**1157**Que faire :**
1158 1158
1159* Exécutez `claude update` à nouveau. Sur un réseau par ailleurs sain, le téléchargement réussit généralement à la prochaine exécution. Pour le message d'expiration, exécutez-le à nouveau à partir d'un réseau plus rapide ou moins limité.1159* Exécutez `claude update` à nouveau. Sur un réseau par ailleurs sain, le téléchargement réussit généralement à la prochaine exécution. Pour le message d'expiration, exécutez-le à nouveau à partir d'un réseau plus rapide ou moins limité.
1160* Si votre réseau nécessite un proxy, définissez `HTTPS_PROXY` avant d'exécuter le programme d'installation ou `claude update`. Consultez [Vérifier la connectivité réseau](/fr/troubleshoot-install#check-network-connectivity).1160* Si votre réseau nécessite un proxy, définissez `HTTPS_PROXY` avant d'exécuter le programme d'installation ou `claude update`. Consultez [Vérifier la connectivité réseau](/docs/fr/troubleshoot-install#check-network-connectivity).
1161* Si un proxy d'entreprise continue de fermer le transfert, demandez à votre équipe réseau d'autoriser le téléchargement complet depuis `downloads.claude.ai`. Consultez [Exigences d'accès réseau](/fr/network-config#network-access-requirements).1161* Si un proxy d'entreprise continue de fermer le transfert, demandez à votre équipe réseau d'autoriser le téléchargement complet depuis `downloads.claude.ai`. Consultez [Exigences d'accès réseau](/docs/fr/network-config#network-access-requirements).
1162* Exécutez `claude doctor` à partir de votre shell pour les diagnostics d'installation1162* Exécutez `claude doctor` à partir de votre shell pour les diagnostics d'installation
1163 1163
1164<h2 id="command-line-errors">1164<h2 id="command-line-errors">
1171 Conflit entre --bg et --print1171 Conflit entre --bg et --print
1172</h3>1172</h3>
1173 1173
1174Ce message nécessite Claude Code v2.1.198 ou version ultérieure. Vous avez combiné `--bg` avec `-p` ou `--print` dans la même invocation `claude`. `--bg` démarre une [session en arrière-plan](/fr/agent-view#from-your-shell) à laquelle vous vous connectez ultérieurement avec `claude agents`, tandis que `--print` s'exécute [de manière non interactive](/fr/headless) et ne démarre jamais la session interactive à laquelle `claude agents` se connecte. Avant la v2.1.198, cette combinaison créait silencieusement une tâche en arrière-plan qui ne pouvait jamais être attachée.1174Ce message nécessite Claude Code v2.1.198 ou version ultérieure. Vous avez combiné `--bg` avec `-p` ou `--print` dans la même invocation `claude`. `--bg` démarre une [session en arrière-plan](/docs/fr/agent-view#from-your-shell) à laquelle vous vous connectez ultérieurement avec `claude agents`, tandis que `--print` s'exécute [de manière non interactive](/docs/fr/headless) et ne démarre jamais la session interactive à laquelle `claude agents` se connecte. Avant la v2.1.198, cette combinaison créait silencieusement une tâche en arrière-plan qui ne pouvait jamais être attachée.
1175 1175
1176```text theme={null}1176```text theme={null}
1177--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.1177--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.
1179 1179
1180**À faire :**1180**À faire :**
1181 1181
1182* Supprimez `-p` ou `--print`. `--bg` prend le prompt comme argument positionnel, donc `claude --bg "<task>"` est la commande complète. Voir [Dispatch new agents from your shell](/fr/agent-view#from-your-shell).1182* Supprimez `-p` ou `--print`. `--bg` prend le prompt comme argument positionnel, donc `claude --bg "<task>"` est la commande complète. Voir [Dispatch new agents from your shell](/docs/fr/agent-view#from-your-shell).
1183* Pour exécuter le prompt de manière non interactive et imprimer le résultat au lieu de créer une session en arrière-plan, supprimez `--bg` et exécutez `claude -p "<task>"`1183* Pour exécuter le prompt de manière non interactive et imprimer le résultat au lieu de créer une session en arrière-plan, supprimez `--bg` et exécutez `claude -p "<task>"`
1184 1184
1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
1186 La valeur --json-schema n'est pas un JSON Schema valide1186 La valeur --json-schema n'est pas un JSON Schema valide
1187</h3>1187</h3>
1188 1188
1189Le schéma que vous avez transmis à [`--json-schema`](/fr/cli-reference#cli-flags) en [mode non interactif](/fr/headless#get-structured-output) a échoué la compilation JSON Schema, donc `claude` se termine avec le code 1 au lieu d'exécuter le prompt. Avant la v2.1.205, un schéma invalide produisait une sortie non structurée sans erreur, et tout schéma utilisant le mot-clé `format` était traité comme invalide.1189Le schéma que vous avez transmis à [`--json-schema`](/docs/fr/cli-reference#cli-flags) en [mode non interactif](/docs/fr/headless#get-structured-output) a échoué la compilation JSON Schema, donc `claude` se termine avec le code 1 au lieu d'exécuter le prompt. Avant la v2.1.205, un schéma invalide produisait une sortie non structurée sans erreur, et tout schéma utilisant le mot-clé `format` était traité comme invalide.
1190 1190
1191```text theme={null}1191```text theme={null}
1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
1200 1200
1201* Corrigez la partie du schéma que le diagnostic nomme, puis réexécutez la commande1201* Corrigez la partie du schéma que le diagnostic nomme, puis réexécutez la commande
1202* Si le diagnostic est `schema too large`, réduisez l'imbrication du schéma et la réutilisation de `$ref`1202* Si le diagnostic est `schema too large`, réduisez l'imbrication du schéma et la réutilisation de `$ref`
1203* Voir [Get structured output](/fr/headless#get-structured-output) pour un schéma et une commande fonctionnels1203* Voir [Get structured output](/docs/fr/headless#get-structured-output) pour un schéma et une commande fonctionnels
1204 1204
1205<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">
1206 Impossible d'importer un serveur depuis Claude Desktop1206 Impossible d'importer un serveur depuis Claude Desktop
1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
1213```1213```
1214 1214
1215Le texte après le nom du serveur est la raison. La plus courante est la vérification du nom : Claude Desktop autorise les caractères dans les noms de serveurs, tels que les espaces et les points, que `claude mcp` restreint aux lettres, chiffres, traits d'union et traits de soulignement. D'autres raisons incluent une configuration de serveur qui échoue la validation et un serveur bloqué par la [politique MCP](/fr/managed-mcp) de votre organisation.1215Le texte après le nom du serveur est la raison. La plus courante est la vérification du nom : Claude Desktop autorise les caractères dans les noms de serveurs, tels que les espaces et les points, que `claude mcp` restreint aux lettres, chiffres, traits d'union et traits de soulignement. D'autres raisons incluent une configuration de serveur qui échoue la validation et un serveur bloqué par la [politique MCP](/docs/fr/managed-mcp) de votre organisation.
1216 1216
1217**À faire :**1217**À faire :**
1218 1218
1219* Renommez le serveur dans `claude_desktop_config.json` pour utiliser uniquement des lettres, des chiffres, des traits d'union et des traits de soulignement, puis exécutez `claude mcp add-from-claude-desktop` à nouveau1219* Renommez le serveur dans `claude_desktop_config.json` pour utiliser uniquement des lettres, des chiffres, des traits d'union et des traits de soulignement, puis exécutez `claude mcp add-from-claude-desktop` à nouveau
1220* Ajoutez ce serveur directement avec `claude mcp add` ou `claude mcp add-json` sous un nom valide. Voir [Import MCP servers from Claude Desktop](/fr/mcp#import-mcp-servers-from-claude-desktop).1220* Ajoutez ce serveur directement avec `claude mcp add` ou `claude mcp add-json` sous un nom valide. Voir [Import MCP servers from Claude Desktop](/docs/fr/mcp#import-mcp-servers-from-claude-desktop).
1221 1221
1222<h3 id="mcp-permission-prompt-tool-not-found">1222<h3 id="mcp-permission-prompt-tool-not-found">
1223 Outil de prompt de permission MCP introuvable1223 Outil de prompt de permission MCP introuvable
1224</h3>1224</h3>
1225 1225
1226L'outil que vous avez transmis à [`--permission-prompt-tool`](/fr/cli-reference#cli-flags) ne figurait pas parmi les outils MCP connectés lorsque l'exécution a d'abord eu besoin d'une décision de permission, soit parce que son serveur ne s'est jamais connecté, soit parce qu'aucun serveur connecté n'expose un outil portant ce nom. Claude Code envoie toujours votre prompt : l'exécution [non interactive](/fr/headless) se termine avec cette erreur et le code de sortie 1 au premier appel d'outil qui nécessite une approbation, donc elle ne produit aucune réponse même si la requête a été effectuée. Avant le premier prompt, Claude Code attend jusqu'à 30 secondes, le délai d'expiration de la connexion par serveur défini par [`MCP_TIMEOUT`](/fr/env-vars), pour que ce serveur se connecte. {/* min-version: 2.1.206 */}Avant la v2.1.206, le démarrage n'attendait pas que le serveur finisse de se connecter, donc un serveur qui démarre lentement mais sain produisait également cette erreur.1226L'outil que vous avez transmis à [`--permission-prompt-tool`](/docs/fr/cli-reference#cli-flags) ne figurait pas parmi les outils MCP connectés lorsque l'exécution a d'abord eu besoin d'une décision de permission, soit parce que son serveur ne s'est jamais connecté, soit parce qu'aucun serveur connecté n'expose un outil portant ce nom. Claude Code envoie toujours votre prompt : l'exécution [non interactive](/docs/fr/headless) se termine avec cette erreur et le code de sortie 1 au premier appel d'outil qui nécessite une approbation, donc elle ne produit aucune réponse même si la requête a été effectuée. Avant le premier prompt, Claude Code attend jusqu'à 30 secondes, le délai d'expiration de la connexion par serveur défini par [`MCP_TIMEOUT`](/docs/fr/env-vars), pour que ce serveur se connecte. Avant la v2.1.206, le démarrage n'attendait pas que le serveur finisse de se connecter, donc un serveur qui démarre lentement mais sain produisait également cette erreur.
1227 1227
1228```text theme={null}1228```text theme={null}
1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
1235 1235
1236* Vérifiez que le serveur démarre et reste connecté : exécutez `claude mcp list` dans le même répertoire et confirmez que le serveur est listé comme connecté1236* Vérifiez que le serveur démarre et reste connecté : exécutez `claude mcp list` dans le même répertoire et confirmez que le serveur est listé comme connecté
1237* Confirmez que le nom de l'outil correspond au nom `mcp__<server>__<tool>` que le serveur expose1237* Confirmez que le nom de l'outil correspond au nom `mcp__<server>__<tool>` que le serveur expose
1238* Si le serveur a besoin de plus de 30 secondes pour démarrer, augmentez [`MCP_TIMEOUT`](/fr/env-vars)1238* Si le serveur a besoin de plus de 30 secondes pour démarrer, augmentez [`MCP_TIMEOUT`](/docs/fr/env-vars)
1239 1239
1240<h2 id="plugin-errors">1240<h2 id="plugin-errors">
1241 Erreurs de plugin1241 Erreurs de plugin
1242</h2>1242</h2>
1243 1243
1244Ces erreurs proviennent de la configuration des [plugins](/fr/plugins) et des [marketplaces](/fr/plugin-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](/fr/discover-plugins#troubleshooting).1244Ces erreurs proviennent de la configuration des [plugins](/docs/fr/plugins) et des [marketplaces](/docs/fr/plugin-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](/docs/fr/discover-plugins#troubleshooting).
1245 1245
1246<h3 id="marketplace-is-registered-from-an-untrusted-source">1246<h3 id="marketplace-is-registered-from-an-untrusted-source">
1247 Marketplace enregistrée à partir d'une source non fiable1247 Marketplace enregistrée à partir d'une source non fiable
1248</h3>1248</h3>
1249 1249
1250La marketplace est enregistrée sous un nom qui est [réservé aux marketplaces officielles d'Anthropic](/fr/plugin-marketplaces#marketplace-schema), mais sa source enregistrée n'est pas un référentiel GitHub `anthropics`. Claude Code revérifie les noms réservés chaque fois qu'il charge ou actualise une marketplace, de sorte que la marketplace et les plugins installés à partir de celle-ci cessent de se charger. Avant la v2.1.205, le nom n'était vérifié que lors de l'ajout de la marketplace, de sorte qu'une entrée enregistrée avant que son nom ne soit réservé continuait à se charger.1250La marketplace est enregistrée sous un nom qui est [réservé aux marketplaces officielles d'Anthropic](/docs/fr/plugin-marketplaces#marketplace-schema), mais sa source enregistrée n'est pas un référentiel GitHub `anthropics`. Claude Code revérifie les noms réservés chaque fois qu'il charge ou actualise une marketplace, de sorte que la marketplace et les plugins installés à partir de celle-ci cessent de se charger. Avant la v2.1.205, le nom n'était vérifié que lors de l'ajout de la marketplace, de sorte qu'une entrée enregistrée avant que son nom ne soit réservé continuait à se charger.
1251 1251
1252```text theme={null}1252```text theme={null}
1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.
1257 1257
1258* Exécutez `claude plugin marketplace remove <name>`, puis ajoutez à nouveau la marketplace à partir du référentiel officiel `github.com/anthropics`1258* Exécutez `claude plugin marketplace remove <name>`, puis ajoutez à nouveau la marketplace à partir du référentiel officiel `github.com/anthropics`
1259* 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 source1259* 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
1260* Consultez la liste des noms réservés sous [Schéma de marketplace](/fr/plugin-marketplaces#marketplace-schema)1260* Consultez la liste des noms réservés sous [Schéma de marketplace](/docs/fr/plugin-marketplaces#marketplace-schema)
1261 1261
1262<h3 id="plugin-command-references-user-config">1262<h3 id="plugin-command-references-user-config">
1263 La commande du plugin référence user\_config dans une commande shell1263 La commande du plugin référence user\_config dans une commande shell
1264</h3>1264</h3>
1265 1265
1266Un hook de plugin, [monitor](/fr/plugins-reference#monitors), ou une commande MCP [`headersHelper`](/fr/mcp#use-dynamic-headers-for-custom-authentication) référence une [option de plugin](/fr/plugins-reference#user-configuration) `${user_config.KEY}`, et la chaîne substituée serait transmise à un shell. Une valeur configurée contenant `$(...)`, des backticks ou `;` s'exécuterait en tant que code là-bas, de sorte que 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, de sorte que l'erreur apparaît même quand aucune valeur n'est encore configurée. Avant la v2.1.207, la valeur était substituée dans la commande shell.1266Un hook de plugin, [monitor](/docs/fr/plugins-reference#monitors), ou une commande MCP [`headersHelper`](/docs/fr/mcp#use-dynamic-headers-for-custom-authentication) référence une [option de plugin](/docs/fr/plugins-reference#user-configuration) `${user_config.KEY}`, et la chaîne substituée serait transmise à un shell. Une valeur configurée contenant `$(...)`, des backticks ou `;` s'exécuterait en tant que code là-bas, de sorte que 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, de sorte que l'erreur apparaît même quand aucune valeur n'est encore configurée. Avant la v2.1.207, la valeur était substituée dans la commande shell.
1267 1267
1268La formulation dépend de la surface qui a référencé l'option. Un hook de forme shell rapporte :1268La formulation dépend de la surface qui a référencé l'option. Un hook de forme shell rapporte :
1269 1269
1285 1285
1286**À faire :**1286**À faire :**
1287 1287
1288* Pour un hook, ajoutez un tableau `args` afin qu'il s'exécute en [forme exec](/fr/hooks#exec-form-and-shell-form), 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 script1288* Pour un hook, ajoutez un tableau `args` afin qu'il s'exécute en [forme exec](/docs/fr/hooks#exec-form-and-shell-form), 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
1289* Pour un monitor, supprimez la référence et faites en sorte que le script monitor lise la valeur à partir d'un fichier de configuration1289* 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
1290* Pour un `headersHelper`, déplacez `${user_config.KEY}` dans le champ `headers` du serveur, qui n'est pas analysé par shell, ou lisez la valeur à l'intérieur du script helper1290* Pour un `headersHelper`, déplacez `${user_config.KEY}` dans le champ `headers` du serveur, qui n'est pas analysé par shell, ou lisez la valeur à l'intérieur du script helper
1291 1291
1299 Un agent serait lancé sans outils1299 Un agent serait lancé sans outils
1300</h3>1300</h3>
1301 1301
1302Rien dans la [liste `tools` d'un sous-agent](/fr/sub-agents#supported-frontmatter-fields) n'a été résolu en un outil, donc Claude Code refuse de lancer le sous-agent plutôt que de démarrer un qui ne peut pas agir. Le message regroupe les entrées par la raison pour laquelle elles n'ont pas été résolues : outil non reconnu, outil qui n'est pas disponible pour les sous-agents, ou reconnu mais ne correspondant à aucun outil dans la session actuelle. L'omission du champ `tools` ne déclenche jamais ce refus. Un modèle de serveur MCP tel que `mcp__github__*` n'est pas exempté : quand aucun outil connecté ne provient de ce serveur, le lancement est refusé avec le modèle dans le groupe sans correspondance. Avant la v2.1.208, le sous-agent était lancé sans outils et retournait un résultat vide ou confus.1302Rien dans la [liste `tools` d'un sous-agent](/docs/fr/sub-agents#supported-frontmatter-fields) n'a été résolu en un outil, donc Claude Code refuse de lancer le sous-agent plutôt que de démarrer un qui ne peut pas agir. Le message regroupe les entrées par la raison pour laquelle elles n'ont pas été résolues : outil non reconnu, outil qui n'est pas disponible pour les sous-agents, ou reconnu mais ne correspondant à aucun outil dans la session actuelle. L'omission du champ `tools` ne déclenche jamais ce refus. Un modèle de serveur MCP tel que `mcp__github__*` n'est pas exempté : quand aucun outil connecté ne provient de ce serveur, le lancement est refusé avec le modèle dans le groupe sans correspondance. Avant la v2.1.208, le sous-agent était lancé sans outils et retournait un résultat vide ou confus.
1303 1303
1304```text theme={null}1304```text theme={null}
1305Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.1305Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.
1307 1307
1308**Ce qu'il faut faire :**1308**Ce qu'il faut faire :**
1309 1309
1310* Corrigez chaque entrée que l'erreur nomme par rapport aux [outils disponibles pour les sous-agents](/fr/sub-agents#available-tools)1310* Corrigez chaque entrée que l'erreur nomme par rapport aux [outils disponibles pour les sous-agents](/docs/fr/sub-agents#available-tools)
1311* 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é1311* 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é
1312* Pour donner au sous-agent tous les outils que le parent a, supprimez le champ `tools` au lieu de lister les outils1312* Pour donner au sous-agent tous les outils que le parent a, supprimez le champ `tools` au lieu de lister les outils
1313 1313
1315 Le fichier est couvert par une règle de refus Read1315 Le fichier est couvert par une règle de refus Read
1316</h3>1316</h3>
1317 1317
1318L'outil Edit a été appelé sur un chemin correspondant à une [règle de refus `Read`](/fr/permissions#read-and-edit), y compris la création d'un nouveau fichier à ce chemin. L'édition réécrit le contenu que Claude doit pouvoir relire, donc l'appel est refusé avant tout accès au fichier. La règle bloque uniquement l'outil Edit : Write et NotebookEdit ne sont pas couverts par les règles de refus `Read`. Avant la v2.1.208, seule une règle de refus `Edit` bloquait les éditions, et une règle de refus `Read` seule ne le faisait pas.1318L'outil Edit a été appelé sur un chemin correspondant à une [règle de refus `Read`](/docs/fr/permissions#read-and-edit), y compris la création d'un nouveau fichier à ce chemin. L'édition réécrit le contenu que Claude doit pouvoir relire, donc l'appel est refusé avant tout accès au fichier. La règle bloque uniquement l'outil Edit : Write et NotebookEdit ne sont pas couverts par les règles de refus `Read`. Avant la v2.1.208, seule une règle de refus `Edit` bloquait les éditions, et une règle de refus `Read` seule ne le faisait pas.
1319 1319
1320```text theme={null}1320```text theme={null}
1321File is covered by a Read deny rule in your permission settings and cannot be edited.1321File is covered by a Read deny rule in your permission settings and cannot be edited.
1323 1323
1324**Ce qu'il faut faire :**1324**Ce qu'il faut faire :**
1325 1325
1326* Si Claude doit pouvoir éditer le fichier, supprimez ou réduisez la règle de refus `Read` dans `/permissions` ou dans les [paramètres](/fr/settings#permission-settings)1326* Si Claude doit pouvoir éditer le fichier, supprimez ou réduisez la règle de refus `Read` dans `/permissions` ou dans les [paramètres](/docs/fr/settings#permission-settings)
1327* Si le fichier doit rester intact, conservez la règle et ajoutez une règle de refus `Edit` pour le même chemin afin que les outils Write et NotebookEdit soient également bloqués1327* Si le fichier doit rester intact, conservez la règle et ajoutez une règle de refus `Edit` pour le même chemin afin que les outils Write et NotebookEdit soient également bloqués
1328 1328
1329<h2 id="background-session-errors">1329<h2 id="background-session-errors">
1330 Erreurs de session en arrière-plan1330 Erreurs de session en arrière-plan
1331</h2>1331</h2>
1332 1332
1333Les [sessions en arrière-plan](/fr/agent-view) s'exécutent sans terminal interactif propre, donc les commandes qui en ont besoin se comportent différemment là. Ces messages apparaissent dans la transcription d'une session en arrière-plan, en vue agent ou après attachement.1333Les [sessions en arrière-plan](/docs/fr/agent-view) s'exécutent sans terminal interactif propre, donc les commandes qui en ont besoin se comportent différemment là. Ces messages apparaissent dans la transcription d'une session en arrière-plan, en vue agent ou après attachement.
1334 1334
1335<h3 id="commands-refused-in-a-background-session">1335<h3 id="commands-refused-in-a-background-session">
1336 Commandes refusées dans une session en arrière-plan1336 Commandes refusées dans une session en arrière-plan
1337</h3>1337</h3>
1338 1338
1339Les commandes qui ouvrent une boîte de dialogue interactive sont refusées dans une session en arrière-plan avec un message nommant un formulaire qui fonctionne là ou vous indiquant d'exécuter la commande à partir d'un terminal régulier. `/install-github-app`, la liste des paramètres `/mcp`, et les actions d'authentification dans le menu du serveur MCP sont tous refusés de cette façon. Avant la v2.1.208, ils ouvraient leur boîte de dialogue à l'intérieur de la session en arrière-plan.1339Les commandes qui ouvrent une boîte de dialogue interactive sont refusées dans une session en arrière-plan avec un message nommant un formulaire qui fonctionne là ou vous indiquant d'exécuter la commande à partir d'un terminal régulier. `/install-github-app`, la liste des paramètres `/mcp`, et les actions d'authentification dans le menu du serveur MCP sont tous refusés de cette façon. Avant la v2.1.208, ils ouvraient leur boîte de dialogue à l'intérieur de la session en arrière-plan.
1340{/* max-version: 2.1.208 */}Dans la v2.1.208 uniquement, le sélecteur `/model` a également été refusé dans une session en arrière-plan, et `/upgrade` a imprimé l'URL de mise à niveau au lieu d'ouvrir un navigateur.1340Dans la v2.1.208 uniquement, le sélecteur `/model` a également été refusé dans une session en arrière-plan, et `/upgrade` a imprimé l'URL de mise à niveau au lieu d'ouvrir un navigateur.
1341 1341
1342La formulation nomme la commande qui a été refusée. La liste des paramètres `/mcp` rapporte :1342La formulation nomme la commande qui a été refusée. La liste des paramètres `/mcp` rapporte :
1343 1343
1354 Erreurs du lanceur CLAUDE\_CODE\_PROCESS\_WRAPPER1354 Erreurs du lanceur CLAUDE\_CODE\_PROCESS\_WRAPPER
1355</h3>1355</h3>
1356 1356
1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/fr/corporate-launcher) est défini, et sa valeur ne peut pas être utilisée, donc 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 indique la raison, par exemple :1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/fr/corporate-launcher) est défini, et sa valeur ne peut pas être utilisée, donc 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 indique la raison, par exemple :
1358 1358
1359```text theme={null}1359```text theme={null}
1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
1364 1364
1365**Ce qu'il faut faire :**1365**Ce qu'il faut faire :**
1366 1366
1367* Définissez la variable sur le chemin absolu d'un exécutable qui se termine en appelant `exec "$@"`. Voir [le contrat du lanceur](/fr/corporate-launcher#the-launcher-contract) pour le contrat complet1367* Définissez la variable sur le chemin absolu d'un exécutable qui se termine en appelant `exec "$@"`. Voir [le contrat du lanceur](/docs/fr/corporate-launcher#the-launcher-contract) pour le contrat complet
1368* Vérifiez `/status`, qui affiche la commande de lancement résolue dans son entrée Self-exec et avertit lorsque le service en arrière-plan en cours d'exécution ne correspond pas, ou exécutez `claude daemon status` à partir d'un shell1368* Vérifiez `/status`, qui affiche la commande de lancement résolue dans son entrée Self-exec et avertit lorsque le service en arrière-plan en cours d'exécution ne correspond pas, ou exécutez `claude daemon status` à partir d'un shell
1369* Après avoir corrigé la valeur dans le bloc `env` des [paramètres](/fr/corporate-launcher#set-up-the-launcher), redémarrez le service en arrière-plan avec `claude daemon stop --any` afin que la prochaine expédition démarre un service enveloppé1369* Après avoir corrigé la valeur dans le bloc `env` des [paramètres](/docs/fr/corporate-launcher#set-up-the-launcher), redémarrez le service en arrière-plan avec `claude daemon stop --any` afin que la prochaine expédition démarre un service enveloppé
1370 1370
1371<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">
1372 Avertissements de configuration1372 Avertissements de configuration
1378 L'espace de travail n'a pas été approuvé1378 L'espace de travail n'a pas été approuvé
1379</h3>1379</h3>
1380 1380
1381Claude Code a trouvé des règles `permissions.allow` ou des entrées `permissions.additionalDirectories` dans le fichier `.claude/settings.json` ou `.claude/settings.local.json` du projet et ne les a pas appliquées, car [les règles d'autorisation des paramètres du projet nécessitent l'approbation de l'espace de travail](/fr/permissions#project-allow-rules-and-workspace-trust). 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.1381Claude Code a trouvé des règles `permissions.allow` ou des entrées `permissions.additionalDirectories` dans le fichier `.claude/settings.json` ou `.claude/settings.local.json` du projet et ne les a pas appliquées, car [les règles d'autorisation des paramètres du projet nécessitent l'approbation de l'espace de travail](/docs/fr/permissions#project-allow-rules-and-workspace-trust). 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.
1382 1382
1383```text theme={null}1383```text theme={null}
1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.
1386 1386
1387**Que faire :**1387**Que faire :**
1388 1388
1389* Exécutez `claude` dans le répertoire et acceptez la boîte de dialogue d'approbation. {/* min-version: 2.1.200 */}La boîte de dialogue s'affiche même si un répertoire parent est déjà approuvé, répertorie les règles retenues et vous permet de refuser et de continuer à travailler sans elles. Avant la v2.1.200, aucune boîte de dialogue n'apparaissait dans cette situation, donc cette étape ne pouvait pas être complétée là.1389* Exécutez `claude` dans le répertoire et acceptez la boîte de dialogue d'approbation. La boîte de dialogue s'affiche même si un répertoire parent est déjà approuvé, répertorie les règles retenues et vous permet de refuser et de continuer à travailler sans elles. Avant la v2.1.200, aucune boîte de dialogue n'apparaissait dans cette situation, donc cette étape ne pouvait pas être complétée là.
1390* En [mode non interactif](/fr/headless) avec `-p`, aucune boîte de dialogue n'est affichée. Définissez l'entrée `hasTrustDialogAccepted` dans `~/.claude.json` en utilisant la clé `projects` exacte que le message affiche.1390* En [mode non interactif](/docs/fr/headless) avec `-p`, aucune boîte de dialogue n'est affichée. Définissez l'entrée `hasTrustDialogAccepted` dans `~/.claude.json` en utilisant la clé `projects` exacte que le message affiche.
1391* {/* min-version: 2.1.200 */}Si le message nomme `.claude/settings.local.json` et que vous avez démarré Claude Code en dehors d'un référentiel git ou dans votre répertoire personnel, mettez à jour vers la v2.1.200 ou ultérieure. Les versions 2.1.196 à 2.1.199 ont traité votre propre `.claude/settings.local.json` comme fourni par le référentiel dans ces espaces de travail. {/* min-version: 2.1.207 */}Sur la v2.1.207 et ultérieure, la mise à jour ne suffit pas en dehors d'un référentiel git si vous n'avez pas approuvé le dossier : déterminer qu'un dossier ne se trouve pas dans un référentiel 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](/fr/permissions#project-allow-rules-and-workspace-trust) sont exempts et n'attendent pas la boîte de dialogue. Voir [Règles d'autorisation du projet et approbation de l'espace de travail](/fr/permissions#project-allow-rules-and-workspace-trust).1391* Si le message nomme `.claude/settings.local.json` et que vous avez démarré Claude Code en dehors d'un référentiel git ou dans votre répertoire personnel, mettez à jour vers la v2.1.200 ou ultérieure. Les versions 2.1.196 à 2.1.199 ont traité votre propre `.claude/settings.local.json` comme fourni par le référentiel dans ces espaces de travail. Sur la v2.1.207 et ultérieure, la mise à jour ne suffit pas en dehors d'un référentiel git si vous n'avez pas approuvé le dossier : déterminer qu'un dossier ne se trouve pas dans un référentiel 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](/docs/fr/permissions#project-allow-rules-and-workspace-trust) sont exempts et n'attendent pas la boîte de dialogue. Voir [Règles d'autorisation du projet et approbation de l'espace de travail](/docs/fr/permissions#project-allow-rules-and-workspace-trust).
1392 1392
1393<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">
1394 Les réponses semblent de qualité inférieure à la normale1394 Les réponses semblent de qualité inférieure à la normale
1396 1396
1397Si les réponses de Claude semblent moins performantes que prévu mais qu'aucune erreur n'est affichée, la cause est généralement l'état de la conversation plutôt que le modèle lui-même. Claude Code ne change pas silencieusement les versions de modèle. Il peut basculer vers un modèle de secours dans trois cas spécifiques :1397Si les réponses de Claude semblent moins performantes que prévu mais qu'aucune erreur n'est affichée, la cause est généralement l'état de la conversation plutôt que le modèle lui-même. Claude Code ne change pas silencieusement les versions de modèle. Il peut basculer vers un modèle de secours dans trois cas spécifiques :
1398 1398
1399* Un [`--fallback-model`](/fr/cli-reference#cli-flags) configuré prend le relais après une erreur de disponibilité, pour ce tour uniquement, avec un avis dans la transcription1399* Un [`--fallback-model`](/docs/fr/cli-reference#cli-flags) configuré prend le relais après une erreur de disponibilité, pour ce tour uniquement, avec un avis dans la transcription
1400* 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 disponible1400* 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
1401* Le [basculement automatique du modèle](/fr/model-config#automatic-model-fallback) sur Fable 5 déplace la session vers le modèle Opus par défaut et affiche un avis dans la transcription1401* Le [basculement automatique du modèle](/docs/fr/model-config#automatic-model-fallback) sur Fable 5 déplace la session vers le modèle Opus par défaut et affiche un avis dans la transcription
1402 1402
1403La vérification de sélection du modèle ci-dessous détecte les deuxième et troisième cas ; le premier apparaît comme un avis de transcription plutôt qu'un changement de `/model`. La [configuration du modèle](/fr/model-config) explique quand chaque basculement s'applique.1403La vérification de sélection du modèle ci-dessous détecte les deuxième et troisième cas ; le premier apparaît comme un avis de transcription plutôt qu'un changement de `/model`. La [configuration du modèle](/docs/fr/model-config) explique quand chaque basculement s'applique.
1404 1404
1405Vérifiez d'abord ceci :1405Vérifiez d'abord ceci :
1406 1406
1407* **Sélection du modèle** : exécutez `/model` pour confirmer que vous êtes sur le modèle attendu. Un choix `/model` précédent ou une variable d'environnement `ANTHROPIC_MODEL` peut vous placer sur un modèle plus petit que prévu.1407* **Sélection du modèle** : exécutez `/model` pour confirmer que vous êtes sur le modèle attendu. Un choix `/model` précédent ou une variable d'environnement `ANTHROPIC_MODEL` peut vous placer sur un modèle plus petit que prévu.
1408* **Niveau d'effort** : exécutez `/effort` pour vérifier le niveau de raisonnement actuel et l'augmenter pour le débogage difficile ou le travail de conception. Les valeurs par défaut varient selon le modèle, vérifiez donc avant de supposer que vous êtes en dessous du maximum. Consultez [Ajuster le niveau d'effort](/fr/model-config#adjust-effort-level) pour les valeurs par défaut par modèle et le raccourci `ultrathink`.1408* **Niveau d'effort** : exécutez `/effort` pour vérifier le niveau de raisonnement actuel et l'augmenter pour le débogage difficile ou le travail de conception. Les valeurs par défaut varient selon le modèle, vérifiez donc avant de supposer que vous êtes en dessous du maximum. Consultez [Ajuster le niveau d'effort](/docs/fr/model-config#adjust-effort-level) pour les valeurs par défaut par modèle et le raccourci `ultrathink`.
1409* **Pression contextuelle** : exécutez `/context` pour voir le remplissage de la fenêtre. S'il est proche de la capacité, exécutez `/compact` à un point naturel ou `/clear` pour recommencer. Consultez [Explorer la fenêtre contextuelle](/fr/context-window) pour voir comment auto-compact affecte les tours précédents.1409* **Pression contextuelle** : exécutez `/context` pour voir le remplissage de la fenêtre. S'il est proche de la capacité, exécutez `/compact` à un point naturel ou `/clear` pour recommencer. Consultez [Explorer la fenêtre contextuelle](/docs/fr/context-window) pour voir comment auto-compact affecte les tours précédents.
1410* **Instructions obsolètes** : les fichiers `CLAUDE.md` volumineux ou obsolètes et les définitions d'outils MCP consomment du contexte et peuvent orienter les réponses. {/* min-version: 2.1.205 */}La vérification `/doctor` signale les fichiers mémoire surdimensionnés et les extensions inutilisées, et `/context` affiche l'utilisation des jetons des outils MCP. Avant la v2.1.205, `/doctor` ouvrait un écran de diagnostics qui signalait les fichiers mémoire surdimensionnés et les définitions de sous-agents.1410* **Instructions obsolètes** : les fichiers `CLAUDE.md` volumineux ou obsolètes et les définitions d'outils MCP consomment du contexte et peuvent orienter les réponses. La vérification `/doctor` signale les fichiers mémoire surdimensionnés et les extensions inutilisées, et `/context` affiche l'utilisation des jetons des outils MCP. Avant la v2.1.205, `/doctor` ouvrait un écran de diagnostics qui signalait les fichiers mémoire surdimensionnés et les définitions de sous-agents.
1411 1411
1412Quand une réponse s'avère incorrecte, revenir en arrière fonctionne généralement mieux que de répondre avec des corrections. Appuyez deux fois sur Échap ou exécutez `/rewind` pour revenir avant le mauvais tour, puis reformulez l'invite avec plus de détails. Corriger dans le fil de discussion garde la mauvaise tentative en contexte, ce qui peut ancrer les réponses ultérieures à celle-ci. Consultez [Checkpointing](/fr/checkpointing).1412Quand une réponse s'avère incorrecte, revenir en arrière fonctionne généralement mieux que de répondre avec des corrections. Appuyez deux fois sur Échap ou exécutez `/rewind` pour revenir avant le mauvais tour, puis reformulez l'invite avec plus de détails. Corriger dans le fil de discussion garde la mauvaise tentative en contexte, ce qui peut ancrer les réponses ultérieures à celle-ci. Consultez [Checkpointing](/docs/fr/checkpointing).
1413 1413
1414Si la qualité semble toujours mauvaise après vérification des éléments ci-dessus, exécutez `/feedback` et décrivez ce que vous attendiez par rapport à ce que vous avez obtenu. Les commentaires soumis de cette manière incluent la transcription de la conversation, ce qui est le moyen le plus rapide pour Anthropic de diagnostiquer une véritable régression. Consultez [Signaler une erreur](#report-an-error) si `/feedback` n'est pas disponible dans votre environnement.1414Si la qualité semble toujours mauvaise après vérification des éléments ci-dessus, exécutez `/feedback` et décrivez ce que vous attendiez par rapport à ce que vous avez obtenu. Les commentaires soumis de cette manière incluent la transcription de la conversation, ce qui est le moyen le plus rapide pour Anthropic de diagnostiquer une véritable régression. Consultez [Signaler une erreur](#report-an-error) si `/feedback` n'est pas disponible dans votre environnement.
1415 1415
1416Si 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](#report-an-error) plutôt que de coller le contenu signalé dans l'invite. {/* min-version: 2.1.201 */}Avant la v2.1.201, Sonnet 5 refusait certaines demandes de la même manière.1416Si 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](#report-an-error) 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.
1417 1417
1418<h2 id="report-an-error">1418<h2 id="report-an-error">
1419 Signaler une erreur1419 Signaler une erreur
1421 1421
1422Pour les erreurs provenant de composants non couverts par cette page, consultez le guide pertinent :1422Pour les erreurs provenant de composants non couverts par cette page, consultez le guide pertinent :
1423 1423
1424* Le serveur MCP n'a pas pu se connecter ou s'authentifier : [MCP](/fr/mcp)1424* Le serveur MCP n'a pas pu se connecter ou s'authentifier : [MCP](/docs/fr/mcp)
1425* Le script hook a échoué ou a bloqué un outil : [Déboguer les hooks](/fr/hooks#debug-hooks)1425* Le script hook a échoué ou a bloqué un outil : [Déboguer les hooks](/docs/fr/hooks#debug-hooks)
1426* Erreur de permission ou erreurs du système de fichiers lors de l'installation : [Dépanner l'installation et la connexion](/fr/troubleshoot-install)1426* Erreur de permission ou erreurs du système de fichiers lors de l'installation : [Dépanner l'installation et la connexion](/docs/fr/troubleshoot-install)
1427 1427
1428Si une erreur n'est pas répertoriée ici ou si la correction suggérée ne vous aide pas :1428Si une erreur n'est pas répertoriée ici ou si la correction suggérée ne vous aide pas :
1429 1429
1430* Exécutez `/feedback` dans Claude Code pour envoyer la transcription et une description à Anthropic. La commande propose également d'ouvrir un problème GitHub prérempli. L'envoi à Anthropic nécessite une [authentification](/fr/authentication). Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et d'autres fournisseurs tiers, ou lorsqu'aucune identifiant Anthropic n'est configuré, `/feedback` enregistre une archive locale que vous pouvez envoyer à votre représentant de compte Anthropic à la place.1430* Exécutez `/feedback` dans Claude Code pour envoyer la transcription et une description à Anthropic. La commande propose également d'ouvrir un problème GitHub prérempli. L'envoi à Anthropic nécessite une [authentification](/docs/fr/authentication). Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et d'autres fournisseurs tiers, ou lorsqu'aucune identifiant Anthropic n'est configuré, `/feedback` enregistre une archive locale que vous pouvez envoyer à votre représentant de compte Anthropic à la place.
1431* Exécutez `claude doctor` depuis votre shell pour un diagnostic en lecture seule de votre installation, ou exécutez la vérification `/doctor` dans Claude Code pour trouver et corriger les problèmes de configuration1431* Exécutez `claude doctor` depuis votre shell pour un diagnostic en lecture seule de votre installation, ou exécutez la vérification `/doctor` dans Claude Code pour trouver et corriger les problèmes de configuration
1432* Vérifiez [status.claude.com](https://status.claude.com) pour les incidents actifs1432* Vérifiez [status.claude.com](https://status.claude.com) pour les incidents actifs
1433* Recherchez les [problèmes existants](https://github.com/anthropics/claude-code/issues) sur GitHub1433* Recherchez les [problèmes existants](https://github.com/anthropics/claude-code/issues) sur GitHub
