21Faites correspondre le message que vous voyez dans votre terminal à une section ci-dessous.21Faites correspondre le message que vous voyez dans votre terminal à une section ci-dessous.
22 22
23| Message | Section |23| Message | Section |
24| :-------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- |24| :------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- |
25| `API Error: 500 Internal server error` | [Erreurs serveur](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Erreurs serveur](#api-error-500-internal-server-error) |
26| `API Error: Repeated 529 Overloaded errors` | [Erreurs serveur](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Erreurs serveur](#api-error-repeated-529-overloaded-errors) |
27| `Request timed out` | [Erreurs serveur](#request-timed-out), ou [Réseau](#unable-to-connect-to-api) si le message mentionne votre connexion Internet |27| `Request timed out` | [Erreurs serveur](#request-timed-out), ou [Réseau](#unable-to-connect-to-api) si le message mentionne votre connexion Internet |
39| `Not logged in · Please run /login` | [Authentification](#not-logged-in) |39| `Not logged in · Please run /login` | [Authentification](#not-logged-in) |
40| `Could not resolve authentication method` | [Authentification](#could-not-resolve-authentication-method) |40| `Could not resolve authentication method` | [Authentification](#could-not-resolve-authentication-method) |
41| `Invalid API key` | [Authentification](#invalid-api-key) |41| `Invalid API key` | [Authentification](#invalid-api-key) |
42| `Your apiKeyHelper script is failing` | [Authentification](#your-apikeyhelper-script-is-failing) |
42| `This organization has been disabled` | [Authentification](#this-organization-has-been-disabled) |43| `This organization has been disabled` | [Authentification](#this-organization-has-been-disabled) |
43| `Your organization has disabled API key authentication` | [Authentification](#your-organization-has-disabled-api-key-authentication) |44| `Your organization has disabled API key authentication` | [Authentification](#your-organization-has-disabled-api-key-authentication) |
44| `Your organization has disabled Claude subscription access` | [Authentification](#your-organization-has-disabled-claude-subscription-access) |45| `Your organization has disabled Claude subscription access` | [Authentification](#your-organization-has-disabled-claude-subscription-access) |
45| `Routines are disabled by your organization's policy` | [Authentification](#routines-are-disabled-by-your-organizations-policy) |46| `Routines are disabled by your organization's policy` | [Authentification](#routines-are-disabled-by-your-organizations-policy) |
46| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentification](#remote-control-requires-the-anthropic-api) |47| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentification](#remote-control-requires-the-anthropic-api) |
47| `OAuth token revoked` / `OAuth token has expired` | [Authentification](#oauth-token-revoked-or-expired) |48| `OAuth token revoked` / `OAuth token has expired` | [Authentification](#oauth-token-revoked-or-expired) |
49| `Login expired · Please run /login` | [Authentification](#login-expired) |
50| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentification](#login-expired) |
48| `does not meet scope requirement user:profile` | [Authentification](#oauth-scope-requirement) |51| `does not meet scope requirement user:profile` | [Authentification](#oauth-scope-requirement) |
49| `AWS credentials expired or invalid` | [Authentification](#aws-credentials-expired-or-invalid) |52| `AWS credentials expired or invalid` | [Authentification](#aws-credentials-expired-or-invalid) |
50| `AWS authentication failed` | [Authentification](#aws-authentication-failed) |53| `AWS authentication failed` | [Authentification](#aws-authentication-failed) |
54| `AWS default-chain credential resolve timed out` | [Authentification](#aws-default-chain-credential-resolve-timed-out) |
51| `Unable to connect to API` | [Réseau](#unable-to-connect-to-api) |55| `Unable to connect to API` | [Réseau](#unable-to-connect-to-api) |
52| `Waiting for API response · will retry in` | [Tentatives automatiques](#automatic-retries), ou [Réseau](#unable-to-connect-to-api) si le problème persiste |56| `Waiting for API response · will retry in` | [Tentatives automatiques](#automatic-retries), ou [Réseau](#unable-to-connect-to-api) si le problème persiste |
57| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Réseau](#bedrock-streaming-response-has-an-unexpected-content-type) |
53| `SSL certificate verification failed` | [Réseau](#ssl-certificate-errors) |58| `SSL certificate verification failed` | [Réseau](#ssl-certificate-errors) |
54| `SSL certificate error (...)` during login or startup | [Réseau](#ssl-certificate-errors) |59| `SSL certificate error (...)` during login or startup | [Réseau](#ssl-certificate-errors) |
55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Réseau](#host-not-allowed-in-a-cloud-session) |60| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Réseau](#host-not-allowed-in-a-cloud-session) |
76| `--bg and --print conflict` | [Erreurs de ligne de commande](#command-line-errors) |81| `--bg and --print conflict` | [Erreurs de ligne de commande](#command-line-errors) |
77| `Error: --json-schema is not a valid JSON Schema` | [Erreurs de ligne de commande](#command-line-errors) |82| `Error: --json-schema is not a valid JSON Schema` | [Erreurs de ligne de commande](#command-line-errors) |
78| `Could not import <server>: <reason>` | [Erreurs de ligne de commande](#could-not-import-a-server-from-claude-desktop) |83| `Could not import <server>: <reason>` | [Erreurs de ligne de commande](#could-not-import-a-server-from-claude-desktop) |
84| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Erreurs de ligne de commande](#mcp-permission-prompt-tool-not-found) |
79| `Marketplace "<name>" is registered from an untrusted source` | [Erreurs de plugin](#marketplace-is-registered-from-an-untrusted-source) |85| `Marketplace "<name>" is registered from an untrusted source` | [Erreurs de plugin](#marketplace-is-registered-from-an-untrusted-source) |
86| `references ${user_config.*} in a shell-form command` | [Erreurs de plugin](#plugin-command-references-user-config) |
87| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Erreurs de plugin](#plugin-command-references-user-config) |
88| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Erreurs de plugin](#plugin-command-references-user-config) |
89| `would be spawned with zero tools — refusing` | [Erreurs d'outil](#agent-would-be-spawned-with-zero-tools) |
90| `File is covered by a Read deny rule in your permission settings` | [Erreurs d'outil](#file-is-covered-by-a-read-deny-rule) |
91| `Can't open MCP settings in a background session` | [Erreurs de session en arrière-plan](#commands-refused-in-a-background-session) |
92| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Erreurs de session en arrière-plan](#claude_code_process_wrapper-launcher-errors) |
80| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avertissements de configuration](#workspace-has-not-been-trusted) |93| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avertissements de configuration](#workspace-has-not-been-trusted) |
81| Responses seem lower quality than usual | [Qualité des réponses](#responses-seem-lower-quality-than-usual) |94| Responses seem lower quality than usual | [Qualité des réponses](#responses-seem-lower-quality-than-usual) |
82 95
86 99
87Claude 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. {/* 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.
88 101
89Deux 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 :
90 103
91* {/* 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* {/* 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.
92* {/* 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* {/* 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.
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.
93 107
94Lors 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. {/* 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.
95 109
96{/* min-version: 2.1.198 */}À partir de la v2.1.198, l'indice de spinner habituel est supprimé lors des tentatives. Une fois que la raison de l'erreur est révélée, si la défaillance est un surcharge 529, la ligne sous le compte à rebours nomme également où vérifier l'état du service : `status.claude.com` sur l'API Anthropic, ou l'hôte du fournisseur ou de la passerelle nommé dans le message sur d'autres configurations.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.
97 111
98{/* 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).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).
99 113
285 299
286Claude Code bloque les demandes supplémentaires jusqu'à l'heure de réinitialisation indiquée dans le message. Les limites de session et hebdomadaires sont partagées entre tous les modèles, donc changer de modèle ne restaure pas l'accès. La limite Opus s'applique uniquement aux demandes Opus, donc passer à un autre modèle avec `/model` vous permet de continuer à travailler.300Claude Code bloque les demandes supplémentaires jusqu'à l'heure de réinitialisation indiquée dans le message. Les limites de session et hebdomadaires sont partagées entre tous les modèles, donc changer de modèle ne restaure pas l'accès. La limite Opus s'applique uniquement aux demandes Opus, donc passer à un autre modèle avec `/model` vous permet de continuer à travailler.
287 301
302L'utilisation compte par rapport aux allocations de session et hebdomadaires en même temps. Une seule rafale d'activité intensive, comme un grand fanout de flux de travail, peut épuiser l'allocation hebdomadaire avant que la fenêtre de session se réinitialise.
303
288**À faire :**304**À faire :**
289 305
290* Attendez l'heure de réinitialisation indiquée dans l'erreur306* Attendez l'heure de réinitialisation indiquée dans l'erreur
430* 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`](/fr/settings#available-settings), exécutez le script directement pour confirmer qu'il imprime une clé valide sur stdout
431* 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
432 448
449<h3 id="your-apikeyhelper-script-is-failing">
450 Votre script apiKeyHelper échoue
451</h3>
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`.
454
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 output
457```
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.
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.
462
463**À faire :**
464
465* 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 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.
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
433<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">
434 Cette organisation a été désactivée471 Cette organisation a été désactivée
435</h3>472</h3>
532 569
533Votre connexion enregistrée n'est plus valide. Un token révoqué signifie que vous vous êtes déconnecté partout ou qu'un administrateur a supprimé l'accès ; un token expiré signifie que l'actualisation automatique a échoué en cours de session.570Votre connexion enregistrée n'est plus valide. Un token révoqué signifie que vous vous êtes déconnecté partout ou qu'un administrateur a supprimé l'accès ; un token expiré signifie que l'actualisation automatique a échoué en cours de session.
534 571
572Les deux messages signalent un rejet que l'API a retourné pour une requête que Claude Code a envoyée. Quand la connexion enregistrée a déjà été effacée après un échec d'actualisation, vous voyez [Connexion expirée](#login-expired) à la place.
573
535```text theme={null}574```text theme={null}
536OAuth token revoked · Please run /login575OAuth token revoked · Please run /login
537OAuth token has expired · Please run /login576OAuth token has expired · Please run /login
545* 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](/fr/troubleshoot-install#not-logged-in-or-token-expired)
546* 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](/fr/troubleshoot-install#login-and-authentication)
547 586
587<h3 id="login-expired">
588 Connexion expirée
589</h3>
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.
592
593```text theme={null}
594Login expired · Please run /login
595```
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` :
598
599```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed
601```
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.
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.
606
607**À faire :**
608
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).
611* Si la connexion continue d'échouer, consultez [Connexion et authentification](/fr/troubleshoot-install#login-and-authentication)
612
548<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">
549 Exigence de portée OAuth614 Exigence de portée OAuth
550</h3>615</h3>
603* 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](/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
604* 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
605 670
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é
673</h3>
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.
676
677```text theme={null}
678API Error: AWS default-chain credential resolve timed out
679```
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.
682
683**À faire :**
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.
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 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)
688
606<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">
607 Erreurs de réseau et de connexion690 Erreurs de réseau et de connexion
608</h2>691</h2>
609 692
610Ces erreurs signifient qu'une requête réseau de Claude Code n'a pas pu atteindre sa destination. Elles proviennent généralement de votre réseau local, d'un proxy, d'un pare-feu, ou de la politique réseau de l'environnement cloud.693Ces erreurs signifient qu'une requête réseau de Claude Code n'a pas pu atteindre sa destination, ou que quelque chose entre Claude Code et l'API a modifié la réponse en chemin. Elles proviennent généralement de votre réseau local, d'un proxy, d'un pare-feu, ou de la politique réseau de l'environnement cloud.
611 694
612<h3 id="unable-to-connect-to-api">695<h3 id="unable-to-connect-to-api">
613 Impossible de se connecter à l'API696 Impossible de se connecter à l'API
640* Sur macOS, un client VPN qui a été déconnecté ou désinstallé peut laisser une interface tunnel ou une règle de routage. Vérifiez `ifconfig` pour les interfaces `utun` obsolètes et supprimez l'extension réseau du VPN dans Paramètres système.723* Sur macOS, un client VPN qui a été déconnecté ou désinstallé peut laisser une interface tunnel ou une règle de routage. Vérifiez `ifconfig` pour les interfaces `utun` obsolètes et supprimez l'extension réseau du VPN dans Paramètres système.
641* Docker Desktop et les runtimes de conteneurs similaires peuvent intercepter le trafic sortant. Quittez-les et réessayez pour exclure cette possibilité.724* Docker Desktop et les runtimes de conteneurs similaires peuvent intercepter le trafic sortant. Quittez-les et réessayez pour exclure cette possibilité.
642 725
726<h3 id="bedrock-streaming-response-has-an-unexpected-content-type">
727 La réponse de streaming Bedrock a un content-type inattendu
728</h3>
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.
731
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.
734```
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.
737
738**Que faire :**
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.
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).
742
643<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">
644 Erreurs de certificat SSL744 Erreurs de certificat SSL
645</h3>745</h3>
859* **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`](/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.
860* 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](/fr/model-config).
861* 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é](/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.
862* 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](/fr/google-vertex-ai#troubleshooting).
863 964
864<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">
1064 Erreurs de ligne de commande1165 Erreurs de ligne de commande
1065</h2>1166</h2>
1066 1167
1067Ces erreurs proviennent de la commande `claude` et de ses sous-commandes. Claude Code les affiche avant d'exécuter votre prompt ou d'envoyer une requête API.1168Ces erreurs proviennent de la ligne de commande `claude` et de ses sous-commandes. Claude Code les affiche avant d'exécuter votre prompt ou d'envoyer une requête API.
1068 1169
1069<h3 id="conflict-between-bg-and-print">1170<h3 id="conflict-between-bg-and-print">
1070 Conflit entre --bg et --print1171 Conflit entre --bg et --print
1071</h3>1172</h3>
1072 1173
1073Ce 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 un travail en arrière-plan qui ne pouvait jamais être attaché.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.
1074 1175
1075```text theme={null}1176```text theme={null}
1076--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>'`.
1077```1178```
1078 1179
1079**Ce qu'il faut faire :**1180**À faire :**
1080 1181
1081* 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](/fr/agent-view#from-your-shell).
1082* 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>"`
1095 1196
1096Claude Code exécute deux vérifications avant la compilation du schéma : il rejette une valeur qui n'est pas du JSON analysable avec `Error: --json-schema is not valid JSON`, et du JSON valide qui n'est pas un objet avec `Error: --json-schema must be a JSON object`.1197Claude Code exécute deux vérifications avant la compilation du schéma : il rejette une valeur qui n'est pas du JSON analysable avec `Error: --json-schema is not valid JSON`, et du JSON valide qui n'est pas un objet avec `Error: --json-schema must be a JSON object`.
1097 1198
1098**Ce qu'il faut faire :**1199**À faire :**
1099 1200
1100* 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
1101* 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`
1113 1214
1114Le 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](/fr/managed-mcp) de votre organisation.
1115 1216
1116**Ce qu'il faut faire :**1217**À faire :**
1117 1218
1118* 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
1119* 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](/fr/mcp#import-mcp-servers-from-claude-desktop).
1120 1221
1222<h3 id="mcp-permission-prompt-tool-not-found">
1223 Outil de prompt de permission MCP introuvable
1224</h3>
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.
1227
1228```text theme={null}
1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
1230```
1231
1232La liste après `Available MCP tools:` nomme les outils MCP qui étaient connectés lorsque l'attente s'est terminée.
1233
1234**À faire :**
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é
1237* 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)
1239
1121<h2 id="plugin-errors">1240<h2 id="plugin-errors">
1122 Erreurs de plugin1241 Erreurs de plugin
1123</h2>1242</h2>
1140* 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
1141* 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](/fr/plugin-marketplaces#marketplace-schema)
1142 1261
1262<h3 id="plugin-command-references-user-config">
1263 La commande du plugin référence user\_config dans une commande shell
1264</h3>
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.
1267
1268La formulation dépend de la surface qui a référencé l'option. Un hook de forme shell rapporte :
1269
1270```text theme={null}
1271Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}
1272```
1273
1274Un monitor rapporte :
1275
1276```text theme={null}
1277Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.
1278```
1279
1280Un MCP `headersHelper` rapporte :
1281
1282```text theme={null}
1283headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).
1284```
1285
1286**À faire :**
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 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 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 helper
1291
1292<h2 id="tool-errors">
1293 Erreurs d'outils
1294</h2>
1295
1296Ces erreurs proviennent des outils intégrés de Claude qui refusent une entrée. Claude corrige la plupart des erreurs d'outils de lui-même ; les deux ci-dessous nécessitent une modification de votre part, car elles proviennent d'une définition de sous-agent ou d'une règle de permission que vous contrôlez.
1297
1298<h3 id="agent-would-be-spawned-with-zero-tools">
1299 Un agent serait lancé sans outils
1300</h3>
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.
1303
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.
1306```
1307
1308**Ce qu'il faut faire :**
1309
1310* Corrigez chaque entrée que l'erreur nomme par rapport aux [outils disponibles pour les sous-agents](/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é
1312* Pour donner au sous-agent tous les outils que le parent a, supprimez le champ `tools` au lieu de lister les outils
1313
1314<h3 id="file-is-covered-by-a-read-deny-rule">
1315 Le fichier est couvert par une règle de refus Read
1316</h3>
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.
1319
1320```text theme={null}
1321File is covered by a Read deny rule in your permission settings and cannot be edited.
1322```
1323
1324**Ce qu'il faut faire :**
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)
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és
1328
1329<h2 id="background-session-errors">
1330 Erreurs de session en arrière-plan
1331</h2>
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.
1334
1335<h3 id="commands-refused-in-a-background-session">
1336 Commandes refusées dans une session en arrière-plan
1337</h3>
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.
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.
1341
1342La formulation nomme la commande qui a été refusée. La liste des paramètres `/mcp` rapporte :
1343
1344```text theme={null}
1345Can't open MCP settings in a background session — use `/mcp enable|disable|reconnect <server>` to steer, or run /mcp from an interactive terminal to authenticate.
1346```
1347
1348**Ce qu'il faut faire :**
1349
1350* Utilisez le formulaire que le message nomme, tel que `/mcp reconnect <server>`, `/mcp enable`, ou `/mcp disable`
1351* Pour les flux de connexion et d'autorisation, exécutez la commande à partir d'une session `claude` régulière dans un terminal
1352
1353<h3 id="claude_code_process_wrapper-launcher-errors">
1354 Erreurs du lanceur CLAUDE\_CODE\_PROCESS\_WRAPPER
1355</h3>
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 :
1358
1359```text theme={null}
1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
1361```
1362
1363Un lanceur qui démarre mais se termine sans se remplacer par Claude Code échoue la session qu'il démarrait, et la ligne de la session dans la vue agent rapporte que le lanceur `must exec, not daemonize`, suivi de tout ce que le lanceur a imprimé. Une session qui ne peut pas démarrer ou atteindre le service en arrière-plan en raison du lanceur rapporte le problème du lanceur comme raison à l'intérieur de `Couldn't reach the background service (...)`.
1364
1365**Ce qu'il faut faire :**
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 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 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é
1370
1143<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">
1144 Avertissements de configuration1372 Avertissements de configuration
1145</h2>1373</h2>
1160 1388
1161* 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. {/* 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à.
1162* 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](/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.
1163* {/* 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 une version ultérieure. Les versions 2.1.196 à 2.1.199 ont traité votre propre `.claude/settings.local.json` comme fournie par le référentiel dans ces espaces de travail. Voir [Règles d'autorisation du projet et approbation de l'espace de travail](/fr/permissions#project-allow-rules-and-workspace-trust).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).
1164 1392
1165<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">
1166 Les réponses semblent de qualité inférieure à la normale1394 Les réponses semblent de qualité inférieure à la normale
1178 1406
1179* **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.
1180* **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](/fr/model-config#adjust-effort-level) pour les valeurs par défaut par modèle et le raccourci `ultrathink`.
1181* **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 l'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](/fr/context-window) pour voir comment auto-compact affecte les tours précédents.
1182* **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 */}Le `/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. {/* 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.
1183 1411
1184Quand une réponse s'avère incorrecte, revenir en arrière fonctionne généralement mieux que de répondre avec des corrections. Appuyez deux fois sur Échap ou exécutez `/rewind` pour revenir avant le mauvais tour, puis reformulez l'invite avec plus de détails. Corriger dans le fil de discussion conserve la mauvaise tentative en contexte, ce qui peut ancrer les réponses ultérieures à celle-ci. Consultez [Checkpointing](/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](/fr/checkpointing).
1185 1413
1186Si 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.
1187 1415
1188{/* min-version: 2.1.201 */}Si Sonnet 5 refuse une demande et cite une injection d'invite suspectée sur Claude Code v2.1.200 ou antérieur, exécutez `claude update` pour récupérer le correctif v2.1.201.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.
1189 1417
1190<h2 id="report-an-error">1418<h2 id="report-an-error">
1191 Signaler une erreur1419 Signaler une erreur
1199 1427
1200Si 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 :
1201 1429
1202* 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. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et d'autres fournisseurs tiers, `/feedback` enregistre une archive locale que vous pouvez envoyer à votre représentant de compte Anthropic.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.
1203* Exécutez `claude doctor` depuis votre shell pour un diagnostic en lecture seule de votre installation, ou exécutez le diagnostic `/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
1204* Consultez [status.claude.com](https://status.claude.com) pour les incidents actifs1432* Vérifiez [status.claude.com](https://status.claude.com) pour les incidents actifs
1205* 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
