SpyBara
Go Premium

Documentation 2026-10-06 23:59 UTC to 2026-10-07 21:59 UTC

69 files changed +1,255 −1,042. View all changes and history on the product overview
2026
Wed 7 23:01 Tue 6 23:59 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59

admin-setup.md +5 −5

Details

55| Géré basé sur fichier | macOS : `/Library/Application Support/ClaudeCode/managed-settings.json`<br />Linux et WSL : `/etc/claude-code/managed-settings.json`<br />Windows : `C:\Program Files\ClaudeCode\managed-settings.json` | Moyenne | Tous |55| Géré basé sur fichier | macOS : `/Library/Application Support/ClaudeCode/managed-settings.json`<br />Linux et WSL : `/etc/claude-code/managed-settings.json`<br />Windows : `C:\Program Files\ClaudeCode\managed-settings.json` | Moyenne | Tous |

56| Registre utilisateur Windows | `HKCU\SOFTWARE\Policies\ClaudeCode` | Très basse | Windows uniquement |56| Registre utilisateur Windows | `HKCU\SOFTWARE\Policies\ClaudeCode` | Très basse | Windows uniquement |

57 57 

58Claude Code récupère les paramètres gérés par le serveur au démarrage et les actualise toutes les heures pendant la session, sans infrastructure de point de terminaison à déployer. La livraison via la console d'administration claude.ai nécessite un plan Claude for Teams ou Enterprise. Les déploiements sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry peuvent obtenir la même livraison à distance en exécutant une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway), ou utiliser l'un des mécanismes basés sur fichier ou au niveau du système d'exploitation à la place.58Claude Code récupère les paramètres gérés par le serveur au démarrage et les actualise toutes les heures pendant la session, sans infrastructure d'endpoint à déployer. La livraison via la console d'administration claude.ai nécessite un plan Claude for Teams ou Enterprise. Les déploiements sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry peuvent obtenir la même livraison à distance en exécutant une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway), ou utiliser l'un des mécanismes basés sur fichier ou au niveau du système d'exploitation à la place.

59 59 

60Si votre organisation mélange les fournisseurs, configurez les [paramètres gérés par le serveur](/docs/fr/server-managed-settings) pour les utilisateurs de claude.ai plus un [secours basé sur fichier ou plist/registre](/docs/fr/managed-settings#delivery-mechanisms) afin que les autres utilisateurs reçoivent toujours la politique gérée.60Si votre organisation mélange les fournisseurs, configurez les [paramètres gérés par le serveur](/docs/fr/server-managed-settings) pour les utilisateurs de claude.ai plus une [solution de repli basée sur fichier ou plist/registre](/docs/fr/managed-settings#delivery-mechanisms) afin que les autres utilisateurs reçoivent toujours la politique gérée.

61 61 

62Les emplacements du registre plist et HKLM fonctionnent avec n'importe quel fournisseur et résistent à la falsification car ils nécessitent des privilèges d'administrateur pour écrire. Le registre utilisateur Windows à HKCU est accessible en écriture sans élévation, donc traitez-le comme une valeur par défaut pratique plutôt que comme un canal d'application.62Les emplacements du registre plist et HKLM fonctionnent avec n'importe quel fournisseur et résistent à la falsification car ils nécessitent des privilèges d'administrateur pour écrire. Le registre utilisateur Windows à HKCU est accessible en écriture sans élévation, donc traitez-le comme une valeur par défaut pratique plutôt que comme un canal d'application.

63 63 

64Par défaut, WSL lit uniquement le chemin de fichier Linux à `/etc/claude-code`. Pour étendre votre registre Windows et la politique `C:\Program Files\ClaudeCode` à WSL sur la même machine, définissez [`wslInheritsWindowsSettings: true`](/docs/fr/settings-reference#wslinheritswindowssettings) dans l'une de ces sources Windows réservées aux administrateurs.64Par défaut, WSL lit uniquement le chemin de fichier Linux à `/etc/claude-code`. Pour étendre votre registre Windows et la politique `C:\Program Files\ClaudeCode` à WSL sur la même machine, définissez [`wslInheritsWindowsSettings: true`](/docs/fr/settings-reference#wslinheritswindowssettings) dans l'une de ces sources Windows réservées aux administrateurs.

65 65 

66Quel que soit le mécanisme que vous choisissez, les valeurs gérées prennent précédence sur les paramètres utilisateur et projet, à l'exception de quelques [exceptions](/docs/fr/settings#exceptions-to-managed-settings-precedence) sensibles à la sécurité. Les paramètres de tableau tels que `permissions.allow` et `permissions.deny` fusionnent les entrées de toutes les sources, donc les développeurs peuvent étendre les listes gérées mais pas les supprimer. Pour `fallbackModel`, `availableModels`, et [`modelPicker`](/docs/fr/settings-reference#modelpicker), la valeur gérée remplace les couches inférieures plutôt que de fusionner.66Quel que soit le mécanisme que vous choisissez, les valeurs gérées ont priorité sur les paramètres utilisateur et projet, à l'exception de quelques [exceptions](/docs/fr/settings#exceptions-to-managed-settings-precedence) sensibles à la sécurité. Les paramètres de tableau tels que `permissions.allow` et `permissions.deny` fusionnent les entrées de toutes les sources, donc les développeurs peuvent étendre les listes gérées mais pas les supprimer. Pour `fallbackModel`, `availableModels`, et [`modelPicker`](/docs/fr/settings-reference#modelpicker), la valeur gérée remplace les couches inférieures plutôt que de fusionner.

67 67 

68<h3 id="wsl-sessions-in-claude-code-desktop">68<h3 id="wsl-sessions-in-claude-code-desktop">

69 Sessions WSL dans Claude Code Desktop69 Sessions WSL dans Claude Code Desktop


78 78 

79Desktop lit la politique chaque fois qu'une session WSL démarre, vous n'avez donc pas besoin de redémarrer l'application après l'avoir déployée.79Desktop lit la politique chaque fois qu'une session WSL démarre, vous n'avez donc pas besoin de redémarrer l'application après l'avoir déployée.

80 80 

81Si un appareil refuse toujours les sessions WSL, ouvrez **Aide > Dépannage > Afficher les journaux dans l'Explorateur** dans Claude Desktop sur cet appareil, ce qui enregistre une copie de son dossier de journaux dans Téléchargements. Recherchez `[wslPolicyGate] denying WSL session` dans `main.log` dans cette copie. La raison du refus suit entre parenthèses, comme `(cli-file-present)`. Si Claude Desktop a été installé avec le programme d'installation `.exe`, vous pouvez également lire le fichier en direct à `%APPDATA%\Claude\logs\main.log`.81Si un appareil refuse toujours les sessions WSL, ouvrez **Aide > Dépannage > Afficher les journaux dans l'Explorateur** dans Claude Desktop sur cet appareil, ce qui enregistre une copie de son dossier de journaux dans Téléchargements. Recherchez `[wslPolicyGate] denying WSL session` dans `main.log` dans cette copie. La raison du refus suit entre parenthèses, comme `(cli-file-present)`.

82 82 

83Une fois que les sessions WSL sont activées, étendez vos paramètres gérés à celles-ci :83Une fois que les sessions WSL sont activées, étendez vos paramètres gérés à celles-ci :

84 84 

85* Déployez `wslInheritsWindowsSettings: true` via le registre HKLM ou le fichier `C:\Program Files\ClaudeCode` afin que les sessions WSL héritent de la même politique que les sessions hôte.85* Déployez `wslInheritsWindowsSettings: true` via le registre HKLM ou le fichier `C:\Program Files\ClaudeCode` afin que les sessions WSL héritent de la même politique que les sessions hôte.

86* Vérifiez en exécutant `/status` à l'intérieur d'une session WSL et en lisant la ligne `Setting sources`. Pour interpréter ce qu'elle indique, consultez [Lire la source dans /status](/docs/fr/managed-settings#read-the-source-in-/status).86* Vérifiez en exécutant `/status` à l'intérieur d'une session WSL et en lisant la ligne `Setting sources`. Pour interpréter ce qu'elle indique, consultez [Lire la source dans /status](/docs/fr/managed-settings#read-the-source-in-/status).

87 87 

88Les processus à l'intérieur de la machine virtuelle utilitaire WSL 2 ne sont pas visibles pour les capteurs de détection de point de terminaison côté Windows. Pour observer l'activité des processus et fichiers dans la distribution, consultez les conseils WSL de votre fournisseur de détection de point de terminaison pour un capteur Linux que vous pouvez exécuter à l'intérieur de la distribution et les exclusions dont il a besoin. La [télémétrie d'exécution d'outils OpenTelemetry](/docs/fr/monitoring-usage) de Claude Code est émise de manière identique pour les sessions WSL et natives.88Les processus à l'intérieur de la machine virtuelle utilitaire WSL 2 ne sont pas visibles pour les capteurs de détection d'endpoint côté Windows. Pour observer l'activité des processus et fichiers dans la distribution, consultez les conseils WSL de votre fournisseur de détection d'endpoint pour un capteur Linux que vous pouvez exécuter à l'intérieur de la distribution et les exclusions dont il a besoin. La [télémétrie d'exécution d'outils OpenTelemetry](/docs/fr/monitoring-usage) de Claude Code est émise de manière identique pour les sessions WSL et natives.

89 89 

90<h2 id="decide-what-to-enforce">90<h2 id="decide-what-to-enforce">

91 Décider ce qu'il faut appliquer91 Décider ce qu'il faut appliquer

advisor.md +8 −8

Details

87Claude Code utilise le drapeau à la place du paramètre `advisorModel` pour cette session. Il ne liste pas `--advisor` dans `claude --help`. Claude Code se termine avec une erreur au lancement si :87Claude Code utilise le drapeau à la place du paramètre `advisorModel` pour cette session. Il ne liste pas `--advisor` dans `claude --help`. Claude Code se termine avec une erreur au lancement si :

88 88 

89* Le modèle principal de la session ne supporte pas l'advisor89* Le modèle principal de la session ne supporte pas l'advisor

90* Le modèle demandé, tel que Haiku, ne peut pas agir comme advisor90* Le modèle demandé, tel que Haiku 4.5, ne peut pas agir comme advisor

91* La liste d'autorisation [`availableModels`](/docs/fr/model-config#restrict-model-selection) de votre organisation exclut le modèle demandé91* La liste d'autorisation [`availableModels`](/docs/fr/model-config#restrict-model-selection) de votre organisation exclut le modèle demandé

92* Vous avez demandé Fable et votre compte nécessite toujours le [consentement des crédits d'utilisation](#fable-advisor-and-usage-credits)92* Vous avez demandé Fable et votre compte nécessite toujours le [consentement des crédits d'utilisation](#fable-advisor-and-usage-credits)

93 93 


103 103 

104| Modèle principal | Advisors acceptés |104| Modèle principal | Advisors acceptés |

105| - | - |105| - | - |

106| Haiku 4.5 | Fable, Opus, Sonnet |106| Haiku 4.5 | Fable, Opus, Sonnet, Haiku 5.5 |

107| Sonnet 4.6 | Fable, Opus, Sonnet |107| Sonnet 4.6 | Fable, Opus, Sonnet, Haiku 5.5 |

108| Opus 4.6 | Fable, Opus, Sonnet 5 ou ultérieur |108| Opus 4.6 | Fable, Opus, Sonnet 5 ou ultérieur, Haiku 5.5 |

109| Sonnet 5 | Fable, Opus 4.7 ou ultérieur, Sonnet 5 ou ultérieur |109| Sonnet 5 ou Haiku 5.5 | Fable, Opus 4.7 ou ultérieur, Sonnet 5 ou ultérieur, Haiku 5.5 |

110| Opus 4.7 ou Opus 4.8 | Fable, Opus 4.7 ou ultérieur, Sonnet 5.5 |110| Opus 4.7 ou Opus 4.8 | Fable, Opus 4.7 ou ultérieur, Sonnet 5.5 |

111| Sonnet 5.5 | Fable, Opus 5 ou ultérieur, Sonnet 5.5 |111| Sonnet 5.5 | Fable, Opus 5 ou ultérieur, Sonnet 5.5 |

112| Opus 5 ou Opus 5.5 | Fable, Opus 5 ou ultérieur |112| Opus 5 ou Opus 5.5 | Fable, Opus 5 ou ultérieur |

113| Fable 5 | Fable 5.1 ou Fable 5 |113| Fable 5 | Fable 5.1 ou Fable 5 |

114| Fable 5.1 | Fable 5.1 |114| Fable 5.1 | Fable 5.1 |

115 115 

116Fable 5.1 nécessite Claude Code v2.1.257 ou ultérieur. Les modèles Fable nécessitent [l'accès à Fable](/docs/fr/model-config#work-with-fable). Sonnet 5.5 en tant qu'advisor pour un modèle principal Opus 4.7 ou Opus 4.8 nécessite Claude Code v2.1.287 ou ultérieur.116Fable 5.1 nécessite Claude Code v2.1.257 ou ultérieur. Les modèles Fable nécessitent [l'accès à Fable](/docs/fr/model-config#work-with-fable). Sonnet 5.5 en tant qu'advisor pour un modèle principal Opus 4.7 ou Opus 4.8 nécessite Claude Code v2.1.287 ou ultérieur. Haiku 5.5 en tant que modèle principal ou en tant qu'advisor nécessite Claude Code v2.1.293 ou ultérieur.

117 117 

118Définissez l'advisor comme `fable`, `opus`, ou `sonnet`. Ces alias se résolvent à la [version par défaut intégrée](/docs/fr/model-config#model-aliases) de Claude Code pour chaque famille de modèles, qui avance avec les nouvelles versions de Claude Code. Vous pouvez également passer un ID de modèle complet tel que `claude-opus-5-5`. Haiku peut appeler l'advisor mais ne peut pas en être un.118Définissez l'advisor comme `fable`, `opus`, ou `sonnet`. Ces alias se résolvent à la [version par défaut intégrée](/docs/fr/model-config#model-aliases) de Claude Code pour chaque famille de modèles, qui avance avec les nouvelles versions de Claude Code. Vous pouvez également passer un ID de modèle complet tel que `claude-opus-5-5` ou `claude-haiku-5-5`. Haiku 4.5 peut appeler l'advisor mais ne peut pas en être un.

119 119 

120Les sous-agents héritent de l'advisor configuré et appliquent la même vérification d'appairage par rapport à leur propre modèle.120Les sous-agents héritent de l'advisor configuré et appliquent la même vérification d'appairage par rapport à leur propre modèle.

121 121 


202L'outil advisor nécessite tous les éléments suivants :202L'outil advisor nécessite tous les éléments suivants :

203 203 

204* **API Anthropic uniquement** : l'advisor est un outil exécuté par le serveur. Il n'est pas disponible sur Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, ou Microsoft Foundry. Via une [passerelle LLM](/docs/fr/llm-gateway) configurée avec `ANTHROPIC_BASE_URL`, la disponibilité dépend de si la passerelle transfère la requête intacte à l'API Anthropic. Si la passerelle ou son amont ne reconnaît pas l'outil advisor, consultez [Nouvelle tentative automatique et transfert d'erreur](/docs/fr/llm-gateway-protocol#automatic-retry-and-error-forwarding) pour voir comment Claude Code répond.204* **API Anthropic uniquement** : l'advisor est un outil exécuté par le serveur. Il n'est pas disponible sur Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, ou Microsoft Foundry. Via une [passerelle LLM](/docs/fr/llm-gateway) configurée avec `ANTHROPIC_BASE_URL`, la disponibilité dépend de si la passerelle transfère la requête intacte à l'API Anthropic. Si la passerelle ou son amont ne reconnaît pas l'outil advisor, consultez [Nouvelle tentative automatique et transfert d'erreur](/docs/fr/llm-gateway-protocol#automatic-retry-and-error-forwarding) pour voir comment Claude Code répond.

205* **Modèle principal supporté** : Fable, Opus 4.6 ou ultérieur, Sonnet 4.6 ou ultérieur, ou Haiku 4.5. Voir [Choisir un modèle advisor](#choose-an-advisor-model) pour savoir quels advisors chacun accepte.205* **Modèle principal supporté** : Fable, Opus 4.6 ou ultérieur, Sonnet 4.6 ou ultérieur, Haiku 4.5, ou Haiku 5.5. Voir [Choisir un modèle advisor](#choose-an-advisor-model) pour savoir quels advisors chacun accepte.

206* **Récupération de feature flag** : Claude Code active l'advisor via un feature flag qu'il récupère auprès d'Anthropic. Dans une session où une variable qui désactive la récupération de flag est définie, comme `DISABLE_TELEMETRY`, l'advisor reste désactivé. Voir [Fonctionnalités nécessitant la récupération de feature flag](/docs/fr/env-vars#features-that-need-feature-flag-fetching).206* **Récupération de feature flag** : Claude Code active l'advisor via un feature flag qu'il récupère auprès d'Anthropic. Dans une session où une variable qui désactive la récupération de flag est définie, comme `DISABLE_TELEMETRY`, l'advisor reste désactivé. Voir [Fonctionnalités nécessitant la récupération de feature flag](/docs/fr/env-vars#features-that-need-feature-flag-fetching).

207 207 

208<h2 id="turn-the-advisor-off">208<h2 id="turn-the-advisor-off">

agent-sdk/hooks.md +12 −12

Details

36 </Step>36 </Step>

37 37 

38 <Step title="Votre rappel retourne une décision">38 <Step title="Votre rappel retourne une décision">

39 Après avoir effectué toute opération (enregistrement, appels API, validation), votre rappel retourne un [objet de sortie](#outputs) qui indique à l'agent quoi faire : autoriser l'opération, la bloquer, modifier l'entrée ou injecter du contexte dans la conversation.39 Après avoir effectué toute opération (journalisation, appels API, validation), votre rappel retourne un [objet de sortie](#outputs) qui indique à l'agent quoi faire : autoriser l'opération, la bloquer, modifier l'entrée ou injecter du contexte dans la conversation.

40 </Step>40 </Step>

41</Steps>41</Steps>

42 42 


140 ```140 ```

141</CodeGroup>141</CodeGroup>

142 142 

143Lorsque vous exécutez l'un ou l'autre script, Claude tente de créer le fichier `.env`, le hook refuse l'appel d'outil, et la réponse finale de Claude explique qu'il ne peut pas créer de fichiers `.env`.143Lorsque vous exécutez l'un ou l'autre script, Claude tente de créer le fichier `.env` et le hook refuse l'appel d'outil.

144 144 

145<h2 id="available-hooks">145<h2 id="available-hooks">

146 Hooks disponibles146 Hooks disponibles


179| `ConfigChange` | Non | Oui | Le fichier de configuration change | Recharger les paramètres dynamiquement |179| `ConfigChange` | Non | Oui | Le fichier de configuration change | Recharger les paramètres dynamiquement |

180| `InstructionsLoaded` | Non | Oui | Un fichier `CLAUDE.md` ou de règles est chargé dans le contexte | Auditer quels fichiers d'instructions se chargent |180| `InstructionsLoaded` | Non | Oui | Un fichier `CLAUDE.md` ou de règles est chargé dans le contexte | Auditer quels fichiers d'instructions se chargent |

181| `WorktreeCreate` | Non | Oui | Git worktree créé | Suivre les espaces de travail isolés |181| `WorktreeCreate` | Non | Oui | Git worktree créé | Suivre les espaces de travail isolés |

182| `WorktreeRemove` | Non | Oui | Git worktree supprimé | Nettoyer les ressources de l'espace de travail |182| `WorktreeRemove` | Non | Oui | Un worktree créé par un hook `WorktreeCreate` est en cours de suppression | Nettoyer les ressources de l'espace de travail |

183| `CwdChanged` | Non | Oui | Le répertoire de travail change pendant une session | Recharger les variables d'environnement par répertoire |183| `CwdChanged` | Non | Oui | Le répertoire de travail change pendant une session | Recharger les variables d'environnement par répertoire |

184| `FileChanged` | Non | Oui | Un fichier surveillé est modifié, créé ou supprimé | Recharger la configuration quand les fichiers du projet changent |184| `FileChanged` | Non | Oui | Un fichier surveillé est modifié, créé ou supprimé | Recharger la configuration quand les fichiers du projet changent |

185| `DirectoryAdded` | Non | Oui | Un répertoire de travail est ajouté pendant une session | Installer les dépendances pour un référentiel ajouté en cours de session |185| `DirectoryAdded` | Non | Oui | Un répertoire de travail est ajouté pendant une session | Installer les dépendances pour un référentiel ajouté en cours de session |


235| `hooks` | `HookCallback[]` | - | Requis. Tableau de fonctions de rappel à exécuter lorsque le motif correspond |235| `hooks` | `HookCallback[]` | - | Requis. Tableau de fonctions de rappel à exécuter lorsque le motif correspond |

236| `timeout` | `number` | `undefined` | Délai d'expiration en secondes. Lorsqu'il est omis, Claude Code applique le [délai d'expiration par défaut de l'événement](#hook-timeout). Vos rappels du SDK suivent les valeurs par défaut du hook `command` |236| `timeout` | `number` | `undefined` | Délai d'expiration en secondes. Lorsqu'il est omis, Claude Code applique le [délai d'expiration par défaut de l'événement](#hook-timeout). Vos rappels du SDK suivent les valeurs par défaut du hook `command` |

237 237 

238Utilisez le motif `matcher` pour cibler des outils spécifiques chaque fois que possible. Un matcher avec `'Bash'` s'exécute uniquement pour les commandes Bash, tandis que l'omission du motif exécute vos rappels pour chaque occurrence de l'événement. Omettez-le intentionnellement pour enregistrer chaque appel d'outil que votre session effectue.238Utilisez le motif `matcher` pour cibler des outils spécifiques chaque fois que possible. Un matcher avec `'Bash'` s'exécute uniquement pour les commandes Bash, tandis que l'omission du motif exécute vos rappels pour chaque occurrence de l'événement. Omettez-le intentionnellement pour journaliser chaque appel d'outil que votre session effectue.

239 239 

240<h3 id="callback-functions">240<h3 id="callback-functions">

241 Fonctions de rappel241 Fonctions de rappel


262* **Champs de niveau supérieur** sont acceptés sur chaque événement : `systemMessage` affiche un message à l'utilisateur, et `continue` (`continue_` en Python) détermine si l'agent continue à s'exécuter après ce hook. Certains événements les rejettent ou les livrent ailleurs. La section de chaque [événement](/docs/fr/hooks#hook-events) sur la page des hooks indique où ils aboutissent.262* **Champs de niveau supérieur** sont acceptés sur chaque événement : `systemMessage` affiche un message à l'utilisateur, et `continue` (`continue_` en Python) détermine si l'agent continue à s'exécuter après ce hook. Certains événements les rejettent ou les livrent ailleurs. La section de chaque [événement](/docs/fr/hooks#hook-events) sur la page des hooks indique où ils aboutissent.

263* **`hookSpecificOutput`** contrôle l'opération actuelle. Les champs que vous définissez à l'intérieur dépendent du type d'événement hook :263* **`hookSpecificOutput`** contrôle l'opération actuelle. Les champs que vous définissez à l'intérieur dépendent du type d'événement hook :

264 * Pour les hooks `PreToolUse`, c'est là que vous définissez `permissionDecision` (`"allow"`, `"deny"`, `"ask"` ou `"defer"`), `permissionDecisionReason` et `updatedInput`. Si vous retournez `"defer"`, le tour se termine par un message de résultat dont le `stop_reason` est `"tool_deferred"`, afin que vous puissiez [reprendre l'appel plus tard](/docs/fr/hooks#defer-a-tool-call-for-later).264 * Pour les hooks `PreToolUse`, c'est là que vous définissez `permissionDecision` (`"allow"`, `"deny"`, `"ask"` ou `"defer"`), `permissionDecisionReason` et `updatedInput`. Si vous retournez `"defer"`, le tour se termine par un message de résultat dont le `stop_reason` est `"tool_deferred"`, afin que vous puissiez [reprendre l'appel plus tard](/docs/fr/hooks#defer-a-tool-call-for-later).

265 * Pour les hooks `PostToolUse`, vous pouvez définir `additionalContext` pour ajouter des informations au résultat de l'outil. Pour remplacer la sortie de l'outil avant que Claude ne la voie, définissez `updatedToolOutput`, qui fonctionne pour n'importe quel outil dans les deux SDK. Le champ plus ancien `updatedMCPToolOutput` remplace uniquement la sortie de l'outil MCP et est déprécié.265 * Pour les hooks `PostToolUse`, vous pouvez définir `additionalContext` pour ajouter des informations au résultat de l'outil. Pour remplacer la sortie de l'outil avant que Claude ne la voie, définissez `updatedToolOutput`, qui fonctionne pour n'importe quel outil dans les deux SDK. Le champ plus ancien `updatedMCPToolOutput` remplace uniquement la sortie des outils MCP.

266 * Dans le SDK TypeScript, un rappel `PostToolUse` peut également retourner `classifierContext`, une courte note sur le résultat de l'appel d'outil pour le classificateur de permission du [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode). Parce que votre rappel s'exécute dans le propre processus de votre application, le classificateur peut peser une déclaration d'utilisateur que vous relayez dans la note comme intention de l'utilisateur. Le champ nécessite le SDK Agent TypeScript v0.3.236 ou ultérieur. [Annoter un résultat pour le classificateur du mode auto](/docs/fr/hooks#annotate-a-result-for-the-auto-mode-classifier) couvre le plafond de longueur, la règle synchrone uniquement, et ce qu'il ne faut pas mettre dans la note.266 * Dans le SDK TypeScript, un rappel `PostToolUse` peut également retourner `classifierContext`, une courte note sur le résultat de l'appel d'outil pour le classificateur de permission du [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode). Parce que votre rappel s'exécute dans le propre processus de votre application, le classificateur peut peser une déclaration d'utilisateur que vous relayez dans la note comme intention de l'utilisateur. Le champ nécessite le SDK Agent TypeScript v0.3.236 ou ultérieur. [Annoter un résultat pour le classificateur du mode auto](/docs/fr/hooks#annotate-a-result-for-the-auto-mode-classifier) couvre le plafond de longueur, la règle synchrone uniquement, et ce qu'il ne faut pas mettre dans la note.

267 267 

268Retournez `{}` pour autoriser l'opération sans modifications. Les hooks de rappel du SDK utilisent le même format de sortie JSON que les [hooks de commande shell Claude Code](/docs/fr/hooks#json-output), qui documente chaque champ et option spécifique à l'événement. Pour les définitions de type du SDK, consultez les références du SDK [TypeScript](/docs/fr/agent-sdk/typescript#synchookjsonoutput) et [Python](/docs/fr/agent-sdk/python#synchookjsonoutput).268Retournez `{}` pour autoriser l'opération sans modifications. Les hooks de rappel du SDK utilisent le même format de sortie JSON que les [hooks de commande shell Claude Code](/docs/fr/hooks#json-output), qui documente chaque champ et option spécifique à l'événement. Pour les définitions de type du SDK, consultez les références du SDK [TypeScript](/docs/fr/agent-sdk/typescript#synchookjsonoutput) et [Python](/docs/fr/agent-sdk/python#synchookjsonoutput).


297| Champ | Type | Description |297| Champ | Type | Description |

298| - | - | - |298| - | - | - |

299| `async` | `true` | Signale le mode asynchrone. L'agent continue sans attendre. En Python, utilisez `async_` pour éviter le mot-clé réservé. |299| `async` | `true` | Signale le mode asynchrone. L'agent continue sans attendre. En Python, utilisez `async_` pour éviter le mot-clé réservé. |

300| `asyncTimeout` | `number` | Délai d'expiration optionnel en millisecondes pour l'opération de fond |300| `asyncTimeout` | `number` | Délai d'expiration optionnel en millisecondes pour l'opération en arrière-plan |

301 301 

302<Note>302<Note>

303 Les sorties asynchrones ne peuvent pas bloquer, modifier ou injecter du contexte dans l'opération puisque l'agent a déjà avancé. Utilisez-les uniquement pour les effets secondaires comme la journalisation, les métriques ou les notifications.303 Les sorties asynchrones ne peuvent pas bloquer, modifier ou injecter du contexte dans l'opération puisque l'agent a déjà avancé. Utilisez-les uniquement pour les effets secondaires comme la journalisation, les métriques ou les notifications.


834 834 

835* `PreToolUse` : Claude Code n'exécute pas l'appel d'outil, Claude reçoit un résultat d'outil indiquant que le hook n'a pas répondu avant son délai d'expiration, et le tour continue. Si un autre hook `PreToolUse` a retourné un refus explicite, Claude reçoit ce refus à la place de l'erreur de délai d'expiration. Avant la v2.1.210, Claude Code signalait le délai d'expiration à Claude comme un refus utilisateur, ce qui faisait arrêter les sessions sans surveillance et attendre une entrée.835* `PreToolUse` : Claude Code n'exécute pas l'appel d'outil, Claude reçoit un résultat d'outil indiquant que le hook n'a pas répondu avant son délai d'expiration, et le tour continue. Si un autre hook `PreToolUse` a retourné un refus explicite, Claude reçoit ce refus à la place de l'erreur de délai d'expiration. Avant la v2.1.210, Claude Code signalait le délai d'expiration à Claude comme un refus utilisateur, ce qui faisait arrêter les sessions sans surveillance et attendre une entrée.

836* `PostToolUse` et `PostToolUseFailure` : Claude Code conserve le résultat de l'outil et le tour continue.836* `PostToolUse` et `PostToolUseFailure` : Claude Code conserve le résultat de l'outil et le tour continue.

837* `UserPromptSubmit` et [`UserPromptExpansion`](/docs/fr/hooks#userpromptexpansion) : Claude Code bloque l'invite avec un message nommant le hook et le délai d'expiration, et la session continue. Parce qu'un rappel sur ces événements peut agir comme une porte de politique, Claude Code ne laisse jamais passer une invite expirée sans contrôle. Avant la v2.1.208, Claude Code terminait la requête avec `error_during_execution` lorsqu'un rappel sur ces événements expirait.837* `UserPromptSubmit` et [`UserPromptExpansion`](/docs/fr/hooks#userpromptexpansion) : Claude Code bloque le prompt avec un message nommant le hook et le délai d'expiration, et la session continue. Parce qu'un rappel sur ces événements peut agir comme une porte de politique, Claude Code ne laisse jamais passer un prompt expiré sans contrôle. Avant la v2.1.208, Claude Code terminait la requête avec `error_during_execution` lorsqu'un rappel sur ces événements expirait.

838* `Stop` et `SubagentStop` : le rappel expiré compte comme ne retournant aucune décision. L'agent ou le sous-agent s'arrête comme si ce rappel l'avait autorisé, et une décision de vos autres hooks sur l'événement s'applique toujours. Avant Claude Code v2.1.273, un rappel `Stop` ou `SubagentStop` expiré comptait comme une exécution de hook échouée, et Claude Code rejetait les décisions de vos autres hooks sur l'événement.838* `Stop` et `SubagentStop` : le rappel expiré compte comme ne retournant aucune décision. L'agent ou le sous-agent s'arrête comme si ce rappel l'avait autorisé, et une décision de vos autres hooks sur l'événement s'applique toujours. Avant Claude Code v2.1.273, un rappel `Stop` ou `SubagentStop` expiré comptait comme une exécution de hook échouée, et Claude Code rejetait les décisions de vos autres hooks sur l'événement.

839* `SessionStart` : le rappel expiré compte comme ne retournant aucune sortie, et la session continue avec la sortie de vos autres hooks `SessionStart`.839* `SessionStart` : le rappel expiré compte comme ne retournant aucune sortie, et la session continue avec la sortie de vos autres hooks `SessionStart`.

840* `PreModelSwitch` : Claude Code bloque le changement de modèle. Un hook qui ne répond pas n'a pas approuvé le changement.840* `PreModelSwitch` : Claude Code bloque le changement de modèle. Un hook qui ne répond pas n'a pas approuvé le changement.

841* Autres événements, tels que `Notification`, `PreCompact` et `PostModelSwitch` : Claude Code enregistre l'échec et continue.841* Autres événements, tels que `Notification`, `PreCompact` et `PostModelSwitch` : Claude Code consigne l'échec dans les logs et continue.

842 842 

843La première fois qu'un rappel `Stop` ou `SessionStart` expire dans la session principale, Claude Code ajoute également un [`SDKInformationalMessage`](/docs/fr/agent-sdk/typescript#sdkinformationalmessage) au flux de messages indiquant que l'application pilotant la session n'a pas répondu. Les expirations ultérieures ne répètent pas ce message tant que votre application reste sans réponse.843La première fois qu'un rappel `Stop` ou `SessionStart` expire dans la session principale, Claude Code ajoute également un [`SDKInformationalMessage`](/docs/fr/agent-sdk/typescript#sdkinformationalmessage) au flux de messages indiquant que l'application pilotant la session n'a pas répondu. Les expirations ultérieures ne répètent pas ce message tant que votre application reste sans réponse.

844 844 


878 Hooks de session non disponibles en Python878 Hooks de session non disponibles en Python

879</h3>879</h3>

880 880 

881`SessionStart` et `SessionEnd` peuvent être enregistrés en tant que hooks de rappel du SDK en TypeScript, mais ne sont pas disponibles dans le SDK Python car son type `HookEvent` les omet. En Python, ils ne sont disponibles que comme [hooks de commande shell](/docs/fr/hooks#hook-events) définis dans les fichiers de paramètres tels que `.claude/settings.json`. Pour charger les hooks de commande shell à partir de votre application SDK, incluez la source de paramètre appropriée avec [`setting_sources`](/docs/fr/agent-sdk/python#settingsource) ou [`settingSources`](/docs/fr/agent-sdk/typescript#settingsource) :881`SessionStart` et `SessionEnd` peuvent être enregistrés en tant que hooks de rappel du SDK en TypeScript, mais ne sont pas disponibles dans le SDK Python car son type `HookEvent` les omet. En Python, ils ne sont disponibles que comme [hooks de commande shell](/docs/fr/hooks#hook-events) définis dans les fichiers de paramètres tels que `.claude/settings.json`. Les fichiers de paramètres que charge votre application SDK dépendent de [`setting_sources`](/docs/fr/agent-sdk/python#settingsource) ou de [`settingSources`](/docs/fr/agent-sdk/typescript#settingsource). Si vous définissez cette option, incluez la source qui contient les hooks :

882 882 

883<CodeGroup>883<CodeGroup>

884 ```python Python theme={null}884 ```python Python theme={null}


897Pour exécuter la logique d'initialisation en tant que rappel du SDK Python à la place, utilisez le premier message de `client.receive_response()` comme déclencheur.897Pour exécuter la logique d'initialisation en tant que rappel du SDK Python à la place, utilisez le premier message de `client.receive_response()` comme déclencheur.

898 898 

899<h3 id="subagent-permission-prompts-multiplying">899<h3 id="subagent-permission-prompts-multiplying">

900 Les invites de permission des sous-agents se multiplient900 Les demandes de permission des sous-agents se multiplient

901</h3>901</h3>

902 902 

903Lors du lancement de plusieurs sous-agents, chacun peut demander des permissions séparément pour ses propres appels d'outils. Pour éviter les invites répétées, utilisez les hooks `PreToolUse` pour approuver automatiquement des outils spécifiques, ou configurez des règles de permission, que les sous-agents [héritent de la conversation parent](/docs/fr/sub-agents#permission-modes).903Lors du lancement de plusieurs sous-agents, chacun peut demander des permissions séparément pour ses propres appels d'outils. Pour éviter les demandes répétées, utilisez les hooks `PreToolUse` pour approuver automatiquement des outils spécifiques, ou configurez des règles de permission, que les sous-agents [héritent de la conversation parent](/docs/fr/sub-agents#permission-modes).

904 904 

905<h3 id="recursive-hook-loops-with-subagents">905<h3 id="recursive-hook-loops-with-subagents">

906 Boucles de hook récursives avec des sous-agents906 Boucles de hook récursives avec des sous-agents


919 919 

920Avant la v2.1.227, le SDK ne faisait apparaître la sortie du hook dans le flux de messages que pour les hooks `SessionStart` et `Setup`. Pour tout autre événement, la sortie n'apparaissait que dans les événements de cycle de vie que [`includeHookEvents`](/docs/fr/agent-sdk/typescript#options) (`include_hook_events` en Python) ajoute. L'entrée de cette option couvre les événements de cycle de vie que chaque événement hook produit.920Avant la v2.1.227, le SDK ne faisait apparaître la sortie du hook dans le flux de messages que pour les hooks `SessionStart` et `Setup`. Pour tout autre événement, la sortie n'apparaissait que dans les événements de cycle de vie que [`includeHookEvents`](/docs/fr/agent-sdk/typescript#options) (`include_hook_events` en Python) ajoute. L'entrée de cette option couvre les événements de cycle de vie que chaque événement hook produit.

921 921 

922Si vous avez besoin de faire apparaître les décisions de hook à votre application de manière fiable, enregistrez-les séparément ou utilisez un canal de sortie dédié.922Si vous avez besoin de faire apparaître les décisions de hook à votre application de manière fiable, journalisez-les séparément ou utilisez un canal de sortie dédié.

923 923 

924<h2 id="related-resources">924<h2 id="related-resources">

925 Ressources connexes925 Ressources connexes

Details

194 `ToolAnnotations`194 `ToolAnnotations`

195</h4>195</h4>

196 196 

197Indices comportementaux pour un outil, passés comme argument `annotations` de [`tool()`](#tool). `ToolAnnotations` étend `mcp.types.ToolAnnotations` du SDK MCP avec un champ `maxResultSizeChars`, et vous pouvez écrire chaque indice en camelCase ou snake\_case : `ToolAnnotations(readOnlyHint=True)` et `ToolAnnotations(read_only_hint=True)` sont équivalents. Vous pouvez également passer un `mcp.types.ToolAnnotations` simple partout où le SDK accepte des annotations.197Indices comportementaux pour un outil, passés comme argument `annotations` de [`tool()`](#tool). `ToolAnnotations` étend `mcp.types.ToolAnnotations` du SDK MCP avec un champ `maxResultSizeChars`, et vous pouvez écrire chaque indice en camelCase ou snake\_case : `ToolAnnotations(readOnlyHint=True)` et `ToolAnnotations(read_only_hint=True)` sont équivalents. Pour relire un indice depuis l'objet, utilisez l'orthographe déclarée par votre package `mcp` installé : `.readOnlyHint` sur `mcp` 1.x et `.read_only_hint` sur 2.x, tandis que `.maxResultSizeChars` fonctionne sur les deux. Vous pouvez également passer un `mcp.types.ToolAnnotations` simple partout où le SDK accepte des annotations.

198 198 

199Les noms snake\_case et le champ typé `maxResultSizeChars` nécessitent Python Agent SDK 0.2.140 ou ultérieur. Les versions 0.1.31 à 0.2.139 réexportent `mcp.types.ToolAnnotations` inchangé. Sur les versions 0.1.55 à 0.2.139, vous pouvez toujours passer `maxResultSizeChars` comme argument de mot-clé : la classe MCP accepte les champs supplémentaires, et le SDK transmet la valeur à Claude Code.199Les noms snake\_case et le champ typé `maxResultSizeChars` nécessitent Python Agent SDK 0.2.140 ou ultérieur. Les versions 0.1.31 à 0.2.139 réexportent `mcp.types.ToolAnnotations` inchangé. Sur les versions 0.1.55 à 0.2.139, vous pouvez toujours passer `maxResultSizeChars` comme argument de mot-clé : la classe MCP accepte les champs supplémentaires, et le SDK transmet la valeur à Claude Code.

200 200 


321| `summary` | `str` | Titre d'affichage : titre personnalisé, prompt le plus récent, résumé généré automatiquement, ou premier prompt |321| `summary` | `str` | Titre d'affichage : titre personnalisé, prompt le plus récent, résumé généré automatiquement, ou premier prompt |

322| `last_modified` | `int` | Heure de dernière modification en millisecondes depuis l'époque |322| `last_modified` | `int` | Heure de dernière modification en millisecondes depuis l'époque |

323| `file_size` | `int \| None` | Taille du fichier de session en octets (`None` pour les backends de stockage distant) |323| `file_size` | `int \| None` | Taille du fichier de session en octets (`None` pour les backends de stockage distant) |

324| `custom_title` | `str \| None` | Titre de session défini par l'utilisateur |324| `custom_title` | `str \| None` | Titre de session : le titre défini par l'utilisateur, ou le titre généré automatiquement si aucun n'est défini |

325| `first_prompt` | `str \| None` | Premier prompt utilisateur significatif dans la session |325| `first_prompt` | `str \| None` | Premier prompt utilisateur significatif dans la session |

326| `git_branch` | `str \| None` | Branche git à la fin de la session |326| `git_branch` | `str \| None` | Branche git à la fin de la session |

327| `cwd` | `str \| None` | Répertoire de travail pour la session |327| `cwd` | `str \| None` | Répertoire de travail pour la session |


919| Property | Type | Default | Description |919| Property | Type | Default | Description |

920| :- | :- | :- | :- |920| :- | :- | :- | :- |

921| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Configuration des outils. Utilisez `{"type": "preset", "preset": "claude_code"}` pour les outils par défaut de Claude Code |921| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Configuration des outils. Utilisez `{"type": "preset", "preset": "claude_code"}` pour les outils par défaut de Claude Code |

922| `allowed_tools` | `list[str]` | `[]` | Outils à approuver automatiquement sans demander. Cela ne restreint pas Claude à seulement ces outils. Si vous nommez l'un des [outils de suivi des tâches](/docs/fr/agent-sdk/todo-tracking#model-availability) ici, Claude Code opte également la session. Les autres outils non listés passent à `permission_mode` et `can_use_tool`. Utilisez `disallowed_tools` pour bloquer les outils. Voir [Permissions](/docs/fr/agent-sdk/permissions#allow-and-deny-rules) |922| `allowed_tools` | `list[str]` | `[]` | Outils à approuver automatiquement sans demander. Cela ne restreint pas Claude à seulement ces outils. Si vous nommez l'un des [outils de suivi des tâches](/docs/fr/agent-sdk/todo-tracking#model-availability) ici, Claude Code active également cette fonctionnalité pour la session. Les autres outils non listés passent à `permission_mode` et `can_use_tool`. Utilisez `disallowed_tools` pour bloquer les outils. Voir [Permissions](/docs/fr/agent-sdk/permissions#allow-and-deny-rules) |

923| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptCustom \| SystemPromptFile \| None` | `None` | Configuration du prompt système. Passez une chaîne pour un prompt personnalisé, `{"type": "preset", "preset": "claude_code"}` pour le prompt système de Claude Code avec `"append"` optionnel, `{"type": "custom", "prompt": "..."}` pour un prompt personnalisé qui peut également définir `"snapshot"`, ou `{"type": "file", "path": "..."}` pour charger un grand prompt depuis le disque. Voir [`SystemPromptPreset`](#systempromptpreset), [`SystemPromptCustom`](#systempromptcustom), et [`SystemPromptFile`](#systempromptfile) |923| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptCustom \| SystemPromptFile \| None` | `None` | Configuration du prompt système. Passez une chaîne pour un prompt personnalisé, `{"type": "preset", "preset": "claude_code"}` pour le prompt système de Claude Code avec `"append"` optionnel, `{"type": "custom", "prompt": "..."}` pour un prompt personnalisé qui peut également définir `"snapshot"`, ou `{"type": "file", "path": "..."}` pour charger un grand prompt depuis le disque. Voir [`SystemPromptPreset`](#systempromptpreset), [`SystemPromptCustom`](#systempromptcustom), et [`SystemPromptFile`](#systempromptfile) |

924| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | Configurations des serveurs MCP ou chemin vers un fichier de configuration |924| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | Configurations des serveurs MCP ou chemin vers un fichier de configuration |

925| `strict_mcp_config` | `bool` | `False` | Quand `True`, utilisez uniquement les serveurs passés dans `mcp_servers` et ignorez le `.mcp.json` du projet, les paramètres utilisateur, les serveurs MCP fournis par les plugins, et les [connecteurs claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai). Correspond au drapeau CLI `--strict-mcp-config` |925| `strict_mcp_config` | `bool` | `False` | Quand `True`, utilisez uniquement les serveurs passés dans `mcp_servers` et ignorez le `.mcp.json` du projet, les paramètres utilisateur, les serveurs MCP fournis par les plugins, et les [connecteurs claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai). Correspond au flag CLI `--strict-mcp-config` |

926| `permission_mode` | `PermissionMode \| None` | `None` | Mode de permission pour l'utilisation des outils |926| `permission_mode` | `PermissionMode \| None` | `None` | Mode de permission pour l'utilisation des outils |

927| `continue_conversation` | `bool` | `False` | Continuer la conversation la plus récente |927| `continue_conversation` | `bool` | `False` | Continuer la conversation la plus récente |

928| `resume` | `str \| None` | `None` | ID de session à reprendre |928| `resume` | `str \| None` | `None` | ID de session à reprendre |


930| `max_turns` | `int \| None` | `None` | Nombre maximum de tours d'agent (allers-retours d'utilisation d'outils) |930| `max_turns` | `int \| None` | `None` | Nombre maximum de tours d'agent (allers-retours d'utilisation d'outils) |

931| `max_budget_usd` | `float \| None` | `None` | Arrêter la requête quand l'estimation du coût côté client atteint cette valeur en USD. Compte uniquement les dépenses de l'appel lui-même ; les totaux restaurés à partir d'une session reprise ne comptent pas. Pour les avertissements de précision et le comportement de réinitialisation, voir [Suivre le coût et l'utilisation](/docs/fr/agent-sdk/cost-tracking) |931| `max_budget_usd` | `float \| None` | `None` | Arrêter la requête quand l'estimation du coût côté client atteint cette valeur en USD. Compte uniquement les dépenses de l'appel lui-même ; les totaux restaurés à partir d'une session reprise ne comptent pas. Pour les avertissements de précision et le comportement de réinitialisation, voir [Suivre le coût et l'utilisation](/docs/fr/agent-sdk/cost-tracking) |

932| `disallowed_tools` | `list[str]` | `[]` | Outils à refuser. Un nom simple tel que `"Bash"` supprime l'outil du contexte de Claude. Une règle délimitée telle que `"Bash(rm *)"` laisse l'outil disponible et refuse les appels correspondants dans chaque mode de permission, y compris `bypassPermissions`, pour la commande [telle qu'écrite](/docs/fr/permissions#bash-rule-limits). Voir [Permissions](/docs/fr/agent-sdk/permissions#allow-and-deny-rules) |932| `disallowed_tools` | `list[str]` | `[]` | Outils à refuser. Un nom simple tel que `"Bash"` supprime l'outil du contexte de Claude. Une règle délimitée telle que `"Bash(rm *)"` laisse l'outil disponible et refuse les appels correspondants dans chaque mode de permission, y compris `bypassPermissions`, pour la commande [telle qu'écrite](/docs/fr/permissions#bash-rule-limits). Voir [Permissions](/docs/fr/agent-sdk/permissions#allow-and-deny-rules) |

933| `enable_file_checkpointing` | `bool` | `False` | Activer le suivi des modifications de fichiers pour la rembobinage. Voir [Checkpointing de fichiers](/docs/fr/agent-sdk/file-checkpointing) |933| `enable_file_checkpointing` | `bool` | `False` | Activer le suivi des modifications de fichiers pour le rembobinage. Voir [Checkpointing de fichiers](/docs/fr/agent-sdk/file-checkpointing) |

934| `model` | `str \| None` | `None` | Alias de modèle Claude ou nom de modèle complet. Voir [valeurs acceptées et IDs spécifiques au fournisseur](/docs/fr/model-config#available-models) |934| `model` | `str \| None` | `None` | Alias de modèle Claude ou nom de modèle complet. Voir [valeurs acceptées et IDs spécifiques au fournisseur](/docs/fr/model-config#available-models) |

935| `fallback_model` | `str \| None` | `None` | Modèle de secours à utiliser si le modèle principal échoue. Accepte une liste séparée par des virgules. Pour des conseils, voir [Choisir un modèle](/docs/fr/agent-sdk/configuration#choose-a-model) |935| `fallback_model` | `str \| None` | `None` | Modèle de secours à utiliser si le modèle principal échoue. Accepte une liste séparée par des virgules. Pour des conseils, voir [Choisir un modèle](/docs/fr/agent-sdk/configuration#choose-a-model) |

936| `betas` | `list[SdkBeta]` | `[]` | Fonctionnalités bêta à activer. Voir [`SdkBeta`](#sdkbeta) pour les options disponibles |936| `betas` | `list[SdkBeta]` | `[]` | Fonctionnalités bêta à activer. Voir [`SdkBeta`](#sdkbeta) pour les options disponibles |

937| `output_format` | `dict[str, Any] \| None` | `None` | Format de sortie pour les réponses structurées (par exemple, `{"type": "json_schema", "schema": {...}}`). Voir [Sorties structurées](/docs/fr/agent-sdk/structured-outputs) pour les détails |937| `output_format` | `dict[str, Any] \| None` | `None` | Format de sortie pour les réponses structurées (par exemple, `{"type": "json_schema", "schema": {...}}`). Voir [Sorties structurées](/docs/fr/agent-sdk/structured-outputs) pour les détails |

938| `permission_prompt_tool_name` | `str \| None` | `None` | Nom de l'outil MCP pour les invites de permission |938| `permission_prompt_tool_name` | `str \| None` | `None` | Nom de l'outil MCP pour les demandes de permission |

939| `cwd` | `str \| Path \| None` | `None` | Répertoire de travail courant |939| `cwd` | `str \| Path \| None` | `None` | Répertoire de travail courant |

940| `cli_path` | `str \| Path \| None` | `None` | Chemin personnalisé vers l'exécutable CLI de Claude Code |940| `cli_path` | `str \| Path \| None` | `None` | Chemin personnalisé vers l'exécutable CLI de Claude Code |

941| `settings` | `str \| None` | `None` | Chemin vers un fichier de paramètres ou une chaîne JSON en ligne |941| `settings` | `str \| None` | `None` | Chemin vers un fichier de paramètres ou une chaîne JSON en ligne |

942| `add_dirs` | `list[str \| Path]` | `[]` | Répertoires supplémentaires auxquels Claude peut accéder. Le SDK transmet chaque entrée à Claude Code en tant que `--add-dir`, donc avec la source de paramètre `project` Claude Code [charge également les compétences, commandes et sous-agents du répertoire](/docs/fr/permissions#additional-directories-grant-file-access-not-configuration) |942| `add_dirs` | `list[str \| Path]` | `[]` | Répertoires supplémentaires auxquels Claude peut accéder. Le SDK transmet chaque entrée à Claude Code en tant que `--add-dir`, donc avec la source de paramètre `project` Claude Code [charge également les skills, commandes et sous-agents du répertoire](/docs/fr/permissions#additional-directories-grant-file-access-not-configuration) |

943| `env` | `dict[str, str]` | `{}` | Variables d'environnement fusionnées au-dessus de l'environnement de processus hérité. Voir [Variables d'environnement](/docs/fr/env-vars) pour les variables que le CLI sous-jacent lit, et [Gérer les réponses API lentes ou bloquées](#handle-slow-or-stalled-api-responses) pour les variables liées aux délais d'attente. Définissez `CLAUDE_AGENT_SDK_CLIENT_APP` pour identifier votre application dans l'en-tête User-Agent |943| `env` | `dict[str, str]` | `{}` | Variables d'environnement fusionnées au-dessus de l'environnement de processus hérité. Voir [Variables d'environnement](/docs/fr/env-vars) pour les variables que le CLI sous-jacent lit, et [Gérer les réponses API lentes ou bloquées](#handle-slow-or-stalled-api-responses) pour les variables liées aux délais d'attente. Définissez `CLAUDE_AGENT_SDK_CLIENT_APP` pour identifier votre application dans l'en-tête User-Agent |

944| `extra_args` | `dict[str, str \| None]` | `{}` | Arguments CLI supplémentaires à transmettre directement au CLI |944| `extra_args` | `dict[str, str \| None]` | `{}` | Arguments CLI supplémentaires à transmettre directement au CLI |

945| `max_buffer_size` | `int \| None` | `None` | Nombre maximum d'octets lors de la mise en mémoire tampon de la sortie standard du CLI |945| `max_buffer_size` | `int \| None` | `None` | Nombre maximum d'octets lors de la mise en mémoire tampon de la sortie standard du CLI |

946| `debug_stderr` | `Any` | `sys.stderr` | *Déprécié* - Le SDK ignore cette valeur. Utilisez le rappel `stderr` pour la sortie stderr du CLI |946| `debug_stderr` | `Any` | `sys.stderr` | *Déprécié* - Le SDK ignore cette valeur. Utilisez le rappel `stderr` pour la sortie stderr du CLI |

947| `stderr` | `Callable[[str], None] \| None` | `None` | Fonction de rappel pour la sortie stderr du CLI |947| `stderr` | `Callable[[str], None] \| None` | `None` | Fonction de rappel pour la sortie stderr du CLI |

948| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Rappel de permission d'outil, invoqué uniquement quand le [flux de permission](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) aboutit à une invite. Non invoqué pour les appels pré-approuvés par `allowed_tools`, les règles d'autorisation, ou `permission_mode`. Une règle d'autorisation ne pré-approuve pas les [actions qu'aucun mode n'approuve automatiquement](/docs/fr/permission-modes#actions-no-mode-auto-approves). Voir [`CanUseTool`](#canusetool) pour les détails |948| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Rappel de permission d'outil, invoqué uniquement quand le [flux de permission](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) aboutit à une demande de permission. Non invoqué pour les appels approuvés automatiquement par `allowed_tools`, les règles d'autorisation, ou `permission_mode`. Une règle d'autorisation ne pré-approuve pas les [actions qu'aucun mode n'approuve automatiquement](/docs/fr/permission-modes#actions-no-mode-auto-approves). Voir [`CanUseTool`](#canusetool) pour les détails |

949| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | Configurations de hook pour intercepter les événements |949| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | Configurations de hook pour intercepter les événements |

950| `user` | `str \| None` | `None` | Sur les plates-formes POSIX, le compte utilisateur du système d'exploitation sous lequel le sous-processus Claude Code s'exécute. Claude Code conserve l'environnement du processus parent, y compris `HOME`, et s'exécute dans `cwd` |950| `user` | `str \| None` | `None` | Sur les plates-formes POSIX, le compte utilisateur du système d'exploitation sous lequel le sous-processus Claude Code s'exécute. Claude Code conserve l'environnement du processus parent, y compris `HOME`, et s'exécute dans `cwd` |

951| `include_partial_messages` | `bool` | `False` | Inclure les événements de diffusion de messages partiels. Quand activé, les messages [`StreamEvent`](#streamevent) sont produits |951| `include_partial_messages` | `bool` | `False` | Inclure les événements de streaming de messages partiels. Quand activé, les messages [`StreamEvent`](#streamevent) sont produits |

952| `include_hook_events` | `bool` | `False` | Inclure les événements du cycle de vie des hooks dans le flux de messages en tant qu'objets `HookEventMessage` |952| `include_hook_events` | `bool` | `False` | Inclure les événements du cycle de vie des hooks dans le flux de messages en tant qu'objets `HookEventMessage` |

953| `forward_subagent_text` | `bool` | `False` | Transmettre les blocs de texte et de réflexion des sous-agents dans le flux de messages. Sans cette option, Claude Code émet les blocs `tool_use` et `tool_result` des sous-agents mais pas le texte ou la réflexion. Nécessite Python Agent SDK 0.2.140 ou ultérieur |953| `forward_subagent_text` | `bool` | `False` | Transmettre les blocs de texte et de réflexion des sous-agents dans le flux de messages. Sans cette option, Claude Code omet les blocs de texte et de réflexion d'un sous-agent qui s'exécute au [premier plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background). Pour les sous-agents imbriqués, les skills avec `context: fork`, et la version de Claude Code requise pour chacun, voir [Suivre les messages des sous-agents](/docs/fr/headless#follow-subagent-messages). Nécessite Python Agent SDK 0.2.140 ou ultérieur |

954| `verbatim_prompts` | `bool` | `False` | Livrer chaque invite telle qu'écrite. Le SDK envoie chaque message utilisateur avec `client_composed` défini à `True`. Voir [`client_composed`](/docs/fr/agent-sdk/typescript#sdkusermessage) pour ce que Claude Code ignore sur ces messages. Utilisez cette option quand votre texte d'invite inclut du contenu que l'utilisateur final n'a pas tapé. Pour un contrôle par tour, laissez-le désactivé et définissez `"client_composed": True` sur les messages diffusés individuels à la place. Pendant que l'option est activée, le SDK écrase toute valeur `client_composed` que vous définissez. Nécessite Python Agent SDK 0.2.158 ou ultérieur et Claude Code v2.1.248 ou ultérieur ; le CLI fourni avec ces versions du SDK satisfait l'exigence de Claude Code |954| `verbatim_prompts` | `bool` | `False` | Livrer chaque prompt tel qu'écrit. Le SDK envoie chaque message utilisateur avec `client_composed` défini à `True`. Voir [`client_composed`](/docs/fr/agent-sdk/typescript#sdkusermessage) pour ce que Claude Code ignore sur ces messages. Utilisez cette option quand le texte de votre prompt inclut du contenu que l'utilisateur final n'a pas tapé. Pour un contrôle par tour, laissez-la désactivée et définissez plutôt `"client_composed": True` sur les messages individuels envoyés en streaming. Pendant que l'option est activée, le SDK écrase toute valeur `client_composed` que vous définissez. Nécessite Python Agent SDK 0.2.158 ou ultérieur et Claude Code v2.1.248 ou ultérieur ; le CLI fourni avec ces versions du SDK satisfait l'exigence de Claude Code |

955| `fork_session` | `bool` | `False` | Lors de la reprise avec `resume`, bifurquer vers un nouvel ID de session au lieu de continuer la session d'origine |955| `fork_session` | `bool` | `False` | Lors de la reprise avec `resume`, bifurquer vers un nouvel ID de session au lieu de continuer la session d'origine |

956| `resume_session_at` | `str \| None` | `None` | Lors de la reprise, charger la conversation uniquement jusqu'à et y compris le message avec cet UUID. Utilisez avec `resume`, et généralement `fork_session`, pour brancher à partir d'un point antérieur. Nécessite Python Agent SDK 0.2.137 ou ultérieur |956| `resume_session_at` | `str \| None` | `None` | Lors de la reprise, charger la conversation uniquement jusqu'à et y compris le message avec cet UUID. Utilisez avec `resume`, et généralement `fork_session`, pour créer une branche à partir d'un point antérieur. Nécessite Python Agent SDK 0.2.137 ou ultérieur |

957| `resume_drops_turn` | `str \| None` | `None` | UUID de l'invite utilisateur dont le tour une troncature `resume_session_at` rejette. Quand défini, le CLI refuse la reprise si la plage rejetée contient des entrées non attribuables à ce tour. Nécessite Python Agent SDK 0.2.137 ou ultérieur et Claude Code v2.1.223 ou ultérieur ; le CLI fourni avec ces versions du SDK satisfait l'exigence de Claude Code |957| `resume_drops_turn` | `str \| None` | `None` | UUID du prompt utilisateur dont le tour est rejeté par une troncature `resume_session_at`. Quand défini, le CLI refuse la reprise si la plage rejetée contient des entrées non attribuables à ce tour. Nécessite Python Agent SDK 0.2.137 ou ultérieur et Claude Code v2.1.223 ou ultérieur ; le CLI fourni avec ces versions du SDK satisfait l'exigence de Claude Code |

958| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Sous-agents définis par programmation |958| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Sous-agents définis par programmation |

959| `plugins` | `list[SdkPluginConfig]` | `[]` | Charger des plugins personnalisés à partir de chemins locaux. Voir [Plugins](/docs/fr/agent-sdk/plugins) pour les détails |959| `plugins` | `list[SdkPluginConfig]` | `[]` | Charger des plugins personnalisés à partir de chemins locaux. Voir [Plugins](/docs/fr/agent-sdk/plugins) pour les détails |

960| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Configurer le comportement du sandbox par programmation. Voir [Paramètres du sandbox](#sandboxsettings) pour les détails |960| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Configurer le comportement du sandbox par programmation. Voir [Paramètres du sandbox](#sandboxsettings) pour les détails |

961| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Contrôler quels paramètres du système de fichiers charger. Passez `[]` pour désactiver les paramètres utilisateur, projet et locaux. Avec `skills` défini et ce champ non défini, seules les sources utilisateur et projet se chargent. Définissez `setting_sources` explicitement pour conserver les paramètres locaux. La politique gérée par le point de terminaison se charge indépendamment ; les paramètres gérés par le serveur sont récupérés quand la session s'authentifie avec une credential d'organisation sur une [configuration éligible](/docs/fr/server-managed-settings#platform-availability). Pour les entrées lues indépendamment de cette option, voir [Ce que settingSources ne contrôle pas](/docs/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) |961| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Contrôler quels paramètres du système de fichiers charger. Passez `[]` pour désactiver les paramètres utilisateur, projet et locaux. Avec `skills` défini et ce champ non défini, seules les sources utilisateur et projet se chargent. Définissez `setting_sources` explicitement pour conserver les paramètres locaux. La politique gérée par le point de terminaison se charge indépendamment ; les paramètres gérés par le serveur sont récupérés quand la session s'authentifie avec des identifiants d'organisation sur une [configuration éligible](/docs/fr/server-managed-settings#platform-availability). Pour les entrées lues indépendamment de cette option, voir [Ce que settingSources ne contrôle pas](/docs/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

962| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Compétences disponibles pour la session. Passez `"all"` pour activer chaque compétence découverte, ou une liste de noms de compétences. Passez uniquement les noms exacts. Le SDK rejette les noms mal formés et de forme générique avec une `ValueError` avant de démarrer le processus Claude Code ; cette vérification nécessite Python Agent SDK 0.2.129 ou ultérieur. Quand défini, le SDK ajoute l'outil Skill à `allowed_tools` automatiquement. Si vous passez également `tools`, incluez `"Skill"` dans cette liste. Voir [Compétences](/docs/fr/agent-sdk/skills) |962| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills disponibles pour la session. Passez `"all"` pour activer chaque skill découvert, ou une liste de noms de skills. Passez uniquement les noms exacts. Le SDK rejette les noms mal formés et de forme générique avec une `ValueError` avant de démarrer le processus Claude Code ; cette vérification nécessite Python Agent SDK 0.2.129 ou ultérieur. Quand défini, le SDK ajoute l'outil Skill à `allowed_tools` automatiquement. Si vous passez également `tools`, incluez `"Skill"` dans cette liste. Voir [Skills](/docs/fr/agent-sdk/skills) |

963| `max_thinking_tokens` | `int \| None` | `None` | *Déprécié* - Nombre maximum de tokens pour les blocs de réflexion. Utilisez `thinking` à la place |963| `max_thinking_tokens` | `int \| None` | `None` | *Déprécié* - Nombre maximum de tokens pour les blocs de réflexion. Utilisez `thinking` à la place |

964| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | Contrôle le comportement de la réflexion étendue. Prend la priorité sur `max_thinking_tokens` |964| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | Contrôle le comportement de la réflexion étendue. A priorité sur `max_thinking_tokens` |

965| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | Niveau d'effort pour la profondeur de réflexion. Voir [ajuster le niveau d'effort](/docs/fr/model-config#adjust-effort-level) |965| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | Niveau d'effort pour la profondeur de réflexion. Voir [ajuster le niveau d'effort](/docs/fr/model-config#adjust-effort-level) |

966| `session_store` | [`SessionStore`](/docs/fr/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Refléter les transcriptions de session vers un backend externe afin qu'un autre hôte puisse les reprendre. Voir [Persister les sessions vers un stockage externe](/docs/fr/agent-sdk/session-storage) |966| `session_store` | [`SessionStore`](/docs/fr/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Refléter les transcriptions de session vers un backend externe afin qu'un autre hôte puisse les reprendre. Voir [Persister les sessions vers un stockage externe](/docs/fr/agent-sdk/session-storage) |

967| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Quand vider les entrées de transcription refléchies vers `session_store`. `"batched"` vide une fois par tour ou quand le tampon se remplit ; `"eager"` déclenche un vidage en arrière-plan après chaque frame. Ignoré quand `session_store` est `None` |967| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Quand vider les entrées de transcription reflétées vers `session_store`. `"batched"` vide une fois par tour ou quand le tampon se remplit ; `"eager"` déclenche un vidage en arrière-plan après chaque frame. Ignoré quand `session_store` est `None` |

968| `load_timeout_ms` | `int` | `60000` | Délai d'attente par appel pour `session_store.load()` et `list_subkeys()` lors de la matérialisation de la reprise, en millisecondes |968| `load_timeout_ms` | `int` | `60000` | Délai d'attente par appel pour `session_store.load()` et `list_subkeys()` lors de la matérialisation de la reprise, en millisecondes |

969| `task_budget` | `TaskBudget \| None` | `None` | Budget de tokens côté API. Envoyé en tant que `output_config.task_budget` avec l'en-tête bêta `task-budgets-2026-03-13`. Passez `{"total": <int>}`. |969| `task_budget` | `TaskBudget \| None` | `None` | Budget de tokens côté API. Envoyé en tant que `output_config.task_budget` avec l'en-tête bêta `task-budgets-2026-03-13`. Passez `{"total": <int>}`. |

970 970 


987```987```

988 988 

989* `API_TIMEOUT_MS` : délai d'attente par requête sur le client Anthropic, en millisecondes. Par défaut `600000`. S'applique à la boucle principale et à tous les sous-agents.989* `API_TIMEOUT_MS` : délai d'attente par requête sur le client Anthropic, en millisecondes. Par défaut `600000`. S'applique à la boucle principale et à tous les sous-agents.

990* `CLAUDE_CODE_MAX_RETRIES` : nombre maximum de tentatives d'API. Par défaut `10`, plafonné à `15`. Chaque tentative obtient sa propre fenêtre `API_TIMEOUT_MS`, donc le pire cas de temps mural est à peu près `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` plus le backoff. Pour les exécutions sans surveillance qui doivent attendre les pannes plus longues, définissez [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/fr/errors#tune-retry-behavior) : il réessaie les erreurs de capacité transitoires indéfiniment et, sur Claude Code v2.1.199 ou ultérieur, augmente la valeur par défaut pour les autres erreurs transitoires à `300` et supprime le plafond sur cette variable.990* `CLAUDE_CODE_MAX_RETRIES` : nombre maximum de nouvelles tentatives d'API. Par défaut `10`, plafonné à `15`. Chaque tentative obtient sa propre fenêtre `API_TIMEOUT_MS`, donc le pire cas de temps mural est à peu près `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` plus le backoff. Pour les exécutions sans surveillance qui doivent attendre la fin de pannes plus longues, définissez [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/fr/errors#tune-retry-behavior) : il réessaie les erreurs de capacité transitoires indéfiniment et, sur Claude Code v2.1.199 ou ultérieur, augmente la valeur par défaut pour les autres erreurs transitoires à `300` et supprime le plafond sur cette variable.

991* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` : chien de garde de blocage pour les sous-agents. Pendant que le chien de garde de flux est activé, la valeur par défaut est `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 minutes, ce qui donne `600000` sauf si vous augmentez cette variable. Avec le chien de garde de flux désactivé, la valeur par défaut est `600000`. Avant v2.1.257, la valeur par défaut était toujours `600000`.991* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` : chien de garde de blocage pour les sous-agents. Pendant que le chien de garde de flux est activé, la valeur par défaut est `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 minutes, ce qui donne `600000` sauf si vous augmentez cette variable. Avec le chien de garde de flux désactivé, la valeur par défaut est `600000`. Avant v2.1.257, la valeur par défaut était toujours `600000`.

992 992 

993 Le minuteur se réinitialise à chaque événement de flux. En cas de blocage, Claude Code abandonne le sous-agent et signale le blocage au parent. Pour un sous-agent en arrière-plan, il marque également la tâche comme échouée et joint tout résultat partiel.993 Le minuteur se réinitialise à chaque événement de flux. En cas de blocage, Claude Code abandonne le sous-agent et signale le blocage au parent. Pour un sous-agent en arrière-plan, il marque également la tâche comme échouée et joint tout résultat partiel.

994* `CLAUDE_ENABLE_STREAM_WATCHDOG` avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` : chien de garde de flux qui abandonne la requête quand les en-têtes sont arrivés mais que le corps de la réponse cesse de diffuser. Le chien de garde est activé par défaut pour tous les fournisseurs ; définissez `CLAUDE_ENABLE_STREAM_WATCHDOG=0` pour le désactiver. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` par défaut à `300000` et est limité à ce minimum. Après l'abandon, [Tentatives automatiques](/docs/fr/errors#automatic-retries) couvre ce que Claude Code fait, en fonction de la progression de la réponse.994* `CLAUDE_ENABLE_STREAM_WATCHDOG` avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` : chien de garde de flux qui abandonne la requête quand les en-têtes sont arrivés mais que le corps de la réponse cesse d'être envoyé en streaming. Le chien de garde est activé par défaut pour tous les fournisseurs ; définissez `CLAUDE_ENABLE_STREAM_WATCHDOG=0` pour le désactiver. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` vaut par défaut `300000` et est limité à ce minimum. Après l'abandon, [Nouvelles tentatives automatiques](/docs/fr/errors#automatic-retries) décrit ce que fait Claude Code, en fonction de la progression de la réponse.

995 995 

996 Pendant que le chien de garde attend une réponse qu'une passerelle derrière `ANTHROPIC_BASE_URL` maintient ouverte avec des pings de maintien de connexion, un hôte qui définit `include_partial_messages` continue de recevoir des messages [`StreamEvent`](#streamevent) de `ping`. Lisez ces frames comme une vivacité plutôt que de chronométrer la session sur le silence. Avant v2.1.257, les frames s'arrêtaient 5 minutes après le dernier événement de flux réel.996 Pendant que le chien de garde attend une réponse qu'une passerelle derrière `ANTHROPIC_BASE_URL` maintient ouverte avec des pings de maintien de connexion, un hôte qui définit `include_partial_messages` continue de recevoir des messages [`StreamEvent`](#streamevent) de `ping`. Interprétez ces frames comme un signe d'activité plutôt que de faire expirer la session en cas de silence. Avant v2.1.257, les frames s'arrêtaient 5 minutes après le dernier événement de flux réel.

997 997 

998<h3 id="outputformat">998<h3 id="outputformat">

999 `OutputFormat`999 `OutputFormat`


1034| `type` | Yes | Doit être `"preset"` pour utiliser un prompt système prédéfini |1034| `type` | Yes | Doit être `"preset"` pour utiliser un prompt système prédéfini |

1035| `preset` | Yes | Doit être `"claude_code"` pour utiliser le prompt système de Claude Code |1035| `preset` | Yes | Doit être `"claude_code"` pour utiliser le prompt système de Claude Code |

1036| `append` | No | Instructions supplémentaires à ajouter au prompt système prédéfini |1036| `append` | No | Instructions supplémentaires à ajouter au prompt système prédéfini |

1037| `exclude_dynamic_sections` | No | Déplacer le contexte par session tel que le répertoire de travail, le drapeau du dépôt git, et les chemins de mémoire automatique du prompt système vers le premier message utilisateur. Améliore la réutilisation du cache de prompt entre les utilisateurs et les machines. Voir [Modifier les prompts système](/docs/fr/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |1037| `exclude_dynamic_sections` | No | Déplacer le contexte propre à chaque utilisateur, tel que l'emplacement de la mémoire automatique, du prompt système vers le premier message utilisateur. Améliore la réutilisation du cache de prompt entre les utilisateurs et les machines. Voir [Modifier les prompts système](/docs/fr/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

1038| `snapshot` | No | Définissez à `False` pour reconstruire le prompt système à chaque requête au lieu de [réutiliser le prompt que la session a enregistré à sa première requête](/docs/fr/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Nécessite `claude-agent-sdk` v0.2.153 ou ultérieur |1038| `snapshot` | No | Définissez à `False` pour reconstruire le prompt système à chaque requête au lieu de [réutiliser le prompt que la session a enregistré à sa première requête](/docs/fr/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Nécessite `claude-agent-sdk` v0.2.153 ou ultérieur |

1039 1039 

1040<h3 id="systempromptcustom">1040<h3 id="systempromptcustom">


1060 `SystemPromptFile`1060 `SystemPromptFile`

1061</h3>1061</h3>

1062 1062 

1063Configuration pour charger un prompt système personnalisé à partir d'un fichier au lieu de le passer en tant que chaîne. Le SDK mappe ceci au drapeau CLI [`--system-prompt-file`](/docs/fr/cli-reference#system-prompt-flags). Utilisez la forme fichier quand le prompt est volumineux : le SDK transmet un `system_prompt` chaîne sur l'argv du sous-processus CLI, qui est soumis aux limites de longueur de ligne de commande du système d'exploitation avant que le SDK n'envoie une requête API. Sur Linux, un seul argument plus long que environ 128 KB échoue au lancement du processus avec `Argument list too long`. Sur Windows, la ligne de commande entière est plafonnée à environ 32 KB, donc la forme chaîne échoue à un seuil inférieur.1063Configuration pour charger un prompt système personnalisé à partir d'un fichier au lieu de le passer en tant que chaîne. Le SDK mappe ceci au flag CLI [`--system-prompt-file`](/docs/fr/cli-reference#system-prompt-flags). Utilisez la forme fichier quand le prompt est volumineux : le SDK transmet un `system_prompt` chaîne sur l'argv du sous-processus CLI, qui est soumis aux limites de longueur de ligne de commande du système d'exploitation avant que le SDK n'envoie une requête API. Sur Linux, un seul argument plus long qu'environ 128 KB échoue au lancement du processus avec `Argument list too long`. Sur Windows, la ligne de commande entière est plafonnée à environ 32 KB, donc la forme chaîne échoue à un seuil inférieur.

1064 1064 

1065```python theme={null}1065```python theme={null}

1066class SystemPromptFile(TypedDict):1066class SystemPromptFile(TypedDict):


1077 `SettingSource`1077 `SettingSource`

1078</h3>1078</h3>

1079 1079 

1080Contrôle quelles sources de configuration basées sur le système de fichiers le SDK charge les paramètres.1080Contrôle à partir de quelles sources de configuration basées sur le système de fichiers le SDK charge les paramètres.

1081 1081 

1082```python theme={null}1082```python theme={null}

1083SettingSource = Literal["user", "project", "local"]1083SettingSource = Literal["user", "project", "local"]


1093 Comportement par défaut1093 Comportement par défaut

1094</h4>1094</h4>

1095 1095 

1096Quand `setting_sources` est omis ou `None` et `skills` n'est pas défini, `query()` charge les mêmes paramètres du système de fichiers que le CLI Claude Code : utilisateur, projet et local. Avec `skills` défini, la ligne [`setting_sources`](#claudeagentoptions) décrit la valeur par défaut actuelle. La politique gérée par le point de terminaison est chargée dans tous les cas ; les paramètres gérés par le serveur sont récupérés quand la session s'authentifie avec une credential d'organisation sur une [configuration éligible](/docs/fr/server-managed-settings#platform-availability). Pour plus d'informations, voir [Ce que settingSources ne contrôle pas](/docs/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control).1096Quand `setting_sources` est omis ou `None` et `skills` n'est pas défini, `query()` charge les mêmes paramètres du système de fichiers que le CLI Claude Code : utilisateur, projet et local. Avec `skills` défini, la ligne [`setting_sources`](#claudeagentoptions) décrit la valeur par défaut actuelle. La politique gérée par le point de terminaison est chargée dans tous les cas ; les paramètres gérés par le serveur sont récupérés quand la session s'authentifie avec des identifiants d'organisation sur une [configuration éligible](/docs/fr/server-managed-settings#platform-availability). Pour plus d'informations, voir [Ce que settingSources ne contrôle pas](/docs/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control).

1097 1097 

1098<h4 id="why-use-setting_sources">1098<h4 id="why-use-setting_sources">

1099 Pourquoi utiliser setting\_sources1099 Pourquoi utiliser setting\_sources


1174asyncio.run(main())1174asyncio.run(main())

1175```1175```

1176 1176 

1177Pour charger les instructions de projet CLAUDE.md, incluez `"project"` dans `setting_sources`. Voir [Modifier les prompts système](/docs/fr/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions) pour comment le chargement de CLAUDE.md interagit avec les options de prompt système.1177Pour charger les instructions de projet CLAUDE.md, incluez `"project"` dans `setting_sources`. Voir [Modifier les prompts système](/docs/fr/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions) pour savoir comment le chargement de CLAUDE.md interagit avec les options de prompt système.

1178 1178 

1179<h4 id="settings-precedence">1179<h4 id="settings-precedence">

1180 Précédence des paramètres1180 Priorité des paramètres

1181</h4>1181</h4>

1182 1182 

1183Quand plusieurs sources sont chargées, les paramètres sont fusionnés avec cette précédence (la plus haute à la plus basse) :1183Quand plusieurs sources sont chargées, les paramètres sont fusionnés selon cette priorité (de la plus haute à la plus basse) :

1184 1184 

11851. Paramètres locaux (`.claude/settings.local.json`)11851. Paramètres locaux (`.claude/settings.local.json`)

11862. Paramètres de projet (`.claude/settings.json`)11862. Paramètres de projet (`.claude/settings.json`)

11873. Paramètres utilisateur (`~/.claude/settings.json`)11873. Paramètres utilisateur (`~/.claude/settings.json`)

1188 1188 

1189Les options programmatiques telles que `agents`, `allowed_tools`, et `settings` remplacent les paramètres du système de fichiers utilisateur, projet et local. Les paramètres de politique gérée prennent la priorité sur les options programmatiques.1189Les options programmatiques telles que `agents`, `allowed_tools`, et `settings` remplacent les paramètres du système de fichiers utilisateur, projet et local. Les paramètres de politique gérée ont priorité sur les options programmatiques.

1190 1190 

1191<h3 id="agentdefinition">1191<h3 id="agentdefinition">

1192 `AgentDefinition`1192 `AgentDefinition`


1219| `tools` | No | Tableau de noms d'outils autorisés. S'il est omis, hérite de chaque [outil disponible pour les sous-agents](/docs/fr/sub-agents#available-tools) |1219| `tools` | No | Tableau de noms d'outils autorisés. S'il est omis, hérite de chaque [outil disponible pour les sous-agents](/docs/fr/sub-agents#available-tools) |

1220| `disallowedTools` | No | Tableau de noms d'outils à supprimer de l'ensemble d'outils de l'agent. Les motifs au niveau du serveur MCP sont également acceptés : `mcp__server` ou `mcp__server__*` supprime chaque outil de ce serveur, et `mcp__*` supprime chaque outil MCP de n'importe quel serveur |1220| `disallowedTools` | No | Tableau de noms d'outils à supprimer de l'ensemble d'outils de l'agent. Les motifs au niveau du serveur MCP sont également acceptés : `mcp__server` ou `mcp__server__*` supprime chaque outil de ce serveur, et `mcp__*` supprime chaque outil MCP de n'importe quel serveur |

1221| `model` | No | Remplacement de modèle pour cet agent. Accepte un alias tel que `"sonnet"`, `"opus"`, `"haiku"`, ou `"inherit"`, ou un ID de modèle complet. Quand vous l'omettez, Claude Code choisit le modèle dans l'[ordre de modèle des sous-agents](/docs/fr/sub-agents#choose-a-model) |1221| `model` | No | Remplacement de modèle pour cet agent. Accepte un alias tel que `"sonnet"`, `"opus"`, `"haiku"`, ou `"inherit"`, ou un ID de modèle complet. Quand vous l'omettez, Claude Code choisit le modèle dans l'[ordre de modèle des sous-agents](/docs/fr/sub-agents#choose-a-model) |

1222| `skills` | No | Liste de noms de compétences à précharger dans le contexte de l'agent au démarrage. Les compétences non listées restent invocables via l'outil Skill |1222| `skills` | No | Liste de noms de skills à précharger dans le contexte de l'agent au démarrage. Les skills non listés restent invocables via l'outil Skill |

1223| `memory` | No | Source de mémoire pour cet agent : `"user"`, `"project"`, ou `"local"` |1223| `memory` | No | Source de mémoire pour cet agent : `"user"`, `"project"`, ou `"local"` |

1224| `mcpServers` | No | Serveurs MCP disponibles pour cet agent. Chaque entrée est un nom de serveur ou un dict `{name: config}` en ligne |1224| `mcpServers` | No | Serveurs MCP disponibles pour cet agent. Chaque entrée est un nom de serveur ou un dict `{name: config}` en ligne |

1225| `initialPrompt` | No | Auto-soumis en tant que premier tour utilisateur quand cet agent s'exécute en tant qu'agent de thread principal |1225| `initialPrompt` | No | Auto-soumis en tant que premier tour utilisateur quand cet agent s'exécute en tant qu'agent de thread principal |


1245 "plan", # Mode planification - explorer sans éditer1245 "plan", # Mode planification - explorer sans éditer

1246 "dontAsk", # Refuser tout ce qui n'est pas pré-approuvé au lieu de demander1246 "dontAsk", # Refuser tout ce qui n'est pas pré-approuvé au lieu de demander

1247 "bypassPermissions", # Contourner les vérifications de permission ; les règles d'ask explicites demandent toujours (utiliser avec prudence)1247 "bypassPermissions", # Contourner les vérifications de permission ; les règles d'ask explicites demandent toujours (utiliser avec prudence)

1248 "auto", # Le classificateur de modèle approuve ou refuse les invites de permission1248 "auto", # Un classifieur de modèle examine les actions telles que les commandes shell et les requêtes réseau

1249]1249]

1250```1250```

1251 1251 


1285 1285 

1286Retourne un `PermissionResult` (soit `PermissionResultAllow` soit `PermissionResultDeny`).1286Retourne un `PermissionResult` (soit `PermissionResultAllow` soit `PermissionResultDeny`).

1287 1287 

1288Le rappel est le remplacement SDK pour l'invite de permission interactive : il est invoqué uniquement quand le [flux d'évaluation de permission](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) aboutit à une invite. Les appels d'outil déjà approuvés par une entrée `allowed_tools`, une règle d'autorisation de paramètres, ou le mode de permission, tel que `acceptEdits` ou `bypassPermissions`, ne l'invoquent jamais. Pour contrôler chaque appel d'outil, utilisez un hook [`PreToolUse`](/docs/fr/agent-sdk/hooks) à la place.1288Le rappel est le remplacement SDK de la demande de permission interactive : il est invoqué uniquement quand le [flux d'évaluation des permissions](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) aboutit à une demande de permission. Les appels d'outils déjà approuvés par une entrée `allowed_tools`, une règle d'autorisation des paramètres, ou le mode de permission, tel que `acceptEdits` ou `bypassPermissions`, ne l'invoquent jamais. Pour contrôler chaque appel d'outil, utilisez plutôt un [hook `PreToolUse`](/docs/fr/agent-sdk/hooks).

1289 1289 

1290Une règle d'autorisation ne pré-approuve pas les [actions qu'aucun mode n'approuve automatiquement](/docs/fr/permission-modes#actions-no-mode-auto-approves) ; voir [Comment les permissions sont évaluées](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) pour lesquelles d'entre elles atteignent le rappel et ce qui se passe en mode `dontAsk` et `auto`.1290Une règle d'autorisation ne pré-approuve pas les [actions qu'aucun mode n'approuve automatiquement](/docs/fr/permission-modes#actions-no-mode-auto-approves) ; voir [Comment les permissions sont évaluées](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) pour savoir lesquelles d'entre elles atteignent le rappel et ce qui se passe en mode `dontAsk` et `auto`.

1291 1291 

1292<h3 id="toolpermissioncontext">1292<h3 id="toolpermissioncontext">

1293 `ToolPermissionContext`1293 `ToolPermissionContext`


1312| Field | Type | Description |1312| Field | Type | Description |

1313| :- | :- | :- |1313| :- | :- | :- |

1314| `signal` | `Any \| None` | Réservé pour le support futur du signal d'abandon |1314| `signal` | `Any \| None` | Réservé pour le support futur du signal d'abandon |

1315| `suggestions` | `list[PermissionUpdate]` | Suggestions de mise à jour de permission du CLI. Les invites Bash incluent une suggestion avec la destination `localSettings`, donc retourner cela dans `updated_permissions` écrit la règle à `.claude/settings.local.json` et persiste entre les sessions. |1315| `suggestions` | `list[PermissionUpdate]` | Suggestions de mise à jour de permission du CLI. Les demandes de permission Bash incluent une suggestion avec la destination `localSettings`, donc la retourner dans `updated_permissions` écrit la règle dans `.claude/settings.local.json` et persiste entre les sessions. |

1316| `tool_use_id` | `str \| None` | Identifiant de l'appel d'outil spécifique pour lequel cette invite est. Toujours rempli quand livré à `can_use_tool` |1316| `tool_use_id` | `str \| None` | Identifiant de l'appel d'outil spécifique concerné par cette demande de permission. Toujours rempli quand livré à `can_use_tool` |

1317| `agent_id` | `str \| None` | ID du sous-agent quand l'appel provient d'un sous-agent ; `None` pour l'agent principal |1317| `agent_id` | `str \| None` | ID du sous-agent quand l'appel provient d'un sous-agent ; `None` pour l'agent principal |

1318| `blocked_path` | `str \| None` | Chemin de fichier qui a déclenché la demande de permission, le cas échéant. Par exemple, quand une commande Bash essaie d'accéder à un chemin en dehors des répertoires autorisés |1318| `blocked_path` | `str \| None` | Chemin de fichier qui a déclenché la demande de permission, le cas échéant. Par exemple, quand une commande Bash essaie d'accéder à un chemin en dehors des répertoires autorisés |

1319| `decision_reason` | `str \| None` | Raison pour laquelle cette demande de permission a été déclenchée. Transmise d'un hook PreToolUse dont `permissionDecisionReason` quand le hook a retourné `"ask"` |1319| `decision_reason` | `str \| None` | Raison pour laquelle cette demande de permission a été déclenchée. Transmise depuis le `permissionDecisionReason` d'un hook PreToolUse quand le hook a retourné `"ask"` |

1320| `title` | `str \| None` | Phrase d'invite de permission complète, telle que `Claude wants to read foo.txt`. Utilisez comme texte d'invite principal quand présent |1320| `title` | `str \| None` | Phrase complète de la demande de permission, telle que `Claude wants to read foo.txt`. Utilisez-la comme texte principal de la demande quand elle est présente |

1321| `display_name` | `str \| None` | Phrase nominale courte pour l'action d'outil, telle que `Read file`, appropriée pour les étiquettes de bouton |1321| `display_name` | `str \| None` | Phrase nominale courte pour l'action d'outil, telle que `Read file`, appropriée pour les étiquettes de bouton |

1322| `description` | `str \| None` | Sous-titre lisible par l'homme pour l'interface utilisateur de permission |1322| `description` | `str \| None` | Sous-titre lisible par l'homme pour l'interface utilisateur de permission |

1323 1323 


1465| `enabled` | `type`, `budget_tokens`, `display` | Activer la réflexion avec un budget de tokens spécifique |1465| `enabled` | `type`, `budget_tokens`, `display` | Activer la réflexion avec un budget de tokens spécifique |

1466| `disabled` | `type` | Désactiver la réflexion |1466| `disabled` | `type` | Désactiver la réflexion |

1467 1467 

1468Le champ `display` optionnel contrôle si le texte de réflexion est retourné `"summarized"` ou `"omitted"`. Sur Claude Opus 4.7 et ultérieur, la valeur par défaut de l'API est `"omitted"`, donc définissez `"summarized"` pour recevoir le contenu de réflexion dans les sorties [`ThinkingBlock`](#thinkingblock). Claude Code n'envoie pas `display` à Amazon Bedrock ou à la plateforme d'agent de Google Cloud, donc sur ces fournisseurs Opus 4.7 et ultérieur retournent des sorties `ThinkingBlock` vides même quand vous définissez `display` à `"summarized"`.1468Le champ `display` optionnel contrôle si le texte de réflexion est retourné `"summarized"` ou `"omitted"`. Sur Claude Opus 4.7 et ultérieur, la valeur par défaut de l'API est `"omitted"`, donc définissez `"summarized"` pour recevoir le contenu de réflexion dans les sorties [`ThinkingBlock`](#thinkingblock). Claude Code ne transmet pas votre valeur `display` à certains fournisseurs, tels qu'Amazon Bedrock et Agent Platform de Google Cloud. Sur ces fournisseurs, Opus 4.7 et ultérieur retournent des sorties `ThinkingBlock` vides même quand vous définissez `display` à `"summarized"`.

1469 1469 

1470Parce que ce sont des classes `TypedDict`, ce sont des dicts simples à l'exécution. Construisez-les soit comme des littéraux dict soit appelez la classe comme un constructeur ; les deux produisent un `dict`. Accédez aux champs avec `config["budget_tokens"]`, pas `config.budget_tokens` :1470Parce que ce sont des classes `TypedDict`, ce sont des dicts simples à l'exécution. Construisez-les soit comme des littéraux dict soit appelez la classe comme un constructeur ; les deux produisent un `dict`. Accédez aux champs avec `config["budget_tokens"]`, pas `config.budget_tokens` :

1471 1471 


1660 apiUsage: NotRequired[dict[str, Any] | None]1660 apiUsage: NotRequired[dict[str, Any] | None]

1661```1661```

1662 1662 

1663Chaque entrée `ContextUsageCategory` porte `name`, `tokens`, `color`, et un drapeau optionnel `isDeferred`. `totalTokens` est l'utilisation de contexte actuelle de la session, et `maxTokens` est la fenêtre contre laquelle l'utilisation est mesurée. Cette fenêtre est la fenêtre de contexte du modèle, ou la fenêtre de compaction automatique inférieure quand une s'applique, et `rawMaxTokens` porte la même valeur que `maxTokens`. `apiUsage` contient l'utilisation de la dernière réponse API, pas un total cumulé pour la session. Claude Code laisse les clés optionnelles `deferredBuiltinTools`, `systemTools`, et `systemPromptSections` non définies, donc attendez-vous à ce qu'elles soient absentes même si le type les déclare.1663Chaque entrée `ContextUsageCategory` porte `name`, `tokens`, `color`, et un flag optionnel `isDeferred`. `totalTokens` est l'utilisation de contexte actuelle de la session, et `maxTokens` est la fenêtre par rapport à laquelle cette utilisation est mesurée. Cette fenêtre est la fenêtre de contexte du modèle, ou la fenêtre de compaction automatique inférieure quand elle s'applique, et `rawMaxTokens` porte la même valeur que `maxTokens`. `apiUsage` contient l'utilisation de la dernière réponse API, pas un total cumulé pour la session. Claude Code laisse les clés optionnelles `deferredBuiltinTools`, `systemTools`, et `systemPromptSections` non définies, donc attendez-vous à ce qu'elles soient absentes même si le type les déclare.

1664 1664 

1665<h3 id="sdkpluginconfig">1665<h3 id="sdkpluginconfig">

1666 `SdkPluginConfig`1666 `SdkPluginConfig`


1840 1840 

1841Plusieurs champs portent des détails de diagnostic sur la façon dont la conversation s'est terminée :1841Plusieurs champs portent des détails de diagnostic sur la façon dont la conversation s'est terminée :

1842 1842 

1843* `is_error` : `True` quand la conversation s'est terminée dans un état d'erreur. Toujours `True` sur les sous-types `error_*`. Sur `subtype="success"` c'est `True` quand la dernière demande de modèle a échoué, ce qui signifie que la boucle d'agent s'est terminée mais le dernier appel API a retourné une erreur.1843* `is_error` : `True` quand la conversation s'est terminée dans un état d'erreur. Toujours `True` sur les sous-types `error_*`. Sur `subtype="success"` c'est `True` quand la dernière requête de modèle a échoué, ce qui signifie que la boucle d'agent s'est terminée mais le dernier appel API a retourné une erreur.

1844* `api_error_status` : le code de statut HTTP de l'erreur API terminale. `None` quand le tour s'est terminé sans une. Rempli uniquement sur `subtype="success"`.1844* `api_error_status` : le code de statut HTTP de l'erreur API terminale. `None` quand le tour s'est terminé sans une. Rempli uniquement sur `subtype="success"`.

1845* `result` : texte du message d'assistant final sur `subtype="success"`, ou `None` sur les sous-types `error_*`. Quand `subtype="success"` et `is_error=True`, ceci contient la chaîne d'erreur API si une est disponible mais peut être vide, donc vérifiez `api_error_status` et le contenu `AssistantMessage` précédent pour plus de détails.1845* `result` : texte du message d'assistant final sur `subtype="success"`, ou `None` sur les sous-types `error_*`. Quand `subtype="success"` et `is_error=True`, ceci contient la chaîne d'erreur API si une est disponible mais peut être vide, donc vérifiez `api_error_status` et le contenu `AssistantMessage` précédent pour plus de détails.

1846* `errors` : chaînes d'erreur au niveau de la boucle telles que le message max-turns. Rempli uniquement sur les sous-types `error_*`.1846* `errors` : chaînes d'erreur au niveau de la boucle telles que le message max-turns. Rempli uniquement sur les sous-types `error_*`.

1847* `terminal_reason` : pourquoi la boucle de requête s'est terminée, telle que `"completed"`, `"max_turns"`, `"api_error"`, `"aborted_streaming"`, ou `"aborted_tools"`. Une valeur de `"aborted_streaming"` ou `"aborted_tools"` signifie que le tour a été interrompu avant de se terminer. Les causes courantes sont [`interrupt()`](#claudesdkclient) et un rappel de permission retournant [`PermissionResultDeny`](#permissionresultdeny) avec `interrupt=True`. `None` sur les versions CLI qui précèdent le champ, sur les résultats des commandes locales telles que `/voice` ou `/usage`, qui contournent la boucle de requête, ou sur les résultats d'erreur synthétisés émis quand la session échoue fatalement. Reflète le [`SDKResultMessage.terminal_reason`](/docs/fr/agent-sdk/typescript#sdkresultmessage) du SDK TypeScript, qui liste l'ensemble complet des valeurs.1847* `terminal_reason` : pourquoi la boucle de requête s'est terminée, telle que `"completed"`, `"max_turns"`, `"api_error"`, `"aborted_streaming"`, ou `"aborted_tools"`. Une valeur de `"aborted_streaming"` ou `"aborted_tools"` signifie que le tour a été interrompu avant de se terminer. Les causes courantes sont [`interrupt()`](#claudesdkclient) et un rappel de permission retournant [`PermissionResultDeny`](#permissionresultdeny) avec `interrupt=True`. `None` sur les versions CLI qui précèdent le champ, sur les résultats des commandes locales telles que `/voice` ou `/usage`, qui contournent la boucle de requête, ou sur les résultats d'erreur synthétisés émis quand la session échoue fatalement. Reflète le [`SDKResultMessage.terminal_reason`](/docs/fr/agent-sdk/typescript#sdkresultmessage) du SDK TypeScript, qui liste l'ensemble complet des valeurs.

1848* `origin` : origine du message utilisateur qui a déclenché ce tour. En [mode d'entrée en streaming](/docs/fr/agent-sdk/streaming-vs-single-mode), vérifiez ceci pour distinguer le résultat de votre propre invite, où `origin` est `None` ou `{"kind": "human"}`, du résultat d'un tour injecté tel qu'une notification de tâche de fond. Nécessite Python Agent SDK 0.2.137 ou ultérieur.1848* `origin` : origine du message utilisateur qui a déclenché ce tour. En [mode d'entrée en streaming](/docs/fr/agent-sdk/streaming-vs-single-mode), vérifiez ceci pour distinguer le résultat de votre propre prompt, où `origin` est `None` ou `{"kind": "human"}`, du résultat d'un tour injecté tel qu'une notification de tâche en arrière-plan. Nécessite Python Agent SDK 0.2.137 ou ultérieur.

1849 1849 

1850Le dict `usage` couvre uniquement la boucle d'agent principal et exclut les sous-agents et autres appels de modèle imbriqués ou auxiliaires. En [mode d'entrée en streaming](/docs/fr/agent-sdk/streaming-vs-single-mode), les valeurs sont par tour. Préférez `model_usage` pour la comptabilité des tokens et des coûts. Le dict `usage` contient les clés suivantes quand présentes :1850Le dict `usage` couvre uniquement la boucle d'agent principal et exclut les sous-agents et autres appels de modèle imbriqués ou auxiliaires. En [mode d'entrée en streaming](/docs/fr/agent-sdk/streaming-vs-single-mode), les valeurs sont par tour. Préférez `model_usage` pour la comptabilité des tokens et des coûts. Le dict `usage` contient les clés suivantes quand présentes :

1851 1851 


1856| `cache_creation_input_tokens` | `int` | Tokens utilisés pour créer de nouvelles entrées de cache. |1856| `cache_creation_input_tokens` | `int` | Tokens utilisés pour créer de nouvelles entrées de cache. |

1857| `cache_read_input_tokens` | `int` | Tokens lus à partir des entrées de cache existantes. |1857| `cache_read_input_tokens` | `int` | Tokens lus à partir des entrées de cache existantes. |

1858 1858 

1859Le dict `model_usage` mappe les noms de modèles à l'utilisation par modèle. Il couvre chaque appel de modèle effectué via le pipeline de requête : la boucle principale, les sous-agents, et les appels internes tels que la compaction et les agents Workflow. Les appels d'assistance en dehors de ce pipeline, tels que le classificateur de permission et les demandes de comptage de tokens, sont exclus de `model_usage`. Traitez `model_usage` comme une estimation, pas une déclaration de facturation.1859Le dict `model_usage` mappe les noms de modèles à l'utilisation par modèle. Il couvre chaque appel de modèle effectué via le pipeline de requête : la boucle principale, les sous-agents, et les appels internes tels que la compaction et les agents Workflow. Les appels d'assistance en dehors de ce pipeline, tels que le classificateur de permission et les requêtes de comptage de tokens, sont exclus de `model_usage`. Traitez `model_usage` comme une estimation, pas une déclaration de facturation.

1860 1860 

1861En [mode d'entrée en streaming](/docs/fr/agent-sdk/streaming-vs-single-mode), `model_usage` et `total_cost_usd` sont cumulatifs entre les tours, donc lisez le dernier résultat plutôt que de faire la somme entre les résultats. Un appel qui reprend une session compte également les [totaux restaurés à partir des appels antérieurs de la session](/docs/fr/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Voir [Suivre les coûts en mode d'entrée en streaming](/docs/fr/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) pour les réinitialisations et [Récupérer les totaux après un crash de session](/docs/fr/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) pour les résultats remis à zéro.1861En [mode d'entrée en streaming](/docs/fr/agent-sdk/streaming-vs-single-mode), `model_usage` et `total_cost_usd` sont cumulatifs entre les tours, donc lisez le dernier résultat plutôt que de faire la somme entre les résultats. Un appel qui reprend une session compte également les [totaux restaurés à partir des appels antérieurs de la session](/docs/fr/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Voir [Suivre les coûts en mode d'entrée en streaming](/docs/fr/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) pour les réinitialisations et [Récupérer les totaux après un crash de session](/docs/fr/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) pour les résultats remis à zéro.

1862 1862 


1875| `maxOutputTokens` | `int` | Limite de tokens de sortie maximum pour ce modèle. |1875| `maxOutputTokens` | `int` | Limite de tokens de sortie maximum pour ce modèle. |

1876| `canonicalModel` | `str` | ID de modèle canonique utilisé pour la recherche de tarification. Peut différer de la chaîne de modèle brute par laquelle l'entrée est indexée, telle qu'un ID spécifique au fournisseur ou un alias. Pas toujours présent. |1876| `canonicalModel` | `str` | ID de modèle canonique utilisé pour la recherche de tarification. Peut différer de la chaîne de modèle brute par laquelle l'entrée est indexée, telle qu'un ID spécifique au fournisseur ou un alias. Pas toujours présent. |

1877| `provider` | `str` | Fournisseur d'API qui a servi ce modèle, tel que `firstParty`, `bedrock`, `vertex`, `foundry`, `anthropicAws`, `mantle`, ou `gateway`. Pas toujours présent. |1877| `provider` | `str` | Fournisseur d'API qui a servi ce modèle, tel que `firstParty`, `bedrock`, `vertex`, `foundry`, `anthropicAws`, `mantle`, ou `gateway`. Pas toujours présent. |

1878| `costBasis` | `str` | Grille tarifaire qui a déterminé le prix de la dernière requête de ce modèle : `list` pour le prix catalogue, `managed` pour une table [`modelPricing`](/docs/fr/settings-reference#modelpricing), ou `unknown` quand aucune ne correspondait à l'ID du modèle. Pas toujours présent, et non déclaré sur le TypedDict, donc lisez-le avec `.get()`. Nécessite Claude Code v2.1.246 ou ultérieur. |

1878 1879 

1879<h3 id="streamevent">1880<h3 id="streamevent">

1880 `StreamEvent`1881 `StreamEvent`


1945 1946 

1946| Champ | Type | Description |1947| Champ | Type | Description |

1947| :- | :- | :- |1948| :- | :- | :- |

1948| `status` | `RateLimitStatus` | Statut actuel. `"allowed_warning"` signifie approcher la limite ; `"rejected"` signifie que la limite a été atteinte |1949| `status` | `RateLimitStatus` | Statut actuel, l'un de `"allowed"`, `"allowed_warning"`, ou `"rejected"`. `"allowed_warning"` signifie approcher la limite ; `"rejected"` signifie que la limite a été atteinte |

1949| `resets_at` | `int \| None` | Timestamp Unix quand la fenêtre de limite de débit se réinitialise |1950| `resets_at` | `int \| None` | Timestamp Unix quand la fenêtre de limite de débit se réinitialise |

1950| `rate_limit_type` | `RateLimitType \| None` | Quelle fenêtre de limite de débit s'applique |1951| `rate_limit_type` | `RateLimitType \| None` | Quelle fenêtre de limite de débit s'applique |

1951| `utilization` | `float \| None` | Fraction de la limite de débit consommée (0,0 à 1,0) |1952| `utilization` | `float \| None` | Fraction de la limite de débit consommée (0,0 à 1,0) |


1978 `TaskStartedMessage`1979 `TaskStartedMessage`

1979</h3>1980</h3>

1980 1981 

1981Émis quand une tâche de fond démarre. Une tâche de fond est tout ce qui est suivi en dehors du tour principal : une commande Bash en arrière-plan, une montre [Monitor](#monitor), un sous-agent généré via l'outil Agent, ou un agent distant. Le champ `task_type` vous dit lequel. Ce nommage n'est pas lié au renommage de l'outil `Task`-à-`Agent`.1982Émis quand une tâche en arrière-plan démarre. Une tâche en arrière-plan est tout ce qui est suivi en dehors du tour principal : une commande Bash en arrière-plan, une surveillance [Monitor](#monitor), un sous-agent généré via l'outil Agent, ou un agent distant. Le champ `task_type` vous dit lequel. Ce nommage n'est pas lié au renommage de l'outil `Task`-à-`Agent`.

1982 1983 

1983```python theme={null}1984```python theme={null}

1984@dataclass1985@dataclass


1998| `uuid` | `str` | Identifiant de message unique |1999| `uuid` | `str` | Identifiant de message unique |

1999| `session_id` | `str` | Identifiant de session |2000| `session_id` | `str` | Identifiant de session |

2000| `tool_use_id` | `str \| None` | ID d'utilisation d'outil associé |2001| `tool_use_id` | `str \| None` | ID d'utilisation d'outil associé |

2001| `task_type` | `str \| None` | Quel type de tâche de fond : `"local_bash"` pour Bash en arrière-plan et les montres Monitor, `"local_agent"`, ou `"remote_agent"` |2002| `task_type` | `str \| None` | Quel type de tâche en arrière-plan : `"local_bash"` pour Bash en arrière-plan et les surveillances Monitor, `"local_agent"`, ou `"remote_agent"` |

2002 2003 

2003<h3 id="taskusage">2004<h3 id="taskusage">

2004 `TaskUsage`2005 `TaskUsage`

2005</h3>2006</h3>

2006 2007 

2007Données de tokens et de timing pour une tâche de fond.2008Données de tokens et de timing pour une tâche en arrière-plan.

2008 2009 

2009```python theme={null}2010```python theme={null}

2010class TaskUsage(TypedDict):2011class TaskUsage(TypedDict):


2017 `TaskProgressMessage`2018 `TaskProgressMessage`

2018</h3>2019</h3>

2019 2020 

2020Émis périodiquement avec les mises à jour de progression pour une tâche de fond en cours d'exécution.2021Émis périodiquement avec les mises à jour de progression pour une tâche en arrière-plan en cours d'exécution.

2021 2022 

2022```python theme={null}2023```python theme={null}

2023@dataclass2024@dataclass


2045 `TaskNotificationMessage`2046 `TaskNotificationMessage`

2046</h3>2047</h3>

2047 2048 

2048Émis quand une tâche de fond se termine, échoue, ou est arrêtée. Les tâches de fond incluent les commandes Bash `run_in_background`, les montres Monitor, et les sous-agents en arrière-plan.2049Émis quand une tâche en arrière-plan se termine, échoue, ou est arrêtée. Les tâches en arrière-plan incluent les commandes Bash `run_in_background`, les surveillances Monitor, et les sous-agents en arrière-plan.

2049 2050 

2050```python theme={null}2051```python theme={null}

2051@dataclass2052@dataclass


2166 """Base error for Claude SDK."""2167 """Base error for Claude SDK."""

2167```2168```

2168 2169 

2169Quand une requête `query()` unique se termine par un résultat d'erreur, par exemple une erreur de limite de tours, le SDK lève une [`ResultError`](#resulterror) après avoir cédé le message de résultat final. Les versions du Python Agent SDK antérieures à 0.2.140 levaient une `Exception` simple qui n'était pas une sous-classe de `ClaudeSDKError`.2170Quand une requête `query()` unique se termine par un résultat d'erreur, par exemple une erreur de limite de tours, le SDK lève une [`ResultError`](#resulterror).

2170 2171 

2171<h3 id="clinotfounderror">2172<h3 id="clinotfounderror">

2172 `CLINotFoundError`2173 `CLINotFoundError`


2216 `ResultError`2217 `ResultError`

2217</h3>2218</h3>

2218 2219 

2219Levée après le [`ResultMessage`](#resultmessage) final quand le processus Claude Code se termine parce que l'exécution s'est terminée par un résultat d'erreur, comme une erreur de limite de tours ou une erreur API. `ResultError` est une sous-classe de `ProcessError`, donc un gestionnaire `except ProcessError` existant la capture également. Ses attributs portent les champs de ce message de résultat, vous pouvez donc vous brancher sur la raison de l'échec de l'exécution sans analyser le texte du message. Nécessite Python Agent SDK 0.2.140 ou version ultérieure.2220Levée quand le processus Claude Code se termine parce que l'exécution s'est terminée par un [message de résultat](#resultmessage) d'erreur, comme une erreur de limite de tours ou une erreur API. `ResultError` est une sous-classe de `ProcessError`, donc un gestionnaire `except ProcessError` existant la capture également. Ses attributs portent les champs de ce message de résultat, vous pouvez donc adapter votre logique selon la raison de l'échec de l'exécution sans analyser le texte du message. Nécessite Python Agent SDK 0.2.140 ou version ultérieure.

2220 2221 

2221```python theme={null}2222```python theme={null}

2222class ResultError(ProcessError):2223class ResultError(ProcessError):


2649 hookEventName: Literal["PostToolUse"]2650 hookEventName: Literal["PostToolUse"]

2650 additionalContext: NotRequired[str]2651 additionalContext: NotRequired[str]

2651 updatedToolOutput: NotRequired[Any]2652 updatedToolOutput: NotRequired[Any]

2652 updatedMCPToolOutput: NotRequired[Any] # Deprecated: use updatedToolOutput, which works for all tools2653 updatedMCPToolOutput: NotRequired[Any] # MCP tools only. Prefer updatedToolOutput, which works for all tools

2653 2654 

2654 2655 

2655class PostToolUseFailureHookSpecificOutput(TypedDict):2656class PostToolUseFailureHookSpecificOutput(TypedDict):


2708 Exemple d'utilisation de hook2709 Exemple d'utilisation de hook

2709</h3>2710</h3>

2710 2711 

2711Cet exemple enregistre deux hooks : l'un qui bloque les commandes bash dangereuses comme `rm -rf /`, et un autre qui enregistre toute l'utilisation d'outils pour l'audit. Le hook de sécurité s'exécute uniquement sur les commandes Bash (via le `matcher`), tandis que le hook de journalisation s'exécute sur tous les outils.2712Cet exemple enregistre deux hooks : l'un qui bloque les commandes Bash dangereuses comme `rm -rf /`, et un autre qui journalise toute l'utilisation d'outils pour l'audit. Le hook de sécurité s'exécute uniquement sur les commandes Bash (via le `matcher`), tandis que le hook de journalisation s'exécute sur tous les outils.

2712 2713 

2713```python theme={null}2714```python theme={null}

2714import asyncio2715import asyncio


2767 Types d'entrée/sortie d'outil2768 Types d'entrée/sortie d'outil

2768</h2>2769</h2>

2769 2770 

2770Documentation des schémas d'entrée/sortie pour tous les outils Claude Code intégrés. Bien que le SDK Python n'exporte pas ceux-ci en tant que types, ils représentent la structure des entrées et sorties d'outils dans les messages.2771Documentation des schémas d'entrée/sortie pour les outils Claude Code intégrés. Bien que le SDK Python n'exporte pas ceux-ci en tant que types, ils représentent la structure des entrées et sorties d'outils dans les messages.

2771 2772 

2772Chaque sortie affichée est la valeur que vous lisez à partir de [`UserMessage.tool_use_result`](#usermessage) pour cet outil. Les noms de clés apparaissent exactement comme Claude Code les émet. Une clé annotée `| None` avec un commentaire « présent quand » ou « optionnel » est omise quand elle ne s'applique pas.2773Chaque sortie affichée est la valeur que vous lisez à partir de [`UserMessage.tool_use_result`](#usermessage) pour cet outil. Les noms de clés apparaissent exactement comme Claude Code les émet. Une clé annotée `| None` avec un commentaire « présent quand » ou « optionnel » est omise quand elle ne s'applique pas.

2773 2774 


3544 TaskOutput3545 TaskOutput

3545</h3>3546</h3>

3546 3547 

3547Supprimé dans Claude Code v2.1.277. Précédemment récupéré la sortie d'une tâche de fond en cours d'exécution ou terminée, avec `BashOutput` accepté comme alias ; Claude lit le fichier de sortie d'une tâche de fond avec `Read` à la place.3548Supprimé dans Claude Code v2.1.277. Récupérait auparavant la sortie d'une tâche en arrière-plan en cours d'exécution ou terminée, avec `BashOutput` accepté comme alias ; Claude lit le fichier de sortie d'une tâche en arrière-plan avec `Read` à la place.

3548 3549 

3549Une entrée `disallowed_tools` ou une règle de refus qui nomme toujours l'un ou l'autre nom est ignorée sans avertissement.3550Une entrée `disallowed_tools` ou une règle de refus qui nomme toujours l'un ou l'autre nom est ignorée sans avertissement.

3550 3551 

Details

60 60 

61Pour utiliser les sorties structurées, définissez un [JSON Schema](https://json-schema.org/understanding-json-schema/about) décrivant la forme des données que vous souhaitez, puis passez-le à `query()` via l'option `outputFormat` (TypeScript) ou `output_format` (Python). Quand l'agent termine, le message de résultat inclut un champ `structured_output` avec des données validées correspondant à votre schéma.61Pour utiliser les sorties structurées, définissez un [JSON Schema](https://json-schema.org/understanding-json-schema/about) décrivant la forme des données que vous souhaitez, puis passez-le à `query()` via l'option `outputFormat` (TypeScript) ou `output_format` (Python). Quand l'agent termine, le message de résultat inclut un champ `structured_output` avec des données validées correspondant à votre schéma.

62 62 

63L'exemple ci-dessous demande à l'agent de rechercher Anthropic et de retourner le nom de l'entreprise, l'année de fondation et le siège social en tant que sortie structurée.63Avant d'exécuter les exemples de cette page, installez le Claude Agent SDK en suivant le [démarrage rapide](/docs/fr/agent-sdk/quickstart#setup). L'exemple ci-dessous demande à l'agent de rechercher Anthropic et de retourner le nom de l'entreprise, l'année de fondation et le siège social en tant que sortie structurée.

64 64 

65<CodeGroup>65<CodeGroup>

66 ```typescript TypeScript theme={null}66 ```typescript TypeScript theme={null}


390 Gestion des erreurs390 Gestion des erreurs

391</h2>391</h2>

392 392 

393La génération de sortie structurée peut échouer quand l'agent ne peut pas produire du JSON valide correspondant à votre schéma. Cela se produit généralement quand le schéma est trop complexe pour la tâche, la tâche elle-même est ambiguë, ou l'agent atteint sa limite de tentatives en essayant de corriger les erreurs de validation. Cela peut aussi se produire sans aucune erreur de validation : un [repli de modèle](/docs/fr/model-config#automatic-model-fallback) peut rétracter une sortie déjà complétée en cours de flux, et si aucune nouvelle tentative ne la remplace, l'exécution se termine avec la même erreur. Vérifiez la liste `errors` du message de résultat pour distinguer les deux causes avant de déboguer votre schéma.393La génération de sortie structurée peut échouer quand l'agent ne peut pas produire du JSON valide correspondant à votre schéma. Cela se produit généralement quand le schéma est trop complexe pour la tâche, la tâche elle-même est ambiguë, ou l'agent atteint sa limite de tentatives en essayant de corriger les erreurs de validation. Cela peut aussi se produire sans aucune erreur de validation : un [basculement vers un modèle de secours](/docs/fr/model-config#automatic-model-fallback) peut rétracter une sortie déjà complétée en cours de flux, et si aucune nouvelle tentative ne la remplace, l'exécution se termine avec la même erreur. Vérifiez la liste `errors` du message de résultat d'erreur pour distinguer les deux causes avant de déboguer votre schéma.

394 394 

395Quand une erreur se produit, le message de résultat a un `subtype` indiquant ce qui s'est mal passé :395Quand une erreur se produit, le message de résultat a un `subtype` indiquant ce qui s'est mal passé :

396 396 

397| Subtype | Signification |397| Subtype | Signification |

398| - | - |398| - | - |

399| `success` | La sortie a été générée et validée avec succès |399| `success` | La sortie a été générée et validée avec succès |

400| `error_max_structured_output_retries` | Aucune sortie valide n'a survécu après plusieurs tentatives (erreurs de validation, ou une rétraction de repli de modèle sans nouvelle tentative réussie) |400| `error_max_structured_output_retries` | Aucune sortie valide ne subsistait après plusieurs tentatives (erreurs de validation, ou une rétraction due au basculement vers un modèle de secours sans nouvelle tentative réussie) |

401 401 

402Un résultat peut aussi se terminer avec le subtype `success` mais sans valeur `structured_output`, par exemple quand l'exécution se termine sans que l'agent produise une sortie structurée. Traitez ce cas comme un échec aussi. L'entrée de dépannage [structured\_output is None but the result says success](/docs/fr/agent-sdk/troubleshooting#structured_output-is-none-but-the-result-says-success) couvre ce cas. L'exemple ci-dessous traite un résultat comme réussi uniquement quand le `subtype` est `success` et `structured_output` est présent, et gère tous les autres résultats comme un échec :402Un résultat peut aussi se terminer avec le subtype `success` mais sans valeur `structured_output`, par exemple quand l'exécution se termine sans que l'agent produise une sortie structurée. Traitez ce cas comme un échec aussi. L'entrée de dépannage [structured\_output is None but the result says success](/docs/fr/agent-sdk/troubleshooting#structured_output-is-none-but-the-result-says-success) couvre ce cas. L'exemple ci-dessous traite un résultat comme réussi uniquement quand le `subtype` est `success` et `structured_output` est présent, et gère tous les autres résultats comme un échec :

403 403 


436 }436 }

437 }437 }

438 } catch (error) {438 } catch (error) {

439 // Une requête query() unique lève une exception après avoir produit un message d'erreur. Si439 // Une requête query() unique lève une exception après avoir produit un résultat d'erreur. Si

440 // l'échec était un message d'erreur, les branches de subtype d'erreur ci-dessus ont440 // l'échec était un résultat d'erreur, les branches de subtype d'erreur ci-dessus ont

441 // déjà été exécutées ; les défaillances de connexion ou de processus ne produisent aucun message de résultat.441 // déjà été exécutées ; les défaillances de connexion ou de processus ne produisent aucun message de résultat.

442 console.log(`Session ended with an error: ${error}`);442 console.log(`Session ended with an error: ${error}`);

443 }443 }


474 else:474 else:

475 print("Run ended without a structured output")475 print("Run ended without a structured output")

476 except Exception as error:476 except Exception as error:

477 # Une requête query() unique lève une exception après avoir produit un message d'erreur. Si477 # Une requête query() unique lève une exception après avoir produit un résultat d'erreur. Si

478 # l'échec était un message d'erreur, les branches de subtype d'erreur ci-dessus ont478 # l'échec était un résultat d'erreur, les branches de subtype d'erreur ci-dessus ont

479 # déjà été exécutées ; les défaillances de connexion ou de processus ne produisent aucun message de résultat.479 # déjà été exécutées ; les défaillances de connexion ou de processus ne produisent aucun message de résultat.

480 print(f"Session ended with an error: {error}")480 print(f"Session ended with an error: {error}")

481 481 


488 488 

489* **Gardez les schémas ciblés.** Les schémas profondément imbriqués avec de nombreux champs requis sont plus difficiles à satisfaire. Commencez simple et ajoutez de la complexité au besoin.489* **Gardez les schémas ciblés.** Les schémas profondément imbriqués avec de nombreux champs requis sont plus difficiles à satisfaire. Commencez simple et ajoutez de la complexité au besoin.

490* **Faites correspondre le schéma à la tâche.** Si la tâche pourrait ne pas avoir toutes les informations que votre schéma nécessite, rendez ces champs optionnels.490* **Faites correspondre le schéma à la tâche.** Si la tâche pourrait ne pas avoir toutes les informations que votre schéma nécessite, rendez ces champs optionnels.

491* **Utilisez des invites claires.** Les invites ambiguës rendent plus difficile pour l'agent de savoir quelle sortie produire.491* **Utilisez des prompts clairs.** Les prompts ambigus rendent plus difficile pour l'agent de savoir quelle sortie produire.

492 492 

493<h2 id="related-resources">493<h2 id="related-resources">

494 Ressources connexes494 Ressources connexes

Details

6 6 

7> Référence API complète du SDK Agent TypeScript, incluant toutes les fonctions, types et interfaces.7> Référence API complète du SDK Agent TypeScript, incluant toutes les fonctions, types et interfaces.

8 8 

9<script src="/docs/components/typescript-sdk-type-links.js" defer />

10 

11<h2 id="installation">9<h2 id="installation">

12 Installation10 Installation

13</h2>11</h2>


181});179});

182 180 

183spare.claimed.catch((error: Error) => {181spare.claimed.catch((error: Error) => {

184 // À moins que le message commence par « option_not_applied », l'invite n'a pas été exécutée :182 // À moins que le message commence par « option_not_applied », le prompt n'a pas été exécuté :

185 // démarrez cette session avec query() à la place183 // démarrez cette session avec query() à la place

186 console.error("Claim failed:", error.message);184 console.error("Claim failed:", error.message);

187});185});

188 186 

189for await (const message of claimedQuery) {187try {

188 for await (const message of claimedQuery) {

190 console.log(message);189 console.log(message);

190 }

191} catch (error) {

192 // Après une réclamation refusée, la requête réclamée lève une exception une fois qu'elle a produit le résultat d'erreur

193 console.error(`Session ended with an error: ${error}`);

191}194}

192```195```

193 196 


536 539 

537Objet de configuration pour la fonction `query()`.540Objet de configuration pour la fonction `query()`.

538 541 

539| Propriété | Type | Par défaut | Description |542| Propriété | Type | Valeur par défaut | Description |

540| :- | :- | :- | :- |543| :- | :- | :- | :- |

541| `abortController` | `AbortController` | `new AbortController()` | Contrôleur permettant d'annuler les opérations |544| `abortController` | `AbortController` | `new AbortController()` | Contrôleur permettant d'annuler les opérations |

542| `additionalDirectories` | `string[]` | `[]` | Répertoires supplémentaires auxquels Claude peut accéder. Le SDK transmet chaque entrée à Claude Code sous la forme `--add-dir`, de sorte qu'avec la source de paramètres `project`, Claude Code [charge également les skills, commandes et sous-agents du répertoire](/docs/fr/permissions#additional-directories-grant-file-access-not-configuration) |545| `additionalDirectories` | `string[]` | `[]` | Répertoires supplémentaires auxquels Claude peut accéder. Le SDK transmet chaque entrée à Claude Code sous la forme `--add-dir`, de sorte qu'avec la source de paramètres `project`, Claude Code [charge également les skills, commandes et sous-agents du répertoire](/docs/fr/permissions#additional-directories-grant-file-access-not-configuration) |

543| `agent` | `string` | `undefined` | Nom de l'agent pour le thread principal. L'agent doit être défini dans l'option `agents` ou dans les paramètres |546| `agent` | `string` | `undefined` | Nom de l'agent pour le thread principal. L'agent doit être défini dans l'option `agents` ou dans les paramètres |

544| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | Définir des sous-agents par programmation |547| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | Définir des sous-agents par programmation |

545| `agentProgressSummaries` | `boolean` | `false` | Lorsque la valeur est `true`, génère des résumés de progression d'une ligne pour les sous-agents et les transmet dans les événements [`task_progress`](#sdktaskprogressmessage) via le champ `summary`. S'applique aux sous-agents au premier plan et en arrière-plan |548| `agentProgressSummaries` | `boolean` | `false` | Lorsque `true`, génère des résumés de progression d'une ligne pour les sous-agents et les transmet dans les événements [`task_progress`](#sdktaskprogressmessage) via le champ `summary`. S'applique aux sous-agents au premier plan et en arrière-plan |

546| `allowDangerouslySkipPermissions` | `boolean` | `false` | Permet de contourner les permissions. Requis lors de l'utilisation de `permissionMode: 'bypassPermissions'`, au démarrage ou ultérieurement via `setPermissionMode()`. Consultez [mode plan](/docs/fr/agent-sdk/permissions#plan-mode-plan) pour savoir comment il interagit avec `permissionMode: 'plan'` |549| `allowDangerouslySkipPermissions` | `boolean` | `false` | Active le contournement des permissions. Requis lors de l'utilisation de `permissionMode: 'bypassPermissions'`, au démarrage ou ultérieurement via `setPermissionMode()`. Consultez [mode plan](/docs/fr/agent-sdk/permissions#plan-mode-plan) pour savoir comment il interagit avec `permissionMode: 'plan'` |

547| `allowedTools` | `string[]` | `[]` | Outils à approuver automatiquement sans demande. Cela ne limite pas Claude à ces seuls outils. Si vous nommez ici l'un des [outils de suivi des tâches](/docs/fr/agent-sdk/todo-tracking#model-availability), Claude Code active également ces outils pour la session. Les autres outils non listés sont traités par `permissionMode` et `canUseTool`. Utilisez `disallowedTools` pour bloquer des outils. Consultez [Permissions](/docs/fr/agent-sdk/permissions#allow-and-deny-rules) |550| `allowedTools` | `string[]` | `[]` | Outils à approuver automatiquement sans demande. Cela ne limite pas Claude à ces seuls outils. Si vous nommez ici l'un des [outils de suivi des tâches](/docs/fr/agent-sdk/todo-tracking#model-availability), Claude Code les active également pour la session. Les autres outils non listés sont soumis à `permissionMode` et `canUseTool`. Utilisez `disallowedTools` pour bloquer des outils. Consultez [Permissions](/docs/fr/agent-sdk/permissions#allow-and-deny-rules) |

548| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | Activer les fonctionnalités bêta |551| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | Activer les fonctionnalités bêta |

549| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Fonction de permission personnalisée, invoquée uniquement lorsque le [flux de permissions](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) aboutit à une demande. Elle n'est pas invoquée pour les appels approuvés automatiquement par `allowedTools`, les règles d'autorisation ou `permissionMode`. Une règle d'autorisation n'approuve pas à l'avance les [actions qu'aucun mode n'approuve automatiquement](/docs/fr/permission-modes#actions-no-mode-auto-approves). Consultez [`CanUseTool`](#canusetool) pour plus de détails |552| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Fonction de permission personnalisée, invoquée uniquement lorsque le [flux de permissions](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) aboutit à une demande. Non invoquée pour les appels approuvés automatiquement par `allowedTools`, les règles d'autorisation ou `permissionMode`. Une règle d'autorisation ne pré-approuve pas les [actions qu'aucun mode n'approuve automatiquement](/docs/fr/permission-modes#actions-no-mode-auto-approves). Consultez [`CanUseTool`](#canusetool) pour plus de détails |

550| `continue` | `boolean` | `false` | Poursuivre la conversation la plus récente |553| `continue` | `boolean` | `false` | Poursuivre la conversation la plus récente |

551| `cwd` | `string` | `process.cwd()` | Répertoire de travail actuel |554| `cwd` | `string` | `process.cwd()` | Répertoire de travail actuel |

552| `debug` | `boolean` | `false` | Activer le mode débogage pour le processus Claude Code |555| `debug` | `boolean` | `false` | Activer le mode débogage pour le processus Claude Code |

553| `debugFile` | `string` | `undefined` | Écrire les logs de débogage dans un chemin de fichier spécifique. Active implicitement le mode débogage |556| `debugFile` | `string` | `undefined` | Écrire les logs de débogage dans un chemin de fichier spécifique. Active implicitement le mode débogage |

554| `disallowedTools` | `string[]` | `[]` | Outils à refuser. Un nom seul tel que `"Bash"` retire l'outil du contexte de Claude. Une règle ciblée telle que `"Bash(rm *)"` laisse l'outil disponible et refuse les appels correspondants dans tous les modes de permission, y compris `bypassPermissions`, pour la commande [telle qu'elle est écrite](/docs/fr/permissions#bash-rule-limits). Consultez [Permissions](/docs/fr/agent-sdk/permissions#allow-and-deny-rules) |557| `disallowedTools` | `string[]` | `[]` | Outils à refuser. Un nom seul tel que `"Bash"` retire l'outil du contexte de Claude. Une règle ciblée telle que `"Bash(rm *)"` laisse l'outil disponible et refuse les appels correspondants dans tous les modes de permission, y compris `bypassPermissions`, pour la commande [telle qu'écrite](/docs/fr/permissions#bash-rule-limits). Consultez [Permissions](/docs/fr/agent-sdk/permissions#allow-and-deny-rules) |

555| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | `undefined` | Contrôle l'effort que Claude consacre à sa réponse. Fonctionne avec la réflexion adaptative pour guider la profondeur de réflexion. Consultez [ajuster le niveau d'effort](/docs/fr/model-config#adjust-effort-level) |558| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | `undefined` | Contrôle l'effort que Claude consacre à sa réponse. Fonctionne avec la réflexion adaptative pour guider la profondeur de réflexion. Consultez [ajuster le niveau d'effort](/docs/fr/model-config#adjust-effort-level) |

556| `enableFileCheckpointing` | `boolean` | `false` | Activer le suivi des modifications de fichiers pour le retour en arrière. Consultez [Checkpointing de fichiers](/docs/fr/agent-sdk/file-checkpointing) |559| `enableFileCheckpointing` | `boolean` | `false` | Activer le suivi des modifications de fichiers pour le retour en arrière. Consultez [Checkpointing de fichiers](/docs/fr/agent-sdk/file-checkpointing) |

557| `env` | `Record<string, string \| undefined>` | `process.env` | Variables d'environnement. Lorsqu'elles sont définies, elles remplacent l'environnement du sous-processus au lieu d'être fusionnées avec `process.env` ; passez donc `{ ...process.env, YOUR_VAR: 'value' }` pour conserver les variables héritées comme `PATH`. Consultez [Gérer les réponses d'API lentes ou bloquées](#handle-slow-or-stalled-api-responses) pour un exemple de ce modèle, et [Variables d'environnement](/docs/fr/env-vars) pour les variables lues par la CLI sous-jacente. Définissez `CLAUDE_AGENT_SDK_CLIENT_APP` pour identifier votre application dans l'en-tête User-Agent |560| `env` | `Record<string, string \| undefined>` | `process.env` | Variables d'environnement. Lorsqu'elle est définie, cette option remplace l'environnement du sous-processus au lieu de fusionner avec `process.env`, passez donc `{ ...process.env, YOUR_VAR: 'value' }` pour conserver les variables héritées comme `PATH`. Consultez [Gérer les réponses d'API lentes ou bloquées](#handle-slow-or-stalled-api-responses) pour un exemple de ce modèle, et [Variables d'environnement](/docs/fr/env-vars) pour les variables que lit la CLI sous-jacente. Définissez `CLAUDE_AGENT_SDK_CLIENT_APP` pour identifier votre application dans l'en-tête User-Agent |

558| `executable` | `'bun' \| 'deno' \| 'node'` | Détecté automatiquement | Runtime JavaScript à utiliser |561| `executable` | `'bun' \| 'deno' \| 'node'` | Détecté automatiquement | Runtime JavaScript à utiliser |

559| `executableArgs` | `string[]` | `[]` | Arguments à transmettre à l'exécutable |562| `executableArgs` | `string[]` | `[]` | Arguments à transmettre à l'exécutable |

560| `extraArgs` | `Record<string, string \| null>` | `{}` | Arguments supplémentaires |563| `extraArgs` | `Record<string, string \| null>` | `{}` | Arguments supplémentaires |

561| `fallbackModel` | `string` | `undefined` | Modèle à utiliser si le modèle principal échoue. Accepte une liste séparée par des virgules. Pour l'ordre et la limite, consultez [Chaînes de modèles de secours](/docs/fr/model-config#fallback-model-chains). Pour des recommandations, consultez [Choisir un modèle](/docs/fr/agent-sdk/configuration#choose-a-model) |564| `fallbackModel` | `string` | `undefined` | Modèle à utiliser si le modèle principal échoue. Accepte une liste séparée par des virgules. Pour l'ordre et la limite, consultez [Chaînes de modèles de secours](/docs/fr/model-config#fallback-model-chains). Pour des recommandations, consultez [Choisir un modèle](/docs/fr/agent-sdk/configuration#choose-a-model) |

562| `forkSession` | `boolean` | `false` | Lors de la reprise avec `resume`, bifurquer vers un nouvel identifiant de session au lieu de poursuivre la session d'origine |565| `forkSession` | `boolean` | `false` | Lors d'une reprise avec `resume`, créer un fork vers un nouvel ID de session au lieu de poursuivre la session d'origine |

563| `forwardSubagentText` | `boolean` | `false` | Transmettre le texte et les blocs de réflexion des sous-agents sous forme de messages assistant et utilisateur avec `parent_tool_use_id` défini, afin que les consommateurs puissent afficher une transcription imbriquée. Sans cette option, Claude Code émet les blocs `tool_use` et `tool_result` des sous-agents, mais pas le texte ni la réflexion. Les messages des sous-agents de tous les niveaux d'imbrication sont transmis à partir de Claude Code v2.1.219 ; avant la v2.1.219, seuls les messages des sous-agents de niveau 1 apparaissaient. Les messages des sous-agents lancés par un skill forké, et ceux des skills forkés imbriqués, nécessitent la v2.1.275 ou ultérieure |566| `forwardSubagentText` | `boolean` | `false` | Transmettre le texte et les blocs de réflexion des sous-agents sous forme de messages assistant et utilisateur avec `parent_tool_use_id` défini, afin que les consommateurs puissent afficher une transcription imbriquée. Sans cette option, Claude Code omet le texte et les blocs de réflexion d'un sous-agent qui s'exécute au [premier plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background). Pour les sous-agents imbriqués, les skills avec `context: fork` et la version de Claude Code requise pour chacun, consultez [Suivre les messages des sous-agents](/docs/fr/headless#follow-subagent-messages) |

564| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Callbacks de hooks pour les événements |567| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Callbacks de hooks pour les événements |

565| `includeHookEvents` | `boolean` | `false` | Inclure les événements du cycle de vie des hooks dans le flux de messages sous forme de [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage) et [`SDKHookResponseMessage`](#sdkhookresponsemessage). Les événements du cycle de vie des hooks `SessionStart` et `Setup` sont toujours inclus et ne nécessitent pas cette option. Certains événements de hook, tels que `Notification`, `SessionEnd`, `PreCompact` et `PostCompact`, ne produisent jamais de `SDKHookStartedMessage`, même avec cette option. Pour ces événements, Claude Code émet tout de même un `SDKHookProgressMessage` lorsqu'un hook de commande qui s'exécute pendant plus d'une seconde produit une sortie, et n'émet un `SDKHookResponseMessage` que lorsqu'un hook [qui s'exécute en arrière-plan](/docs/fr/hooks#run-hooks-in-the-background) se termine |568| `includeHookEvents` | `boolean` | `false` | Inclure les événements du cycle de vie des hooks dans le flux de messages sous forme de [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage) et [`SDKHookResponseMessage`](#sdkhookresponsemessage). Les événements du cycle de vie des hooks `SessionStart` et `Setup` sont toujours inclus et ne nécessitent pas cette option. Certains événements de hook, tels que `Notification`, `SessionEnd`, `PreCompact` et `PostCompact`, ne produisent jamais de `SDKHookStartedMessage`, même avec cette option. Pour ces événements, Claude Code émet tout de même un `SDKHookProgressMessage` lorsqu'un hook de commande qui s'exécute pendant plus d'une seconde produit une sortie, et n'émet un `SDKHookResponseMessage` que lorsqu'un hook [qui s'exécute en arrière-plan](/docs/fr/hooks#run-hooks-in-the-background) se termine |

566| `includePartialMessages` | `boolean` | `false` | Inclure les événements de messages partiels |569| `includePartialMessages` | `boolean` | `false` | Inclure les événements de messages partiels |

567| `loadTimeoutMs` | `number` | `60000` | *Alpha.* Délai d'expiration en millisecondes pour chaque appel à `sessionStore.load()` et `sessionStore.listSubkeys()` lors de la matérialisation de la reprise. Si l'adaptateur ne se résout pas dans ce délai, la requête échoue au lieu de rester bloquée. Ignoré lorsque `sessionStore` n'est pas défini |570| `loadTimeoutMs` | `number` | `60000` | *Alpha.* Délai d'expiration en millisecondes pour chaque appel à `sessionStore.load()` et `sessionStore.listSubkeys()` lors de la matérialisation de la reprise. Si l'adaptateur ne se résout pas dans ce délai, la requête échoue au lieu de rester bloquée. Ignoré lorsque `sessionStore` n'est pas défini |

568| `managedSettings` | `Settings` | `undefined` | Paramètres de niveau stratégie que votre processus hôte fournit à la session lancée. Sur les machines disposant de paramètres gérés déployés par un administrateur, Claude Code les ignore sauf si la source gérée la plus prioritaire de l'administrateur définit `parentSettingsBehavior: 'merge'`, et ne les fusionne jamais lorsqu'un [`policyHelper`](/docs/fr/settings-reference#policyhelper) fournit des paramètres gérés. Les valeurs fusionnées passent par un filtre uniquement restrictif ; [Restreindre les paramètres parents](/docs/fr/claude-apps-gateway#restrict-parent-settings) décrit ce que le filtre admet ainsi que les verrous `allowManaged*Only`. Un hôte qui définit [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/fr/env-vars) voit plutôt trois clés lues directement depuis ce payload : sa [configuration de modèle](/docs/fr/model-config#restrict-model-selection) à partir de Claude Code v2.1.222, [`modelPricing`](/docs/fr/settings-reference#modelpricing) lorsqu'aucune source gérée ne le définit à partir de la v2.1.246, et son entrée d'environnement `ENABLE_TOOL_SEARCH` à partir de la v2.1.247 |571| `managedSettings` | `Settings` | `undefined` | Paramètres de niveau stratégie que votre processus hôte fournit à la session lancée. Sur les machines disposant de paramètres gérés déployés par un administrateur, Claude Code les ignore sauf si la source gérée de priorité la plus élevée de l'administrateur définit `parentSettingsBehavior: 'merge'`, et ne les fusionne jamais lorsqu'un [`policyHelper`](/docs/fr/settings-reference#policyhelper) fournit des paramètres gérés. Les valeurs fusionnées passent par un filtre uniquement restrictif ; [Restreindre les paramètres parents](/docs/fr/claude-apps-gateway#restrict-parent-settings) décrit ce que le filtre admet et les verrous `allowManaged*Only`. Pour un hôte qui définit [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/fr/env-vars), trois clés sont lues directement depuis ce payload à la place : sa [configuration de modèle](/docs/fr/model-config#restrict-model-selection) sur Claude Code v2.1.222 ou ultérieure, [`modelPricing`](/docs/fr/settings-reference#modelpricing) lorsqu'aucune source gérée ne le définit sur v2.1.246 ou ultérieure, et son entrée env `ENABLE_TOOL_SEARCH` sur v2.1.247 ou ultérieure |

569| `maxBudgetUsd` | `number` | `undefined` | Arrêter la requête lorsque l'estimation des coûts côté client atteint cette valeur en USD. Seules les dépenses propres à l'appel sont comptabilisées ; les totaux restaurés depuis une session reprise ne sont pas comptés. Pour les réserves sur la précision et le comportement de réinitialisation, consultez [Suivre les coûts et l'utilisation](/docs/fr/agent-sdk/cost-tracking) |572| `maxBudgetUsd` | `number` | `undefined` | Arrêter la requête lorsque l'estimation des coûts côté client atteint cette valeur en USD. Ne compte que les dépenses propres à l'appel ; les totaux restaurés depuis une session reprise ne sont pas comptés. Pour les réserves sur la précision et le comportement de réinitialisation, consultez [Suivre les coûts et l'utilisation](/docs/fr/agent-sdk/cost-tracking) |

570| `maxThinkingTokens` | `number` | `undefined` | *Obsolète :* utilisez plutôt `thinking`. Nombre maximal de tokens pour le processus de réflexion |573| `maxThinkingTokens` | `number` | `undefined` | *Obsolète :* Utilisez `thinking` à la place. Nombre maximal de tokens pour le processus de réflexion |

571| `maxTurns` | `number` | `undefined` | Nombre maximal de tours agentiques (allers-retours d'utilisation d'outils) |574| `maxTurns` | `number` | `undefined` | Nombre maximal de tours agentiques (allers-retours d'utilisation d'outils) |

572| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | Configurations des serveurs MCP |575| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | Configurations des serveurs MCP |

573| `model` | `string` | Valeur par défaut de la CLI | Alias de modèle Claude ou nom complet du modèle. Consultez [valeurs acceptées et identifiants spécifiques aux fournisseurs](/docs/fr/model-config#available-models) |576| `model` | `string` | Valeur par défaut de la CLI | Alias de modèle Claude ou nom complet du modèle. Consultez [valeurs acceptées et ID spécifiques aux fournisseurs](/docs/fr/model-config#available-models) |

574| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | Callback pour gérer les demandes d'élicitation MCP. Appelé lorsqu'un serveur MCP demande une saisie de l'utilisateur et qu'aucun hook ne la traite en premier. S'il n'est pas fourni, les demandes d'élicitation non traitées sont automatiquement refusées |577| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | Callback pour gérer les requêtes d'élicitation MCP. Appelé lorsqu'un serveur MCP demande une saisie utilisateur et qu'aucun hook ne la gère en premier. S'il n'est pas fourni, les requêtes d'élicitation non gérées sont automatiquement refusées |

575| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Définir le format de sortie des résultats de l'agent. Consultez [Sorties structurées](/docs/fr/agent-sdk/structured-outputs) pour plus de détails |578| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Définir le format de sortie des résultats de l'agent. Consultez [Sorties structurées](/docs/fr/agent-sdk/structured-outputs) pour plus de détails |

576| `outputStyle` | `string` | `undefined` | Ce n'est pas un champ de `Options`. Définissez plutôt `outputStyle` dans l'objet [`settings`](/docs/fr/settings) inline ou dans un fichier de paramètres. Consultez [Activer un style de sortie](/docs/fr/agent-sdk/modifying-system-prompts#activate-an-output-style) |579| `outputStyle` | `string` | `undefined` | Ce n'est pas un champ d'`Options`. Définissez plutôt `outputStyle` dans l'objet [`settings`](/docs/fr/settings) inline ou dans un fichier de paramètres. Consultez [Activer un style de sortie](/docs/fr/agent-sdk/modifying-system-prompts#activate-an-output-style) |

577| `pathToClaudeCodeExecutable` | `string` | Résolu automatiquement à partir du binaire natif intégré | Chemin vers l'exécutable Claude Code. Nécessaire uniquement si les dépendances optionnelles ont été ignorées lors de l'installation ou si votre plateforme ne fait pas partie de celles prises en charge |580| `pathToClaudeCodeExecutable` | `string` | Résolu automatiquement depuis le binaire natif fourni | Chemin vers l'exécutable Claude Code. Nécessaire uniquement si les dépendances optionnelles ont été ignorées lors de l'installation ou si votre plateforme ne fait pas partie de l'ensemble pris en charge |

578| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | Mode de permission de la session. Si vous l'omettez, la session peut démarrer en mode auto. Consultez [Modes de permission](/docs/fr/agent-sdk/permissions#permission-modes) pour savoir comment Claude Code choisit le mode de permission initial |581| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | Mode de permission pour la session. Si vous l'omettez, la session peut démarrer en mode auto. Consultez [Modes de permission](/docs/fr/agent-sdk/permissions#permission-modes) pour savoir comment Claude Code choisit le mode de permission de départ |

579| `permissionPromptToolName` | `string` | `undefined` | Nom de l'outil MCP pour les demandes de permission |582| `permissionPromptToolName` | `string` | `undefined` | Nom de l'outil MCP pour les demandes de permission |

580| `permissionPrompts` | `'host' \| 'none'` | `'host'` | Qui répond aux demandes de permission : `'host'` les achemine vers votre callback [`canUseTool`](#canusetool) ou vers l'outil `permissionPromptToolName`, et `'none'` [refuse les appels qui auraient déclenché une demande](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated). Nécessite Claude Code v2.1.259 ou ultérieure |583| `permissionPrompts` | `'host' \| 'none'` | `'host'` | Qui répond aux demandes de permission : `'host'` les achemine vers votre callback [`canUseTool`](#canusetool) ou l'outil `permissionPromptToolName`, et `'none'` [refuse les appels qui auraient déclenché une demande](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated). Nécessite Claude Code v2.1.259 ou ultérieure |

581| `persistSession` | `boolean` | `true` | Lorsque la valeur est `false`, désactive la persistance de la session sur disque. Les sessions ne peuvent alors pas être reprises ultérieurement |584| `persistSession` | `boolean` | `true` | Lorsque `false`, désactive la persistance de la session sur disque. Les sessions ne peuvent pas être reprises ultérieurement |

582| `planModeInstructions` | `string` | `undefined` | Instructions de workflow personnalisées pour le mode plan. Lorsque `permissionMode` vaut `'plan'`, cette chaîne remplace le corps du workflow par défaut du mode plan. La CLI l'encadre toujours avec le préambule imposant la lecture seule et le pied de page du protocole ExitPlanMode |585| `planModeInstructions` | `string` | `undefined` | Instructions de workflow personnalisées pour le mode plan. Lorsque `permissionMode` vaut `'plan'`, cette chaîne remplace le corps par défaut du workflow du mode plan. La CLI l'encadre toujours avec le préambule d'application de la lecture seule et le pied de page du protocole ExitPlanMode |

583| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | Charger des plugins personnalisés depuis des chemins locaux. Consultez [Plugins](/docs/fr/agent-sdk/plugins) pour plus de détails |586| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | Charger des plugins personnalisés depuis des chemins locaux. Consultez [Plugins](/docs/fr/agent-sdk/plugins) pour plus de détails |

584| `projectConfigRoot` | `string` | `undefined` | Chemin absolu du checkout de confiance dont `cwd` est un worktree. Claude Code lit les paramètres du projet, `.mcp.json`, ainsi que les commandes, agents, skills, workflows, routines et styles de sortie du répertoire `.claude/` du projet depuis ce répertoire au lieu de `cwd`, et y définit `CLAUDE_PROJECT_DIR`. Les hooks, les scripts d'assistance tels que `apiKeyHelper` et les serveurs MCP stdio démarrent avec ce répertoire comme répertoire de travail. Les fichiers `CLAUDE.md` et `.claude/rules/` sont toujours chargés depuis `cwd`. Nécessite Claude Code v2.1.275 ou ultérieure |587| `projectConfigRoot` | `string` | `undefined` | Chemin absolu du checkout de confiance dont `cwd` est un worktree. Claude Code lit les paramètres du projet, `.mcp.json` et les commandes, agents, skills, workflows, routines et styles de sortie du dossier `.claude/` du projet depuis ce répertoire au lieu de `cwd`, et y fait pointer `CLAUDE_PROJECT_DIR`. Les hooks, les scripts auxiliaires tels que `apiKeyHelper` et les serveurs MCP stdio démarrent avec ce répertoire comme répertoire de travail. Les fichiers `CLAUDE.md` et `.claude/rules/` sont toujours chargés depuis `cwd`. Nécessite Claude Code v2.1.275 ou ultérieure |

585| `promptSuggestions` | `boolean` | `false` | Activer les suggestions de prompts. Après un tour, Claude Code émet un message `prompt_suggestion` contenant une prédiction du prochain prompt de l'utilisateur. Claude Code ne génère aucune suggestion pour certains tours, par exemple lorsque votre compte approche ou a atteint sa limite d'utilisation. Consultez [Quand Claude Code ignore les suggestions](/docs/fr/interactive-mode#when-claude-code-skips-suggestions) |588| `promptSuggestions` | `boolean` | `false` | Activer les suggestions de prompts. Après un tour, Claude Code émet un message `prompt_suggestion` contenant une prédiction du prochain prompt de l'utilisateur. Claude Code ne génère aucune suggestion pour certains tours, par exemple lorsque votre compte est proche de sa limite d'utilisation ou l'a atteinte. Consultez [Quand Claude Code ignore les suggestions](/docs/fr/interactive-mode#when-claude-code-skips-suggestions) |

586| `resume` | `string` | `undefined` | Identifiant de la session à reprendre |589| `resume` | `string` | `undefined` | ID de session à reprendre |

587| `resumeDropsTurn` | `string` | `undefined` | Avec `resumeSessionAt` : l'UUID du prompt du tour que la reprise avec troncature entend supprimer. Claude Code refuse la reprise lorsque la plage supprimée contient quoi que ce soit qui ne peut pas être attribué à ce tour, comme des messages en file d'attente absorbés ou des notifications de tâches, et mentionne le flag `--resume-drops-turn` dans le message de refus. Seuls l'Agent SDK et les reprises en mode print lisent cette paire. Nécessite Claude Code v2.1.223 ou ultérieure |590| `resumeDropsTurn` | `string` | `undefined` | Avec `resumeSessionAt` : l'UUID du prompt du tour que la reprise tronquante a l'intention d'écarter. Claude Code refuse la reprise lorsque la plage écartée contient quoi que ce soit qui ne soit pas attribuable à ce tour, comme des messages en file d'attente absorbés ou des notifications de tâches, et mentionne le flag `--resume-drops-turn` dans le message de refus. Seules les reprises de l'Agent SDK et du mode print lisent cette paire. Nécessite Claude Code v2.1.223 ou ultérieure |

588| `resumeSessionAt` | `string` | `undefined` | Reprendre la session à partir d'un UUID de message spécifique |591| `resumeSessionAt` | `string` | `undefined` | Reprendre la session à un UUID de message spécifique |

589| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | Configurer le comportement du sandbox par programmation. Consultez [Paramètres du sandbox](#sandboxsettings) pour plus de détails |592| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | Configurer le comportement du sandbox par programmation. Consultez [Paramètres du sandbox](#sandboxsettings) pour plus de détails |

590| `sessionId` | `string` | Généré automatiquement | Utiliser un UUID spécifique pour la session au lieu d'en générer un automatiquement |593| `sessionId` | `string` | Généré automatiquement | Utiliser un UUID spécifique pour la session au lieu d'en générer un automatiquement |

591| `sessionStore` | [`SessionStore`](/docs/fr/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Répliquer les transcriptions de session vers un backend externe afin qu'un autre hôte puisse les reprendre. Consultez [Persister les sessions dans un stockage externe](/docs/fr/agent-sdk/session-storage) |594| `sessionStore` | [`SessionStore`](/docs/fr/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Dupliquer les transcriptions de session vers un backend externe afin qu'un autre hôte puisse les reprendre. Consultez [Persister les sessions dans un stockage externe](/docs/fr/agent-sdk/session-storage) |

592| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alpha.* Mode de vidage pour `sessionStore`. Ignoré lorsque `sessionStore` n'est pas défini |595| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alpha.* Mode de vidage pour `sessionStore`. Ignoré lorsque `sessionStore` n'est pas défini |

593| `settings` | `string \| Settings` | `undefined` | Objet de [paramètres](/docs/fr/settings) inline, chemin d'un fichier de paramètres ou chaîne JSON inline. Alimente la couche de paramètres de flags dans l'[ordre de priorité](/docs/fr/settings#settings-precedence). Modifiable à l'exécution avec [`applyFlagSettings()`](#applyflagsettings) |596| `settings` | `string \| Settings` | `undefined` | Objet de [paramètres](/docs/fr/settings) inline, chemin vers un fichier de paramètres ou chaîne JSON inline. Alimente la couche de paramètres de flag dans l'[ordre de priorité](/docs/fr/settings#settings-precedence). Modifiable à l'exécution avec [`applyFlagSettings()`](#applyflagsettings) |

594| `settingSources` | [`SettingSource`](#settingsource)`[]` | Valeurs par défaut de la CLI (toutes les sources) | Contrôler quels paramètres du système de fichiers charger. Passez `[]` pour désactiver les paramètres utilisateur, projet et locaux. La [stratégie gérée par le poste](/docs/fr/managed-settings#delivery-mechanisms) est chargée dans tous les cas ; les paramètres gérés par le serveur sont récupérés lorsque la session s'authentifie avec des identifiants d'organisation sur une [configuration éligible](/docs/fr/server-managed-settings#platform-availability). Consultez [Utiliser les fonctionnalités de Claude Code](/docs/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) |597| `settingSources` | [`SettingSource`](#settingsource)`[]` | Valeurs par défaut de la CLI (toutes les sources) | Contrôler quels paramètres du système de fichiers charger. Passez `[]` pour désactiver les paramètres utilisateur, projet et locaux. La [stratégie gérée par endpoint](/docs/fr/managed-settings#delivery-mechanisms) est chargée dans tous les cas ; les paramètres gérés par le serveur sont récupérés lorsque la session s'authentifie avec des identifiants d'organisation sur une [configuration éligible](/docs/fr/server-managed-settings#platform-availability). Consultez [Utiliser les fonctionnalités de Claude Code](/docs/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

595| `skills` | `string[] \| 'all'` | `undefined` | Skills disponibles pour la session. Passez `'all'` pour activer tous les skills découverts, ou une liste de noms de skills. Ne passez que des noms exacts. À partir de l'Agent SDK v0.3.221, le SDK rejette les noms mal formés et les noms contenant des caractères génériques avec une erreur avant de démarrer le processus Claude Code. Lorsque cette option est définie, le SDK ajoute automatiquement l'outil Skill à `allowedTools`. Si vous passez également `tools`, incluez `'Skill'` dans cette liste. Consultez [Skills](/docs/fr/agent-sdk/skills) |598| `skills` | `string[] \| 'all'` | `undefined` | Skills disponibles pour la session. Passez `'all'` pour activer tous les skills découverts, ou une liste de noms de skills. Ne passez que des noms exacts. Sur Agent SDK v0.3.221 ou ultérieure, le SDK rejette les noms mal formés et les noms sous forme de caractères génériques avec une erreur avant de démarrer le processus Claude Code. Lorsque cette option est définie, le SDK ajoute automatiquement l'outil Skill à `allowedTools`. Si vous passez également `tools`, incluez `'Skill'` dans cette liste. Consultez [Skills](/docs/fr/agent-sdk/skills) |

596| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Fonction personnalisée pour lancer le processus Claude Code. Utilisez-la pour exécuter Claude Code dans des VM, des conteneurs ou des environnements distants |599| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Fonction personnalisée pour lancer le processus Claude Code. À utiliser pour exécuter Claude Code dans des VM, des conteneurs ou des environnements distants |

597| `stderr` | `(data: string) => void` | `undefined` | Callback pour la sortie stderr |600| `stderr` | `(data: string) => void` | `undefined` | Callback pour la sortie stderr |

598| `strictMcpConfig` | `boolean` | `false` | Utiliser uniquement les serveurs passés dans `mcpServers` et ignorer le fichier `.mcp.json` du projet, les paramètres utilisateur, les serveurs MCP fournis par des plugins et les [connecteurs claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai) |601| `strictMcpConfig` | `boolean` | `false` | Utiliser uniquement les serveurs passés dans `mcpServers` et ignorer le `.mcp.json` du projet, les paramètres utilisateur, les serveurs MCP fournis par des plugins et les [connecteurs claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai) |

599| `systemPrompt` | `string \| string[] \| { type: 'custom'; prompt: string \| string[]; snapshot?: boolean } \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean; snapshot?: boolean }` | `undefined` (prompt minimal) | Configuration du prompt système. Passez une chaîne pour un prompt personnalisé, ou `{ type: 'preset', preset: 'claude_code' }` pour utiliser le prompt système de Claude Code. Passez un tableau de chaînes avec la constante exportée `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` entre la partie statique et la partie propre à chaque requête pour [mettre en cache la partie statique d'un prompt personnalisé](/docs/fr/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt). Avec la forme objet preset, ajoutez `append` pour l'étendre avec des instructions supplémentaires, et définissez `excludeDynamicSections: true` pour déplacer le contexte propre à la session dans le premier message utilisateur afin d'[améliorer la réutilisation du cache de prompts entre machines](/docs/fr/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines). Définissez `snapshot: false` pour reconstruire le prompt à chaque requête au lieu de [réutiliser le prompt que la session a enregistré lors de sa première requête](/docs/fr/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Pour définir `snapshot` sur un prompt personnalisé, passez la forme `{ type: 'custom', prompt }`. La forme `{ type: 'custom' }` et le champ `snapshot` nécessitent l'Agent SDK TypeScript v0.3.257 ou ultérieure |602| `systemPrompt` | `string \| string[] \| { type: 'custom'; prompt: string \| string[]; snapshot?: boolean } \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean; snapshot?: boolean }` | `undefined` (prompt minimal) | Configuration du prompt système. Passez une chaîne pour un prompt personnalisé, ou `{ type: 'preset', preset: 'claude_code' }` pour utiliser le prompt système de Claude Code. Passez un tableau de chaînes avec la constante exportée `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` entre la partie statique et la partie propre à chaque requête pour [mettre en cache la partie statique d'un prompt personnalisé](/docs/fr/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt). Avec la forme objet preset, ajoutez `append` pour l'étendre avec des instructions supplémentaires, et définissez `excludeDynamicSections: true` pour déplacer le contexte propre à la session dans le premier message utilisateur afin d'[améliorer la réutilisation du cache de prompts entre machines](/docs/fr/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines). Définissez `snapshot: false` pour reconstruire le prompt à chaque requête au lieu de [réutiliser le prompt enregistré par la session lors de sa première requête](/docs/fr/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Pour définir `snapshot` sur un prompt personnalisé, passez la forme `{ type: 'custom', prompt }`. La forme `{ type: 'custom' }` et le champ `snapshot` nécessitent TypeScript Agent SDK v0.3.257 ou ultérieure |

600| `taskBudget` | `{ total: number }` | `undefined` | *Alpha.* Budget de tâche côté API, en tokens. Lorsqu'il est défini, le modèle est informé du budget de tokens restant afin de pouvoir doser son utilisation des outils et conclure avant la limite |603| `taskBudget` | `{ total: number }` | `undefined` | *Alpha.* Budget de tâche côté API en tokens. Lorsqu'il est défini, le modèle est informé de son budget de tokens restant afin de pouvoir doser son utilisation des outils et conclure avant la limite |

601| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` pour les modèles pris en charge | Contrôle le comportement de réflexion/raisonnement de Claude. Consultez [`ThinkingConfig`](#thinkingconfig) pour les options |604| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` pour les modèles pris en charge | Contrôle le comportement de réflexion/raisonnement de Claude. Consultez [`ThinkingConfig`](#thinkingconfig) pour les options |

602| `title` | `string` | `undefined` | Titre d'affichage de la session. Lors d'une reprise via `resume` ou `continue`, le titre persistant de la session reprise a priorité ; utilisez [`renameSession()`](#renamesession) pour renommer une session existante |605| `title` | `string` | `undefined` | Titre d'affichage de la session. Lors d'une reprise via `resume` ou `continue`, le titre persisté de la session reprise a priorité ; utilisez [`renameSession()`](#renamesession) pour renommer une session existante |

603| `toolAliases` | `Record<string, string>` | `undefined` | Associer des noms d'outils intégrés à des noms d'outils MCP afin que Claude appelle votre implémentation MCP à la place de l'outil intégré. Par exemple, `{ Bash: 'mcp__workspace__bash' }` |606| `toolAliases` | `Record<string, string>` | `undefined` | Associer des noms d'outils intégrés à des noms d'outils MCP afin que Claude appelle votre implémentation MCP à la place de l'outil intégré. Par exemple, `{ Bash: 'mcp__workspace__bash' }` |

604| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | Configuration du comportement des outils intégrés. Consultez [`ToolConfig`](#toolconfig) pour plus de détails |607| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | Configuration du comportement des outils intégrés. Consultez [`ToolConfig`](#toolconfig) pour plus de détails |

605| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | Configuration des outils. Passez un tableau de noms d'outils ou utilisez le preset pour obtenir les outils par défaut de Claude Code |608| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | Configuration des outils. Passez un tableau de noms d'outils ou utilisez le preset pour obtenir les outils par défaut de Claude Code |

606| `verbatimPrompts` | `boolean` | `false` | Transmettre chaque prompt tel qu'il est écrit. Le SDK envoie chaque message utilisateur avec `client_composed: true`. Consultez [`client_composed`](#sdkusermessage) pour savoir ce que Claude Code ignore sur ces messages. Utilisez cette option lorsque le texte de votre prompt inclut du contenu que l'utilisateur final n'a pas saisi. Pour un contrôle tour par tour, laissez-la désactivée et définissez plutôt `client_composed` sur les messages diffusés en streaming individuellement. Nécessite l'Agent SDK TypeScript v0.3.280 ou ultérieure et Claude Code v2.1.248 ou ultérieure ; la version de Claude Code fournie avec ces versions du SDK satisfait l'exigence relative à Claude Code |609| `verbatimPrompts` | `boolean` | `false` | Transmettre chaque prompt tel qu'il est écrit. Le SDK envoie chaque message utilisateur avec `client_composed: true`. Consultez [`client_composed`](#sdkusermessage) pour savoir ce que Claude Code ignore sur ces messages. Utilisez cette option lorsque le texte de votre prompt inclut du contenu que l'utilisateur final n'a pas saisi. Pour un contrôle par tour, laissez-la désactivée et définissez plutôt `client_composed` sur les messages individuels envoyés en streaming. Nécessite TypeScript Agent SDK v0.3.280 ou ultérieure et Claude Code v2.1.248 ou ultérieure ; la version de Claude Code fournie avec ces versions du SDK satisfait l'exigence relative à Claude Code |

607 610 

608<h4 id="handle-slow-or-stalled-api-responses">611<h4 id="handle-slow-or-stalled-api-responses">

609 Gérer les réponses d'API lentes ou bloquées612 Gérer les réponses d'API lentes ou bloquées


627});630});

628```631```

629 632 

630* `API_TIMEOUT_MS` : délai d'expiration par requête sur le client Anthropic, en millisecondes. Valeur par défaut : `600000`. S'applique à la boucle principale et à tous les sous-agents.633* `API_TIMEOUT_MS` : délai d'expiration par requête sur le client Anthropic, en millisecondes. Par défaut `600000`. S'applique à la boucle principale et à tous les sous-agents.

631* `CLAUDE_CODE_MAX_RETRIES` : nombre maximal de nouvelles tentatives d'API. Valeur par défaut : `10`, plafonnée à `15`. Chaque nouvelle tentative dispose de sa propre fenêtre `API_TIMEOUT_MS`, de sorte que la durée réelle dans le pire des cas est d'environ `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` plus le backoff. Pour les exécutions sans surveillance qui doivent patienter pendant des pannes plus longues, définissez [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/fr/errors#tune-retry-behavior) : cette variable réessaie indéfiniment en cas d'erreurs de capacité transitoires et, à partir de Claude Code v2.1.199, porte la valeur par défaut pour les autres erreurs transitoires à `300` et supprime le plafond de cette variable.634* `CLAUDE_CODE_MAX_RETRIES` : nombre maximal de nouvelles tentatives d'API. Par défaut `10`, plafonné à `15`. Chaque nouvelle tentative dispose de sa propre fenêtre `API_TIMEOUT_MS`, de sorte que la durée totale dans le pire des cas est d'environ `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` plus le backoff. Pour les exécutions sans surveillance qui doivent patienter pendant des pannes plus longues, définissez [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/fr/errors#tune-retry-behavior) : il réessaie indéfiniment en cas d'erreurs de capacité transitoires et, sur Claude Code v2.1.199 ou ultérieure, porte la valeur par défaut pour les autres erreurs transitoires à `300` et supprime le plafond de cette variable.

632* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` : watchdog de blocage pour les sous-agents. Lorsque le watchdog de flux est actif, la valeur par défaut est `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 minutes, soit `600000` sauf si vous augmentez cette variable. Lorsque le watchdog de flux est désactivé, la valeur par défaut est `600000`. Avant la v2.1.257, la valeur par défaut était toujours `600000`.635* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` : watchdog de blocage pour les sous-agents. Tant que le watchdog de flux est actif, la valeur par défaut est `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 minutes, soit `600000` sauf si vous augmentez cette variable. Lorsque le watchdog de flux est désactivé, la valeur par défaut est `600000`. Avant v2.1.257, la valeur par défaut était toujours `600000`.

633 636 

634 Le minuteur est réinitialisé à chaque événement de flux. En cas de blocage, Claude Code interrompt le sous-agent et signale le blocage au parent. Pour un sous-agent en arrière-plan, il marque également la tâche comme échouée et joint tout résultat partiel.637 Le minuteur est réinitialisé à chaque événement de flux. En cas de blocage, Claude Code interrompt le sous-agent et signale le blocage au parent. Pour un sous-agent en arrière-plan, il marque également la tâche comme échouée et joint tout résultat partiel.

635* `CLAUDE_ENABLE_STREAM_WATCHDOG` avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` : watchdog de flux qui interrompt la requête lorsque les en-têtes sont arrivés mais que le corps de la réponse cesse d'être diffusé en streaming. Le watchdog est activé par défaut pour tous les fournisseurs ; définissez `CLAUDE_ENABLE_STREAM_WATCHDOG=0` pour le désactiver. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` vaut `300000` par défaut et ne peut pas descendre sous ce minimum. Après l'interruption, [Nouvelles tentatives automatiques](/docs/fr/errors#automatic-retries) décrit ce que fait Claude Code, selon l'avancement de la réponse.638* `CLAUDE_ENABLE_STREAM_WATCHDOG` avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` : watchdog de flux qui interrompt la requête lorsque les en-têtes sont arrivés mais que le corps de la réponse cesse d'être transmis. Le watchdog est activé par défaut pour tous les fournisseurs ; définissez `CLAUDE_ENABLE_STREAM_WATCHDOG=0` pour le désactiver. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` vaut `300000` par défaut et ne peut pas descendre en dessous de ce minimum. Après l'interruption, [Nouvelles tentatives automatiques](/docs/fr/errors#automatic-retries) décrit ce que fait Claude Code, selon l'avancement de la réponse.

636 639 

637 Pendant que le watchdog attend une réponse qu'une passerelle derrière `ANTHROPIC_BASE_URL` maintient ouverte avec des pings keep-alive, un hôte qui définit `includePartialMessages` continue de recevoir des [événements de flux](#sdkpartialassistantmessage) `ping` ; interprétez donc ces trames comme des signes d'activité plutôt que de faire expirer la session en l'absence de contenu. Avant la v2.1.257, ces trames s'arrêtaient 5 minutes après le dernier véritable événement de flux.640 Pendant que le watchdog attend une réponse qu'une passerelle derrière `ANTHROPIC_BASE_URL` maintient ouverte avec des pings keep-alive, un hôte qui définit `includePartialMessages` continue de recevoir des [événements de flux](#sdkpartialassistantmessage) `ping` ; interprétez donc ces trames comme des signes d'activité plutôt que de faire expirer la session en cas de silence. Avant v2.1.257, les trames s'arrêtaient 5 minutes après le dernier véritable événement de flux.

638 641 

639<h3 id="query-object">642<h3 id="query-object">

640 Objet `Query`643 Objet `Query`


696 699 

697| Méthode | Description |700| Méthode | Description |

698| :- | :- |701| :- | :- |

699| `interrupt()` | Interrompt la requête. Disponible uniquement en mode d'entrée en streaming. Lorsque la CLI annonce la capacité `interrupt_receipt_v1` dans [`SDKSystemMessage.capabilities`](#sdksystemmessage), se résout avec un [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) listant les messages en attente au moment où l'interruption est arrivée. Se résout en `undefined` sur les CLI antérieures à la v2.1.205 |702| `interrupt()` | Interrompt la requête. Disponible uniquement en mode d'entrée en streaming. Lorsque la CLI annonce la capacité `interrupt_receipt_v1` dans [`SDKSystemMessage.capabilities`](#sdksystemmessage), se résout avec un [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) listant les messages qui étaient en attente lorsque l'interruption est arrivée. Se résout avec `undefined` sur les CLI antérieures à v2.1.205 |

700| `rewindFiles(userMessageId, options?)` | Restaure les fichiers dans l'état où ils se trouvaient au moment du message utilisateur spécifié. Passez `{ dryRun: true }` pour prévisualiser les modifications. Nécessite `enableFileCheckpointing: true`. Consultez [Checkpointing de fichiers](/docs/fr/agent-sdk/file-checkpointing) |703| `rewindFiles(userMessageId, options?)` | Restaure les fichiers dans leur état au moment du message utilisateur spécifié. Passez `{ dryRun: true }` pour prévisualiser les modifications. Nécessite `enableFileCheckpointing: true`. Consultez [Checkpointing de fichiers](/docs/fr/agent-sdk/file-checkpointing) |

701| `setPermissionMode()` | Modifie le mode de permission (disponible uniquement en mode d'entrée en streaming) |704| `setPermissionMode()` | Modifie le mode de permission (disponible uniquement en mode d'entrée en streaming) |

702| `setModel()` | Modifie le modèle (disponible uniquement en mode d'entrée en streaming). Passer `undefined` ou la chaîne `"default"` rétablit le [modèle par défaut de Claude Code](/docs/fr/model-config) |705| `setModel()` | Modifie le modèle (disponible uniquement en mode d'entrée en streaming). Passer `undefined` ou la chaîne `"default"` rétablit le [modèle par défaut de Claude Code](/docs/fr/model-config) |

703| `setMaxThinkingTokens()` | *Obsolète :* utilisez plutôt l'option `thinking`. Modifie le nombre maximal de tokens de réflexion. Passer `null` rétablit la réflexion à la valeur par défaut de la session : un remplacement effectué en cours de session est effacé, et la réflexion reste désactivée pour les sessions où elle l'est |706| `setMaxThinkingTokens()` | *Obsolète :* Utilisez plutôt l'option `thinking`. Modifie le nombre maximal de tokens de réflexion. Passer `null` rétablit la réflexion à la valeur par défaut de la session : un remplacement en cours de session est effacé, et la réflexion reste désactivée pour les sessions où elle est désactivée |

704| `applyFlagSettings(settings)` | Fusionne des paramètres dans la couche de paramètres de flags de la session à l'exécution (disponible uniquement en mode d'entrée en streaming). Consultez [`applyFlagSettings()`](#applyflagsettings) |707| `applyFlagSettings(settings)` | Fusionne des paramètres dans la couche de paramètres de flag de la session à l'exécution (disponible uniquement en mode d'entrée en streaming). Consultez [`applyFlagSettings()`](#applyflagsettings) |

705| `updateSettings(source, settings)` | Écrit une clé autorisée dans le fichier de paramètres locaux du projet ou dans votre fichier de paramètres utilisateur, afin que la valeur persiste pour les sessions ultérieures. Consultez [`updateSettings()`](#updatesettings). Nécessite le SDK TypeScript v0.3.257 ou ultérieure, qui intègre Claude Code v2.1.257 |708| `updateSettings(source, settings)` | Écrit une clé autorisée dans le fichier de paramètres locaux du projet ou dans votre fichier de paramètres utilisateur, afin que la valeur persiste pour les sessions ultérieures. Consultez [`updateSettings()`](#updatesettings). Nécessite TypeScript SDK v0.3.257 ou ultérieure, qui inclut Claude Code v2.1.257 |

706| `initializationResult()` | Renvoie le résultat d'initialisation complet, y compris les commandes prises en charge, les modèles, les informations du compte et la configuration du style de sortie |709| `initializationResult()` | Renvoie le résultat complet de l'initialisation, y compris les commandes prises en charge, les modèles, les informations de compte et la configuration du style de sortie |

707| `reinitialize()` | Renvoie la requête de contrôle `initialize` à la CLI en cours d'exécution et renvoie un résultat à jour au lieu du résultat mis en cache lors de la première connexion. Utilisez-la après une interruption du transport, par exemple lorsque vous vous rattachez à une session après une déconnexion, afin que les demandes de permission en attente parviennent à nouveau à votre callback `canUseTool`. Rendez le callback idempotent par identifiant de requête, car une requête dont la réponse a été perdue est de nouveau distribuée. Nécessite Claude Code v2.1.195 ou ultérieure |710| `reinitialize()` | Renvoie la requête de contrôle `initialize` à la CLI en cours d'exécution et renvoie un nouveau résultat au lieu du résultat mis en cache lors de la première connexion. Utilisez-la après une interruption du transport, par exemple lors du rattachement à une session après une déconnexion, afin que les demandes de permission en attente parviennent de nouveau à votre callback `canUseTool`. Rendez le callback idempotent par ID de requête, car une requête dont la réponse a été perdue est de nouveau distribuée. Nécessite Claude Code v2.1.195 ou ultérieure |

708| `supportedCommands()` | Renvoie les commandes disponibles. À partir de l'Agent SDK v0.3.216, la liste reflète les modifications de commandes en cours de session ; consultez [`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) |711| `supportedCommands()` | Renvoie les commandes disponibles. À partir d'Agent SDK v0.3.216, la liste reflète les modifications de commandes en cours de session ; consultez [`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) |

709| `supportedModels()` | Renvoie les modèles disponibles avec leurs informations d'affichage |712| `supportedModels()` | Renvoie les modèles disponibles avec leurs informations d'affichage |

710| `supportedAgents()` | Renvoie les sous-agents disponibles sous forme de [`AgentInfo`](#agentinfo)`[]` |713| `supportedAgents()` | Renvoie les sous-agents disponibles sous forme de [`AgentInfo`](#agentinfo)`[]` |

711| `mcpServerStatus()` | Renvoie l'état des serveurs MCP connectés sous forme de [`McpServerStatus`](#mcpserverstatus)`[]` |714| `mcpServerStatus()` | Renvoie l'état des serveurs MCP connectés sous forme de [`McpServerStatus`](#mcpserverstatus)`[]` |

712| `getContextUsage(opts?)` | Renvoie un [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) détaillant l'utilisation de la fenêtre de contexte de la session par catégorie, skill et outil. Avec la valeur `detail` par défaut, il s'agit des mêmes données que celles affichées par `/context` dans une session interactive, calculées à l'aide de requêtes API de comptage de tokens qui n'apparaissent pas dans le flux de messages ; consultez [la façon dont ces requêtes sont traitées](#sdkcontrolgetcontextusageresponse). L'[option `detail`](#sdkcontrolgetcontextusageresponse) nécessite l'Agent SDK v0.3.257 ou ultérieure |715| `getContextUsage(opts?)` | Renvoie un [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) qui détaille l'utilisation de la fenêtre de contexte de la session par catégorie, skill et outil. Avec la valeur par défaut de `detail`, il s'agit des mêmes données que celles affichées par `/context` dans une session interactive, calculées avec des requêtes API de comptage de tokens qui n'apparaissent pas dans le flux de messages ; consultez [comment ces requêtes sont traitées](#sdkcontrolgetcontextusageresponse). L'[option `detail`](#sdkcontrolgetcontextusageresponse) nécessite Agent SDK v0.3.257 ou ultérieure |

713| `readFile(path, options?)` | Lit un fichier depuis le système de fichiers de la session. Claude Code résout le chemin par rapport à `cwd` ; [Ce que `readFile()` peut lire](#what-readfile-can-read) liste les fichiers qu'il sert. Passez `{ maxBytes }` pour modifier la limite de lecture (1 Mo par défaut, 10 Mo au maximum) et `{ encoding: 'base64' }` pour les fichiers binaires tels que les images. Se résout avec un [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse), ou `null` en cas de refus de permission, de fichier manquant ou d'erreur de transport. Nécessite le SDK TypeScript v0.2.121 ou ultérieure |716| `readFile(path, options?)` | Lit un fichier depuis le système de fichiers de la session. Claude Code résout le chemin par rapport à `cwd` ; [Ce que `readFile()` peut lire](#what-readfile-can-read) liste les fichiers qu'elle sert. Passez `{ maxBytes }` pour modifier la limite de lecture (1 Mo par défaut, 10 Mo maximum) et `{ encoding: 'base64' }` pour les fichiers binaires tels que les images. Se résout avec un [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse), ou `null` en cas de refus de permission, de fichier manquant ou d'erreur de transport. Nécessite TypeScript SDK v0.2.121 ou ultérieure |

714| `reloadPlugins(options?)` | Recharge les plugins depuis le disque, afin que les plugins que vous installez ou modifiez en cours de session soient pris en compte par la session en cours. Se résout avec un [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse) listant les commandes, les sous-agents, les plugins et l'état des serveurs MCP de la session. Nécessite l'Agent SDK v0.2.85 ou ultérieure. L'[option `holdOnCacheImpact`](#sdkcontrolreloadpluginsresponse) nécessite l'Agent SDK v0.3.268 ou ultérieure |717| `reloadPlugins(options?)` | Recharge les plugins depuis le disque, afin que les plugins que vous installez ou modifiez en cours de session parviennent à la session en cours. Se résout avec un [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse) listant les commandes, les sous-agents, les plugins et l'état des serveurs MCP de la session. Nécessite Agent SDK v0.2.85 ou ultérieure. L'[option `holdOnCacheImpact`](#sdkcontrolreloadpluginsresponse) nécessite Agent SDK v0.3.268 ou ultérieure |

715| `reloadSkills()` | Recharge les skills depuis le disque, afin que les skills que vous ajoutez ou modifiez en cours de session deviennent disponibles pour la session en cours. Se résout avec un [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) listant les skills disponibles après le rechargement. Nécessite l'Agent SDK v0.3.163 ou ultérieure |718| `reloadSkills()` | Recharge les skills depuis le disque, afin que les skills que vous ajoutez ou modifiez en cours de session deviennent disponibles pour la session en cours. Se résout avec un [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) listant les skills disponibles après le rechargement. Nécessite Agent SDK v0.3.163 ou ultérieure |

716| `reloadOutputStyles()` | Relit les [styles de sortie](/docs/fr/output-styles) depuis le disque, afin qu'un fichier de style que vous ajoutez ou modifiez en cours de session devienne disponible pour la session en cours. Se résout avec un [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) listant les noms des styles disponibles après le rechargement. Nécessite l'Agent SDK v0.3.261 ou ultérieure |719| `reloadOutputStyles()` | Relit les [styles de sortie](/docs/fr/output-styles) depuis le disque, afin qu'un fichier de style que vous ajoutez ou modifiez en cours de session devienne disponible pour la session en cours. Se résout avec un [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) listant les noms de styles disponibles après le rechargement. Nécessite Agent SDK v0.3.261 ou ultérieure |

717| `accountInfo()` | Renvoie les informations du compte |720| `accountInfo()` | Renvoie les informations du compte |

718| `reconnectMcpServer(serverName)` | Reconnecter un serveur MCP par son nom. Si le nom correspond également à une entrée d'un fichier de paramètres tel que `.mcp.json` ou `~/.claude.json`, Claude Code reconnecte le serveur que vous avez configuré via [`mcpServers`](#options) ou `setMcpServers()`, et non l'entrée du fichier de paramètres. Cet ordre de résolution nécessite Claude Code v2.1.257 ou ultérieure |721| `reconnectMcpServer(serverName)` | Reconnecte un serveur MCP par son nom. Si le nom correspond également à une entrée d'un fichier de paramètres tel que `.mcp.json` ou `~/.claude.json`, Claude Code reconnecte le serveur que vous avez configuré via [`mcpServers`](#options) ou `setMcpServers()`, et non l'entrée du fichier de paramètres. Cet ordre de résolution nécessite Claude Code v2.1.257 ou ultérieure |

719| `toggleMcpServer(serverName, enabled)` | Activer ou désactiver un serveur MCP par son nom, avec la même résolution de nom que `reconnectMcpServer()`. La désactivation d'un serveur le déconnecte et retire ses outils. Consultez [`toggleMcpServer()`](#togglemcpserver) pour connaître la version de Claude Code requise pour chaque type de serveur |722| `toggleMcpServer(serverName, enabled)` | Active ou désactive un serveur MCP par son nom, avec la même résolution de nom que `reconnectMcpServer()`. Désactiver un serveur le déconnecte et retire ses outils. Consultez [`toggleMcpServer()`](#togglemcpserver) pour connaître la version de Claude Code requise pour chaque type de serveur |

720| `setMcpServers(servers)` | Remplacer dynamiquement l'ensemble des serveurs MCP de cette session. Se résout avec un [`McpSetServersResult`](#mcpsetserversresult) indiquant quels serveurs ont été ajoutés et retirés, ainsi que les éventuelles erreurs |723| `setMcpServers(servers)` | Remplace les serveurs MCP gérés par cette méthode : les serveurs ajoutés par son intermédiaire et les [serveurs SDK in-process](#createsdkmcpserver). Se résout avec un [`McpSetServersResult`](#mcpsetserversresult) indiquant quels serveurs ont été ajoutés et retirés, ainsi que les éventuelles erreurs ; cette section indique quels autres serveurs restent connectés |

721| `readMcpResource(serverName, uri)` | *Alpha.* Lit une ressource MCP Apps `ui://` depuis un serveur MCP connecté afin que votre application puisse afficher le widget d'un outil. Se résout avec un [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Nécessite l'Agent SDK TypeScript v0.3.280 ou ultérieure |724| `readMcpResource(serverName, uri)` | *Alpha.* Lit une ressource MCP Apps `ui://` depuis un serveur MCP connecté afin que votre application puisse afficher le widget d'un outil. Se résout avec un [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Nécessite TypeScript Agent SDK v0.3.280 ou ultérieure |

722| `streamInput(stream)` | Envoyer en flux des messages d'entrée à la requête pour les conversations multi-tours |725| `streamInput(stream)` | Envoie des messages d'entrée en flux à la requête pour les conversations multi-tours |

723| `stopTask(taskId)` | Arrêter une tâche en arrière-plan en cours d'exécution par son identifiant |726| `stopTask(taskId)` | Arrête une tâche en arrière-plan en cours d'exécution par son ID |

724| `close()` | Fermer la requête et terminer le processus sous-jacent. Met fin de force à la requête et libère toutes les ressources |727| `close()` | Ferme la requête et termine le processus sous-jacent. Met fin de force à la requête et libère toutes les ressources |

725 728 

726<h4 id="applyflagsettings">729<h4 id="applyflagsettings">

727 `applyFlagSettings()`730 `applyFlagSettings()`

728</h4>731</h4>

729 732 

730Modifie les [paramètres](/docs/fr/settings) d'une session en cours sans redémarrer la requête. Utilisez-la lorsqu'un paramètre dépourvu de setter dédié doit changer en cours de session, par exemple pour resserrer `permissions` après que l'agent a lu une entrée non fiable. `setModel()` et `setPermissionMode()` sont des setters dédiés à ces deux clés ; `applyFlagSettings()` est la forme générale qui accepte n'importe quel sous-ensemble des clés de paramètres, et passer `model` ici se comporte comme `setModel()`.733Modifie les [paramètres](/docs/fr/settings) d'une session en cours sans redémarrer la requête. Utilisez-la lorsqu'un paramètre dépourvu de setter dédié doit changer en cours de session, par exemple pour resserrer `permissions` après que l'agent a lu une entrée non fiable. `setModel()` et `setPermissionMode()` sont des setters dédiés pour ces deux clés ; `applyFlagSettings()` est la forme générale qui accepte n'importe quel sous-ensemble des clés de paramètres, et passer `model` ici se comporte de la même manière que `setModel()`.

731 734 

732Seules certaines clés prennent effet en cours de session :735Seules certaines clés prennent effet en cours de session :

733 736 

734* **Appliquées au tour suivant** : `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `agent`. Changer `agent` applique également le remplacement de modèle et les hooks de cet agent au tour suivant. Son prompt système s'applique au tour suivant ou, dans une session qui [réutilise un prompt système enregistré](/docs/fr/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session), une fois la session compactée.737* **Appliquées au tour suivant** : `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `agent`. Changer d'`agent` applique également le remplacement de modèle et les hooks de cet agent au tour suivant. Son prompt système s'applique au tour suivant ou, dans une session qui [réutilise un prompt système enregistré](/docs/fr/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session), une fois la session compactée.

735* **Appliquée pendant le tour en cours** : `model`. Si vous changez `model` pendant que Claude travaille sur un tour, la réponse que Claude est déjà en train de générer se termine avec l'ancien modèle, et le reste du tour, à partir du prochain appel que Claude Code adresse au modèle, utilise le nouveau. Les sous-agents conservent leur propre modèle. Avant la v2.1.212, un changement en cours de tour attendait le tour suivant.738* **Appliquée pendant le tour en cours** : `model`. Si vous changez de `model` pendant que Claude travaille sur un tour, la réponse que Claude est déjà en train de générer se termine avec l'ancien modèle, et le reste du tour, à partir du prochain appel que Claude Code adresse au modèle, utilise le nouveau. Les sous-agents conservent leur propre modèle. Avant v2.1.212, un changement en cours de tour attendait le tour suivant.

736* **Sans effet en cours de session** : les options du prompt système. Elles sont résolues une seule fois au démarrage, de sorte que la session en cours conserve la valeur d'origine même si l'appel réussit. Pour les modifier, démarrez une nouvelle session.739* **Sans effet en cours de session** : les options du prompt système. Elles sont résolues une seule fois au démarrage, de sorte que la session en cours conserve la valeur d'origine même si l'appel réussit. Pour les modifier, démarrez une nouvelle session.

737 740 

738`effortLevel` accepte un nom de [niveau d'effort](/docs/fr/model-config#adjust-effort-level). Il accepte aussi `"ultracode"`, qui demande un effort `xhigh` avec [ultracode](/docs/fr/workflows#let-claude-decide-with-ultracode) activé. `applyFlagSettings()` déclare `effortLevel` sans cette valeur ; en TypeScript, passez donc `{ ultracode: true, effortLevel: "xhigh" }` pour obtenir le même résultat, ou la clé [`ultracode`](/docs/fr/settings-reference#ultracode) seule pour activer ultracode au niveau d'effort actuel de la session. La valeur `ultracode` nécessite Claude Code v2.1.203 ou ultérieure et n'est acceptée que par `applyFlagSettings()`, pas par la clé `effortLevel` d'un fichier de paramètres. Avant la v2.1.284, la clé `ultracode` seule définissait également le niveau sur `xhigh`.741`effortLevel` accepte un nom de [niveau d'effort](/docs/fr/model-config#adjust-effort-level). Il accepte également `"ultracode"`, qui demande un effort `xhigh` avec [ultracode](/docs/fr/workflows#let-claude-decide-with-ultracode) activé. `applyFlagSettings()` déclare `effortLevel` sans cette valeur ; en TypeScript, passez donc `{ ultracode: true, effortLevel: "xhigh" }` pour obtenir le même résultat, ou la clé [`ultracode`](/docs/fr/settings-reference#ultracode) seule pour activer ultracode au niveau d'effort actuel de la session. La valeur `ultracode` nécessite Claude Code v2.1.203 ou ultérieure et n'est acceptée que par `applyFlagSettings()`, et non par la clé `effortLevel` d'un fichier de paramètres. Avant v2.1.284, la clé `ultracode` seule définissait également le niveau sur `xhigh`.

739 742 

740Les valeurs sont écrites dans la couche de paramètres de flags, fusionnées par-dessus ce que l'option `settings` inline de `query()` a défini au démarrage. Il s'agit du même niveau que celui que la [section sur la priorité](#settings-precedence) de cette page appelle options programmatiques.743Les valeurs sont écrites dans la couche de paramètres de flag, fusionnées par-dessus ce que l'option inline `settings` de `query()` a défini au démarrage. Il s'agit du même niveau que celui que la [section sur la priorité de cette page](#settings-precedence) appelle options programmatiques.

741 744 

742Les appels successifs fusionnent superficiellement les clés de premier niveau. Un second appel avec `{ permissions: {...} }` remplace l'intégralité de l'objet `permissions` de l'appel précédent au lieu de le fusionner en profondeur.745Les appels successifs fusionnent superficiellement les clés de premier niveau. Un second appel avec `{ permissions: {...} }` remplace l'intégralité de l'objet `permissions` de l'appel précédent au lieu de le fusionner en profondeur.

743 746 

744Pour effacer une clé que vous avez définie avec `applyFlagSettings()`, passez `null` pour cette clé. La plupart des clés se rabattent alors d'abord sur une valeur définie au démarrage par l'option `settings` de `query()`, puis sur les sources de priorité inférieure. Un `model` effacé revient au [modèle par défaut de Claude Code](/docs/fr/model-config), même lorsqu'un fichier de paramètres définit `model`. Passer `undefined` n'a aucun effet, car la sérialisation JSON le supprime.747Pour effacer une clé définie avec `applyFlagSettings()`, passez `null` pour cette clé. La plupart des clés se rabattent alors d'abord sur une valeur définie au démarrage par l'option `settings` de `query()`, puis sur des sources de priorité inférieure. Un `model` effacé revient au [modèle par défaut de Claude Code](/docs/fr/model-config), même lorsqu'un fichier de paramètres définit `model`. Passer `undefined` n'a aucun effet, car la sérialisation JSON le supprime.

745 748 

746Trois clés, en plus de `model`, réinitialisent l'état de la session au lieu de se rabattre sur une autre valeur :749Trois clés en plus de `model` réinitialisent l'état de la session au lieu de se rabattre sur une autre valeur :

747 750 

748* `effortLevel: null` ramène la session au niveau d'effort par défaut du modèle, et non à l'option `effort` de `query()` ni à un `effortLevel` provenant d'un fichier de paramètres.751* `effortLevel: null` ramène la session au niveau d'effort par défaut du modèle, et non à l'option `effort` de `query()` ni à un `effortLevel` provenant d'un fichier de paramètres.

749* `agent: null` exécute le thread principal sans agent à partir du tour suivant, au lieu de restaurer l'option `agent` de `query()` ou un `agent` provenant d'un fichier de paramètres. Si l'agent effacé avait appliqué son propre modèle, la session revient au modèle qu'elle avait résolu au démarrage.752* `agent: null` exécute le thread principal sans agent à partir du tour suivant, au lieu de restaurer l'option `agent` de `query()` ou un `agent` provenant d'un fichier de paramètres. Si l'agent effacé avait appliqué son propre modèle, la session revient au modèle résolu au démarrage.

750* `ultracode: null` désactive ultracode, comme le fait `false`, au lieu de restaurer une valeur `ultracode` provenant d'un fichier de paramètres. La session conserve son niveau d'effort actuel ; passez donc `effortLevel` dans le même appel pour le modifier.753* `ultracode: null` désactive ultracode, comme `false`, au lieu de restaurer une valeur `ultracode` provenant d'un fichier de paramètres. La session conserve son niveau d'effort actuel ; passez donc `effortLevel` dans le même appel pour le modifier.

751 754 

752Disponible uniquement en mode d'entrée en streaming, la même contrainte que pour `setModel()` et `setPermissionMode()`.755Disponible uniquement en mode d'entrée en streaming, la même contrainte que pour `setModel()` et `setPermissionMode()`.

753 756 


773 `updateSettings()`776 `updateSettings()`

774</h4>777</h4>

775 778 

776Écrit une clé autorisée dans un fichier de paramètres sur disque, afin que la valeur persiste pour les sessions ultérieures qui chargent cette source. Chaque source accepte une seule clé, avec une valeur de type chaîne :779Écrit une clé autorisée dans un fichier de paramètres sur disque, afin que la valeur persiste pour les sessions ultérieures qui chargent cette source. Chaque source accepte une clé, avec une valeur de type chaîne :

777 780 

778* **`"localSettings"`** : accepte `outputStyle` et le fusionne dans le fichier de paramètres locaux du projet, `.claude/settings.local.json`. Le nouveau style prend effet à la prochaine requête de la session.781* **`"localSettings"`** : accepte `outputStyle` et le fusionne dans le fichier de paramètres locaux du projet, `.claude/settings.local.json`. Le nouveau style prend effet à la prochaine requête de la session.

779* **`"userSettings"`** : accepte `effortLevel` et l'enregistre comme [niveau d'effort](/docs/fr/model-config#adjust-effort-level) par défaut pour le modèle actuel de la session, sous [`modelSettings`](/docs/fr/settings-reference#modelsettings) dans votre fichier de paramètres utilisateur. Passer `max` n'écrit rien, car `max` est limité à la session. Dans les deux cas, la session en cours conserve son niveau d'effort actuel ; appelez donc [`applyFlagSettings()`](#applyflagsettings) si vous souhaitez également le modifier. Cette source nécessite le SDK TypeScript v0.3.277 ou ultérieure, qui intègre Claude Code v2.1.277.782* **`"userSettings"`** : accepte `effortLevel` et l'enregistre comme [niveau d'effort](/docs/fr/model-config#adjust-effort-level) par défaut pour le modèle actuel de la session, sous [`modelSettings`](/docs/fr/settings-reference#modelsettings) dans votre fichier de paramètres utilisateur. Passer `max` n'écrit rien, car `max` est limité à la session. La session en cours conserve son niveau d'effort actuel dans tous les cas ; appelez donc [`applyFlagSettings()`](#applyflagsettings) si vous souhaitez également le modifier. Cette source nécessite TypeScript SDK v0.3.277 ou ultérieure, qui inclut Claude Code v2.1.277.

780 783 

781L'appel est rejeté lorsque la requête contient une autre clé, lorsque la session s'exécute via un transport distant, et lorsque les [`settingSources`](#options) de la session excluent la source que vous indiquez. La suppression d'une clé n'est pas prise en charge.784L'appel est rejeté lorsque la requête contient toute autre clé, lorsque la session s'exécute via un transport distant, et lorsque les [`settingSources`](#options) de la session excluent la source que vous indiquez. La suppression d'une clé n'est pas prise en charge.

782 785 

783<h4 id="togglemcpserver">786<h4 id="togglemcpserver">

784 `toggleMcpServer()`787 `toggleMcpServer()`

785</h4>788</h4>

786 789 

787La désactivation d'un serveur le déconnecte et retire ses outils de la session. Pour les serveurs que vous avez ajoutés en cours de session et pour les serveurs in-process, cela dépend de votre version de Claude Code :790Désactiver un serveur le déconnecte et retire ses outils de la session. Pour les serveurs que vous avez ajoutés en cours de session et pour les serveurs in-process, cela dépend de votre version de Claude Code :

788 791 

789* Un serveur stdio, SSE ou HTTP que vous avez ajouté en cours de session avec `setMcpServers()` : le retrait de ses outils nécessite Claude Code v2.1.285 ou ultérieure.792* Un serveur stdio, SSE ou HTTP que vous avez ajouté en cours de session avec `setMcpServers()` : le retrait de ses outils nécessite Claude Code v2.1.285 ou ultérieure.

790* Un serveur in-process que vous avez créé avec [`createSdkMcpServer()`](#createsdkmcpserver), que vous l'ayez passé dans `mcpServers` ou avec `setMcpServers()` : sa déconnexion et le retrait de ses outils nécessitent Claude Code v2.1.286 ou ultérieure. La désactivation d'un tel serveur fait également échouer ses appels d'outils encore en cours, de sorte que Claude reçoit immédiatement un résultat d'erreur pour chacun d'eux, sans attendre que votre handler retourne.793* Un serveur in-process que vous avez créé avec [`createSdkMcpServer()`](#createsdkmcpserver), que vous l'ayez passé dans `mcpServers` ou avec `setMcpServers()` : sa déconnexion et le retrait de ses outils nécessitent Claude Code v2.1.286 ou ultérieure. La désactivation d'un tel serveur fait également échouer ses appels d'outils encore en cours, de sorte que Claude reçoit immédiatement un résultat d'erreur pour chacun d'eux, sans attendre le retour de votre handler.

791 794 

792<h3 id="warmquery">795<h3 id="warmquery">

793 `WarmQuery`796 `WarmQuery`


808 811 

809| Méthode | Description |812| Méthode | Description |

810| :- | :- |813| :- | :- |

811| `query(prompt)` | Envoyer un prompt au sous-processus préchauffé et renvoyer un [`Query`](#query-object). Ne peut être appelée qu'une seule fois par `WarmQuery` |814| `query(prompt)` | Envoie un prompt au sous-processus préchauffé et renvoie un [`Query`](#query-object). Ne peut être appelée qu'une seule fois par `WarmQuery` |

812| `close()` | Fermer le sous-processus sans envoyer de prompt. Utilisez-la pour abandonner une requête préchauffée qui n'est plus nécessaire |815| `close()` | Ferme le sous-processus sans envoyer de prompt. Utilisez-la pour abandonner une requête préchauffée dont vous n'avez plus besoin |

813 816 

814`WarmQuery` implémente `AsyncDisposable`, il peut donc être utilisé avec `await using` pour un nettoyage automatique.817`WarmQuery` implémente `AsyncDisposable`, il peut donc être utilisé avec `await using` pour un nettoyage automatique.

815 818 


817 `SpareProcess`820 `SpareProcess`

818</h3>821</h3>

819 822 

820*Alpha.* Handle renvoyé par [`prewarm()`](#prewarm) : un processus Claude Code démarré qui n'est encore lié à aucune session et qui peut être réclamé une seule fois. Nécessite l'Agent SDK TypeScript v0.3.282 ou ultérieure.823*Alpha.* Handle renvoyé par [`prewarm()`](#prewarm) : un processus Claude Code démarré qui n'est pas encore lié à une session et qui peut être réclamé une seule fois. Nécessite TypeScript Agent SDK v0.3.282 ou ultérieure.

821 824 

822```typescript theme={null}825```typescript theme={null}

823interface SpareProcess extends AsyncDisposable {826interface SpareProcess extends AsyncDisposable {


837 840 

838| Membre | Description |841| Membre | Description |

839| :- | :- |842| :- | :- |

840| `claim({ prompt, options })` | Lier le processus de réserve à une session dans `options.cwd` et envoyer son premier message. Renvoie un [`Query`](#query-object) de manière synchrone, comme le fait `query()`. Ne peut être appelée qu'une seule fois |843| `claim({ prompt, options })` | Lie le processus de réserve à une session dans `options.cwd` et envoie son premier message. Renvoie un [`Query`](#query-object) de manière synchrone, comme le fait `query()`. Ne peut être appelée qu'une seule fois |

841| `claimed` | Se résout avec le répertoire de travail et l'identifiant de la session une fois que Claude Code accepte la réclamation. Est rejetée lorsque Claude Code refuse la réclamation, lorsque le processus s'est terminé ou a été fermé auparavant, et, avec un message commençant par `option_not_applied`, lorsque la session s'exécute sans le `model` ou le `maxThinkingTokens` que vous avez demandé |844| `claimed` | Se résout avec le répertoire de travail et l'ID de la session une fois que Claude Code accepte la réclamation. Est rejetée lorsque Claude Code refuse la réclamation, lorsque le processus s'est terminé ou a été fermé auparavant, et, avec un message commençant par `option_not_applied`, lorsque la session s'exécute sans le `model` ou le `maxThinkingTokens` que vous avez demandé |

842| `exited` | Se règle lorsque le processus se termine, qu'il ait été réclamé ou non. Remplacez un processus de réserve qui se termine avant que vous ne le réclamiez |845| `exited` | Se règle lorsque le processus se termine, qu'il ait été réclamé ou non. Remplacez un processus de réserve qui se termine avant que vous ne le réclamiez |

843| `close()` | Terminer le processus. Avant une réclamation, cela abandonne le processus de réserve et rejette `claimed` |846| `close()` | Termine le processus. Avant une réclamation, cela abandonne le processus de réserve et rejette `claimed` |

844 847 

845`options.cwd` est obligatoire. Une réclamation peut également définir `additionalDirectories`, `model`, `permissionMode`, `maxThinkingTokens`, une surcouche de paramètres de flags dans `settings`, `appendSystemPrompt`, `title`, `agents` et des jetons propres à la session dans `env`.848`options.cwd` est requis. Une réclamation peut également définir `additionalDirectories`, `model`, `permissionMode`, `maxThinkingTokens`, une surcouche de paramètres de flag dans `settings`, `appendSystemPrompt`, `title`, `agents` et des jetons propres à la session dans `env`.

846 849 

847Claude Code peut refuser une réclamation, par exemple pour un dossier qui n'existe pas ou dont les paramètres de projet définissent `env`, `agent` ou `model`. Lorsque `claimed` est rejetée avec un message commençant par `option_not_applied`, la session s'exécute sans le `model` ou le `maxThinkingTokens` que vous avez demandé. Après tout autre rejet, votre prompt n'a pas été exécuté ; démarrez donc plutôt la session avec `query()`.850Claude Code peut refuser une réclamation, par exemple pour un dossier qui n'existe pas ou dont les paramètres de projet définissent `env`, `agent` ou `model`. Après un refus, un prompt que `claim()` a déjà envoyé reçoit un résultat d'erreur dont le texte commence par `not_claimed`, puis la requête renvoyée lève une exception. Encapsulez la boucle de la requête dans un bloc try pour continuer au-delà de l'exception. Lorsque `claimed` est rejetée avec un message commençant par `option_not_applied`, la session s'exécute sans le `model` ou le `maxThinkingTokens` que vous avez demandé. Après tout autre rejet, votre prompt n'a pas été exécuté ; démarrez donc plutôt la session avec `query()`.

848 851 

849<h3 id="sdkcontrolinitializeresponse">852<h3 id="sdkcontrolinitializeresponse">

850 `SDKControlInitializeResponse`853 `SDKControlInitializeResponse`


874};877};

875```878```

876 879 

877`hooks_applied` indique si Claude Code a enregistré les `hooks` contenus dans la requête `initialize`. Le SDK envoie cette requête une fois au démarrage de la session, puis à chaque appel à [`reinitialize()`](#query-object). Ce champ nécessite l'Agent SDK v0.3.238 ou ultérieure.880`hooks_applied` indique si Claude Code a enregistré les `hooks` que contenait la requête `initialize`. Le SDK envoie cette requête une fois au démarrage de la session, puis à chaque appel à [`reinitialize()`](#query-object). Le champ nécessite Agent SDK v0.3.238 ou ultérieure.

878 881 

879Claude Code omet ce champ lorsque la requête ne contenait aucun hook. Lorsque la requête contenait des hooks, la valeur dépend du fait que la requête soit ou non la première initialisation de la session et, pour une initialisation répétée, de la manière dont elle a atteint la session :882Claude Code omet le champ lorsque la requête ne contenait aucun hook. Lorsque la requête contenait des hooks, la valeur dépend du fait que la requête soit ou non le premier initialize de la session et, pour un initialize répété, de la manière dont elle a atteint la session :

880 883 

881* `true` : Claude Code a enregistré les hooks. La première initialisation d'une session renvoie cette valeur. Une initialisation répétée envoyée via le stdin de la CLI renvoie également `true`. Dans ce cas, les hooks de la nouvelle requête remplacent ceux enregistrés précédemment.884* `true` : Claude Code a enregistré les hooks. Le premier initialize d'une session renvoie cette valeur. Un initialize répété envoyé via le stdin de la CLI renvoie également `true`. Dans ce cas, les hooks de la nouvelle requête remplacent ceux enregistrés précédemment.

882* `false` : Claude Code a ignoré les hooks. Une initialisation répétée envoyée à une session distante renvoie cette valeur, de sorte qu'un second client qui rejoint une session ne peut pas remplacer les hooks enregistrés par le premier client.885* `false` : Claude Code a ignoré les hooks. Un initialize répété envoyé à une session distante renvoie cette valeur, de sorte qu'un second client qui rejoint une session ne peut pas remplacer les hooks enregistrés par le premier client.

883 886 

884Avant l'Agent SDK v0.3.238, la réponse ne contenait jamais ce champ, et Claude Code ignorait les `hooks` à chaque initialisation répétée.887Avant Agent SDK v0.3.238, la réponse ne contenait jamais ce champ, et Claude Code ignorait `hooks` à chaque initialize répété.

885 888 

886Le champ `sdkMcpServerManifests` de la requête et le champ `sdk_mcp_manifests_parked` de la réponse concernent les [serveurs MCP du SDK](/docs/fr/agent-sdk/custom-tools) in-process que vous avez créés avec [`createSdkMcpServer()`](#createsdkmcpserver). Votre application ne définit ni ne lit aucun de ces deux champs.889Le champ `sdkMcpServerManifests` de la requête et le champ `sdk_mcp_manifests_parked` de la réponse concernent les [serveurs MCP SDK](/docs/fr/agent-sdk/custom-tools) in-process que vous avez créés avec [`createSdkMcpServer()`](#createsdkmcpserver). Votre application ne définit ni ne lit aucun de ces champs.

887 890 

888La réponse indique toujours `fast_mode_state`, et lorsque quelque chose bloque le [mode rapide](/docs/fr/fast-mode), `fast_mode_disabled_reason` fournit le code de raison en complément, afin que vous puissiez expliquer l'état bloqué au lieu de recalculer la disponibilité. Ces deux comportements nécessitent Claude Code v2.1.219 ou ultérieure. Avant la v2.1.219, la réponse omettait `fast_mode_state` lorsque le mode rapide n'était pas disponible et ne fournissait jamais de raison. Pour les codes de raison et leur signification, consultez [`fast_mode_disabled_reason`](#sdkresultmessage) sur le message de résultat.891La réponse indique toujours `fast_mode_state`, et lorsqu'un élément bloque le [mode rapide](/docs/fr/fast-mode), `fast_mode_disabled_reason` fournit le code de raison en complément, afin que vous puissiez expliquer l'état bloqué au lieu de redéduire la disponibilité. Ces deux comportements nécessitent Claude Code v2.1.219 ou ultérieure. Avant v2.1.219, la réponse omettait `fast_mode_state` lorsque le mode rapide n'était pas disponible et ne fournissait jamais de raison. Pour les codes de raison et leur signification, consultez [`fast_mode_disabled_reason`](#sdkresultmessage) dans le message de résultat.

889 892 

890L'enveloppe de réponse de contrôle d'un `initialize` réussi contient également un tableau `pending_permission_requests`. Ce champ se trouve sur l'enveloppe de réponse elle-même, et non dans le payload `SDKControlInitializeResponse` ci-dessus. Chaque entrée est un message `control_request` complet, de même forme `{ type: "control_request", request_id, request }` que celle que la session diffuse pour les demandes de permission pendant son exécution.893Le wrapper de réponse de contrôle d'un `initialize` réussi contient également un tableau `pending_permission_requests`. Le champ se trouve sur le wrapper de réponse lui-même, et non dans le payload `SDKControlInitializeResponse` ci-dessus. Chaque entrée est un message `control_request` complet, avec la même forme `{ type: "control_request", request_id, request }` que celle des demandes de permission que la session diffuse en flux pendant son exécution.

891 894 

892Le tableau liste les demandes de permission que ce processus Claude Code a émises et qui ne sont pas encore résolues. Le SDK lit le tableau pour vous et distribue chaque entrée à votre callback [`canUseTool`](#canusetool), la même redistribution que celle déclenchée par [`reinitialize()`](#query-object) après une interruption du transport. Traitez les identifiants de requête répétés de manière idempotente, car une entrée peut répéter une requête que le callback a déjà reçue avant la perte de connexion.895Le tableau liste les demandes de permission que ce processus Claude Code a émises et qui ne sont pas encore résolues. Le SDK lit le tableau pour vous et distribue chaque entrée à votre callback [`canUseTool`](#canusetool), la même redistribution que celle déclenchée par [`reinitialize()`](#query-object) après une interruption du transport. Traitez les ID de requête répétés de manière idempotente, car une entrée peut répéter une requête que le callback a déjà reçue avant la perte de connexion.

893 896 

894Le tableau est toujours présent dans une réponse `initialize` réussie et il est vide lorsque ce processus n'a aucune demande de permission non résolue. Nécessite Claude Code v2.1.268 ou ultérieure. Les versions antérieures pouvaient omettre ce champ ; si vous analysez vous-même le protocole filaire, considérez donc un champ manquant comme le signe d'une CLI plus ancienne plutôt que comme la preuve qu'aucune demande n'est en attente.897Le tableau est toujours présent dans une réponse `initialize` réussie et il est vide lorsque ce processus n'a aucune demande de permission non résolue. Nécessite Claude Code v2.1.268 ou ultérieure. Les versions antérieures pouvaient omettre le champ ; si vous analysez vous-même le protocole filaire, considérez donc un champ manquant comme le signe d'une CLI plus ancienne plutôt que comme la preuve que rien n'est en attente.

895 898 

896<h3 id="sdkcontrolinterruptresponse">899<h3 id="sdkcontrolinterruptresponse">

897 `SDKControlInterruptResponse`900 `SDKControlInterruptResponse`


906};909};

907```910```

908 911 

909`still_queued` liste les UUID des messages utilisateur qui étaient en attente au moment où l'interruption est arrivée : les messages encore dans la file d'attente, ainsi que tous les messages que Claude Code avait déjà retirés de la file pour le tour suivant. Une fois que le premier tour de la session a commencé, Claude Code traite les messages listés après l'interruption, sauf si vous les annulez d'abord, et peut en fusionner plusieurs en un seul tour. Si vous interrompez avant le début du premier tour, Claude Code interrompt ce tour dès qu'il commence, et les messages listés dans ce tour ne reçoivent aucune réponse.912`still_queued` liste les UUID des messages utilisateur qui étaient en attente lorsque l'interruption est arrivée : les messages encore dans la file d'attente, ainsi que les messages que Claude Code avait déjà retirés de la file pour le tour suivant. Une fois le premier tour de la session commencé, Claude Code traite les messages listés après l'interruption, sauf si vous les annulez d'abord, et peut en fusionner plusieurs en un seul tour. Si vous interrompez avant le début du premier tour, Claude Code interrompt ce tour dès qu'il commence, et les messages listés dans ce tour ne reçoivent aucune réponse.

910 913 

911Utilisez le reçu pour décider s'il faut renvoyer quelque chose. Un message listé que vous n'annulez pas entre dans la conversation, qu'il reçoive une réponse ou non ; le renvoyer le transmettrait donc deux fois à Claude.914Utilisez le reçu pour décider s'il faut renvoyer quelque chose. Un message listé que vous n'annulez pas entre dans la conversation, qu'il reçoive une réponse ou non ; le renvoyer le transmet donc deux fois à Claude.

912 915 

913Interprétez la liste en tenant compte des réserves suivantes :916Interprétez la liste en tenant compte des réserves suivantes :

914 917 

915* Seuls les messages mis en file d'attente avec un UUID apparaissent. Un tableau vide ne signifie pas que rien d'autre ne s'exécutera.918* Seuls les messages mis en file d'attente avec un UUID apparaissent. Un tableau vide ne signifie pas que rien d'autre ne s'exécutera.

916* Seuls les messages du thread principal sont listés. Les messages adressés à un sous-agent sont hors périmètre.919* Seuls les messages du thread principal sont listés. Les messages adressés à un sous-agent sont hors du périmètre.

917* La liste peut inclure des UUID que votre client n'a jamais envoyés, comme les déclencheurs de [tâches planifiées](/docs/fr/scheduled-tasks). Ignorez les UUID que vous ne reconnaissez pas au lieu de les traiter comme une erreur.920* La liste peut inclure des UUID que votre client n'a jamais envoyés, comme les déclencheurs de [tâches planifiées](/docs/fr/scheduled-tasks). Ignorez les UUID que vous ne reconnaissez pas au lieu de les traiter comme une erreur.

918 921 

919Un client qui pilote directement le protocole de contrôle de la CLI, plutôt que via `interrupt()`, peut définir `cancel_queued: true` sur la requête de contrôle `interrupt`. Claude Code v2.1.219 et ultérieure annonce cette prise en charge avec la capacité `interrupt_cancel_queued_v1` dans [`SDKSystemMessage.capabilities`](#sdksystemmessage) ; les CLI plus anciennes ignorent ce champ et laissent les messages en file d'attente s'exécuter normalement. Une telle interruption annule également tous les messages qui auraient autrement été listés sous `still_queued` : le reçu les liste plutôt sous `cancelled`, `still_queued` est vide, et aucun d'eux ne s'exécute.922Un client qui pilote directement le protocole de contrôle de la CLI, plutôt que via `interrupt()`, peut définir `cancel_queued: true` sur la requête de contrôle `interrupt`. Claude Code v2.1.219 et versions ultérieures annoncent la prise en charge avec la capacité `interrupt_cancel_queued_v1` dans [`SDKSystemMessage.capabilities`](#sdksystemmessage) ; les CLI plus anciennes ignorent le champ et laissent les messages en file d'attente s'exécuter normalement. Une telle interruption annule également tous les messages qui seraient sinon listés sous `still_queued` : le reçu les liste sous `cancelled` à la place, `still_queued` est vide, et aucun d'eux ne s'exécute.

920 923 

921La liste `cancelled` est soumise aux mêmes réserves que `still_queued`. La méthode `interrupt()` n'envoie jamais `cancel_queued`, de sorte que les reçus avec lesquels elle se résout ne contiennent pas `cancelled`.924La liste `cancelled` comporte les mêmes réserves que `still_queued`. La méthode `interrupt()` n'envoie jamais `cancel_queued`, de sorte que les reçus avec lesquels elle se résout ne contiennent pas `cancelled`.

922 925 

923Le reçu est un instantané pris au moment où l'interruption est traitée, et lors d'une interruption propre, il arrive avant le [`SDKResultMessage`](#sdkresultmessage) du tour interrompu. Lisez le reçu plutôt que d'inspecter la file d'attente après ce résultat : la boucle démarre immédiatement le tour suivant en file d'attente, de sorte que la file que vous inspectez après le résultat a déjà changé.926Le reçu est un instantané pris au moment où l'interruption est traitée et, lors d'une interruption propre, il arrive avant le [`SDKResultMessage`](#sdkresultmessage) du tour interrompu. Lisez le reçu plutôt que d'inspecter la file d'attente après ce résultat : la boucle démarre immédiatement le tour suivant en file d'attente, de sorte que la file que vous inspectez après le résultat a déjà changé.

924 927 

925<h3 id="sdkcontrolgetcontextusageresponse">928<h3 id="sdkcontrolgetcontextusageresponse">

926 `SDKControlGetContextUsageResponse`929 `SDKControlGetContextUsageResponse`

927</h3>930</h3>

928 931 

929Type de retour de [`getContextUsage()`](#query-object). Avec la valeur `detail` par défaut, il s'agit du même payload que celui que Claude Code affiche pour la commande `/context` dans une session interactive ; en plus des nombres de tokens, il contient donc des champs d'affichage tels que `color` et `gridRows` que Claude Code utilise pour dessiner la grille d'utilisation de `/context`.932Type de retour de [`getContextUsage()`](#query-object). Avec la valeur par défaut de `detail`, il s'agit du même payload que celui que Claude Code affiche pour la commande `/context` dans une session interactive ; en plus des nombres de tokens, il contient donc des champs d'affichage tels que `color` et `gridRows` que Claude Code utilise pour dessiner la grille d'utilisation de `/context`.

930 933 

931L'argument optionnel `detail` de la méthode détermine la façon dont Claude Code comptabilise chaque catégorie. L'argument `detail` nécessite l'Agent SDK v0.3.257 ou ultérieure.934L'argument optionnel `detail` de la méthode détermine la manière dont Claude Code compte chaque catégorie. L'argument `detail` nécessite Agent SDK v0.3.257 ou ultérieure.

932 935 

933* **`'full'`** : la valeur par défaut. Claude Code comptabilise chaque catégorie à l'aide de requêtes API de [comptage de tokens](https://platform.claude.com/docs/en/build-with-claude/token-counting). Ces requêtes n'apparaissent pas dans le flux de messages, de sorte qu'un suivi des coûts qui lit le flux ne les verra pas. Sur l'API Anthropic, le comptage de tokens n'est pas facturé.936* **`'full'`** : la valeur par défaut. Claude Code compte chaque catégorie avec des requêtes API de [comptage de tokens](https://platform.claude.com/docs/en/build-with-claude/token-counting). Ces requêtes n'apparaissent pas dans le flux de messages, de sorte que le suivi des coûts qui lit le flux ne les verra pas. Sur l'API Anthropic, le comptage de tokens n'est pas facturé.

934* **`'summary'`** : passez `{ detail: 'summary' }` pour obtenir plutôt une réponse basée sur l'utilisation de la dernière réponse et sur des estimations locales. Aucune requête de comptage de tokens n'est envoyée, et les chiffres par catégorie sont approximatifs.937* **`'summary'`** : passez `{ detail: 'summary' }` pour obtenir plutôt une réponse basée sur l'utilisation de la dernière réponse et sur des estimations locales. Aucune requête de comptage de tokens n'est envoyée, et les nombres par catégorie sont approximatifs.

935 938 

936Lorsque vous envoyez `/context` comme prompt au lieu d'appeler la méthode, Claude Code joint un payload [`SDKContextUsage`](#sdkcontextusage) au champ `context_usage` du message assistant qui transmet le résultat. Ce champ nécessite l'Agent SDK v0.3.232 ou ultérieure.939Lorsque vous envoyez `/context` comme prompt au lieu d'appeler la méthode, Claude Code joint un payload [`SDKContextUsage`](#sdkcontextusage) au champ `context_usage` du message assistant qui délivre le résultat. Ce champ nécessite Agent SDK v0.3.232 ou ultérieure.

937 940 

938```typescript theme={null}941```typescript theme={null}

939type SDKControlGetContextUsageResponse = {942type SDKControlGetContextUsageResponse = {


1032 1035 

1033Lisez l'attribution des tokens à partir des champs de collection :1036Lisez l'attribution des tokens à partir des champs de collection :

1034 1037 

1035* `categories` contient les totaux par catégorie. Le champ `kind` de chaque entrée classe la ligne avec les mêmes valeurs que [`SDKContextUsageCategory`](#sdkcontextusagecategory). Classez les lignes selon ce champ plutôt que selon le `name` d'affichage. Ce champ nécessite l'Agent SDK v0.3.268 ou ultérieure.1038* `categories` contient les totaux par catégorie. Le `kind` de chaque entrée classe la ligne avec les mêmes valeurs que [`SDKContextUsageCategory`](#sdkcontextusagecategory). Classez les lignes selon ce champ plutôt que selon le `name` d'affichage. Le champ nécessite Agent SDK v0.3.268 ou ultérieure.

1036* `mcpTools` et `agents` attribuent les tokens à chaque outil MCP et à chaque sous-agent.1039* `mcpTools` et `agents` attribuent les tokens à des outils MCP et à des sous-agents individuels.

1037* `memoryFiles` liste chaque fichier mémoire chargé avec son coût.1040* `memoryFiles` liste chaque fichier de mémoire chargé avec son coût.

1038* `skills.skillFrontmatter` attribue les tokens de la liste des skills à chaque skill inclus. Les nombres par skill mesurent l'entrée de chaque skill dans la liste telle que Claude Code l'envoie réellement, ce qui peut être plus court que le frontmatter complet du skill. Comparez `skills.totalSkills` avec `skills.includedSkills` pour vérifier si tous les skills découverts figurent dans la liste.1041* `skills.skillFrontmatter` attribue les tokens de la liste des skills à chaque skill inclus. Les nombres par skill mesurent l'entrée de chaque skill dans la liste telle que Claude Code l'envoie réellement, qui peut être plus courte que le frontmatter complet du skill. Comparez `skills.totalSkills` à `skills.includedSkills` pour vérifier si chaque skill découvert figure dans la liste.

1039 1042 

1040`totalTokens` correspond à l'utilisation actuelle du contexte de la session, et `maxTokens` à la fenêtre par rapport à laquelle cette utilisation est mesurée. Cette fenêtre est la fenêtre de contexte du modèle, ou la fenêtre de compaction automatique inférieure lorsqu'elle s'applique. `rawMaxTokens` contient la même valeur que `maxTokens`, et `percentage` correspond à `totalTokens` exprimé en pourcentage arrondi de cette fenêtre. `apiUsage` contient l'utilisation de la dernière réponse de l'API, et non un total cumulé pour la session.1043`totalTokens` représente l'utilisation actuelle du contexte de la session, et `maxTokens` la fenêtre par rapport à laquelle cette utilisation est mesurée. Cette fenêtre est la fenêtre de contexte du modèle, ou la fenêtre de compaction automatique inférieure lorsqu'elle s'applique. `rawMaxTokens` contient la même valeur que `maxTokens`, et `percentage` correspond à `totalTokens` exprimé en pourcentage arrondi de cette fenêtre. `apiUsage` contient l'utilisation issue de la dernière réponse de l'API, et non un total cumulé pour la session.

1041 1044 

1042Claude Code laisse non définis les diagnostics optionnels `deferredBuiltinTools`, `systemTools` et `systemPromptSections` ; attendez-vous donc à ce qu'ils soient absents, même si le type les déclare.1045Claude Code laisse non définis les diagnostics optionnels `deferredBuiltinTools`, `systemTools` et `systemPromptSections` ; attendez-vous donc à ce qu'ils soient absents, même si le type les déclare.

1043 1046 


1056};1059};

1057```1060```

1058 1061 

1059`contents` contient le texte du fichier, ou des données base64 lorsque vous avez demandé `encoding: 'base64'` ; dans ce cas, le champ `encoding` de la réponse est défini sur `'base64'`. `absPath` est le chemin absolu résolu. `truncated` est défini lorsque le fichier dépassait la limite `maxBytes` et que le contenu a été tronqué à cette limite.1062`contents` contient le texte du fichier, ou des données base64 lorsque vous avez demandé `encoding: 'base64'` ; le champ `encoding` de la réponse est alors défini sur `'base64'`. `absPath` est le chemin absolu résolu. `truncated` est défini lorsque le fichier dépassait la limite `maxBytes` et que le contenu a été tronqué à cette limite.

1060 1063 

1061<h4 id="what-readfile-can-read">1064<h4 id="what-readfile-can-read">

1062 Ce que `readFile()` peut lire1065 Ce que `readFile()` peut lire


1067* Un fichier ordinaire situé dans l'un des répertoires de travail de la session, tels que `cwd` et `additionalDirectories`1070* Un fichier ordinaire situé dans l'un des répertoires de travail de la session, tels que `cwd` et `additionalDirectories`

1068* Quelques fichiers propres à Claude Code pour la session, tels que les résultats d'outils1071* Quelques fichiers propres à Claude Code pour la session, tels que les résultats d'outils

1069 1072 

1070Les règles de refus et de demande de `Read` bloquent toujours un chemin correspondant, et une règle d'autorisation `Read` large n'ouvre pas le reste du système de fichiers à `readFile()`. Pour tout autre fichier, l'appel se résout avec `null`.1073Les règles de refus et de demande `Read` bloquent toujours un chemin correspondant, et une règle d'autorisation `Read` large n'ouvre pas le reste du système de fichiers à `readFile()`. Pour tout autre fichier, l'appel se résout avec `null`.

1071 1074 

1072<h3 id="sdkcontrolreloadpluginsresponse">1075<h3 id="sdkcontrolreloadpluginsresponse">

1073 `SDKControlReloadPluginsResponse`1076 `SDKControlReloadPluginsResponse`


1099Les champs de collection décrivent la session après l'appel :1102Les champs de collection décrivent la session après l'appel :

1100 1103 

1101* `commands`, `agents` et `mcpServers` : les commandes, les sous-agents et l'état des serveurs MCP de la session, sous les mêmes formes que celles renvoyées par `supportedCommands()`, `supportedAgents()` et `mcpServerStatus()`. `supportedAgents()` continue de renvoyer la liste capturée lors de l'initialisation ; lisez donc `agents` ici pour obtenir l'ensemble après un rechargement1104* `commands`, `agents` et `mcpServers` : les commandes, les sous-agents et l'état des serveurs MCP de la session, sous les mêmes formes que celles renvoyées par `supportedCommands()`, `supportedAgents()` et `mcpServerStatus()`. `supportedAgents()` continue de renvoyer la liste capturée lors de l'initialisation ; lisez donc `agents` ici pour obtenir l'ensemble après un rechargement

1102* `plugins` : chaque plugin chargé avec son `name` et son `path` d'installation. `version` reprend ce que déclare le manifeste du plugin et est contrôlé par l'auteur du plugin ; validez-le donc avant de vous y fier. Il est omis lorsque le manifeste n'en déclare aucun1105* `plugins` : chaque plugin chargé avec son `name` et son `path` d'installation. `version` reprend ce que déclare le manifeste du plugin et est contrôlé par l'auteur du plugin ; validez-le donc avant de vous y fier. Il est omis lorsque le manifeste n'en déclare aucune

1103* `error_count` : le nombre d'erreurs survenues lors du chargement des plugins1106* `error_count` : le nombre d'erreurs survenues lors du chargement des plugins

1104 1107 

1105Passez `{ holdOnCacheImpact: true }` à `reloadPlugins()` pour suspendre un rechargement qui invaliderait le cache de prompts de la conversation au lieu de l'appliquer. Claude Code effectue la vérification que la commande interactive `/reload-plugins` réalise avant d'[avertir du coût pour le cache](/docs/fr/prompt-caching#enabling-or-disabling-a-plugin). Cette option nécessite l'Agent SDK v0.3.268 ou ultérieure. Un exécutable Claude Code antérieur à la v2.1.268, tel que celui vers lequel vous pointez `pathToClaudeCodeExecutable`, ignore cette option et applique le rechargement.1108Passez `{ holdOnCacheImpact: true }` à `reloadPlugins()` pour suspendre un rechargement qui invaliderait le cache de prompts de la conversation au lieu de l'appliquer. Claude Code effectue la vérification que réalise la commande interactive `/reload-plugins` avant d'[avertir du coût pour le cache](/docs/fr/prompt-caching#enabling-or-disabling-a-plugin). L'option nécessite Agent SDK v0.3.268 ou ultérieure. Un exécutable Claude Code antérieur à v2.1.268, comme celui vers lequel vous faites pointer `pathToClaudeCodeExecutable`, ignore l'option et applique le rechargement.

1106 1109 

1107Lorsque vous passez cette option, lisez `held` pour savoir ce qui s'est passé :1110Lorsque vous passez l'option, lisez `held` pour savoir ce qui s'est passé :

1108 1111 

1109* `true` : le rechargement n'a pas été appliqué, et les champs de collection décrivent la session dans son état actuel. `cache_impact` indique ce que l'application modifierait. Pour l'appliquer malgré tout, appelez de nouveau `reloadPlugins()` sans l'option.1112* `true` : le rechargement n'a pas été appliqué, et les champs de collection décrivent la session telle qu'elle est toujours. `cache_impact` indique ce que l'application changerait. Pour appliquer malgré tout, appelez de nouveau `reloadPlugins()` sans l'option.

1110* `false` : la vérification n'a détecté aucun impact sur le cache, et le rechargement a été appliqué.1113* `false` : la vérification n'a trouvé aucun impact sur le cache, et le rechargement a été appliqué.

1111* Absent : vous n'avez pas passé l'option, ou l'exécutable Claude Code est antérieur à la v2.1.268 et a appliqué le rechargement.1114* Absent : vous n'avez pas passé l'option, ou l'exécutable Claude Code est antérieur à v2.1.268 et a appliqué le rechargement.

1112 1115 

1113`cache_impact` n'est présent qu'avec `held: true`. `mcp_servers_added` et `mcp_servers_removed` nomment les serveurs MCP de plugins que le rechargement enregistrerait ou supprimerait, sous forme de noms délimités `plugin:<plugin>:<server>`. Ces noms sont définis par les auteurs des plugins ; validez-les donc avant de les afficher. `lsp_tool_change` indique si l'application ajouterait ou retirerait l'outil LSP, ou vaut `null` lorsqu'elle ne ferait ni l'un ni l'autre. Les formes `may-` signifient que la vérification n'a pas pu voir entièrement l'ensemble des plugins en attente.1116`cache_impact` n'est présent qu'avec `held: true`. `mcp_servers_added` et `mcp_servers_removed` nomment les serveurs MCP de plugins que le rechargement enregistrerait ou supprimerait, sous forme de noms à portée `plugin:<plugin>:<server>`. Les noms sont définis par les auteurs des plugins ; validez-les donc avant de les afficher. `lsp_tool_change` indique si l'application ajouterait ou retirerait l'outil LSP, ou vaut `null` si elle ne ferait ni l'un ni l'autre. Les formes `may-` signifient que la vérification n'a pas pu voir entièrement l'ensemble des plugins en attente.

1114 1117 

1115<h3 id="sdkcontrolreloadskillsresponse">1118<h3 id="sdkcontrolreloadskillsresponse">

1116 `SDKControlReloadSkillsResponse`1119 `SDKControlReloadSkillsResponse`


1144 `SDKControlMcpReadResourceResponse`1147 `SDKControlMcpReadResourceResponse`

1145</h3>1148</h3>

1146 1149 

1147Type de retour de [`readMcpResource()`](#query-object), contenant le résultat `resources/read` du serveur MCP. Nécessite l'Agent SDK TypeScript v0.3.280 ou ultérieure.1150Type de retour de [`readMcpResource()`](#query-object), contenant le résultat `resources/read` du serveur MCP. Nécessite TypeScript Agent SDK v0.3.280 ou ultérieure.

1148 1151 

1149```typescript theme={null}1152```typescript theme={null}

1150type SDKControlMcpReadResourceResponse = {1153type SDKControlMcpReadResourceResponse = {


1158};1161};

1159```1162```

1160 1163 

1161Passez à `readMcpResource()` le nom du serveur tel que `mcpServerStatus()` le rapporte ainsi qu'une URI `ui://`, comme le `ui.resourceUri` qu'un outil déclare dans son [`_meta`](#mcpserverstatus). L'appel est rejeté pour tout autre schéma d'URI, pour un [serveur MCP SDK](#createsdkmcpserver) que votre application héberge elle-même, et pour un serveur qui n'est pas connecté. Il est disponible lorsque les [`capabilities`](#sdksystemmessage) du message d'initialisation incluent `mcp_read_resource_v1`.1164Passez à `readMcpResource()` le nom du serveur tel que le signale `mcpServerStatus()` et un URI `ui://`, comme le `ui.resourceUri` qu'un outil déclare dans son [`_meta`](#mcpserverstatus). L'appel est rejeté pour tout autre schéma d'URI, pour un [serveur MCP SDK](#createsdkmcpserver) que votre application héberge elle-même, et pour un serveur qui n'est pas connecté. Il est disponible lorsque les [`capabilities`](#sdksystemmessage) du message d'initialisation incluent `mcp_read_resource_v1`.

1162 1165 

1163Chaque entrée de `contents` est un élément de contenu tel que le serveur l'a envoyé, à l'exception de toute clé `_meta` sous le préfixe `com.anthropic/`, réservé à Claude Code. `blob` contient des données base64 pour un élément binaire, et `_meta` est le `_meta` propre à l'élément, où un serveur MCP Apps place les `ui.csp` et `ui.permissions` de la ressource.1166Chaque entrée de `contents` est un élément de contenu tel que le serveur l'a envoyé, sans les clés `_meta` sous le préfixe `com.anthropic/`, qui est réservé à Claude Code. `blob` contient des données base64 pour un élément binaire, et `_meta` est le `_meta` propre à l'élément, où un serveur MCP Apps place les `ui.csp` et `ui.permissions` de la ressource.

1164 1167 

1165Le contenu est du HTML tiers non fiable ; affichez-le donc dans un sandbox.1168Le contenu est du HTML tiers non fiable ; affichez-le donc dans un sandbox.

1166 1169 


1190};1193};

1191```1194```

1192 1195 

1193| Champ | Obligatoire | Description |1196| Champ | Requis | Description |

1194| :- | :- | :- |1197| :- | :- | :- |

1195| `description` | Oui | Description en langage naturel indiquant quand utiliser cet agent |1198| `description` | Oui | Description en langage naturel indiquant quand utiliser cet agent |

1196| `tools` | Non | Tableau des noms d'outils autorisés. S'il est omis, hérite de tous les [outils disponibles pour les sous-agents](/docs/fr/sub-agents#available-tools). Pour précharger des skills dans le contexte de l'agent, utilisez le champ `skills` plutôt que de lister `'Skill'` ici |1199| `tools` | Non | Tableau des noms d'outils autorisés. S'il est omis, hérite de tous les [outils disponibles pour les sous-agents](/docs/fr/sub-agents#available-tools). Pour précharger des skills dans le contexte de l'agent, utilisez le champ `skills` plutôt que de lister `'Skill'` ici |

1197| `disallowedTools` | Non | Tableau des noms d'outils à interdire explicitement pour cet agent. Les motifs au niveau du serveur MCP sont également acceptés : `mcp__server` ou `mcp__server__*` retire tous les outils de ce serveur, et `mcp__*` retire tous les outils MCP de tous les serveurs |1200| `disallowedTools` | Non | Tableau des noms d'outils à interdire explicitement pour cet agent. Les motifs au niveau du serveur MCP sont également acceptés : `mcp__server` ou `mcp__server__*` retire tous les outils de ce serveur, et `mcp__*` retire tous les outils MCP de n'importe quel serveur |

1198| `prompt` | Oui | Le prompt système de l'agent |1201| `prompt` | Oui | Le prompt système de l'agent |

1199| `model` | Non | Remplacement du modèle pour cet agent. Accepte un alias tel que `'fable'`, `'opus'`, `'sonnet'`, `'haiku'`, `'inherit'`, ou un identifiant de modèle complet. `'inherit'` utilise le modèle principal. Si vous l'omettez, Claude Code choisit le modèle selon l'[ordre des modèles des sous-agents](/docs/fr/sub-agents#choose-a-model) |1202| `model` | Non | Remplacement du modèle pour cet agent. Accepte un alias tel que `'fable'`, `'opus'`, `'sonnet'`, `'haiku'`, `'inherit'`, ou un ID de modèle complet. `'inherit'` utilise le modèle principal. Si vous l'omettez, Claude Code choisit le modèle selon l'[ordre des modèles des sous-agents](/docs/fr/sub-agents#choose-a-model) |

1200| `mcpServers` | Non | Spécifications des serveurs MCP pour cet agent |1203| `mcpServers` | Non | Spécifications des serveurs MCP pour cet agent |

1201| `skills` | Non | Tableau des noms de skills à précharger dans le contexte de l'agent |1204| `skills` | Non | Tableau des noms de skills à précharger dans le contexte de l'agent |

1202| `initialPrompt` | Non | Soumis automatiquement comme premier tour utilisateur lorsque cet agent s'exécute en tant qu'agent du thread principal |1205| `initialPrompt` | Non | Soumis automatiquement comme premier tour utilisateur lorsque cet agent s'exécute en tant qu'agent du thread principal |

1203| `maxTurns` | Non | Nombre maximal de tours agentiques (allers-retours d'API) avant l'arrêt |1206| `maxTurns` | Non | Nombre maximal de tours agentiques (allers-retours API) avant l'arrêt |

1204| `background` | Non | Exécuter cet agent en tant que tâche en arrière-plan non bloquante lorsqu'il est invoqué |1207| `background` | Non | Exécuter cet agent comme tâche en arrière-plan non bloquante lorsqu'il est invoqué |

1205| `omitClaudeMd` | Non | Exécuter cet agent sans les fichiers CLAUDE.md utilisateur, projet et locaux lorsqu'il s'exécute en tant que sous-agent ; les fichiers de stratégie gérée sont toujours chargés. Utilisez-le pour les agents qui tirent tout ce dont ils ont besoin du prompt de l'outil Agent. Ignoré lorsque cet agent s'exécute en tant qu'agent du thread principal. Nécessite l'Agent SDK TypeScript v0.3.271 ou ultérieure |1208| `omitClaudeMd` | Non | Exécuter cet agent sans les fichiers CLAUDE.md utilisateur, projet et locaux lorsqu'il s'exécute en tant que sous-agent ; les fichiers de stratégie gérée sont toujours chargés. Utilisez-le pour les agents qui tirent tout ce dont ils ont besoin du prompt de l'outil Agent. Ignoré lorsque cet agent s'exécute en tant qu'agent du thread principal. Nécessite TypeScript Agent SDK v0.3.271 ou ultérieure |

1206| `memory` | Non | Source de mémoire pour cet agent : `'user'`, `'project'` ou `'local'` |1209| `memory` | Non | Source de mémoire pour cet agent : `'user'`, `'project'` ou `'local'` |

1207| `effort` | Non | Niveau d'effort de raisonnement pour cet agent. Accepte un niveau nommé ou un entier |1210| `effort` | Non | Niveau d'effort de raisonnement pour cet agent. Accepte un niveau nommé ou un entier |

1208| `permissionMode` | Non | Mode de permission pour l'exécution des outils au sein de cet agent. Les [règles d'héritage des sous-agents](/docs/fr/agent-sdk/permissions#available-modes) déterminent quand il s'applique. Consultez [`PermissionMode`](#permissionmode) |1211| `permissionMode` | Non | Mode de permission pour l'exécution des outils au sein de cet agent. Les [règles d'héritage des sous-agents](/docs/fr/agent-sdk/permissions#available-modes) déterminent quand il s'applique. Consultez [`PermissionMode`](#permissionmode) |


1212 `AgentMcpServerSpec`1215 `AgentMcpServerSpec`

1213</h3>1216</h3>

1214 1217 

1215Spécifie les serveurs MCP disponibles pour un sous-agent. Il peut s'agir d'un nom de serveur (chaîne faisant référence à un serveur de la configuration `mcpServers` du parent) ou d'un enregistrement de configuration de serveur inline associant des noms de serveurs à des configurations.1218Spécifie les serveurs MCP disponibles pour un sous-agent. Peut être un nom de serveur (chaîne référençant un serveur de la configuration `mcpServers` du parent) ou un enregistrement de configuration de serveur en ligne associant des noms de serveurs à des configurations.

1216 1219 

1217```typescript theme={null}1220```typescript theme={null}

1218type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;1221type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;

1219```1222```

1220 1223 

1221Où `McpServerConfigForProcessTransport` correspond à `McpStdioServerConfig | McpSSEServerConfig | McpHttpServerConfig | McpSdkServerConfig`.1224Où `McpServerConfigForProcessTransport` est `McpStdioServerConfig | McpSSEServerConfig | McpHttpServerConfig | McpSdkServerConfig`.

1222 1225 

1223<h3 id="settingsource">1226<h3 id="settingsource">

1224 `SettingSource`1227 `SettingSource`


1278 Priorité des paramètres1281 Priorité des paramètres

1279</h4>1282</h4>

1280 1283 

1281Lorsque plusieurs sources sont chargées, les paramètres sont fusionnés selon cet ordre de priorité (de la plus élevée à la plus basse) :1284Lorsque plusieurs sources sont chargées, les paramètres sont fusionnés selon cet ordre de priorité (de la plus haute à la plus basse) :

1282 1285 

12831. Paramètres locaux (`.claude/settings.local.json`)12861. Paramètres locaux (`.claude/settings.local.json`)

12842. Paramètres de projet (`.claude/settings.json`)12872. Paramètres de projet (`.claude/settings.json`)

12853. Paramètres utilisateur (`~/.claude/settings.json`)12883. Paramètres utilisateur (`~/.claude/settings.json`)

1286 1289 

1287Les options programmatiques telles que `agents`, `allowedTools` et `settings` remplacent les paramètres utilisateur, de projet et locaux du système de fichiers. Les paramètres de politique gérés ont priorité sur les options programmatiques.1290Les options programmatiques telles que `agents`, `allowedTools` et `settings` remplacent les paramètres utilisateur, projet et locaux du système de fichiers. Les paramètres de politique gérés ont priorité sur les options programmatiques.

1288 1291 

1289<h3 id="permissionmode">1292<h3 id="permissionmode">

1290 `PermissionMode`1293 `PermissionMode`


1306 1309 

1307Type de fonction de permission personnalisée pour contrôler l'utilisation des outils.1310Type de fonction de permission personnalisée pour contrôler l'utilisation des outils.

1308 1311 

1309Cette fonction remplace, dans le SDK, la demande de permission interactive : elle n'est invoquée que lorsque le [flux d'évaluation des permissions](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) aboutit à une demande. Les appels d'outils déjà approuvés par une entrée `allowedTools`, une règle d'autorisation des paramètres ou le mode de permission, comme `acceptEdits` ou `bypassPermissions`, ne l'invoquent jamais. Pour contrôler chaque appel d'outil, utilisez plutôt un [hook `PreToolUse`](/docs/fr/agent-sdk/hooks).1312La fonction est le remplacement, dans le SDK, de la demande de permission interactive : elle n'est invoquée que lorsque le [flux d'évaluation des permissions](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) aboutit à une demande. Les appels d'outils déjà approuvés par une entrée `allowedTools`, une règle d'autorisation des paramètres ou le mode de permission, comme `acceptEdits` ou `bypassPermissions`, ne l'invoquent jamais. Pour contrôler chaque appel d'outil, utilisez plutôt un [hook `PreToolUse`](/docs/fr/agent-sdk/hooks).

1310 1313 

1311Une règle d'autorisation ne pré-approuve pas les [actions qu'aucun mode n'approuve automatiquement](/docs/fr/permission-modes#actions-no-mode-auto-approves) ; consultez [Comment les permissions sont évaluées](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) pour savoir lesquelles atteignent le callback et ce qui se passe en mode `dontAsk` et `auto`.1314Une règle d'autorisation ne pré-approuve pas les [actions qu'aucun mode n'approuve automatiquement](/docs/fr/permission-modes#actions-no-mode-auto-approves) ; consultez [Comment les permissions sont évaluées](/docs/fr/agent-sdk/permissions#how-permissions-are-evaluated) pour savoir lesquelles atteignent le callback et ce qui se passe en mode `dontAsk` et `auto`.

1312 1315 


1331 1334 

1332| Option | Type | Description |1335| Option | Type | Description |

1333| :- | :- | :- |1336| :- | :- | :- |

1334| `signal` | `AbortSignal` | Signalé si l'opération doit être interrompue |1337| `signal` | `AbortSignal` | Signalé si l'opération doit être abandonnée |

1335| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | Mises à jour de permissions suggérées afin que l'utilisateur ne soit plus sollicité pour cet outil. Les demandes Bash incluent une suggestion avec la [destination](#permissionupdatedestination) `localSettings`, de sorte que la renvoyer dans `updatedPermissions` écrit la règle dans `.claude/settings.local.json` et la conserve d'une session à l'autre. |1338| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | Mises à jour de permissions suggérées afin que l'utilisateur ne soit plus sollicité pour cet outil. Les demandes Bash incluent une suggestion avec la [destination](#permissionupdatedestination) `localSettings`, de sorte que la renvoyer dans `updatedPermissions` écrit la règle dans `.claude/settings.local.json` et la conserve d'une session à l'autre. |

1336| `blockedPath` | `string` | Le chemin de fichier qui a déclenché la demande de permission, le cas échéant |1339| `blockedPath` | `string` | Le chemin de fichier qui a déclenché la demande de permission, le cas échéant |

1337| `mcpServer` | `{ name: string; source: string }` | Pour un outil `mcp__*`, le serveur MCP qui le fournit et l'origine de la définition de ce serveur, avec les champs de [`McpServerProvenance`](#mcpserverprovenance). Absent pour les autres outils. Nécessite Agent SDK v0.3.274 ou ultérieur |1340| `mcpServer` | `{ name: string; source: string }` | Pour un outil `mcp__*`, le serveur MCP qui le fournit et l'origine de la définition de ce serveur, avec les champs de [`McpServerProvenance`](#mcpserverprovenance). Absent pour les autres outils. Nécessite Agent SDK v0.3.274 ou ultérieur |

1338| `decisionReason` | `string` | Explique pourquoi cette demande de permission a été déclenchée |1341| `decisionReason` | `string` | Explique pourquoi cette demande de permission a été déclenchée |

1339| `defaultToNo` | `boolean` | Lorsque `true`, une seule frappe accidentelle ne doit pas approuver cette demande : ouvrez votre demande sur son option de refus, ne présélectionnez pas l'approbation et ne proposez aucun raccourci d'approbation à une touche. Nécessite Agent SDK v0.3.268 ou ultérieur |1342| `defaultToNo` | `boolean` | Lorsque `true`, une seule frappe accidentelle ne doit pas approuver cette demande : ouvrez votre demande sur son option de refus, ne présélectionnez pas l'approbation et ne proposez aucun raccourci d'approbation à une touche. Nécessite Agent SDK v0.3.268 ou ultérieur |

1340| `suppressAlwaysAllowRule` | `boolean` | Lorsque `true`, ne proposez pas de choix persistant « toujours autoriser » pour cette demande, car la règle qu'il écrirait accorderait davantage que l'action propre à la demande. Nécessite Agent SDK v0.3.268 ou ultérieur |1343| `suppressAlwaysAllowRule` | `boolean` | Lorsque `true`, ne proposez pas de choix d'autorisation permanente pour cette demande. Nécessite Agent SDK v0.3.268 ou ultérieur |

1341| `toolUseID` | `string` | Identifiant unique de cet appel d'outil spécifique dans le message de l'assistant |1344| `toolUseID` | `string` | Identifiant unique de cet appel d'outil spécifique au sein du message de l'assistant |

1342| `agentID` | `string` | Si l'exécution a lieu dans un sous-agent, l'ID du sous-agent |1345| `agentID` | `string` | En cas d'exécution au sein d'un sous-agent, l'ID du sous-agent |

1343| `requestId` | `string` | Le `request_id` de l'enveloppe `control_request`. Une `control_response` que votre application envoie en dehors du SDK, comme un HTTP POST signé, doit renvoyer cette valeur afin que le processus Claude Code puisse associer la réponse à la requête |1346| `requestId` | `string` | Le `request_id` de l'enveloppe `control_request`. Une `control_response` que votre application envoie en dehors du SDK, comme un HTTP POST signé, doit reprendre cette valeur afin que le processus Claude Code puisse faire correspondre la réponse à la requête |

1344 1347 

1345Le callback résout normalement la requête en renvoyant un [`PermissionResult`](#permissionresult), que le SDK réécrit via son transport sous forme de `control_response`. Ne renvoyez `null` que lorsque votre application a déjà envoyé la `control_response` pour cette requête via son propre canal, en renvoyant `requestId` ; le SDK ignore alors l'écriture de la réponse sur son transport. Renvoyer `null` dans tout autre cas laisse l'appel d'outil bloqué indéfiniment, car aucune `control_response` n'est jamais envoyée et les demandes de permission n'expirent pas.1348Le callback résout normalement la requête en renvoyant un [`PermissionResult`](#permissionresult), que le SDK réécrit sur son transport en tant que `control_response`. Renvoyez `null` uniquement lorsque votre application a déjà envoyé la `control_response` pour cette requête via son propre canal, en reprenant `requestId` ; le SDK ignore alors l'écriture de la réponse sur son transport. Renvoyer `null` dans tout autre cas bloque indéfiniment l'appel d'outil, car aucune `control_response` n'est jamais envoyée et les demandes de permission n'expirent pas.

1346 1349 

1347L'option `requestId` et la valeur de retour `null` nécessitent Claude Code v2.1.199 ou ultérieur.1350L'option `requestId` et la valeur de retour `null` nécessitent Claude Code v2.1.199 ou ultérieur.

1348 1351 


3790};3793};

3791```3794```

3792 3795 

3793Signale les résultats de révision de code sous forme de liste structurée pour que Claude Code puisse les rendre au lieu de les imprimer en tant que texte. `level` est le niveau d'effort auquel la révision s'est exécutée. Les résultats sont ordonnés du plus grave au moins grave, avec au maximum 32 par appel, et le tableau est vide lorsqu'aucun n'a survécu. Nécessite Claude Code v2.1.196 ou version ultérieure.3796Signale les résultats de revue de code sous forme de liste structurée pour que Claude Code puisse les rendre au lieu de les imprimer en tant que texte. Les résultats sont ordonnés du plus grave au moins grave, avec au maximum 32 par appel, et le tableau est vide lorsqu'aucun n'a survécu. Nécessite Claude Code v2.1.196 ou version ultérieure.

3797 

3798`level` est optionnel et contient le niveau d'effort que Claude indique pour la revue. Claude Code ne le compare pas au niveau auquel la revue s'est exécutée, les deux peuvent donc différer.

3794 3799 

3795Chaque résultat porte ces champs :3800Chaque résultat porte ces champs :

3796 3801 


4840};4845};

4841```4846```

4842 4847 

4843Retourne le nombre de résultats signalés, le niveau d'effort auquel l'examen s'est exécuté, et les résultats renvoyés pour le corps du résultat. Nécessite Claude Code v2.1.196 ou ultérieur. Le champ `short_summary` renvoyé nécessite Claude Code v2.1.212 ou ultérieur.4848Retourne le nombre de résultats signalés, la valeur `level` transmise par Claude, et les résultats renvoyés pour le corps du résultat. Nécessite Claude Code v2.1.196 ou ultérieur. Le champ `short_summary` renvoyé nécessite Claude Code v2.1.212 ou ultérieur.

4844 4849 

4845<h3 id="artifact-2">4850<h3 id="artifact-2">

4846 Artifact4851 Artifact


5461 | { type: "disabled" }; // No extended thinking5466 | { type: "disabled" }; // No extended thinking

5462```5467```

5463 5468 

5464Le champ optionnel `display` contrôle si le texte de réflexion est renvoyé `"summarized"` ou `"omitted"`. Sur Claude Opus 4.7 et versions ultérieures, la valeur par défaut de l'API est `"omitted"`, donc définissez `"summarized"` pour recevoir le contenu de réflexion dans les blocs `thinking`. Claude Code n'envoie pas `display` à Amazon Bedrock ou à la plateforme Agent de Google Cloud, donc sur ces fournisseurs Opus 4.7 et versions ultérieures renvoient des blocs `thinking` vides même lorsque vous définissez `display` sur `"summarized"`.5469Le champ optionnel `display` contrôle si le texte de réflexion est renvoyé `"summarized"` ou `"omitted"`. Sur Claude Opus 4.7 et versions ultérieures, la valeur par défaut de l'API est `"omitted"`, donc définissez `"summarized"` pour recevoir le contenu de réflexion dans les blocs `thinking`. Claude Code ne transmet pas votre valeur `display` à certains fournisseurs, tels qu'Amazon Bedrock et la plateforme Agent de Google Cloud. Sur ces fournisseurs, Opus 4.7 et versions ultérieures renvoient des blocs `thinking` vides même lorsque vous définissez `display` sur `"summarized"`.

5465 5470 

5466<h3 id="spawnedprocess">5471<h3 id="spawnedprocess">

5467 `SpawnedProcess`5472 `SpawnedProcess`


5532 5537 

5533Lorsque vous appelez `setMcpServers()`, Claude Code applique ces règles :5538Lorsque vous appelez `setMcpServers()`, Claude Code applique ces règles :

5534 5539 

5535* **Serveurs que l'appel ne nomme pas** : Claude Code maintient les serveurs fournis par plugin en cours d'exécution. Nécessite Agent SDK v0.3.210 ou version ultérieure.5540* **Serveurs que l'appel ne nomme pas** : en dehors d'une [session cloud](/docs/fr/claude-code-on-the-web), Claude Code déconnecte les serveurs qu'un appel `setMcpServers()` antérieur a ajoutés ainsi que les serveurs SDK en processus, et les liste dans `removed`. Les autres serveurs continuent de s'exécuter et ne sont pas listés dans `removed`, parmi lesquels les serveurs stdio, HTTP et SSE de l'option [`mcpServers`](#options), les serveurs des fichiers de paramètres et les serveurs fournis par plugin.

5536* **Serveurs que l'appel nomme** : à l'exception des serveurs intégrés que l'interface de ligne de commande a démarrés au démarrage, Claude Code remplace un serveur en cours d'exécution uniquement lorsque sa configuration diffère de celle que vous avez transmise.5541* **Serveurs que l'appel nomme** : Claude Code remplace un serveur stdio, HTTP ou SSE qu'un appel `setMcpServers()` antérieur a ajouté uniquement lorsque sa configuration diffère de celle que vous avez transmise. Un serveur SDK en processus déjà enregistré sous ce nom reste tel quel ; pour en remplacer un, omettez-le d'un appel et ajoutez-le dans le suivant.

5537* **Serveurs intégrés que l'interface de ligne de commande a démarrés au démarrage** : si l'appel en nomme un, Claude Code supprime cette entrée et la signale dans `errors`.5542* **Serveurs intégrés que l'interface de ligne de commande a démarrés au démarrage** : si l'appel en nomme un, Claude Code supprime cette entrée et la signale dans `errors`.

5538 5543 

5539La promesse se résout après que les serveurs stdio, HTTP et SSE nouvellement ajoutés se connectent ou échouent, donc les outils des serveurs qui se sont connectés sont disponibles au tour suivant.5544La promesse se résout après que les serveurs stdio, HTTP et SSE nouvellement ajoutés se connectent ou échouent, donc les outils des serveurs qui se sont connectés sont disponibles au tour suivant.


5853 tasks: {5858 tasks: {

5854 task_id: string;5859 task_id: string;

5855 task_type: string;5860 task_type: string;

5861 subagent_type?: string;

5856 description: string;5862 description: string;

5857 ambient?: boolean;5863 ambient?: boolean;

5858 }[];5864 }[];


5861};5867};

5862```5868```

5863 5869 

5870`subagent_type` nomme le type de sous-agent sur les entrées dont le [`task_type`](#sdktaskstartedmessage) est `"local_agent"`, tel que `general-purpose` ou le nom d'un sous-agent personnalisé. Le champ nécessite Agent SDK v0.3.293 ou version ultérieure.

5871 

5864<h3 id="sdkthinkingtokensmessage">5872<h3 id="sdkthinkingtokensmessage">

5865 `SDKThinkingTokensMessage`5873 `SDKThinkingTokensMessage`

5866</h3>5874</h3>

agent-view.md +1 −0

Details

819| `claude rm <id> --discard-unpushed <commit>@<worktree-id>` | Supprimer une session dont la suppression a été refusée en raison de commits non poussés, en supprimant la worktree ainsi que sa branche et ses commits. Passez la valeur exacte que le refus a affichée ; voir [Ce que la suppression d'une session supprime](#what-deleting-a-session-removes). Nécessite v2.1.260 ou ultérieur |819| `claude rm <id> --discard-unpushed <commit>@<worktree-id>` | Supprimer une session dont la suppression a été refusée en raison de commits non poussés, en supprimant la worktree ainsi que sa branche et ses commits. Passez la valeur exacte que le refus a affichée ; voir [Ce que la suppression d'une session supprime](#what-deleting-a-session-removes). Nécessite v2.1.260 ou ultérieur |

820| `claude rm <id> --force-remove-worktree <worktree-id>` | Supprimer une session dont la suppression a été refusée parce que git ou le hook `WorktreeRemove` n'a pas pu supprimer sa worktree, en supprimant le répertoire worktree de toute façon et en laissant sa branche dans le dépôt. Passez la valeur exacte que le refus a affichée ; voir [Ce que la suppression d'une session supprime](#what-deleting-a-session-removes). Nécessite v2.1.268 ou ultérieur |820| `claude rm <id> --force-remove-worktree <worktree-id>` | Supprimer une session dont la suppression a été refusée parce que git ou le hook `WorktreeRemove` n'a pas pu supprimer sa worktree, en supprimant le répertoire worktree de toute façon et en laissant sa branche dans le dépôt. Passez la valeur exacte que le refus a affichée ; voir [Ce que la suppression d'une session supprime](#what-deleting-a-session-removes). Nécessite v2.1.268 ou ultérieur |

821| `claude daemon status` | Afficher l'état du [superviseur](#the-supervisor-process), la version, le répertoire socket et le nombre de workers |821| `claude daemon status` | Afficher l'état du [superviseur](#the-supervisor-process), la version, le répertoire socket et le nombre de workers |

822| `claude daemon logs` | Suivre le fichier de log du superviseur, [`~/.claude/daemon.log`](#where-state-is-stored), en affichant les nouvelles lignes à mesure qu'elles arrivent jusqu'à ce que vous appuyiez sur `Ctrl+C` |

822| `claude daemon stop --any` | Arrêter le processus superviseur et les sessions en arrière-plan qu'il héberge. Passez `--keep-workers` pour laisser les sessions en arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. Le prochain `claude agents` ou `claude --bg` démarre un nouveau superviseur |823| `claude daemon stop --any` | Arrêter le processus superviseur et les sessions en arrière-plan qu'il héberge. Passez `--keep-workers` pour laisser les sessions en arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. Le prochain `claude agents` ou `claude --bg` démarre un nouveau superviseur |

823 824 

824`claude attach` et `claude logs` peuvent prendre une partie du nom d'une session en cours d'exécution à la place de l'ID, comme dans `claude logs "auth refactor"`. Passer un nom nécessite Claude Code v2.1.290 ou ultérieur.825`claude attach` et `claude logs` peuvent prendre une partie du nom d'une session en cours d'exécution à la place de l'ID, comme dans `claude logs "auth refactor"`. Passer un nom nécessite Claude Code v2.1.290 ou ultérieur.

agents.md +1 −1

Details

20 20 

21Trois autres outils soutiennent ce travail sans être une façon d'exécuter des agents eux-mêmes :21Trois autres outils soutiennent ce travail sans être une façon d'exécuter des agents eux-mêmes :

22 22 

23* [Les worktrees](/docs/fr/worktrees) donnent à chaque session un checkout git séparé, de sorte que les sessions parallèles ne modifient jamais les mêmes fichiers. Utilisez-les pour les sessions que vous exécutez vous-même. Une session que vous dispatchez depuis la vue agent [se déplace dans son propre worktree avant qu'elle ne modifie les fichiers](/docs/fr/agent-view#how-file-edits-are-isolated), et les sous-agents que vous générez peuvent chacun en obtenir un aussi.23* [Les worktrees](/docs/fr/worktrees) donnent à chaque session un checkout git séparé, de sorte que les sessions parallèles modifient chacune leur propre copie des fichiers. Utilisez-les pour les sessions que vous exécutez vous-même. Une session que vous dispatchez depuis la vue agent [se déplace dans son propre worktree avant qu'elle ne modifie les fichiers](/docs/fr/agent-view#how-file-edits-are-isolated), et les sous-agents que vous générez peuvent chacun en obtenir un aussi.

24* [La messagerie inter-sessions](/docs/fr/cross-session-messaging) permet à Claude de lister et de communiquer avec vos autres sessions Claude Code sur cette machine, sur une autre machine ou [dans le cloud](/docs/fr/claude-code-on-the-web), de sorte que les sessions que vous exécutez vous-même peuvent transmettre les résultats et l'état entre elles.24* [La messagerie inter-sessions](/docs/fr/cross-session-messaging) permet à Claude de lister et de communiquer avec vos autres sessions Claude Code sur cette machine, sur une autre machine ou [dans le cloud](/docs/fr/claude-code-on-the-web), de sorte que les sessions que vous exécutez vous-même peuvent transmettre les résultats et l'état entre elles.

25* [`/batch`](/docs/fr/commands) est une [compétence](/docs/fr/skills) qui a Claude diviser un grand changement en 5 à 30 sous-agents isolés par worktree. C'est une utilisation packagée de sous-agents et de worktrees, pas un style de coordination séparé.25* [`/batch`](/docs/fr/commands) est une [compétence](/docs/fr/skills) qui a Claude diviser un grand changement en 5 à 30 sous-agents isolés par worktree. C'est une utilisation packagée de sous-agents et de worktrees, pas un style de coordination séparé.

26 26 

Details

188 188 

189Le cache couvre chaque option d'identifiant ci-dessus sauf une clé API Amazon Bedrock, qui n'utilise pas la chaîne du fournisseur. Pour résoudre la chaîne à chaque demande à la place, définissez [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/docs/fr/env-vars).189Le cache couvre chaque option d'identifiant ci-dessus sauf une clé API Amazon Bedrock, qui n'utilise pas la chaîne du fournisseur. Pour résoudre la chaîne à chaque demande à la place, définissez [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/docs/fr/env-vars).

190 190 

191Chaque résolution de la chaîne expire après 60 secondes. Si une étape de la chaîne s'arrête, par exemple un assistant `credential_process` qui attend une entrée qu'il ne peut pas recevoir, la demande échoue avec [`AWS default-chain credential resolve timed out`](/docs/fr/errors#aws-default-chain-credential-resolve-timed-out). Si votre chaîne exécute une connexion interactive qui a légitimement besoin de plus de temps, comme SSO basé sur navigateur 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). Avant v2.1.207, une résolution d'identifiant bloquée laissait la demande en attente indéfiniment.191La résolution qui remplit le cache expire après 60 secondes. Si une étape de la chaîne s'arrête, par exemple un assistant `credential_process` qui attend une entrée qu'il ne peut pas recevoir, la requête échoue avec [`AWS default-chain credential resolve timed out`](/docs/fr/errors#aws-default-chain-credential-resolve-timed-out). Si votre chaîne exécute une connexion interactive qui a légitimement besoin de plus de temps, comme SSO basé sur navigateur 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). Lorsque `CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1` est défini, chaque requête API résout la chaîne sans cette limite.

192 192 

193Sauf quand vous vous authentifiez avec une clé API Amazon Bedrock, l'[assistant de configuration](#sign-in-with-bedrock) applique la même limite à chaque appel AWS qu'il effectue lors de la vérification de vos identifiants, et à la recherche d'identifiants avant chaque vérification de modèle. Lors de la vérification des identifiants, une vérification qui dépasse la limite échoue avec [`Timed out after 60s waiting for AWS`](/docs/fr/errors#bedrock-setup-verification-timed-out-waiting-for-aws).193Sauf quand vous vous authentifiez avec une clé API Amazon Bedrock, l'[assistant de configuration](#sign-in-with-bedrock) applique la même limite à chaque appel AWS qu'il effectue lors de la vérification de vos identifiants, et à la recherche d'identifiants avant chaque vérification de modèle. Lors de la vérification des identifiants, une vérification qui dépasse la limite échoue avec [`Timed out after 60s waiting for AWS`](/docs/fr/errors#bedrock-setup-verification-timed-out-waiting-for-aws).

194 194 


681 681 

682Amazon Bedrock diffuse les réponses `InvokeModelWithResponseStream` dans un format d'événement binaire event-stream avec l'en-tête `Content-Type: application/vnd.amazon.eventstream`. Une passerelle ou un proxy entre Claude Code et Amazon Bedrock doit transmettre le corps de la réponse et ses en-têtes, y compris `Content-Type`, tels qu'Amazon Bedrock les a envoyés.682Amazon Bedrock diffuse les réponses `InvokeModelWithResponseStream` dans un format d'événement binaire event-stream avec l'en-tête `Content-Type: application/vnd.amazon.eventstream`. Une passerelle ou un proxy entre Claude Code et Amazon Bedrock doit transmettre le corps de la réponse et ses en-têtes, y compris `Content-Type`, tels qu'Amazon Bedrock les a envoyés.

683 683 

684Si la passerelle réécrit `Content-Type` en une autre valeur, Claude Code rejette la réponse avec une erreur qui commence par `Bedrock streaming response has content-type`, en nommant la valeur qu'il a reçue. La réécriture courante est `text/event-stream`, provenant d'une intégration qui réemet le flux sous forme d'événements envoyés par le serveur.684Si la passerelle réécrit `Content-Type` en une autre valeur, Claude Code rejette la réponse avec une erreur qui commence par `Bedrock streaming response has content-type`, en nommant la valeur qu'il a reçue. La réécriture courante est `text/event-stream`, provenant d'une intégration qui réémet le flux sous forme d'événements envoyés par le serveur. Pour la variable `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` que nomme le message d'erreur, consultez [Bedrock streaming response has an unexpected content-type](/docs/fr/errors#bedrock-streaming-response-has-an-unexpected-content-type).

685 685 

686Si la passerelle supprime ou efface l'en-tête à la place, Claude Code suppose que le corps est le flux d'événements d'Amazon Bedrock et le décode, donc un corps que la passerelle a transmis sans modification continue à diffuser.686Si la passerelle supprime ou efface l'en-tête à la place, Claude Code suppose que le corps est le flux d'événements d'Amazon Bedrock et le décode, donc un corps que la passerelle a transmis sans modification continue à diffuser.

687 687 

Details

12 Se connecter à Claude Code12 Se connecter à Claude Code

13</h2>13</h2>

14 14 

15Après [l'installation de Claude Code](/docs/fr/setup#install-claude-code), exécutez `claude` dans votre terminal. Au premier lancement, Claude Code ouvre une fenêtre de navigateur pour vous permettre de vous connecter. Si vous avez défini la variable d'environnement `ANTHROPIC_API_KEY`, Claude Code ignore l'invite de connexion et vous demande plutôt d'approuver la clé.15Après [l'installation de Claude Code](/docs/fr/setup#install-claude-code), exécutez `claude` dans votre terminal. Au premier lancement, Claude Code ouvre une fenêtre de navigateur pour vous permettre de vous connecter. Si vous avez défini la variable d'environnement `ANTHROPIC_API_KEY` et que vous approuvez la clé lorsque Claude Code vous demande s'il doit l'utiliser, Claude Code ignore l'invite de connexion.

16 16 

17Si le navigateur ne s'ouvre pas automatiquement, appuyez sur `c` pour copier l'URL de connexion dans votre presse-papiers, puis collez-la dans votre navigateur.17Si le navigateur ne s'ouvre pas automatiquement, appuyez sur `c` pour copier l'URL de connexion dans votre presse-papiers, puis collez-la dans votre navigateur.

18 18 

Details

351}351}

352```352```

353 353 

354Obtenez des commentaires d'IA sur vos règles personnalisées `allow`, `soft_deny` et `hard_deny` :354Obtenez des commentaires d'IA sur vos entrées personnalisées `allow`, `soft_deny`, `hard_deny` et `environment` :

355 355 

356```bash theme={null}356```bash theme={null}

357claude auto-mode critique357claude auto-mode critique

chrome.md +1 −1

Details

343 343 

344| Erreur | Cause | Solution |344| Erreur | Cause | Solution |

345| - | - | - |345| - | - | - |

346| « Browser extension is not connected » | L'hôte de messagerie native ne peut pas atteindre l'extension, ou la liste d'adresses IP autorisées de votre organisation rejette la connexion à `bridge.claudeusercontent.com` | Redémarrez Chrome et Claude Code, puis exécutez `/chrome` pour reconnecter. Si votre organisation utilise une liste d'adresses IP autorisées et que l'erreur persiste, consultez [Listes d'adresses IP autorisées et sortie proxy de l'organisation](/docs/fr/network-config#organization-ip-allowlists-and-proxy-egress) |346| « Browser extension is not connected » | L'hôte de messagerie native ne peut pas atteindre l'extension, ou la liste d'adresses IP autorisées de votre organisation rejette la connexion à `bridge.claudeusercontent.com` | Vérifiez que l'extension est connectée au même compte claude.ai que Claude Code, redémarrez Chrome et Claude Code, puis exécutez `/chrome` pour reconnecter. Si votre organisation utilise une liste d'adresses IP autorisées et que l'erreur persiste, consultez [Listes d'adresses IP autorisées et sortie proxy de l'organisation](/docs/fr/network-config#organization-ip-allowlists-and-proxy-egress) |

347| Extension shows "Not detected" in `/chrome` | L'extension Chrome n'est pas installée ou est désactivée | Installez ou activez l'extension dans `chrome://extensions` |347| Extension shows "Not detected" in `/chrome` | L'extension Chrome n'est pas installée ou est désactivée | Installez ou activez l'extension dans `chrome://extensions` |

348| « No tab available » | Claude a tenté d'agir avant qu'un onglet soit prêt | Demandez à Claude de créer un nouvel onglet et réessayez |348| « No tab available » | Claude a tenté d'agir avant qu'un onglet soit prêt | Demandez à Claude de créer un nouvel onglet et réessayez |

349| « Receiving end does not exist » | Le service worker de l'extension est devenu inactif | Exécutez `/chrome` et sélectionnez « Reconnect extension » |349| « Receiving end does not exist » | Le service worker de l'extension est devenu inactif | Exécutez `/chrome` et sélectionnez « Reconnect extension » |

Details

75| - | - |75| - | - |

76| Claude Code v2.1.195 ou ultérieur | La sous-commande `claude gateway` et le flux de connexion de la passerelle sont livrés dans v2.1.195. Les versions publiques antérieures ne les incluent pas. La machine exécutant le serveur de passerelle et la machine de chaque développeur doivent être sur v2.1.195 ou ultérieur ; exécutez `claude update` pour obtenir la dernière version. L'[amont Claude Platform on AWS](/docs/fr/claude-apps-gateway-config#claude-platform-on-aws) nécessite Claude Code v2.1.198 ou ultérieur sur le serveur de passerelle. |76| Claude Code v2.1.195 ou ultérieur | La sous-commande `claude gateway` et le flux de connexion de la passerelle sont livrés dans v2.1.195. Les versions publiques antérieures ne les incluent pas. La machine exécutant le serveur de passerelle et la machine de chaque développeur doivent être sur v2.1.195 ou ultérieur ; exécutez `claude update` pour obtenir la dernière version. L'[amont Claude Platform on AWS](/docs/fr/claude-apps-gateway-config#claude-platform-on-aws) nécessite Claude Code v2.1.198 ou ultérieur sur le serveur de passerelle. |

77| Fournisseur d'identité OpenID Connect (OIDC) | Okta, Microsoft Entra ID, Google Workspace, Keycloak, ou Dex, ou tout autre IdP conforme à OIDC comme PingFederate. La passerelle exécute la découverte OIDC standard et le flux de code d'autorisation contre elle. SAML et LDAP ne sont pas supportés. |77| Fournisseur d'identité OpenID Connect (OIDC) | Okta, Microsoft Entra ID, Google Workspace, Keycloak, ou Dex, ou tout autre IdP conforme à OIDC comme PingFederate. La passerelle exécute la découverte OIDC standard et le flux de code d'autorisation contre elle. SAML et LDAP ne sont pas supportés. |

78| PostgreSQL 14 ou ultérieur | Soutient le flux de connexion d'appareil, où le rappel du navigateur écrit et l'interface de ligne de commande d'interrogation lit, plus les compteurs de limite de débit. Tout Postgres géré fonctionne, y compris le plus petit niveau. Sans limites de dépenses configurées, la passerelle stocke quelques Ko d'état d'authentification de courte durée ; avec les [limites de dépenses](/docs/fr/claude-apps-gateway-spend-limits), elle détient également des tables de dépenses durables, d'audit et d'identité qui doivent être sauvegardées. TLS via `?sslmode=require` est recommandé. |78| PostgreSQL 11 ou ultérieur | Soutient le flux de connexion d'appareil et les compteurs de limite de débit. Un service PostgreSQL géré fonctionne, y compris le plus petit niveau ; voir [quelles bases de données sont prises en charge](/docs/fr/claude-apps-gateway-deploy#postgres). Avec les [limites de dépenses](/docs/fr/claude-apps-gateway-spend-limits), la base de données détient également des tables de dépenses durables, d'audit et d'identité qui doivent être sauvegardées. TLS via `?sslmode=require` est recommandé. PostgreSQL 11, 12 et 13 nécessitent Claude Code v2.1.290 ou ultérieur sur le serveur de passerelle. Le projet PostgreSQL ne maintient plus ces versions ; utilisez donc une version plus récente lorsque c'est possible. |

79| Amont du modèle | Identifiants Amazon Bedrock, identifiants Claude Platform on AWS, identifiants Google Cloud, une ressource Microsoft Foundry, ou une clé API Anthropic. Plusieurs ammonts sont supportés avec basculement. |79| Amont du modèle | Identifiants Amazon Bedrock, identifiants Claude Platform on AWS, identifiants Google Cloud, une ressource Microsoft Foundry, ou une clé API Anthropic. Plusieurs ammonts sont supportés avec basculement. |

80| HTTPS | La passerelle doit être accessible via `https://` à partir des ordinateurs portables des développeurs et de tout navigateur utilisé pour la connexion ; la passerelle sert la page de vérification d'appareil sur le même écouteur. Fournissez un certificat TLS via `listen.tls` ou exécutez derrière un ingress qui termine TLS, et définissez `listen.public_url` à l'origine externe dans les deux cas. À `/login`, Claude Code accepte une origine `http://` simple uniquement quand l'hôte de la passerelle est une boucle locale : `localhost`, `127.0.0.1`, ou `::1`. |80| HTTPS | La passerelle doit être accessible via `https://` à partir des ordinateurs portables des développeurs et de tout navigateur utilisé pour la connexion ; la passerelle sert la page de vérification d'appareil sur le même écouteur. Fournissez un certificat TLS via `listen.tls` ou exécutez derrière un ingress qui termine TLS, et définissez `listen.public_url` à l'origine externe dans les deux cas. À `/login`, Claude Code accepte une origine `http://` simple uniquement quand l'hôte de la passerelle est une boucle locale : `localhost`, `127.0.0.1`, ou `::1`. |

81| Adresse de réseau privé | À `/login`, Claude Code exige que le nom d'hôte ou l'adresse IP de la passerelle ne se résolve qu'à des adresses privées : RFC 1918, link-local, CGNAT `100.64.0.0/10`, ULA IPv6 `fc00::/7`, ou boucle locale. Pour une passerelle que vous hébergez, toute adresse publique en dehors d'un bloc que vous déclarez est rejetée ; voir le [modèle de menace](/docs/fr/claude-apps-gateway-deploy#threat-model-summary) dans le guide de déploiement. Si les machines des développeurs acheminent HTTPS via un proxy d'entreprise, la connexion exige également que l'hôte proxy se résolve à des adresses privées ; s'il ne le fait pas, ajoutez l'hôte de la passerelle à `NO_PROXY` pour que l'interface de ligne de commande se connecte directement. Si votre réseau interne est numéroté à partir d'un espace IPv4 public que votre organisation possède, [déclarez ces blocs](#allow-a-gateway-on-public-address-space-you-own) pour que `/login` accepte une passerelle là-bas. |81| Adresse de réseau privé | À `/login`, Claude Code exige que le nom d'hôte ou l'adresse IP de la passerelle ne se résolve qu'à des adresses privées : RFC 1918, link-local, CGNAT `100.64.0.0/10`, ULA IPv6 `fc00::/7`, ou boucle locale. Pour une passerelle que vous hébergez, toute adresse publique en dehors d'un bloc que vous déclarez est rejetée ; voir le [modèle de menace](/docs/fr/claude-apps-gateway-deploy#threat-model-summary) dans le guide de déploiement. Si les machines des développeurs acheminent HTTPS via un proxy d'entreprise, la connexion exige également que l'hôte proxy se résolve à des adresses privées ; s'il ne le fait pas, ajoutez l'hôte de la passerelle à `NO_PROXY` pour que l'interface de ligne de commande se connecte directement. Si votre réseau interne est numéroté à partir d'un espace IPv4 public que votre organisation possède, [déclarez ces blocs](#allow-a-gateway-on-public-address-space-you-own) pour que `/login` accepte une passerelle là-bas. |


91 </Step>91 </Step>

92 92 

93 <Step title="Provisionner une base de données PostgreSQL">93 <Step title="Provisionner une base de données PostgreSQL">

94 Tout Postgres 14 ou ultérieur fonctionne, y compris le plus petit niveau géré. La passerelle exécute ses propres migrations de schéma au démarrage, donc le rôle de la base de données a besoin de droits pour créer et modifier les tables ; voir [`store`](/docs/fr/claude-apps-gateway-config#store).94 Utilisez PostgreSQL 11 ou ultérieur. Le plus petit niveau géré suffit. La passerelle exécute ses propres migrations de schéma au démarrage, donc le rôle de la base de données a besoin de droits pour créer et modifier les tables ; voir [`store`](/docs/fr/claude-apps-gateway-config#store).

95 </Step>95 </Step>

96 96 

97 <Step title="Écrivez gateway.yaml">97 <Step title="Écrivez gateway.yaml">

Details

158La passerelle lit la clé et le certificat une seule fois au démarrage, donc un fichier modifié ne prend effet qu'après un redémarrage. Effectuez la rotation dans cet ordre afin qu'aucune requête de jeton ne présente un certificat dont le fournisseur d'identité ne dispose pas :158La passerelle lit la clé et le certificat une seule fois au démarrage, donc un fichier modifié ne prend effet qu'après un redémarrage. Effectuez la rotation dans cet ordre afin qu'aucune requête de jeton ne présente un certificat dont le fournisseur d'identité ne dispose pas :

159 159 

1601. Téléversez le nouveau certificat vers le fournisseur d'identité à côté de l'ancien.1601. Téléversez le nouveau certificat vers le fournisseur d'identité à côté de l'ancien.

1612. Remplacez les fichiers de clé et de certificat que `gateway.yaml` charge, puis redémarrez la passerelle.1612. Remplacez les fichiers de clé et de certificat que `gateway.yaml` charge, puis redémarrez la passerelle. Si vous exécutez plusieurs répliques, un [redémarrage progressif](/docs/fr/claude-apps-gateway-deploy#upgrades) fonctionne, car le fournisseur d'identité dispose des deux certificats jusqu'à ce que vous supprimiez l'ancien.

1623. Supprimez l'ancien certificat du fournisseur d'identité.1623. Une fois que chaque réplique a redémarré, supprimez l'ancien certificat du fournisseur d'identité.

163 163 

164<h4 id="idp-requests-through-a-forward-proxy">164<h4 id="idp-requests-through-a-forward-proxy">

165 Demandes du fournisseur d'identité via un proxy avant165 Demandes du fournisseur d'identité via un proxy avant


227 227 

228| Champ | Obligatoire | Description |228| Champ | Obligatoire | Description |

229| - | - | - |229| - | - | - |

230| `postgres_url` | Oui | URL `postgres://` ou `postgresql://`. Obligatoire : le rendez-vous de subvention d'appareil, où le rappel du navigateur écrit et le CLI d'interrogation lit, a besoin d'un état entre répliques. La passerelle exécute ses propres migrations de schéma au démarrage et à la mise à niveau, donc le rôle a besoin de droits pour créer et modifier les tables sur le schéma cible. Voir [Mises à niveau](/docs/fr/claude-apps-gateway-deploy#upgrades) et [Postgres](/docs/fr/claude-apps-gateway-deploy#postgres). |230| `postgres_url` | Oui | URL `postgres://` ou `postgresql://` avec un seul hôte, et non une liste séparée par des virgules. La passerelle exécute ses propres migrations de schéma au démarrage et à la mise à niveau, donc le rôle a besoin de droits pour créer et modifier les tables sur le schéma cible. Voir [Mises à niveau](/docs/fr/claude-apps-gateway-deploy#upgrades) et [Postgres](/docs/fr/claude-apps-gateway-deploy#postgres). |

231| `username` | Non | Remplace l'utilisateur dans `postgres_url` |231| `username` | Non | Remplace l'utilisateur dans `postgres_url` |

232| `password` | Non | Identifiant de base de données. Définissez-le ici plutôt que dans `postgres_url` pour que l'identifiant reste hors de l'URL. Accepte n'importe quel caractère et a priorité sur les identifiants d'URL. |232| `password` | Non | Identifiant de base de données. Définissez-le ici plutôt que dans `postgres_url` pour que l'identifiant reste hors de l'URL. Accepte n'importe quel caractère et a priorité sur les identifiants d'URL. |

233| `max_connections` | Non | Taille du pool de connexions Postgres par réplique. Par défaut `5`, ce qui est conservateur et convivial pour les bases de données partagées. Avec les [limites de dépenses](#admin) activées, le chemin chaud effectue quelques opérations par demande d'inférence, donc augmentez-le pour une base de données dédiée sous charge, et gardez répliques × ceci en dessous du `max_connections` de la base de données. |233| `max_connections` | Non | Taille du pool de connexions Postgres par réplique. Par défaut `5`, ce qui est conservateur et convivial pour les bases de données partagées. Avec les [limites de dépenses](#admin) activées, le chemin chaud effectue quelques opérations par demande d'inférence, donc augmentez-le pour une base de données dédiée sous charge, et gardez répliques × ceci en dessous du `max_connections` de la base de données. |


376| N'importe où ailleurs | Passez les identifiants via les variables d'environnement `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, et `AWS_SESSION_TOKEN`, ou définissez-les explicitement dans `auth:` avec l'expansion `${VAR}` |376| N'importe où ailleurs | Passez les identifiants via les variables d'environnement `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, et `AWS_SESSION_TOKEN`, ou définissez-les explicitement dans `auth:` avec l'expansion `${VAR}` |

377| Région | `region:` est la région de l'endpoint API. Les profils d'inférence inter-régions acheminent à travers la géographie (US, EU, APAC) indépendamment de celui que vous choisissez. Pour les régions non-US ou les ARN de débit provisionné, ajoutez un bloc [`models:`](#models) avec les bons ID par upstream. |377| Région | `region:` est la région de l'endpoint API. Les profils d'inférence inter-régions acheminent à travers la géographie (US, EU, APAC) indépendamment de celui que vous choisissez. Pour les régions non-US ou les ARN de débit provisionné, ajoutez un bloc [`models:`](#models) avec les bons ID par upstream. |

378 378 

379<a id="apply-an-amazon-bedrock-guardrail" />

380 

379<h5 id="apply-an-amazon-bedrock-guardrail">381<h5 id="apply-an-amazon-bedrock-guardrail">

380 Appliquer une protection Amazon Bedrock382 Appliquer une protection Amazon Bedrock

381</h5>383</h5>


921 923 

922 Deux horloges de propagation s'appliquent :924 Deux horloges de propagation s'appliquent :

923 925 

924 * **Contenu de la politique** : modifier une politique et redéployer atteint les clients connectés lors de leur prochain sondage des paramètres gérés, en moins d'une heure, à l'exception des [modifications qui s'appliquent uniquement au prochain lancement](/docs/fr/server-managed-settings#fetch-and-caching-behavior)926 * **Contenu de la politique** : modifier une politique et redéployer atteint les clients Claude Code connectés lors de leur prochain sondage des paramètres gérés, en moins d'une heure, à l'exception des [modifications qui s'appliquent uniquement au prochain lancement](/docs/fr/server-managed-settings#fetch-and-caching-behavior)

925 * **Appartenance aux groupes** : modifier l'appartenance aux groupes d'un utilisateur change la politique qui lui correspond. Cela prend effet lors de la prochaine réémission de session, c'est-à-dire le prochain renouvellement silencieux, limité par `session.ttl_hours`.927 * **Appartenance aux groupes** : modifier l'appartenance aux groupes d'un utilisateur change la politique qui lui correspond. Cela prend effet lors de la prochaine réémission de session, c'est-à-dire le prochain renouvellement silencieux, limité par `session.ttl_hours`.

928 

929 Claude Desktop suit [son propre calendrier](#when-a-policy-change-reaches-claude-desktop).

926</Note>930</Note>

927 931 

928<h4 id="start-sessions-on-a-model-the-policy-allows">932<h4 id="start-sessions-on-a-model-the-policy-allows">


1086 Nécessite Claude Code v2.1.203 ou ultérieur sur le serveur de passerelle, et une activation explicite : `/user/bootstrap` retourne 404 à moins que la politique correspondant à l'utilisateur ne porte une clé `desktop`. Un `desktop: {}` vide active une politique, et une clé `desktop` sur la couche de base `match: {}` active chaque politique qui en hérite. Le journal d'audit enregistre chaque requête en tant que `desktop_bootstrap.serve` ou `desktop_bootstrap.denied`.1090 Nécessite Claude Code v2.1.203 ou ultérieur sur le serveur de passerelle, et une activation explicite : `/user/bootstrap` retourne 404 à moins que la politique correspondant à l'utilisateur ne porte une clé `desktop`. Un `desktop: {}` vide active une politique, et une clé `desktop` sur la couche de base `match: {}` active chaque politique qui en hérite. Le journal d'audit enregistre chaque requête en tant que `desktop_bootstrap.serve` ou `desktop_bootstrap.denied`.

1087</Note>1091</Note>

1088 1092 

1089La passerelle dérive une grande partie de la réponse du bloc `cli` de la politique correspondante et de la configuration de passerelle de niveau supérieur :1093Si vous ne déployez pas Claude Desktop, laissez complètement `desktop` hors de vos politiques ; la passerelle retourne alors 404 depuis `/user/bootstrap` pour chaque utilisateur.

1094 

1095<h5 id="settings-the-gateway-derives-for-claude-desktop">

1096 Paramètres que la passerelle dérive pour Claude Desktop

1097</h5>

1098 

1099La passerelle dérive une grande partie de la réponse d'amorçage du bloc `cli` de la politique correspondante et de la configuration de passerelle de niveau supérieur :

1090 1100 

1091* La liste des modèles, à partir de `availableModels`. [Contexte étendu dans Claude Desktop](#extended-context-in-claude-desktop) couvre l'option de contexte 1M de chaque modèle1101* La liste des modèles, à partir de `availableModels`. [Contexte étendu dans Claude Desktop](#extended-context-in-claude-desktop) couvre l'option de contexte 1M de chaque modèle

1092* Les outils désactivés, à partir des entrées `permissions.deny` constituées d'un simple nom d'outil. Si vous définissez `disabledBuiltinTools` dans le bloc `desktop` de la politique, la passerelle sert l'union de votre valeur et de la liste dérivée, de sorte que vous pouvez désactiver plus d'outils de cette façon mais ne pouvez pas réactiver un outil que vous avez désactivé via `permissions.deny`1102* Les outils désactivés, à partir des entrées `permissions.deny` constituées d'un simple nom d'outil. Si vous définissez `disabledBuiltinTools` dans le bloc `desktop` de la politique, la passerelle sert l'union de votre valeur et de la liste dérivée, de sorte que vous pouvez désactiver plus d'outils de cette façon mais ne pouvez pas réactiver un outil que vous avez désactivé via `permissions.deny`


1099 1109 

1100La passerelle omet de la réponse d'amorçage les clés sans équivalent Claude Desktop, comme `hooks` et les règles de permission ciblées comme `Bash(npm *)`.1110La passerelle omet de la réponse d'amorçage les clés sans équivalent Claude Desktop, comme `hooks` et les règles de permission ciblées comme `Bash(npm *)`.

1101 1111 

1102Ajoutez le bloc `desktop` optionnel aux côtés de `cli` pour définir directement les paramètres de Claude Desktop. Écrivez les paramètres de la [référence de configuration gérée](https://claude.com/docs/third-party/claude-desktop/configuration) de Claude Desktop sous forme de noms de clés plats. Laissez de côté les clés que Claude Desktop lit uniquement depuis MDM ou des fichiers locaux, comme `bootstrapUrl` ; la passerelle les rejette au démarrage. Avant v2.1.232, la passerelle acceptait une liste fixe de 11 clés de feature flag, comme `chatTabEnabled` et `disableAutoUpdates`, et rejetait toute autre clé au démarrage. Avant v2.1.227, la passerelle rejetait également `chatTabEnabled` et `chatAdvancedFileAnalysisEnabled` au démarrage.1112<h5 id="set-claude-desktop-settings-directly">

1113 Définir directement les paramètres de Claude Desktop

1114</h5>

1115 

1116Ajoutez le bloc `desktop` optionnel aux côtés de `cli` pour définir directement les paramètres de Claude Desktop. Écrivez les paramètres de la [référence de configuration gérée](https://claude.com/docs/third-party/claude-desktop/configuration) de Claude Desktop sous forme de noms de clés plats. Laissez de côté les clés que Claude Desktop lit uniquement depuis MDM ou des fichiers locaux, comme `bootstrapUrl` ; la passerelle les rejette au démarrage.

1117 

1118Cet exemple définit trois clés Claude Desktop pour le groupe `eng-contractors` aux côtés de ses paramètres `cli` :

1103 1119 

1104```yaml theme={null}1120```yaml theme={null}

1105managed:1121managed:


1114 banner: { text: "Contractor build: internal use only" }1130 banner: { text: "Contractor build: internal use only" }

1115```1131```

1116 1132 

1117Chaque clé est optionnelle ; Claude Desktop applique sa propre valeur par défaut pour toute clé que vous omettez. La passerelle valide chaque bloc `desktop` au démarrage par rapport au schéma de configuration que Claude Desktop utilise lui-même, de sorte qu'une erreur apparaît au démarrage de la passerelle sous la forme d'une erreur nommant la clé plutôt que d'atteindre chaque poste Desktop connecté. La passerelle échoue au démarrage lorsqu'un bloc contient :1133Chaque clé est optionnelle ; Claude Desktop applique sa propre valeur par défaut pour toute clé que vous omettez.

1134 

1135<h5 id="what-the-gateway-rejects-at-boot">

1136 Ce que la passerelle rejette au démarrage

1137</h5>

1138 

1139La passerelle valide chaque bloc `desktop` au démarrage par rapport au schéma de configuration que Claude Desktop utilise lui-même, de sorte qu'une erreur apparaît au démarrage de la passerelle sous la forme d'une erreur nommant la clé plutôt que d'atteindre chaque poste Desktop connecté. La passerelle échoue au démarrage lorsqu'un bloc contient :

1118 1140 

1119* Une clé inconnue1141* Une clé inconnue

1120* Une clé reconnue dont Claude Desktop rejetterait ou supprimerait silencieusement la valeur, comme une valeur vide ou une sous-clé mal orthographiée dans une entrée imbriquée. Avant v2.1.260, la passerelle supprimait silencieusement un champ mal orthographié dans un objet imbriqué d'une entrée `managedMcpServers` ou `orgPluginSettings` au lieu d'échouer au démarrage.1142* Une clé reconnue dont Claude Desktop rejetterait ou supprimerait silencieusement la valeur, comme une valeur vide ou une sous-clé mal orthographiée dans une entrée imbriquée. Avant v2.1.260, la passerelle supprimait silencieusement un champ mal orthographié dans un objet imbriqué d'une entrée `managedMcpServers` ou `orgPluginSettings` au lieu d'échouer au démarrage.


1123 1145 

1124Si vous utilisez une valeur ou une forme d'entrée dépréciée, comme une entrée `managedMcpServers` sans `transport`, la passerelle démarre et journalise un avertissement qui nomme le remplacement.1146Si vous utilisez une valeur ou une forme d'entrée dépréciée, comme une entrée `managedMcpServers` sans `transport`, la passerelle démarre et journalise un avertissement qui nomme le remplacement.

1125 1147 

1148Avant v2.1.232, la passerelle acceptait une liste fixe de 11 clés de feature flag, comme `chatTabEnabled` et `disableAutoUpdates`, et rejetait toute autre clé au démarrage. Avant v2.1.227, la passerelle rejetait également `chatTabEnabled` et `chatAdvancedFileAnalysisEnabled` au démarrage.

1149 

1150<h5 id="keys-that-need-a-later-gateway-or-claude-desktop-version">

1151 Clés qui nécessitent une version ultérieure de la passerelle ou de Claude Desktop

1152</h5>

1153 

1126La passerelle valide un bloc `desktop` par rapport au schéma fourni avec sa version installée, comme elle le fait pour le bloc `cli`. Pour livrer un paramètre introduit par une version plus récente de Claude Desktop, mettez d'abord à niveau la passerelle. Par exemple, `userPluginMarketplacesEnabled` et `userPluginUploadsEnabled` nécessitent Claude Code v2.1.260 ou ultérieur sur le serveur de passerelle et Claude Desktop 1.37937.0 ou ultérieur sur les machines des membres.1154La passerelle valide un bloc `desktop` par rapport au schéma fourni avec sa version installée, comme elle le fait pour le bloc `cli`. Pour livrer un paramètre introduit par une version plus récente de Claude Desktop, mettez d'abord à niveau la passerelle. Par exemple, `userPluginMarketplacesEnabled` et `userPluginUploadsEnabled` nécessitent Claude Code v2.1.260 ou ultérieur sur le serveur de passerelle et Claude Desktop 1.37937.0 ou ultérieur sur les machines des membres.

1127 1155 

1128`blockReadsOutsideWorkingDirectories`, `disableBypassPermissionsMode`, `configRecheckIntervalMinutes` et `sshClientPath` nécessitent Claude Code v2.1.281 ou ultérieur sur le serveur de passerelle. C'est aussi le cas de la valeur `required` de `microsoftAuthBroker` et du champ `continuousAccessEvaluation` d'une entrée `managedMcpServers` Microsoft 365. Les versions de Claude Desktop antérieures à la valeur `required` la lisent comme `disabled`, donc définissez `required` uniquement lorsque le Claude Desktop de chaque membre la prend en charge. La [référence de configuration gérée](https://claude.com/docs/third-party/claude-desktop/configuration) de Claude Desktop indique la version qui lit chaque clé pour la première fois.1156`blockReadsOutsideWorkingDirectories`, `disableBypassPermissionsMode`, `configRecheckIntervalMinutes` et `sshClientPath` nécessitent Claude Code v2.1.281 ou ultérieur sur le serveur de passerelle. C'est aussi le cas de la valeur `required` de `microsoftAuthBroker` et du champ `continuousAccessEvaluation` d'une entrée `managedMcpServers` Microsoft 365. Les versions de Claude Desktop antérieures à la valeur `required` la lisent comme `disabled`, donc définissez `required` uniquement lorsque le Claude Desktop de chaque membre la prend en charge. La [référence de configuration gérée](https://claude.com/docs/third-party/claude-desktop/configuration) de Claude Desktop indique la version qui lit chaque clé pour la première fois.

1129 1157 

1130Si vous définissez `orgPluginSettings` dans le bloc `desktop` d'une politique, la passerelle le sert sous la forme de tableau que lisent Claude Desktop 1.15200.0 et ultérieur. Les versions de Desktop plus anciennes ignorent le tableau et n'appliquent aucune politique d'outil de plugin, donc mettez à jour les membres vers 1.15200.0 ou ultérieur avant de vous y fier.1158Si vous définissez `orgPluginSettings` dans le bloc `desktop` d'une politique, la passerelle le sert sous la forme de tableau que lisent Claude Desktop 1.15200.0 et ultérieur. Les versions de Desktop plus anciennes ignorent le tableau et n'appliquent aucune politique d'outil de plugin, donc mettez à jour les membres vers 1.15200.0 ou ultérieur avant de vous y fier.

1131 1159 

1160<h5 id="how-a-role-policy-inherits-the-base-desktop-block">

1161 Comment une politique par rôle hérite du bloc `desktop` de base

1162</h5>

1163 

1132La passerelle complète les clés que le bloc `desktop` d'une politique ne définit pas à partir du bloc `desktop` du fourre-tout `match: {}`, de la même manière qu'elle complète le bloc `cli` d'une politique à partir de la base. Si vous définissez `disabledBuiltinTools` ou `builtinToolPolicy` à la fois dans la base et dans une politique par rôle, la passerelle conserve la restriction de la base :1164La passerelle complète les clés que le bloc `desktop` d'une politique ne définit pas à partir du bloc `desktop` du fourre-tout `match: {}`, de la même manière qu'elle complète le bloc `cli` d'une politique à partir de la base. Si vous définissez `disabledBuiltinTools` ou `builtinToolPolicy` à la fois dans la base et dans une politique par rôle, la passerelle conserve la restriction de la base :

1133 1165 

1134* `disabledBuiltinTools` : la passerelle utilise l'union de la liste de la base et de la liste de la politique1166* `disabledBuiltinTools` : la passerelle utilise l'union de la liste de la base et de la liste de la politique


1136 1168 

1137Pour toute autre clé, si vous la définissez dans la politique par rôle, la passerelle utilise la valeur de la politique par rôle. La passerelle remplace entièrement un tableau ou un objet imbriqué comme `banner`, donc si vous définissez `banner.text` dans une politique par rôle, la passerelle supprime le `banner.backgroundColor` de la base.1169Pour toute autre clé, si vous la définissez dans la politique par rôle, la passerelle utilise la valeur de la politique par rôle. La passerelle remplace entièrement un tableau ou un objet imbriqué comme `banner`, donc si vous définissez `banner.text` dans une politique par rôle, la passerelle supprime le `banner.backgroundColor` de la base.

1138 1170 

1139Si vous ne déployez pas Claude Desktop, laissez complètement `desktop` hors de vos politiques ; la passerelle retourne alors 404 depuis `/user/bootstrap` pour chaque utilisateur.1171<h5 id="when-a-policy-change-reaches-claude-desktop">

1172 Quand une modification de politique atteint Claude Desktop

1173</h5>

1174 

1175Après que vous avez redéployé la passerelle avec une politique modifiée, Claude Desktop applique la plupart des paramètres uniquement à son prochain démarrage :

1176 

1177* **Fermé** : Claude Desktop récupère la réponse d'amorçage à son démarrage, de sorte que la modification s'applique à partir du prochain démarrage

1178* **Ouvert** : Claude Desktop vérifie si la réponse a changé toutes les 10 minutes par défaut et applique quelques paramètres sans redémarrage. Pour les autres, comme [`skillCreationEnabled`](https://claude.com/docs/third-party/claude-desktop/configuration#skillcreationenabled), l'utilisateur voit une carte **Relaunch Claude Desktop** dans la barre latérale et conserve la configuration précédente jusqu'à ce qu'il redémarre l'application. Après 24 heures par défaut, Claude Desktop affiche une boîte de dialogue de redémarrage et redémarre de lui-même après 2 minutes d'inactivité

1179 

1180Pour raccourcir ces 24 heures, définissez [`relaunchEnforcementHours`](https://claude.com/docs/third-party/claude-desktop/configuration#relaunchenforcementhours) dans le bloc `desktop` de la politique. Vous avez besoin de Claude Code v2.1.260 ou ultérieur sur le serveur de passerelle et de Claude Desktop 1.40609.0 ou ultérieur sur les machines des membres. Avec `0`, la boîte de dialogue apparaît dès que Claude Desktop détecte la modification.

1140 1181 

1141<h4 id="extended-context-in-claude-desktop">1182<h4 id="extended-context-in-claude-desktop">

1142 Contexte étendu dans Claude Desktop1183 Contexte étendu dans Claude Desktop

Details

249 Postgres249 Postgres

250</h3>250</h3>

251 251 

252La passerelle stocke son état dans une base de données PostgreSQL :

253 

254* **Base de données** : PostgreSQL lui-même, auto-hébergé ou managé, en [version minimale](/docs/fr/claude-apps-gateway#prerequisites) ou ultérieure. Les bases de données qui implémentent uniquement le protocole Postgres, comme les bases de données SQL distribuées, ne sont pas prises en charge.

255* **Adresse** : `store.postgres_url` accepte un seul hôte. Si la base de données comporte plusieurs nœuds, utilisez l'adresse placée devant eux, comme l'endpoint de votre service managé, un équilibreur de charge ou une IP virtuelle. Définissez une [période de grâce de disponibilité](#readiness-grace-period) plus longue que la durée d'un basculement.

256 

252La passerelle détient cinq tables de données plus une table `_migrations`, toutes créées par ses migrations au démarrage :257La passerelle détient cinq tables de données plus une table `_migrations`, toutes créées par ses migrations au démarrage :

253 258 

254| Table | Contenu | Rétention |259| Table | Contenu | Rétention |


396| CLI `/login` : `Could not resolve the configured HTTP proxy` | Le nom d'hôte dans `HTTPS_PROXY` ou `HTTP_PROXY` ne se résout pas à partir de la machine du développeur, généralement parce qu'il n'est pas connecté au réseau d'entreprise | Demandez au développeur de se connecter à votre réseau ou VPN et de réessayer, ou corrigez l'URL du proxy |401| CLI `/login` : `Could not resolve the configured HTTP proxy` | Le nom d'hôte dans `HTTPS_PROXY` ou `HTTP_PROXY` ne se résout pas à partir de la machine du développeur, généralement parce qu'il n'est pas connecté au réseau d'entreprise | Demandez au développeur de se connecter à votre réseau ou VPN et de réessayer, ou corrigez l'URL du proxy |

397| CLI `/login` : `Could not resolve gateway host <host>` | La machine ne peut pas résoudre le nom DNS interne de la passerelle, généralement parce qu'elle n'est pas sur le réseau d'entreprise | Demandez au développeur de se connecter à votre réseau ou VPN, puis de réessayer `/login` |402| CLI `/login` : `Could not resolve gateway host <host>` | La machine ne peut pas résoudre le nom DNS interne de la passerelle, généralement parce qu'elle n'est pas sur le réseau d'entreprise | Demandez au développeur de se connecter à votre réseau ou VPN, puis de réessayer `/login` |

398| Le démarrage se termine avec une erreur de validation de configuration nommant `store.postgres_url` | Aucun Postgres configuré ; la passerelle nécessite Postgres | Définissez `store.postgres_url`. Pour le développement local, utilisez un conteneur jetable : `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`. |403| Le démarrage se termine avec une erreur de validation de configuration nommant `store.postgres_url` | Aucun Postgres configuré ; la passerelle nécessite Postgres | Définissez `store.postgres_url`. Pour le développement local, utilisez un conteneur jetable : `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`. |

404| Le démarrage se termine : `store.postgres_url in <path> is not a URL the gateway can read`, ou avant v2.1.290 un simple `Invalid URL` ou `URI error` | L'URL ne peut pas être analysée, par exemple parce qu'elle liste plus d'un hôte ou que son mot de passe contient un `/`, `?`, `#` ou `%` non encodé | Nommez [un seul hôte](#postgres), et déplacez le mot de passe dans [`store.password`](/docs/fr/claude-apps-gateway-config#store) |

399| Le démarrage se termine : `requires the native binary` | Exécution sous Node au lieu du binaire natif | Installez Claude Code avec l'une des [méthodes d'installation autonome](/docs/fr/setup) |405| Le démarrage se termine : `requires the native binary` | Exécution sous Node au lieu du binaire natif | Installez Claude Code avec l'une des [méthodes d'installation autonome](/docs/fr/setup) |

400| Le démarrage se termine avec une erreur de découverte OIDC après `config.load` | `oidc.issuer` inaccessible, ou chaîne TLS non approuvée | Vérifiez que l'émetteur est accessible à partir du pod et sert `/.well-known/openid-configuration`. Définissez `ca_cert_pem` pour l'infrastructure à clé publique privée. Si le pod atteint l'IdP uniquement via un proxy de transfert, définissez [`oidc.use_proxy: true`](/docs/fr/claude-apps-gateway-config#idp-requests-through-a-forward-proxy) ; sur les versions antérieures à v2.1.227, donnez au pod une route directe vers chacun des endpoints de l'IdP à la place. Si le pod ne peut pas non plus résoudre le nom d'hôte de l'IdP, ou le proxy refuse `CONNECT` à une adresse IP, voir [Sortie proxy uniquement](/docs/fr/claude-apps-gateway-config#proxy-only-egress), qui nécessite v2.1.277 ou ultérieur. |406| Le démarrage se termine avec une erreur de découverte OIDC après `config.load` | `oidc.issuer` inaccessible, ou chaîne TLS non approuvée | Vérifiez que l'émetteur est accessible à partir du pod et sert `/.well-known/openid-configuration`. Définissez `ca_cert_pem` pour l'infrastructure à clé publique privée. Si le pod atteint l'IdP uniquement via un proxy de transfert, définissez [`oidc.use_proxy: true`](/docs/fr/claude-apps-gateway-config#idp-requests-through-a-forward-proxy) ; sur les versions antérieures à v2.1.227, donnez au pod une route directe vers chacun des endpoints de l'IdP à la place. Si le pod ne peut pas non plus résoudre le nom d'hôte de l'IdP, ou le proxy refuse `CONNECT` à une adresse IP, voir [Sortie proxy uniquement](/docs/fr/claude-apps-gateway-config#proxy-only-egress), qui nécessite v2.1.277 ou ultérieur. |

401| Le démarrage se termine avec une erreur de permission Postgres | Le rôle de base de données manque de droits DDL sur son schéma | Accordez au rôle `CREATE` sur le schéma de la passerelle pour qu'il puisse créer et modifier ses tables au démarrage |407| Le démarrage se termine avec une erreur de permission Postgres | Le rôle de base de données manque de droits DDL sur son schéma | Accordez au rôle `CREATE` sur le schéma de la passerelle pour qu'il puisse créer et modifier ses tables au démarrage |

402| Journal : `could not connect to Postgres at boot, attempt 1 of 3` | La base de données n'était pas accessible lorsque la passerelle a démarré, par exemple sur une instance froide dont le réseau est encore en cours de configuration | Si la passerelle termine ensuite le démarrage, aucune action n'est nécessaire. Lorsque la base de données n'est pas accessible, la passerelle essaie la connexion trois fois, deux secondes d'intervalle, avant de se terminer. Si elle se termine avec `could not connect to Postgres`, vérifiez `store.postgres_url` et le chemin réseau vers la base de données. Si les tentatives expirent plutôt que d'être refusées, augmentez [`store.connect_timeout_seconds`](/docs/fr/claude-apps-gateway-config#store) pour donner à chacune plus de temps. |408| Journal : `could not connect to Postgres at boot, attempt 1 of 3` | La base de données n'était pas accessible lorsque la passerelle a démarré, par exemple sur une instance froide dont le réseau est encore en cours de configuration | Si la passerelle termine ensuite le démarrage, aucune action n'est nécessaire. Lorsque la base de données n'est pas accessible, la passerelle essaie la connexion trois fois, deux secondes d'intervalle, avant de se terminer. Si elle se termine avec `could not connect to Postgres`, vérifiez `store.postgres_url`, notamment qu'elle nomme un seul hôte, ainsi que le chemin réseau vers la base de données. Si les tentatives expirent plutôt que d'être refusées, augmentez [`store.connect_timeout_seconds`](/docs/fr/claude-apps-gateway-config#store) pour donner à chacune plus de temps. |

403| `/oauth/callback` affiche « Sign-in could not be completed » | Domaine de courrier électronique rejeté, validation id\_token échouée, ou `email_verified` est explicitement `false`, que la passerelle rejette toujours sans remplacement | Vérifiez `allowed_email_domains` et que l'IdP renvoie une réclamation `email` vérifiée. Pour `email_verified: false`, corrigez la vérification côté IdP. Si votre IdP émet le courrier électronique sous un nom de réclamation différent, définissez `oidc.email_claim`. |409| `/oauth/callback` affiche « Sign-in could not be completed » | Domaine de courrier électronique rejeté, validation id\_token échouée, ou `email_verified` est explicitement `false`, que la passerelle rejette toujours sans remplacement | Vérifiez `allowed_email_domains` et que l'IdP renvoie une réclamation `email` vérifiée. Pour `email_verified: false`, corrigez la vérification côté IdP. Si votre IdP émet le courrier électronique sous un nom de réclamation différent, définissez `oidc.email_claim`. |

404| Journal : `token exchange failed request_id=<id>: id_token missing email claim` | L'IdP n'inclut pas `email` dans l'id\_token par défaut. Ce rejet ne se déclenche que lorsque `allowed_email_domains` est défini ; sans lui, un courrier électronique manquant crée une session sans courrier électronique | Configurez l'IdP pour émettre `email` dans l'id\_token. Okta : ajoutez `email` aux réclamations de jeton d'ID d'un serveur d'autorisation personnalisé. Entra : ajoutez `email` comme réclamation facultative sur l'enregistrement de l'application. PingFederate : activez une politique OpenID Connect qui émet `email`. Si l'IdP sert `email` à partir de l'endpoint userinfo mais ne l'inclura pas dans l'id\_token, comme le serveur d'autorisation org Okta, définissez `oidc.userinfo_fallback: true`. |410| Journal : `token exchange failed request_id=<id>: id_token missing email claim` | L'IdP n'inclut pas `email` dans l'id\_token par défaut. Ce rejet ne se déclenche que lorsque `allowed_email_domains` est défini ; sans lui, un courrier électronique manquant crée une session sans courrier électronique | Configurez l'IdP pour émettre `email` dans l'id\_token. Okta : ajoutez `email` aux réclamations de jeton d'ID d'un serveur d'autorisation personnalisé. Entra : ajoutez `email` comme réclamation facultative sur l'enregistrement de l'application. PingFederate : activez une politique OpenID Connect qui émet `email`. Si l'IdP sert `email` à partir de l'endpoint userinfo mais ne l'inclura pas dans l'id\_token, comme le serveur d'autorisation org Okta, définissez `oidc.userinfo_fallback: true`. |

405| Journal : `refresh failed request_id=<id>: invalid_token (…) (at userinfo_no_id_token, …)`, et les développeurs voient `Cloud gateway session expired` tous les `session.ttl_hours` | L'IdP a accepté le jeton d'actualisation mais n'a renvoyé aucun id\_token avec lui, donc la passerelle a demandé à l'endpoint userinfo de l'IdP les réclamations de l'utilisateur. L'IdP a rejeté le jeton d'accès actualisé là. La passerelle répond `temporarily_unavailable`, donc Claude Code conserve le jeton d'actualisation mais ne peut pas renouveler la session. Les versions de passerelle antérieures à v2.1.260 enregistrent la même ligne sans le détail `(at …)`. | Définissez [`oidc.scope_on_refresh: true`](/docs/fr/claude-apps-gateway-config#oidc), disponible dans la passerelle v2.1.260 ou ultérieure, pour que la demande d'actualisation demande à nouveau `openid`. Certains IdP, comme Okta, renvoient un id\_token lors de l'actualisation uniquement lorsqu'on le demande. Sur PingFederate, activez **Return ID Token On Refresh Grant** sous **Applications > OAuth > OpenID Connect Policy Management** à la place. La clé ne change pas le comportement de PingFederate. Pour les autres IdP qui l'omettent toujours, vérifiez si l'endpoint userinfo accepte les jetons d'accès émis par une actualisation. En tant que solution temporaire, augmentez [`session.ttl_hours`](/docs/fr/claude-apps-gateway-config#session). Voir [Configuration du fournisseur d'identité](#identity-provider-setup) pour le compromis de déprovisionnement. |411| Journal : `refresh failed request_id=<id>: invalid_token (…) (at userinfo_no_id_token, …)`, et les développeurs voient `Cloud gateway session expired` tous les `session.ttl_hours` | L'IdP a accepté le jeton d'actualisation mais n'a renvoyé aucun id\_token avec lui, donc la passerelle a demandé à l'endpoint userinfo de l'IdP les réclamations de l'utilisateur. L'IdP a rejeté le jeton d'accès actualisé là. La passerelle répond `temporarily_unavailable`, donc Claude Code conserve le jeton d'actualisation mais ne peut pas renouveler la session. Les versions de passerelle antérieures à v2.1.260 enregistrent la même ligne sans le détail `(at …)`. | Définissez [`oidc.scope_on_refresh: true`](/docs/fr/claude-apps-gateway-config#oidc), disponible dans la passerelle v2.1.260 ou ultérieure, pour que la demande d'actualisation demande à nouveau `openid`. Certains IdP, comme Okta, renvoient un id\_token lors de l'actualisation uniquement lorsqu'on le demande. Sur PingFederate, activez **Return ID Token On Refresh Grant** sous **Applications > OAuth > OpenID Connect Policy Management** à la place. La clé ne change pas le comportement de PingFederate. Pour les autres IdP qui l'omettent toujours, vérifiez si l'endpoint userinfo accepte les jetons d'accès émis par une actualisation. En tant que solution temporaire, augmentez [`session.ttl_hours`](/docs/fr/claude-apps-gateway-config#session). Voir [Configuration du fournisseur d'identité](#identity-provider-setup) pour le compromis de déprovisionnement. |

Details

169 </Step>169 </Step>

170 170 

171 <Step title="Provisionner Amazon RDS pour PostgreSQL">171 <Step title="Provisionner Amazon RDS pour PostgreSQL">

172 L'instance s'exécute dans les sous-réseaux privés sans adresse publique et avec le chiffrement du stockage activé. La version du moteur est épinglée à Postgres 16, ce qui satisfait le plancher pris en charge de PostgreSQL 14 de la passerelle et garantit que la famille du groupe de paramètres ci-dessous correspond à l'instance.172 L'instance exécute Postgres 16 dans les sous-réseaux privés, sans adresse publique et avec le chiffrement du stockage activé.

173 173 

174 Tout d'abord, créez le groupe de sous-réseaux qui place la base de données dans les sous-réseaux privés, et un groupe de paramètres avec `rds.force_ssl=1` pour que le serveur rejette les connexions en texte brut. La version du moteur est épinglée une fois car la famille du groupe de paramètres doit correspondre à la version majeure du moteur que l'instance exécute :174 Tout d'abord, créez le groupe de sous-réseaux qui place la base de données dans les sous-réseaux privés, et un groupe de paramètres avec `rds.force_ssl=1` pour que le serveur rejette les connexions en texte brut. La version du moteur est épinglée une fois car la famille du groupe de paramètres doit correspondre à la version majeure du moteur que l'instance exécute :

175 175 


203 203 

204 L'argument littéral `--master-user-password` est visible dans la table des processus et dans les journaux d'audit/EDR pendant l'exécution de la commande, la même exposition que celle couverte par la note de l'étape des secrets. Sur un hôte partagé ou surveillé, passez le mot de passe via `--cli-input-json` à partir d'un fichier `0600` à la place, de la même façon que le `setup.sh` du bundle.204 L'argument littéral `--master-user-password` est visible dans la table des processus et dans les journaux d'audit/EDR pendant l'exécution de la commande, la même exposition que celle couverte par la note de l'étape des secrets. Sur un hôte partagé ou surveillé, passez le mot de passe via `--cli-input-json` à partir d'un fichier `0600` à la place, de la même façon que le `setup.sh` du bundle.

205 205 

206 Attendez que l'instance soit opérationnelle, ce qui peut prendre plusieurs minutes, puis lisez son point de terminaison privé et assemblez la chaîne de connexion que la passerelle utilisera :206 Attendez que l'instance soit opérationnelle, ce qui peut prendre plusieurs minutes, puis lisez son endpoint privé et assemblez la chaîne de connexion que la passerelle utilisera :

207 207 

208 ```bash theme={null}208 ```bash theme={null}

209 aws rds wait db-instance-available --db-instance-identifier claude-gateway-db209 aws rds wait db-instance-available --db-instance-identifier claude-gateway-db


212 GATEWAY_POSTGRES_URL="postgres://gateway:${PGPASS}@${DB_HOST}:5432/claude_gateway?sslmode=verify-full"212 GATEWAY_POSTGRES_URL="postgres://gateway:${PGPASS}@${DB_HOST}:5432/claude_gateway?sslmode=verify-full"

213 ```213 ```

214 214 

215 `sslmode=verify-full` fait que la passerelle vérifie la chaîne du certificat du serveur RDS et le nom d'hôte, pas seulement le chiffrement. L'ancre de confiance est le [bundle de certificats AWS RDS](https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem), que l'étape de construction d'image ci-dessous copie à `/etc/claude/rds-global-bundle.pem` et approuve via `NODE_EXTRA_CA_CERTS`. N'ajoutez pas de paramètre `sslrootcert=` de style libpq à l'URL : le pilote de la passerelle lit uniquement `sslmode` à partir de la chaîne de requête et transmettrait `sslrootcert` à Postgres en tant que paramètre de démarrage, que le serveur rejette.215 `sslmode=verify-full` fait que la passerelle vérifie la chaîne du certificat du serveur RDS et le nom d'hôte, pas seulement le chiffrement. L'ancre de confiance est le [bundle de certificats AWS RDS](https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem), que l'étape de build d'image ci-dessous copie à `/etc/claude/rds-global-bundle.pem` et approuve via `NODE_EXTRA_CA_CERTS`. N'ajoutez pas de paramètre `sslrootcert=` de style libpq à l'URL : le pilote de la passerelle lit uniquement `sslmode` à partir de la chaîne de requête et transmettrait `sslrootcert` à Postgres en tant que paramètre de démarrage, que le serveur rejette.

216 216 

217 Le service ECS ou les pods EKS doivent s'exécuter dans ce VPC pour pouvoir atteindre le point de terminaison privé de l'instance, et le groupe de sécurité `claude-gateway-db` n'admet que le groupe de sécurité de la passerelle.217 Le service ECS ou les pods EKS doivent s'exécuter dans ce VPC pour pouvoir atteindre l'endpoint privé de l'instance, et le groupe de sécurité `claude-gateway-db` n'admet que le groupe de sécurité de la passerelle.

218 </Step>218 </Step>

219 219 

220 <Step title="Écrire gateway.yaml">220 <Step title="Écrire gateway.yaml">

221 Le bloc `upstreams` pointe vers Bedrock avec `auth: {}`, donc la passerelle s'authentifie via la chaîne de credentials par défaut d'AWS à partir du rôle de tâche sur ECS ou du rôle IRSA sur EKS. Consultez la [référence de configuration](/docs/fr/claude-apps-gateway-config) pour chaque champ.221 Le bloc `upstreams` pointe vers Bedrock avec `auth: {}`, donc la passerelle s'authentifie via la chaîne d'identifiants par défaut d'AWS à partir du rôle de tâche sur ECS ou du rôle IRSA sur EKS. Consultez la [référence de configuration](/docs/fr/claude-apps-gateway-config) pour chaque champ.

222 222 

223 Deux champs `listen` décrivent ce qui est en face de la passerelle :223 Deux champs `listen` décrivent ce qui est en face de la passerelle :

224 224 

225 * `public_url` : l'origine `https://` externe, requise pour tout bind non-loopback ; consultez la [référence `listen`](/docs/fr/claude-apps-gateway-config#listen). La passerelle construit l'`redirect_uri` de l'IdP et son document de découverte uniquement à partir de cette valeur, jamais à partir des en-têtes `X-Forwarded-*`.225 * `public_url` : l'origine `https://` externe, requise pour tout bind non-loopback ; consultez la [référence `listen`](/docs/fr/claude-apps-gateway-config#listen). La passerelle construit l'`redirect_uri` de l'IdP et son document de découverte uniquement à partir de cette valeur, jamais à partir des en-têtes `X-Forwarded-*`.

226 * `trusted_proxies` : les plages source du frontal. La passerelle honore `X-Forwarded-For` uniquement lorsque le pair TCP est dans cette liste, puis parcourt la chaîne au-delà des sauts de confiance, donc les limites de taux de connexion par IP et les événements d'audit enregistrent les adresses IP des développeurs au lieu de celle de l'équilibreur de charge.226 * `trusted_proxies` : les plages source du frontal. La passerelle honore `X-Forwarded-For` uniquement lorsque le pair TCP est dans cette liste, puis parcourt la chaîne au-delà des sauts de confiance, donc les limites de débit de connexion par IP et les événements d'audit enregistrent les adresses IP des développeurs au lieu de celle de l'équilibreur de charge.

227 227 

228 Sur les deux pistes, le frontal est un ALB interne, qu'il soit créé directement ou par le contrôleur AWS Load Balancer, et les nœuds d'un ALB prennent des adresses à partir des sous-réseaux auxquels il est attaché, donc définissez `trusted_proxies` sur les CIDR de ces sous-réseaux. Cela approuve chaque hôte de ces sous-réseaux en tant que proxy. Gardez la source d'entrée de l'ALB, votre CIDR d'entreprise, de ne pas chevaucher, et ne partagez pas les sous-réseaux avec des charges de travail non fiables qui pourraient usurper les adresses IP des clients via `X-Forwarded-For`.228 Sur les deux pistes, le frontal est un ALB interne, qu'il soit créé directement ou par le contrôleur AWS Load Balancer, et les nœuds d'un ALB prennent des adresses à partir des sous-réseaux auxquels il est attaché, donc définissez `trusted_proxies` sur les CIDR de ces sous-réseaux. Cela approuve chaque hôte de ces sous-réseaux en tant que proxy. Veillez à ce que la source d'entrée de l'ALB, votre CIDR d'entreprise, ne les chevauche pas, et ne partagez pas les sous-réseaux avec des charges de travail non fiables qui pourraient usurper les adresses IP des clients via `X-Forwarded-For`.

229 229 

230 L'attribut de préservation du port client de l'ALB, `routing.http.xff_client_port.enabled`, peut rester à l'un ou l'autre paramètre : avec lui activé, l'ALB écrit le client comme `203.0.113.7:54321` ou `[2001:db8::1]:54321`, et la passerelle lit les deux avec le port supprimé.230 L'attribut de préservation du port client de l'ALB, `routing.http.xff_client_port.enabled`, peut rester à l'un ou l'autre paramètre : avec lui activé, l'ALB écrit le client comme `203.0.113.7:54321` ou `[2001:db8::1]:54321`, et la passerelle lit les deux avec le port supprimé.

231 231 


244 # Le serveur d'autorisation org Okta retourne un id_token mince qui omet244 # Le serveur d'autorisation org Okta retourne un id_token mince qui omet

245 # l'email et les groupes ; la passerelle les remplit à partir de /userinfo.245 # l'email et les groupes ; la passerelle les remplit à partir de /userinfo.

246 userinfo_fallback: true246 userinfo_fallback: true

247 # Okta émet des groupes uniquement lorsque la portée `groups` est demandée et que247 # Okta émet des groupes uniquement lorsque le scope `groups` est demandé et que

248 # le filtre de revendication de groupes de l'application les autorise.248 # le filtre de revendication de groupes de l'application les autorise.

249 scopes: [openid, profile, email, offline_access, groups]249 scopes: [openid, profile, email, offline_access, groups]

250 250 


262 - provider: bedrock262 - provider: bedrock

263 region: <your-region> # correspondre à $AWS_REGION pour que les ARN de la politique IAM263 region: <your-region> # correspondre à $AWS_REGION pour que les ARN de la politique IAM

264 # le couvrent264 # le couvrent

265 auth: {} # chaîne de credentials par défaut d'AWS :265 auth: {} # chaîne d'identifiants par défaut d'AWS :

266 # rôle de tâche ECS, ou IRSA sur EKS266 # rôle de tâche ECS, ou IRSA sur EKS

267 ```267 ```

268 268 

269 <Note>269 <Note>

270 Seul le bloc `oidc` est spécifique à Okta. Pour utiliser Microsoft Entra ID à la place, définissez `issuer` sur `https://login.microsoftonline.com/<tenant-id>/v2.0`, supprimez `userinfo_fallback` et la portée `groups`, et notez qu'Entra émet des ID d'objet de groupe plutôt que des noms, donc [`managed.policies`](/docs/fr/claude-apps-gateway-config#managed) doit correspondre sur les GUID, ou sur les rôles d'application avec `oidc.groups_claim: roles`. Consultez [Configuration du fournisseur d'identité](/docs/fr/claude-apps-gateway-deploy#identity-provider-setup).270 Seul le bloc `oidc` est spécifique à Okta. Pour utiliser Microsoft Entra ID à la place, définissez `issuer` sur `https://login.microsoftonline.com/<tenant-id>/v2.0`, supprimez `userinfo_fallback` et le scope `groups`, et notez qu'Entra émet des ID d'objet de groupe plutôt que des noms, donc [`managed.policies`](/docs/fr/claude-apps-gateway-config#managed) doit correspondre sur les GUID, ou sur les rôles d'application avec `oidc.groups_claim: roles`. Consultez [Configuration du fournisseur d'identité](/docs/fr/claude-apps-gateway-deploy#identity-provider-setup).

271 </Note>271 </Note>

272 </Step>272 </Step>

273 273 


289 Les arguments littéraux `--secret-string` sont visibles dans la table des processus et dans les journaux d'audit/EDR pendant l'exécution de chaque commande. Sur un hôte partagé ou surveillé, mettez la valeur dans un fichier `0600` et passez `--secret-string file://<path>` à la place. Le `setup.sh` du bundle garde les valeurs secrètes hors de l'argv du processus de la même façon, en passant des fichiers temporaires `0600` à `--cli-input-json`.289 Les arguments littéraux `--secret-string` sont visibles dans la table des processus et dans les journaux d'audit/EDR pendant l'exécution de chaque commande. Sur un hôte partagé ou surveillé, mettez la valeur dans un fichier `0600` et passez `--secret-string file://<path>` à la place. Le `setup.sh` du bundle garde les valeurs secrètes hors de l'argv du processus de la même façon, en passant des fichiers temporaires `0600` à `--cli-input-json`.

290 </Note>290 </Note>

291 291 

292 Contrairement aux secrets, `gateway.yaml` lui-même ne contient aucune valeur secrète, car chaque credential se résout au démarrage via l'expansion [`${VAR}` ou `${file:...}`](/docs/fr/claude-apps-gateway-config#secret-expansion). La façon dont tout atteint le conteneur diffère selon la piste :292 Contrairement aux secrets, `gateway.yaml` lui-même ne contient aucune valeur secrète, car tous les identifiants se résolvent au démarrage via l'expansion [`${VAR}` ou `${file:...}`](/docs/fr/claude-apps-gateway-config#secret-expansion). La façon dont tout atteint le conteneur diffère selon la piste :

293 293 

294 * Sur ECS, l'étape de construction suivante copie `gateway.yaml` dans l'image à `/etc/claude/gateway.yaml`, et la définition de tâche injecte les trois secrets en tant que variables d'environnement via son champ `secrets`, donc le YAML référence `${GATEWAY_JWT_SECRET}`, `${OIDC_CLIENT_SECRET}` et `${GATEWAY_POSTGRES_URL}`.294 * Sur ECS, l'étape de build suivante copie `gateway.yaml` dans l'image à `/etc/claude/gateway.yaml`, et la définition de tâche injecte les trois secrets en tant que variables d'environnement via son champ `secrets`, donc le YAML référence `${GATEWAY_JWT_SECRET}`, `${OIDC_CLIENT_SECRET}` et `${GATEWAY_POSTGRES_URL}`.

295 * Sur EKS, montez `gateway.yaml` à partir d'une ConfigMap et les secrets en tant que fichiers à `/secrets`, référencés comme `${file:/secrets/...}`. Sourcez les secrets Kubernetes à partir de Secrets Manager avec External Secrets Operator ou le pilote AWS du pilote CSI Secrets Store, ou créez-les directement avec `kubectl`.295 * Sur EKS, montez `gateway.yaml` à partir d'une ConfigMap et les secrets en tant que fichiers à `/secrets`, référencés comme `${file:/secrets/...}`. Sourcez les secrets Kubernetes à partir de Secrets Manager avec External Secrets Operator ou le fournisseur AWS du pilote CSI Secrets Store, ou créez-les directement avec `kubectl`.

296 </Step>296 </Step>

297 297 

298 <Step title="Construire et pousser l'image vers Amazon ECR">298 <Step title="Construire et pousser l'image vers Amazon ECR">

299 Construisez l'image selon les [exigences d'image de conteneur](/docs/fr/claude-apps-gateway-deploy#container-image), en plaçant le binaire glibc `linux-x64` à `./claude` dans le contexte de construction. Écrivez votre propre Dockerfile selon ces exigences ou commencez par le [`Dockerfile`](https://github.com/anthropics/claude-code/blob/main/examples/gateway/aws/Dockerfile) du bundle, qui copie le `gateway.yaml` rempli des étapes précédentes dans l'image à `/etc/claude/gateway.yaml`. Sur ECS, cette copie intégrée est la façon dont la configuration atteint le conteneur, c'est pourquoi la construction vient après l'écriture du fichier. La piste EKS monte plutôt `gateway.yaml` à partir d'une ConfigMap au déploiement, donc la copie intégrée n'est pas utilisée là.299 Construisez l'image selon les [exigences d'image de conteneur](/docs/fr/claude-apps-gateway-deploy#container-image), en plaçant le binaire glibc `linux-x64` à `./claude` dans le contexte de build. Écrivez votre propre Dockerfile selon ces exigences ou commencez par le [`Dockerfile`](https://github.com/anthropics/claude-code/blob/main/examples/gateway/aws/Dockerfile) du bundle, qui copie le `gateway.yaml` rempli des étapes précédentes dans l'image à `/etc/claude/gateway.yaml`. Sur ECS, cette copie intégrée est la façon dont la configuration atteint le conteneur, c'est pourquoi le build vient après l'écriture du fichier. La piste EKS monte plutôt `gateway.yaml` à partir d'une ConfigMap au déploiement, donc la copie intégrée n'est pas utilisée là.

300 300 

301 L'image porte également le bundle de certificats AWS RDS comme ancre de confiance pour la chaîne de connexion `sslmode=verify-full`, donc téléchargez-le d'abord dans le contexte de construction. AWS fait tourner le bundle (les nouvelles autorités de certification régionales sont ajoutées), donc téléchargez-le par construction plutôt que d'épingler une somme de contrôle ou de le valider :301 L'image porte également le bundle de certificats AWS RDS comme ancre de confiance pour la chaîne de connexion `sslmode=verify-full`, donc téléchargez-le d'abord dans le contexte de build. AWS fait tourner le bundle (les nouvelles autorités de certification régionales sont ajoutées), donc téléchargez-le à chaque build plutôt que d'épingler une somme de contrôle ou de le valider :

302 302 

303 ```bash theme={null}303 ```bash theme={null}

304 curl -fL --proto '=https' -o rds-global-bundle.pem \304 curl -fL --proto '=https' -o rds-global-bundle.pem \

305 https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem305 https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem

306 ```306 ```

307 307 

308 Les exigences d'image de conteneur ne couvrent pas le bundle, donc si vous écrivez votre propre Dockerfile, ajoutez les deux lignes qui le copient et le font confiance ; le Dockerfile du bundle les inclut déjà :308 Les exigences d'image de conteneur ne couvrent pas le bundle, donc si vous écrivez votre propre Dockerfile, ajoutez les deux lignes qui le copient et le font confiance ; le `Dockerfile` du bundle les inclut déjà :

309 309 

310 ```dockerfile theme={null}310 ```dockerfile theme={null}

311 COPY rds-global-bundle.pem /etc/claude/rds-global-bundle.pem311 COPY rds-global-bundle.pem /etc/claude/rds-global-bundle.pem

312 ENV NODE_EXTRA_CA_CERTS=/etc/claude/rds-global-bundle.pem312 ENV NODE_EXTRA_CA_CERTS=/etc/claude/rds-global-bundle.pem

313 ```313 ```

314 314 

315 Créez le référentiel ECR et connectez Docker à celui-ci. Les balises immuables signifient que la balise `<version>` que l'étape de déploiement épingle ne peut pas être ultérieurement silencieusement réorientée vers une image différente :315 Créez le dépôt ECR et connectez Docker à celui-ci. Les balises immuables signifient que la balise `<version>` que l'étape de déploiement épingle ne peut pas être ultérieurement silencieusement réorientée vers une image différente :

316 316 

317 ```bash theme={null}317 ```bash theme={null}

318 aws ecr create-repository --repository-name claude-gateway \318 aws ecr create-repository --repository-name claude-gateway \


425 --load-balancers "targetGroupArn=$TG_ARN,containerName=gateway,containerPort=8080"425 --load-balancers "targetGroupArn=$TG_ARN,containerName=gateway,containerPort=8080"

426 ```426 ```

427 427 

428 La période de grâce de 60 secondes donne à une tâche froide le temps de tirer l'image, de se connecter au store et de répondre à sa première vérification de santé avant qu'ECS ne commence à compter les défaillances par rapport au déploiement. La vérification de santé du groupe cible sur `GET /readyz` vérifie que le store est accessible, donc une tâche qui ne peut pas atteindre Postgres n'entre jamais en rotation. Pour garder les tâches passant la vérification lors d'une courte panne de base de données telle qu'un basculement RDS, définissez `store.readiness_grace_seconds` comme décrit dans [Comportement en cas de panne](/docs/fr/claude-apps-gateway-deploy#outage-behavior), qui couvre également l'alternative `/healthz`.428 La période de grâce de 60 secondes donne à une tâche froide le temps de tirer l'image, de se connecter au store et de répondre à sa première vérification de santé avant qu'ECS ne commence à compter les défaillances par rapport au déploiement.

429 429 

430 Les tâches s'exécutent dans des sous-réseaux privés sans IP publique, donc tout le trafic sortant (vers Bedrock, votre IdP, Secrets Manager, ECR et CloudWatch Logs) passe par la passerelle NAT. Pour garder le trafic Bedrock hors du chemin public, créez un point de terminaison VPC d'interface `bedrock-runtime` et pointez l'`base_url` upstream vers celui-ci, comme indiqué dans la [référence upstream Bedrock](/docs/fr/claude-apps-gateway-config#amazon-bedrock) ; l'IdP a toujours besoin d'une sortie Internet.430 La vérification de santé du groupe cible sur `GET /readyz` vérifie que le store est accessible, donc une tâche qui ne peut pas atteindre Postgres n'entre jamais en rotation. Pour garder les tâches passant la vérification lors d'une courte panne de base de données telle qu'un basculement RDS, définissez `store.readiness_grace_seconds` comme décrit dans [Comportement en cas de panne](/docs/fr/claude-apps-gateway-deploy#outage-behavior), qui couvre également l'alternative `/healthz`.

431 

432 Les tâches s'exécutent dans des sous-réseaux privés sans IP publique, donc tout le trafic sortant (vers Bedrock, votre IdP, Secrets Manager, ECR et CloudWatch Logs) passe par la passerelle NAT. Pour garder le trafic Bedrock hors du chemin public, créez un endpoint VPC d'interface `bedrock-runtime` et pointez l'`base_url` upstream vers celui-ci, comme indiqué dans la [référence upstream Bedrock](/docs/fr/claude-apps-gateway-config#amazon-bedrock) ; l'IdP a toujours besoin d'une sortie Internet.

431 433 

432 Terminez en donnant aux développeurs un nom d'hôte privé résolvable : dans une zone hébergée privée Route 53, aliasez le nom DNS interne de la passerelle à l'ALB, et définissez `listen.public_url` sur ce nom d'hôte. Le nom `*.elb.amazonaws.com` propre de l'ALB se résout en adresses privées sur un ALB interne, mais il ne peut pas porter votre certificat ACM, donc utilisez votre propre nom.434 Terminez en donnant aux développeurs un nom d'hôte privé résolvable : dans une zone hébergée privée Route 53, aliasez le nom DNS interne de la passerelle à l'ALB, et définissez `listen.public_url` sur ce nom d'hôte. Le nom `*.elb.amazonaws.com` propre de l'ALB se résout en adresses privées sur un ALB interne, mais il ne peut pas porter votre certificat ACM, donc utilisez votre propre nom.

433 435 


435 </Tab>437 </Tab>

436 438 

437 <Tab title="EKS">439 <Tab title="EKS">

438 Cette piste a besoin de `kubectl` et `eksctl` installés localement, et d'un cluster EKS existant avec un fournisseur OIDC IAM et le contrôleur AWS Load Balancer installé. Le cluster doit être sur `$VPC_ID` pour que les pods puissent atteindre le point de terminaison privé RDS, et le groupe de sécurité `claude-gateway-db` doit admettre le groupe de sécurité du pod ou du nœud du cluster à la place de `$GW_SG`.440 Cette piste a besoin de `kubectl` et `eksctl` installés localement, et d'un cluster EKS existant avec un fournisseur OIDC IAM et le contrôleur AWS Load Balancer installé. Le cluster doit être sur `$VPC_ID` pour que les pods puissent atteindre l'endpoint privé RDS, et le groupe de sécurité `claude-gateway-db` doit admettre le groupe de sécurité du pod ou du nœud du cluster à la place de `$GW_SG`.

439 441 

440 Sur EKS, la passerelle obtient ses credentials Bedrock via IRSA plutôt que les rôles ECS. La politique de confiance `ecs-tasks.amazonaws.com` de l'étape IAM ne s'applique pas ici ; IRSA a besoin d'un rôle dont la politique de confiance fédère sur le fournisseur OIDC du cluster, limité à `system:serviceaccount:claude-gateway:gateway`. `eksctl create iamserviceaccount` crée ce rôle, attache les politiques et annote le compte de service Kubernetes avec l'ARN du rôle en une seule étape. Transformez les deux documents de politique de l'étape IAM en politiques gérées qu'il peut attacher :442 Sur EKS, la passerelle obtient ses identifiants Bedrock via IRSA plutôt que les rôles ECS. La politique de confiance `ecs-tasks.amazonaws.com` de l'étape IAM ne s'applique pas ici ; IRSA a besoin d'un rôle dont la politique de confiance fédère sur le fournisseur OIDC du cluster, limité à `system:serviceaccount:claude-gateway:gateway`. `eksctl create iamserviceaccount` crée ce rôle, attache les politiques et annote le compte de service Kubernetes avec l'ARN du rôle en une seule étape. Transformez les deux documents de politique de l'étape IAM en politiques gérées qu'il peut attacher :

441 443 

442 ```bash theme={null}444 ```bash theme={null}

443 BEDROCK_POLICY_ARN="$(aws iam create-policy --policy-name claude-gateway-bedrock-invoke \445 BEDROCK_POLICY_ARN="$(aws iam create-policy --policy-name claude-gateway-bedrock-invoke \


453 --approve455 --approve

454 ```456 ```

455 457 

456 La politique des secrets n'est nécessaire que lorsque les pods lisent eux-mêmes Secrets Manager, comme le fait le pilote AWS du pilote CSI Secrets Store en utilisant le compte de service du pod de montage ; supprimez-la si vous créez les secrets Kubernetes d'une autre façon. Le fournisseur a besoin des deux actions de la politique : il appelle `DescribeSecret` lorsqu'il réconcilie les secrets rotatés, donc une subvention `GetSecretValue`-uniquement monte au premier déploiement mais arrête de récupérer les rotations.458 La politique des secrets n'est nécessaire que lorsque les pods lisent eux-mêmes Secrets Manager, comme le fait le fournisseur AWS du pilote CSI Secrets Store en utilisant le compte de service du pod de montage ; supprimez-la si vous créez les secrets Kubernetes d'une autre façon. Le fournisseur a besoin des deux actions de la politique : il appelle `DescribeSecret` lorsqu'il réconcilie les secrets ayant fait l'objet d'une rotation, donc une autorisation limitée à `GetSecretValue` permet le montage au premier déploiement mais cesse de récupérer les rotations.

457 459 

458 Déployez la passerelle en tant que Deployment standard plus un Service et un Ingress, comme décrit dans [Déploiement Kubernetes](/docs/fr/claude-apps-gateway-deploy#kubernetes), avec :460 Déployez la passerelle en tant que Deployment standard plus un Service et un Ingress, comme décrit dans [Déploiement Kubernetes](/docs/fr/claude-apps-gateway-deploy#kubernetes), avec :

459 461 


476 </Step>478 </Step>

477 479 

478 <Step title="Pousser l'URL de la passerelle vers les machines des développeurs">480 <Step title="Pousser l'URL de la passerelle vers les machines des développeurs">

479 La passerelle s'exécute maintenant, mais les développeurs ne peuvent pas la atteindre à partir de `/login` jusqu'à ce que l'URL de la passerelle soit sur leurs machines. Définissez `forceLoginMethod` et `forceLoginGatewayUrl` dans le [fichier de paramètres gérés](/docs/fr/claude-apps-gateway#set-the-gateway-url) que vous déployez sur chaque appareil via MDM. Il n'y a pas d'option de passerelle dans le sélecteur de connexion pour qu'un développeur sélectionne manuellement.481 La passerelle s'exécute maintenant, mais les développeurs ne peuvent pas l'atteindre à partir de `/login` tant que l'URL de la passerelle n'est pas sur leurs machines. Définissez `forceLoginMethod` et `forceLoginGatewayUrl` dans le [fichier de paramètres gérés](/docs/fr/claude-apps-gateway#set-the-gateway-url) que vous déployez sur chaque appareil via MDM. Il n'y a pas d'option de passerelle dans le sélecteur de connexion pour qu'un développeur sélectionne manuellement.

480 </Step>482 </Step>

481</Steps>483</Steps>

482 484 

Details

416* **Machines virtuelles isolées** : chaque session s'exécute dans une VM isolée gérée par Anthropic. Les sessions que votre organisation achemine vers un [environnement auto-hébergé](/docs/fr/self-hosted-environments) s'exécutent sur votre propre infrastructure à la place, où l'isolation est la responsabilité de votre déploiement416* **Machines virtuelles isolées** : chaque session s'exécute dans une VM isolée gérée par Anthropic. Les sessions que votre organisation achemine vers un [environnement auto-hébergé](/docs/fr/self-hosted-environments) s'exécutent sur votre propre infrastructure à la place, où l'isolation est la responsabilité de votre déploiement

417* <span id="default-allowed-domains" />**Contrôles d'accès réseau** : dans les environnements hébergés par Anthropic, l'accès réseau est limité par défaut et peut être désactivé. Consultez [Accès réseau](/docs/fr/cloud-environments#network-access) pour les niveaux d'accès, les [domaines autorisés par défaut](/docs/fr/cloud-environments#default-allowed-domains), et le trafic qui ne passe pas par la liste d'autorisation. Dans un environnement auto-hébergé, vous restreignez la sortie de session à votre propre limite réseau. Lors de l'exécution avec l'accès réseau désactivé, Claude Code peut toujours communiquer avec l'API Anthropic, ce qui peut permettre aux données de quitter la VM.417* <span id="default-allowed-domains" />**Contrôles d'accès réseau** : dans les environnements hébergés par Anthropic, l'accès réseau est limité par défaut et peut être désactivé. Consultez [Accès réseau](/docs/fr/cloud-environments#network-access) pour les niveaux d'accès, les [domaines autorisés par défaut](/docs/fr/cloud-environments#default-allowed-domains), et le trafic qui ne passe pas par la liste d'autorisation. Dans un environnement auto-hébergé, vous restreignez la sortie de session à votre propre limite réseau. Lors de l'exécution avec l'accès réseau désactivé, Claude Code peut toujours communiquer avec l'API Anthropic, ce qui peut permettre aux données de quitter la VM.

418* **Protection des identifiants** : dans les environnements hébergés par Anthropic, les identifiants git et les clés de signature restent en dehors du sandbox, et un proxy authentifie au nom de la session avec des identifiants limités. Dans un environnement auto-hébergé, votre déploiement fournit les identifiants git ; consultez [Configurer git](/docs/fr/self-hosted-environments-deploy#configure-git)418* **Protection des identifiants** : dans les environnements hébergés par Anthropic, les identifiants git et les clés de signature restent en dehors du sandbox, et un proxy authentifie au nom de la session avec des identifiants limités. Dans un environnement auto-hébergé, votre déploiement fournit les identifiants git ; consultez [Configurer git](/docs/fr/self-hosted-environments-deploy#configure-git)

419* **Identifiants API** : dans les environnements hébergés par Anthropic sur les plans Pro et Max, les clés que vous [ajoutez à un environnement cloud](/docs/fr/cloud-environments#add-api-credentials) restent en dehors du sandbox de la même manière, attachées aux demandes correspondantes après qu'elles quittent la session. Un environnement auto-hébergé n'a pas d'identifiants API, et les plans Team et Enterprise ne les ont pas encore419* **Secrets réseau** : dans les environnements hébergés par Anthropic sur les plans Pro et Max, les clés que vous [ajoutez à un environnement cloud](/docs/fr/cloud-environments#add-api-credentials) restent en dehors du sandbox de la même manière, attachées aux requêtes correspondantes après qu'elles quittent la session. Un environnement auto-hébergé n'a pas de secrets réseau, et les plans Team et Enterprise ne les ont pas encore

420* **Analyse sécurisée** : le code est analysé et modifié dans l'environnement isolé de la session avant la création de PR420* **Analyse sécurisée** : le code est analysé et modifié dans l'environnement isolé de la session avant la création de PR

421 421 

422<h2 id="troubleshooting">422<h2 id="troubleshooting">


442`claude --cloud` et `claude --teleport` nécessitent une connexion avec un compte claude.ai. Si vous vous authentifiez avec une clé API, ou si vos détails de compte stockés sont obsolètes, vous voyez l'un des messages suivants :442`claude --cloud` et `claude --teleport` nécessitent une connexion avec un compte claude.ai. Si vous vous authentifiez avec une clé API, ou si vos détails de compte stockés sont obsolètes, vous voyez l'un des messages suivants :

443 443 

444* `Unable to get organization UUID`444* `Unable to get organization UUID`

445* Un message indiquant que l'authentification par clé API n'est pas suffisante445* ``Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.``

446* `Error loading Claude Code sessions` dans le sélecteur de session, lorsque vous exécutez `claude --teleport` sans ID de session446* `Error loading Claude Code sessions` dans le sélecteur de session, lorsque vous exécutez `claude --teleport` sans ID de session

447 447 

448Exécutez `/login` pour vous connecter avec votre compte claude.ai, puis réessayez la commande. Si l'erreur nomme votre fournisseur à la place, consultez le [tableau d'erreurs](#errors-when-sending-to-a-cloud-session) : les sessions cloud ne sont pas disponibles via les fournisseurs tiers.448Exécutez [`claude auth login`](/docs/fr/cli-reference#cli-commands) dans votre shell pour vous connecter avec votre compte claude.ai, puis réessayez la commande. Dans une session en cours, `/login` fait de même. Si l'erreur nomme votre fournisseur à la place, consultez le [tableau d'erreurs](#errors-when-sending-to-a-cloud-session) : les sessions cloud ne sont pas disponibles via les fournisseurs tiers.

449 

450De la v2.1.274 à la v2.1.289, le message de connexion était `Claude Code cloud sessions require authentication with a Claude.ai account. API key authentication is not sufficient. Please run /login to authenticate, or check your authentication status with /status.`

449 451 

450<h3 id="remote-control-session-expired-or-access-denied">452<h3 id="remote-control-session-expired-or-access-denied">

451 Session Remote Control expirée ou accès refusé453 Session Remote Control expirée ou accès refusé

Details

34 oneLiner: 'Project instructions Claude reads every session',34 oneLiner: 'Project instructions Claude reads every session',

35 when: 'Loaded into context at the start of every session',35 when: 'Loaded into context at the start of every session',

36 description: 'Project-specific instructions that shape how Claude works in this repository. Put your conventions, common commands, and architectural context here so Claude operates with the same assumptions your team does.',36 description: 'Project-specific instructions that shape how Claude works in this repository. Put your conventions, common commands, and architectural context here so Claude operates with the same assumptions your team does.',

37 tips: ['Target under 200 lines. Longer files still load in full but may reduce adherence', <>CLAUDE.md loads into every session. If something only matters for specific tasks, move it to a <A href="/docs/en/skills">skill</A> or a path-scoped <A href="/docs/en/memory#organize-rules-with-claude/rules/">rule</A> so it loads only when needed</>, 'List the commands you run most, like build, test, and format, so Claude knows them without you spelling them out each time', <>Run <C>/memory</C> to open and edit CLAUDE.md from within a session</>, <>Also works at <C>.claude/CLAUDE.md</C> if you prefer to keep the project root clean</>, <>If your repo already has an <C>AGENTS.md</C> for other coding agents, Claude Code <A href="/docs/en/memory#agents-md">can read that</A> on its own or alongside CLAUDE.md</>],37 tips: ['Target under 200 lines. Longer files still load in full but may reduce adherence', <>CLAUDE.md loads into every session. If something only matters for specific tasks, move it to a <A href="/docs/en/skills">skill</A> or a path-scoped <A href="/docs/en/memory#organize-rules-with-claude/rules/">rule</A> so it loads only when needed</>, 'List the commands you run most, like build, test, and format, so Claude knows them without you spelling them out each time', <>Run <C>/memory</C> to open and edit CLAUDE.md from within a session</>, <>Also works at <C>.claude/CLAUDE.md</C> if you prefer to keep the project root clean</>, <>If your repo already has an <C>AGENTS.md</C> for other coding agents, Claude Code <A href="/docs/en/memory#agents-md">can read that</A> in place of a <C>CLAUDE.md</C></>],

38 exampleIntro: 'This example is for a TypeScript and React project. It lists the build and test commands, the framework conventions Claude should follow, and project-specific rules like export style and file layout.',38 exampleIntro: 'This example is for a TypeScript and React project. It lists the build and test commands, the framework conventions Claude should follow, and project-specific rules like export style and file layout.',

39 example: `# Project conventions39 example: `# Project conventions

40 40 


164 icon: 'folder',164 icon: 'folder',

165 color: '#9B7BC4',165 color: '#9B7BC4',

166 oneLiner: 'Topic-scoped instructions, optionally gated by file paths',166 oneLiner: 'Topic-scoped instructions, optionally gated by file paths',

167 when: <>Rules without <C>paths:</C> load at session start. Rules with <C>paths:</C> load when a matching file enters context</>,167 when: <>Rules without <C>paths:</C> load at session start. Rules with <C>paths:</C> load when Claude reads, writes, or edits a matching file</>,

168 description: [<>Project instructions split into topic files that can load conditionally based on file paths. A rule without <C>paths:</C> frontmatter loads at session start like CLAUDE.md; a rule with <C>paths:</C> loads only when Claude reads, writes, or edits a matching file.</>, <>Like CLAUDE.md, rules are guidance Claude reads, not configuration Claude Code enforces. For guaranteed behavior use <A href="/docs/en/hooks">hooks</A> or <A href="/docs/en/permissions">permissions</A>.</>],168 description: [<>Project instructions split into topic files that can load conditionally based on file paths. A rule without <C>paths:</C> frontmatter loads at session start like CLAUDE.md; a rule with <C>paths:</C> loads only when Claude reads, writes, or edits a matching file.</>, <>Like CLAUDE.md, rules are guidance Claude reads, not configuration Claude Code enforces. For guaranteed behavior use <A href="/docs/en/hooks">hooks</A> or <A href="/docs/en/permissions">permissions</A>.</>],

169 tips: [<>Use <C>paths:</C> frontmatter with globs to scope rules to directories or file types</>, <>Subdirectories work: <C>.claude/rules/frontend/react.md</C> is discovered automatically</>, 'When CLAUDE.md approaches 200 lines, start splitting into rules'],169 tips: [<>Use <C>paths:</C> frontmatter with globs to scope rules to directories or file types</>, <>Subdirectories work: <C>.claude/rules/frontend/react.md</C> is discovered automatically</>, 'When CLAUDE.md approaches 200 lines, start splitting into rules'],

170 docsLink: '/en/memory#organize-rules-with-claude/rules/',170 docsLink: '/en/memory#organize-rules-with-claude/rules/',


176 color: '#9B7BC4',176 color: '#9B7BC4',

177 badge: 'committed',177 badge: 'committed',

178 oneLiner: 'Test conventions scoped to test files',178 oneLiner: 'Test conventions scoped to test files',

179 when: <>Loaded when Claude reads a file matching the <C>paths:</C> globs below</>,179 when: <>Loaded when Claude reads, writes, or edits a file matching the <C>paths:</C> globs below</>,

180 description: <>An example rule that only loads when Claude is working on test files. The <C>paths:</C> globs in the frontmatter define which files trigger it; here, anything ending in .test.ts or .test.tsx. For other files, this rule is not loaded into context.</>,180 description: <>An example rule that only loads when Claude is working on test files. The <C>paths:</C> globs in the frontmatter define which files trigger it; here, anything ending in .test.ts or .test.tsx. For other files, this rule is not loaded into context.</>,

181 example: `---181 example: `---

182paths:182paths:


197 color: '#9B7BC4',197 color: '#9B7BC4',

198 badge: 'committed',198 badge: 'committed',

199 oneLiner: 'API conventions scoped to backend code',199 oneLiner: 'API conventions scoped to backend code',

200 when: <>Loaded when Claude reads a file matching the <C>paths:</C> glob below</>,200 when: <>Loaded when Claude reads, writes, or edits a file matching the <C>paths:</C> glob below</>,

201 description: <>A second example showing a rule scoped to backend code. The <C>paths:</C> glob matches files under src/api/, so these conventions load only when Claude is editing API routes.</>,201 description: <>A second example showing a rule scoped to backend code. The <C>paths:</C> glob matches files under src/api/, so these conventions load only when Claude is working on API routes.</>,

202 example: `---202 example: `---

203paths:203paths:

204 - "src/api/**/*.ts"204 - "src/api/**/*.ts"


605 icon: 'folder',605 icon: 'folder',

606 color: '#9B7BC4',606 color: '#9B7BC4',

607 oneLiner: 'User-level rules that apply to every project',607 oneLiner: 'User-level rules that apply to every project',

608 when: <>Rules without <C>paths:</C> load at session start. Rules with <C>paths:</C> load when a matching file enters context</>,608 when: <>Rules without <C>paths:</C> load at session start. Rules with <C>paths:</C> load when Claude reads, writes, or edits a matching file</>,

609 description: 'Same as project .claude/rules/ but applies everywhere. Use this for conventions you want across all your work, like personal code style or commit message format.',609 description: 'Same as project .claude/rules/ but applies everywhere. Use this for conventions you want across all your work, like personal code style or commit message format.',

610 docsLink: '/en/memory#organize-rules-with-claude/rules/',610 docsLink: '/en/memory#organize-rules-with-claude/rules/',

611 children: []611 children: []


1434 1434 

1435Sur Windows, `~/.claude` se résout en `%USERPROFILE%\.claude`. Si vous définissez [`CLAUDE_CONFIG_DIR`](/docs/fr/env-vars), chaque chemin `~/.claude` sur cette page se trouve sous ce répertoire à la place.1435Sur Windows, `~/.claude` se résout en `%USERPROFILE%\.claude`. Si vous définissez [`CLAUDE_CONFIG_DIR`](/docs/fr/env-vars), chaque chemin `~/.claude` sur cette page se trouve sous ce répertoire à la place.

1436 1436 

1437La plupart des utilisateurs ne modifient que `CLAUDE.md` et `settings.json`. Si votre référentiel possède déjà un `AGENTS.md` pour d'autres agents de codage, Claude Code [peut le lire](/docs/fr/memory#agents-md) seul ou aux côtés de `CLAUDE.md`. Le reste du répertoire est optionnel : ajoutez des skills, des rules ou des subagents selon vos besoins.1437La plupart des utilisateurs ne modifient que `CLAUDE.md` et `settings.json`. Si votre dépôt possède déjà un `AGENTS.md` pour d'autres agents de codage, Claude Code [peut le lire](/docs/fr/memory#agents-md) à la place d'un `CLAUDE.md`. Le reste du répertoire est optionnel : ajoutez des skills, des règles ou des sous-agents selon vos besoins.

1438 1438 

1439<h2 id="explore-the-directory">1439<h2 id="explore-the-directory">

1440 Explorez le répertoire1440 Explorez le répertoire


1452 1452 

1453| Fichier | Emplacement | Objectif |1453| Fichier | Emplacement | Objectif |

1454| - | - | - |1454| - | - | - |

1455| `managed-settings.json` | Au niveau du système, varie selon le système d'exploitation | Paramètres appliqués par l'entreprise que vous ne pouvez pas remplacer, à l'exception de [quelques cas particuliers](/docs/fr/settings#security-keys-where-the-stricter-value-applies). Consultez [où enregistrer le fichier](/docs/fr/managed-settings#deploy-a-managed-settings-file) et [quelle source gérée Claude Code utilise](/docs/fr/managed-settings#precedence-within-the-managed-tier). |1455| `managed-settings.json` | Au niveau du système, varie selon le système d'exploitation | Paramètres appliqués par l'entreprise que vos propres fichiers de paramètres et les valeurs `--settings` ne peuvent pas remplacer, à l'exception de [quelques cas particuliers](/docs/fr/settings#exceptions-to-managed-settings-precedence). Consultez [où enregistrer le fichier](/docs/fr/managed-settings#deploy-a-managed-settings-file) et [quelle source gérée Claude Code utilise](/docs/fr/managed-settings#precedence-within-the-managed-tier). |

1456| `CLAUDE.local.md` | Racine du projet | Vos préférences privées pour ce projet, chargées aux côtés de CLAUDE.md. Créez-le manuellement et ajoutez-le à `.gitignore`. |1456| `CLAUDE.local.md` | Racine du projet | Vos préférences privées pour ce projet, chargées aux côtés de CLAUDE.md. Créez-le manuellement et ajoutez-le à `.gitignore`. |

1457| `AGENTS.md` | Racine du projet, `.claude/`, ou n'importe quel répertoire | Instructions de projet que vous écrivez pour les agents de codage IA. Claude Code peut [le charger](/docs/fr/memory#agents-md) de lui-même ou aux côtés de `CLAUDE.md`. |1457| `AGENTS.md` | Racine du projet, `.claude/`, ou n'importe quel répertoire | Instructions de projet que vous écrivez pour les agents de codage IA. Claude Code peut [le charger](/docs/fr/memory#agents-md) à la place d'un `CLAUDE.md`. |

1458| Plugins installés | `~/.claude/plugins` | Marketplaces clonées, versions de plugins installées, l'enregistrement d'installation `installed_plugins.json` et données par plugin, gérées par les commandes `claude plugin`. Les plugins [synchronisés à partir de votre compte claude.ai](/docs/fr/plugins/loading#synced-plugins) se téléchargent dans `~/.claude/plugins/synced/`. Pour un plugin installé à partir d'une source [`command`](/docs/fr/plugins/marketplace-reference#command-plugin-source) de marketplace en mode lien, Claude Code stocke les liens ici au lieu d'une copie, et les fichiers du plugin restent dans le répertoire que la commande affiche. Une source `command` nécessite Claude Code v2.1.229 ou version ultérieure. Un plugin listé par chemin relatif dans une marketplace que vous avez ajoutée à partir d'un chemin local [se charge également sur place](/docs/fr/plugins/loading#find-plugins-on-disk) à partir de son répertoire source plutôt qu'à partir d'une copie en cache. Consultez [mise en cache des plugins](/docs/fr/plugins/loading#find-plugins-on-disk) pour savoir comment les versions orphelines sont nettoyées. |1458| Plugins installés | `~/.claude/plugins` | Marketplaces clonées, versions de plugins installées, l'enregistrement d'installation `installed_plugins.json` et données par plugin, gérées par les commandes `claude plugin`. Les plugins [synchronisés à partir de votre compte claude.ai](/docs/fr/plugins/loading#synced-plugins) se téléchargent dans `~/.claude/plugins/synced/`. Pour un plugin installé à partir d'une source [`command`](/docs/fr/plugins/marketplace-reference#command-plugin-source) de marketplace en mode lien, Claude Code stocke les liens ici au lieu d'une copie, et les fichiers du plugin restent dans le répertoire que la commande affiche. Une source `command` nécessite Claude Code v2.1.229 ou version ultérieure. Un plugin listé par chemin relatif dans une marketplace que vous avez ajoutée à partir d'un chemin local [se charge également sur place](/docs/fr/plugins/loading#find-plugins-on-disk) à partir de son répertoire source plutôt qu'à partir d'une copie en cache. Consultez [mise en cache des plugins](/docs/fr/plugins/loading#find-plugins-on-disk) pour savoir comment les versions orphelines sont nettoyées. |

1459 1459 

1460`~/.claude` contient également les données que Claude Code écrit au fur et à mesure que vous travaillez : transcriptions, historique des invites, instantanés de fichiers, caches et journaux. Consultez [données d'application](#application-data) ci-dessous.1460`~/.claude` contient également les données que Claude Code écrit au fur et à mesure que vous travaillez : transcriptions, historique des invites, instantanés de fichiers, caches et journaux. Consultez [données d'application](#application-data) ci-dessous.


1487<Note>1487<Note>

1488 Plusieurs choses peuvent remplacer ce que vous mettez dans ces fichiers :1488 Plusieurs choses peuvent remplacer ce que vous mettez dans ces fichiers :

1489 1489 

1490 * [Les paramètres gérés](/docs/fr/server-managed-settings) déployés par votre organisation ont la priorité sur tout, à l'exception des [exceptions sous Précédence des paramètres](/docs/fr/settings#exceptions-to-managed-settings-precedence)1490 * [Les paramètres gérés](/docs/fr/server-managed-settings) déployés par votre organisation ont la priorité sur chaque fichier de paramètres et chaque valeur `--settings`, à l'exception des [exceptions décrites sous Priorité des paramètres](/docs/fr/settings#exceptions-to-managed-settings-precedence)

1491 * Les flags CLI comme `--permission-mode` ou `--settings` remplacent `settings.json` pour cette session1491 * Les flags CLI comme `--permission-mode` ou `--settings` remplacent `settings.json` pour cette session

1492 * Certaines variables d'environnement ont la priorité sur leur paramètre équivalent, mais cela varie : consultez la [référence des variables d'environnement](/docs/fr/env-vars) pour chacune1492 * Certaines variables d'environnement ont la priorité sur leur paramètre équivalent, mais cela varie : consultez la [référence des variables d'environnement](/docs/fr/env-vars) pour chacune

1493 1493 


1708 1708 

1709Passez `--all` au lieu d'un chemin pour purger l'état de chaque projet à la fois, ce qui supprime `history.jsonl` directement plutôt que de le filtrer. Passez `-i` pour parcourir le plan de suppression un élément à la fois.1709Passez `--all` au lieu d'un chemin pour purger l'état de chaque projet à la fois, ce qui supprime `history.jsonl` directement plutôt que de le filtrer. Passez `-i` pour parcourir le plan de suppression un élément à la fois.

1710 1710 

1711Dans un script, vérifiez la sortie plutôt que le seul statut de sortie. Une exécution qui supprime tout ce que contient son plan se termine par `Purged N item(s)`. Considérez cette ligne comme le signe de la réussite.

1712 

1713La commande laisse `shell-snapshots/` et `backups/` seuls car ceux-ci ne sont pas limités au projet, et les avertit dans la sortie du plan. Si quelqu'un a exécuté [`/heapdump`](/docs/fr/troubleshooting#high-cpu-or-memory-usage) sur la machine, supprimez également les fichiers `.heapsnapshot` qu'il a écrits. Un snapshot de heap contient la conversation complète et tous les identifiants que le processus détenait, et ni le balayage de rétention ni la purge n'y touchent.1711La commande laisse `shell-snapshots/` et `backups/` seuls car ceux-ci ne sont pas limités au projet, et les avertit dans la sortie du plan. Si quelqu'un a exécuté [`/heapdump`](/docs/fr/troubleshooting#high-cpu-or-memory-usage) sur la machine, supprimez également les fichiers `.heapsnapshot` qu'il a écrits. Un snapshot de heap contient la conversation complète et tous les identifiants que le processus détenait, et ni le balayage de rétention ni la purge n'y touchent.

1714 1712 

1715Vous pouvez également supprimer manuellement l'un des chemins de données d'application ci-dessus, à l'exception des [fichiers d'état à conserver](#state-files-to-keep). Les nouvelles sessions ne sont pas affectées. Le tableau ci-dessous montre ce que vous perdez pour les sessions passées.1713Vous pouvez également supprimer manuellement l'un des chemins de données d'application ci-dessus, à l'exception des [fichiers d'état à conserver](#state-files-to-keep). Les nouvelles sessions ne sont pas affectées. Le tableau ci-dessous montre ce que vous perdez pour les sessions passées.

Details

57* **La conversation du projet** : une session longue durée unique où Claude agit en tant que coordinateur. Il prend ce que vous envoyez, décide ce qui devient un thread, et garde une trace de chaque thread qu'il a démarré. Il voit ce que les threads rapportent, pas chaque étape qu'ils prennent.57* **La conversation du projet** : une session longue durée unique où Claude agit en tant que coordinateur. Il prend ce que vous envoyez, décide ce qui devient un thread, et garde une trace de chaque thread qu'il a démarré. Il voit ce que les threads rapportent, pas chaque étape qu'ils prennent.

58* **Threads** : les travailleurs. Chacun est une session distincte avec sa propre fenêtre de contexte qui fait un morceau de travail et rapporte à la conversation quand il termine. Un thread cloud travaille sur sa propre branche et ouvre une pull request quand le travail l'exige.58* **Threads** : les travailleurs. Chacun est une session distincte avec sa propre fenêtre de contexte qui fait un morceau de travail et rapporte à la conversation quand il termine. Un thread cloud travaille sur sa propre branche et ouvre une pull request quand le travail l'exige.

59* **Ce que chaque thread cloud commence avec** :59* **Ce que chaque thread cloud commence avec** :

60 * Les référentiels et fichiers du projet, plus ses [instructions et mémoire](#give-a-project-standing-context)60 * Les dépôts et fichiers du projet, plus ses [instructions et mémoire](#give-a-project-standing-context)

61 * Le `CLAUDE.md` et skills dans [chacun des référentiels du projet](#what-threads-pick-up-from-your-repositories), et dans un projet avec un référentiel, les règles de permission et les hooks de ce référentiel aussi61 * Le `CLAUDE.md` et skills dans [chacun des dépôts du projet](#what-threads-pick-up-from-your-repositories), et dans un projet avec un dépôt, les règles de permission et les hooks de ce dépôt aussi

62 * Les [connecteurs](#get-skills-plugins-connectors-and-tools-into-threads) sur votre compte claude.ai62 * Les [connecteurs](#get-skills-plugins-connectors-and-tools-into-threads) sur votre compte claude.ai

63 * Un [environnement cloud](#choose-an-environment-for-threads) qui définit son accès réseau, les variables d'environnement, les identifiants API et les outils installés63 * Un [environnement cloud](#choose-an-environment-for-threads) qui définit son accès réseau, les variables d'environnement, les secrets réseau et les outils installés

64* **Le volet Overview** : où vous [voyez tous les threads à la fois](#see-what-needs-you-in-overview) et lesquels vous attendent. Ses autres onglets sont **Library** pour les fichiers que vous avez ajoutés et les fichiers que les threads ont produits, **Pull requests** pour ceux que les threads ont ouverts, et **Routines** pour le travail programmé dans le projet.64* **Le volet Overview** : où vous [voyez tous les threads à la fois](#see-what-needs-you-in-overview) et lesquels vous attendent. Ses autres onglets sont **Library** pour les fichiers que vous avez ajoutés et les fichiers que les threads ont produits, **Pull requests** pour ceux que les threads ont ouverts, et **Routines** pour le travail programmé dans le projet.

65 65 

66Les threads cloud ne reprennent rien de la configuration Claude Code sur votre propre machine. [Obtenir des skills, des plugins, des connecteurs et des outils dans les threads](#get-skills-plugins-connectors-and-tools-into-threads) couvre comment leur donner ce qui leur manquerait autrement.66Les threads cloud ne reprennent rien de la configuration Claude Code sur votre propre machine. [Obtenir des skills, des plugins, des connecteurs et des outils dans les threads](#get-skills-plugins-connectors-and-tools-into-threads) couvre comment leur donner ce qui leur manquerait autrement.


92 92 

93* **Plan** : vous êtes sur Pro ou Max et **Projects** s'affiche dans votre barre latérale.93* **Plan** : vous êtes sur Pro ou Max et **Projects** s'affiche dans votre barre latérale.

94* **GitHub, si le projet travaillera sur du code** : votre code est sur github.com plutôt que sur GitHub Enterprise Server, GitLab ou Bitbucket, votre compte GitHub connecté y a accès en push, et l'application Claude GitHub est installée dessus. Si vous avez connecté GitHub avec [`/web-setup`](/docs/fr/web-quickstart#connect-from-your-terminal), ce token permet à vos autres sessions cloud d'atteindre un référentiel mais n'est pas suffisant pour les threads du projet, qui ont besoin de l'application Claude GitHub. [Configurer l'accès GitHub](#set-up-github-access) a les étapes.94* **GitHub, si le projet travaillera sur du code** : votre code est sur github.com plutôt que sur GitHub Enterprise Server, GitLab ou Bitbucket, votre compte GitHub connecté y a accès en push, et l'application Claude GitHub est installée dessus. Si vous avez connecté GitHub avec [`/web-setup`](/docs/fr/web-quickstart#connect-from-your-terminal), ce token permet à vos autres sessions cloud d'atteindre un référentiel mais n'est pas suffisant pour les threads du projet, qui ont besoin de l'application Claude GitHub. [Configurer l'accès GitHub](#set-up-github-access) a les étapes.

95* **Réseau, identifiants et outils** : ceux-ci proviennent de l'[environnement cloud](#choose-an-environment-for-threads) du projet. L'environnement par défaut atteint déjà [les registres de packages courants](/docs/fr/cloud-environments#default-allowed-domains), donc vérifiez ceci seulement si le travail a besoin d'autres domaines, d'un secret ou d'un outil qui n'est pas préinstallé. Si le travail a besoin d'un serveur MCP, vérifiez qu'il s'affiche comme connecté dans vos [connecteurs claude.ai](https://claude.ai/customize/connectors).95* **Accès réseau, secrets et outils** : pour les threads cloud, ceux-ci proviennent de l'[environnement cloud](#choose-an-environment-for-threads) du projet. L'environnement par défaut atteint déjà [les registres de packages courants](/docs/fr/cloud-environments#default-allowed-domains), donc vérifiez ceci seulement si le travail a besoin d'autres domaines, d'un secret ou d'un outil qui n'est pas préinstallé. Si le travail a besoin d'un serveur MCP, vérifiez qu'il s'affiche comme connecté dans vos [connecteurs claude.ai](https://claude.ai/customize/connectors).

96 96 

97<h3 id="start-a-new-project-from-scratch">97<h3 id="start-a-new-project-from-scratch">

98 Démarrer un nouveau projet à partir de zéro98 Démarrer un nouveau projet à partir de zéro


396 Choisir un environnement pour les threads396 Choisir un environnement pour les threads

397</h3>397</h3>

398 398 

399Chaque nouveau thread cloud démarre dans l'[environnement cloud](/docs/fr/cloud-environments) du projet. L'environnement définit quels domaines les threads peuvent atteindre, quelles variables d'environnement ils ont, quels identifiants API sont ajoutés à leurs demandes et ce que le script de configuration installe avant que Claude commence. Les threads cloud utilisent un environnement par défaut hébergé par Anthropic jusqu'à ce que vous en choisissiez un dans **Project settings > Environment**.399Chaque nouveau thread cloud démarre dans l'[environnement cloud](/docs/fr/cloud-environments) du projet. L'environnement définit quels domaines les threads peuvent atteindre, quelles variables d'environnement ils ont, quels secrets réseau sont ajoutés à leurs requêtes et ce que le script de configuration installe avant que Claude commence. Les threads cloud utilisent un environnement par défaut hébergé par Anthropic jusqu'à ce que vous en choisissiez un dans **Project settings > Environment**.

400 400 

401Si les threads cloud ont besoin d'atteindre une API interne ou un registre de packages privé, ou ont besoin d'un token que votre machine détient normalement, changez l'environnement plutôt que le projet : voir [Accès réseau](/docs/fr/cloud-environments#network-access), [Ajouter des identifiants API](/docs/fr/cloud-environments#add-api-credentials) et [Scripts de configuration](/docs/fr/cloud-environments#setup-scripts).401Si les threads cloud ont besoin d'atteindre une API interne ou un registre de packages privé, ou ont besoin d'un jeton que votre machine détient normalement, changez l'environnement plutôt que le projet : voir [Accès réseau](/docs/fr/cloud-environments#network-access), [Ajouter des secrets réseau](/docs/fr/cloud-environments#add-api-credentials) et [Scripts de configuration](/docs/fr/cloud-environments#setup-scripts).

402 402 

403<h3 id="get-skills-plugins-connectors-and-tools-into-threads">403<h3 id="get-skills-plugins-connectors-and-tools-into-threads">

404 Obtenir des skills, des plugins, des connecteurs et des outils dans les threads404 Obtenir des skills, des plugins, des connecteurs et des outils dans les threads


590</h2>590</h2>

591 591 

592* [Utiliser Claude Code dans le cloud](/docs/fr/claude-code-on-the-web) : comment fonctionnent les sessions cloud derrière chaque thread, y compris les options d'accès GitHub et l'auto-fix sur les pull requests592* [Utiliser Claude Code dans le cloud](/docs/fr/claude-code-on-the-web) : comment fonctionnent les sessions cloud derrière chaque thread, y compris les options d'accès GitHub et l'auto-fix sur les pull requests

593* [Configurer les environnements cloud](/docs/fr/cloud-environments) : changez ce que les threads peuvent atteindre sur le réseau, donnez-leur des variables d'environnement et des identifiants API, et installez des outils avec un script de configuration593* [Configurer les environnements cloud](/docs/fr/cloud-environments) : changez ce que les threads cloud peuvent atteindre sur le réseau, donnez-leur des variables d'environnement et des secrets réseau, et installez des outils avec un script de configuration

594* [Automatiser le travail avec les routines](/docs/fr/routines) : calendriers, déclencheurs et gestion des routines, y compris celles que Claude crée à partir d'un projet594* [Automatiser le travail avec les routines](/docs/fr/routines) : calendriers, déclencheurs et gestion des routines, y compris celles que Claude crée à partir d'un projet

595* [Gérer plusieurs agents avec agent view](/docs/fr/agent-view) : exécutez et suivez plusieurs sessions sur votre propre machine quand le travail a besoin d'outils ou de services que seule votre machine peut atteindre595* [Gérer plusieurs agents avec agent view](/docs/fr/agent-view) : exécutez et suivez plusieurs sessions sur votre propre machine quand le travail a besoin d'outils ou de services que seule votre machine peut atteindre

596* [Projects redesigned: from folder to conversation](https://claude.com/blog/projects-redesigned) : l'annonce du lancement, avec la réflexion derrière la transformation d'un projet en conversation avec Claude596* [Projects redesigned: from folder to conversation](https://claude.com/blog/projects-redesigned) : l'annonce du lancement, avec la réflexion derrière la transformation d'un projet en conversation avec Claude

Details

31| `claude attach <id\|name>` | Attacher à une [session d'arrière-plan](/docs/fr/agent-view#manage-sessions-from-the-shell) dans ce terminal. Passer une partie du nom d'une session en cours d'exécution à la place de l'ID nécessite Claude Code v2.1.290 ou ultérieur | `claude attach 7c5dcf5d` |31| `claude attach <id\|name>` | Attacher à une [session d'arrière-plan](/docs/fr/agent-view#manage-sessions-from-the-shell) dans ce terminal. Passer une partie du nom d'une session en cours d'exécution à la place de l'ID nécessite Claude Code v2.1.290 ou ultérieur | `claude attach 7c5dcf5d` |

32| `claude auto-mode defaults` | Imprimer les règles du classificateur [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) intégrées en JSON. Utilisez `claude auto-mode config` pour voir votre configuration effective avec les paramètres appliqués. `--label <prefix>` imprime uniquement les règles dont l'étiquette commence par ce préfixe, correspondance insensible à la casse. Nécessite Claude Code v2.1.208 ou ultérieur | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | Imprimer les règles du classificateur [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) intégrées en JSON. Utilisez `claude auto-mode config` pour voir votre configuration effective avec les paramètres appliqués. `--label <prefix>` imprime uniquement les règles dont l'étiquette commence par ce préfixe, correspondance insensible à la casse. Nécessite Claude Code v2.1.208 ou ultérieur | `claude auto-mode defaults --label 'Git Destructive'` |

33| `claude auto-mode reset` | Restaurer la configuration [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) par défaut en supprimant la section `autoMode` de votre fichier de paramètres utilisateur. Demande une confirmation avant d'écrire ; passez `-y`/`--yes` pour ignorer la demande. Les règles des [paramètres gérés](/docs/fr/server-managed-settings) ou du flag `--settings` s'appliquent toujours. Nécessite Claude Code v2.1.212 ou ultérieur. Voir [Inspecter les valeurs par défaut et votre configuration effective](/docs/fr/auto-mode-config#inspect-the-defaults-and-your-effective-config) | `claude auto-mode reset --yes` |33| `claude auto-mode reset` | Restaurer la configuration [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) par défaut en supprimant la section `autoMode` de votre fichier de paramètres utilisateur. Demande une confirmation avant d'écrire ; passez `-y`/`--yes` pour ignorer la demande. Les règles des [paramètres gérés](/docs/fr/server-managed-settings) ou du flag `--settings` s'appliquent toujours. Nécessite Claude Code v2.1.212 ou ultérieur. Voir [Inspecter les valeurs par défaut et votre configuration effective](/docs/fr/auto-mode-config#inspect-the-defaults-and-your-effective-config) | `claude auto-mode reset --yes` |

34| `claude daemon logs` | Suivre le fichier de log du [superviseur](/docs/fr/agent-view#the-supervisor-process) de session d'arrière-plan, `~/.claude/daemon.log`, en imprimant les nouvelles lignes à mesure qu'elles arrivent jusqu'à ce que vous appuyiez sur `Ctrl+C` | `claude daemon logs` |

35| `claude daemon run` | Exécuter le [superviseur](/docs/fr/agent-view#the-supervisor-process) de session d'arrière-plan au premier plan de ce terminal, en imprimant son log | `claude daemon run` |

34| `claude daemon status` | Imprimer l'état du [superviseur](/docs/fr/agent-view#the-supervisor-process) de session d'arrière-plan, la version, le répertoire socket, et le nombre de workers pour les diagnostics. Quitte avec 1 si le superviseur n'est pas en cours d'exécution | `claude daemon status` |36| `claude daemon status` | Imprimer l'état du [superviseur](/docs/fr/agent-view#the-supervisor-process) de session d'arrière-plan, la version, le répertoire socket, et le nombre de workers pour les diagnostics. Quitte avec 1 si le superviseur n'est pas en cours d'exécution | `claude daemon status` |

35| `claude daemon stop --any` | Arrêter le [superviseur](/docs/fr/agent-view#the-supervisor-process) de session d'arrière-plan et les sessions qu'il héberge. Passez `--keep-workers` pour laisser les sessions d'arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. `--any` confirme l'arrêt d'un superviseur à la demande, qui est la valeur par défaut. Utilisez ceci pour récupérer d'un [superviseur qui ne répond pas](/docs/fr/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |37| `claude daemon stop --any` | Arrêter le [superviseur](/docs/fr/agent-view#the-supervisor-process) de session d'arrière-plan et les sessions qu'il héberge. Passez `--keep-workers` pour laisser les sessions d'arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. `--any` confirme l'arrêt d'un superviseur à la demande, qui est la valeur par défaut. Utilisez ceci pour récupérer d'un [superviseur qui ne répond pas](/docs/fr/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |

36| `claude doctor` | Imprimer les diagnostics d'installation et de paramètres en lecture seule depuis le terminal sans démarrer une session, y compris la vérification de la santé de l'installation, les erreurs de validation du fichier de paramètres, et l'éligibilité à Remote Control. Pour la vérification de configuration en session qui peut également appliquer des correctifs, exécutez [`/doctor`](/docs/fr/commands#all-commands) | `claude doctor` |38| `claude doctor` | Imprimer les diagnostics d'installation et de paramètres en lecture seule depuis le terminal sans démarrer une session, y compris la vérification de la santé de l'installation, les erreurs de validation du fichier de paramètres, et l'éligibilité à Remote Control. Pour la vérification de configuration en session qui peut également appliquer des correctifs, exécutez [`/doctor`](/docs/fr/commands#all-commands) | `claude doctor` |


94| `--exec` | Exécuter une commande shell en tant que travail en arrière-plan soutenu par PTY au lieu de démarrer une session Claude. À utiliser avec `--bg` pour lancer depuis le shell | `claude --bg --exec 'pytest -x'` |96| `--exec` | Exécuter une commande shell en tant que travail en arrière-plan soutenu par PTY au lieu de démarrer une session Claude. À utiliser avec `--bg` pour lancer depuis le shell | `claude --bg --exec 'pytest -x'` |

95| `--fallback-model` | Activer le basculement automatique vers le ou les modèles spécifiés lorsque le modèle principal est surchargé ou non disponible, par exemple un modèle retiré. Accepte une liste séparée par des virgules essayée dans l'ordre. Voir [Chaînes de modèles de secours](/docs/fr/model-config#fallback-model-chains). Pour conserver une chaîne entre les sessions, utilisez le paramètre [`fallbackModel`](/docs/fr/settings-reference#fallbackmodel), que ce drapeau remplace | `claude --fallback-model sonnet,haiku` |97| `--fallback-model` | Activer le basculement automatique vers le ou les modèles spécifiés lorsque le modèle principal est surchargé ou non disponible, par exemple un modèle retiré. Accepte une liste séparée par des virgules essayée dans l'ordre. Voir [Chaînes de modèles de secours](/docs/fr/model-config#fallback-model-chains). Pour conserver une chaîne entre les sessions, utilisez le paramètre [`fallbackModel`](/docs/fr/settings-reference#fallbackmodel), que ce drapeau remplace | `claude --fallback-model sonnet,haiku` |

96| `--fork-session` | Lors de la reprise, créer un nouvel ID de session au lieu de réutiliser l'original (à utiliser avec `--resume` ou `--continue`) | `claude --resume abc123 --fork-session` |98| `--fork-session` | Lors de la reprise, créer un nouvel ID de session au lieu de réutiliser l'original (à utiliser avec `--resume` ou `--continue`) | `claude --resume abc123 --fork-session` |

97| `--forward-subagent-text` | Émettre les blocs de texte et de réflexion des [subagents](/docs/fr/sub-agents) dans le flux de sortie en tant que messages `assistant` et `user` avec `parent_tool_use_id` défini, afin que vous puissiez reconstruire la transcription de chaque subagent. Sans ce drapeau, Claude Code omet le texte et les blocs de réflexion d'un subagent qui s'exécute en [avant-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background). Nécessite `--print` et `--output-format stream-json`. Claude Code transfère également les messages des [subagents imbriqués](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents), en définissant `parent_tool_use_id` sur l'ID de l'appel de l'outil Agent ou Skill qui a généré chacun ; cela nécessite Claude Code v2.1.219 ou ultérieur, et les messages des subagents qu'une skill forquée génère, et des skills forquées imbriquées, nécessitent v2.1.275 ou ultérieur. La variable d'environnement [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/fr/env-vars) active le même comportement. Nécessite Claude Code v2.1.211 ou ultérieur | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |99| `--forward-subagent-text` | Émettre les blocs de texte et de réflexion des [sous-agents](/docs/fr/sub-agents) dans le flux de sortie en tant que messages `assistant` et `user` avec `parent_tool_use_id` défini, afin que vous puissiez reconstruire la transcription de chaque sous-agent. Sans ce flag, Claude Code omet le texte et les blocs de réflexion d'un sous-agent qui s'exécute en [avant-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background). Nécessite `--print` et `--output-format stream-json`. Pour les sous-agents imbriqués, les skills forkés et la version requise pour chacun, voir [Suivre les messages des sous-agents](/docs/fr/headless#follow-subagent-messages). La variable d'environnement [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/fr/env-vars) active le même comportement. Nécessite Claude Code v2.1.211 ou ultérieur | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |

98| `--from-pr` | Ouvrir le sélecteur de session filtré aux sessions liées à une demande de tirage spécifique. Accepte un numéro de PR, une URL GitHub ou GitHub Enterprise PR, une URL de demande de fusion GitLab, ou une URL de demande de tirage Bitbucket. Les sessions sont automatiquement liées lorsque Claude crée la demande de tirage | `claude --from-pr 123` |100| `--from-pr` | Ouvrir le sélecteur de session filtré aux sessions liées à une demande de tirage spécifique. Accepte un numéro de PR, une URL GitHub ou GitHub Enterprise PR, une URL de demande de fusion GitLab, ou une URL de demande de tirage Bitbucket. Les sessions sont automatiquement liées lorsque Claude crée la demande de tirage | `claude --from-pr 123` |

99| `--ide` | Se connecter automatiquement à l'IDE au démarrage s'il y a exactement un IDE valide disponible | `claude --ide` |101| `--ide` | Se connecter automatiquement à l'IDE au démarrage s'il y a exactement un IDE valide disponible | `claude --ide` |

100| `--init` | Exécuter les hooks d'[initialisation](/docs/fr/hooks#setup) avec le matcher `init` avant la session (mode impression uniquement) | `claude -p --init "query"` |102| `--init` | Exécuter les hooks d'[initialisation](/docs/fr/hooks#setup) avec le matcher `init` avant la session (mode impression uniquement) | `claude -p --init "query"` |

Details

10 Les environnements cloud s'appliquent aux [sessions cloud](/docs/fr/claude-code-on-the-web), qui sont disponibles sur les plans Pro, Max et Team, et pour les utilisateurs Enterprise disposant de [sièges premium ou de sièges Chat + Claude Code](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan).10 Les environnements cloud s'appliquent aux [sessions cloud](/docs/fr/claude-code-on-the-web), qui sont disponibles sur les plans Pro, Max et Team, et pour les utilisateurs Enterprise disposant de [sièges premium ou de sièges Chat + Claude Code](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan).

11</Note>11</Note>

12 12 

13Chaque [session cloud](/docs/fr/claude-code-on-the-web) s'exécute dans un environnement cloud. Vous pouvez configurer un environnement pour autoriser ou refuser l'[accès réseau](#access-levels), [définir des variables d'environnement](#set-environment-variables) pour la session, sur les plans Pro et Max stocker des [identifiants API](#add-api-credentials) que les sessions utilisent sans les voir, et exécuter un [script de configuration](#setup-scripts) avant que Claude ne commence à travailler.13Chaque [session cloud](/docs/fr/claude-code-on-the-web) s'exécute dans un environnement cloud. Vous pouvez configurer un environnement pour autoriser ou refuser l'[accès réseau](#access-levels), [définir des variables d'environnement](#set-environment-variables) pour la session, sur les plans Pro et Max stocker des [secrets réseau](#add-api-credentials) que les sessions utilisent sans les voir, et exécuter un [script de configuration](#setup-scripts) avant que Claude ne commence à travailler.

14 14 

15Les mêmes environnements s'appliquent partout où vous démarrez une session cloud : l'[application de bureau](/docs/fr/desktop), l'[application mobile Claude](/docs/fr/mobile), votre navigateur sur [claude.ai/code](https://claude.ai/code), le terminal avec [`claude --cloud`](/docs/fr/claude-code-on-the-web#from-terminal-to-cloud), les [routines](/docs/fr/routines) et [Claude Tag](https://claude.com/docs/claude-tag/overview). Chacune de ces surfaces peut également router vers un [environnement auto-hébergé](/docs/fr/self-hosted-environments). La section [Disponibilité et limitations](/docs/fr/self-hosted-environments#availability-and-limitations) couvre ce que Claude ne peut pas encore utiliser quand une session Claude Tag s'exécute dans un.15Les mêmes environnements s'appliquent partout où vous démarrez une session cloud : l'[application de bureau](/docs/fr/desktop), l'[application mobile Claude](/docs/fr/mobile), votre navigateur sur [claude.ai/code](https://claude.ai/code), le terminal avec [`claude --cloud`](/docs/fr/claude-code-on-the-web#from-terminal-to-cloud), les [routines](/docs/fr/routines) et [Claude Tag](https://claude.com/docs/claude-tag/overview). Chacune de ces surfaces peut également router vers un [environnement auto-hébergé](/docs/fr/self-hosted-environments). La section [Disponibilité et limitations](/docs/fr/self-hosted-environments#availability-and-limitations) couvre ce que Claude ne peut pas encore utiliser quand une session Claude Tag s'exécute dans un.

16 16 


58 <Step title="Ajouter ou modifier un environnement">58 <Step title="Ajouter ou modifier un environnement">

59 Sélectionnez **Cloud** pour lister vos environnements. Ensuite, sélectionnez **Add cloud environment**, ou survolez un environnement existant et sélectionnez l'icône de paramètres qui apparaît à droite.59 Sélectionnez **Cloud** pour lister vos environnements. Ensuite, sélectionnez **Add cloud environment**, ou survolez un environnement existant et sélectionnez l'icône de paramètres qui apparaît à droite.

60 60 

61 La boîte de dialogue inclut le nom, le niveau d'accès réseau, les variables d'environnement et le script de configuration. Lorsque vous modifiez un environnement cloud existant sur un plan Pro ou Max, la boîte de dialogue inclut également les [identifiants API](#add-api-credentials).61 La boîte de dialogue inclut le nom, le niveau d'accès réseau, les variables d'environnement et le script de configuration. Lorsque vous modifiez un environnement cloud existant sur un plan Pro ou Max, la boîte de dialogue inclut également les [secrets réseau](#add-api-credentials).

62 62 

63 <Frame>63 <Frame>

64 <img src="https://mintcdn.com/claude-code/ZFId6l95856c5LSw/images/cloud-environment-dialog.png?fit=max&auto=format&n=ZFId6l95856c5LSw&q=85&s=30d4478b31d1f879f7ee287ddab32505" alt="La boîte de dialogue New cloud environment. Un champ Name avec le texte d'espace réservé Default, un sélecteur Network access défini sur Trusted avec des liens vers la politique réseau et les niveaux d'accès, une zone Environment variables affichant un texte d'espace réservé au format .env avec une note indiquant que les valeurs sont visibles pour quiconque utilise l'environnement, une zone Setup script décrite comme un script Bash qui s'exécute au démarrage d'une nouvelle session avant le lancement de Claude Code, et les boutons Cancel et Create environment." width="874" height="1372" data-path="images/cloud-environment-dialog.png" />64 <img src="https://mintcdn.com/claude-code/ZFId6l95856c5LSw/images/cloud-environment-dialog.png?fit=max&auto=format&n=ZFId6l95856c5LSw&q=85&s=30d4478b31d1f879f7ee287ddab32505" alt="La boîte de dialogue New cloud environment. Un champ Name avec le texte d'espace réservé Default, un sélecteur Network access défini sur Trusted avec des liens vers la politique réseau et les niveaux d'accès, une zone Environment variables affichant un texte d'espace réservé au format .env avec une note indiquant que les valeurs sont visibles pour quiconque utilise l'environnement, une zone Setup script décrite comme un script Bash qui s'exécute au démarrage d'une nouvelle session avant le lancement de Claude Code, et les boutons Cancel et Create environment." width="874" height="1372" data-path="images/cloud-environment-dialog.png" />


91 91 

92Une session cloud définit également certaines variables elle-même au démarrage. Pour [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/fr/claude-code-on-the-web#manage-context), la valeur que la session définit remplace celle que vous ajoutez ici, donc ajouter cette clé ici n'a aucun effet.92Une session cloud définit également certaines variables elle-même au démarrage. Pour [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/fr/claude-code-on-the-web#manage-context), la valeur que la session définit remplace celle que vous ajoutez ici, donc ajouter cette clé ici n'a aucun effet.

93 93 

94Quiconque utilise l'environnement peut lire les valeurs. Sur les plans Pro et Max, utilisez plutôt une [identifiant API](#add-api-credentials) pour une clé que le proxy d'agent peut joindre à une demande. Les [demandes qui ne reçoivent jamais d'identifiant](#requests-that-never-get-the-credential) sont listées là.94Quiconque utilise l'environnement peut lire les valeurs. Sur les plans Pro et Max, utilisez plutôt un [secret réseau](#add-api-credentials) pour une clé que le proxy d'agent peut joindre à une requête. Les [requêtes qui ne reçoivent jamais de secret](#requests-that-never-get-the-credential) y sont listées.

95 95 

96<h3 id="add-api-credentials">96<h3 id="add-api-credentials">

97 Ajouter des identifiants API97 Ajouter des secrets réseau

98</h3>98</h3>

99 99 

100Un identifiant API est une clé API ou un jeton que vous stockez sur un environnement cloud afin que Claude puisse appeler cette API à partir de n'importe quelle session dans l'environnement sans voir la clé. Le proxy d'agent d'Anthropic ajoute la clé aux demandes pour les hôtes que vous listez, après que chaque demande quitte la VM de la session. La clé n'atteint jamais Claude, les commandes qu'il exécute, ou les variables d'environnement de la session.100Un secret réseau est une clé API ou un jeton que vous stockez sur un environnement cloud afin que Claude puisse appeler cette API à partir de n'importe quelle session dans l'environnement sans voir la clé. Le proxy d'agent d'Anthropic ajoute la clé aux requêtes pour les hôtes que vous listez, après que chaque requête quitte la VM de la session, de sorte que la clé elle-même reste en dehors de la VM.

101 101 

102Les identifiants API sont disponibles sur les plans Pro et Max. Ils ne sont pas encore disponibles sur les plans Team ou Enterprise, donc la section **API credentials** n'apparaît pas dans la boîte de dialogue d'environnement sur ces plans.102Les secrets réseau sont disponibles sur les plans Pro et Max. Ils ne sont pas encore disponibles sur les plans Team ou Enterprise, donc la section **Network secrets** n'apparaît pas dans la boîte de dialogue d'environnement sur ces plans.

103 103 

104<h4 id="requirements">104<h4 id="requirements">

105 Exigences105 Exigences

106</h4>106</h4>

107 107 

108Deux d'entre elles décident si vous pouvez ajouter un identifiant, et deux décident si le proxy d'agent peut l'utiliser une fois ajouté :108Ces exigences déterminent si vous pouvez ajouter un secret et si le proxy d'agent peut l'utiliser une fois ajouté :

109 109 

110* **Rôle** : un rôle d'administrateur d'organisation dans votre organisation claude.ai110* **Rôle** : un rôle d'administrateur d'organisation dans votre organisation claude.ai

111 * Sur Team et Enterprise, les propriétaires le détiennent et les administrateurs ne le détiennent pas111 * Sur Team et Enterprise, les propriétaires le détiennent et les administrateurs ne le détiennent pas

112 * Sur Pro et Max, vous le détenez dans votre propre organisation112 * Sur Pro et Max, vous le détenez dans votre propre organisation

113* **Type d'environnement** : un environnement cloud hébergé par Anthropic qui existe déjà. Un [environnement auto-hébergé](/docs/fr/self-hosted-environments) n'a pas d'identifiants API113* **Type d'environnement** : un environnement cloud hébergé par Anthropic qui existe déjà. Un [environnement auto-hébergé](/docs/fr/self-hosted-environments) n'a pas de secrets réseau

114* **Accessibilité de l'API** : l'API accepte les connexions depuis Internet, car les demandes partent du réseau d'Anthropic114* **Accessibilité de l'API** : l'API accepte les connexions depuis Internet, car les demandes partent du réseau d'Anthropic

115* **Clés de chiffrement** : si votre organisation utilise des clés de chiffrement gérées par le client, vous ne pouvez pas enregistrer les identifiants115* **Clés de chiffrement** : si votre organisation utilise des clés de chiffrement gérées par le client, vous ne pouvez pas enregistrer de secrets réseau

116 116 

117<h4 id="add-a-credential">117<h4 id="add-a-credential">

118 Ajouter un identifiant118 Ajouter un secret

119</h4>119</h4>

120 120 

121Vous ajoutez les identifiants un à la fois, et vous ne pouvez pas modifier un identifiant après l'avoir ajouté. Pour modifier les hôtes ou la valeur d'un identifiant, supprimez-le et ajoutez-le à nouveau.121Vous ajoutez les secrets un à la fois, et vous ne pouvez pas modifier un secret après l'avoir ajouté. Pour modifier les hôtes ou la valeur d'un secret, supprimez-le et ajoutez-le à nouveau.

122 122 

123<Steps>123<Steps>

124 <Step title="Ouvrir les identifiants API de l'environnement">124 <Step title="Ouvrir les secrets réseau de l'environnement">

125 [Ouvrez l'environnement pour modification](#configure-your-environment) sur [claude.ai/code](https://claude.ai/code). Dans la boîte de dialogue **Edit environment**, trouvez la section **API credentials**. Vous voyez les identifiants déjà sur l'environnement, chacun avec les hôtes auxquels il s'applique.125 [Ouvrez l'environnement pour modification](#configure-your-environment) sur [claude.ai/code](https://claude.ai/code). Dans la boîte de dialogue **Edit environment**, trouvez la section **Network secrets**. Vous voyez les secrets déjà présents sur l'environnement, chacun avec les hôtes auxquels il s'applique.

126 </Step>126 </Step>

127 127 

128 <Step title="Ajouter l'identifiant">128 <Step title="Ajouter le secret">

129 Sélectionnez **Add credential** et remplissez le formulaire. Conservez le **Credential type** par défaut, **Bearer**, pour une clé API qui voyage dans un en-tête de requête, et remplissez ces champs :129 Sélectionnez **Add secret** et remplissez le formulaire. Conservez le **Credential type** par défaut, **Bearer**, pour une clé API qui voyage dans un en-tête de requête, et remplissez ces champs :

130 130 

131 * **Name** : une étiquette pour l'identifiant, comme `Internal billing API`131 * **Name** : une étiquette pour le secret, comme `Internal billing API`

132 * **Allowed websites** : les hôtes de l'API, comme `api.example.com`. Un `*.` initial correspond à chaque sous-domaine132 * **Allowed websites** : les hôtes de l'API, comme `api.example.com`. Un `*.` initial correspond à chaque sous-domaine

133 * **Custom headers** : une ligne pour l'en-tête qui porte la clé. La ligne commence par `Authorization` comme **Name** de l'en-tête et `Bearer` comme son **Prefix** ; collez la clé elle-même comme **Value**. Pour un en-tête comme `X-Api-Key` qui prend la valeur brute, changez le nom et effacez le préfixe133 * **Custom headers** : une ligne pour l'en-tête qui porte la clé. La ligne commence par `Authorization` comme **Name** de l'en-tête et `Bearer` comme son **Prefix** ; collez la clé elle-même comme **Value**. Pour un en-tête comme `X-Api-Key` qui prend la valeur brute, changez le nom et effacez le préfixe

134 134 

135 Pour une API qui s'authentifie d'une autre manière, choisissez un **Credential type** différent. La liste est la même que celle que [Claude Tag](https://claude.com/docs/claude-tag/overview), l'intégration Slack pour les plans Team et Enterprise, propose pour les [connexions](https://claude.com/docs/claude-tag/admins/add-connections).135 Pour une API qui s'authentifie d'une autre manière, choisissez un **Credential type** différent. La liste est la même que celle que [Claude Tag](https://claude.com/docs/claude-tag/overview), l'intégration Slack pour les plans Team et Enterprise, propose pour les [connexions](https://claude.com/docs/claude-tag/admins/add-connections).

136 </Step>136 </Step>

137 137 

138 <Step title="Enregistrer l'identifiant">138 <Step title="Enregistrer le secret">

139 Sélectionnez **Connect**. L'identifiant apparaît dans la liste avec ses hôtes, enregistré sans le bouton **Save changes** de la boîte de dialogue. Vous ne pouvez pas afficher la valeur à nouveau après l'enregistrement.139 Sélectionnez **Connect**. Le secret apparaît dans la liste avec ses hôtes, enregistré sans le bouton **Save changes** de la boîte de dialogue. Vous ne pouvez pas afficher la valeur à nouveau après l'enregistrement.

140 </Step>140 </Step>

141</Steps>141</Steps>

142 142 

143Pour confirmer que l'identifiant fonctionne, démarrez une session dans l'environnement et demandez à Claude d'appeler l'API, par exemple avec `curl`. L'API répond comme si la clé était dans la demande, et la clé n'apparaît pas dans les variables d'environnement de la session ou dans aucun fichier. Si la liste marque un identifiant **Not sent** à la place, la note sous celui-ci explique pourquoi et quoi faire. Deux identifiants dont les hôtes se chevauchent sans correspondre exactement ne reçoivent aucun marqueur, et le proxy d'agent n'en envoie qu'un.143Pour confirmer que le secret fonctionne, démarrez une session dans l'environnement et demandez à Claude d'appeler l'API, par exemple avec `curl`. L'API répond comme si la clé était dans la requête, et la clé n'apparaît pas dans les variables d'environnement de la session ni dans aucun fichier. Si la liste marque plutôt un secret **Not sent**, la note en dessous explique pourquoi et quoi faire. Deux secrets dont les hôtes se chevauchent sans correspondre exactement ne reçoivent aucun marqueur, et le proxy d'agent n'en envoie qu'un.

144 144 

145<h4 id="which-requests-get-the-credential">145<h4 id="which-requests-get-the-credential">

146 Quelles demandes reçoivent l'identifiant146 Quelles requêtes reçoivent le secret

147</h4>147</h4>

148 148 

149Le proxy d'agent joint un identifiant à une demande lorsque l'hôte de la demande correspond à l'un de ceux que vous avez listés sur cet identifiant. Les sessions peuvent atteindre ces hôtes même lorsque le [niveau d'accès réseau](#access-levels) de l'environnement ne le permettrait pas autrement, sauf les [hôtes qui ne reçoivent jamais l'identifiant](#requests-that-never-get-the-credential). L'identifiant s'applique dans chaque session qui s'exécute dans l'environnement, peu importe qui l'a démarrée, jusqu'à ce que vous le supprimiez.149Le proxy d'agent joint un secret à une requête lorsque l'hôte de la requête correspond à l'un de ceux que vous avez listés sur ce secret. Les sessions peuvent atteindre ces hôtes même lorsque le [niveau d'accès réseau](#access-levels) de l'environnement ne le permettrait pas autrement, sauf les [hôtes qui ne reçoivent jamais le secret](#requests-that-never-get-the-credential). Le secret s'applique dans chaque session qui s'exécute dans l'environnement, peu importe qui l'a démarrée, jusqu'à ce que vous le supprimiez.

150 150 

151<h4 id="requests-that-never-get-the-credential">151<h4 id="requests-that-never-get-the-credential">

152 Demandes qui ne reçoivent jamais l'identifiant152 Requêtes qui ne reçoivent jamais le secret

153</h4>153</h4>

154 154 

155Le proxy d'agent ne joint jamais un identifiant que vous ajoutez à ces demandes :155Le proxy d'agent ne joint jamais un secret que vous ajoutez à ces requêtes :

156 156 

157* **GitHub** : le [proxy GitHub](#github-proxy) authentifie les demandes à GitHub à la place, donc vous n'avez pas besoin d'un identifiant API pour cela157* **GitHub** : le [proxy GitHub](#github-proxy) authentifie les requêtes vers GitHub à la place, donc vous n'avez pas besoin d'un secret réseau pour cela

158* **L'API Anthropic et les registres de paquets publics** : `api.anthropic.com`, `registry.npmjs.org`, `jsr.io`, `npm.jsr.io`, `pypi.org`, `files.pythonhosted.org`, `index.crates.io`, et `proxy.golang.org`158* **L'API Anthropic et les registres de paquets publics** : `api.anthropic.com`, `registry.npmjs.org`, `jsr.io`, `npm.jsr.io`, `pypi.org`, `files.pythonhosted.org`, `index.crates.io`, et `proxy.golang.org`

159* **Demandes de script de configuration** : Claude Code se connecte au proxy d'agent au lancement, après l'exécution du [script de configuration](#setup-scripts)159* **Demandes de script de configuration** : Claude Code se connecte au proxy d'agent au lancement, après l'exécution du [script de configuration](#setup-scripts)

160* **Export de télémétrie de Claude Code** : Claude Code envoie son propre [export de télémétrie](/docs/fr/monitoring-usage#telemetry-from-cloud-sessions-and-claude-tag) plutôt que par une commande qu'il exécute, et cette demande ne passe pas par le proxy d'agent160* **Export de télémétrie de Claude Code** : Claude Code envoie son propre [export de télémétrie](/docs/fr/monitoring-usage#telemetry-from-cloud-sessions-and-claude-tag) plutôt que par une commande qu'il exécute, et cette demande ne passe pas par le proxy d'agent


179 179 

180* Les sessions déjà en cours d'exécution dans l'environnement continuent de fonctionner.180* Les sessions déjà en cours d'exécution dans l'environnement continuent de fonctionner.

181* L'environnement disparaît du sélecteur et de `/remote-env`, donc vous ne pouvez pas le choisir pour les nouvelles sessions.181* L'environnement disparaît du sélecteur et de `/remote-env`, donc vous ne pouvez pas le choisir pour les nouvelles sessions.

182* Les identifiants API sur l'environnement restent attachés dans ses sessions en cours d'exécution. Supprimez ceux que vous ne voulez plus avant d'archiver.182* Les secrets réseau sur l'environnement restent attachés dans ses sessions en cours d'exécution. Supprimez ceux que vous ne voulez plus avant d'archiver.

183* Aucune nouvelle session ne peut démarrer dans un environnement archivé, sur aucune surface. Si l'environnement était votre [défaut CLI](#select-an-environment-from-the-cli) enregistré, Claude Code démarre les sessions cloud CLI dans l'environnement hébergé par Anthropic lorsque votre liste en a un, et sinon dans le premier environnement de votre liste qui n'est pas un [environnement de pont Remote Control](#the-default-environment). Tout ce qui est configuré avec l'environnement explicitement, comme une [routine](/docs/fr/routines#environments-and-network-access), ne peut pas démarrer de nouvelles sessions dedans. Pointez-le vers un autre environnement.183* Aucune nouvelle session ne peut démarrer dans un environnement archivé, sur aucune surface. Si l'environnement était votre [défaut CLI](#select-an-environment-from-the-cli) enregistré, Claude Code démarre les sessions cloud CLI dans l'environnement hébergé par Anthropic lorsque votre liste en a un, et sinon dans le premier environnement de votre liste qui n'est pas un [environnement de pont Remote Control](#the-default-environment). Tout ce qui est configuré avec l'environnement explicitement, comme une [routine](/docs/fr/routines#environments-and-network-access), ne peut pas démarrer de nouvelles sessions dedans. Pointez-le vers un autre environnement.

184 184 

185<h3 id="organization-shared-environments">185<h3 id="organization-shared-environments">


197 197 

198Les propriétaires choisissent l'[environnement par défaut](#the-default-environment) de l'organisation séparément, sur [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).198Les propriétaires choisissent l'[environnement par défaut](#the-default-environment) de l'organisation séparément, sur [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).

199 199 

200Les sessions de chaque membre dans un environnement partagé lisent ses variables, donc n'incluez pas de secrets dedans. Les [identifiants API](#add-api-credentials), qui donnent aux sessions une clé qu'elles ne peuvent pas lire, ne sont pas encore disponibles sur les plans Team ou Enterprise.200Les sessions de chaque membre dans un environnement partagé lisent ses variables, donc n'y incluez pas de secrets. Les [secrets réseau](#add-api-credentials), qui donnent aux sessions une clé qu'elles ne peuvent pas lire, ne sont pas encore disponibles sur les plans Team ou Enterprise.

201 201 

202<h3 id="set-the-environment-a-claude-tag-channel-uses">202<h3 id="set-the-environment-a-claude-tag-channel-uses">

203 Définir l'environnement qu'un canal Claude Tag utilise203 Définir l'environnement qu'un canal Claude Tag utilise


239 239 

240* GitHub, via son [proxy séparé](#github-proxy)240* GitHub, via son [proxy séparé](#github-proxy)

241* Les [connecteurs MCP](#network-access) que vous activez, dont le trafic transite par les serveurs d'Anthropic241* Les [connecteurs MCP](#network-access) que vous activez, dont le trafic transite par les serveurs d'Anthropic

242* Les hôtes que vous avez listés sur les [identifiants API](#add-api-credentials) de l'environnement, sauf les [hôtes qui ne reçoivent jamais l'identifiant](#requests-that-never-get-the-credential)242* Les hôtes que vous avez listés sur les [secrets réseau](#add-api-credentials) de l'environnement, sauf les [hôtes qui ne reçoivent jamais le secret](#requests-that-never-get-the-credential)

243* L'API Anthropic, pour les propres requêtes de Claude Code, même au niveau **None**, comme noté sous [Security and isolation](/docs/fr/claude-code-on-the-web#security-and-isolation)243* L'API Anthropic, pour les propres requêtes de Claude Code, même au niveau **None**, comme noté sous [Security and isolation](/docs/fr/claude-code-on-the-web#security-and-isolation)

244 244 

245<h3 id="allow-specific-domains">245<h3 id="allow-specific-domains">


254registry.example.com254registry.example.com

255```255```

256 256 

257Les sessions dans cet environnement peuvent maintenant atteindre `api.example.com`, n'importe quel sous-domaine de `internal.example.com`, et `registry.example.com`, et aucun autre domaine via le réseau de la session. Le [trafic GitHub](#github-proxy), le [trafic des connecteurs MCP](#network-access), et les requêtes vers les hôtes des [identifiants API](#add-api-credentials) de l'environnement, autres que les [hôtes qui ne reçoivent jamais l'identifiant](#requests-that-never-get-the-credential), ne passent pas par cette liste d'autorisation. Un `*.` au début correspond à tous les sous-domaines. Pour conserver également les [domaines Trusted](#default-allowed-domains), cochez **Also include default list of common package managers** ; laissez-le décoché pour autoriser uniquement ce que vous listez.257Les sessions dans cet environnement peuvent maintenant atteindre `api.example.com`, n'importe quel sous-domaine de `internal.example.com`, et `registry.example.com`, et aucun autre domaine via le réseau de la session. Le [trafic GitHub](#github-proxy), le [trafic des connecteurs MCP](#network-access), et les requêtes vers les hôtes des [secrets réseau](#add-api-credentials) de l'environnement, autres que les [hôtes qui ne reçoivent jamais le secret](#requests-that-never-get-the-credential), ne passent pas par cette liste d'autorisation. Un `*.` au début correspond à tous les sous-domaines. Pour conserver également les [domaines Trusted](#default-allowed-domains), cochez **Also include default list of common package managers** ; laissez-le décoché pour autoriser uniquement ce que vous listez.

258 258 

259Si votre organisation utilise les [artifacts](/docs/fr/artifacts#availability), vous n'avez pas besoin de `*.frame.claudeusercontent.com` dans la liste pour que les sessions les lisent. Lorsque la liste omet cet hôte, Claude Code lit le contenu des artifacts via la connexion de la session à Anthropic à la place. Conservez l'hôte dans une liste d'autorisation dans deux situations :259Si votre organisation utilise les [artifacts](/docs/fr/artifacts#availability), vous n'avez pas besoin de `*.frame.claudeusercontent.com` dans la liste pour que les sessions les lisent. Lorsque la liste omet cet hôte, Claude Code lit le contenu des artifacts via la connexion de la session à Anthropic à la place. Conservez l'hôte dans une liste d'autorisation dans deux situations :

260 260 


272* **Identifiants Git** : le client git à l'intérieur de la VM utilise un identifiant limité en portée, que le proxy vérifie et échange contre votre véritable token GitHub.272* **Identifiants Git** : le client git à l'intérieur de la VM utilise un identifiant limité en portée, que le proxy vérifie et échange contre votre véritable token GitHub.

273* **Requêtes API** : les requêtes des outils GitHub intégrés, et de `gh` sous l'[espace réservé `proxy-injected`](#work-with-github-issues-and-pull-requests), sortent avec vos véritables identifiants substitués.273* **Requêtes API** : les requêtes des outils GitHub intégrés, et de `gh` sous l'[espace réservé `proxy-injected`](#work-with-github-issues-and-pull-requests), sortent avec vos véritables identifiants substitués.

274* **Restrictions de push** : le proxy rejette les suppressions de branches et les push de tout ce qui n'est pas une branche, comme un tag. Il ne limite pas les branches qu'un push peut mettre à jour. Pour cela, utilisez des règles de protection de branche ou des rulesets sur GitHub.274* **Restrictions de push** : le proxy rejette les suppressions de branches et les push de tout ce qui n'est pas une branche, comme un tag. Il ne limite pas les branches qu'un push peut mettre à jour. Pour cela, utilisez des règles de protection de branche ou des rulesets sur GitHub.

275* **Portée du référentiel** : les requêtes API GitHub et les requêtes d'actifs de version n'atteignent que les référentiels attachés à la session, donc un script de configuration qui télécharge des actifs de version à partir d'un référentiel non attaché reçoit un 403.275* **Portée du dépôt** : le proxy sert les requêtes API GitHub pour les dépôts attachés à la session. Une requête API pour un autre dépôt reçoit un 403 dont le message commence par `GitHub access to` et contient `is not enabled for this session`.

276* **Restrictions GraphQL** : le proxy ne sert qu'un ensemble épinglé d'opérations GraphQL pour les flux de travail de pull-request. Le proxy rejette tout le reste sur le point de terminaison GraphQL avec un 403 qui dit `This GraphQL query is not enabled for this session` et nomme le fallback REST, `gh api repos/{owner}/{repo}/...`. La restriction s'applique à chaque requête via le proxy quel que soit l'identifiant que vous fournissez, donc un `GH_TOKEN` que vous définissez reçoit le même 403. Claude ne peut pas atteindre les API GitHub qui n'existent que dans GraphQL, comme Projects v2, via le proxy.276* **Restrictions GraphQL** : le proxy rejette les requêtes vers l'endpoint GraphQL de GitHub avec un 403 dont le message commence par `GitHub GraphQL is not available from Claude Code sessions` et nomme la solution de repli REST, `gh api repos/{owner}/{repo}/...`. Les sous-commandes `gh` qui utilisent GraphQL, comme `gh pr` et `gh issue`, reçoivent le même 403. La restriction s'applique à chaque requête via le proxy quels que soient les identifiants que vous fournissez, donc un `GH_TOKEN` que vous définissez reçoit le même 403. Claude ne peut pas atteindre les API GitHub qui n'existent que dans GraphQL, comme Projects v2, via le proxy.

277 277 

278Les fichiers validés des référentiels publics arrivent via `raw.githubusercontent.com`, que le [proxy de sécurité](#security-proxy) gère à la place. Ce domaine figure dans la liste [Trusted](#default-allowed-domains) par défaut, donc ces fichiers restent accessibles sauf si le [niveau d'accès](#access-levels) de l'environnement l'exclut.278Les fichiers validés des référentiels publics arrivent via `raw.githubusercontent.com`, que le [proxy de sécurité](#security-proxy) gère à la place. Ce domaine figure dans la liste [Trusted](#default-allowed-domains) par défaut, donc ces fichiers restent accessibles sauf si le [niveau d'accès](#access-levels) de l'environnement l'exclut.

279 279 


285 285 

286* Protection contre les requêtes malveillantes286* Protection contre les requêtes malveillantes

287* Limitation de débit et prévention des abus287* Limitation de débit et prévention des abus

288* Filtrage de contenu pour une sécurité renforcée

289* Un journal d'audit au niveau DNS des noms d'hôtes demandés

290 288 

291<h2 id="what’s-available-in-cloud-sessions">289<h2 id="what’s-available-in-cloud-sessions">

292 Ce qui est disponible dans les sessions cloud290 Ce qui est disponible dans les sessions cloud

293</h2>291</h2>

294 292 

295Dans les environnements hébergés par Anthropic, chaque session obtient une machine virtuelle (VM) fraîche exécutant Ubuntu 24.04 sur x86\_64, quel que soit votre propre système d'exploitation et architecture CPU, avec votre dépôt cloné et les chaînes d'outils courantes pré-installées. Quand une dépendance fournit des binaires précompilés, comme les gems Ruby avec des extensions natives ou les roues Python précompilées, utilisez sa compilation Linux x86\_64 pour correspondre à la VM. Cette section couvre les défauts hébergés par Anthropic, les outils GitHub intégrés, comment [exécuter des tests et des services](#run-tests-start-services-and-add-packages), les [limites de ressources](#resource-limits) que chaque VM obtient, et les [limites de temps](#time-limits) sur les travaux de longue durée.293Dans les environnements hébergés par Anthropic, chaque session obtient une machine virtuelle (VM) fraîche exécutant Ubuntu 24.04 sur x86\_64, quel que soit votre propre système d'exploitation et architecture CPU, avec votre dépôt cloné et les chaînes d'outils courantes pré-installées. Quand une dépendance fournit des binaires précompilés, comme les gems Ruby avec des extensions natives ou les wheels Python précompilées, utilisez son build Linux x86\_64 pour correspondre à la VM. Cette section couvre les défauts hébergés par Anthropic, les outils GitHub intégrés, comment [exécuter des tests et des services](#run-tests-start-services-and-add-packages), les [limites de ressources](#resource-limits) que chaque VM obtient, et les [limites de temps](#time-limits) sur les travaux de longue durée.

296 294 

297<Note>295<Note>

298 Les sessions que votre organisation route vers un [environnement auto-hébergé](/docs/fr/self-hosted-environments) s'exécutent sur vos propres exécuteurs à la place, avec les outils que votre image d'exécuteur fournit.296 Les sessions que votre organisation route vers un [environnement auto-hébergé](/docs/fr/self-hosted-environments) s'exécutent sur vos propres exécuteurs à la place, avec les outils que votre image d'exécuteur fournit.


302 Ce qui est reporté de votre configuration300 Ce qui est reporté de votre configuration

303</h3>301</h3>

304 302 

305Les sessions cloud commencent à partir d'un clone frais de votre dépôt. Tout ce que vous validez dans le dépôt est disponible. Tout ce que vous avez installé ou configuré seulement sur votre propre machine n'est pas disponible dans la session. La politique de votre organisation arrive séparément via les [paramètres gérés par le serveur](/docs/fr/server-managed-settings).303Les sessions cloud commencent à partir d'un clone frais de votre dépôt. Tout ce que vous commitez dans le dépôt est disponible. Tout ce que vous avez installé ou configuré seulement sur votre propre machine n'est pas disponible dans la session. La politique de votre organisation arrive séparément via les [paramètres gérés par le serveur](/docs/fr/server-managed-settings).

306 304 

307| | Disponible dans les sessions cloud | Pourquoi |305| | Disponible dans les sessions cloud | Pourquoi |

308| :- | :- | :- |306| :- | :- | :- |

309| Votre `CLAUDE.md` du dépôt | Oui | Partie du clone |307| Votre `CLAUDE.md` du dépôt | Oui | Partie du clone |

310| Vos crochets `.claude/settings.json` du dépôt et règles de permission | Oui, dans une session avec un seul dépôt | Partie du clone. Une session avec plusieurs dépôts, incluant un fil de [projet](/docs/fr/claude-projects#what-threads-pick-up-from-your-repositories), démarre au-dessus des clones et ne les lit pas |308| Vos hooks `.claude/settings.json` du dépôt et règles de permission | Oui, dans une session avec un seul dépôt | Partie du clone. Une session avec plusieurs dépôts, incluant un fil de [projet](/docs/fr/claude-projects#what-threads-pick-up-from-your-repositories), démarre au-dessus des clones et ne les lit pas |

311| Vos serveurs MCP `.mcp.json` du dépôt | Oui, dans une session avec un seul dépôt | Partie du clone, trouvé à partir du répertoire de travail de la session |309| Vos serveurs MCP `.mcp.json` du dépôt | Oui, dans une session avec un seul dépôt | Partie du clone, trouvé à partir du répertoire de travail de la session |

312| Votre `.claude/rules/` du dépôt | Oui | Partie du clone |310| Votre `.claude/rules/` du dépôt | Oui | Partie du clone |

313| Votre `.claude/skills/`, `.claude/agents/`, `.claude/commands/` du dépôt | Oui | Partie du clone |311| Votre `.claude/skills/`, `.claude/agents/`, `.claude/commands/` du dépôt | Oui | Partie du clone |

314| Plugins et places de marché déclarés dans le `.claude/settings.json` de votre dépôt | Non | Une session cloud n'installe pas les plugins qu'un dépôt active sous [`enabledPlugins`](/docs/fr/settings-reference#enabledplugins), y compris ceux des places de marché qu'il liste sous [`extraKnownMarketplaces`](/docs/fr/settings-reference#extraknownmarketplaces) |312| Plugins et marketplaces déclarés dans le `.claude/settings.json` de votre dépôt | Non | Une session cloud n'installe pas les plugins qu'un dépôt active sous [`enabledPlugins`](/docs/fr/settings-reference#enabledplugins), y compris ceux des marketplaces qu'il liste sous [`extraKnownMarketplaces`](/docs/fr/settings-reference#extraknownmarketplaces) |

315| Les [paramètres gérés par le serveur](/docs/fr/server-managed-settings) de votre organisation | Oui, sauf dans les sessions [Claude Tag](https://claude.com/docs/claude-tag/overview) | Récupérés des serveurs d'Anthropic quand la session démarre. Consultez [Couverture de surface](/docs/fr/model-config#surface-coverage) pour savoir comment `availableModels` est appliqué dans les sessions cloud. Les paramètres déployés sur votre appareil via MDM ou des fichiers de paramètres gérés ne s'appliquent pas, car la session s'exécute sur une VM gérée par Anthropic ; dans un [environnement auto-hébergé](/docs/fr/self-hosted-environments), les sessions lisent également le fichier de paramètres gérés dans l'image d'exécuteur, selon [comment Claude Code combine les sources gérées](/docs/fr/managed-settings#how-claude-code-combines-managed-sources) |313| Les [paramètres gérés par le serveur](/docs/fr/server-managed-settings) de votre organisation | Oui, sauf dans les sessions [Claude Tag](https://claude.com/docs/claude-tag/overview) | Récupérés des serveurs d'Anthropic quand la session démarre. Consultez [Couverture de surface](/docs/fr/model-config#surface-coverage) pour savoir comment `availableModels` est appliqué dans les sessions cloud. Les paramètres déployés sur votre appareil via MDM ou des fichiers de paramètres gérés ne s'appliquent pas, car la session s'exécute sur une VM gérée par Anthropic ; dans un [environnement auto-hébergé](/docs/fr/self-hosted-environments), les sessions lisent également le fichier de paramètres gérés dans l'image d'exécuteur, selon [comment Claude Code combine les sources gérées](/docs/fr/managed-settings#how-claude-code-combines-managed-sources) |

316| Votre `~/.claude/CLAUDE.md` utilisateur | Non | Vit sur votre machine, pas dans le dépôt |314| Votre `~/.claude/CLAUDE.md` utilisateur | Non | Vit sur votre machine, pas dans le dépôt. Consultez [Ajouter des préférences personnelles sans les commiter dans le dépôt](#add-personal-preferences-without-committing-to-the-repo) |

317| Vos `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` utilisateur | Non | Vivent sur votre machine, pas dans le dépôt. Validez-les dans le répertoire `.claude/` du dépôt à la place. Les sessions cloud chargent automatiquement les compétences que vous activez sur claude.ai |315| Vos `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` utilisateur | Non | Vivent sur votre machine, pas dans le dépôt. Commitez-les dans le répertoire `.claude/` du dépôt à la place. Les sessions cloud chargent automatiquement les skills que vous activez sur claude.ai |

318| Plugins activés seulement dans vos paramètres utilisateur | Non | L'`enabledPlugins` au niveau utilisateur vit dans `~/.claude/settings.json` sur votre machine |316| Plugins activés seulement dans vos paramètres utilisateur | Non | L'`enabledPlugins` de portée utilisateur vit dans `~/.claude/settings.json` sur votre machine |

319| Serveurs MCP que vous avez ajoutés avec `claude mcp add` à la portée locale par défaut ou à la portée utilisateur | Non | Ceux-ci écrivent dans `~/.claude.json` sur votre machine, pas le dépôt. Ajoutez le serveur avec `claude mcp add --scope project`, qui écrit le [`.mcp.json`](/docs/fr/mcp#project-scope) du dépôt, et validez ce fichier. Une session avec un seul dépôt le charge |317| Serveurs MCP que vous avez ajoutés avec `claude mcp add` à la portée locale par défaut ou à la portée utilisateur | Non | Ceux-ci écrivent dans `~/.claude.json` sur votre machine, pas le dépôt. Ajoutez le serveur avec `claude mcp add --scope project`, qui écrit le [`.mcp.json`](/docs/fr/mcp#project-scope) du dépôt, et commitez ce fichier. Une session avec un seul dépôt le charge |

320| Variables de transport dans le bloc `env` de `.claude/settings.json` de votre dépôt, comme `NODE_EXTRA_CA_CERTS` et les [variables de certificat client mTLS](/docs/fr/network-config#mtls-authentication) | Non | L'environnement d'hébergement gère la connexion API de la session, donc Claude Code ignore ces clés et note chaque clé ignorée dans le journal de débogage de la session |318| Variables de transport dans le bloc `env` de `.claude/settings.json` de votre dépôt, comme `NODE_EXTRA_CA_CERTS` et les [variables de certificat client mTLS](/docs/fr/network-config#mtls-authentication) | Non | L'environnement d'hébergement gère la connexion API de la session, donc Claude Code ignore ces clés et note chaque clé ignorée dans le journal de débogage de la session |

321| Clés API et jetons pour les services que Claude appelle | Sur les plans Pro et Max, en tant qu'[identifiants API](#add-api-credentials) | Vous ajoutez la clé une fois sur l'environnement et le proxy d'agent la joint aux requêtes pour les hôtes que vous listez. Une clé que le proxy d'agent [ne peut pas joindre](#requests-that-never-get-the-credential), ou n'importe quelle clé sur un plan Team ou Enterprise, reste dans une variable d'environnement |319| Clés API et jetons pour les services que Claude appelle | Sur les plans Pro et Max, en tant que [secrets réseau](#add-api-credentials) | Vous ajoutez la clé une fois sur l'environnement et le proxy d'agent la joint aux requêtes pour les hôtes que vous listez. Une clé que le proxy d'agent [ne peut pas joindre](#requests-that-never-get-the-credential), ou n'importe quelle clé sur un plan Team ou Enterprise, reste dans une variable d'environnement |

322| Authentification interactive comme AWS SSO | Non | Non supporté. SSO nécessite une connexion basée sur un navigateur qui ne peut pas s'exécuter dans une session cloud |320| Authentification interactive comme AWS SSO | Non | Non supporté. SSO nécessite une connexion basée sur un navigateur qui ne peut pas s'exécuter dans une session cloud |

323 321 

324Pour rendre votre propre configuration disponible dans les sessions cloud, validez-la dans le dépôt.322Pour rendre votre propre configuration disponible dans les sessions cloud, commitez-la dans le dépôt.

325 323 

326Quiconque utilise l'environnement peut lire ses variables d'environnement et son script de configuration. La note de la boîte de dialogue sous **Environment variables** le dit et avertit contre l'ajout de secrets dedans. Sur les plans Pro et Max, stockez une clé que le proxy d'agent peut joindre en tant qu'[identifiant API](#add-api-credentials) à la place.324Quiconque utilise l'environnement peut lire ses variables d'environnement et son script de configuration. La note de la boîte de dialogue sous **Environment variables** le dit et avertit contre l'ajout de secrets dedans. Sur les plans Pro et Max, stockez une clé que le proxy d'agent peut joindre en tant que [secret réseau](#add-api-credentials) à la place.

325 

326<h4 id="add-personal-preferences-without-committing-to-the-repo">

327 Ajouter des préférences personnelles sans les commiter dans le dépôt

328</h4>

329 

330Dans un environnement hébergé par Anthropic, ajoutez un [script de configuration](#setup-scripts) qui écrit `~/.claude/CLAUDE.md` pour les préférences que vous préférez ne pas placer dans un dépôt partagé. Claude Code charge ce fichier en tant qu'[instructions utilisateur](/docs/fr/memory#choose-where-to-put-claude-md-files) dans la session. Cet exemple définit une préférence de message de commit :

331 

332```bash theme={null}

333#!/bin/bash

334mkdir -p ~/.claude

335cat > ~/.claude/CLAUDE.md <<'EOF'

336Use conventional commit messages.

337EOF

338```

339 

340Placez le script sur l'un de vos propres environnements plutôt que sur un [environnement partagé](#organization-shared-environments).

341 

342Exécutez `/context` dans votre prochaine session cloud et vérifiez que `/root/.claude/CLAUDE.md` apparaît sous **Memory files**.

327 343 

328<h3 id="installed-tools">344<h3 id="installed-tools">

329 Outils installés345 Outils installés

330</h3>346</h3>

331 347 

332Les sessions cloud sont livrées avec les runtimes de langage courants, les outils de construction et les bases de données pré-installés. Le tableau ci-dessous résume ce qui est inclus par catégorie.348Les sessions cloud sont livrées avec les runtimes de langage courants, les outils de build et les bases de données pré-installés. Le tableau ci-dessous résume ce qui est inclus par catégorie.

333 349 

334| Catégorie | Inclus |350| Catégorie | Inclus |

335| :- | :- |351| :- | :- |


354Les chaînes d'outils en dehors de cette liste, comme le SDK .NET, ne sont pas pré-installées même quand leurs registres de paquets sont sur la [liste d'autorisation par défaut](#default-allowed-domains). Installez-les avec un [script de configuration](#setup-scripts).370Les chaînes d'outils en dehors de cette liste, comme le SDK .NET, ne sont pas pré-installées même quand leurs registres de paquets sont sur la [liste d'autorisation par défaut](#default-allowed-domains). Installez-les avec un [script de configuration](#setup-scripts).

355 371 

356<h3 id="work-with-github-issues-and-pull-requests">372<h3 id="work-with-github-issues-and-pull-requests">

357 Travaillez avec les problèmes et les demandes de tirage GitHub373 Travaillez avec les issues et les pull requests GitHub

358</h3>374</h3>

359 375 

360Les sessions cloud incluent des outils GitHub intégrés qui permettent à Claude de lire les problèmes, de lister les demandes de tirage, de récupérer les diffs et de publier des commentaires sans aucune configuration. Ces outils s'authentifient via le [proxy GitHub](#github-proxy) en utilisant la méthode que vous avez configurée sous [Options d'authentification GitHub](/docs/fr/claude-code-on-the-web#github-authentication-options), donc votre jeton ne pénètre jamais dans le conteneur.376Les sessions cloud incluent des outils GitHub intégrés qui permettent à Claude de lire les issues, de lister les pull requests, de récupérer les diffs et de publier des commentaires sans aucune configuration. Ces outils s'authentifient via le [proxy GitHub](#github-proxy) en utilisant la méthode que vous avez configurée sous [Options d'authentification GitHub](/docs/fr/claude-code-on-the-web#github-authentication-options), donc votre jeton ne pénètre jamais dans le conteneur.

361 377 

362Vous pouvez définir `GH_TOKEN` ou `GITHUB_TOKEN` vous-même dans les [paramètres d'environnement](#set-environment-variables), ou laisser les deux non définis et laisser le [proxy GitHub](#github-proxy) s'authentifier pour vous :378Vous pouvez définir `GH_TOKEN` ou `GITHUB_TOKEN` vous-même dans les [paramètres d'environnement](#set-environment-variables), ou laisser les deux non définis et laisser le [proxy GitHub](#github-proxy) s'authentifier pour vous :

363 379 

364* Si vous définissez un jeton, il passe au conteneur inchangé, donc vos scripts et le [`gh` CLI](https://cli.github.com) de GitHub l'utilisent directement.380* Si vous définissez un jeton, il passe au conteneur inchangé, donc vos scripts et le [`gh` CLI](https://cli.github.com) de GitHub l'utilisent directement.

365* Si vous ne définissez ni l'un ni l'autre et que le [proxy GitHub](#github-proxy) gère l'authentification pour votre session, les deux variables lisent comme la chaîne d'espace réservé `proxy-injected` dans les commandes que Claude exécute, et le proxy substitue vos vrais identifiants sur les requêtes GitHub sortantes. `gh` fonctionne sans un jeton de votre côté, mais un script qui lit `GITHUB_TOKEN` directement obtient l'espace réservé, pas un jeton utilisable.381* Si vous ne définissez ni l'un ni l'autre et que le [proxy GitHub](#github-proxy) gère l'authentification pour votre session, les deux variables lisent comme la chaîne d'espace réservé `proxy-injected` dans les commandes que Claude exécute, et le proxy substitue vos vrais identifiants sur les requêtes GitHub sortantes. Les appels `gh api` pour les dépôts attachés fonctionnent sans un jeton de votre côté, mais un script qui lit `GITHUB_TOKEN` directement obtient l'espace réservé, pas un jeton utilisable.

366 382 

367Un jeton que vous définissez est une variable d'environnement ordinaire, donc quiconque utilise l'environnement peut le lire ; le chemin du proxy garde l'identifiant hors de la configuration de l'environnement et de la VM de la session.383Un jeton que vous définissez est une variable d'environnement ordinaire, donc quiconque utilise l'environnement peut le lire ; le chemin du proxy garde les identifiants hors de la configuration de l'environnement et de la VM de la session.

368 384 

369Pour vérifier quel cas s'applique à votre session, demandez à Claude d'exécuter `echo $GH_TOKEN`.385Pour vérifier quel cas s'applique à votre session, demandez à Claude d'exécuter `echo $GH_TOKEN`.

370 386 

371Le [`gh` CLI](https://cli.github.com) de GitHub est pré-installé. Si vous avez besoin d'une commande `gh` que les outils intégrés ne couvrent pas, comme `gh release` ou `gh workflow run`, demandez à Claude de l'exécuter. `gh` lit `GH_TOKEN` automatiquement, donc vous n'avez pas besoin d'exécuter `gh auth login`.387Le [`gh` CLI](https://cli.github.com) de GitHub est pré-installé. Si vous avez besoin d'une opération GitHub que les outils intégrés ne couvrent pas, demandez à Claude d'appeler l'API REST avec `gh api`. Les sous-commandes `gh` qui utilisent l'API REST, comme `gh workflow list`, fonctionnent également. Le proxy [rejette les sous-commandes qui utilisent GraphQL](#github-proxy), comme `gh pr` et `gh issue`. `gh` lit `GH_TOKEN` automatiquement, donc vous n'avez pas besoin d'exécuter `gh auth login`.

372 388 

373<h3 id="link-output-back-to-the-session">389<h3 id="link-output-back-to-the-session">

374 Liez la sortie à la session390 Liez la sortie à la session

375</h3>391</h3>

376 392 

377Chaque session cloud a une URL de transcription sur claude.ai, et la session peut lire son propre ID à partir de la variable d'environnement `CLAUDE_CODE_REMOTE_SESSION_ID`. Utilisez ceci pour mettre un lien traçable dans les corps PR, les messages de validation, les publications Slack ou les rapports générés afin qu'un examinateur puisse ouvrir l'exécution qui les a produits.393Chaque session cloud a une URL de transcription sur claude.ai, et la session peut lire son propre ID à partir de la variable d'environnement `CLAUDE_CODE_REMOTE_SESSION_ID`. Utilisez ceci pour mettre un lien traçable dans les corps de PR, les messages de commit, les publications Slack ou les rapports générés afin qu'un examinateur puisse ouvrir l'exécution qui les a produits.

378 394 

379Les validations que Claude crée dans une session cloud incluent une remorque git `Claude-Session: <url>`, et les corps PR incluent l'URL de la session sur sa propre ligne. Pour omettre la remorque et le lien du corps PR, définissez [`attribution.sessionUrl`](/docs/fr/settings-reference#attribution-sessionurl) sur `false`.395Les commits que Claude crée dans une session cloud incluent un trailer git `Claude-Session: <url>`, et les corps de PR incluent l'URL de la session sur sa propre ligne. Pour omettre le trailer et le lien du corps de PR, définissez [`attribution.sessionUrl`](/docs/fr/settings-reference#attribution-sessionurl) sur `false`.

380 396 

381Pour inclure le lien de session dans quelque chose d'autre qu'une validation ou une PR, comme un message Slack que Claude publie ou un fichier de rapport qu'il écrit, demandez à Claude d'exécuter la commande suivante et d'utiliser sa sortie. La commande convertit le préfixe `cse_` dans la valeur de la variable d'environnement au préfixe `session_` que l'URL de transcription attend :397Pour inclure le lien de session dans quelque chose d'autre qu'un commit ou une PR, comme un message Slack que Claude publie ou un fichier de rapport qu'il écrit, demandez à Claude d'exécuter la commande suivante et d'utiliser sa sortie. La commande convertit le préfixe `cse_` dans la valeur de la variable d'environnement au préfixe `session_` que l'URL de transcription attend :

382 398 

383```bash theme={null}399```bash theme={null}

384echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"400echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"


388 Exécutez des tests, démarrez des services et ajoutez des paquets404 Exécutez des tests, démarrez des services et ajoutez des paquets

389</h3>405</h3>

390 406 

391Vous n'avez pas d'accès shell à la VM de la session. Claude exécute chaque commande pour vous, donc formulez les tâches de cette section comme des demandes dans votre invite.407Vous n'avez pas d'accès shell à la VM de la session. Claude exécute chaque commande pour vous, donc formulez les tâches de cette section comme des demandes dans votre prompt.

392 408 

393<h4 id="run-tests">409<h4 id="run-tests">

394 Exécutez des tests410 Exécutez des tests

395</h4>411</h4>

396 412 

397Claude exécute les tests dans le cadre du travail sur une tâche. Demandez-le dans votre invite, comme « corriger les tests échoués dans `tests/` » ou « exécuter pytest après chaque modification ». Les exécuteurs de tests qui viennent avec les [chaînes d'outils pré-installées](#installed-tools), comme pytest et cargo test, fonctionnent sans configuration supplémentaire. Un exécuteur que votre projet déclare comme dépendance, comme jest, s'installe avec vos dépendances.413Claude exécute les tests dans le cadre du travail sur une tâche. Demandez-le dans votre prompt, comme « corriger les tests échoués dans `tests/` » ou « exécuter pytest après chaque modification ». Les exécuteurs de tests qui viennent avec les [chaînes d'outils pré-installées](#installed-tools), comme pytest et cargo test, fonctionnent sans configuration supplémentaire. Un exécuteur que votre projet déclare comme dépendance, comme jest, s'installe avec vos dépendances.

398 414 

399<h4 id="start-services">415<h4 id="start-services">

400 Démarrez des services416 Démarrez des services


412 428 

413Docker est disponible pour exécuter des services conteneurisés. Demandez à Claude d'exécuter `docker compose up` pour démarrer les services de votre projet. L'accès réseau pour extraire les images suit le [niveau d'accès](#access-levels) de votre environnement, et les [défauts Trusted](#default-allowed-domains) incluent Docker Hub et d'autres registres courants.429Docker est disponible pour exécuter des services conteneurisés. Demandez à Claude d'exécuter `docker compose up` pour démarrer les services de votre projet. L'accès réseau pour extraire les images suit le [niveau d'accès](#access-levels) de votre environnement, et les [défauts Trusted](#default-allowed-domains) incluent Docker Hub et d'autres registres courants.

414 430 

415Si vos images sont grandes ou lentes à extraire, ajoutez `docker compose pull` ou `docker compose build` à votre [script de configuration](#setup-scripts). Le [cache d'environnement](#environment-caching) conserve les images extraites, donc chaque nouvelle session les a sur le disque. Le cache stocke seulement les fichiers, pas les processus en cours d'exécution, donc Claude démarre toujours les conteneurs chaque session.431Si vos images sont grandes ou lentes à extraire, ajoutez `docker compose pull` ou `docker compose build` à votre [script de configuration](#setup-scripts). Le [cache d'environnement](#environment-caching) conserve les images extraites, donc chaque nouvelle session les a sur le disque. Le cache stocke seulement les fichiers, pas les processus en cours d'exécution, donc Claude démarre toujours les conteneurs à chaque session.

416 432 

417<h4 id="add-packages">433<h4 id="add-packages">

418 Ajoutez des paquets434 Ajoutez des paquets


430* 16 Go de RAM446* 16 Go de RAM

431* 30 Go de disque447* 30 Go de disque

432 448 

433La VM peut arrêter les tâches qui ont besoin de beaucoup plus de mémoire, comme les gros travaux de construction ou les tests gourmands en mémoire. Pour les charges de travail au-delà de ces limites, utilisez [Remote Control](/docs/fr/remote-control) pour exécuter Claude Code sur votre propre matériel, ou exécutez les sessions cloud dans un [environnement auto-hébergé](/docs/fr/self-hosted-environments) sur le calcul que votre organisation exploite.449La VM peut arrêter les tâches qui ont besoin de beaucoup plus de mémoire vive, comme les gros jobs de build ou les tests gourmands en mémoire. Pour les charges de travail au-delà de ces limites, utilisez [Remote Control](/docs/fr/remote-control) pour exécuter Claude Code sur votre propre matériel, ou exécutez les sessions cloud dans un [environnement auto-hébergé](/docs/fr/self-hosted-environments) sur le calcul que votre organisation exploite.

434 450 

435<h3 id="time-limits">451<h3 id="time-limits">

436 Limites de temps452 Limites de temps

437</h3>453</h3>

438 454 

439Dans les environnements hébergés par Anthropic, ces limites de temps s'appliquent aux travaux de longue durée dans une session cloud, comme une construction, une installation ou une exécution de test. Chaque entrée renvoie à la section qui définit la limite.455Dans les environnements hébergés par Anthropic, ces limites de temps s'appliquent aux travaux de longue durée dans une session cloud, comme un build, une installation ou une exécution de test. Chaque entrée renvoie à la section qui définit la limite.

440 456 

441* **Commandes que Claude exécute** : un environnement cloud ne définit pas son propre délai d'expiration de commande, donc les défauts de l'outil Bash s'appliquent. Claude attend 2 minutes pour une commande par défaut et peut demander jusqu'à 10 minutes.457* **Commandes que Claude exécute** : un environnement cloud ne définit pas son propre délai d'expiration de commande, donc les défauts de l'outil Bash s'appliquent. Claude attend 2 minutes pour une commande au premier plan par défaut et peut demander jusqu'à 10 minutes.

442 458 

443 Quand une commande atteint son [délai d'expiration](/docs/fr/tools-reference#timeout-and-output-limits), Claude Code [la déplace en arrière-plan](/docs/fr/tools-reference#foreground-commands-that-move-to-the-background) au lieu de l'arrêter, sauf si la commande commence par `sleep`. Une commande déplacée de cette façon peut continuer à s'exécuter pendant jusqu'à 30 minutes supplémentaires avant que Claude Code l'arrête à son [délai d'expiration en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands). Définir `BASH_DEFAULT_TIMEOUT_MS` au-dessus de `1800000` millisecondes allonge cette limite ainsi que le défaut de premier plan.459 Quand une commande atteint son [délai d'expiration](/docs/fr/tools-reference#timeout-and-output-limits), Claude Code [la déplace en arrière-plan](/docs/fr/tools-reference#foreground-commands-that-move-to-the-background) au lieu de l'arrêter, sauf si la commande commence par `sleep`. Une commande déplacée de cette façon peut continuer à s'exécuter pendant jusqu'à 30 minutes supplémentaires avant que Claude Code l'arrête à sa [limite de temps en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands). Définir `BASH_DEFAULT_TIMEOUT_MS` au-dessus de `1800000` millisecondes allonge cette limite ainsi que le défaut de premier plan.

444* **Crochets SessionStart** : Claude Code annule un crochet `command` après 600 secondes sauf si vous définissez [`timeout`](/docs/fr/hooks#common-fields), en secondes, sur l'entrée du crochet. Claude Code n'applique pas le délai d'expiration sur un crochet que vous exécutez avec [`async: true`](/docs/fr/hooks#run-hooks-in-the-background).460* **Hooks SessionStart** : Claude Code annule un hook `command` après 600 secondes sauf si vous définissez [`timeout`](/docs/fr/hooks#common-fields), en secondes, sur l'entrée du hook. Claude Code n'applique pas le délai d'expiration sur un hook que vous exécutez avec [`async: true`](/docs/fr/hooks#run-hooks-in-the-background).

445* **Script de configuration** : un script qui prend plus que environ cinq minutes n'est pas mis en cache. [Exigences du script](#script-requirements) couvre comment rester en dessous de cela.461* **Script de configuration** : un script qui prend plus d'environ cinq minutes n'est pas mis en cache. [Exigences du script](#script-requirements) couvre comment rester en dessous de cela.

446* **Sessions inactives** : après quelques minutes sans activité, la VM d'une session s'arrête avec ses fichiers sauvegardés, et une VM arrêtée peut être réclamée ultérieurement. [Définir les variables d'environnement](#set-environment-variables) décrit ce qu'une session récupère dans chaque cas, et [Environnement expiré](/docs/fr/claude-code-on-the-web#environment-expired) couvre comment rouvrir une session dont la VM a été réclamée.462* **Sessions inactives** : après quelques minutes sans activité, la VM d'une session se met en pause avec ses fichiers sauvegardés, et une VM en pause peut être réclamée ultérieurement. [Définir les variables d'environnement](#set-environment-variables) décrit ce qu'une session récupère dans chaque cas, et [Environnement expiré](/docs/fr/claude-code-on-the-web#environment-expired) couvre comment rouvrir une session dont la VM a été réclamée.

447 463 

448Pour augmenter les délais d'expiration de commande pour les sessions d'un environnement, ajoutez [`BASH_DEFAULT_TIMEOUT_MS` et `BASH_MAX_TIMEOUT_MS`](/docs/fr/env-vars#variables) à ses [variables d'environnement](#set-environment-variables). Les deux prennent des millisecondes. Par exemple, `BASH_DEFAULT_TIMEOUT_MS=600000` rend 10 minutes le défaut.464Pour augmenter les délais d'expiration de commande pour les sessions d'un environnement, ajoutez [`BASH_DEFAULT_TIMEOUT_MS` et `BASH_MAX_TIMEOUT_MS`](/docs/fr/env-vars#variables) à ses [variables d'environnement](#set-environment-variables). Les deux prennent des millisecondes. Par exemple, `BASH_DEFAULT_TIMEOUT_MS=600000` rend 10 minutes le défaut.

449 465 

code-review.md +1 −1

Details

385 Ajuster l'effort et les arguments385 Ajuster l'effort et les arguments

386</h3>386</h3>

387 387 

388Passez un [niveau d'effort](/docs/fr/model-config#adjust-effort-level) pour échanger la couverture contre la confiance. À `low` et `medium`, la révision signale uniquement les résultats dont elle est la plus confiante, vous voyez donc moins de faux positifs ; `high` à `max` élargissent la couverture et peuvent inclure des résultats dont la révision est moins sûre.388Passez un [niveau d'effort](/docs/fr/model-config#adjust-effort-level) pour échanger la couverture contre la confiance. À `low`, la revue signale les résultats dont elle est la plus sûre, vous voyez donc moins de faux positifs. De `medium` à `max`, la revue élargit la couverture.

389 389 

390Quand vous ne tapez pas de niveau, la révision réutilise le dernier niveau de `low` à `max` que vous avez tapé, même dans une session antérieure, et Claude Code affiche un avis tel que `Reusing high effort, the level you typed last time`. Tapez un niveau, comme `/code-review high`, pour changer ce que les exécutions ultérieures réutilisent ; un niveau que vous passez dans une exécution `-p` non interactive ne le met pas à jour. `ultra` ne met à jour ni n'utilise le niveau mémorisé. Si vous n'avez jamais tapé de niveau, la révision utilise l'effort actuel de la session. Avant v2.1.223, un `/code-review` sans niveau utilisait toujours l'effort actuel de la session.390Quand vous ne tapez pas de niveau, la révision réutilise le dernier niveau de `low` à `max` que vous avez tapé, même dans une session antérieure, et Claude Code affiche un avis tel que `Reusing high effort, the level you typed last time`. Tapez un niveau, comme `/code-review high`, pour changer ce que les exécutions ultérieures réutilisent ; un niveau que vous passez dans une exécution `-p` non interactive ne le met pas à jour. `ultra` ne met à jour ni n'utilise le niveau mémorisé. Si vous n'avez jamais tapé de niveau, la révision utilise l'effort actuel de la session. Avant v2.1.223, un `/code-review` sans niveau utilisait toujours l'effort actuel de la session.

391 391 

context-window.md +10 −10

Details

1586 1586 

1587La session parcourt un flux réaliste avec des comptages de jetons représentatifs :1587La session parcourt un flux réaliste avec des comptages de jetons représentatifs :

1588 1588 

1589* **Avant que vous ne tapiez quoi que ce soit** : CLAUDE.md, la mémoire automatique, les noms d'outils MCP, et les descriptions de compétences se chargent tous dans le contexte. [Les fichiers AGENTS.md](/docs/fr/memory#agents-md) peuvent également se charger, seuls ou aux côtés de CLAUDE.md. Votre propre configuration peut ajouter plus ici, comme un [style de sortie](/docs/fr/output-styles) ou du texte provenant de [`--append-system-prompt`](/docs/fr/cli-reference).1589* **Avant que vous ne tapiez quoi que ce soit** : CLAUDE.md, la mémoire automatique, les noms d'outils MCP, et les descriptions de skills se chargent tous dans le contexte. [Les fichiers AGENTS.md](/docs/fr/memory#agents-md) peuvent se charger à la place de CLAUDE.md. Votre propre configuration peut ajouter plus ici, comme un [style de sortie](/docs/fr/output-styles) ou du texte provenant de [`--append-system-prompt`](/docs/fr/cli-reference).

1590* **Pendant que Claude travaille** : chaque lecture de fichier s'ajoute au contexte, les [règles délimitées par chemin](/docs/fr/memory#path-specific-rules) se chargent automatiquement aux côtés des fichiers correspondants, et un [hook PostToolUse](/docs/fr/hooks-guide) s'exécute après chaque modification.1590* **Pendant que Claude travaille** : chaque lecture de fichier s'ajoute au contexte, les [règles délimitées par chemin](/docs/fr/memory#path-specific-rules) se chargent automatiquement aux côtés des fichiers correspondants, et un [hook PostToolUse](/docs/fr/hooks-guide) s'exécute après chaque modification.

1591* **L'invite de suivi** : un [sous-agent](/docs/fr/sub-agents) gère la recherche dans sa propre fenêtre de contexte séparée, de sorte que les lectures de fichiers volumineux restent en dehors de la vôtre. Seul le résumé et une petite remorque de métadonnées reviennent.1591* **L'invite de suivi** : un [sous-agent](/docs/fr/sub-agents) gère la recherche dans sa propre fenêtre de contexte séparée, de sorte que les lectures de fichiers volumineux restent en dehors de la vôtre. Seul le résumé et une petite remorque de métadonnées reviennent.

1592* **À la fin de la présentation** : vous exécutez `/compact`, qui remplace la conversation par un résumé structuré. La plupart du contenu de démarrage se recharge automatiquement ; le tableau ci-dessous montre ce qui se passe pour chaque mécanisme.1592* **À la fin de la présentation** : vous exécutez `/compact`, qui remplace la conversation par un résumé structuré. La plupart du contenu de démarrage se recharge automatiquement ; le tableau ci-dessous montre ce qui se passe pour chaque mécanisme.


1595 Ce qui survit à la compaction1595 Ce qui survit à la compaction

1596</h2>1596</h2>

1597 1597 

1598Quand une longue session se compacte, Claude Code résume l'historique de la conversation pour l'adapter à la fenêtre de contexte. À partir de la v2.1.198, la demande de résumé hérite de la configuration de [réflexion étendue](/docs/fr/model-config#extended-thinking) de votre session, de sorte qu'elle raisonne avec la réflexion activée quand votre session l'a activée et reste désactivée sinon. La réflexion affecte uniquement la façon dont le résumé est produit ; vos paramètres de session restent inchangés après. Ce qui arrive à chaque type de contenu dépend de la façon dont il a été chargé :1598Quand une longue session se compacte, Claude Code résume l'historique de la conversation pour l'adapter à la fenêtre de contexte. À partir de la v2.1.198, la requête de résumé hérite de la configuration de [réflexion étendue](/docs/fr/model-config#extended-thinking) de votre session, de sorte qu'elle raisonne avec la réflexion activée quand votre session l'a activée et reste désactivée sinon. La réflexion affecte uniquement la façon dont le résumé est produit ; vos paramètres de session restent inchangés après. Ce qui arrive à chaque type de contenu dépend de la façon dont il a été chargé :

1599 1599 

1600| Mécanisme | Après compaction |1600| Mécanisme | Après compaction |

1601| :- | :- |1601| :- | :- |

1602| Invite système et style de sortie | Les deux s'appliquent toujours |1602| Prompt système et style de sortie | Les deux s'appliquent toujours |

1603| CLAUDE.md à la racine du projet et règles sans portée | Réinjectés depuis le disque |1603| CLAUDE.md à la racine du projet et règles sans portée | Réinjectés depuis le disque |

1604| Mémoire automatique | Réinjectés depuis le disque |1604| Mémoire automatique | Réinjectée depuis le disque |

1605| [Snapshot du statut Git](/docs/fr/settings-reference#includegitinstructions) | Claude Code en lit un nouveau depuis votre référentiel |1605| [Snapshot du statut Git](/docs/fr/settings-reference#includegitinstructions) | Claude Code en lit un nouveau depuis votre dépôt |

1606| Le plan que Claude a écrit en [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) | Réinjecté depuis le disque |1606| Le plan que Claude a écrit en [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) | Réinjecté depuis le disque |

1607| Règles avec frontmatter `paths:` | Claude Code les recharge [à la demande](/docs/fr/memory#path-specific-rules) |1607| Règles avec frontmatter `paths:` | Claude Code les recharge [à la demande](/docs/fr/memory#path-specific-rules) |

1608| CLAUDE.md imbriqué dans les sous-répertoires | Claude Code les recharge [à la demande](/docs/fr/memory#how-claude-md-files-load) |1608| CLAUDE.md imbriqué dans les sous-répertoires | Claude Code les recharge [à la demande](/docs/fr/memory#how-claude-md-files-load) |

1609| Fichiers que Claude a lus ou modifiés | Claude Code relit jusqu'à cinq, les plus récemment modifiés en premier |1609| Fichiers que Claude a lus ou modifiés | Claude Code relit jusqu'à cinq, les plus récemment modifiés en premier |

1610| Invoked skill bodies | Réinjectés, limités à 5 000 jetons par compétence et 25 000 jetons au total ; les plus anciens sont supprimés en premier |1610| Corps des skills invoqués | Réinjectés, limités à 5 000 tokens par skill et 25 000 tokens au total ; les plus anciens sont supprimés en premier |

1611| [Commandes d'arrière-plan](/docs/fr/interactive-mode#background-bash-commands) et [sous-agents](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) d'arrière-plan | Continuent de s'exécuter. Claude Code rappelle à Claude lesquels sont encore en cours d'exécution pour qu'il ne démarre pas un doublon |1611| [Commandes d'arrière-plan](/docs/fr/interactive-mode#background-bash-commands) et [sous-agents](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) d'arrière-plan | Continuent de s'exécuter. Claude Code rappelle à Claude lesquels sont encore en cours d'exécution pour qu'il ne démarre pas un doublon |

1612| Contexte que les hooks ont ajouté plus tôt | Résumé avec le reste de la conversation |1612| Contexte que les hooks ont ajouté plus tôt | Résumé avec le reste de la conversation |

1613| [Hooks SessionStart](/docs/fr/hooks-guide#re-inject-context-after-compaction) qui correspondent à la source `compact` | Claude Code les exécute et ajoute leur sortie au contexte compacté |1613| [Hooks SessionStart](/docs/fr/hooks-guide#re-inject-context-after-compaction) qui correspondent à la source `compact` | Claude Code les exécute et ajoute leur sortie au contexte compacté |

1614 1614 

1615Immédiatement après la compaction, Claude Code relit jusqu'à cinq des fichiers que Claude a lus ou modifiés dans la session, en choisissant ceux modifiés les plus récemment. Un fichier de plus de 5 000 jetons revient comme une référence de chemin sans son contenu, affiché comme `Referenced file` au lieu de `Read`.1615Immédiatement après la compaction, Claude Code relit jusqu'à cinq des fichiers que Claude a lus ou modifiés dans la session, en choisissant ceux modifiés les plus récemment. Un fichier de plus de 5 000 tokens revient comme une référence de chemin sans son contenu, affiché comme `Referenced file` au lieu de `Read`.

1616 1616 

1617Les règles délimitées par chemin et les fichiers CLAUDE.md imbriqués se chargent dans l'historique des messages quand leur fichier déclencheur est lu, de sorte que la compaction les résume avec tout le reste. Si une règle doit persister à travers la compaction, supprimez le frontmatter `paths:` ou déplacez-le vers le CLAUDE.md à la racine du projet.1617Les règles délimitées par chemin et les fichiers CLAUDE.md imbriqués se chargent dans l'historique des messages quand Claude lit, écrit ou modifie leur fichier déclencheur, de sorte que la compaction les résume avec tout le reste. Si une règle doit persister à travers la compaction, supprimez le frontmatter `paths:` ou déplacez-la vers le CLAUDE.md à la racine du projet.

1618 1618 

1619Les corps de compétences sont réinjectés après compaction, mais les grandes compétences sont tronquées pour s'adapter au plafond par compétence, et les compétences invoquées les plus anciennes sont supprimées une fois le budget total dépassé. La troncature conserve le début du fichier, donc mettez les instructions les plus importantes près du haut de `SKILL.md`.1619Les corps des skills sont réinjectés après compaction, mais les skills volumineux sont tronqués pour s'adapter au plafond par skill, et les skills invoqués les plus anciens sont supprimés une fois le budget total dépassé. La troncature conserve le début du fichier, donc mettez les instructions les plus importantes près du haut de `SKILL.md`.

1620 1620 

1621<h2 id="when-your-context-fills-up">1621<h2 id="when-your-context-fills-up">

1622 Quand votre contexte se remplit1622 Quand votre contexte se remplit


1632* **Effacer entre les tâches** : exécutez `/clear` quand vous passez à un travail non lié. L'ancienne conversation encombre les fichiers dont vous avez besoin ensuite et coûte des jetons à chaque message.1632* **Effacer entre les tâches** : exécutez `/clear` quand vous passez à un travail non lié. L'ancienne conversation encombre les fichiers dont vous avez besoin ensuite et coûte des jetons à chaque message.

1633* **Déléguer les lectures volumineuses** : envoyez la recherche à un [sous-agent](/docs/fr/sub-agents) de sorte que le contenu du fichier reste dans sa fenêtre de contexte, pas dans la vôtre.1633* **Déléguer les lectures volumineuses** : envoyez la recherche à un [sous-agent](/docs/fr/sub-agents) de sorte que le contenu du fichier reste dans sa fenêtre de contexte, pas dans la vôtre.

1634 1634 

1635Si vous avez besoin d'une fenêtre plus grande plutôt qu'une conversation plus petite, les modèles Fable, Sonnet 5 et versions ultérieures, Opus 4.6 et versions ultérieures, et Sonnet 4.6 supportent une fenêtre de contexte de 1 million de jetons. Consultez [Contexte étendu](/docs/fr/model-config#extended-context) pour la disponibilité par plan et comment sélectionner une variante de modèle `[1m]`. La compaction fonctionne de la même manière à la limite plus grande.1635Si vous avez besoin d'une fenêtre plus grande plutôt qu'une conversation plus petite, les modèles Fable, Sonnet 5 et versions ultérieures, Haiku 5.5, Opus 4.6 et versions ultérieures, et Sonnet 4.6 supportent une fenêtre de contexte de 1 million de tokens. Consultez [Contexte étendu](/docs/fr/model-config#extended-context) pour la disponibilité par plan et comment sélectionner une variante de modèle `[1m]`. La compaction fonctionne de la même manière à la limite plus grande.

1636 1636 

1637Sonnet 5.5 et Sonnet 5 s'exécutent avec la fenêtre de contexte 1M et n'ont pas de variante `[1m]` à sélectionner. Consultez [Fenêtre de contexte Sonnet 5.5 et Sonnet 5](/docs/fr/model-config#sonnet-5-5-and-sonnet-5-context-window) pour leurs seuils de compaction automatique, et [la fenêtre de contexte derrière une passerelle](/docs/fr/model-config#context-window-behind-a-gateway) pour savoir comment Claude Code dimensionne la fenêtre quand vous définissez `ANTHROPIC_BASE_URL` sur une [passerelle LLM](/docs/fr/llm-gateway).1637Sonnet 5.5 et Sonnet 5 s'exécutent avec la fenêtre de contexte 1M et n'ont pas de variante `[1m]` à sélectionner. Consultez [Fenêtre de contexte Sonnet 5.5 et Sonnet 5](/docs/fr/model-config#sonnet-5-5-and-sonnet-5-context-window) pour leurs seuils de compaction automatique, et [la fenêtre de contexte derrière une passerelle](/docs/fr/model-config#context-window-behind-a-gateway) pour savoir comment Claude Code dimensionne la fenêtre quand vous définissez `ANTHROPIC_BASE_URL` sur une [passerelle LLM](/docs/fr/llm-gateway).

1638 1638 

costs.md +18 −18

Details

252 Réduire l'utilisation des tokens252 Réduire l'utilisation des tokens

253</h2>253</h2>

254 254 

255Les coûts des tokens augmentent avec la taille du contexte : plus Claude traite de contexte, plus vous utilisez de tokens. Claude Code optimise automatiquement les coûts grâce à la [mise en cache des invites](/docs/fr/prompt-caching), qui réduit les coûts pour le contenu répété comme les invites système, et à la compaction automatique, qui résume l'historique des conversations en approchant les limites du contexte.255Les coûts des tokens augmentent avec la taille du contexte : plus Claude traite de contexte, plus vous utilisez de tokens. Claude Code optimise automatiquement les coûts grâce au [prompt caching](/docs/fr/prompt-caching), qui réduit les coûts pour le contenu répété comme les prompts système, et à la compaction automatique, qui résume l'historique des conversations en approchant les limites du contexte.

256 256 

257Les stratégies suivantes vous aident à maintenir le contexte petit et à réduire les coûts par message.257Les stratégies suivantes vous aident à maintenir le contexte petit et à réduire les coûts par message.

258 258 


260 Gérer le contexte de manière proactive260 Gérer le contexte de manière proactive

261</h3>261</h3>

262 262 

263Utilisez `/usage` pour vérifier votre utilisation actuelle des tokens, ou [configurez votre ligne d'état](/docs/fr/statusline#context-window-usage) pour l'afficher en continu.263Utilisez `/usage` pour vérifier votre utilisation actuelle des tokens, ou [configurez votre barre de statut](/docs/fr/statusline#context-window-usage) pour l'afficher en continu.

264 264 

265* **Effacer entre les tâches** : Utilisez `/clear` pour recommencer à zéro lorsque vous passez à un travail non lié. Le contexte obsolète gaspille des tokens à chaque message suivant. Utilisez `/rename` avant d'effacer pour pouvoir retrouver la session plus tard, puis `/resume` pour y revenir.265* **Effacer entre les tâches** : Utilisez `/clear` pour recommencer à zéro lorsque vous passez à un travail non lié. Le contexte obsolète gaspille des tokens à chaque message suivant. Utilisez `/rename` avant d'effacer pour pouvoir retrouver la session plus tard, puis `/resume` pour y revenir.

266* **Ajouter des instructions de compaction personnalisées** : `/compact Focus on code samples and API usage` indique à Claude ce qu'il faut préserver lors de la résumé.266* **Ajouter des instructions de compaction personnalisées** : `/compact Focus on code samples and API usage` indique à Claude ce qu'il faut préserver lors du résumé.

267 267 

268Vous pouvez également personnaliser le comportement de compaction dans votre fichier CLAUDE.md à la racine de votre projet :268Vous pouvez également personnaliser le comportement de compaction dans votre fichier CLAUDE.md à la racine de votre projet :

269 269 


277 Choisir le bon modèle277 Choisir le bon modèle

278</h3>278</h3>

279 279 

280Sonnet gère bien la plupart des tâches de codage et coûte moins cher qu'Opus. Réservez Opus pour les décisions architecturales complexes ou le raisonnement multi-étapes. Utilisez `/model` pour changer de modèle en cours de session, ou définissez une valeur par défaut dans `/config`. Un changement vers Opus s'applique également aux [subagents qui héritent du modèle de votre session](/docs/fr/model-config#setting-your-model). Pour les tâches simples de subagent, spécifiez `model: haiku` dans votre [configuration de subagent](/docs/fr/sub-agents#choose-a-model).280Sonnet gère bien la plupart des tâches de codage et coûte moins cher qu'Opus. Réservez Opus pour les décisions architecturales complexes ou le raisonnement multi-étapes. Utilisez `/model` pour changer de modèle en cours de session, ou définissez une valeur par défaut dans `/config`. Un changement vers Opus s'applique également aux [sous-agents qui héritent du modèle de votre session](/docs/fr/model-config#setting-your-model). Pour les tâches simples de sous-agent, spécifiez `model: haiku` dans votre [configuration de sous-agent](/docs/fr/sub-agents#choose-a-model).

281 281 

282<h3 id="reduce-mcp-server-overhead">282<h3 id="reduce-mcp-server-overhead">

283 Réduire la surcharge des serveurs MCP283 Réduire la surcharge des serveurs MCP


285 285 

286Les définitions d'outils MCP sont [reportées par défaut](/docs/fr/mcp#scale-with-mcp-tool-search), donc seuls les noms d'outils et les instructions du serveur entrent en contexte jusqu'à ce que Claude utilise un outil spécifique. Exécutez `/context` pour voir ce qui consomme de l'espace.286Les définitions d'outils MCP sont [reportées par défaut](/docs/fr/mcp#scale-with-mcp-tool-search), donc seuls les noms d'outils et les instructions du serveur entrent en contexte jusqu'à ce que Claude utilise un outil spécifique. Exécutez `/context` pour voir ce qui consomme de l'espace.

287 287 

288* **Préférez les outils CLI lorsqu'ils sont disponibles** : Les outils comme `gh`, `aws`, `gcloud` et `sentry-cli` sont plus efficaces en contexte que les serveurs MCP car ils n'ajoutent pas de liste d'outils par outil. Claude peut exécuter les commandes CLI directement.288* **Préférez les outils CLI lorsqu'ils sont disponibles** : Les outils comme `gh`, `aws`, `gcloud` et `sentry-cli` restent plus efficaces en contexte que les serveurs MCP car ils n'ajoutent pas de liste d'outils par outil. Claude peut exécuter les commandes CLI directement.

289* **Désactiver les serveurs inutilisés** : Exécutez `/mcp` pour voir les serveurs configurés et désactiver ceux que vous n'utilisez pas activement.289* **Désactiver les serveurs inutilisés** : Exécutez `/mcp` pour voir les serveurs configurés et désactiver ceux que vous n'utilisez pas activement.

290 290 

291<h3 id="install-code-intelligence-plugins-for-typed-languages">291<h3 id="install-code-intelligence-plugins-for-typed-languages">


298 Déléguer le traitement aux hooks et aux skills298 Déléguer le traitement aux hooks et aux skills

299</h3>299</h3>

300 300 

301Les [hooks](/docs/fr/hooks) personnalisés peuvent prétraiter les données avant que Claude ne les voie. Au lieu que Claude lise un fichier journal de 10 000 lignes pour trouver les erreurs, un hook peut rechercher `ERROR` et retourner uniquement les lignes correspondantes, réduisant le contexte de dizaines de milliers de tokens à des centaines.301Les [hooks](/docs/fr/hooks) personnalisés peuvent prétraiter les données avant que Claude ne les voie. Au lieu que Claude lise un fichier de log de 10 000 lignes pour trouver les erreurs, un hook peut rechercher `ERROR` et retourner uniquement les lignes correspondantes, réduisant le contexte de dizaines de milliers de tokens à des centaines.

302 302 

303Une [skill](/docs/fr/skills) peut donner à Claude des connaissances de domaine pour qu'il n'ait pas à explorer. Par exemple, une skill « codebase-overview » pourrait décrire l'architecture de votre projet, les répertoires clés et les conventions de nommage. Lorsque Claude invoque la skill, il obtient ce contexte immédiatement au lieu de dépenser des tokens pour lire plusieurs fichiers pour comprendre la structure.303Un [skill](/docs/fr/skills) peut donner à Claude des connaissances de domaine pour qu'il n'ait pas à explorer. Par exemple, un skill « codebase-overview » pourrait décrire l'architecture de votre projet, les répertoires clés et les conventions de nommage. Lorsque Claude invoque le skill, il obtient ce contexte immédiatement au lieu de dépenser des tokens pour lire plusieurs fichiers pour comprendre la structure.

304 304 

305Par exemple, ce hook PreToolUse filtre la sortie des tests pour afficher uniquement les échecs :305Par exemple, ce hook PreToolUse filtre la sortie des tests pour afficher uniquement les échecs :

306 306 


347 </Tab>347 </Tab>

348</Tabs>348</Tabs>

349 349 

350Pour vérifier la configuration, exécutez `/hooks` et vérifiez que le hook apparaît sous PreToolUse. Vous pouvez également démarrer Claude Code avec `claude --debug-file ./claude-debug.txt` et demander à Claude d'exécuter `npm test`. Lorsque le hook réécrit la commande, ce fichier journal contient une ligne `modified tool input keys` listant `command` et les autres champs d'entrée Bash.350Pour vérifier la configuration, exécutez `/hooks` et vérifiez que le hook apparaît sous PreToolUse. Vous pouvez également démarrer Claude Code avec `claude --debug-file ./claude-debug.txt` et demander à Claude d'exécuter `npm test`. Lorsque le hook réécrit la commande, ce fichier de log contient une ligne `modified tool input keys` listant `command` et les autres champs d'entrée Bash.

351 351 

352<h3 id="move-instructions-from-claude-md-to-skills">352<h3 id="move-instructions-from-claude-md-to-skills">

353 Déplacer les instructions de CLAUDE.md vers les skills353 Déplacer les instructions de CLAUDE.md vers les skills

354</h3>354</h3>

355 355 

356Votre fichier [CLAUDE.md](/docs/fr/memory) est chargé en contexte au démarrage de la session. S'il contient des instructions détaillées pour des flux de travail spécifiques (comme les révisions de PR ou les migrations de base de données), ces tokens sont présents même lorsque vous faites un travail non lié. Les [skills](/docs/fr/skills) se chargent à la demande uniquement lorsqu'elles sont invoquées, donc déplacer les instructions spécialisées dans les skills maintient votre contexte de base plus petit. Visez à garder CLAUDE.md en dessous de 200 lignes en incluant uniquement les éléments essentiels.356Votre fichier [CLAUDE.md](/docs/fr/memory) est chargé en contexte au démarrage de la session. S'il contient des instructions détaillées pour des workflows spécifiques (comme les révisions de PR ou les migrations de base de données), ces tokens sont présents même lorsque vous faites un travail non lié. Les [skills](/docs/fr/skills) se chargent à la demande uniquement lorsqu'ils sont invoqués, donc déplacer les instructions spécialisées dans les skills maintient votre contexte de base plus petit. Visez à garder CLAUDE.md en dessous de 200 lignes en incluant uniquement les éléments essentiels.

357 357 

358<h3 id="adjust-extended-thinking">358<h3 id="adjust-extended-thinking">

359 Ajuster la réflexion étendue359 Ajuster la réflexion étendue


361 361 

362La réflexion étendue est activée par défaut car elle améliore considérablement les performances sur les tâches complexes de planification et de raisonnement. Les tokens de réflexion sont facturés comme des tokens de sortie, et le budget par défaut peut être des dizaines de milliers de tokens par requête selon le modèle.362La réflexion étendue est activée par défaut car elle améliore considérablement les performances sur les tâches complexes de planification et de raisonnement. Les tokens de réflexion sont facturés comme des tokens de sortie, et le budget par défaut peut être des dizaines de milliers de tokens par requête selon le modèle.

363 363 

364Pour les tâches plus simples où un raisonnement approfondi n'est pas nécessaire, vous pouvez réduire les coûts en abaissant le [niveau d'effort](/docs/fr/model-config#adjust-effort-level) avec `/effort` ou dans `/model`, ou en désactivant la réflexion dans `/config`. Vous ne pouvez pas désactiver la réflexion sur les modèles Opus 5.5, Sonnet 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue.364Pour les tâches plus simples où un raisonnement approfondi n'est pas nécessaire, vous pouvez réduire les coûts en abaissant le [niveau d'effort](/docs/fr/model-config#adjust-effort-level) avec `/effort` ou dans `/model`, ou en désactivant la réflexion dans `/config`. Vous ne pouvez pas désactiver la réflexion sur Opus 5.5, Sonnet 5.5, Haiku 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue.

365 365 

366Sur les modèles avec un [budget de réflexion fixe](/docs/fr/model-config#adaptive-reasoning-and-fixed-thinking-budgets), vous pouvez également abaisser le budget en définissant la [variable d'environnement](/docs/fr/env-vars) `MAX_THINKING_TOKENS`, par exemple `MAX_THINKING_TOKENS=8000`. Les modèles de raisonnement adaptatif ignorent les budgets non nuls, donc utilisez plutôt les niveaux d'effort.366Sur les modèles avec un [budget de réflexion fixe](/docs/fr/model-config#adaptive-reasoning-and-fixed-thinking-budgets), vous pouvez également abaisser le budget en définissant la [variable d'environnement](/docs/fr/env-vars) `MAX_THINKING_TOKENS`, par exemple `MAX_THINKING_TOKENS=8000`. Les modèles de raisonnement adaptatif ignorent les budgets non nuls, donc utilisez plutôt les niveaux d'effort.

367 367 

368<h3 id="delegate-verbose-operations-to-subagents">368<h3 id="delegate-verbose-operations-to-subagents">

369 Déléguer les opérations détaillées aux subagents369 Déléguer les opérations détaillées aux sous-agents

370</h3>370</h3>

371 371 

372L'exécution de tests, la récupération de documentation ou le traitement de fichiers journaux peuvent consommer un contexte important. Déléguez-les aux [subagents](/docs/fr/sub-agents#isolate-high-volume-operations) pour que la sortie détaillée reste dans le contexte du subagent tandis que seul un résumé revient à votre conversation principale.372L'exécution de tests, la récupération de documentation ou le traitement de fichiers de log peuvent consommer un contexte important. Déléguez-les aux [sous-agents](/docs/fr/sub-agents#isolate-high-volume-operations) pour que la sortie détaillée reste dans le contexte du sous-agent tandis que seul un résumé revient à votre conversation principale.

373 373 

374Les propres requêtes du subagent tirent toujours sur votre utilisation. Pour dépenser moins sur eux, [choisissez un modèle plus petit pour un subagent](/docs/fr/sub-agents#choose-a-model) ou [exécutez chaque subagent sur un seul modèle](/docs/fr/sub-agents#run-every-subagent-on-one-model).374Les propres requêtes du sous-agent tirent toujours sur votre utilisation. Pour dépenser moins sur elles, [choisissez un modèle plus petit pour un sous-agent](/docs/fr/sub-agents#choose-a-model) ou [exécutez chaque sous-agent sur un seul modèle](/docs/fr/sub-agents#run-every-subagent-on-one-model).

375 375 

376<h3 id="manage-agent-team-costs">376<h3 id="manage-agent-team-costs">

377 Gérer les coûts des équipes d'agents377 Gérer les coûts des équipes d'agents


380Les équipes d'agents utilisent environ 7 fois plus de tokens que les sessions standard lorsque les coéquipiers s'exécutent en mode plan, car chaque coéquipier maintient sa propre fenêtre de contexte et s'exécute en tant qu'instance Claude distincte. Gardez les tâches d'équipe petites et autonomes pour limiter l'utilisation des tokens par coéquipier. Voir [équipes d'agents](/docs/fr/agent-teams) pour plus de détails.380Les équipes d'agents utilisent environ 7 fois plus de tokens que les sessions standard lorsque les coéquipiers s'exécutent en mode plan, car chaque coéquipier maintient sa propre fenêtre de contexte et s'exécute en tant qu'instance Claude distincte. Gardez les tâches d'équipe petites et autonomes pour limiter l'utilisation des tokens par coéquipier. Voir [équipes d'agents](/docs/fr/agent-teams) pour plus de détails.

381 381 

382<h3 id="write-specific-prompts">382<h3 id="write-specific-prompts">

383 Écrire des invites spécifiques383 Écrire des prompts spécifiques

384</h3>384</h3>

385 385 

386Les demandes vagues comme « améliorer cette base de code » déclenchent une analyse large. Les demandes spécifiques comme « ajouter la validation des entrées à la fonction de connexion dans auth.ts » permettent à Claude de travailler efficacement avec des lectures de fichiers minimales.386Les demandes vagues comme « améliorer cette base de code » déclenchent une analyse large. Les demandes spécifiques comme « ajouter la validation des entrées à la fonction de connexion dans auth.ts » permettent à Claude de travailler efficacement avec des lectures de fichiers minimales.


391 391 

392Pour un travail plus long ou plus complexe, ces habitudes aident à éviter les tokens gaspillés en prenant la mauvaise direction :392Pour un travail plus long ou plus complexe, ces habitudes aident à éviter les tokens gaspillés en prenant la mauvaise direction :

393 393 

394* **Utilisez le mode plan pour les tâches complexes** : Appuyez sur Maj+Tab pour entrer en [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) avant l'implémentation. Claude explore la base de code et propose une approche pour votre approbation, évitant les retouches coûteuses lorsque la direction initiale est mauvaise.394* **Utilisez le mode plan pour les tâches complexes** : Appuyez sur Maj+Tab pour passer en [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) avant l'implémentation. Claude explore la base de code et propose une approche pour votre approbation, évitant les retouches coûteuses lorsque la direction initiale est mauvaise.

395* **Corriger la trajectoire tôt** : Si Claude commence à aller dans la mauvaise direction, appuyez sur Échap pour arrêter immédiatement. Utilisez `/rewind` ou appuyez deux fois sur Échap pour restaurer la conversation et le code à un point de contrôle précédent.395* **Corriger la trajectoire tôt** : Si Claude commence à aller dans la mauvaise direction, appuyez sur Échap pour arrêter immédiatement. Utilisez `/rewind` ou appuyez deux fois sur Échap pour restaurer la conversation et le code à un checkpoint précédent.

396* **Donner des cibles de vérification** : Incluez des cas de test, collez des captures d'écran ou définissez la sortie attendue dans votre invite. Lorsque Claude peut vérifier son propre travail, il détecte les problèmes avant que vous ayez besoin de demander des corrections.396* **Donner des cibles de vérification** : Incluez des cas de test, collez des captures d'écran ou définissez la sortie attendue dans votre prompt. Lorsque Claude peut vérifier son propre travail, il détecte les problèmes avant que vous ayez besoin de demander des corrections.

397* **Tester de manière progressive** : Écrivez un fichier, testez-le, puis continuez. Cela détecte les problèmes tôt lorsqu'ils sont bon marché à corriger.397* **Tester de manière progressive** : Écrivez un fichier, testez-le, puis continuez. Cela permet de détecter les problèmes tôt.

398 398 

399<h2 id="background-token-usage">399<h2 id="background-token-usage">

400 Utilisation des tokens en arrière-plan400 Utilisation des tokens en arrière-plan

desktop.md +59 −8

Details

108 Disponibilité du mode auto108 Disponibilité du mode auto

109</h4>109</h4>

110 110 

111Le mode auto est disponible pour tous les utilisateurs sur l'API Anthropic et nécessite Claude Opus 4.6 ou version ultérieure, Sonnet 4.6 ou version ultérieure, ou un [modèle Fable](/docs/fr/model-config#work-with-fable). Les administrateurs d'organisation peuvent désactiver le mode auto avec la clé `disableAutoMode` dans les [paramètres gérés](#managed-settings).111Le mode auto est disponible pour tous les utilisateurs sur l'API Anthropic et nécessite Claude Opus 4.6 ou version ultérieure, Sonnet 4.6 ou version ultérieure, Haiku 5.5, ou un [modèle Fable](/docs/fr/model-config#work-with-fable). Les administrateurs d'organisation peuvent désactiver le mode auto avec la clé `disableAutoMode` dans les [paramètres gérés](#managed-settings).

112 112 

113Dans les déploiements Enterprise qui acheminent Desktop vers Google Cloud's Agent Platform, le mode auto est également disponible par défaut ; voir [Mode auto sur Bedrock, Agent Platform ou Foundry](/docs/fr/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) pour les modèles supportés.113Dans les déploiements Enterprise qui acheminent Desktop vers Google Cloud's Agent Platform, le mode auto est également disponible par défaut ; voir [Mode auto sur Bedrock, Agent Platform ou Foundry](/docs/fr/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) pour les modèles supportés.

114 114 


225 Exécuter les commandes dans le terminal225 Exécuter les commandes dans le terminal

226</h3>226</h3>

227 227 

228Le terminal intégré vous permet d'exécuter les commandes aux côtés de votre session sans basculer vers une autre application. Cliquez sur **Terminal** dans la barre de titre de la session ou appuyez sur **Ctrl+\`** sur macOS ou Windows. Le terminal s'ouvre dans le répertoire de travail de votre session et partage le même environnement que Claude, donc les commandes comme `npm test` ou `git status` voient les mêmes fichiers que Claude édite. Pour ouvrir un deuxième onglet de terminal, cliquez sur **+** dans l'en-tête du volet de terminal ou cliquez avec le bouton droit sur un dossier dans le chat pour choisir **Ouvrir dans le terminal**. Le terminal est disponible dans les sessions locales uniquement.228Le terminal intégré vous permet d'exécuter les commandes aux côtés de votre session sans basculer vers une autre application. Cliquez sur **Terminal** dans la barre de titre de la session ou appuyez sur **Ctrl+\`** sur macOS ou Windows. Le terminal s'ouvre dans le répertoire de travail de votre session et partage le même environnement que Claude, donc les commandes comme `npm test` ou `git status` voient les mêmes fichiers que Claude édite. Pour ouvrir un deuxième onglet de terminal, cliquez sur **+** dans l'en-tête du volet de terminal ou cliquez avec le bouton droit sur un dossier dans le chat pour choisir **Ouvrir dans le terminal**. Le terminal est disponible dans les sessions locales et [SSH](#ssh-sessions).

229 229 

230<h3 id="open-and-edit-files">230<h3 id="open-and-edit-files">

231 Ouvrir et modifier les fichiers231 Ouvrir et modifier les fichiers


743 743 

744Pour définir les variables d'environnement pour les sessions locales et les serveurs de développement sur n'importe quelle plateforme, ouvrez la liste déroulante d'environnement dans la zone de prompt, survolez **Local** et cliquez sur l'icône d'engrenage pour ouvrir l'éditeur d'environnement local. Les variables que vous enregistrez ici sont stockées chiffrées sur votre machine et s'appliquent à chaque session locale et serveur d'aperçu que vous démarrez. Vous pouvez également ajouter des variables à la clé `env` dans votre fichier `~/.claude/settings.json`, bien que celles-ci n'atteignent que les sessions Claude et non les serveurs de développement. Voir [variables d'environnement](/docs/fr/env-vars) pour la liste complète des variables supportées.744Pour définir les variables d'environnement pour les sessions locales et les serveurs de développement sur n'importe quelle plateforme, ouvrez la liste déroulante d'environnement dans la zone de prompt, survolez **Local** et cliquez sur l'icône d'engrenage pour ouvrir l'éditeur d'environnement local. Les variables que vous enregistrez ici sont stockées chiffrées sur votre machine et s'appliquent à chaque session locale et serveur d'aperçu que vous démarrez. Vous pouvez également ajouter des variables à la clé `env` dans votre fichier `~/.claude/settings.json`, bien que celles-ci n'atteignent que les sessions Claude et non les serveurs de développement. Voir [variables d'environnement](/docs/fr/env-vars) pour la liste complète des variables supportées.

745 745 

746[La réflexion étendue](/docs/fr/model-config#extended-thinking) est activée par défaut, ce qui améliore les performances sur les tâches de raisonnement complexe mais utilise des tokens supplémentaires. Sur l'API Anthropic, définissez `MAX_THINKING_TOKENS` à `0` dans l'éditeur d'environnement local pour désactiver la réflexion ; cela n'a aucun effet sur Opus 5.5, Sonnet 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue. Avec la réflexion désactivée sur l'API Anthropic, Claude Code envoie l'effort `high` au lieu d'un niveau supérieur aux modèles qu'il sait [ne pas accepter cette combinaison](/docs/fr/errors#effort-isnt-available-with-thinking-turned-off), comme Opus 5.746[La réflexion étendue](/docs/fr/model-config#extended-thinking) est activée par défaut, ce qui améliore les performances sur les tâches de raisonnement complexe mais utilise des tokens supplémentaires. Sur l'API Anthropic, définissez `MAX_THINKING_TOKENS` à `0` dans l'éditeur d'environnement local pour désactiver la réflexion ; cela n'a aucun effet sur Opus 5.5, Sonnet 5.5, Haiku 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue. Avec la réflexion désactivée sur l'API Anthropic, Claude Code envoie l'effort `high` au lieu d'un niveau supérieur aux modèles qu'il sait [ne pas accepter cette combinaison](/docs/fr/errors#effort-isnt-available-with-thinking-turned-off), comme Opus 5.

747 747 

748Sur les modèles avec [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level), Claude Code ignore le nombre lui-même dans une valeur `MAX_THINKING_TOKENS` positive, car le raisonnement adaptatif contrôle la profondeur de la réflexion à la place. Sur Opus 4.6 et Sonnet 4.6, définissez `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` à `1` pour utiliser un budget de réflexion fixe ; les modèles Fable, Sonnet 5 et versions ultérieures, et Opus 4.7 et versions ultérieures utilisent toujours le raisonnement adaptatif et n'ont pas de mode de budget fixe.748Sur les modèles avec [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level), Claude Code ignore le nombre lui-même dans une valeur `MAX_THINKING_TOKENS` positive, car le raisonnement adaptatif contrôle la profondeur de la réflexion à la place. Sur Opus 4.6 et Sonnet 4.6, définissez `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` à `1` pour utiliser un budget de réflexion fixe ; les modèles Fable, Sonnet 5 et versions ultérieures, Haiku 5.5, et Opus 4.7 et versions ultérieures utilisent toujours le raisonnement adaptatif et n'ont pas de mode de budget fixe.

749 749 

750<h4 id="local-sessions-on-managed-devices">750<h4 id="local-sessions-on-managed-devices">

751 Sessions locales sur les appareils gérés751 Sessions locales sur les appareils gérés


783 783 

784La machine distante doit exécuter Linux ou macOS. Desktop installe Claude Code sur la machine distante automatiquement la première fois que vous vous connectez. Une fois connecté, les sessions SSH supportent les modes de permission, les connecteurs, les plugins et les serveurs MCP.784La machine distante doit exécuter Linux ou macOS. Desktop installe Claude Code sur la machine distante automatiquement la première fois que vous vous connectez. Une fois connecté, les sessions SSH supportent les modes de permission, les connecteurs, les plugins et les serveurs MCP.

785 785 

786<h4 id="open-an-ssh-session-from-a-link">

787 Ouvrir une session SSH à partir d'un lien

788</h4>

789 

790Un lien `claude://code/new` ouvre la page de nouvelle session de Desktop, et il peut désigner une connexion SSH. Placez un tel lien dans un runbook, un tableau de bord ou une page wiki pour ouvrir Desktop configuré pour la bonne machine et le bon dossier. Pour les plateformes qui suppriment ces liens, voir [Le lien s'affiche en texte brut au lieu d'être cliquable](/docs/fr/deep-links#the-link-renders-as-plain-text-instead-of-being-clickable).

791 

792Les liens SSH nécessitent Claude Desktop v2.110.0 ou une version ultérieure.

793 

794Le lien suivant désigne l'utilisateur `dev` sur `build.example.com`, le port 2222 et le dossier `/srv/payments`, et renseigne un prompt :

795 

796```text theme={null}

797claude://code/new?ssh_host=dev%40build.example.com&ssh_port=2222&ssh_folder=/srv/payments&q=Investigate%20the%20failed%20deploy

798```

799 

800Un lien SSH accepte ces paramètres, et seul `ssh_host` est obligatoire :

801 

802| Paramètre | Valeur |

803| :- | :- |

804| `ssh_host` | `host` ou `user@host`, écrit comme dans le champ **Hôte SSH**. La valeur ne peut pas commencer par `-`, et la partie hôte n'accepte que des lettres, des chiffres, `.`, `_`, `:` et `-` |

805| `ssh_port` | Un numéro de port compris entre 1 et 65535 |

806| `ssh_folder` | Un dossier sur la machine distante. Commencez-le par `/` ou `~/`, ou utilisez `~` |

807| `q` | Texte encodé en URL pour la zone de prompt |

808 

809Un alias de `~/.ssh/config` ne fonctionne comme `ssh_host` que pour les personnes qui possèdent cette entrée. Pour correspondre à une connexion que les personnes possèdent déjà, donnez au lien le même utilisateur, le même hôte et le même port que cette connexion.

810 

811Lorsque vous ouvrez le lien, Desktop vous demande de confirmer avant de sélectionner la connexion :

812 

813* **Une connexion que vous possédez déjà** : si l'hôte, l'utilisateur et le port correspondent à l'une de vos connexions, Desktop vous demande s'il faut l'utiliser, et vous affiche le nom et l'hôte de la connexion, ainsi que le dossier si le lien en désigne un.

814* **Une nouvelle connexion** : sinon, Desktop ouvre la boîte de dialogue d'ajout d'une connexion SSH. Lorsque vous ajoutez la connexion, Desktop vous demande s'il faut se connecter avant d'enregistrer quoi que ce soit, et vous affiche l'hôte provenant du lien, ainsi que le port et le dossier si le lien les désigne.

815 

816Tant que vous n'avez pas confirmé, Desktop n'enregistre pas l'hôte, le port ou le dossier provenant du lien, et ne sélectionne ni n'ouvre de connexion avec eux. Si une connexion SSH est déjà sélectionnée, la page de nouvelle session peut toujours s'y connecter d'elle-même, comme elle le fait sans lien, même lorsque le lien désigne le même hôte. Un lien ne peut pas transporter de fichier de clé, de mot de passe ou de commande.

817 

818N'importe qui peut écrire un lien, alors vérifiez ce qu'il a renseigné :

819 

820* **Avant de confirmer** : vérifiez l'hôte et le dossier.

821* **Avant d'envoyer** : vérifiez le prompt et l'environnement sélectionné.

822 

823Desktop renseigne le prompt à l'ouverture du lien, à la place de tout texte que vous n'avez pas envoyé, et ne l'envoie jamais à votre place. Il traite le prompt comme du texte brut, de sorte qu'un `/` ou un `!` en début de texte et une mention de fichier `@` n'agissent pas comme une commande ou une mention. Si vous annulez, le prompt reste dans la zone et l'environnement que vous aviez sélectionné ne change pas.

824 

825Un lien ne contourne pas [`sshHostAllowlist`](#restrict-which-ssh-hosts-users-can-connect-to). Desktop vérifie la liste d'autorisation lors de la connexion.

826 

827Si le lien ouvre Desktop sans boîte de dialogue concernant la connexion, recherchez l'une de ces causes :

828 

829* **Vous êtes déconnecté** : connectez-vous, puis ouvrez à nouveau le lien.

830* **Une autre boîte de dialogue est ouverte** : fermez-la, puis ouvrez à nouveau le lien.

831* **Le lien n'est pas valide** : Desktop affiche un message indiquant ce qu'il faut corriger, et ne renseigne pas le prompt.

832* **Desktop est antérieur à v2.110.0** : les versions antérieures ignorent les paramètres SSH et ouvrent la page de nouvelle session avec uniquement le prompt.

833* **Les sessions SSH sont désactivées** : si votre administrateur définit la liste d'autorisation sur un tableau vide, Desktop refuse les liens SSH.

834 

786<h4 id="pre-configure-ssh-connections-for-your-team">835<h4 id="pre-configure-ssh-connections-for-your-team">

787 Pré-configurer les connexions SSH pour votre équipe836 Pré-configurer les connexions SSH pour votre équipe

788</h4>837</h4>


805}854}

806```855```

807 856 

808Chaque entrée nécessite `id`, `name` et `sshHost`. Les champs `sshPort` et `sshIdentityFile` sont optionnels. Les utilisateurs peuvent également ajouter `sshConfigs` à leur propre `~/.claude/settings.json`, qui est l'endroit où les connexions ajoutées via la boîte de dialogue sont stockées.857Chaque entrée nécessite `id`, `name` et `sshHost`. Les champs `sshPort` et `sshIdentityFile` sont optionnels. Les utilisateurs peuvent également ajouter `sshConfigs` à leur propre `~/.claude/settings.json`.

809 858 

810<h4 id="restrict-which-ssh-hosts-users-can-connect-to">859<h4 id="restrict-which-ssh-hosts-users-can-connect-to">

811 Restreindre les hôtes SSH auxquels les utilisateurs peuvent se connecter860 Restreindre les hôtes SSH auxquels les utilisateurs peuvent se connecter


866| `sshConfigs` | pré-configurez les [connexions SSH](#pre-configure-ssh-connections-for-your-team) qui apparaissent dans la liste déroulante de l'environnement. Les utilisateurs ne peuvent pas modifier ou supprimer les connexions gérées. |915| `sshConfigs` | pré-configurez les [connexions SSH](#pre-configure-ssh-connections-for-your-team) qui apparaissent dans la liste déroulante de l'environnement. Les utilisateurs ne peuvent pas modifier ou supprimer les connexions gérées. |

867| `sshHostAllowlist` | restreignez les [sessions SSH](#restrict-which-ssh-hosts-users-can-connect-to) aux hôtes dont le nom d'hôte résolu correspond à l'un de ces modèles. Un tableau vide désactive les sessions SSH. Lecture à partir des paramètres gérés uniquement. |916| `sshHostAllowlist` | restreignez les [sessions SSH](#restrict-which-ssh-hosts-users-can-connect-to) aux hôtes dont le nom d'hôte résolu correspond à l'un de ces modèles. Un tableau vide désactive les sessions SSH. Lecture à partir des paramètres gérés uniquement. |

868| `disableDesktopLocalSessions` | définissez sur `true` pour désactiver les [sessions Code qui s'exécutent sur l'appareil](#local-sessions-on-managed-devices), en laissant les sessions SSH vers d'autres hôtes et les sessions cloud disponibles. La valeur doit être le booléen JSON `true`. Lecture à partir des paramètres gérés uniquement. Nécessite Claude Desktop v1.37937.0 ou version ultérieure. |917| `disableDesktopLocalSessions` | définissez sur `true` pour désactiver les [sessions Code qui s'exécutent sur l'appareil](#local-sessions-on-managed-devices), en laissant les sessions SSH vers d'autres hôtes et les sessions cloud disponibles. La valeur doit être le booléen JSON `true`. Lecture à partir des paramètres gérés uniquement. Nécessite Claude Desktop v1.37937.0 ou version ultérieure. |

918| `disableSshSavedPasswords` | définissez sur `true` pour empêcher Desktop de proposer de mémoriser les mots de passe SSH et d'utiliser ou d'afficher ceux qu'il a enregistrés précédemment. L'activer ne les supprime pas. Lecture à partir des paramètres gérés uniquement. Nécessite Claude Desktop v1.49585.0 ou version ultérieure. |

869| `managedMcpServers` | poussez les configurations du serveur MCP à tous les utilisateurs. Disponible dans les déploiements Desktop tiers (3P) uniquement. Dans chaque entrée, définissez un transport de `"http"`, `"sse"` ou `"stdio"`, les détails de connexion et optionnellement une carte `toolPolicy` pour restreindre les outils de ce serveur que les utilisateurs peuvent invoquer. Livrez-le via le fichier de paramètres gérés, MDM ou la politique de bloc [`desktop`](/docs/fr/claude-apps-gateway-config#claude-desktop-overlay) d'une passerelle d'applications Claude, car les déploiements tiers ne reçoivent pas les paramètres de la console d'administration. Pour le livrer via la passerelle, vous avez besoin de Claude Code v2.1.232 ou version ultérieure sur le serveur de la passerelle. Ceci est la clé propre de l'application de bureau ; Claude Code lit un [paramètre géré de même nom](/docs/fr/managed-mcp#provide-servers-through-managed-settings) qui lui est propre, avec une forme d'entrée différente. |919| `managedMcpServers` | poussez les configurations du serveur MCP à tous les utilisateurs. Disponible dans les déploiements Desktop tiers (3P) uniquement. Dans chaque entrée, définissez un transport de `"http"`, `"sse"` ou `"stdio"`, les détails de connexion et optionnellement une carte `toolPolicy` pour restreindre les outils de ce serveur que les utilisateurs peuvent invoquer. Livrez-le via le fichier de paramètres gérés, MDM ou la politique de bloc [`desktop`](/docs/fr/claude-apps-gateway-config#claude-desktop-overlay) d'une passerelle d'applications Claude, car les déploiements tiers ne reçoivent pas les paramètres de la console d'administration. Pour le livrer via la passerelle, vous avez besoin de Claude Code v2.1.232 ou version ultérieure sur le serveur de la passerelle. Ceci est la clé propre de l'application de bureau ; Claude Code lit un [paramètre géré de même nom](/docs/fr/managed-mcp#provide-servers-through-managed-settings) qui lui est propre, avec une forme d'entrée différente. |

870 920 

871Les paramètres gérés qui atteignent une session Desktop dépendent de l'endroit où cette session s'exécute. Les restrictions de modèle telles que [`availableModels`](/docs/fr/model-config#restrict-model-selection) sont appliquées dans les sessions Claude Code de Desktop de la même manière que dans le CLI du terminal ; voir [couverture de surface](/docs/fr/model-config#surface-coverage).921Les paramètres gérés qui atteignent une session Desktop dépendent de l'endroit où cette session s'exécute. Les restrictions de modèle telles que [`availableModels`](/docs/fr/model-config#restrict-model-selection) sont appliquées dans les sessions Claude Code de Desktop de la même manière que dans le CLI du terminal ; voir [couverture de surface](/docs/fr/model-config#surface-coverage).

872 922 

873* **Sessions locales sur cette machine** : un fichier de paramètres gérés déployé sur le disque s'applique. Les paramètres gérés poussés à distance via la console d'administration atteignent également ces sessions sur l'API d'Anthropic lorsque la session s'authentifie avec une [connexion ou clé éligible](/docs/fr/server-managed-settings#platform-availability), en suivant la même [priorité des paramètres](/docs/fr/settings#settings-precedence) que le CLI du terminal.923* **Sessions locales sur cette machine** : un fichier de paramètres gérés déployé sur le disque s'applique. Les paramètres gérés poussés à distance via la console d'administration atteignent également ces sessions sur l'API d'Anthropic lorsque la session s'authentifie avec une [connexion ou clé éligible](/docs/fr/server-managed-settings#platform-availability), en suivant la même [priorité des paramètres](/docs/fr/settings#settings-precedence) que le CLI du terminal.

874* **[Sessions cloud](#cloud-sessions)** : reçoivent les [paramètres gérés par le serveur](/docs/fr/server-managed-settings) ; les fichiers déployés sur l'appareil ne les atteignent pas, car ils s'exécutent sur des machines virtuelles gérées par Anthropic. Les sessions acheminées vers un [environnement auto-hébergé](/docs/fr/self-hosted-environments) lisent également le fichier de paramètres gérés dans l'image du runner. [Comment Claude Code combine les sources gérées](/docs/fr/managed-settings#how-claude-code-combines-managed-sources) indique quand ce fichier s'applique.924* **[Sessions cloud](#cloud-sessions)** : reçoivent les [paramètres gérés par le serveur](/docs/fr/server-managed-settings) ; les fichiers déployés sur l'appareil ne les atteignent pas, car ils s'exécutent sur des machines virtuelles gérées par Anthropic. Les sessions acheminées vers un [environnement auto-hébergé](/docs/fr/self-hosted-environments) lisent également le fichier de paramètres gérés dans l'image du runner. [Comment Claude Code combine les sources gérées](/docs/fr/managed-settings#how-claude-code-combines-managed-sources) indique quand ce fichier s'applique.

875* **[Sessions SSH](#ssh-sessions)** : la session lit le fichier de paramètres gérés à partir de l'hôte distant. Desktop lui-même lit `sshConfigs`, `sshHostAllowlist` et `disableDesktopLocalSessions` à partir des paramètres gérés de la machine locale.925* **[Sessions SSH](#ssh-sessions)** : la session lit le fichier de paramètres gérés à partir de l'hôte distant. Desktop lui-même lit `sshConfigs`, `sshHostAllowlist`, `disableSshSavedPasswords` et `disableDesktopLocalSessions` à partir des paramètres gérés de la machine locale.

876* **Sessions [Cowork](https://claude.com/docs/cowork/overview)** : dans une session Cowork sur cette machine, Claude Code ne récupère jamais les paramètres de la console d'administration, même lorsque l'utilisateur se connecte avec un compte Team ou Enterprise, et lit la politique déployée sur la machine sauf si votre configuration Claude Desktop définit `requireCoworkFullVmSandbox`. Les sessions Cowork distantes ne reçoivent ni l'une ni l'autre. Voir [où et quand une politique s'applique](/docs/fr/managed-settings#where-and-when-a-policy-applies) pour savoir quels fichiers d'appareil atteignent Cowork, et [règles de permission MCP](/docs/fr/permissions#mcp) pour savoir comment les règles `Bash` et `WebFetch` s'appliquent aux outils de Cowork.926* **Sessions [Cowork](https://claude.com/docs/cowork/overview)** : dans une session Cowork sur cette machine, Claude Code ne récupère jamais les paramètres de la console d'administration, même lorsque l'utilisateur se connecte avec un compte Team ou Enterprise, et lit la politique déployée sur la machine sauf si votre configuration Claude Desktop définit `requireCoworkFullVmSandbox`. Les sessions Cowork distantes ne reçoivent ni l'une ni l'autre. Voir [où et quand une politique s'applique](/docs/fr/managed-settings#where-and-when-a-policy-applies) pour savoir quels fichiers d'appareil atteignent Cowork, et [règles de permission MCP](/docs/fr/permissions#mcp) pour savoir comment les règles `Bash` et `WebFetch` s'appliquent aux outils de Cowork.

877 927 

878Dans les sessions locales et SSH, l'application de bureau fournit les connecteurs claude.ai connectés de chaque utilisateur à Claude Code directement. Aucun paramètre MCP ou `managed-mcp.json` n'atteint ces connecteurs, quelle que soit la source de paramètres ou l'emplacement du fichier que vous utilisez. Pour bloquer les outils d'un connecteur dans ces sessions, utilisez les [contrôles des outils de connecteur](/docs/fr/mcp#organization-controls-on-connector-tools) de votre organisation. [Comment les connecteurs atteignent Claude Code](/docs/fr/mcp#how-connectors-reach-claude-code) montre quels paramètres gouvernent les connecteurs dans chaque type de session.928Dans les sessions locales et SSH, l'application de bureau fournit les connecteurs claude.ai connectés de chaque utilisateur à Claude Code directement. Aucun paramètre MCP ou `managed-mcp.json` n'atteint ces connecteurs, quelle que soit la source de paramètres ou l'emplacement du fichier que vous utilisez. Pour bloquer les outils d'un connecteur dans ces sessions, utilisez les [contrôles des outils de connecteur](/docs/fr/mcp#organization-controls-on-connector-tools) de votre organisation. [Comment les connecteurs atteignent Claude Code](/docs/fr/mcp#how-connectors-reach-claude-code) montre quels paramètres gouvernent les connecteurs dans chaque type de session.


885 Politiques de gestion des appareils935 Politiques de gestion des appareils

886</h3>936</h3>

887 937 

888Les équipes informatiques peuvent gérer l'application de bureau via MDM sur macOS ou la politique de groupe sur Windows. Les politiques disponibles incluent l'activation ou la désactivation de la fonctionnalité Claude Code, le contrôle des mises à jour automatiques et la définition d'une URL de déploiement personnalisée.938Les équipes informatiques peuvent gérer l'application de bureau via MDM sur macOS, la politique de groupe sur Windows ou un fichier de politique sur Linux. Les politiques disponibles incluent l'activation ou la désactivation de la fonctionnalité Claude Code, le contrôle des mises à jour automatiques sur macOS et Windows, et la définition d'une URL de déploiement personnalisée.

889 939 

890* **macOS** : configurez via le domaine de préférence `com.anthropic.claudefordesktop` en utilisant des outils comme Jamf ou Kandji940* **macOS** : configurez via le domaine de préférence `com.anthropic.claudefordesktop` en utilisant des outils comme Jamf ou Kandji

891* **Windows** : configurez via le registre à `SOFTWARE\Policies\Claude`941* **Windows** : configurez via le registre à `SOFTWARE\Policies\Claude`

942* **Linux** : configurez via un fichier appartenant à root à l'emplacement `/etc/claude-desktop/managed-settings.json`, qui contient les clés de politique sous forme d'objet JSON. Desktop refuse le fichier si quelqu'un d'autre que root peut écrire dans celui-ci ou dans son dossier. Il s'agit d'un fichier différent du [fichier de paramètres gérés](/docs/fr/managed-settings) de Claude Code.

892 943 

893<h3 id="network-access-requirements">944<h3 id="network-access-requirements">

894 Exigences d'accès réseau945 Exigences d'accès réseau


1092Pour voir quelle version de l'application de bureau vous exécutez :1143Pour voir quelle version de l'application de bureau vous exécutez :

1093 1144 

1094* **macOS** : cliquez sur **Claude** dans la barre de menu, puis **À propos de Claude**1145* **macOS** : cliquez sur **Claude** dans la barre de menu, puis **À propos de Claude**

1095* **Windows** : cliquez sur **Aide**, puis **À propos**1146* **Windows** : cliquez sur **Aide**, puis **À propos de Claude**

1096 1147 

1097Cliquez sur le numéro de version pour le copier dans votre presse-papiers.1148Cliquez sur le numéro de version pour le copier dans votre presse-papiers.

1098 1149 

Details

92* Enregistrer une capture d'écran avec **Cmd+S** ou un enregistrement d'écran avec **Cmd+R**, en utilisant les boutons de capture du volet ou les raccourcis ; les fichiers sont enregistrés sur votre Bureau92* Enregistrer une capture d'écran avec **Cmd+S** ou un enregistrement d'écran avec **Cmd+R**, en utilisant les boutons de capture du volet ou les raccourcis ; les fichiers sont enregistrés sur votre Bureau

93* Arrêter la diffusion en continu d'un appareil sans l'arrêter en cliquant sur **Detach simulator**, ce qui ramène le volet à son état **Attach simulator**93* Arrêter la diffusion en continu d'un appareil sans l'arrêter en cliquant sur **Detach simulator**, ce qui ramène le volet à son état **Attach simulator**

94 94 

95Pour régler le flux vidéo du simulateur, ouvrez le menu **Display** du volet. Réduisez la **Frame rate** ou la **Resolution** si le volet surcharge votre Mac. Ces deux paramètres modifient la façon dont le volet affiche l'appareil, pas la façon dont l'application s'exécute.95Si le volet affiche un menu **Display**, utilisez-le pour régler le flux vidéo du simulateur. Réduisez la **Frame rate** ou la **Resolution** si le volet surcharge votre Mac. Ces deux paramètres modifient la façon dont le volet affiche l'appareil, pas la façon dont l'application s'exécute.

96 96 

97Vous et Claude pilotez le même appareil, donc vos appuis modifient l'état de l'application que Claude voit. Pour que Claude vérifie un écran spécifique, accédez-y en appuyant, puis demandez. Pendant que Claude pilote l'appareil, le volet affiche un badge **Claude is using this device** au-dessus de l'écran ; attendez avant d'appuyer jusqu'à ce que le badge disparaisse, afin que le résultat reflète l'application plutôt que votre entrée.97Vous et Claude pilotez le même appareil, donc vos appuis modifient l'état de l'application que Claude voit. Pour que Claude vérifie un écran spécifique, accédez-y en appuyant, puis demandez. Pendant que Claude pilote l'appareil, le volet affiche un badge **Claude is using this device** au-dessus de l'écran ; attendez avant d'appuyer jusqu'à ce que le badge disparaisse, afin que le résultat reflète l'application plutôt que votre entrée.

98 98 

env-vars.md +339 −335

Details

82 Dans les fichiers de paramètres82 Dans les fichiers de paramètres

83</h3>83</h3>

84 84 

85Ajoutez les variables sous la clé `env` dans un fichier `settings.json`, en créant le fichier s'il n'existe pas. Claude Code les lit directement depuis le fichier, donc elles prennent effet peu importe comment `claude` a été lancé. Une session en cours applique les valeurs nouvelles et modifiées à son environnement lorsque vous enregistrez le fichier, mais une fonctionnalité qui lit ses variables une seule fois au démarrage, comme [la surveillance OpenTelemetry](/docs/fr/monitoring-usage), conserve ses valeurs de démarrage jusqu'à ce que vous relancez. Retirer une variable du fichier ne la supprime pas d'une session en cours ; ce retrait prend effet la prochaine fois que vous lancez `claude`.85Ajoutez les variables sous la clé `env` dans un fichier `settings.json`, en créant le fichier s'il n'existe pas. Claude Code les lit directement depuis le fichier, donc elles prennent effet peu importe comment `claude` a été lancé. Une session en cours applique les valeurs nouvelles et modifiées à son environnement lorsque vous enregistrez le fichier, mais une fonctionnalité qui lit ses variables une seule fois au démarrage, comme [la surveillance OpenTelemetry](/docs/fr/monitoring-usage), conserve ses valeurs de démarrage jusqu'à ce que vous relanciez. Retirer une variable du fichier ne la supprime pas d'une session en cours ; ce retrait prend effet la prochaine fois que vous lancez `claude`.

86 86 

87```json ~/.claude/settings.json theme={null}87```json ~/.claude/settings.json theme={null}

88{88{


93}93}

94```94```

95 95 

96Claude Code copie ces valeurs dans son environnement telles qu'elles sont écrites. Aucun shell ne les traite, donc les raccourcis comme `~` ou `$HOME` restent tels que saisis. Pour une variable qui prend un chemin, comme `CLAUDE_CONFIG_DIR`, écrivez le chemin absolu : `"CLAUDE_CONFIG_DIR": "/home/you/.claude-work"`.

97 

96Le fichier que vous choisissez contrôle à qui les variables s'appliquent :98Le fichier que vous choisissez contrôle à qui les variables s'appliquent :

97 99 

98| Fichier | S'applique à |100| Fichier | S'applique à |


102| `.claude/settings.local.json` | Vous, dans ce projet uniquement, ignoré par git lorsque Claude Code enregistre un paramètre ; ajoutez-le à votre gitignore si vous le créez manuellement |104| `.claude/settings.local.json` | Vous, dans ce projet uniquement, ignoré par git lorsque Claude Code enregistre un paramètre ; ajoutez-le à votre gitignore si vous le créez manuellement |

103| Paramètres gérés | Tous les membres de votre organisation, déployés par un administrateur |105| Paramètres gérés | Tous les membres de votre organisation, déployés par un administrateur |

104 106 

105Consultez [Fichiers de paramètres](/docs/fr/settings#where-settings-live) pour savoir où se trouve chaque fichier et [Précédence des paramètres](/docs/fr/settings#settings-precedence) pour savoir comment ils se combinent lorsque plusieurs définissent la même variable.107Consultez [Fichiers de paramètres](/docs/fr/settings#where-settings-live) pour savoir où se trouve chaque fichier et [Priorité des paramètres](/docs/fr/settings#settings-precedence) pour savoir comment ils se combinent lorsque plusieurs définissent la même variable.

106 108 

107<h2 id="precedence">109<h2 id="precedence">

108 Précédence110 Précédence


124 Variables126 Variables

125</h2>127</h2>

126 128 

127Les variables numériques, comme les délais d'expiration, les budgets de tokens et les nombres de nouvelles tentatives, acceptent la notation scientifique et les séparateurs de chiffres en plus des chiffres simples, sauf lorsque la ligne d'une variable indique qu'elle n'accepte que des chiffres simples. Par exemple, Claude Code lit `2e3` comme 2000 et `64_000` comme 64000. Avant la v2.1.211, ces écritures pouvaient définir silencieusement une valeur bien plus petite, par exemple `1e6` fixait un délai d'expiration à 1.129Les variables numériques, comme les délais d'expiration, les budgets de tokens et les nombres de nouvelles tentatives, acceptent la notation scientifique et les séparateurs de chiffres en plus des chiffres simples, sauf lorsque la ligne d'une variable indique qu'elle n'accepte que des chiffres simples. Par exemple, Claude Code lit `2e3` comme 2000 et `64_000` comme 64000. Avant la v2.1.211, ces écritures pouvaient définir silencieusement une valeur bien inférieure, par exemple `1e6` qui définissait un délai d'expiration à 1.

128 130 

129<Note>131<Note>

130 Pour les variables qui activent ou désactivent un comportement, définissez `1`, `true`, `yes` ou `on` pour l'activer et `0`, `false`, `no` ou `off` pour le désactiver, quelle que soit la casse.132 Pour les variables qui activent ou désactivent un comportement, définissez `1`, `true`, `yes` ou `on` pour l'activer et `0`, `false`, `no` ou `off` pour le désactiver, quelle que soit la casse.

131 133 

132 Certaines variables vérifient uniquement si vous les avez définies, de sorte que toute valeur non vide, y compris `0`, active le comportement, et vous désactivez le comportement en supprimant la variable ou en lui attribuant une valeur vide. Ces variables fonctionnent de cette manière :134 Certaines variables vérifient uniquement si vous les avez définies, de sorte que toute valeur non vide, y compris `0`, active le comportement, et vous le désactivez en supprimant la variable ou en lui attribuant une valeur vide. Ces variables fonctionnent ainsi :

133 135 

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`136 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`137 * `DISABLE_TELEMETRY`


143 145 

144| Variable | Objectif |146| Variable | Objectif |

145| :- | :- |147| :- | :- |

146| `ANTHROPIC_API_KEY` | Clé API envoyée dans l'en-tête `X-Api-Key`. Lorsqu'elle est définie, cette clé est utilisée à la place de votre abonnement Claude Pro, Max, Team ou Enterprise, même si vous êtes connecté. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente. En mode interactif, il vous est demandé d'approuver la clé une fois avant qu'elle ne remplace votre abonnement. Pour utiliser votre abonnement à la place, exécutez `unset ANTHROPIC_API_KEY` |148| `ANTHROPIC_API_KEY` | Clé API envoyée dans l'en-tête `X-Api-Key`. Lorsqu'elle est définie, cette clé est utilisée à la place de votre abonnement Claude Pro, Max, Team ou Enterprise, même si vous êtes connecté. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente. En mode interactif, il vous est demandé d'approuver la clé une fois avant qu'elle ne remplace votre abonnement. Pour utiliser plutôt votre abonnement, exécutez `unset ANTHROPIC_API_KEY` |

147| `ANTHROPIC_AUTH_TOKEN` | Valeur personnalisée pour l'en-tête `Authorization` (la valeur que vous définissez ici sera préfixée par `Bearer `) |149| `ANTHROPIC_AUTH_TOKEN` | Valeur personnalisée pour l'en-tête `Authorization` (la valeur définie ici sera préfixée par `Bearer `) |

148| `ANTHROPIC_AWS_API_KEY` | Clé API d'espace de travail pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), générée dans la console AWS. Envoyée en tant que `x-api-key` et prioritaire sur AWS SigV4 |150| `ANTHROPIC_AWS_API_KEY` | Clé API d'espace de travail pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), générée dans la console AWS. Envoyée en tant que `x-api-key` et prioritaire sur AWS SigV4 |

149| `ANTHROPIC_AWS_BASE_URL` | Remplace l'URL de l'endpoint [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). À utiliser pour des régions personnalisées ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Valeur par défaut : `https://aws-external-anthropic.{region}.api.aws`. Claude Code résout la région avec la [même priorité que sur Amazon Bedrock](/docs/fr/amazon-bedrock#3-configure-claude-code) |151| `ANTHROPIC_AWS_BASE_URL` | Remplace l'URL de l'endpoint [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). À utiliser pour des régions personnalisées ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Valeur par défaut : `https://aws-external-anthropic.{region}.api.aws`. Claude Code détermine la région avec la [même priorité que sur Amazon Bedrock](/docs/fr/amazon-bedrock#3-configure-claude-code) |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | Requis pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). Envoyé avec chaque requête dans l'en-tête `anthropic-workspace-id` |152| `ANTHROPIC_AWS_WORKSPACE_ID` | Requise pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). Envoyée à chaque requête dans l'en-tête `anthropic-workspace-id` |

151| `ANTHROPIC_BASE_URL` | Remplace l'endpoint de l'API pour acheminer les requêtes via un proxy ou une passerelle. Lorsqu'elle pointe vers un hôte qui n'est pas first-party, [MCP Tool Search](/docs/fr/mcp#scale-with-mcp-tool-search) est désactivé par défaut. Définissez `ENABLE_TOOL_SEARCH=true` si votre proxy transmet les blocs `tool_reference`. Depuis la v2.1.196, [Remote Control](/docs/fr/remote-control#requirements) est désactivé lorsque cette variable pointe vers un hôte autre que `api.anthropic.com`, comme c'est le cas sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry |153| `ANTHROPIC_BASE_URL` | Remplace l'endpoint de l'API pour acheminer les requêtes via un proxy ou une passerelle. Lorsqu'elle pointe vers un hôte qui n'est pas first-party, la [recherche d'outils MCP](/docs/fr/mcp#scale-with-mcp-tool-search) est désactivée par défaut. Définissez `ENABLE_TOOL_SEARCH=true` si votre proxy transmet les blocs `tool_reference`. Depuis la v2.1.196, [Remote Control](/docs/fr/remote-control#requirements) est désactivé lorsque cette variable pointe vers un hôte autre que `api.anthropic.com`, comme c'est le cas sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Remplace l'URL de l'endpoint Amazon Bedrock. À utiliser pour des endpoints Amazon Bedrock personnalisés ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Voir [Amazon Bedrock](/docs/fr/amazon-bedrock) |154| `ANTHROPIC_BEDROCK_BASE_URL` | Remplace l'URL de l'endpoint Amazon Bedrock. À utiliser pour des endpoints Amazon Bedrock personnalisés ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Voir [Amazon Bedrock](/docs/fr/amazon-bedrock) |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Remplace l'URL de l'endpoint Amazon Bedrock Mantle. Voir [Endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) |155| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Remplace l'URL de l'endpoint Amazon Bedrock Mantle. Voir [Endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Préfixe du profil d'inférence interrégional (`us`, `eu`, `apac`, `jp`, `au` ou `global`) que Claude Code essaie en premier au lieu de celui dérivé de la région AWS. Ignoré dans les régions AWS GovCloud. Nécessite Claude Code v2.1.224 ou ultérieur. Voir [Amazon Bedrock](/docs/fr/amazon-bedrock#cross-region-inference-profile-prefixes) |156| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Préfixe de profil d'inférence interrégional (`us`, `eu`, `apac`, `jp`, `au` ou `global`) que Claude Code essaie en premier au lieu de celui dérivé de la région AWS. Ignorée dans les régions AWS GovCloud. Nécessite Claude Code v2.1.224 ou une version ultérieure. Voir [Amazon Bedrock](/docs/fr/amazon-bedrock#cross-region-inference-profile-prefixes) |

155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Niveau de service](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) Amazon Bedrock (`default`, `flex` ou `priority`). Envoyé dans l'en-tête `X-Amzn-Bedrock-Service-Tier`. Voir [Amazon Bedrock](/docs/fr/amazon-bedrock#service-tiers) |157| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Niveau de service](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) Amazon Bedrock (`default`, `flex` ou `priority`). Envoyé dans l'en-tête `X-Amzn-Bedrock-Service-Tier`. Voir [Amazon Bedrock](/docs/fr/amazon-bedrock#service-tiers) |

156| `ANTHROPIC_BETAS` | Liste, séparée par des virgules, de valeurs d'en-tête `anthropic-beta` supplémentaires à inclure dans les requêtes API. Claude Code envoie déjà les en-têtes bêta dont il a besoin ; utilisez cette variable pour activer une [bêta de l'API Anthropic](https://platform.claude.com/docs/en/api/beta-headers) avant que Claude Code n'en ajoute la prise en charge native. Contrairement au [flag `--betas`](/docs/fr/cli-reference#cli-flags), qui nécessite une authentification par clé API, cette variable fonctionne avec toutes les méthodes d'authentification, y compris l'abonnement Claude.ai |158| `ANTHROPIC_BETAS` | Liste séparée par des virgules de valeurs supplémentaires d'en-tête `anthropic-beta` à inclure dans les requêtes API. Claude Code envoie déjà les en-têtes bêta dont il a besoin ; utilisez cette variable pour activer une [bêta de l'API Anthropic](https://platform.claude.com/docs/en/api/beta-headers) avant que Claude Code n'en ajoute la prise en charge native. Contrairement au [flag `--betas`](/docs/fr/cli-reference#cli-flags), qui nécessite une authentification par clé API, cette variable fonctionne avec toutes les méthodes d'authentification, y compris l'abonnement Claude.ai |

157| `ANTHROPIC_CUSTOM_HEADERS` | En-têtes personnalisés à ajouter aux requêtes (format `Name: Value`, séparés par des retours à la ligne pour plusieurs en-têtes). Si un nom ou une valeur contient un caractère qu'un en-tête HTTP ne peut pas transporter, comme un guillemet typographique ou une espace de largeur nulle, la requête échoue avec une erreur qui identifie la paire par sa position. Nécessite Claude Code v2.1.227 ou ultérieur. [Invalid request header value](/docs/fr/errors#invalid-request-header-value) liste le jeu de caractères exact et l'endroit où la vérification s'effectue. Une valeur qui définit un en-tête d'identifiants, d'organisation ou de tenant, de routage ou de comportement de l'API, comme `Authorization` ou `Host`, compte comme un [paramètre nécessitant une approbation](/docs/fr/server-managed-settings#environment-variables-and-the-approval-dialog) lorsque des paramètres gérés par le serveur la fournissent. Depuis les paramètres de projet ou locaux, une telle valeur suit les [règles déterminant quand les valeurs `env` s'appliquent](/docs/fr/settings-reference#when-claude-code-applies-env-values) |159| `ANTHROPIC_CUSTOM_HEADERS` | En-têtes personnalisés à ajouter aux requêtes (format `Name: Value`, séparés par des retours à la ligne pour plusieurs en-têtes). Si un nom ou une valeur contient un caractère qu'un en-tête HTTP ne peut pas transporter, comme un guillemet typographique ou une espace de largeur nulle, la requête échoue avec une erreur qui identifie la paire par sa position. Nécessite Claude Code v2.1.227 ou une version ultérieure. [Invalid request header value](/docs/fr/errors#invalid-request-header-value) indique le jeu de caractères exact et l'endroit où la vérification s'exécute. Une valeur qui définit un en-tête d'identifiants, d'organisation ou de tenant, de routage ou de comportement de l'API, comme `Authorization` ou `Host`, compte comme un [paramètre nécessitant une approbation](/docs/fr/server-managed-settings#environment-variables-and-the-approval-dialog) lorsque les paramètres gérés par le serveur la fournissent. Depuis les paramètres de projet ou locaux, une telle valeur suit les [règles qui déterminent quand les valeurs `env` s'appliquent](/docs/fr/settings-reference#when-claude-code-applies-env-values) |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID de modèle à ajouter comme entrée personnalisée dans le sélecteur `/model`. Utilisez cette variable pour rendre sélectionnable un modèle non standard ou propre à une passerelle sans remplacer les alias intégrés. Voir [Configuration du modèle](/docs/fr/model-config#add-a-custom-model-option) |160| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID de modèle à ajouter comme entrée personnalisée dans le sélecteur `/model`. Utilisez-la pour rendre sélectionnable un modèle non standard ou propre à une passerelle sans remplacer les alias intégrés. Voir [Configuration du modèle](/docs/fr/model-config#add-a-custom-model-option) |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Description affichée pour l'entrée de modèle personnalisé dans le sélecteur `/model`. Valeur par défaut : `Custom model (<model-id>)` lorsqu'elle n'est pas définie |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Description affichée pour l'entrée de modèle personnalisé dans le sélecteur `/model`. Valeur par défaut : `Custom model (<model-id>)` lorsqu'elle n'est pas définie |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nom affiché pour l'entrée de modèle personnalisé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, l'entrée affiche le nom du modèle si Claude Code [reconnaît l'ID](/docs/fr/model-config#customize-pinned-model-display-and-capabilities), et l'ID du modèle sinon |162| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nom affiché pour l'entrée de modèle personnalisé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, l'entrée affiche le nom du modèle si Claude Code [reconnaît l'ID](/docs/fr/model-config#customize-pinned-model-display-and-capabilities), et l'ID du modèle sinon |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Liste, séparée par des virgules, des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle personnalisé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Liste séparée par des virgules des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle personnalisé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID de modèle vers lequel l'alias `fable` est résolu, et ID que Claude Code reconnaît comme un modèle Fable pour le [basculement automatique de modèle](/docs/fr/model-config#automatic-model-fallback) chez les fournisseurs tiers. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |164| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID de modèle vers lequel l'alias `fable` est résolu, et ID que Claude Code reconnaît comme modèle Fable pour le [basculement automatique vers un modèle de secours](/docs/fr/model-config#automatic-model-fallback) chez les fournisseurs tiers. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Description affichée pour le modèle Fable épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par `Custom Fable model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Description affichée pour le modèle Fable épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut qui commence par `Custom Fable model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nom affiché pour le modèle Fable épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |166| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nom affiché pour le modèle Fable épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Liste, séparée par des virgules, des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Fable épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |167| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Liste séparée par des virgules des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Fable épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID de modèle vers lequel l'alias `haiku` est résolu, également utilisé pour les [fonctionnalités en arrière-plan](/docs/fr/costs#background-token-usage). Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID de modèle vers lequel l'alias `haiku` est résolu, également utilisé pour les [fonctionnalités en arrière-plan](/docs/fr/costs#background-token-usage). Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Description affichée pour le modèle Haiku épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par `Custom Haiku model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Description affichée pour le modèle Haiku épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut qui commence par `Custom Haiku model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nom affiché pour le modèle Haiku épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |170| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nom affiché pour le modèle Haiku épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Liste, séparée par des virgules, des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Haiku épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |171| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Liste séparée par des virgules des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Haiku épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

170| `ANTHROPIC_DEFAULT_MODEL` | Modèle sur lequel les nouvelles sessions démarrent par défaut. Nécessite Claude Code v2.1.236 ou ultérieur. Voir [Définir un modèle par défaut pour les nouvelles sessions](/docs/fr/model-config#set-a-default-model-for-new-sessions) |172| `ANTHROPIC_DEFAULT_MODEL` | Modèle sur lequel les nouvelles sessions démarrent par défaut. Nécessite Claude Code v2.1.236 ou une version ultérieure. Voir [Définir un modèle par défaut pour les nouvelles sessions](/docs/fr/model-config#set-a-default-model-for-new-sessions) |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID de modèle vers lequel l'alias `opus` est résolu, et que `opusplan` utilise lorsque le mode plan est actif. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |173| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID de modèle vers lequel l'alias `opus` est résolu, et que `opusplan` utilise lorsque le mode plan est actif. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Description affichée pour le modèle Opus épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par `Custom Opus model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Description affichée pour le modèle Opus épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut qui commence par `Custom Opus model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nom affiché pour le modèle Opus épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |175| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nom affiché pour le modèle Opus épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Liste, séparée par des virgules, des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Opus épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Liste séparée par des virgules des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Opus épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID de modèle vers lequel l'alias `sonnet` est résolu, et que `opusplan` utilise lorsque le mode plan n'est pas actif. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID de modèle vers lequel l'alias `sonnet` est résolu, et que `opusplan` utilise lorsque le mode plan n'est pas actif. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Description affichée pour le modèle Sonnet épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par `Custom Sonnet model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Description affichée pour le modèle Sonnet épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut qui commence par `Custom Sonnet model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nom affiché pour le modèle Sonnet épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |179| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nom affiché pour le modèle Sonnet épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Liste, séparée par des virgules, des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Sonnet épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |180| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Liste séparée par des virgules des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Sonnet épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

179| `ANTHROPIC_FEDERATION_RULE_ID` | ID de règle de fédération pour [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Lorsque vous la définissez avec `ANTHROPIC_ORGANIZATION_ID`, Claude Code sélectionne les identifiants de fédération, qui sont prioritaires sur vos identifiants `/login`. Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |181| `ANTHROPIC_FEDERATION_RULE_ID` | ID de règle de fédération pour [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Lorsque vous la définissez avec `ANTHROPIC_ORGANIZATION_ID`, Claude Code sélectionne les identifiants de fédération, qui sont prioritaires sur vos identifiants `/login`. Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |

180| `ANTHROPIC_FOUNDRY_API_KEY` | Clé API pour l'authentification Microsoft Foundry (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |182| `ANTHROPIC_FOUNDRY_API_KEY` | Clé API pour l'authentification Microsoft Foundry (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |

181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Jeton Bearer pour l'authentification Microsoft Foundry, comme un jeton d'accès Microsoft Entra. Claude Code l'envoie dans l'en-tête `Authorization: Bearer`. Prioritaire sur `ANTHROPIC_FOUNDRY_API_KEY` et sur la chaîne d'identifiants par défaut d'Azure. Voir [Microsoft Foundry](/docs/fr/microsoft-foundry). Nécessite Claude Code v2.1.203 ou ultérieur |183| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Jeton Bearer pour l'authentification Microsoft Foundry, comme un jeton d'accès Microsoft Entra. Claude Code l'envoie dans l'en-tête `Authorization: Bearer`. Prioritaire sur `ANTHROPIC_FOUNDRY_API_KEY` et sur la chaîne d'identifiants par défaut d'Azure. Voir [Microsoft Foundry](/docs/fr/microsoft-foundry). Nécessite Claude Code v2.1.203 ou une version ultérieure |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | URL de base complète de la ressource Microsoft Foundry (par exemple, `https://my-resource.services.ai.azure.com/anthropic`). Alternative à `ANTHROPIC_FOUNDRY_RESOURCE` (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |184| `ANTHROPIC_FOUNDRY_BASE_URL` | URL de base complète de la ressource Microsoft Foundry (par exemple, `https://my-resource.services.ai.azure.com/anthropic`). Alternative à `ANTHROPIC_FOUNDRY_RESOURCE` (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Nom de la ressource Microsoft Foundry (par exemple, `my-resource`). Claude Code [refuse une URL ou un nom d'hôte](/docs/fr/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Requis si `ANTHROPIC_FOUNDRY_BASE_URL` n'est pas définie (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |185| `ANTHROPIC_FOUNDRY_RESOURCE` | Nom de la ressource Microsoft Foundry (par exemple, `my-resource`). Claude Code [refuse une URL ou un nom d'hôte](/docs/fr/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Requise si `ANTHROPIC_FOUNDRY_BASE_URL` n'est pas définie (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |

184| `ANTHROPIC_MODEL` | Nom du paramètre de modèle à utiliser (voir [Configuration du modèle](/docs/fr/model-config#environment-variables)) |186| `ANTHROPIC_MODEL` | Nom du paramètre de modèle à utiliser (voir [Configuration du modèle](/docs/fr/model-config#environment-variables)) |

185| `ANTHROPIC_ORGANIZATION_ID` | ID d'organisation pour [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Définissez-la avec `ANTHROPIC_FEDERATION_RULE_ID`. Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |187| `ANTHROPIC_ORGANIZATION_ID` | ID d'organisation pour [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Définissez-la avec `ANTHROPIC_FEDERATION_RULE_ID`. Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |

186| `ANTHROPIC_PROFILE` | Nom du profil Anthropic avec lequel s'authentifier, comme un profil créé par [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) ou en [se connectant à un compte Console sans clé API](/docs/fr/authentication#sign-in-without-an-api-key). Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |188| `ANTHROPIC_PROFILE` | Nom du profil Anthropic avec lequel s'authentifier, comme un profil créé par [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) ou en [vous connectant à un compte Console sans clé API](/docs/fr/authentication#sign-in-without-an-api-key). Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |

187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DÉPRÉCIÉ] Nom du [modèle de classe Haiku pour les tâches en arrière-plan](/docs/fr/costs) |189| `ANTHROPIC_SMALL_FAST_MODEL` | \[DÉPRÉCIÉE] Nom du [modèle de classe Haiku pour les tâches en arrière-plan](/docs/fr/costs) |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Remplace la région AWS pour le modèle de classe Haiku lors de l'utilisation d'Amazon Bedrock ou d'Amazon Bedrock Mantle. Sur Amazon Bedrock, ne prend effet que lorsque `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou la variable dépréciée `ANTHROPIC_SMALL_FAST_MODEL` est également définie, car sinon Amazon Bedrock exécute les tâches en arrière-plan sur le [modèle Sonnet par défaut ou le modèle principal](/docs/fr/amazon-bedrock#4-pin-model-versions) dans la région de la session |190| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Remplace la région AWS pour le modèle de classe Haiku lors de l'utilisation d'Amazon Bedrock ou d'Amazon Bedrock Mantle. Sur Amazon Bedrock, elle ne prend effet que lorsque `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou la variable dépréciée `ANTHROPIC_SMALL_FAST_MODEL` est également définie, car sinon Amazon Bedrock exécute les tâches en arrière-plan sur le [modèle Sonnet par défaut ou le modèle principal](/docs/fr/amazon-bedrock#4-pin-model-versions) dans la région de la session |

189| `ANTHROPIC_VERTEX_BASE_URL` | Remplace l'URL de l'endpoint Google Cloud's Agent Platform. À utiliser pour des endpoints Google Cloud's Agent Platform personnalisés ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Voir [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) |191| `ANTHROPIC_VERTEX_BASE_URL` | Remplace l'URL de l'endpoint de Google Cloud's Agent Platform. À utiliser pour des endpoints Google Cloud's Agent Platform personnalisés ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Voir [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID du projet GCP auquel les requêtes Google Cloud's Agent Platform sont adressées. Voir [Configurer les identifiants GCP](/docs/fr/google-vertex-ai#3-configure-gcp-credentials) |192| `ANTHROPIC_VERTEX_PROJECT_ID` | ID du projet GCP auquel les requêtes Google Cloud's Agent Platform sont adressées. Voir [Configurer les identifiants GCP](/docs/fr/google-vertex-ai#3-configure-gcp-credentials) |

191| `ANTHROPIC_WORKSPACE_ID` | ID d'espace de travail pour [workload identity federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Définissez-la lorsque votre règle de fédération couvre plus d'un espace de travail, afin que l'échange de jetons sache quel espace de travail cibler |193| `ANTHROPIC_WORKSPACE_ID` | ID d'espace de travail pour la [fédération d'identité de charge de travail](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Définissez-la lorsque votre règle de fédération couvre plusieurs espaces de travail, afin que l'échange de jetons sache quel espace de travail cibler |

192| `API_FORCE_IDLE_TIMEOUT` | Remplace le délai d'inactivité de 5 minutes sur le corps de la réponse, qui interrompt une réponse de modèle en streaming lorsqu'aucun octet n'arrive. Définissez `0` pour désactiver ce délai, par exemple lorsqu'une [passerelle](/docs/fr/llm-gateway) lente ou un modèle local marque des pauses de plus de 5 minutes entre les fragments, ou `1` pour le conserver chez tous les fournisseurs. Lorsque la variable n'est pas définie, le délai est actif chez les fournisseurs autres que l'API Anthropic directe, [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et Amazon Bedrock avec `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` défini. Les [watchdogs de flux](/docs/fr/network-config#streaming-idle-watchdogs) fonctionnent indépendamment et interrompent une longue pause silencieuse même si vous définissez `0` ici |194| `API_FORCE_IDLE_TIMEOUT` | Remplace le délai d'inactivité de 5 minutes sur le corps de la réponse, qui interrompt une réponse de modèle en streaming lorsqu'aucun octet n'arrive. Définissez `0` pour désactiver ce délai, par exemple lorsqu'une [passerelle](/docs/fr/llm-gateway) lente ou un modèle local marque des pauses de plus de 5 minutes entre les blocs, ou `1` pour le maintenir actif chez tous les fournisseurs. Lorsqu'elle n'est pas définie, le délai est actif chez les fournisseurs autres que l'API Anthropic directe, [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et Amazon Bedrock avec `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` défini. Les [watchdogs de streaming](/docs/fr/network-config#streaming-idle-watchdogs) fonctionnent indépendamment de ce délai et interrompent une longue pause silencieuse même lorsque vous définissez `0` ici |

193| `API_TIMEOUT_MS` | Délai d'expiration des requêtes API en millisecondes (par défaut : 600000, soit 10 minutes ; maximum : 2147483647). Augmentez-le lorsque les requêtes expirent sur des réseaux lents ou lors du routage via un proxy. Les valeurs supérieures au maximum font déborder le minuteur sous-jacent et provoquent l'échec immédiat des requêtes |195| `API_TIMEOUT_MS` | Délai d'expiration des requêtes API en millisecondes (par défaut : 600000, soit 10 minutes ; maximum : 2147483647). Augmentez-le lorsque les requêtes expirent sur des réseaux lents ou lors du routage via un proxy. Les valeurs supérieures au maximum font déborder le minuteur sous-jacent et provoquent l'échec immédiat des requêtes |

194| `AWS_BEARER_TOKEN_BEDROCK` | Clé API Amazon Bedrock pour l'authentification (voir [Clés API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |196| `AWS_BEARER_TOKEN_BEDROCK` | Clé API Amazon Bedrock pour l'authentification (voir [Clés API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

195| `BASH_DEFAULT_TIMEOUT_MS` | Délai d'expiration par défaut d'une commande de l'outil Bash ou PowerShell au premier plan, en millisecondes (par défaut : 120000, soit 2 minutes). Une valeur par défaut supérieure à 30 minutes devient également la [limite de temps par défaut des commandes en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands) dans les sessions sans surveillance. La limite de temps en arrière-plan nécessite Claude Code v2.1.285 ou ultérieur |197| `BASH_DEFAULT_TIMEOUT_MS` | Délai d'expiration par défaut d'une commande d'outil Bash ou PowerShell au premier plan, en millisecondes (par défaut : 120000, soit 2 minutes). Une valeur par défaut supérieure à 30 minutes devient également la [limite de temps par défaut des commandes en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands) dans les sessions sans surveillance. La limite de temps en arrière-plan nécessite Claude Code v2.1.285 ou une version ultérieure |

196| `BASH_MAX_OUTPUT_LENGTH` | Nombre maximal de caractères de la sortie bash que Claude Code réintègre dans le résultat d'une commande (par défaut : 30000 ; maximum : 150000). Si vous définissez le paramètre [`bashOutputMaxChars`](/docs/fr/settings-reference#bashoutputmaxchars), Claude Code ignore cette variable. Voir [Limites de sortie](/docs/fr/tools-reference#output-limits) |198| `BASH_MAX_OUTPUT_LENGTH` | Nombre maximal de caractères de la sortie bash que Claude Code réintègre dans le résultat d'une commande (par défaut : 30000 ; maximum : 150000). Si vous définissez le paramètre [`bashOutputMaxChars`](/docs/fr/settings-reference#bashoutputmaxchars), Claude Code ignore cette variable. Voir [Limites de sortie](/docs/fr/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | Délai d'expiration maximal que le modèle peut définir pour une commande de l'outil Bash ou PowerShell au premier plan, en millisecondes (par défaut : 600000, soit 10 minutes). Le plafond effectif est la plus grande valeur entre celle-ci et `BASH_DEFAULT_TIMEOUT_MS`. Un plafond effectif supérieur à 2 heures devient également la [limite de temps maximale des commandes en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands) dans les sessions sans surveillance. La limite de temps en arrière-plan nécessite Claude Code v2.1.285 ou ultérieur |199| `BASH_MAX_TIMEOUT_MS` | Délai d'expiration maximal que le modèle peut définir pour une commande d'outil Bash ou PowerShell au premier plan, en millisecondes (par défaut : 600000, soit 10 minutes). Le plafond effectif est la plus grande valeur entre celle-ci et `BASH_DEFAULT_TIMEOUT_MS`. Un plafond effectif supérieur à 2 heures devient également la [limite de temps maximale des commandes en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands) dans les sessions sans surveillance. La limite de temps en arrière-plan nécessite Claude Code v2.1.285 ou une version ultérieure |

198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP/HTTP pour le [tracing bêta détaillé](/docs/fr/monitoring-usage#traces-beta) : avec `ENABLE_BETA_TRACING_DETAILED=1`, les logs et les traces y sont envoyés au lieu des exportateurs configurés. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |200| `BETA_TRACING_ENDPOINT` | Endpoint OTLP/HTTP pour le [tracing bêta détaillé](/docs/fr/monitoring-usage#traces-beta) : avec `ENABLE_BETA_TRACING_DETAILED=1`, les logs et les traces y sont envoyés au lieu des exportateurs configurés. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |

199| `CCR_FORCE_BUNDLE` | Définissez `1` pour forcer [`claude --cloud`](/docs/fr/claude-code-on-the-web#send-local-repositories-without-github) à empaqueter et téléverser votre dépôt local au lieu de le cloner depuis son remote |201| `CCR_FORCE_BUNDLE` | Définissez sur `1` pour forcer [`claude --cloud`](/docs/fr/claude-code-on-the-web#send-local-repositories-without-github) à empaqueter et téléverser votre dépôt local au lieu de le cloner depuis son dépôt distant |

200| `CLAUDECODE` | Définie à `1` dans les sous-processus lancés par Claude Code (outils Bash et PowerShell, sessions tmux, commandes de [hook](/docs/fr/hooks), commandes de [barre de statut](/docs/fr/statusline), sous-processus de [serveur MCP](/docs/fr/mcp) stdio). Les extensions IDE la définissent également dans leurs terminaux intégrés. Utilisez-la pour détecter lorsqu'un script s'exécute dans un sous-processus lancé par Claude Code. Pour vérifier si le processus actuel a été lancé directement par un appel d'outil ou un hook, plutôt qu'à l'intérieur d'un serveur MCP stdio démarré par Claude Code, utilisez plutôt `CLAUDE_CODE_CHILD_SESSION` |202| `CLAUDECODE` | Définie sur `1` dans les sous-processus lancés par Claude Code (outils Bash et PowerShell, sessions tmux, commandes de [hook](/docs/fr/hooks), commandes de [barre de statut](/docs/fr/statusline), sous-processus de [serveur MCP](/docs/fr/mcp) stdio). Les extensions IDE la définissent également dans leurs terminaux intégrés. Utilisez-la pour détecter quand un script s'exécute dans un sous-processus lancé par Claude Code. Pour vérifier si le processus actuel a été lancé directement par un appel d'outil ou un hook, plutôt qu'à l'intérieur d'un serveur MCP stdio démarré par Claude Code, utilisez plutôt `CLAUDE_CODE_CHILD_SESSION` |

201| `CLAUDE_AFK_COUNTDOWN_MS` | Nombre de millisecondes avant la poursuite automatique auquel le compte à rebours s'affiche à l'écran sur une boîte de dialogue [`AskUserQuestion`](/docs/fr/tools-reference) restée sans réponse. Par défaut `20000` (20 secondes), plafonné au délai de poursuite automatique. N'a aucun effet si la poursuite automatique n'est pas activée ; voir le paramètre [`askUserQuestionTimeout`](/docs/fr/settings-reference#askuserquestiontimeout) et `CLAUDE_AFK_TIMEOUT_MS`. Nécessite Claude Code v2.1.198 ou ultérieur |203| `CLAUDE_AFK_COUNTDOWN_MS` | Nombre de millisecondes avant la poursuite automatique à partir duquel le compte à rebours s'affiche à l'écran sur une boîte de dialogue [`AskUserQuestion`](/docs/fr/tools-reference) restée sans réponse. Valeur par défaut `20000` (20 secondes), plafonnée au délai de poursuite automatique. Sans effet si la poursuite automatique n'est pas activée ; voir le paramètre [`askUserQuestionTimeout`](/docs/fr/settings-reference#askuserquestiontimeout) et `CLAUDE_AFK_TIMEOUT_MS`. Nécessite Claude Code v2.1.198 ou une version ultérieure |

202| `CLAUDE_AFK_TIMEOUT_MS` | Nombre de millisecondes d'inactivité avant qu'une boîte de dialogue [`AskUserQuestion`](/docs/fr/tools-reference) restée sans réponse ne se poursuive automatiquement sans vous. La poursuite automatique est désactivée par défaut ; activez-la avec le paramètre [`askUserQuestionTimeout`](/docs/fr/settings-reference#askuserquestiontimeout). Cette variable est un remplacement destiné aux démos et aux tests automatisés : lorsqu'elle est définie, elle a priorité sur ce paramètre et active la poursuite automatique même si le paramètre n'est pas défini ou vaut `never`. Définir `0` ne désactive pas le délai ; cela ferme immédiatement la boîte de dialogue. Dans les v2.1.198 et v2.1.199, la poursuite automatique était activée par défaut avec un délai de `60000` (60 secondes). Nécessite Claude Code v2.1.198 ou ultérieur |204| `CLAUDE_AFK_TIMEOUT_MS` | Nombre de millisecondes d'inactivité avant qu'une boîte de dialogue [`AskUserQuestion`](/docs/fr/tools-reference) restée sans réponse ne se poursuive automatiquement sans vous. La poursuite automatique est désactivée par défaut ; activez-la avec le paramètre [`askUserQuestionTimeout`](/docs/fr/settings-reference#askuserquestiontimeout). Cette variable est un remplacement destiné aux démos et aux tests automatisés : lorsqu'elle est définie, elle a priorité sur ce paramètre et active la poursuite automatique même lorsque le paramètre n'est pas défini ou vaut `never`. Définir `0` ne désactive pas le délai ; cela ferme immédiatement la boîte de dialogue. Dans les v2.1.198 et v2.1.199, la poursuite automatique était activée par défaut avec un délai de `60000` (60 secondes). Nécessite Claude Code v2.1.198 ou une version ultérieure |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Définissez `1` pour désactiver tous les types de [sous-agents](/docs/fr/sub-agents) intégrés, comme Explore et Plan. S'applique uniquement en mode non interactif (le flag `-p`). Utile pour les utilisateurs du SDK qui veulent partir de zéro. Cela supprime également `general-purpose`, le sous-agent que Claude Code exécute lorsqu'un appel de l'outil Agent omet `subagent_type`. Un tel appel échoue alors avec [`subagent_type is required`](/docs/fr/errors#subagent-type-is-required) |205| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Définissez sur `1` pour désactiver tous les types de [sous-agents](/docs/fr/sub-agents) intégrés, comme Explore et Plan. Ne s'applique qu'en mode non interactif (le flag `-p`). Utile pour les utilisateurs du SDK qui veulent partir de zéro. Cela supprime également `general-purpose`, le sous-agent que Claude Code exécute lorsqu'un appel de l'outil Agent omet `subagent_type`. Un tel appel échoue alors avec [`subagent_type is required`](/docs/fr/errors#subagent-type-is-required) |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Définissez `1` pour omettre le préfixe `mcp__<server>__` sur les noms d'outils des serveurs MCP créés par le SDK. Les outils utilisent leurs noms d'origine. Usage SDK uniquement |206| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Définissez sur `1` pour omettre le préfixe `mcp__<server>__` des noms d'outils provenant des serveurs MCP créés par le SDK. Les outils utilisent leurs noms d'origine. Utilisation avec le SDK uniquement |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Délai de blocage en millisecondes pour les sous-agents. Par défaut `600000` (10 minutes) ; si vous augmentez `CLAUDE_STREAM_IDLE_TIMEOUT_MS` alors que le watchdog de flux est activé, la valeur par défaut augmente avec elle, comme le décrit [Gérer les réponses API lentes ou bloquées](/docs/fr/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Le minuteur est réinitialisé à chaque événement de progression du streaming ; si aucune progression n'arrive dans cet intervalle, Claude Code interrompt le sous-agent et signale le blocage au parent |207| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Délai de blocage en millisecondes pour les sous-agents. Valeur par défaut `600000` (10 minutes) ; si vous augmentez `CLAUDE_STREAM_IDLE_TIMEOUT_MS` alors que le watchdog de flux est actif, la valeur par défaut augmente en conséquence, comme le décrit [Gérer les réponses API lentes ou bloquées](/docs/fr/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Le minuteur se réinitialise à chaque événement de progression du streaming ; si aucune progression n'arrive dans l'intervalle, Claude Code interrompt le sous-agent et signale le blocage au parent |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Définit le pourcentage (1-100) de la fenêtre de compaction automatique à partir duquel la compaction automatique se déclenche. Utilisez des valeurs plus basses comme `50` pour compacter plus tôt ; la variable ne peut pas relever le seuil, donc les valeurs supérieures au pourcentage par défaut sont ignorées. Elle s'applique uniquement dans les sessions qui [compactent avant la limite de contexte du modèle](/docs/fr/model-config#context-window-and-auto-compaction). S'applique à la fois aux conversations principales et aux sous-agents |208| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Définit le pourcentage (1-100) de la fenêtre de compaction automatique auquel la compaction automatique se déclenche. Utilisez des valeurs plus basses comme `50` pour compacter plus tôt ; la variable ne peut pas relever le seuil, donc les valeurs supérieures au pourcentage par défaut sont ignorées. Elle ne s'applique que dans les sessions qui [compactent avant la limite de contexte du modèle](/docs/fr/model-config#context-window-and-auto-compaction). S'applique aussi bien aux conversations principales qu'aux sous-agents |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Définissez `1` pour forcer l'activation de la mise en arrière-plan automatique des tâches d'agent de longue durée. Lorsqu'elle est activée, les sous-agents passent en arrière-plan après environ deux minutes d'exécution. Active également la [mise en arrière-plan automatique des longs appels d'outils MCP](/docs/fr/mcp#automatic-backgrounding-of-long-tool-calls) en mode non interactif sur Claude Code v2.1.212 ou ultérieur |209| `CLAUDE_AUTO_BACKGROUND_TASKS` | Définissez sur `1` pour forcer l'activation de la mise en arrière-plan automatique des tâches d'agent de longue durée. Lorsqu'elle est activée, les sous-agents passent en arrière-plan après environ deux minutes d'exécution. Active également la [mise en arrière-plan automatique des appels d'outils MCP longs](/docs/fr/mcp#automatic-backgrounding-of-long-tool-calls) en mode non interactif sur Claude Code v2.1.212 ou une version ultérieure |

208| `CLAUDE_AX_PREPARK_MS` | En [mode lecteur d'écran](/docs/fr/accessibility), nombre de millisecondes que Claude Code attend avant d'écrire une ligne nouvelle ou modifiée. Par défaut `0`, donc Claude Code n'attend pas. Avant la v2.1.287, la valeur par défaut était `50`. Claude Code plafonne l'attente à `5000`. Nécessite Claude Code v2.1.233 ou ultérieur |210| `CLAUDE_AX_PREPARK_MS` | En [mode lecteur d'écran](/docs/fr/accessibility), nombre de millisecondes que Claude Code attend avant d'écrire une ligne nouvelle ou modifiée. Valeur par défaut `0`, donc Claude Code n'attend pas. Avant la v2.1.287, la valeur par défaut était `50`. Claude Code plafonne l'attente à `5000`. Nécessite Claude Code v2.1.233 ou une version ultérieure |

209| `CLAUDE_AX_SCREEN_READER` | Définissez `1` pour produire une sortie adaptée aux lecteurs d'écran : du texte brut sans bordures décoratives ni animations. Définissez `0` pour forcer la désactivation du mode lecteur d'écran même lorsque [`axScreenReader`](/docs/fr/settings-reference#axscreenreader) vaut `true`. Le flag [`--ax-screen-reader`](/docs/fr/cli-reference#cli-flags) est prioritaire. Nécessite Claude Code v2.1.181 ou ultérieur |211| `CLAUDE_AX_SCREEN_READER` | Définissez sur `1` pour produire une sortie adaptée aux lecteurs d'écran : du texte brut sans bordures décoratives ni animations. Définissez sur `0` pour forcer la désactivation du mode lecteur d'écran même lorsque [`axScreenReader`](/docs/fr/settings-reference#axscreenreader) vaut `true`. Le flag [`--ax-screen-reader`](/docs/fr/cli-reference#cli-flags) est prioritaire. Nécessite Claude Code v2.1.181 ou une version ultérieure |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | En [mode lecteur d'écran](/docs/fr/accessibility), nombre de millisecondes pendant lesquelles Claude Code retient le premier rendu de l'interface après la ligne de confirmation de démarrage, afin que votre lecteur d'écran puisse lire la ligne en entier avant qu'une nouvelle sortie ne l'interrompe. Par défaut `3000`. Définissez `0` pour un rendu immédiat. Claude Code plafonne cette attente à `600000` (10 minutes). Votre première frappe met fin à l'attente plus tôt. Nécessite Claude Code v2.1.217 ou ultérieur |212| `CLAUDE_AX_STARTUP_QUIET_MS` | En [mode lecteur d'écran](/docs/fr/accessibility), nombre de millisecondes pendant lesquelles Claude Code retient le premier rendu de l'interface après la ligne de confirmation de démarrage, afin que votre lecteur d'écran puisse lire la ligne en entier avant qu'une nouvelle sortie ne l'interrompe. Valeur par défaut `3000`. Définissez `0` pour un rendu immédiat. Claude Code plafonne cette attente à `600000` (10 minutes). Votre première frappe au clavier met fin à l'attente plus tôt. Nécessite Claude Code v2.1.217 ou une version ultérieure |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Revenir au répertoire de travail d'origine après chaque commande Bash ou PowerShell dans la session principale |213| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Revenir au répertoire de travail d'origine après chaque commande Bash ou PowerShell dans la session principale |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration en millisecondes du watchdog d'inactivité du streaming au niveau des octets ; lorsqu'elle est définie, elle a priorité sur `CLAUDE_STREAM_IDLE_TIMEOUT_MS` pour ce watchdog et laisse inchangé le watchdog au niveau des événements. Claude Code limite cette variable entre 10 secondes et 30 minutes. Nécessite Claude Code v2.1.210 ou ultérieur |214| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration en millisecondes du watchdog d'inactivité du streaming au niveau des octets ; lorsqu'elle est définie, elle a priorité sur `CLAUDE_STREAM_IDLE_TIMEOUT_MS` pour ce watchdog et laisse inchangé le watchdog au niveau des événements. Claude Code limite cette variable à une valeur comprise entre 10 secondes et 30 minutes. Nécessite Claude Code v2.1.210 ou une version ultérieure |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | Chemin vers un fichier qu'un outil externe, comme un écouteur de verrouillage d'écran, crée lorsque vous déverrouillez votre écran et supprime lorsque vous le verrouillez. Tant que le fichier existe, Claude Code n'envoie pas les [notifications push mobiles de Remote Control](/docs/fr/remote-control#mobile-push-notifications), de sorte que vous ne recevez plus de notifications pendant que vous utilisez activement l'ordinateur. Lorsque le fichier est absent ou illisible, les notifications sont envoyées normalement. Claude Code vérifie le fichier une fois par événement déclenchant une notification push plutôt que de l'interroger en continu. Nécessite Claude Code v2.1.181 ou ultérieur |215| `CLAUDE_CLIENT_PRESENCE_FILE` | Chemin d'un fichier qu'un outil externe, comme un écouteur de verrouillage d'écran, crée lorsque vous déverrouillez votre écran et supprime lorsque vous le verrouillez. Tant que le fichier existe, Claude Code ignore les [notifications push mobiles de Remote Control](/docs/fr/remote-control#mobile-push-notifications), afin que vous ne receviez plus de notifications push lorsque vous utilisez activement l'ordinateur. Lorsque le fichier est absent ou illisible, les notifications sont envoyées normalement. Claude Code vérifie le fichier une fois par événement déclenchant une notification push plutôt que de l'interroger en continu. Nécessite Claude Code v2.1.181 ou une version ultérieure |

214| `CLAUDE_CODE_ACCESSIBILITY` | Définissez `1` pour garder visible le curseur natif du terminal et désactiver l'indicateur de curseur en texte inversé. Permet aux loupes d'écran comme le Zoom de macOS de suivre la position du curseur |216| `CLAUDE_CODE_ACCESSIBILITY` | Définissez sur `1` pour garder visible le curseur natif du terminal et désactiver l'indicateur de curseur en texte inversé. Permet aux loupes d'écran comme Zoom de macOS de suivre la position du curseur |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Définissez `1` pour charger les fichiers de mémoire depuis les répertoires spécifiés avec `--add-dir`. Charge `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` et `CLAUDE.local.md`. Par défaut, les répertoires supplémentaires ne chargent pas de fichiers de mémoire |217| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Définissez sur `1` pour charger les fichiers de mémoire des répertoires spécifiés avec `--add-dir`. Charge `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` et `CLAUDE.local.md`. Par défaut, les répertoires supplémentaires ne chargent pas de fichiers de mémoire |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Définissez `1` pour redessiner l'écran entier à chaque image en [rendu plein écran](/docs/fr/fullscreen) au lieu d'envoyer des mises à jour incrémentielles. Utilisez-la si le mode plein écran affiche des fragments de texte obsolètes ou mal placés. Claude Code l'active automatiquement pour les sessions en arrière-plan et la [vue des agents](/docs/fr/agent-view) sous Windows |218| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Définissez sur `1` pour redessiner l'écran entier à chaque image dans le [rendu plein écran](/docs/fr/fullscreen) au lieu d'envoyer des mises à jour incrémentielles. Utilisez-la si le mode plein écran affiche des fragments de texte obsolètes ou mal placés. Claude Code l'active automatiquement pour les sessions en arrière-plan et la [vue des agents](/docs/fr/agent-view) sous Windows |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Définissez `1` pour envoyer le paramètre [effort](/docs/fr/model-config#adjust-effort-level) avec chaque requête, même lorsque Claude Code ne reconnaît pas l'ID du modèle comme prenant en charge l'effort. Utilisez-la lors du routage via une [passerelle LLM](/docs/fr/llm-gateway) ou un fournisseur tiers qui sert des modèles sous des identifiants personnalisés. Les modèles qui rejettent le paramètre effort au niveau de l'API, notamment les modèles Claude 3, Sonnet 4.0 et 4.5, Opus 4.0 et 4.1, et Haiku 4.5, restent exclus afin que les requêtes n'échouent pas |219| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Définissez sur `1` pour envoyer le paramètre [effort](/docs/fr/model-config#adjust-effort-level) avec chaque requête, même lorsque Claude Code ne reconnaît pas l'ID du modèle comme compatible avec l'effort. Utilisez-la lors du routage via une [passerelle LLM](/docs/fr/llm-gateway) ou un fournisseur tiers qui sert des modèles sous des identifiants personnalisés. Les modèles qui rejettent le paramètre effort au niveau de l'API, notamment les modèles Claude 3, Sonnet 4.0 et 4.5, Opus 4.0 et 4.1, et Haiku 4.5, restent exclus afin que les requêtes n'échouent pas |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalle en millisecondes auquel les identifiants doivent être actualisés (lors de l'utilisation de [`apiKeyHelper`](/docs/fr/settings-reference#apikeyhelper)) |220| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalle en millisecondes auquel les identifiants doivent être actualisés (lors de l'utilisation de [`apiKeyHelper`](/docs/fr/settings-reference#apikeyhelper)) |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Définissez `0` pour empêcher Claude Code d'ouvrir automatiquement le navigateur lorsqu'un nouvel [artefact](/docs/fr/artifacts#create-an-artifact) est publié |221| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Définissez sur `0` pour empêcher Claude Code d'ouvrir automatiquement le navigateur lorsqu'un nouvel [artefact](/docs/fr/artifacts#create-an-artifact) est publié |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Définissez `0` pour empêcher Claude de lire les [commentaires sur un artefact](/docs/fr/artifacts#collect-comments-on-an-artifact) et d'y répondre. Sans effet lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` a [désactivé les artefacts](/docs/fr/artifacts#availability). Nécessite Claude Code v2.1.221 ou ultérieur |222| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Définissez sur `0` pour que Claude cesse de lire les [commentaires sur un artefact](/docs/fr/artifacts#collect-comments-on-an-artifact) et d'y répondre. Sans effet lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` a [désactivé les artefacts](/docs/fr/artifacts#availability). Nécessite Claude Code v2.1.221 ou une version ultérieure |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Définissez `0` pour empêcher Claude de [répondre de lui-même aux commentaires qui lui sont envoyés](/docs/fr/artifacts#let-claude-reply-to-comments-on-its-own). Nécessite Claude Code v2.1.228 ou ultérieur |223| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Définissez sur `0` pour que Claude cesse de [répondre de lui-même aux commentaires qui lui sont envoyés](/docs/fr/artifacts#let-claude-reply-to-comments-on-its-own). Nécessite Claude Code v2.1.228 ou une version ultérieure |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Définissez `0` pour omettre le [bloc d'attribution](/docs/fr/llm-gateway-protocol#system-prompt-attribution-block), qui contient la version du client et une empreinte du prompt, au début du prompt système. La mise en cache sur une connexion directe à l'API Anthropic n'est pas affectée dans les deux cas. Dans certaines configurations de connexion directe, Claude Code conserve le bloc sur les requêtes du classifieur du [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) même lorsque vous définissez `0`. Dans [Bloc d'attribution du prompt système](/docs/fr/llm-gateway-protocol#system-prompt-attribution-block), vérifiez quelles connexions et quels identifiants sont concernés. Avant la v2.1.181, le bloc incluait un jeton par requête sur les URL de base personnalisées et les connexions Microsoft Foundry ; sur ces versions, définissez donc `0` lorsque votre passerelle LLM met en cache sur la base du corps de la requête ou transmet les requêtes à un fournisseur tiers, ou lorsque vous vous connectez directement à Microsoft Foundry |224| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Définissez sur `0` pour omettre le [bloc d'attribution](/docs/fr/llm-gateway-protocol#system-prompt-attribution-block), qui contient la version du client et une empreinte du prompt, au début du prompt système. La mise en cache sur une connexion directe à l'API Anthropic n'est affectée dans aucun cas. Dans certaines configurations à connexion directe, Claude Code conserve le bloc dans les requêtes du classifieur du [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) même lorsque vous définissez `0`. Dans [Bloc d'attribution du prompt système](/docs/fr/llm-gateway-protocol#system-prompt-attribution-block), vérifiez quelles connexions et quels identifiants sont concernés. Avant la v2.1.181, le bloc incluait un jeton propre à chaque requête sur les URL de base personnalisées et les connexions Microsoft Foundry ; sur ces versions, définissez-la donc sur `0` lorsque votre passerelle LLM met en cache en fonction du corps de la requête ou transmet les requêtes à un fournisseur tiers, ou lorsque vous vous connectez directement à Microsoft Foundry |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Supprimée dans la v2.1.283. Utilisez plutôt `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |225| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Supprimée dans la v2.1.283. Utilisez plutôt `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Définit la [fenêtre de compaction automatique](/docs/fr/model-config#set-the-auto-compact-window) en tokens, de `100000` à `1000000`. N'accepte qu'un entier simple comme `500000` : une valeur comme `500k` est lue comme `500` et ramenée au minimum de 100K. La fenêtre effective est également plafonnée à la fenêtre de contexte du modèle. Prioritaire sur la commande `/autocompact`, le flag `--autocompact` et le paramètre `autoCompactWindow`. Le `used_percentage` de la barre de statut se mesure toujours par rapport à la fenêtre de contexte complète du modèle ; une fois cette variable définie, ce pourcentage n'indique donc plus quand la compaction aura lieu |226| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Définit la [fenêtre de compaction automatique](/docs/fr/model-config#set-the-auto-compact-window) en tokens, de `100000` à `1000000`. N'accepte qu'un entier simple comme `500000` : une valeur comme `500k` est lue comme `500` et ramenée au minimum de 100K. La fenêtre effective est également plafonnée à la fenêtre de contexte du modèle. Prioritaire sur la commande `/autocompact`, le flag `--autocompact` et le paramètre `autoCompactWindow`. Le `used_percentage` de la barre de statut se mesure toujours par rapport à la fenêtre de contexte complète du modèle ; une fois cette variable définie, ce pourcentage n'indique donc plus quand la compaction aura lieu |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Remplace la [connexion automatique à l'IDE](/docs/fr/vs-code). Par défaut, Claude Code se connecte automatiquement lorsqu'il est lancé dans le terminal intégré d'un IDE pris en charge. Définissez `false` pour l'empêcher. Définissez `true` pour forcer une tentative de connexion lorsque la détection automatique échoue, par exemple lorsque tmux masque le terminal parent. Prioritaire sur le paramètre de configuration globale [`autoConnectIde`](/docs/fr/settings-reference#autoconnectide) |227| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Remplace la [connexion automatique à l'IDE](/docs/fr/vs-code). Par défaut, Claude Code se connecte automatiquement lorsqu'il est lancé dans le terminal intégré d'un IDE pris en charge. Définissez sur `false` pour l'empêcher. Définissez sur `true` pour forcer une tentative de connexion lorsque la détection automatique échoue, par exemple lorsque tmux masque le terminal parent. Prioritaire sur le paramètre de configuration globale [`autoConnectIde`](/docs/fr/settings-reference#autoconnectide) |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Contrôle si Claude Code demande au serveur d'[examiner les actions du mode auto](/docs/fr/permission-modes#server-side-classifier-review). Définissez `0` pour utiliser plutôt les propres requêtes de classifieur de Claude Code. Sur une connexion directe à l'API Anthropic, nécessite la v2.1.281 ou ultérieure. La section liée indique quelles sessions interrogent le serveur lorsque la variable n'est pas définie, et à partir de quelle version. Nécessite Claude Code v2.1.271 ou ultérieur |228| `CLAUDE_CODE_AUTO_MODE_SERVER` | Contrôle si Claude Code demande au serveur d'[examiner les actions du mode auto](/docs/fr/permission-modes#server-side-classifier-review). Définissez sur `0` pour utiliser plutôt les propres requêtes de classifieur de Claude Code. Sur une connexion directe à l'API Anthropic, nécessite la v2.1.281 ou une version ultérieure. La section liée indique quelles sessions interrogent le serveur lorsque la variable n'est pas définie, et à partir de quelle version. Nécessite Claude Code v2.1.271 ou une version ultérieure |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Temps en millisecondes pendant lequel Claude Code attend que la chaîne de fournisseurs d'identifiants AWS par défaut produise des identifiants avant que la requête n'échoue avec [`AWS default-chain credential resolve timed out`](/docs/fr/errors#aws-default-chain-credential-resolve-timed-out) (par défaut : `60000`). Augmentez-la lorsqu'une étape de votre chaîne a légitimement besoin de plus de temps, comme une connexion SSO dans le navigateur avec MFA via un wrapper tel que `aws-vault`. S'applique partout où Claude Code signe avec la chaîne par défaut : [Amazon Bedrock](/docs/fr/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et l'[endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint). Nécessite Claude Code v2.1.207 ou ultérieur |229| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Durée en millisecondes pendant laquelle Claude Code attend que la chaîne de fournisseurs d'identifiants AWS par défaut produise des identifiants avant que la requête n'échoue avec [`AWS default-chain credential resolve timed out`](/docs/fr/errors#aws-default-chain-credential-resolve-timed-out) (par défaut : `60000`). Augmentez-la lorsqu'une étape de votre chaîne a légitimement besoin de plus de temps, comme une connexion SSO via navigateur avec MFA au moyen d'un wrapper comme `aws-vault`. S'applique à Amazon Bedrock, à [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et à l'[endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint). Voir [mise en cache des identifiants et délai de résolution](/docs/fr/amazon-bedrock#credential-caching-and-resolution-timeout). Nécessite Claude Code v2.1.207 ou une version ultérieure |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Définissez `0` pour désactiver le [diff des fichiers modifiés pendant l'exécution d'une commande Bash](/docs/fr/hooks#bash), ou `1` pour l'enregistrer dans tous les modes de permission. Prioritaire sur le paramètre [`bashEditDiffEnabled`](/docs/fr/settings-reference#basheditdiffenabled). Nécessite Claude Code v2.1.269 ou ultérieur |230| `CLAUDE_CODE_BASH_EDIT_DIFF` | Définissez sur `0` pour désactiver le [diff des fichiers modifiés pendant l'exécution d'une commande Bash](/docs/fr/hooks#bash), ou sur `1` pour l'enregistrer dans tous les modes de permission. Prioritaire sur le paramètre [`bashEditDiffEnabled`](/docs/fr/settings-reference#basheditdiffenabled). Nécessite Claude Code v2.1.269 ou une version ultérieure |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Définissez `0` pour qu'une session non interactive signale un statut inactif à son hôte à chaque fin de tour, même lorsque du travail en arrière-plan est encore en cours. Par défaut, la session continue de signaler un statut en cours d'exécution après la fin du tour tant que du travail en arrière-plan, comme un agent en arrière-plan ou l'exécution d'un [workflow](/docs/fr/workflows), est encore actif. Cela évite qu'un hôte qui surveille le statut, comme une liste de sessions à distance, n'annonce que Claude attend votre saisie en plein travail. Les commandes shell en arrière-plan, comme un serveur de développement, ne maintiennent pas le statut en cours d'exécution. Le comportement par défaut du statut en cours d'exécution et la désactivation via `0` nécessitent Claude Code v2.1.269 ou ultérieur ; sur les versions antérieures, définissez `1` pour maintenir le statut en cours d'exécution |231| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Définissez sur `0` pour qu'une session non interactive signale un statut inactif à son hôte à chaque fin de tour, même lorsqu'un travail en arrière-plan est encore en cours. Par défaut, la session continue de signaler un statut en cours d'exécution après la fin du tour tant qu'un travail en arrière-plan, comme un agent en arrière-plan ou une exécution de [workflow](/docs/fr/workflows), est toujours actif. Cela évite qu'un hôte qui surveille le statut, comme une liste de sessions à distance, n'annonce que Claude attend votre saisie en plein travail. Les commandes shell en arrière-plan, comme un serveur de développement, ne maintiennent pas le statut en cours d'exécution. Le statut en cours d'exécution par défaut et la désactivation avec `0` nécessitent Claude Code v2.1.269 ou une version ultérieure ; sur les versions antérieures, définissez `1` pour maintenir le statut en cours d'exécution |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Définie automatiquement dans les sous-processus de l'outil Bash et des [commandes de hook](/docs/fr/hooks) tant que la session dispose d'une connexion [Remote Control](/docs/fr/remote-control) active, et supprimée à la fin de la connexion. La valeur est l'ID de la session sous la forme `session_`, le même identifiant que celui qui apparaît dans l'URL `claude.ai/code` de la session, afin qu'un script puisse renvoyer vers la session qui l'a exécuté. Nécessite Claude Code v2.1.199 ou ultérieur. Dans les [sessions cloud](/docs/fr/claude-code-on-the-web), lisez plutôt `CLAUDE_CODE_REMOTE_SESSION_ID` |232| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Définie automatiquement dans les sous-processus de l'outil Bash et des [commandes de hook](/docs/fr/hooks) tant que la session dispose d'une connexion [Remote Control](/docs/fr/remote-control) active, et supprimée à la fin de la connexion. La valeur est l'ID de la session au format `session_`, le même identifiant que celui qui apparaît dans l'URL `claude.ai/code` de la session, afin qu'un script puisse renvoyer vers la session qui l'a exécuté. Nécessite Claude Code v2.1.199 ou une version ultérieure. Dans les [sessions cloud](/docs/fr/claude-code-on-the-web), lisez plutôt `CLAUDE_CODE_REMOTE_SESSION_ID` |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Définissez `0` pour que Claude Code lise l'octet `0x08`, également écrit `^H`, comme un simple Retour arrière, ou `1` pour le lire comme Ctrl+Retour arrière. L'une ou l'autre valeur remplace le comportement par défaut de la plateforme. Par défaut, Claude Code le lit comme Ctrl+Retour arrière sous Windows, sauf lorsque `TERM_PROGRAM` vaut `mintty` ou `TERM` vaut `cygwin`, et comme un simple Retour arrière sous macOS et Linux. Définissez `0` dans un terminal Windows où [Retour arrière supprime un mot entier](/docs/fr/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |233| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Définissez sur `0` pour que Claude Code lise l'octet `0x08`, également noté `^H`, comme un simple Backspace, ou sur `1` pour le lire comme Ctrl+Backspace. Les deux valeurs remplacent la valeur par défaut de la plateforme. Par défaut, Claude Code le lit comme Ctrl+Backspace sous Windows, sauf lorsque `TERM_PROGRAM` vaut `mintty` ou que `TERM` vaut `cygwin`, et comme un simple Backspace sous macOS et Linux. Définissez `0` dans un terminal Windows où [Backspace supprime un mot entier](/docs/fr/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

232| `CLAUDE_CODE_CERT_STORE` | Liste, séparée par des virgules, des sources de certificats CA pour les connexions TLS. `bundled` correspond à l'ensemble de CA de Mozilla fourni avec Claude Code. `system` correspond au magasin de confiance du système d'exploitation, lu uniquement sur les runtimes disposant de `tls.getCACertificates` : le binaire natif, ou Node 22.15 ou ultérieur pour les installations npm. Voir [Magasin de certificats CA](/docs/fr/network-config#ca-certificate-store). Valeur par défaut : `bundled,system` |234| `CLAUDE_CODE_CERT_STORE` | Liste séparée par des virgules des sources de certificats CA pour les connexions TLS. `bundled` est l'ensemble de CA Mozilla fourni avec Claude Code. `system` est le magasin de confiance du système d'exploitation, lu uniquement sur les runtimes disposant de `tls.getCACertificates` : le binaire natif, ou Node 22.15 ou une version ultérieure pour les installations npm. Voir [Magasin de certificats CA](/docs/fr/network-config#ca-certificate-store). Valeur par défaut : `bundled,system` |

233| `CLAUDE_CODE_CHILD_SESSION` | Définie à `1` dans les sous-processus que Claude Code lance via les outils Bash, PowerShell et Monitor, les commandes de [hook](/docs/fr/hooks) et les commandes de [barre de statut](/docs/fr/statusline). Non définie pour les sous-processus de [serveur MCP](/docs/fr/mcp) stdio, qui ont une longue durée de vie et survivent à la session qui les a lancés. Contrairement à `CLAUDECODE`, elle n'est définie que par Claude Code lui-même lorsqu'il lance un sous-processus, et non par les extensions IDE ; elle distingue donc de manière fiable une session imbriquée d'un `claude` de premier niveau lancé dans un terminal intégré à un IDE. Une TUI `claude` interactive imbriquée démarrée de cette façon est automatiquement exclue de `--resume`, `--continue`, de l'historique accessible avec la flèche haut et de la liste `claude agents`. Les sessions non interactives `claude -p` sont toujours conservées. Définissez `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` pour annuler cette exclusion. Nécessite Claude Code v2.1.172 ou ultérieur |235| `CLAUDE_CODE_CHILD_SESSION` | Définie sur `1` dans les sous-processus que Claude Code lance via les outils Bash, PowerShell et Monitor, les commandes de [hook](/docs/fr/hooks) et les commandes de [barre de statut](/docs/fr/statusline). Non définie pour les sous-processus de [serveur MCP](/docs/fr/mcp) stdio, qui ont une longue durée de vie et survivent à la session qui les a lancés. Contrairement à `CLAUDECODE`, elle n'est définie que par Claude Code lui-même lorsqu'il lance un sous-processus, et non par les extensions IDE ; elle distingue donc de manière fiable une session imbriquée d'un `claude` de premier niveau lancé dans un terminal intégré à un IDE. Une TUI `claude` interactive imbriquée démarrée de cette façon est automatiquement exclue de `--resume`, de `--continue`, de l'historique accessible avec la flèche haut et de la liste `claude agents`. Les sessions `claude -p` non interactives sont toujours conservées. Définissez `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` pour lever cette exclusion. Nécessite Claude Code v2.1.172 ou une version ultérieure |

234| `CLAUDE_CODE_CLIENT_CERT` | Chemin vers le fichier de certificat client pour l'authentification mTLS |236| `CLAUDE_CODE_CLIENT_CERT` | Chemin du fichier de certificat client pour l'authentification mTLS |

235| `CLAUDE_CODE_CLIENT_KEY` | Chemin vers le fichier de clé privée client pour l'authentification mTLS |237| `CLAUDE_CODE_CLIENT_KEY` | Chemin du fichier de clé privée client pour l'authentification mTLS |

236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Phrase secrète pour la CLAUDE\_CODE\_CLIENT\_KEY chiffrée (facultatif) |238| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Phrase secrète de la clé CLAUDE\_CODE\_CLIENT\_KEY chiffrée (facultatif) |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Supprimée dans la v2.1.186 et désormais sans effet. Définissait auparavant un délai d'expiration distinct pour la phase de connexion, TLS et en-têtes de réponse d'une requête API en streaming. Utilisez `API_TIMEOUT_MS` pour le délai d'expiration par requête. Pour la phase des en-têtes de réponse d'une requête en streaming, voir `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |239| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Supprimée dans la v2.1.186 et désormais sans effet. Définissait auparavant un délai d'expiration distinct pour la phase de connexion, TLS et en-têtes de réponse d'une requête API en streaming. Utilisez `API_TIMEOUT_MS` pour le délai d'expiration par requête. Pour la phase des en-têtes de réponse d'une requête en streaming, voir `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Remplace le chemin du fichier de log de débogage. Malgré son nom, il s'agit d'un chemin de fichier, et non d'un répertoire. Nécessite que le mode débogage soit activé séparément via `--debug`, `/debug` ou la variable d'environnement `DEBUG` : définir cette variable seule n'active pas la journalisation. Le flag [`--debug-file`](/docs/fr/cli-reference#cli-flags) fait les deux à la fois. Valeur par défaut : `~/.claude/debug/<session-id>.txt` |240| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Remplace le chemin du fichier de log de débogage. Malgré son nom, il s'agit d'un chemin de fichier, et non d'un répertoire. Nécessite que le mode débogage soit activé séparément via `--debug`, `/debug` ou la variable d'environnement `DEBUG` : définir cette variable seule n'active pas la journalisation. Le flag [`--debug-file`](/docs/fr/cli-reference#cli-flags) fait les deux à la fois. Valeur par défaut : `~/.claude/debug/<session-id>.txt` |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Niveau de log minimal écrit dans le fichier de log de débogage. Valeurs : `verbose`, `debug` (par défaut), `info`, `warn`, `error`. Définissez `verbose` pour inclure des diagnostics volumineux comme la sortie complète de la commande de barre de statut, ou montez à `error` pour réduire le bruit |241| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Niveau de log minimal écrit dans le fichier de log de débogage. Valeurs : `verbose`, `debug` (par défaut), `info`, `warn`, `error`. Définissez `verbose` pour inclure des diagnostics volumineux comme la sortie complète de la commande de barre de statut, ou passez à `error` pour réduire le bruit |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Définissez `1` pour désactiver la prise en charge de la [fenêtre de contexte de 1M](/docs/fr/model-config#extended-context). Lorsqu'elle est définie, les variantes de modèles 1M ne sont pas disponibles dans le sélecteur de modèles, et Claude Code limite à une fenêtre de 200K les sessions sur des modèles disposant nativement d'une fenêtre de 1M, comme [Sonnet 5.5](/docs/fr/model-config#sonnet-5-5-and-sonnet-5-context-window) et les modèles Fable ; voir [Contexte étendu](/docs/fr/model-config#extended-context) pour savoir comment cette limite est appliquée. Utile pour les environnements d'entreprise soumis à des exigences de conformité. Pour son rôle dans la correction de la fenêtre d'un ID de modèle `[1m]` non reconnu, voir [Corriger la fenêtre pour un ID de modèle de passerelle ou personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |242| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Définissez sur `1` pour désactiver la prise en charge de la [fenêtre de contexte de 1M](/docs/fr/model-config#extended-context). Lorsqu'elle est définie, les variantes de modèles 1M ne sont pas disponibles dans le sélecteur de modèle, et Claude Code limite à une fenêtre de 200K les sessions sur des modèles dotés d'une fenêtre native de 1M, comme [Sonnet 5.5](/docs/fr/model-config#sonnet-5-5-and-sonnet-5-context-window) et les modèles Fable ; voir [Contexte étendu](/docs/fr/model-config#extended-context) pour savoir comment cette limite est appliquée. Utile pour les environnements d'entreprise soumis à des exigences de conformité. Pour son rôle dans la correction de la fenêtre d'un ID de modèle `[1m]` non reconnu, voir [Corriger la fenêtre pour un ID de modèle de passerelle ou personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Définissez `1` pour désactiver le [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level) sur Opus 4.6 et Sonnet 4.6 et revenir au budget de réflexion fixe contrôlé par `MAX_THINKING_TOKENS`. Sans effet sur les [modèles Fable](/docs/fr/model-config#extended-thinking), Sonnet 5 et ultérieurs, ou Opus 4.7 et ultérieurs, qui utilisent toujours le raisonnement adaptatif |243| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Définissez sur `1` pour désactiver le [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level) sur Opus 4.6 et Sonnet 4.6 et revenir au budget de réflexion fixe contrôlé par `MAX_THINKING_TOKENS`. Sans effet sur les [modèles Fable](/docs/fr/model-config#extended-thinking), Sonnet 5 et versions ultérieures, Haiku 5.5, ou Opus 4.7 et versions ultérieures, qui utilisent toujours le raisonnement adaptatif |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Définissez `1` pour empêcher Claude Code de fusionner clé par clé les blocs `env` des [paramètres gérés](/docs/fr/managed-settings#precedence-within-the-managed-tier) provenant de différentes sources d'administration, de sorte que seul le bloc `env` complet de la source la plus prioritaire s'applique, comme avant la v2.1.223. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.223 ou ultérieur |244| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Définissez sur `1` pour empêcher Claude Code de fusionner clé par clé les blocs `env` des [paramètres gérés](/docs/fr/managed-settings#precedence-within-the-managed-tier) provenant des différentes sources d'administration, de sorte que seul le bloc `env` complet de la source la plus prioritaire s'applique, comme avant la v2.1.223. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.223 ou une version ultérieure |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Définissez `1` pour désactiver l'[outil advisor](/docs/fr/advisor). La commande `/advisor` devient indisponible, tout `advisorModel` configuré est ignoré, et le flag `--advisor` est accepté mais sans effet, de sorte que les scripts existants qui le transmettent continuent de fonctionner sans erreur |245| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Définissez sur `1` pour désactiver l'[outil advisor](/docs/fr/advisor). La commande `/advisor` devient indisponible, tout `advisorModel` configuré est ignoré, et le flag `--advisor` est accepté mais reste sans effet, de sorte que les scripts existants qui le transmettent continuent de fonctionner sans erreur |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Définissez `1` pour désactiver les [agents en arrière-plan et la vue des agents](/docs/fr/agent-view) : `claude agents`, `--bg`, `/background` et le superviseur à la demande. Équivalent au paramètre [`disableAgentView`](/docs/fr/settings-reference#disableagentview) |246| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Définissez sur `1` pour désactiver les [agents en arrière-plan et la vue des agents](/docs/fr/agent-view) : `claude agents`, `--bg`, `/background` et le superviseur à la demande. Équivalent au paramètre [`disableAgentView`](/docs/fr/settings-reference#disableagentview) |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Définissez `1` pour désactiver le [rendu plein écran](/docs/fr/fullscreen) et utiliser le moteur de rendu classique sur l'écran principal. La conversation reste dans l'historique de défilement natif de votre terminal, de sorte que `Cmd+f` et le mode copie de tmux fonctionnent normalement. Prioritaire sur `CLAUDE_CODE_NO_FLICKER` et le paramètre [`tui`](/docs/fr/settings-reference#tui). Vous pouvez également basculer avec `/tui default`. Ne s'applique pas aux sessions en arrière-plan ouvertes depuis la [vue des agents](/docs/fr/agent-view), qui utilisent toujours le rendu plein écran |247| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Définissez sur `1` pour désactiver le [rendu plein écran](/docs/fr/fullscreen) et utiliser le moteur de rendu classique sur l'écran principal. La conversation reste dans l'historique de défilement natif de votre terminal, de sorte que `Cmd+f` et le mode copie de tmux fonctionnent comme d'habitude. Prioritaire sur `CLAUDE_CODE_NO_FLICKER` et le paramètre [`tui`](/docs/fr/settings-reference#tui). Vous pouvez également basculer avec `/tui default`. Ne s'applique pas aux sessions en arrière-plan ouvertes depuis la [vue des agents](/docs/fr/agent-view), qui utilisent toujours le rendu plein écran |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Définissez `1` pour désactiver l'outil [Artifact](/docs/fr/artifacts), qui publie la sortie de la session sous forme de page web privée sur claude.ai. Une fois qu'elle est définie, aucun fichier de paramètres ne peut réactiver l'outil. Pour désactiver plutôt l'outil depuis un fichier de paramètres, définissez [`enableArtifact`](/docs/fr/settings-reference#enableartifact) à `false` ; la clé dépréciée [`disableArtifact`](/docs/fr/settings-reference#disableartifact) le désactive également |248| `CLAUDE_CODE_DISABLE_ARTIFACT` | Définissez sur `1` pour désactiver l'outil [Artifact](/docs/fr/artifacts), qui publie la sortie de la session sous forme de page web privée sur claude.ai. Une fois la variable définie, aucun fichier de paramètres ne peut réactiver l'outil. Pour désactiver plutôt l'outil depuis un fichier de paramètres, définissez [`enableArtifact`](/docs/fr/settings-reference#enableartifact) sur `false` ; la clé dépréciée [`disableArtifact`](/docs/fr/settings-reference#disableartifact) le désactive également |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Définissez `1` pour désactiver le traitement des pièces jointes. Les mentions de fichiers avec la syntaxe `@` sont envoyées en texte brut au lieu d'être développées en contenu de fichier |249| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Définissez sur `1` pour désactiver le traitement des pièces jointes. Les mentions de fichiers avec la syntaxe `@` sont envoyées en texte brut au lieu d'être développées en contenu de fichier |

248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Définissez `1` pour qu'un processus Claude Code exécute lui-même sa commande [`gcpAuthRefresh`](/docs/fr/settings-reference#gcpauthrefresh) ou [`awsAuthRefresh`](/docs/fr/settings-reference#awsauthrefresh) au lieu d'attendre qu'un autre processus l'exécute. Nécessite Claude Code v2.1.286 ou ultérieur |250| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Définissez sur `1` pour qu'un processus Claude Code exécute lui-même sa commande [`gcpAuthRefresh`](/docs/fr/settings-reference#gcpauthrefresh) ou [`awsAuthRefresh`](/docs/fr/settings-reference#awsauthrefresh) au lieu d'attendre qu'un autre processus l'exécute. Nécessite Claude Code v2.1.286 ou une version ultérieure |

249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Définissez `1` pour désactiver la [mémoire automatique](/docs/fr/memory#auto-memory). Définissez `0` pour forcer l'activation de la mémoire automatique même lorsque le mode `--bare` ou [`autoMemoryEnabled: false`](/docs/fr/settings-reference#automemoryenabled) la désactiverait. Lorsqu'elle est désactivée, Claude ne crée ni ne charge de fichiers de mémoire automatique |251| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Définissez sur `1` pour désactiver la [mémoire automatique](/docs/fr/memory#auto-memory). Définissez sur `0` pour forcer l'activation de la mémoire automatique même lorsque le mode `--bare` ou [`autoMemoryEnabled: false`](/docs/fr/settings-reference#automemoryenabled) la désactiverait. Lorsqu'elle est désactivée, Claude ne crée ni ne charge de fichiers de mémoire automatique |

250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Définissez `1` pour désactiver toutes les fonctionnalités de tâches en arrière-plan, y compris le paramètre `run_in_background` des outils Bash et de sous-agent, la mise en arrière-plan automatique et le raccourci Ctrl+B |252| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Définissez sur `1` pour désactiver toutes les fonctionnalités de tâches en arrière-plan, y compris le paramètre `run_in_background` des outils Bash et de sous-agent, la mise en arrière-plan automatique et le raccourci Ctrl+B |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Définissez `1` pour empêcher Claude Code de traiter une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) dont l'en-tête `Content-Type` est absent ou vide comme le flux d'événements binaire d'Amazon Bedrock. Par défaut, Claude Code suppose qu'une passerelle a supprimé l'en-tête d'une réponse par ailleurs inchangée ; il décode donc le corps et le streaming continue de fonctionner. Ne définissez cette variable que pour une passerelle qui réémet également le flux sous forme de server-sent events ; Claude Code lit alors le corps sans en-tête comme des server-sent events. Nécessite Claude Code v2.1.239 ou ultérieur |253| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Définissez sur `1` pour empêcher Claude Code de traiter une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) dont l'en-tête `Content-Type` est absent ou vide comme le flux d'événements binaire d'Amazon Bedrock. Par défaut, Claude Code suppose qu'une passerelle a supprimé l'en-tête d'une réponse par ailleurs non modifiée ; il décode donc le corps et le streaming continue de fonctionner. Définissez-la uniquement pour une passerelle qui réémet également le flux sous forme de server-sent events ; Claude Code lit alors plutôt le corps sans en-tête comme des server-sent events. Nécessite Claude Code v2.1.239 ou une version ultérieure |

252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Définissez `1` pour ignorer la vérification selon laquelle une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) porte le content-type `application/vnd.amazon.eventstream`. Sans cette variable, lorsqu'une réponse porte un content-type différent, Claude Code fait échouer la requête avec une erreur indiquant ce type, ce qui signifie qu'une [passerelle ou un proxy transforme la réponse](/docs/fr/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configurez la passerelle pour qu'elle transmette l'en-tête `Content-Type` et le corps sans modification plutôt que de définir cette variable. Nécessite Claude Code v2.1.208 ou ultérieur |254| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Définissez sur `1` pour ignorer la vérification selon laquelle une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) porte le content-type `application/vnd.amazon.eventstream`. Sans cette variable, lorsqu'une réponse porte un autre content-type, Claude Code fait échouer la requête avec une erreur indiquant ce type, ce qui signifie qu'une [passerelle ou un proxy transforme la réponse](/docs/fr/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configurez la passerelle pour qu'elle transmette l'en-tête `Content-Type` et le corps sans modification plutôt que de définir cette variable. Nécessite Claude Code v2.1.208 ou une version ultérieure |

253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Définissez `1` pour arrêter les commandes shell en arrière-plan en cours d'exécution, les workflows dynamiques et, depuis la v2.1.198, les sous-agents en arrière-plan d'une [session en arrière-plan](/docs/fr/agent-view) lorsque le [superviseur](/docs/fr/agent-view#the-supervisor-process) arrête, redémarre ou met à jour le processus de cette session, au lieu de les transmettre au processus suivant de la session. N'affecte que ce transfert : mettre une session en arrière-plan avec `←` ou [`/background`](/docs/fr/agent-view#from-inside-a-session) transfère toujours le travail en cours, et `CLAUDE_DISABLE_ADOPT` désactive les deux. Nécessite Claude Code v2.1.196 ou ultérieur |255| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Définissez sur `1` pour arrêter les commandes shell en arrière-plan en cours d'exécution d'une [session en arrière-plan](/docs/fr/agent-view), les workflows dynamiques, et, depuis la v2.1.198, les sous-agents en arrière-plan lorsque le [superviseur](/docs/fr/agent-view#the-supervisor-process) arrête, redémarre ou met à jour le processus de cette session, au lieu de les transférer au processus suivant de la session. N'affecte que ce transfert : mettre une session en arrière-plan avec `←` ou [`/background`](/docs/fr/agent-view#from-inside-a-session) transfère toujours le travail en cours, et `CLAUDE_DISABLE_ADOPT` désactive les deux. Nécessite Claude Code v2.1.196 ou une version ultérieure |

254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Définissez `1` pour empêcher Claude Code de terminer les [commandes shell en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) en cas de pression mémoire. Par défaut, sous macOS et Linux, Claude Code termine les shells en arrière-plan lorsque le système d'exploitation signale une pression mémoire critique et que la session est inactive depuis 30 minutes sans tour ni sous-agent en cours. Windows ne dispose d'aucun signal de pression mémoire ; cette variable y est donc sans effet. Nécessite Claude Code v2.1.193 ou ultérieur |256| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Définissez sur `1` pour empêcher Claude Code de terminer les [commandes shell en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) en cas de pression mémoire. Par défaut, sous macOS et Linux, Claude Code termine les shells en arrière-plan lorsque le système d'exploitation signale une pression mémoire critique et que la session est inactive depuis 30 minutes sans tour ni sous-agent en cours. Windows ne dispose d'aucun signal de pression mémoire ; cette variable n'y a donc aucun effet. Nécessite Claude Code v2.1.193 ou une version ultérieure |

255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Définissez `1` pour désactiver les [skills](/docs/fr/skills) et workflows inclus avec Claude Code : les skills et workflows fournis sont entièrement supprimés, tandis que les commandes intégrées comme `/init` restent saisissables mais sont masquées au modèle. `/doctor` reste saisissable comme les commandes intégrées ; masquez-la plutôt avec `DISABLE_DOCTOR_COMMAND`. Les skills provenant de plugins, de `.claude/skills/` et de `.claude/commands/` ne sont pas affectés. Équivalent au paramètre [`disableBundledSkills`](/docs/fr/settings-reference#disablebundledskills) |257| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Définissez sur `1` pour désactiver les [skills](/docs/fr/skills) et les workflows inclus avec Claude Code : les skills et workflows fournis sont entièrement supprimés, tandis que les commandes intégrées comme `/init` restent saisissables mais sont masquées pour le modèle. `/doctor` reste saisissable comme les commandes intégrées ; masquez-la plutôt avec `DISABLE_DOCTOR_COMMAND`. Les skills provenant des plugins, de `.claude/skills/` et de `.claude/commands/` ne sont pas affectés. Équivalent au paramètre [`disableBundledSkills`](/docs/fr/settings-reference#disablebundledskills) |

256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Définissez `1` pour garder disponibles les outils de navigateur [Claude in Chrome](/docs/fr/chrome) tout en omettant la section Chrome du prompt système et le [skill fourni](/docs/fr/skills#bundled-skills) `/claude-in-chrome`. Destinée aux hôtes qui intègrent Claude Code et fournissent leurs propres instructions pour le navigateur. Nécessite Claude Code v2.1.257 ou ultérieur |258| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Définissez sur `1` pour conserver les outils de navigateur de [Claude in Chrome](/docs/fr/chrome) tout en omettant la section Chrome du prompt système et le [skill fourni](/docs/fr/skills#bundled-skills) `/claude-in-chrome`. Destinée aux hôtes qui intègrent Claude Code et fournissent leurs propres consignes pour le navigateur. Nécessite Claude Code v2.1.257 ou une version ultérieure |

257| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Définissez `1` pour empêcher le chargement de tout fichier de mémoire CLAUDE.md dans le contexte, y compris les fichiers de mémoire utilisateur, de projet et de mémoire automatique |259| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Définissez sur `1` pour empêcher le chargement de tout fichier de mémoire CLAUDE.md dans le contexte, y compris les fichiers de mémoire utilisateur, de projet et de mémoire automatique |

258| `CLAUDE_CODE_DISABLE_CRON` | Définissez `1` pour désactiver les [tâches planifiées](/docs/fr/scheduled-tasks). Le skill `/loop` et les outils cron deviennent indisponibles et toutes les tâches déjà planifiées cessent de se déclencher, y compris les tâches déjà en cours d'exécution en milieu de session |260| `CLAUDE_CODE_DISABLE_CRON` | Définissez sur `1` pour désactiver les [tâches planifiées](/docs/fr/scheduled-tasks). Le skill `/loop` et les outils cron deviennent indisponibles et toutes les tâches déjà planifiées cessent de se déclencher, y compris celles qui sont déjà en cours d'exécution en milieu de session |

259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Définissez `1` pour désactiver la limite de temps des demandes de permission pour la [suppression de chemins critiques](/docs/fr/permission-modes#critical-paths). En mode `auto`, Claude Code envoie alors ces suppressions au classifieur, et en mode `bypassPermissions`, la demande attend votre réponse. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.281 ou ultérieur |261| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Définissez sur `1` pour désactiver la limite de temps des demandes de permission de [suppression de chemins critiques](/docs/fr/permission-modes#critical-paths). En mode `auto`, Claude Code envoie alors plutôt ces suppressions au classifieur, et en mode `bypassPermissions`, la demande attend votre réponse. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.281 ou une version ultérieure |

260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Définissez `1` pour retirer des requêtes API les en-têtes de requête `anthropic-beta` de préversion, les champs de corps qui leur sont associés et les champs bêta du schéma d'outils comme `defer_loading` et `eager_input_streaming`. Utilisez-la lorsqu'une passerelle proxy rejette les requêtes avec une erreur `Unexpected value(s)` pour l'en-tête `anthropic-beta` ou une erreur `Extra inputs are not permitted`. [Désactiver les capacités de préversion](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) liste ce que la variable supprime, notamment [MCP Tool Search](/docs/fr/mcp#scale-with-mcp-tool-search), et ce que Claude Code continue d'envoyer |262| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Définissez sur `1` pour supprimer des requêtes API les en-têtes de requête `anthropic-beta` de préversion, les champs du corps qui leur sont associés, et les champs bêta de schéma d'outil comme `defer_loading` et `eager_input_streaming`. Utilisez-la lorsqu'une passerelle proxy rejette les requêtes avec une erreur `Unexpected value(s)` pour l'en-tête `anthropic-beta` ou une erreur `Extra inputs are not permitted`. [Désactiver les fonctionnalités de préversion](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) liste ce que la variable supprime, y compris la [recherche d'outils MCP](/docs/fr/mcp#scale-with-mcp-tool-search), et ce que Claude Code continue d'envoyer |

261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Définissez `1` pour désactiver les [sous-agents intégrés Explore et Plan](/docs/fr/sub-agents#built-in-subagents). Claude explore alors avec ses outils de recherche ou le sous-agent general-purpose, et le [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) lit directement les fichiers au lieu de lancer les agents Explore et Plan. Les sous-agents personnalisés nommés `Explore` ou `Plan` ne sont pas affectés. Pour supprimer tous les types de sous-agents intégrés dans l'Agent SDK ou en mode non interactif, utilisez plutôt `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Nécessite Claude Code v2.1.198 ou ultérieur |263| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Définissez sur `1` pour désactiver les [sous-agents intégrés Explore et Plan](/docs/fr/sub-agents#built-in-subagents). Claude explore alors avec ses outils de recherche ou le sous-agent general-purpose, et le [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) lit directement les fichiers plutôt que de lancer les agents Explore et Plan. Les sous-agents personnalisés nommés `Explore` ou `Plan` ne sont pas affectés. Pour supprimer tous les types de sous-agents intégrés dans l'Agent SDK ou en mode non interactif, utilisez plutôt `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Nécessite Claude Code v2.1.198 ou une version ultérieure |

262| `CLAUDE_CODE_DISABLE_FAST_MODE` | Définissez `1` pour désactiver le [mode rapide](/docs/fr/fast-mode) |264| `CLAUDE_CODE_DISABLE_FAST_MODE` | Définissez sur `1` pour désactiver le [mode rapide](/docs/fr/fast-mode) |

263| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Définissez `1` pour désactiver les enquêtes de qualité de session « How is Claude doing? ». Les enquêtes sont également désactivées lorsque `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est définie, sauf si `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` les réactive. Pour définir un taux d'échantillonnage au lieu de les désactiver complètement, utilisez le paramètre [`feedbackSurveyRate`](/docs/fr/settings-reference#feedbacksurveyrate). Voir [Enquêtes de qualité de session](/docs/fr/data-usage#session-quality-surveys) |265| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Définissez sur `1` pour désactiver les enquêtes de qualité de session « How is Claude doing? ». Les enquêtes sont également désactivées lorsque `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est définie, sauf si `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` les réactive. Pour définir un taux d'échantillonnage plutôt que de les désactiver complètement, utilisez le paramètre [`feedbackSurveyRate`](/docs/fr/settings-reference#feedbacksurveyrate). Voir [Enquêtes de qualité de session](/docs/fr/data-usage#session-quality-surveys) |

264| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Définissez `1` pour désactiver le [checkpointing](/docs/fr/checkpointing) des fichiers. La commande `/rewind` ne pourra pas restaurer les modifications de code. Remplace le paramètre [`fileCheckpointingEnabled`](/docs/fr/settings-reference#filecheckpointingenabled) |266| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Définissez sur `1` pour désactiver le [checkpointing](/docs/fr/checkpointing) des fichiers. La commande `/rewind` ne pourra pas restaurer les modifications du code. Remplace le paramètre [`fileCheckpointingEnabled`](/docs/fr/settings-reference#filecheckpointingenabled) |

265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Définissez `1` pour retirer du contexte de Claude les instructions intégrées de workflow de commit et de PR ainsi que l'instantané du statut git. Utile lorsque vous utilisez vos propres skills de workflow git. Prioritaire sur le paramètre [`includeGitInstructions`](/docs/fr/settings-reference#includegitinstructions) lorsqu'elle est définie |267| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Définissez sur `1` pour retirer du contexte de Claude les instructions intégrées relatives aux workflows de commit et de PR, ainsi que l'instantané du statut git. Utile lorsque vous utilisez vos propres skills de workflow git. Prioritaire sur le paramètre [`includeGitInstructions`](/docs/fr/settings-reference#includegitinstructions) lorsqu'elle est définie |

266| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | Définissez `1` pour empêcher Claude Code de lire les scripts transmis à un shell avec `-c`, comme `bash -c 'rm -rf ~'`, à la recherche de suppressions de [chemins critiques](/docs/fr/permission-modes#removals-inside-nested-commands-and-inline-scripts). Claude Code vérifie toujours les cibles de variables shell et de paramètres positionnels dans ces scripts, et les autres vérifications de chemins critiques continuent de s'exécuter. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.288 ou ultérieur |268| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | Définissez sur `1` pour empêcher Claude Code d'analyser les scripts passés à un shell avec `-c`, comme `bash -c 'rm -rf ~'`, à la recherche de suppressions de [chemins critiques](/docs/fr/permission-modes#removals-inside-nested-commands-and-inline-scripts). Claude Code vérifie toujours les cibles de variables shell et de paramètres positionnels dans ces scripts, et les autres vérifications de chemins critiques continuent de s'exécuter. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.288 ou une version ultérieure |

267| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Définissez `1` pour empêcher le remappage automatique d'Opus 4.0 et 4.1 vers la version actuelle d'Opus sur l'API Anthropic. À utiliser lorsque vous souhaitez volontairement épingler un modèle plus ancien. Le remappage ne s'exécute pas sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry |269| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Définissez sur `1` pour empêcher le remappage automatique d'Opus 4.0 et 4.1 vers la version actuelle d'Opus sur l'API Anthropic. À utiliser lorsque vous souhaitez délibérément épingler un modèle plus ancien. Le remappage ne s'exécute pas sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry |

268| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Définissez `1` pour empêcher Claude Code, sur [Amazon Bedrock](/docs/fr/amazon-bedrock#when-a-model-is-disabled-mid-session) et [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai#when-a-model-is-disabled-mid-session), de basculer sur un modèle plus ancien lorsque votre compte perd l'accès au modèle d'une session en cours de session ; la requête refusée échoue alors immédiatement. Une [chaîne de modèles de secours](/docs/fr/model-config#fallback-model-chains) que vous configurez bascule toujours lors de ce refus, et les [vérifications de modèle au démarrage](/docs/fr/amazon-bedrock#startup-model-checks) se rabattent toujours sur un autre modèle au lancement. Nécessite Claude Code v2.1.285 ou ultérieur |270| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Définissez sur `1` pour empêcher Claude Code, sur [Amazon Bedrock](/docs/fr/amazon-bedrock#when-a-model-is-disabled-mid-session) et [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai#when-a-model-is-disabled-mid-session), de basculer vers un modèle plus ancien lorsque votre compte perd l'accès au modèle d'une session en cours de session ; la requête refusée échoue alors immédiatement. Une [chaîne de modèles de secours](/docs/fr/model-config#fallback-model-chains) que vous configurez bascule toujours lors de ce refus, et les [vérifications de modèle au démarrage](/docs/fr/amazon-bedrock#startup-model-checks) se rabattent toujours sur un autre modèle au lancement. Nécessite Claude Code v2.1.285 ou une version ultérieure |

269| `CLAUDE_CODE_DISABLE_MOUSE` | Définissez `1` pour désactiver le suivi de la souris en [rendu plein écran](/docs/fr/fullscreen). Le défilement au clavier avec `PgUp` et `PgDn` fonctionne toujours. Utilisez-la pour conserver le comportement natif de copie à la sélection de votre terminal |271| `CLAUDE_CODE_DISABLE_MOUSE` | Définissez sur `1` pour désactiver le suivi de la souris dans le [rendu plein écran](/docs/fr/fullscreen). Le défilement au clavier avec `PgUp` et `PgDn` fonctionne toujours. Utilisez-la pour conserver le comportement natif de copie à la sélection de votre terminal |

270| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Définissez `1` pour désactiver la gestion des clics, du glisser et du survol en [rendu plein écran](/docs/fr/fullscreen) tout en conservant le défilement à la molette. Utilisez-la lorsque vous voulez que le défilement à la molette fonctionne dans Claude Code, mais pas que les clics positionnent le curseur, développent la sortie des outils ou ouvrent des liens. `CLAUDE_CODE_DISABLE_MOUSE` est prioritaire lorsque les deux sont définies. Nécessite Claude Code v2.1.195 ou ultérieur |272| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Définissez sur `1` pour désactiver la gestion des clics, des glisser-déposer et du survol dans le [rendu plein écran](/docs/fr/fullscreen) tout en conservant le défilement à la molette. Utilisez-la lorsque vous voulez que le défilement à la molette fonctionne dans Claude Code sans que les clics positionnent le curseur, développent la sortie des outils ou ouvrent des liens. `CLAUDE_CODE_DISABLE_MOUSE` est prioritaire lorsque les deux sont définies. Nécessite Claude Code v2.1.195 ou une version ultérieure |

271| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Définissez `1` pour empêcher Claude Code de relire le [certificat client et la clé mTLS](/docs/fr/network-config#mtls-authentication) lorsqu'une requête API échoue avec une erreur au niveau de la connexion, comme une réinitialisation de connexion ou une erreur de handshake TLS. Avec le rechargement désactivé, Claude Code ne charge les fichiers renouvelés que lors de la prochaine application des paramètres ou au prochain démarrage. Nécessite Claude Code v2.1.232 ou ultérieur |273| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Définissez sur `1` pour empêcher Claude Code de relire le [certificat client et la clé mTLS](/docs/fr/network-config#mtls-authentication) lorsqu'une requête API échoue avec une erreur au niveau de la connexion, comme une réinitialisation de connexion ou une erreur de handshake TLS. Avec le rechargement désactivé, Claude Code ne charge les fichiers renouvelés que lors de la prochaine application des paramètres ou au prochain démarrage. Nécessite Claude Code v2.1.232 ou une version ultérieure |

272| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Définissez une valeur non vide quelconque, comme `1`, pour désactiver le trafic réseau non essentiel : mises à jour automatiques, télémétrie, rapports d'erreurs, la commande `/feedback`, les [retours rédigés par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior), les notes de version, les vérifications du [badge de statut des PR et MR](/docs/fr/interactive-mode#pr-review-status) et les vérifications de disponibilité comme celle du [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Elle arrête également les [exécutions en arrière-plan des sources `command` de plugins](/docs/fr/plugins/loading#when-a-command-source-re-runs), qui sont des commandes locales et non du trafic réseau, car elles peuvent déclencher des installations de dépendances. **La définir à `0` ou `false` désactive tout de même ce trafic**, contrairement à la plupart des variables d'activation ; supprimez la variable pour l'autoriser à nouveau. Désactive également la récupération des feature flags, ce qui rend indisponibles [Remote Control](/docs/fr/remote-control#requirements) et les autres [fonctionnalités qui nécessitent la récupération des feature flags](#features-that-need-feature-flag-fetching). L'installation automatique de la marketplace de plugins officielle n'est pas couverte ; désactivez-la avec `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. N'affecte pas la [découverte des modèles de la passerelle](/docs/fr/llm-gateway-connect#add-gateway-models-to-the-model-picker), qui dispose de sa propre activation |274| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour désactiver le trafic réseau non essentiel : mises à jour automatiques, télémétrie, rapports d'erreurs, commande `/feedback`, [feedback rédigé par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior), notes de version, vérifications du [badge de statut des PR et MR](/docs/fr/interactive-mode#pr-review-status) et vérifications de disponibilité comme celle du [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Elle arrête également les [exécutions en arrière-plan des sources `command` des plugins](/docs/fr/plugins/loading#when-a-command-source-re-runs), qui sont des commandes locales et non du trafic réseau, car elles peuvent déclencher des installations de dépendances. **La définir sur `0` ou `false` désactive quand même ce trafic**, contrairement à la plupart des variables d'activation ; supprimez la variable pour l'autoriser à nouveau. Désactive également la récupération des feature flags, ce qui rend indisponibles [Remote Control](/docs/fr/remote-control#requirements) et les autres [fonctionnalités qui nécessitent la récupération des feature flags](#features-that-need-feature-flag-fetching). L'installation automatique de la marketplace officielle de plugins n'est pas couverte ; désactivez-la avec `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. N'affecte pas la [découverte des modèles de passerelle](/docs/fr/llm-gateway-connect#add-gateway-models-to-the-model-picker), qui dispose de sa propre activation |

273| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Définissez `1` pour désactiver la solution de repli sans streaming lorsqu'une requête en streaming échoue en cours de flux. Les erreurs de streaming sont alors propagées à la couche de nouvelles tentatives. Utile lorsqu'un proxy ou une passerelle amène la solution de repli à produire une exécution d'outil en double |275| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Définissez sur `1` pour désactiver la solution de repli sans streaming lorsqu'une requête en streaming échoue en cours de flux. Les erreurs de streaming sont alors transmises à la couche de nouvelles tentatives. Utile lorsqu'un proxy ou une passerelle fait que la solution de repli provoque une exécution d'outil en double |

274| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Définissez `1` pour envoyer la notification de bureau de l'outil `PushNotification` même lorsque vous êtes en train de taper dans le terminal ou qu'il a le focus. Par défaut, l'outil n'envoie ni la notification de bureau ni la [notification push mobile](/docs/fr/remote-control#mobile-push-notifications) lorsqu'il détecte une activité récente du clavier ou le focus du terminal. Cette variable ne désactive que cette vérification locale ; le serveur peut donc toujours supprimer la notification push mobile lorsqu'il détecte que vous êtes actif. Nécessite Claude Code v2.1.193 ou ultérieur |276| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Définissez sur `1` pour envoyer la notification de bureau de l'outil `PushNotification` même lorsque vous tapez dans le terminal ou qu'il a le focus. Par défaut, l'outil ignore à la fois la notification de bureau et la [notification push mobile](/docs/fr/remote-control#mobile-push-notifications) lorsqu'il détecte une activité récente du clavier ou le focus du terminal. Cette variable ne désactive que cette vérification locale ; le serveur peut donc toujours supprimer la notification push mobile lorsqu'il détecte que vous êtes actif. Nécessite Claude Code v2.1.193 ou une version ultérieure |

275| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Définissez `1` pour désactiver l'enregistrement automatique de la marketplace de plugins officielle. Claude Code lit la variable au moment d'enregistrer la marketplace, généralement lors du premier lancement interactif sur une machine. Si la variable est définie à ce moment-là, Claude Code ignore définitivement l'enregistrement. Supprimer la variable plus tard n'annule pas cet abandon. Exécutez `claude plugin marketplace add anthropics/claude-plugins-official` pour enregistrer la marketplace à tout moment |277| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Définissez sur `1` pour désactiver l'enregistrement automatique de la marketplace officielle de plugins. Claude Code lit la variable au moment d'enregistrer la marketplace, généralement lors du premier lancement interactif sur une machine. Si la variable est définie à ce moment-là, Claude Code ignore définitivement l'enregistrement. Supprimer la variable par la suite n'annule pas ce choix. Exécutez `claude plugin marketplace add anthropics/claude-plugins-official` pour enregistrer la marketplace à tout moment |

276| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Définissez `1` pour empêcher Claude Code d'exécuter vos [hooks `Notification` pour les demandes de permission sans réponse](/docs/fr/hooks#notification) dans les sessions où Claude Code les envoie au callback `canUseTool` de l'Agent SDK, ce qui correspond à la façon dont Claude Desktop et l'extension VS Code hébergent Claude Code. Sans effet dans les sessions de terminal. Nécessite Claude Code v2.1.233 ou ultérieur |278| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Définissez sur `1` pour empêcher Claude Code d'exécuter vos [hooks `Notification` pour les demandes de permission restées sans réponse](/docs/fr/hooks#notification) dans les sessions où Claude Code les envoie au callback `canUseTool` de l'Agent SDK, ce qui est la manière dont Claude Desktop et l'extension VS Code hébergent Claude Code. Sans effet dans les sessions de terminal. Nécessite Claude Code v2.1.233 ou une version ultérieure |

277| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Définissez `1` pour ignorer le chargement des skills depuis le répertoire de skills gérés à l'échelle du système. Utile pour les sessions de conteneur ou de CI qui ne doivent pas charger les skills provisionnés par l'opérateur |279| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Définissez sur `1` pour ne pas charger les skills du répertoire de skills gérés à l'échelle du système. Utile pour les sessions de conteneur ou de CI qui ne doivent pas charger les skills provisionnés par l'opérateur |

278| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Définissez `1` pour désactiver la vérification de l'[outil PowerShell](/docs/fr/tools-reference#powershell-tool) qui refuse les commandes intégrées `cmd` `rd`, `rmdir`, `del` et `erase` sur un [chemin système](/docs/fr/permission-modes#remove-item-in-powershell), comme la racine d'un lecteur ou votre répertoire personnel. Claude Code ignore cette variable dans le bloc `env` d'un fichier de paramètres. Nécessite Claude Code v2.1.283 ou ultérieur |280| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Définissez sur `1` pour désactiver la vérification de l'[outil PowerShell](/docs/fr/tools-reference#powershell-tool) qui refuse les commandes intégrées `cmd` `rd`, `rmdir`, `del` et `erase` sur un [chemin système](/docs/fr/permission-modes#remove-item-in-powershell), comme la racine d'un lecteur ou votre répertoire personnel. Claude Code ignore cette variable dans le bloc `env` d'un fichier de paramètres. Nécessite Claude Code v2.1.283 ou une version ultérieure |

279| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | Définissez `1` pour désactiver le [changement automatique de modèle lorsqu'un classifieur de sécurité signale une requête](/docs/fr/model-config#automatic-model-fallback), le comportement que contrôle le paramètre [`switchModelsOnFlag`](/docs/fr/settings-reference#switchmodelsonflag) |281| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | Définissez sur `1` pour désactiver le [changement automatique de modèle lorsqu'un classifieur de sécurité signale une requête](/docs/fr/model-config#automatic-model-fallback), le comportement que contrôle le paramètre [`switchModelsOnFlag`](/docs/fr/settings-reference#switchmodelsonflag) |

280| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Définissez `1` pour empêcher Claude Code d'envoyer le champ de sortie structurée `output_config.format` et la valeur `anthropic-beta` qui lui est associée, pour une [passerelle LLM](/docs/fr/llm-gateway-protocol#feature-pass-through) dont l'amont les rejette. Cela laisse activées les autres capacités de préversion que [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) désactive. Nécessite Claude Code v2.1.288 ou ultérieur |282| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Définissez sur `1` pour empêcher Claude Code d'envoyer le champ de sortie structurée `output_config.format` et la valeur `anthropic-beta` qui lui est associée, pour une [passerelle LLM](/docs/fr/llm-gateway-protocol#feature-pass-through) dont le service en amont les rejette. Cela laisse actives les autres fonctionnalités de préversion que [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) désactive. Nécessite Claude Code v2.1.288 ou une version ultérieure |

281| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Définissez `1` pour désactiver la vérification de [chemin critique](/docs/fr/permission-modes#critical-paths) pour un `rm` récursif dont la cible est entièrement la sortie d'une substitution de commande, comme `rm -rf "$(pwd)"`. Les autres vérifications de chemins critiques continuent de s'exécuter. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.281 ou ultérieur |283| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Définissez sur `1` pour désactiver la vérification de [chemin critique](/docs/fr/permission-modes#critical-paths) pour un `rm` récursif dont la cible est entièrement la sortie d'une substitution de commande, comme `rm -rf "$(pwd)"`. Les autres vérifications de chemins critiques continuent de s'exécuter. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.281 ou une version ultérieure |

282| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Définissez `1` pour désactiver les mises à jour automatiques du titre du terminal basées sur le contexte de la conversation. Cela supprime également la requête en arrière-plan au petit modèle rapide qui [génère un titre de session](/docs/fr/sessions#name-your-sessions) |284| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Définissez sur `1` pour désactiver les mises à jour automatiques du titre du terminal basées sur le contexte de la conversation. Cela supprime également la requête en arrière-plan au modèle petit/rapide qui [génère un titre de session](/docs/fr/sessions#name-your-sessions) |

283| `CLAUDE_CODE_DISABLE_THINKING` | Définissez `1` pour omettre entièrement le paramètre `thinking` des requêtes API. Il s'agit d'une option de compatibilité pour les proxys et les passerelles qui rejettent ce paramètre. Sur les modèles qui réfléchissent par défaut, omettre le paramètre signifie que le modèle peut quand même réfléchir. Pour désactiver explicitement la [réflexion étendue](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sur l'API Anthropic, utilisez plutôt `MAX_THINKING_TOKENS=0`. Aucune des deux variables ne désactive la réflexion sur Opus 5.5, Sonnet 5.5 ou les modèles Fable, sur lesquels la réflexion ne peut pas être désactivée. Chez les [fournisseurs tiers](/docs/fr/third-party-integrations), `MAX_THINKING_TOKENS=0` omet également le paramètre ; les deux variables s'y comportent donc de la même façon |285| `CLAUDE_CODE_DISABLE_THINKING` | Définissez sur `1` pour omettre entièrement le paramètre `thinking` des requêtes API. Il s'agit d'une option de compatibilité pour les proxys et passerelles qui rejettent ce paramètre. Sur les modèles qui réfléchissent par défaut, omettre le paramètre signifie que le modèle peut quand même réfléchir. Pour désactiver explicitement la [réflexion étendue](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sur l'API Anthropic, utilisez plutôt `MAX_THINKING_TOKENS=0`. Aucune des deux variables ne désactive la réflexion sur Opus 5.5, Sonnet 5.5, Haiku 5.5 ou les modèles Fable, dont la réflexion ne peut pas être désactivée. Chez les [fournisseurs tiers](/docs/fr/third-party-integrations), `MAX_THINKING_TOKENS=0` omet également le paramètre, de sorte que les deux variables s'y comportent de la même façon |

284| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Définissez `1` pour ignorer la [compaction automatique](/docs/fr/costs#reduce-token-usage) proactive lorsque Claude Code ne reconnaît pas l'ID du modèle, comme un alias de [passerelle LLM](/docs/fr/llm-gateway). Sans cette variable, Claude Code compacte à la fenêtre de contexte qu'il suppose pour cet ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` peut plutôt corriger la fenêtre supposée ; voir [Corriger la fenêtre pour un ID de modèle de passerelle ou personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id) pour savoir quand chaque variable s'applique. Nécessite Claude Code v2.1.223 ou ultérieur |286| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Définissez sur `1` pour ignorer la [compaction automatique](/docs/fr/costs#reduce-token-usage) proactive lorsque Claude Code ne reconnaît pas l'ID du modèle, comme un alias de [passerelle LLM](/docs/fr/llm-gateway). Sans cette variable, Claude Code compacte à la fenêtre de contexte qu'il suppose pour l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` peut plutôt corriger la fenêtre supposée ; voir [Corriger la fenêtre pour un ID de modèle de passerelle ou personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id) pour savoir quand chaque variable s'applique. Nécessite Claude Code v2.1.223 ou une version ultérieure |

285| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Définissez `1` pour désactiver le défilement virtuel en [rendu plein écran](/docs/fr/fullscreen) et afficher chaque message de la transcription. Utilisez-la si le défilement en mode plein écran affiche des zones vides là où des messages devraient apparaître |287| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Définissez sur `1` pour désactiver le défilement virtuel dans le [rendu plein écran](/docs/fr/fullscreen) et afficher chaque message de la transcription. Utilisez-la si le défilement en mode plein écran affiche des zones vides là où des messages devraient apparaître |

286| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Définissez `1` pour désactiver l'outil [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior). L'outil [WebSearch](/docs/fr/tools-reference#websearch-tool-behavior) reste disponible. Nécessite Claude Code v2.1.285 ou ultérieur |288| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Définissez sur `1` pour désactiver l'outil [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior). L'outil [WebSearch](/docs/fr/tools-reference#websearch-tool-behavior) reste disponible. Nécessite Claude Code v2.1.285 ou une version ultérieure |

287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Définissez `1` pour démarrer directement les commandes de l'[outil PowerShell](/docs/fr/tools-reference#powershell-tool) sous Windows au lieu de passer par le lanceur `cmd.exe`. Par défaut, le lanceur permet à une commande PowerShell [exécutée en arrière-plan](/docs/fr/tools-reference#background-commands) d'être [transférée au processus suivant de la session](/docs/fr/agent-view#the-supervisor-process), par exemple lorsque vous [mettez la session en arrière-plan](/docs/fr/agent-view#from-inside-a-session). Si vous définissez la variable, une commande PowerShell en arrière-plan s'arrête lorsque le processus de la session se termine. Les commandes Bash ne sont pas affectées. Nécessite Claude Code v2.1.269 ou ultérieur |289| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Définissez sur `1` pour démarrer directement les commandes de l'[outil PowerShell](/docs/fr/tools-reference#powershell-tool) sous Windows plutôt que via le lanceur `cmd.exe`. Par défaut, le lanceur permet à une commande PowerShell [s'exécutant en arrière-plan](/docs/fr/tools-reference#background-commands) d'être [transférée au processus suivant de la session](/docs/fr/agent-view#the-supervisor-process), par exemple lorsque vous [mettez la session en arrière-plan](/docs/fr/agent-view#from-inside-a-session). Si vous définissez la variable, une commande PowerShell mise en arrière-plan s'arrête lorsque le processus de la session se termine. Les commandes Bash ne sont pas affectées. Nécessite Claude Code v2.1.269 ou une version ultérieure |

288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Définissez `1` pour désactiver les [workflows](/docs/fr/workflows#turn-workflows-off). Équivalent au paramètre [`disableWorkflows`](/docs/fr/settings-reference#disableworkflows) |290| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Définissez sur `1` pour désactiver les [workflows](/docs/fr/workflows#turn-workflows-off). Équivalent au paramètre [`disableWorkflows`](/docs/fr/settings-reference#disableworkflows) |

289| `CLAUDE_CODE_EFFORT_LEVEL` | Définit le niveau d'effort pour les modèles pris en charge. Valeurs : `low`, `medium`, `high`, `xhigh`, `max`, ou `auto` pour utiliser la valeur par défaut du modèle. Les niveaux disponibles dépendent du modèle. Prioritaire sur `--effort`, `/effort` et les paramètres `modelSettings` et `effortLevel`. Un plafond [`maxEffortLevel`](/docs/fr/settings-reference#maxeffortlevel) s'applique toujours. Voir [Ajuster le niveau d'effort](/docs/fr/model-config#adjust-effort-level) |291| `CLAUDE_CODE_EFFORT_LEVEL` | Définit le niveau d'effort pour les modèles pris en charge. Valeurs : `low`, `medium`, `high`, `xhigh`, `max`, ou `auto` pour utiliser la valeur par défaut du modèle. Les niveaux disponibles dépendent du modèle. Prioritaire sur `--effort`, `/effort` et les paramètres `modelSettings` et `effortLevel`. Un plafond [`maxEffortLevel`](/docs/fr/settings-reference#maxeffortlevel) s'applique toujours. Voir [Ajuster le niveau d'effort](/docs/fr/model-config#adjust-effort-level) |

290| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Définissez à `1` pour ajouter au flux de messages les messages [`session_state_changed`](/docs/fr/agent-sdk/typescript#sdksessionstatechangedmessage), qui contiennent l'état de la session. Nécessite soit l'[Agent SDK](/docs/fr/agent-sdk/overview), soit `--print`, `--output-format stream-json` et `--verbose` |292| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Définissez sur `1` pour ajouter au flux de messages les messages [`session_state_changed`](/docs/fr/agent-sdk/typescript#sdksessionstatechangedmessage), qui contiennent l'état de la session. Nécessite soit l'[Agent SDK](/docs/fr/agent-sdk/overview), soit `--print`, `--output-format stream-json` et `--verbose` |

291| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Acceptée pour assurer la compatibilité avec les versions antérieures, sans aucun effet. Le mode auto est disponible par défaut sur tous les fournisseurs, y compris Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry et les sessions connectées via la [passerelle des apps Claude](/docs/fr/claude-apps-gateway). De la v2.1.158 à la v2.1.206, il fallait définir cette variable sur `1` pour rendre le [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) disponible sur ces fournisseurs |293| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Acceptée pour la compatibilité avec les anciennes versions et sans effet. Le mode auto est disponible par défaut sur tous les fournisseurs, y compris Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions [Claude apps gateway](/docs/fr/claude-apps-gateway) connectées. De la v2.1.158 à la v2.1.206, définir cette variable sur `1` était nécessaire pour rendre le [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) disponible sur ces fournisseurs |

292| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Remplace la disponibilité du [récapitulatif de session](/docs/fr/interactive-mode#session-recap). Définissez-la sur `0` pour forcer la désactivation des récapitulatifs, quel que soit l'état du bouton dans `/config`. Définissez-la sur `1` pour forcer leur activation lorsque [`awaySummaryEnabled`](/docs/fr/settings-reference#awaysummaryenabled) vaut `false`. A priorité sur le paramètre et sur le bouton de `/config` |294| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Remplace la disponibilité du [récapitulatif de session](/docs/fr/interactive-mode#session-recap). Définissez sur `0` pour forcer la désactivation des récapitulatifs quel que soit l'interrupteur de `/config`. Définissez sur `1` pour forcer leur activation lorsque [`awaySummaryEnabled`](/docs/fr/settings-reference#awaysummaryenabled) vaut `false`. A priorité sur le paramètre et sur l'interrupteur de `/config` |

293| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Définissez-la sur `1` pour actualiser l'état des plugins entre deux tours en [mode non interactif](/docs/fr/headless) une fois une installation en arrière-plan terminée. Désactivée par défaut, car l'actualisation modifie le prompt système en cours de session, ce qui invalide le [prompt caching](/docs/fr/prompt-caching) pour ce tour |295| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Définissez sur `1` pour actualiser l'état des plugins entre les tours en [mode non interactif](/docs/fr/headless) une fois qu'une installation en arrière-plan est terminée. Désactivée par défaut car l'actualisation modifie le prompt système en cours de session, ce qui invalide le [prompt caching](/docs/fr/prompt-caching) pour ce tour |

294| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Définissez-la sur `1` pour acheminer l'enquête de qualité de session « How is Claude doing? » vers votre propre [collecteur OpenTelemetry](/docs/fr/monitoring-usage) lorsque le trafic non essentiel destiné à Anthropic est bloqué. Les évaluations de l'enquête sont émises uniquement sous forme d'événements OTEL vers le collecteur que vous avez configuré. Aucune donnée d'enquête n'est envoyée à Anthropic dans ce mode. S'applique lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, et n'a aucun effet dans le cas contraire. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` et la politique de feedback produit de l'organisation ont priorité |296| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Définissez sur `1` pour acheminer l'enquête de qualité de session « How is Claude doing? » vers votre propre [collecteur OpenTelemetry](/docs/fr/monitoring-usage) lorsque le trafic non essentiel destiné à Anthropic est bloqué. Les notes de l'enquête sont émises uniquement sous forme d'événements OTEL vers votre collecteur configuré. Aucune donnée d'enquête n'est envoyée à Anthropic dans ce mode. S'applique lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, et n'a aucun effet sinon. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` et la politique de retours produit de l'organisation ont priorité |

295| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Détermine si les entrées des appels d'outils sont diffusées en streaming depuis l'API à mesure que Claude les génère. Lorsque cette option est désactivée, une entrée d'outil volumineuse, comme l'écriture d'un long fichier, n'arrive qu'une fois que Claude a fini de la générer, ce qui peut donner l'impression d'un blocage. Activée par défaut sur l'API Anthropic. Sur Amazon Bedrock et Agent Platform de Google Cloud, activée modèle par modèle lorsque le conteneur déployé la prend en charge. Définissez-la sur `0` pour la désactiver. Définissez-la sur `1` pour forcer l'activation lors d'un routage via un proxy avec `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Désactivée par défaut sur Microsoft Foundry et pour les connexions via une [passerelle](/docs/fr/llm-gateway) |297| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Contrôle si les entrées des appels d'outils sont diffusées en streaming depuis l'API à mesure que Claude les génère. Lorsque cette option est désactivée, une entrée d'outil volumineuse, comme l'écriture d'un long fichier, n'arrive qu'une fois que Claude a fini de la générer, ce qui peut donner l'impression d'un blocage. Activée par défaut sur l'API Anthropic. Sur Amazon Bedrock et Google Cloud's Agent Platform, activée par modèle lorsque le conteneur déployé la prend en charge. Définissez sur `0` pour la désactiver. Définissez sur `1` pour forcer son activation lors du routage via un proxy avec `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Désactivée par défaut sur Microsoft Foundry et sur les connexions via une [passerelle](/docs/fr/llm-gateway) |

296| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Définissez-la sur `1` pour alimenter le sélecteur `/model` à partir de l'endpoint `/v1/models` de votre passerelle lorsque `ANTHROPIC_BASE_URL` pointe vers une passerelle compatible Anthropic telle que LiteLLM, Kong ou un proxy interne. Désactivée par défaut, car les passerelles reposant sur une clé API partagée montreraient sinon à chaque utilisateur tous les modèles accessibles avec cette clé. Les modèles découverts restent filtrés par la liste d'autorisation [`availableModels`](/docs/fr/settings-reference#availablemodels) que reçoit la session ; fournissez cette liste via [MDM ou un fichier de paramètres gérés](/docs/fr/managed-settings#delivery-mechanisms), car [la distribution gérée par serveur n'est pas disponible pour les configurations de passerelle](/docs/fr/server-managed-settings#platform-availability) |298| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Définissez sur `1` pour alimenter le sélecteur `/model` à partir de l'endpoint `/v1/models` de votre passerelle lorsque `ANTHROPIC_BASE_URL` pointe vers une passerelle compatible Anthropic telle que LiteLLM, Kong ou un proxy interne. Désactivée par défaut car les passerelles reposant sur une clé API partagée montreraient sinon à chaque utilisateur tous les modèles auxquels la clé a accès. Les modèles découverts restent filtrés par une liste d'autorisation [`availableModels`](/docs/fr/settings-reference#availablemodels) reçue par la session ; fournissez la liste via [MDM ou un fichier de paramètres gérés](/docs/fr/managed-settings#delivery-mechanisms), car [la distribution gérée par serveur n'est pas disponible sur les configurations de passerelle](/docs/fr/server-managed-settings#platform-availability) |

297| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Supprimée dans la v2.1.142, lorsque le [mode rapide](/docs/fr/fast-mode) par défaut est passé d'Opus 4.6 à Opus 4.7 |299| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Supprimée dans la v2.1.142, lorsque le modèle par défaut du [mode rapide](/docs/fr/fast-mode) est passé d'Opus 4.6 à Opus 4.7 |

298| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Définissez-la sur `false` pour désactiver les suggestions de prompt, ces prédictions grisées qui apparaissent dans votre zone de saisie. A priorité sur le paramètre [`promptSuggestionEnabled`](/docs/fr/settings-reference#promptsuggestionenabled), celui qu'écrit le bouton **Prompt suggestions** de `/config`. Claude Code [suspend également les suggestions lorsque votre compte approche ou atteint sa limite d'utilisation](/docs/fr/interactive-mode#when-claude-code-skips-suggestions). Définissez-la sur `true` pour les conserver jusqu'à ce que vous atteigniez la limite. Nécessite Claude Code v2.1.238 ou version ultérieure. Consultez [Suggestions de prompt](/docs/fr/interactive-mode#prompt-suggestions) |300| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Définissez sur `false` pour désactiver les suggestions de prompt, les prédictions grisées qui apparaissent dans votre zone de saisie. A priorité sur le paramètre [`promptSuggestionEnabled`](/docs/fr/settings-reference#promptsuggestionenabled), qui est celui qu'écrit l'interrupteur **Prompt suggestions** de `/config`. Claude Code [met également les suggestions en pause lorsque votre compte approche ou atteint sa limite d'utilisation](/docs/fr/interactive-mode#when-claude-code-skips-suggestions). Définissez sur `true` pour les conserver jusqu'à ce que vous atteigniez la limite. Nécessite Claude Code v2.1.238 ou ultérieur. Voir [Suggestions de prompt](/docs/fr/interactive-mode#prompt-suggestions) |

299| `CLAUDE_CODE_ENABLE_TASKS` | Sélectionne les outils de suivi des tâches que Claude Code fournit dans les [sessions qui en disposent](/docs/fr/tools-reference#task-tool-availability). Par défaut, Claude Code fournit les outils Task `TaskCreate`, `TaskUpdate`, `TaskGet` et `TaskList`. Définissez-la sur `0` pour obtenir à la place l'ancien outil `TodoWrite`. Consultez [Liste des tâches](/docs/fr/interactive-mode#task-list) |301| `CLAUDE_CODE_ENABLE_TASKS` | Sélectionne les outils de suivi des tâches que Claude Code fournit dans les [sessions qui en disposent](/docs/fr/tools-reference#task-tool-availability). Par défaut, Claude Code fournit les outils Task `TaskCreate`, `TaskUpdate`, `TaskGet` et `TaskList`. Définissez sur `0` pour obtenir à la place l'ancien outil `TodoWrite`. Voir [Liste des tâches](/docs/fr/interactive-mode#task-list) |

300| `CLAUDE_CODE_ENABLE_TELEMETRY` | Définissez-la sur `1` pour activer la collecte de données OpenTelemetry pour les métriques et les logs. Requise avant de configurer les exportateurs OTel. Définissez-la dans votre shell, dans vos paramètres utilisateur ou dans vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Consultez [Surveillance](/docs/fr/monitoring-usage) |302| `CLAUDE_CODE_ENABLE_TELEMETRY` | Définissez sur `1` pour activer la collecte de données OpenTelemetry pour les métriques et les logs. Requis avant de configurer les exportateurs OTel. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Voir [Surveillance](/docs/fr/monitoring-usage) |

301| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Définissez-la sur `1` pour disposer des outils de suivi des tâches sur tous les modèles. Sans elle, Claude Code ne les fournit par défaut que sur les modèles listés dans [Disponibilité de l'outil Task](/docs/fr/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` continue de choisir entre les outils Task et `TodoWrite`. Nécessite Claude Code v2.1.233 ou version ultérieure |303| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Définissez sur `1` pour obtenir les outils de suivi des tâches sur tous les modèles. Sans cela, Claude Code ne les fournit par défaut que sur les modèles répertoriés sous [Disponibilité de l'outil Task](/docs/fr/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` sélectionne toujours les outils Task ou `TodoWrite`. Nécessite Claude Code v2.1.233 ou ultérieur |

302| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Durée en millisecondes à attendre une fois la boucle de requêtes devenue inactive avant de quitter automatiquement. Utile pour les workflows automatisés et les scripts utilisant le mode SDK |304| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Durée en millisecondes d'attente après que la boucle de requêtes devient inactive avant de quitter automatiquement. Utile pour les workflows automatisés et les scripts utilisant le mode SDK |

303| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Définissez-la sur `1` pour activer les [équipes d'agents](/docs/fr/agent-teams). Les équipes d'agents sont expérimentales et désactivées par défaut |305| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Définissez sur `1` pour activer les [équipes d'agents](/docs/fr/agent-teams). Les équipes d'agents sont expérimentales et désactivées par défaut |

304| `CLAUDE_CODE_EXTRA_BODY` | Objet JSON à fusionner au niveau supérieur du corps de chaque requête API. Utile pour transmettre des paramètres propres au fournisseur que Claude Code n'expose pas directement. Une valeur exportée dans votre shell s'applique également aux [sessions en arrière-plan](/docs/fr/agent-view) que vous lancez avec `claude agents` ou `--bg`. Avant la v2.1.206, les sessions en arrière-plan ignoraient une valeur exportée dans le shell et utilisaient la copie, quelle qu'elle soit, héritée par le processus superviseur en arrière-plan |306| `CLAUDE_CODE_EXTRA_BODY` | Objet JSON à fusionner au niveau supérieur du corps de chaque requête API. Utile pour transmettre des paramètres propres à un fournisseur que Claude Code n'expose pas directement. Une valeur exportée dans votre shell s'applique également aux [sessions en arrière-plan](/docs/fr/agent-view) que vous lancez avec `claude agents` ou `--bg`. Avant la v2.1.206, les sessions en arrière-plan ignoraient une valeur exportée dans le shell et utilisaient la copie héritée par le processus superviseur en arrière-plan |

305| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Remplace la limite de tokens par défaut pour la lecture de fichiers. Utile lorsque vous devez lire intégralement des fichiers plus volumineux |307| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Remplace la limite de tokens par défaut pour la lecture de fichiers. Utile lorsque vous devez lire intégralement des fichiers plus volumineux |

306| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Définissez-la sur `1` pour forcer la persistance des transcriptions, l'historique des prompts et l'enregistrement auprès de `claude agents`, même lorsque ce `claude` a été lancé depuis une autre session Claude Code. À utiliser lorsqu'une valeur `CLAUDE_CODE_CHILD_SESSION` héritée, par exemple d'une session `screen` ou d'un lanceur en arrière-plan démarré initialement par l'outil Bash de Claude Code, amène une véritable session de premier niveau à être classée à tort comme imbriquée. Depuis la v2.1.178, Claude Code détecte automatiquement le cas de tmux et ignore le marqueur hérité ; tmux n'a donc plus besoin de cette variable. Également prise en compte dans la v2.1.169 et les versions antérieures ; sans effet dans les v2.1.170 et v2.1.171, où la détection des sessions imbriquées qu'elle contourne avait été supprimée |308| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Définissez sur `1` pour forcer la persistance de la transcription, l'historique des prompts et l'enregistrement dans `claude agents`, même lorsque ce `claude` a été lancé depuis une autre session Claude Code. Utilisez-la lorsqu'une valeur `CLAUDE_CODE_CHILD_SESSION` héritée, par exemple d'une session `screen` ou d'un lanceur en arrière-plan démarré initialement par l'outil Bash de Claude Code, fait qu'une véritable session de premier niveau est classée à tort comme imbriquée. Depuis la v2.1.178, Claude Code détecte automatiquement le cas de tmux et ignore le marqueur hérité, de sorte que tmux n'a plus besoin de cette variable. Également prise en compte dans la v2.1.169 et antérieures ; sans effet dans les v2.1.170 et v2.1.171, où la détection des sessions imbriquées qu'elle remplace avait été supprimée |

307| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Définissez-la sur `1` pour forcer le rendu barré de `~~text~~` dans les réponses de Claude lorsque votre terminal le prend en charge sans être détecté automatiquement, par exemple via SSH sans transmission de `TERM_PROGRAM`. Sans elle, les terminaux non détectés affichent les marqueurs `~~` tels quels au lieu de rendre le texte barré. Nécessite Claude Code v2.1.186 ou version ultérieure |309| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Définissez sur `1` pour forcer l'affichage barré de `~~text~~` dans les réponses de Claude lorsque votre terminal le prend en charge mais n'est pas détecté automatiquement, par exemple via SSH sans transmission de `TERM_PROGRAM`. Sans cela, les terminaux non détectés affichent les marqueurs `~~` littéraux au lieu d'afficher le texte barré. Nécessite Claude Code v2.1.186 ou ultérieur |

308| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Définissez-la sur `1` pour forcer l'activation de la [sortie synchronisée](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) du mode privé DEC 2026 lorsque votre terminal la prend en charge sans être détecté automatiquement. Utile pour les émulateurs comme `eat` d'Emacs, qui implémentent BSU/ESU mais ne répondent pas à la détection des capacités. Sans effet sous tmux. Contrairement à `CLAUDE_CODE_NO_FLICKER`, qui bascule vers le [rendu plein écran](/docs/fr/fullscreen), cette variable ne change pas le moteur de rendu |310| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Définissez sur `1` pour forcer l'activation de la [sortie synchronisée](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) du mode privé DEC 2026 lorsque votre terminal la prend en charge mais n'est pas détecté automatiquement. Utile pour les émulateurs tels que `eat` d'Emacs qui implémentent BSU/ESU mais ne répondent pas à la sonde de capacité. Sans effet sous tmux. Contrairement à `CLAUDE_CODE_NO_FLICKER`, qui bascule vers le [rendu plein écran](/docs/fr/fullscreen), cette variable ne change pas le moteur de rendu |

309| `CLAUDE_CODE_FORK_SUBAGENT` | Contrôle le [mode fork](/docs/fr/sub-agents#turn-fork-mode-on-or-off), qui permet à Claude de lancer lui-même des [sous-agents forkés](/docs/fr/sub-agents#fork-the-current-conversation) et qui est activé par défaut uniquement dans les sessions interactives. Définissez-la sur `1` pour l'activer également dans `claude -p` et dans l'Agent SDK, ou sur `0` pour le désactiver dans tous les types de session. Vous pouvez exécuter `/subtask`, que le mode fork soit activé ou non. Le comportement par défaut en mode interactif nécessite Claude Code v2.1.232 ou version ultérieure ; dans les versions antérieures, définissez la variable sur `1` pour activer le mode fork |311| `CLAUDE_CODE_FORK_SUBAGENT` | Contrôle le [mode fork](/docs/fr/sub-agents#turn-fork-mode-on-or-off), qui permet à Claude de lancer lui-même des [sous-agents forkés](/docs/fr/sub-agents#fork-the-current-conversation) et qui est activé par défaut uniquement dans les sessions interactives. Définissez sur `1` pour l'activer également dans `claude -p` et l'Agent SDK, ou sur `0` pour le désactiver dans tous les types de sessions. Vous pouvez exécuter `/subtask` que le mode fork soit activé ou non. La valeur par défaut interactive nécessite Claude Code v2.1.232 ou ultérieur ; dans les versions antérieures, définissez la variable sur `1` pour activer le mode fork |

310| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Définissez-la sur `1` pour émettre le texte et les blocs de réflexion des [sous-agents](/docs/fr/sub-agents) dans la sortie de `claude -p --output-format stream-json`, comme le fait le flag [`--forward-subagent-text`](/docs/fr/cli-reference#cli-flags). Utilisez la variable lorsqu'un harnais invoque `claude` et ne peut pas transmettre le flag lui-même. Contrairement au flag, qui se termine par une erreur en dehors du mode non interactif avec sortie stream-json, la variable y est ignorée, afin que les invocations imbriquées continuent de fonctionner lorsqu'elle est définie pour l'ensemble du processus. Nécessite Claude Code v2.1.211 ou version ultérieure |312| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Définissez sur `1` pour émettre le texte et les blocs de réflexion des [sous-agents](/docs/fr/sub-agents) dans la sortie de `claude -p --output-format stream-json`, avec le même comportement que le flag [`--forward-subagent-text`](/docs/fr/cli-reference#cli-flags). Utilisez la variable lorsqu'un harnais invoque `claude` et ne peut pas transmettre le flag lui-même. Contrairement au flag, qui se termine avec une erreur en dehors du mode non interactif avec une sortie stream-json, la variable y est ignorée afin que les invocations imbriquées continuent de fonctionner lorsqu'elle est définie pour l'ensemble du processus. Nécessite Claude Code v2.1.211 ou ultérieur |

311| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Définissez-la sur `1` pour envoyer les [en-têtes d'indication de passerelle](/docs/fr/llm-gateway-protocol#gateway-hint-headers), comme `x-claude-code-request-class` et `x-claude-code-compaction`, vers un proxy personnalisé ou un fournisseur tiers comme Amazon Bedrock ou Claude Platform on AWS. Définissez-la sur `0` pour ne plus les envoyer sur aucune connexion, y compris une connexion directe à l'API Anthropic, où Claude Code les envoie par défaut. Nécessite Claude Code v2.1.273 ou version ultérieure |313| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Définissez sur `1` pour envoyer les [en-têtes d'indication de passerelle](/docs/fr/llm-gateway-protocol#gateway-hint-headers), tels que `x-claude-code-request-class` et `x-claude-code-compaction`, sur un proxy personnalisé ou un fournisseur tiers comme Amazon Bedrock ou Claude Platform on AWS. Définissez sur `0` pour ne plus les envoyer sur aucune connexion, y compris une connexion directe à l'API Anthropic, où Claude Code les envoie par défaut. Nécessite Claude Code v2.1.273 ou ultérieur |

312| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Délai d'expiration en millisecondes de la requête de [découverte des modèles de la passerelle](/docs/fr/llm-gateway-protocol#model-discovery) qu'active `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (par défaut : `3000`). Augmentez-le lorsque votre passerelle a besoin de plus de trois secondes pour répondre à `/v1/models` au démarrage. N'accepte que des chiffres simples ; `0`, les valeurs négatives et les autres écritures conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou version ultérieure |314| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Délai d'expiration en millisecondes de la requête de [découverte des modèles de la passerelle](/docs/fr/llm-gateway-protocol#model-discovery) activée par `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (par défaut : `3000`). Augmentez-le lorsque votre passerelle a besoin de plus de trois secondes pour répondre à `/v1/models` au démarrage. N'accepte que des chiffres simples ; `0`, les valeurs négatives et les autres écritures conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou ultérieur |

313| `CLAUDE_CODE_GIT_BASH_PATH` | Windows uniquement : chemin vers l'exécutable Git Bash (`bash.exe`). À utiliser lorsque Git Bash est installé mais absent de votre PATH. Si le chemin n'existe pas ou si le fichier ne s'appelle pas `bash.exe`, `sh.exe`, `bash` ou `sh`, Claude Code ignore la variable et détecte automatiquement Git Bash comme si elle n'était pas définie, en journalisant un avertissement visible avec `--debug`. Avant la v2.1.219, Claude Code se fermait au démarrage lorsque le chemin n'existait pas, et utilisait n'importe quel fichier existant comme shell sans vérifier qu'il s'agissait de bash ou de sh. Consultez [Configuration sous Windows](/docs/fr/setup#set-up-on-windows) |315| `CLAUDE_CODE_GIT_BASH_PATH` | Windows uniquement : chemin vers l'exécutable Git Bash (`bash.exe`). Utilisez-la lorsque Git Bash est installé mais ne figure pas dans votre PATH. Si le chemin n'existe pas ou si le fichier ne s'appelle pas `bash.exe`, `sh.exe`, `bash` ou `sh`, Claude Code ignore la variable et détecte automatiquement Git Bash comme si elle n'était pas définie, en journalisant un avertissement visible avec `--debug`. Avant la v2.1.219, Claude Code s'arrêtait au démarrage lorsque le chemin n'existait pas, et utilisait n'importe quel fichier existant comme shell sans vérifier qu'il s'agissait de bash ou de sh. Voir [Configuration sous Windows](/docs/fr/setup#set-up-on-windows) |

314| `CLAUDE_CODE_GLOB_HIDDEN` | Définissez-la sur `false` pour exclure les dotfiles des résultats lorsque Claude invoque l'[outil Glob](/docs/fr/tools-reference#glob-tool-behavior). Ils sont inclus par défaut. N'affecte pas l'autocomplétion de fichiers `@`, `ls`, Grep ni Read |316| `CLAUDE_CODE_GLOB_HIDDEN` | Définissez sur `false` pour exclure les fichiers cachés (dotfiles) des résultats lorsque Claude invoque l'[outil Glob](/docs/fr/tools-reference#glob-tool-behavior). Inclus par défaut. N'affecte pas l'autocomplétion de fichiers `@`, `ls`, Grep ni Read |

315| `CLAUDE_CODE_GLOB_NO_IGNORE` | Définissez-la sur `false` pour que l'[outil Glob](/docs/fr/tools-reference#glob-tool-behavior) respecte les motifs `.gitignore`. Par défaut, Glob renvoie tous les fichiers correspondants, y compris ceux ignorés par git. N'affecte pas l'autocomplétion de fichiers `@`, qui dispose de son propre [paramètre `respectGitignore`](/docs/fr/settings-reference#respectgitignore) |317| `CLAUDE_CODE_GLOB_NO_IGNORE` | Définissez sur `false` pour que l'[outil Glob](/docs/fr/tools-reference#glob-tool-behavior) respecte les motifs `.gitignore`. Par défaut, Glob renvoie tous les fichiers correspondants, y compris ceux ignorés par Git. N'affecte pas l'autocomplétion de fichiers `@`, qui dispose de son propre [paramètre `respectGitignore`](/docs/fr/settings-reference#respectgitignore) |

316| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Délai d'expiration en secondes pour la découverte de fichiers par l'outil Glob. 20 secondes par défaut sur la plupart des plateformes et 60 secondes sous WSL |318| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Délai d'expiration en secondes pour la découverte de fichiers par l'outil Glob. 20 secondes par défaut sur la plupart des plateformes et 60 secondes sur WSL |

317| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Nombre de minutes pendant lesquelles le travail en arrière-plan peut faire attendre un objectif actif avant que Claude Code [demande à Claude de faire le point](/docs/fr/goal#background-work-defers-evaluation). Par défaut `30`. Définissez `0` pour désactiver ces points d'étape. Indiquez un nombre entier de minutes en chiffres simples, au maximum `10080`, soit une semaine. Claude Code traite toute autre valeur comme non définie et utilise la valeur par défaut. Nécessite Claude Code v2.1.234 ou version ultérieure |319| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Nombre de minutes pendant lesquelles un travail en arrière-plan peut faire attendre un objectif actif avant que Claude Code [demande à Claude de vérifier où il en est](/docs/fr/goal#background-work-defers-evaluation). Valeur par défaut : `30`. Définissez `0` pour désactiver ces vérifications. Indiquez des minutes entières en chiffres simples, au maximum `10080`, soit une semaine. Claude Code traite toute autre valeur comme non définie et utilise la valeur par défaut. Nécessite Claude Code v2.1.234 ou ultérieur |

318| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Définissez sur `0` pour désactiver la compression gzip des corps de requêtes de l'API Claude, de la télémétrie et de publication d'[artefacts](/docs/fr/artifacts) envoyés à `api.anthropic.com`. Par défaut, Claude Code compresse les corps de requêtes volumineux sur les connexions directes et ignore la compression lorsque vous envoyez les requêtes via un proxy, configurez un certificat client ou définissez `NODE_EXTRA_CA_CERTS`. Utilisez `0` si un [proxy d'inspection TLS](/docs/fr/network-config#ca-certificate-store) que Claude Code ne peut pas détecter gère mal les requêtes compressées |320| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Définissez sur `0` pour désactiver la compression gzip des corps de requêtes de l'API Claude, de télémétrie et de publication d'[artefacts](/docs/fr/artifacts) envoyés à `api.anthropic.com`. Par défaut, Claude Code compresse les corps de requêtes volumineux sur les connexions directes et ignore la compression lorsque vous envoyez des requêtes via un proxy, configurez un certificat client ou définissez `NODE_EXTRA_CA_CERTS`. Utilisez `0` si un [proxy d'inspection TLS](/docs/fr/network-config#ca-certificate-store) que Claude Code ne peut pas détecter gère mal les requêtes compressées |

319| `CLAUDE_CODE_HIDE_CWD` | Définissez-la sur `1` pour masquer le répertoire de travail dans le logo de démarrage. Utile pour les partages d'écran ou les enregistrements où le chemin révèle votre nom d'utilisateur système |321| `CLAUDE_CODE_HIDE_CWD` | Définissez sur `1` pour masquer le répertoire de travail dans le logo de démarrage. Utile pour les partages d'écran ou les enregistrements où le chemin expose votre nom d'utilisateur du système d'exploitation |

320| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Remplace l'adresse d'hôte utilisée pour se connecter à l'extension IDE. Par défaut, Claude Code détecte automatiquement l'adresse correcte, y compris le routage de WSL vers Windows |322| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Remplace l'adresse de l'hôte utilisée pour se connecter à l'extension de l'IDE. Par défaut, Claude Code détecte automatiquement l'adresse correcte, y compris le routage de WSL vers Windows |

321| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Définissez-la sur `1` pour ignorer l'installation automatique des extensions IDE. Équivaut à définir [`autoInstallIdeExtension`](/docs/fr/settings-reference#autoinstallideextension) sur `false` |323| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Définissez sur `1` pour ignorer l'installation automatique des extensions d'IDE. Équivaut à définir [`autoInstallIdeExtension`](/docs/fr/settings-reference#autoinstallideextension) sur `false` |

322| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Définissez-la sur `1` pour ignorer la validation des entrées du fichier de verrouillage de l'IDE lors de la connexion. À utiliser lorsque la connexion automatique ne trouve pas votre IDE alors qu'il est en cours d'exécution |324| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Définissez sur `1` pour ignorer la validation des entrées du fichier de verrouillage de l'IDE lors de la connexion. Utilisez-la lorsque la connexion automatique ne trouve pas votre IDE alors qu'il est en cours d'exécution |

323| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Nombre de [sous-agents](/docs/fr/sub-agents#concurrent-subagent-limit) pouvant s'exécuter dans une session avant que l'outil Agent refuse d'en lancer un autre (par défaut : 20). Accepte un nombre entier positif en chiffres simples ; toute autre valeur est ignorée, de sorte que la variable permet d'ajuster le plafond, mais pas de le désactiver. Nécessite Claude Code v2.1.217 ou version ultérieure |325| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Nombre de [sous-agents](/docs/fr/sub-agents#concurrent-subagent-limit) pouvant s'exécuter dans une session avant que l'outil Agent refuse d'en lancer un autre (par défaut : 20). Accepte un nombre entier positif en chiffres simples ; toute autre valeur est ignorée, de sorte que la variable peut ajuster le plafond mais pas le désactiver. Nécessite Claude Code v2.1.217 ou ultérieur |

324| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Remplace la taille de fenêtre de contexte que Claude Code suppose pour le modèle actif. Depuis la v2.1.193, la manière dont elle s'applique dépend de la façon dont Claude Code résout l'identifiant du modèle ; consultez [Corriger la fenêtre pour une passerelle ou un identifiant de modèle personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id). À utiliser lors du routage vers un modèle via `ANTHROPIC_BASE_URL` dont la fenêtre de contexte ne correspond pas à la taille intégrée associée à son nom |326| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Remplace la taille de la fenêtre de contexte que Claude Code suppose pour le modèle actif. Depuis la v2.1.193, son application dépend de la façon dont Claude Code résout l'ID du modèle ; voir [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Utilisez-la lors du routage vers un modèle via `ANTHROPIC_BASE_URL` dont la fenêtre de contexte ne correspond pas à la taille intégrée associée à son nom |

325| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Longueur maximale, en caractères, de chaque description d'outil MCP et des instructions de chaque serveur MCP que Claude Code envoie au modèle (par défaut : 2048). Claude Code [tronque les textes plus longs](/docs/fr/mcp#for-mcp-server-authors). Accepte un nombre entier positif en chiffres simples. Toute autre valeur est ignorée et la valeur par défaut s'applique. Nécessite Claude Code v2.1.280 ou version ultérieure |327| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Longueur maximale, en caractères, de chaque description d'outil MCP et des instructions de chaque serveur MCP que Claude Code envoie au modèle (par défaut : 2048). Claude Code [tronque les textes plus longs](/docs/fr/mcp#for-mcp-server-authors). Accepte un nombre entier positif en chiffres simples. Toute autre valeur est ignorée et la valeur par défaut s'applique. Nécessite Claude Code v2.1.280 ou ultérieur |

326| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Définit le nombre maximal de tokens de sortie pour la plupart des requêtes. Les valeurs par défaut et les plafonds varient selon le modèle ; consultez [nombre maximal de tokens de sortie](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code ramène au plafond toute valeur supérieure au plafond d'un modèle. Pour un identifiant de modèle que Claude Code ne parvient pas à associer à un modèle connu, la valeur par défaut est 32000 et le plafond est 128000. Augmenter cette valeur réduit la fenêtre de contexte effectivement disponible avant le déclenchement de la [compaction automatique](/docs/fr/costs#reduce-token-usage) |328| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Définit le nombre maximal de tokens de sortie pour la plupart des requêtes. Les valeurs par défaut et les plafonds varient selon le modèle ; voir [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code ramène au plafond une valeur supérieure au plafond d'un modèle. Pour un ID de modèle que Claude Code ne peut pas associer à un modèle connu, la valeur par défaut est 32000 et le plafond 128000. Augmenter cette valeur réduit la fenêtre de contexte effective disponible avant le déclenchement de la [compaction automatique](/docs/fr/costs#reduce-token-usage) |

327| `CLAUDE_CODE_MAX_RETRIES` | Remplace le nombre de nouvelles tentatives pour les requêtes API ayant échoué (par défaut : 10). Plafonné à 15 depuis la v2.1.186 ; depuis la v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` augmente la valeur par défaut et supprime le plafond. Pour les sessions sans surveillance qui doivent patienter pendant des pannes plus longues, définissez plutôt `CLAUDE_CODE_RETRY_WATCHDOG` |329| `CLAUDE_CODE_MAX_RETRIES` | Remplace le nombre de nouvelles tentatives pour les requêtes API ayant échoué (par défaut : 10). Plafonné à 15 depuis la v2.1.186 ; depuis la v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` augmente la valeur par défaut et supprime le plafond. Pour les sessions sans surveillance qui doivent patienter pendant des pannes plus longues, définissez plutôt `CLAUDE_CODE_RETRY_WATCHDOG` |

328| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Supprimée dans la v2.1.224 et désormais sans effet. Plafonnait auparavant le nombre total de [sous-agents](/docs/fr/sub-agents) que Claude pouvait lancer avec l'outil Agent au cours d'une session (par défaut : 200) ; tout lancement au-delà du plafond échouait avec `Subagent spawn limit reached`. La [limite de sous-agents simultanés](/docs/fr/sub-agents#concurrent-subagent-limit) et la [limite de profondeur](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents) s'appliquent toujours |330| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Supprimée dans la v2.1.224 et désormais sans effet. Plafonnait auparavant le nombre total de [sous-agents](/docs/fr/sub-agents) que Claude pouvait lancer avec l'outil Agent dans une session (par défaut : 200) ; tout lancement au-delà du plafond échouait avec `Subagent spawn limit reached`. La [limite de sous-agents simultanés](/docs/fr/sub-agents#concurrent-subagent-limit) et la [limite de profondeur](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents) s'appliquent toujours |

329| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Nombre de [niveaux de sous-agents](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents) autorisés sous la conversation principale (par défaut : 3). Avec la valeur par défaut, les sous-agents peuvent lancer leurs propres sous-agents, et un sous-agent du troisième niveau ne peut pas en lancer d'autres ; définissez `1` pour désactiver l'imbrication. De la v2.1.217 à la v2.1.218, la valeur par défaut était 1 : un sous-agent ne pouvait donc pas lancer les siens à moins que vous n'augmentiez la limite ; la v2.1.219 a porté la valeur par défaut à 3. Accepte un nombre entier positif en chiffres simples ; toute autre valeur est ignorée, de sorte que la limite peut être ajustée, mais pas supprimée. Nécessite Claude Code v2.1.217 ou version ultérieure |331| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Nombre de [niveaux de sous-agents](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents) autorisés sous la conversation principale (par défaut : 3). Avec la valeur par défaut, les sous-agents peuvent lancer leurs propres sous-agents, et un sous-agent au troisième niveau ne peut plus en lancer ; définissez `1` pour désactiver l'imbrication. De la v2.1.217 à la v2.1.218, la valeur par défaut était 1, de sorte qu'un sous-agent ne pouvait pas lancer les siens à moins que vous n'augmentiez la limite ; la v2.1.219 a porté la valeur par défaut à 3. Accepte un nombre entier positif en chiffres simples ; toute autre valeur est ignorée, de sorte que la limite peut être ajustée mais pas supprimée. Nécessite Claude Code v2.1.217 ou ultérieur |

330| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Nombre maximal d'outils en lecture seule et de sous-agents pouvant s'exécuter en parallèle (par défaut : 10). Des valeurs plus élevées augmentent le parallélisme mais consomment davantage de ressources |332| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Nombre maximal d'outils en lecture seule et de sous-agents pouvant s'exécuter en parallèle (par défaut : 10). Des valeurs plus élevées augmentent le parallélisme mais consomment davantage de ressources |

331| `CLAUDE_CODE_MAX_TURNS` | Plafonne le nombre de tours agentiques lorsqu'aucune limite explicite n'est transmise. Équivaut à transmettre [`--max-turns`](/docs/fr/cli-reference#cli-flags), qui a priorité lorsque les deux sont définis. Une valeur qui n'est pas un entier positif est rejetée au démarrage avec une erreur, au lieu d'être traitée comme une absence de plafond |333| `CLAUDE_CODE_MAX_TURNS` | Plafonne le nombre de tours agentiques lorsqu'aucune limite explicite n'est transmise. Équivaut à transmettre [`--max-turns`](/docs/fr/cli-reference#cli-flags), qui a priorité lorsque les deux sont définis. Une valeur qui n'est pas un entier positif est rejetée au démarrage avec une erreur plutôt que d'être traitée comme une absence de plafond |

332| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Plafond du nombre total d'appels [WebSearch](/docs/fr/tools-reference#websearch-tool-behavior) qu'une session peut effectuer (par défaut : 200). Lorsque Claude atteint le plafond, les appels WebSearch suivants renvoient un avis lui indiquant de poursuivre avec les informations déjà recueillies. Accepte un nombre entier positif sans limite supérieure. Toute autre valeur est ignorée et la valeur par défaut s'applique, de sorte que le plafond peut être relevé, mais pas désactivé. Nécessite Claude Code v2.1.212 ou version ultérieure |334| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Plafond du nombre total d'appels [WebSearch](/docs/fr/tools-reference#websearch-tool-behavior) qu'une session peut effectuer (par défaut : 200). Lorsque Claude atteint le plafond, les appels WebSearch suivants renvoient un avis lui indiquant de poursuivre avec les informations déjà recueillies. Accepte un nombre entier positif sans limite supérieure. Toute autre valeur est ignorée et la valeur par défaut s'applique, de sorte que le plafond peut être relevé mais pas désactivé. Nécessite Claude Code v2.1.212 ou ultérieur |

333| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Définissez-la sur `1` pour lancer les serveurs MCP stdio avec uniquement un environnement de base sûr complété par l'`env` configuré pour le serveur, au lieu d'hériter de l'environnement de votre shell |335| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Définissez sur `1` pour lancer les serveurs MCP stdio avec uniquement un environnement de base sûr plus le `env` configuré pour le serveur, au lieu d'hériter de l'environnement de votre shell |

334| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Temps écoulé, en millisecondes, avant qu'un appel d'outil MCP toujours en cours [devienne une tâche en arrière-plan](/docs/fr/mcp#automatic-backgrounding-of-long-tool-calls) (par défaut : 120000, soit 2 minutes). Définissez-la sur `0` pour désactiver ce passage automatique en arrière-plan. Nécessite Claude Code v2.1.212 ou version ultérieure |336| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Temps écoulé en millisecondes avant qu'un appel d'outil MCP toujours en cours [passe en tâche en arrière-plan](/docs/fr/mcp#automatic-backgrounding-of-long-tool-calls) (par défaut : 120000, soit 2 minutes). Définissez sur `0` pour désactiver le passage automatique en arrière-plan. Nécessite Claude Code v2.1.212 ou ultérieur |

335| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Durée, en millisecondes, pendant laquelle le premier tour d'une session [non interactive](/docs/fr/headless) attend les serveurs MCP encore en cours de connexion, à la place de l'[attente du premier tour](/docs/fr/agent-sdk/mcp#connection-timing) par défaut. Lorsqu'elle est définie, l'attente couvre tous les serveurs en attente. Définissez-la sur `0` pour ne pas attendre. Un serveur [`--permission-prompt-tool`](/docs/fr/cli-reference#cli-flags) conserve sa propre attente `MCP_TIMEOUT`, quelle que soit la valeur. Nécessite Claude Code v2.1.274 ou version ultérieure |337| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Durée en millisecondes pendant laquelle le premier tour d'une session [non interactive](/docs/fr/headless) attend les serveurs MCP encore en cours de connexion, à la place de l'[attente du premier tour](/docs/fr/agent-sdk/mcp#connection-timing) par défaut. Lorsqu'elle est définie, l'attente couvre tous les serveurs en attente. Définissez sur `0` pour ignorer l'attente. Un serveur [`--permission-prompt-tool`](/docs/fr/cli-reference#cli-flags) conserve sa propre attente `MCP_TIMEOUT` quelle que soit la valeur. Nécessite Claude Code v2.1.274 ou ultérieur |

336| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Délai d'inactivité en millisecondes pour les appels d'outils MCP. Lorsqu'un serveur MCP stdio, HTTP, SSE, WebSocket ou [connecteur claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai) n'envoie ni réponse ni notification de progression pendant cette durée, l'appel d'outil s'interrompt avec une erreur au lieu d'attendre l'expiration du `MCP_TOOL_TIMEOUT` global. Remplace les valeurs par défaut propres à chaque transport, soit 300000 (5 minutes) pour les serveurs réseau et 1800000 (30 minutes) pour les serveurs stdio. Définissez-la sur `0` pour désactiver la vérification d'inactivité. Les valeurs inférieures à 1000 sont portées à une seconde, et la valeur est plafonnée au `MCP_TOOL_TIMEOUT` effectif. Un `timeout` par serveur d'au moins 1000 dans `.mcp.json` porte la fenêtre d'inactivité de ce serveur au moins à la valeur de `timeout`. Ne s'applique ni aux serveurs IDE ni aux serveurs SDK intégrés au processus. Nécessite Claude Code v2.1.187 ou version ultérieure. Avant la v2.1.203, les serveurs stdio étaient exemptés du délai d'inactivité |338| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Délai d'inactivité en millisecondes pour les appels d'outils MCP. Lorsqu'un serveur MCP stdio, HTTP, SSE, WebSocket ou [connecteur claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai) n'envoie ni réponse ni notification de progression pendant cette durée, l'appel d'outil s'interrompt avec une erreur au lieu d'attendre le `MCP_TOOL_TIMEOUT` global. Remplace les valeurs par défaut par transport de 300000 (5 minutes) pour les serveurs réseau et de 1800000 (30 minutes) pour les serveurs stdio. Définissez sur `0` pour désactiver la vérification d'inactivité. Les valeurs inférieures à 1000 sont portées à une seconde, et la valeur est plafonnée au `MCP_TOOL_TIMEOUT` effectif. Un `timeout` par serveur d'au moins 1000 dans `.mcp.json` porte la fenêtre d'inactivité de ce serveur à au moins la valeur de `timeout`. Ne s'applique pas aux serveurs de l'IDE ni aux serveurs SDK en processus. Nécessite Claude Code v2.1.187 ou ultérieur. Avant la v2.1.203, les serveurs stdio étaient exemptés du délai d'inactivité |

337| `CLAUDE_CODE_MESSAGING_SOCKET` | Définie par Claude Code, pas par vous : dans les sessions qui lient un [socket de boîte de réception](/docs/fr/cross-session-messaging#the-sessions-inbox-socket), Claude Code exporte le chemin de ce socket vers les hooks et les commandes Bash au moment où il lie le socket. Dans une session qui démarre avec la messagerie activée, Claude Code lie le socket avant l'exécution de tout hook. Les autres sessions de la machine livrent leurs messages à ce chemin. Chaque session exporte son propre socket plutôt qu'un socket hérité d'un parent, et les messages qui y arrivent passent par les [contrôles des messages entrants](/docs/fr/cross-session-messaging#control-inbound-messages) de la session. Les blocs `env` des paramètres ne peuvent pas la définir. Nécessite Claude Code v2.1.224 ou version ultérieure |339| `CLAUDE_CODE_MESSAGING_SOCKET` | Définie par Claude Code, pas par vous : dans les sessions qui lient un [socket de boîte de réception](/docs/fr/cross-session-messaging#the-sessions-inbox-socket), Claude Code exporte le chemin de ce socket vers les hooks et les commandes Bash lorsqu'il lie le socket. Dans une session qui démarre avec la messagerie activée, Claude Code lie le socket avant l'exécution de tout hook. Les autres sessions de la machine délivrent les messages à ce chemin. Chaque session exporte son propre socket plutôt qu'un socket hérité d'un parent, et les messages qui y arrivent passent par les [contrôles des messages entrants](/docs/fr/cross-session-messaging#control-inbound-messages) de la session. Les blocs `env` des paramètres ne peuvent pas la définir. Nécessite Claude Code v2.1.224 ou ultérieur |

338| `CLAUDE_CODE_MESSAGING_TOKEN` | Définie par Claude Code, pas par vous : dans les sessions qui lient un [socket de boîte de réception](/docs/fr/cross-session-messaging#the-sessions-inbox-socket), Claude Code exporte ce jeton propre à la session vers les hooks et les commandes Bash, en plus de `CLAUDE_CODE_MESSAGING_SOCKET`. Un script qui écrit sur le socket peut envoyer `{"type":"auth","token":"<token>"}` comme première ligne pour prouver qu'il appartient à la session. Sous Windows natif, Claude Code exige cette ligne et ferme toute connexion qui ne commence pas par une ligne valide. Les [règles relatives aux processus enfants propres](/docs/fr/cross-session-messaging#the-sessions-inbox-socket) précisent quand Claude Code consulte le jeton. Chaque session exporte son propre jeton, jamais un jeton hérité d'une session parente. Les blocs `env` des paramètres ne peuvent pas la définir. Nécessite Claude Code v2.1.228 ou version ultérieure |340| `CLAUDE_CODE_MESSAGING_TOKEN` | Définie par Claude Code, pas par vous : dans les sessions qui lient un [socket de boîte de réception](/docs/fr/cross-session-messaging#the-sessions-inbox-socket), Claude Code exporte ce jeton propre à la session vers les hooks et les commandes Bash en même temps que `CLAUDE_CODE_MESSAGING_SOCKET`. Un script qui publie sur le socket peut envoyer `{"type":"auth","token":"<token>"}` comme première ligne pour prouver qu'il appartient à la session. Sous Windows natif, Claude Code exige cette ligne et ferme toute connexion qui ne commence pas par une ligne valide. Les [règles relatives aux processus enfants propres](/docs/fr/cross-session-messaging#the-sessions-inbox-socket) indiquent quand Claude Code consulte le jeton. Chaque session exporte son propre jeton, jamais un jeton hérité d'une session parente. Les blocs `env` des paramètres ne peuvent pas la définir. Nécessite Claude Code v2.1.228 ou ultérieur |

339| `CLAUDE_CODE_NATIVE_CURSOR` | Définissez-la sur `1` pour afficher le curseur propre au terminal à la position de saisie au lieu d'un bloc dessiné. Le curseur respecte les paramètres de clignotement, de forme et de focus du terminal |341| `CLAUDE_CODE_NATIVE_CURSOR` | Définissez sur `1` pour afficher le curseur propre au terminal au point d'insertion au lieu d'un bloc dessiné. Le curseur respecte les paramètres de clignotement, de forme et de focus du terminal. Définir `0` revient à laisser la variable non définie, de sorte que cela ne rétablit pas le bloc dessiné dans une session où le curseur propre au terminal est déjà activé |

340| `CLAUDE_CODE_NEW_INIT` | Définissez-la sur `1` pour que `/init` exécute un processus de configuration interactif. Ce processus demande quels fichiers générer, notamment CLAUDE.md, des skills et des hooks, avant d'explorer la base de code et de les écrire. Sans cette variable, `/init` génère automatiquement un CLAUDE.md sans rien vous demander |342| `CLAUDE_CODE_NEW_INIT` | Définissez sur `1` pour que `/init` exécute un processus de configuration interactif. Ce processus demande quels fichiers générer, notamment CLAUDE.md, les skills et les hooks, avant d'explorer la base de code et de les écrire. Sans cette variable, `/init` génère automatiquement un CLAUDE.md sans rien demander |

341| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Définissez-la sur `1` pour écrire la sortie du terminal via un second descripteur de fichier non bloquant, afin qu'un terminal qui cesse de lire, comme un volet tmux en mode contrôle mis en pause ou une connexion SSH bloquée, ne puisse pas figer Claude Code en cours de session. S'applique sous macOS, Linux et WSL lorsque stdout est un terminal. Nécessite Claude Code v2.1.261 ou version ultérieure |343| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Définissez sur `1` pour écrire la sortie du terminal via un second descripteur de fichier non bloquant, afin qu'un terminal qui cesse de lire, comme un volet tmux en mode contrôle mis en pause ou une connexion SSH bloquée, ne puisse pas figer Claude Code en cours de session. S'applique sur macOS, Linux et WSL lorsque stdout est un terminal. Nécessite Claude Code v2.1.261 ou ultérieur |

342| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limite le nombre de fois où Claude Code renvoie une [requête sans streaming](/docs/fr/errors#streaming-response-ended-before-any-complete-data-was-received) qui expire. Avec `0`, la requête échoue dès la première expiration. Non définie par défaut, de sorte que c'est `CLAUDE_CODE_MAX_RETRIES` qui limite ces renvois. Consultez [Ajuster le comportement des nouvelles tentatives](/docs/fr/errors#tune-retry-behavior) pour le délai d'expiration. Nécessite Claude Code v2.1.285 ou version ultérieure |344| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limite le nombre de fois où Claude Code renvoie une [requête sans streaming](/docs/fr/errors#streaming-response-ended-before-any-complete-data-was-received) qui expire. Avec `0`, la requête échoue dès le premier délai d'expiration. Non définie par défaut, de sorte que `CLAUDE_CODE_MAX_RETRIES` limite ces renvois. Voir [Ajuster le comportement des nouvelles tentatives](/docs/fr/errors#tune-retry-behavior) pour le délai d'expiration. Nécessite Claude Code v2.1.285 ou ultérieur |

343| `CLAUDE_CODE_NO_FLICKER` | Définissez-la sur `1` pour activer le [rendu plein écran](/docs/fr/fullscreen), en research preview, qui réduit le scintillement et maintient une consommation de mémoire stable dans les longues conversations. Remplace le paramètre [`tui`](/docs/fr/settings-reference#tui) ; vous pouvez aussi basculer avec `/tui fullscreen` |345| `CLAUDE_CODE_NO_FLICKER` | Définissez sur `1` pour activer le [rendu plein écran](/docs/fr/fullscreen), en research preview, qui réduit le scintillement et maintient une consommation mémoire stable dans les longues conversations. Remplace le paramètre [`tui`](/docs/fr/settings-reference#tui) ; vous pouvez aussi basculer avec `/tui fullscreen` |

344| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Jeton d'actualisation OAuth pour l'authentification Claude.ai. Lorsqu'il est défini, `claude auth login` échange directement ce jeton au lieu d'ouvrir un navigateur. Nécessite `CLAUDE_CODE_OAUTH_SCOPES`. Utile pour provisionner l'authentification dans des environnements automatisés |346| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Jeton d'actualisation OAuth pour l'authentification Claude.ai. Lorsqu'il est défini, `claude auth login` échange directement ce jeton au lieu d'ouvrir un navigateur. Nécessite `CLAUDE_CODE_OAUTH_SCOPES`. Utile pour provisionner l'authentification dans des environnements automatisés |

345| `CLAUDE_CODE_OAUTH_SCOPES` | Scopes OAuth, séparés par des espaces, avec lesquels le jeton d'actualisation a été émis, par exemple `"user:profile user:inference user:sessions:claude_code"`. Requise lorsque `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` est défini |347| `CLAUDE_CODE_OAUTH_SCOPES` | Scopes OAuth séparés par des espaces avec lesquels le jeton d'actualisation a été émis, par exemple `"user:profile user:inference user:sessions:claude_code"`. Requise lorsque `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` est définie |

346| `CLAUDE_CODE_OAUTH_TOKEN` | Jeton d'accès OAuth pour l'authentification claude.ai. Alternative à `/login` pour le SDK et les environnements automatisés. A priorité sur les identifiants stockés dans le trousseau. Générez-en un avec [`claude setup-token`](/docs/fr/authentication#generate-a-long-lived-token). À moins que vous n'exécutiez [`/login`](/docs/fr/authentication#authentication-precedence), Claude Code utilise le jeton que vous avez défini pendant toute la session. Pour remplacer un jeton expiré, générez-en un nouveau et redémarrez |348| `CLAUDE_CODE_OAUTH_TOKEN` | Jeton d'accès OAuth pour l'authentification claude.ai. Alternative à `/login` pour le SDK et les environnements automatisés. A priorité sur les identifiants stockés dans le trousseau. Générez-en un avec [`claude setup-token`](/docs/fr/authentication#generate-a-long-lived-token). À moins que vous n'exécutiez [`/login`](/docs/fr/authentication#authentication-precedence), Claude Code utilise le jeton que vous avez défini pour toute la session. Pour remplacer un jeton expiré, générez-en un nouveau et redémarrez |

347| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Supprimée dans la v2.1.160 et désormais sans effet. Épinglait auparavant le [mode rapide](/docs/fr/fast-mode) sur Claude Opus 4.6 au lieu du modèle par défaut actuel. Opus 4.6 ne prend plus en charge le mode rapide |349| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Supprimée dans la v2.1.160 et désormais sans effet. Épinglait auparavant le [mode rapide](/docs/fr/fast-mode) sur Claude Opus 4.6 au lieu du modèle par défaut actuel. Opus 4.6 ne prend plus en charge le mode rapide |

348| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Longueur maximale des attributs OpenTelemetry porteurs de contenu (réponses du modèle, contenu des outils, prompts système, corps bruts des requêtes API), marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, soit 60 Ko). Augmentez-la uniquement si votre backend de télémétrie accepte des valeurs d'attribut supérieures à 64 Ko, ou réduisez-la pour diminuer le volume de télémétrie. Nécessite Claude Code v2.1.214 ou version ultérieure. Consultez [Surveillance](/docs/fr/monitoring-usage) |350| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Longueur maximale des attributs OpenTelemetry porteurs de contenu (réponses du modèle, contenu des outils, prompts système, corps bruts de l'API), marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, soit 60 Ko). Ne l'augmentez que si votre backend de télémétrie accepte des valeurs d'attributs supérieures à 64 Ko, ou réduisez-la pour diminuer le volume de télémétrie. Nécessite Claude Code v2.1.214 ou ultérieur. Voir [Surveillance](/docs/fr/monitoring-usage) |

349| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Définissez-la sur `1` pour écrire sur stderr les erreurs de diagnostic de l'exportateur OpenTelemetry. Par défaut, ces erreurs n'apparaissent qu'avec `--debug`, si bien qu'un exportateur mal configuré, par exemple à cause d'un conflit de port Prometheus, échoue sinon silencieusement. Nécessite Claude Code v2.1.179 ou version ultérieure. Consultez [Surveillance](/docs/fr/monitoring-usage) |351| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Définissez sur `1` pour écrire les erreurs de diagnostic de l'exportateur OpenTelemetry sur stderr. Par défaut, ces erreurs n'apparaissent qu'avec `--debug`, de sorte qu'un exportateur mal configuré, par exemple en cas de collision de port Prometheus, échoue sinon silencieusement. Nécessite Claude Code v2.1.179 ou ultérieur. Voir [Surveillance](/docs/fr/monitoring-usage) |

350| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Délai d'expiration en millisecondes pour le vidage des spans OpenTelemetry en attente (par défaut : 5000). Consultez [Surveillance](/docs/fr/monitoring-usage) |352| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Délai d'expiration en millisecondes pour vider les spans OpenTelemetry en attente (par défaut : 5000). Voir [Surveillance](/docs/fr/monitoring-usage) |

351| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalle d'actualisation des en-têtes OpenTelemetry dynamiques, en millisecondes (par défaut : 1740000 / 29 minutes). Consultez [En-têtes dynamiques](/docs/fr/monitoring-usage#dynamic-headers) |353| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalle d'actualisation des en-têtes OpenTelemetry dynamiques en millisecondes (par défaut : 1740000 / 29 minutes). Voir [En-têtes dynamiques](/docs/fr/monitoring-usage#dynamic-headers) |

352| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Délai d'expiration en millisecondes accordé à l'exportateur OpenTelemetry pour terminer lors de l'arrêt (par défaut : 2000). Augmentez-le si des métriques sont perdues à la fermeture. Consultez [Surveillance](/docs/fr/monitoring-usage) |354| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Délai d'expiration en millisecondes accordé à l'exportateur OpenTelemetry pour terminer lors de l'arrêt (par défaut : 2000). Augmentez-le si des métriques sont perdues à la sortie. Voir [Surveillance](/docs/fr/monitoring-usage) |

353| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Définissez-la sur `1` pour permettre à Claude Code d'exécuter en arrière-plan la commande de mise à niveau de votre gestionnaire de paquets lorsqu'une nouvelle version est disponible. S'applique aux installations Homebrew et WinGet. Les autres gestionnaires de paquets continuent d'afficher la commande de mise à niveau sans l'exécuter. Consultez [Mises à jour automatiques](/docs/fr/setup#auto-updates) |355| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Définissez sur `1` pour permettre à Claude Code d'exécuter la commande de mise à niveau de votre gestionnaire de paquets en arrière-plan lorsqu'une nouvelle version est disponible. S'applique aux installations Homebrew et WinGet. Les autres gestionnaires de paquets continuent d'afficher la commande de mise à niveau sans l'exécuter. Voir [Mises à jour automatiques](/docs/fr/setup#auto-updates) |

354| `CLAUDE_CODE_PERFORCE_MODE` | Définissez-la sur `1` pour activer une protection en écriture adaptée à Perforce. Lorsqu'elle est définie, Edit, Write et NotebookEdit échouent avec une indication `p4 edit <file>` si le fichier cible n'a pas le bit d'écriture propriétaire, que Perforce retire sur les fichiers synchronisés jusqu'à ce que `p4 edit` les ouvre. Cela empêche Claude Code de contourner le suivi des modifications de Perforce |356| `CLAUDE_CODE_PERFORCE_MODE` | Définissez sur `1` pour activer la protection en écriture adaptée à Perforce. Lorsqu'elle est définie, Edit, Write et NotebookEdit échouent avec une indication `p4 edit <file>` si le fichier cible n'a pas le bit d'écriture du propriétaire, que Perforce retire des fichiers synchronisés jusqu'à ce que `p4 edit` les ouvre. Cela empêche Claude Code de contourner le suivi des modifications de Perforce |

355| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Remplace le répertoire racine des plugins. Malgré son nom, cette variable définit le répertoire parent, et non le cache lui-même : les marketplaces et le cache des plugins se trouvent dans des sous-répertoires de ce chemin. Par défaut `~/.claude/plugins` |357| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Remplace le répertoire racine des plugins. Malgré son nom, cette variable définit le répertoire parent, et non le cache lui-même : les marketplaces et le cache des plugins se trouvent dans des sous-répertoires de ce chemin. Valeur par défaut : `~/.claude/plugins` |

356| `CLAUDE_CODE_PLUGIN_DIRS` | Répertoires de plugins à charger pour la session, chacun étant chargé comme le ferait un flag [`--plugin-dir`](/docs/fr/plugins/cli-reference#flags-that-load-a-plugin-for-one-session). Séparez plusieurs chemins par `:` sous Unix ou `;` sous Windows. Indiquez chaque chemin sous forme de chemin absolu ou faites-le commencer par `~`, car Claude Code ignore les chemins relatifs. Nécessite Claude Code v2.1.280 ou version ultérieure. Consultez [Charger un plugin pour une session](/docs/fr/plugins/create#load-a-directory-or-archive-for-one-session) |358| `CLAUDE_CODE_PLUGIN_DIRS` | Répertoires de plugins à charger pour la session, chacun chargé comme le ferait un flag [`--plugin-dir`](/docs/fr/plugins/cli-reference#flags-that-load-a-plugin-for-one-session). Séparez plusieurs chemins par `:` sous Unix ou `;` sous Windows. Indiquez chaque chemin sous forme de chemin absolu ou commencez-le par `~`, car Claude Code ignore les chemins relatifs. Nécessite Claude Code v2.1.280 ou ultérieur. Voir [Charger un plugin pour une seule session](/docs/fr/plugins/create#load-a-directory-or-archive-for-one-session) |

357| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Délai d'expiration en millisecondes pour le clonage ou l'actualisation d'une marketplace de plugins (par défaut : 120000). Augmentez cette valeur pour les dépôts volumineux ou les connexions réseau lentes. Consultez [Git clone timed out](/docs/fr/plugins/troubleshooting#git-clone-timed-out-after-120s) |359| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | Contrôle si Claude Code recharge un [mod](/docs/fr/plugins/mods/overview) lorsque les fichiers du mod changent. Le rechargement s'applique à un mod que vous chargez depuis un répertoire avec `--plugin-dir`, et il est activé par défaut dans les sessions interactives. Définissez sur `1` pour l'activer également dans les sessions non interactives, ou sur `0` pour le désactiver dans toutes les sessions. Nécessite Claude Code v2.1.287 ou ultérieur. Voir [paramètres et variables d'environnement des mods](/docs/fr/plugins/mods/reference#settings-and-environment-variables) |

358| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Définissez-la sur `1` pour ne pas tenter de re-cloner et continuer à utiliser le checkout existant de la marketplace lorsqu'une actualisation de marketplace ne parvient pas à joindre le dépôt distant ou à s'y authentifier. Utile dans les environnements hors ligne ou isolés (airgapped), où un nouveau clonage échouerait de la même manière. Consultez [Les mises à jour de marketplace échouent dans les environnements hors ligne](/docs/fr/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |360| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Délai d'expiration en millisecondes pour le clonage ou l'actualisation d'une marketplace de plugins (par défaut : 120000). Augmentez cette valeur pour les dépôts volumineux ou les connexions réseau lentes. Voir [Git clone timed out](/docs/fr/plugins/troubleshooting#git-clone-timed-out-after-120s) |

359| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Définissez-la sur `1` pour cloner les sources GitHub en notation abrégée `owner/repo` via HTTPS au lieu de SSH. S'applique à l'installation et à la mise à jour des plugins, ainsi qu'à `/plugin marketplace add` et `update`. Utile dans les runners CI, les conteneurs ou tout environnement sans clé SSH configurée pour `github.com` |361| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Définissez sur `1` pour ignorer la tentative de reclonage et continuer à utiliser l'extraction existante de la marketplace lorsqu'une actualisation de marketplace ne parvient pas à joindre le dépôt distant ou à s'y authentifier. Utile dans les environnements hors ligne ou isolés (airgapped) où le reclonage échouerait de la même manière. Voir [Les mises à jour de marketplace échouent dans les environnements hors ligne](/docs/fr/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |

360| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Chemin vers un ou plusieurs répertoires d'amorçage de plugins en lecture seule, séparés par `:` sous Unix ou `;` sous Windows. Utilisez-la pour intégrer un répertoire de plugins prérempli dans une image de conteneur. Claude Code enregistre les marketplaces de ces répertoires au démarrage et utilise les plugins déjà mis en cache sans les re-cloner. Consultez [Préremplir les plugins pour les conteneurs](/docs/fr/plugins/org#seed-containers-and-ci) |362| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Définissez sur `1` pour cloner les sources abrégées GitHub `owner/repo` via HTTPS au lieu de SSH. S'applique à l'installation et à la mise à jour des plugins, ainsi qu'à `/plugin marketplace add` et `update`. Utile dans les runners CI, les conteneurs ou tout environnement sans clé SSH configurée pour `github.com` |

361| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Définissez-la sur `1` pour empêcher Claude Code de transmettre `-ExecutionPolicy Bypass` lorsqu'il lance PowerShell pour les appels d'outils, les hooks et les commandes de barre de statut, et respecter à la place la stratégie d'exécution effective de la machine. Par défaut, Claude Code contourne la stratégie d'exécution au niveau du processus afin que les scripts `.ps1` et les imports de modules fonctionnent sur les installations Windows configurées par défaut en mode Restricted. Le contournement au niveau du processus ne l'emporte jamais sur les stratégies de groupe `MachinePolicy` ou `UserPolicy`, quelle que soit la valeur de ce paramètre |363| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Chemin vers un ou plusieurs répertoires d'amorçage de plugins en lecture seule, séparés par `:` sous Unix ou `;` sous Windows. Utilisez-la pour intégrer un répertoire de plugins pré-rempli dans une image de conteneur. Claude Code enregistre les marketplaces à partir de ces répertoires au démarrage et utilise les plugins pré-mis en cache sans les recloner. Voir [Pré-remplir les plugins pour les conteneurs](/docs/fr/plugins/org#seed-containers-and-ci) |

362| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Plafond, en millisecondes, de l'attente inactive du travail en arrière-plan, comme les sous-agents et les workflows, après le dernier tour en [mode non interactif](/docs/fr/headless#background-tasks-at-exit) avec le flag `-p`. L'attente inactive repart de zéro chaque fois que Claude effectue un tour pour traiter un résultat en arrière-plan. Par défaut : `600000`, soit 10 minutes. Lorsque l'attente inactive atteint le plafond, Claude Code cesse d'attendre les tâches en arrière-plan restantes et se ferme. Définissez-la sur `0` pour attendre indéfiniment. Ce plafond est distinct de la période de grâce de cinq secondes qui s'applique aux simples shells en arrière-plan. Nécessite Claude Code v2.1.182 ou version ultérieure |364| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Définissez sur `1` pour empêcher Claude Code de transmettre `-ExecutionPolicy Bypass` lorsqu'il lance PowerShell pour les appels d'outils, les hooks et les commandes de barre de statut, et respecter à la place la stratégie d'exécution effective de la machine. Par défaut, Claude Code contourne la stratégie d'exécution au niveau du processus afin que les scripts `.ps1` et les importations de modules fonctionnent sur les installations Windows en mode Restricted par défaut. Le contournement au niveau du processus ne remplace jamais les stratégies de groupe `MachinePolicy` ou `UserPolicy`, quel que soit ce paramètre |

363| `CLAUDE_CODE_PROCESS_WRAPPER` | Lance les processus que Claude Code démarre à partir de son propre binaire, comme le service en arrière-plan qui héberge les sessions de la [vue des agents](/docs/fr/agent-view), via un lanceur d'entreprise indiqué sous forme de préfixe argv, par exemple `/opt/corp/launcher`. Définissez-la dans le bloc `env` des paramètres utilisateur ou des [paramètres gérés](/docs/fr/managed-settings), et non comme un export du shell, afin que le service en arrière-plan détaché en hérite ; les paramètres de projet et locaux ne peuvent pas la définir. Équivaut au [paramètre `processWrapper`](/docs/fr/settings-reference#processwrapper), qui nécessite Claude Code v2.1.210 ou version ultérieure ; cette variable a priorité lorsque les deux sont définis. L'extension VS Code configure son propre lanceur séparément via son paramètre `claudeProcessWrapper`. Ignorée sous Windows. Consultez [Exécuter Claude Code derrière un lanceur d'entreprise](/docs/fr/corporate-launcher) pour le format de la valeur, le périmètre couvert par le lanceur et le contrat qu'il doit respecter. Nécessite Claude Code v2.1.208 ou version ultérieure |365| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Plafond en millisecondes de l'attente inactive du travail en arrière-plan, comme les sous-agents et les workflows, après le dernier tour en [mode non interactif](/docs/fr/headless#background-tasks-at-exit) avec le flag `-p`. L'attente inactive redémarre chaque fois que Claude effectue un tour pour traiter un résultat en arrière-plan. Valeur par défaut : `600000`, soit 10 minutes. Lorsque l'attente inactive atteint le plafond, Claude Code cesse d'attendre les tâches en arrière-plan restantes et quitte. Définissez sur `0` pour attendre indéfiniment. Ce plafond est distinct du délai de grâce de cinq secondes qui s'applique aux simples shells en arrière-plan. Nécessite Claude Code v2.1.182 ou ultérieur |

364| `CLAUDE_CODE_PROJECT_DIR_NAME` | À définir conjointement avec `CLAUDE_CONFIG_DIR` pour choisir le nom du répertoire `projects/` sous lequel Claude Code stocke les transcriptions et la mémoire automatique de cette session, à la place d'un nom dérivé du chemin du répertoire de travail. Par exemple, démarrer Claude Code avec `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` les stocke sous `/srv/tenant-a/projects/work/`. Claude Code ignore cette variable lorsque `CLAUDE_CONFIG_DIR` n'est pas définie, et ne la lit que depuis l'environnement à partir duquel vous démarrez `claude`, jamais depuis le [bloc `env` d'un fichier de paramètres](#in-settings-files). Consultez [Nommer vous-même le répertoire du projet](/docs/fr/sessions#name-the-project-directory-yourself). Nécessite Claude Code v2.1.234 ou version ultérieure |366| `CLAUDE_CODE_PROCESS_WRAPPER` | Lance les processus que Claude Code démarre à partir de son propre binaire, comme le service en arrière-plan qui héberge les sessions de la [vue des agents](/docs/fr/agent-view), via un lanceur d'entreprise indiqué sous forme de préfixe argv, par exemple `/opt/corp/launcher`. Définissez-la dans le bloc `env` des paramètres utilisateur ou des [paramètres gérés](/docs/fr/managed-settings), et non comme un export du shell, afin que le service en arrière-plan détaché en hérite ; les paramètres de projet et locaux ne peuvent pas la définir. Équivaut au [paramètre `processWrapper`](/docs/fr/settings-reference#processwrapper), qui nécessite Claude Code v2.1.210 ou ultérieur ; cette variable a priorité lorsque les deux sont définis. L'extension VS Code configure son propre lanceur séparément via son paramètre `claudeProcessWrapper`. Ignorée sous Windows. Voir [Exécuter Claude Code derrière un lanceur d'entreprise](/docs/fr/corporate-launcher) pour le format de la valeur, ce que couvre le lanceur et le contrat qu'il doit respecter. Nécessite Claude Code v2.1.208 ou ultérieur |

365| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Définissez `5m` ou `1h`, les seules valeurs acceptées par Claude Code, pour choisir le [TTL du cache de prompt](/docs/fr/prompt-caching#cache-lifetime) de la conversation principale : vos tours interactifs, `-p` et SDK, ainsi que les assistants qui s'exécutent en ligne avec eux. A priorité sur le paramètre `promptCacheTtl` et sur `ENABLE_PROMPT_CACHING_1H`, tandis que `FORCE_PROMPT_CACHING_5M` l'emporte sur elle. L'API facture les écritures en cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou version ultérieure |367| `CLAUDE_CODE_PROJECT_DIR_NAME` | À définir avec `CLAUDE_CONFIG_DIR` pour choisir le nom du répertoire `projects/` sous lequel Claude Code stocke les transcriptions et la mémoire automatique de cette session, à la place d'un nom dérivé du chemin du répertoire de travail. Par exemple, démarrer Claude Code avec `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` les stocke sous `/srv/tenant-a/projects/work/`. Claude Code ignore cette variable lorsque `CLAUDE_CONFIG_DIR` n'est pas définie, et ne la lit que dans l'environnement depuis lequel vous démarrez `claude`, jamais depuis un [bloc `env` d'un fichier de paramètres](#in-settings-files). Voir [Nommer vous-même le répertoire du projet](/docs/fr/sessions#name-the-project-directory-yourself). Nécessite Claude Code v2.1.234 ou ultérieur |

366| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Définissez-la sur `1` pour propager le contexte de trace W3C lorsque `ANTHROPIC_BASE_URL` pointe vers un proxy personnalisé. La propagation couvre l'en-tête `traceparent` des requêtes au modèle et des requêtes MCP HTTP, ainsi que la variable d'environnement `TRACEPARENT` pour les sous-processus Bash, PowerShell et des hooks. Par défaut, la propagation n'est activée qu'en cas de connexion directe à l'API Anthropic. Ajoutée dans la v2.1.152. Consultez [Traces (bêta)](/docs/fr/monitoring-usage#traces-beta) |368| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Définissez `5m` ou `1h`, les seules valeurs acceptées par Claude Code, pour choisir le [TTL du cache de prompt](/docs/fr/prompt-caching#cache-lifetime) de la conversation principale : vos tours interactifs, `-p` et SDK, ainsi que les assistants qui s'exécutent en ligne avec eux. A priorité sur le paramètre `promptCacheTtl` et sur `ENABLE_PROMPT_CACHING_1H`, et `FORCE_PROMPT_CACHING_5M` la remplace. L'API facture les écritures en cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur |

367| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Définie par les plateformes hôtes qui intègrent Claude Code et gèrent pour lui le routage vers le fournisseur de modèles. Lorsqu'elle est définie, Claude Code ignore les variables de sélection du fournisseur, d'endpoint et d'authentification, comme `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY`, dans les fichiers de paramètres, afin que les paramètres utilisateur ne puissent pas remplacer le routage de l'hôte. Claude Code ignore également les clés de sélection de modèle, comme `model`, `fallbackModel` et `modelOverrides`, dans les [paramètres gérés](/docs/fr/managed-settings), quelle que soit la source gérée qui les fournit, afin que la configuration de modèles de l'hôte ait priorité sur un modèle géré épinglé devenu obsolète. Claude Code ignore aussi les variables de sélection de modèle, comme `ANTHROPIC_MODEL` et la famille `ANTHROPIC_DEFAULT_*_MODEL`, dans un bloc `env` géré ; une liste d'autorisation [`availableModels`](/docs/fr/model-config#restrict-model-selection) définie dans les paramètres gérés continue de s'appliquer, sauf si l'hôte fournit la sienne. Enfin, Claude Code n'applique pas la désactivation automatique de la télémétrie qu'il applique sinon sur les fournisseurs tiers comme Amazon Bedrock, Claude Platform on AWS, Agent Platform de Google Cloud et Microsoft Foundry : la télémétrie suit donc la désactivation standard via `DISABLE_TELEMETRY`. Consultez [Comportements par défaut selon le fournisseur d'API](/docs/fr/data-usage#default-behaviors-by-api-provider) |369| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Définissez sur `1` pour propager le contexte de trace W3C lorsque `ANTHROPIC_BASE_URL` pointe vers un proxy personnalisé. La propagation couvre l'en-tête `traceparent` sur les requêtes vers le modèle et vers les serveurs MCP HTTP, ainsi que la variable d'environnement `TRACEPARENT` pour les sous-processus Bash, PowerShell et de hooks. Par défaut, la propagation n'est activée qu'en cas de connexion directe à l'API Anthropic. Ajoutée dans la v2.1.152. Voir [Traces (bêta)](/docs/fr/monitoring-usage#traces-beta) |

368| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Définissez-la sur `1` pour permettre au proxy d'effectuer la résolution DNS à la place de l'appelant. Option à activer dans les environnements où le proxy doit gérer la résolution des noms d'hôte |370| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Définie par les plateformes hôtes qui intègrent Claude Code et gèrent le routage vers le fournisseur de modèles pour son compte. Lorsqu'elle est définie, Claude Code ignore les variables de sélection du fournisseur, d'endpoint et d'authentification telles que `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY` dans les fichiers de paramètres, afin que les paramètres utilisateur ne puissent pas remplacer le routage de l'hôte. Claude Code ignore également les clés de sélection de modèle telles que `model`, `fallbackModel` et `modelOverrides` dans les [paramètres gérés](/docs/fr/managed-settings), quelle que soit la source gérée qui les fournit, afin que la configuration de modèle de l'hôte l'emporte sur un épinglage de modèle géré obsolète. Claude Code ignore aussi les variables de sélection de modèle telles que `ANTHROPIC_MODEL` et la famille `ANTHROPIC_DEFAULT_*_MODEL` dans un bloc `env` géré ; une liste d'autorisation [`availableModels`](/docs/fr/model-config#restrict-model-selection) dans les paramètres gérés s'applique toujours, sauf si l'hôte fournit la sienne. Claude Code ignore en outre la désactivation automatique de la télémétrie qu'il applique sinon sur les fournisseurs tiers tels qu'Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform et Microsoft Foundry, de sorte que la télémétrie suit la désactivation standard `DISABLE_TELEMETRY`. Voir [Comportements par défaut selon le fournisseur d'API](/docs/fr/data-usage#default-behaviors-by-api-provider) |

371| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Définissez sur `1` pour permettre au proxy d'effectuer la résolution DNS à la place de l'appelant. Option à activer pour les environnements où le proxy doit gérer la résolution des noms d'hôte |

369| `CLAUDE_CODE_REMOTE` | Définie automatiquement sur `true` lorsque Claude Code s'exécute en tant que [session cloud](/docs/fr/claude-code-on-the-web). Lisez-la depuis un hook ou un script de configuration pour détecter si vous êtes dans une session cloud |372| `CLAUDE_CODE_REMOTE` | Définie automatiquement sur `true` lorsque Claude Code s'exécute en tant que [session cloud](/docs/fr/claude-code-on-the-web). Lisez-la depuis un hook ou un script de configuration pour détecter si vous êtes dans une session cloud |

370| `CLAUDE_CODE_REMOTE_SESSION_ID` | Définie automatiquement, dans les [sessions cloud](/docs/fr/claude-code-on-the-web), sur l'identifiant de la session en cours. Lisez-la pour construire un lien vers la transcription de la session. Consultez [Relier la sortie à la session](/docs/fr/cloud-environments#link-output-back-to-the-session) |373| `CLAUDE_CODE_REMOTE_SESSION_ID` | Définie automatiquement dans les [sessions cloud](/docs/fr/claude-code-on-the-web) sur l'ID de la session en cours. Lisez-la pour construire un lien vers la transcription de la session. Voir [Relier la sortie à la session](/docs/fr/cloud-environments#link-output-back-to-the-session) |

371| `CLAUDE_CODE_RESTRICTED` | Définissez-la sur `1` pour démarrer la session en mode restreint, comme si vous transmettiez [`--restricted`](/docs/fr/cli-reference#cli-flags). Claude Code ignore cette variable dans le bloc `env` d'un fichier de paramètres. Nécessite Claude Code v2.1.248 ou version ultérieure |374| `CLAUDE_CODE_RESTRICTED` | Définissez sur `1` pour démarrer la session en mode restreint, comme en transmettant [`--restricted`](/docs/fr/cli-reference#cli-flags). Claude Code ignore cette variable dans le bloc `env` d'un fichier de paramètres. Nécessite Claude Code v2.1.248 ou ultérieur |

372| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Définissez-la sur `1` pour reprendre automatiquement si la session précédente s'est terminée au milieu d'un tour. Utilisée en mode SDK pour que le modèle poursuive sans que le SDK ait à renvoyer le prompt. Pour désactiver ce comportement, supprimez la variable ou définissez-la sur `0`. Pour le panneau de chat de VS Code, consultez [Poursuivre les conversations après un rechargement](/docs/fr/vs-code#continue-conversations-after-a-reload) |375| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Définissez sur `1` pour reprendre automatiquement si la session précédente s'est terminée en plein tour. Utilisée en mode SDK afin que le modèle continue sans que le SDK ait à renvoyer le prompt. Pour la désactiver, supprimez la variable ou définissez-la sur `0`. Pour le panneau de chat de VS Code, voir [Poursuivre les conversations après un rechargement](/docs/fr/vs-code#continue-conversations-after-a-reload) |

373| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Âge maximal, en millisecondes, du dernier message de la transcription pour qu'une session terminée au milieu d'un tour se poursuive automatiquement lors de la reprise. Lorsque le dernier message est plus ancien que cette limite, Claude Code n'effectue pas la reprise automatique de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` ni l'envoi de son message de continuation `CLAUDE_CODE_RESUME_PROMPT`, et la session démarre inactive pour que vous repreniez explicitement. Non définie ou `0` signifie aucune limite, sauf qu'un tour dont la dernière requête a échoué avec une erreur d'API ne reprend que tant que cette erreur date de moins de six heures. Une valeur positive limite tous les tours, y compris ceux-ci ; une valeur négative ou non numérique applique une limite d'une heure. Les scripts de lancement d'agents de longue durée peuvent la définir afin qu'un redémarrage sur une ancienne transcription ne réexécute pas un prompt périmé. Claude Code définit lui-même une limite d'une heure lorsqu'il redémarre une session de la [vue des agents](/docs/fr/agent-view) ayant planté qui a hérité sa conversation d'une session interactive. Nécessite Claude Code v2.1.211 ou version ultérieure |376| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Ancienneté maximale en millisecondes du dernier message de la transcription pour qu'une session terminée en plein tour continue automatiquement à la reprise. Lorsque le dernier message est plus ancien que cette limite, Claude Code ignore la reprise automatique `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` et son message de continuation `CLAUDE_CODE_RESUME_PROMPT`, et la session démarre inactive afin que vous continuiez explicitement. Une valeur non définie ou `0` signifie aucune limite, sauf qu'un tour dont la dernière requête a échoué avec une erreur d'API ne reprend que tant que cette erreur date de moins de six heures. Une valeur positive limite chaque tour, y compris ceux-là ; une valeur négative ou non numérique applique une limite d'une heure. Les scripts de lancement d'agents de longue durée peuvent la définir afin qu'un redémarrage sur une ancienne transcription ne réexécute pas un prompt obsolète. Claude Code définit lui-même une limite d'une heure lorsqu'il redémarre une session de la [vue des agents](/docs/fr/agent-view) ayant planté et qui avait hérité sa conversation d'une session interactive. Nécessite Claude Code v2.1.211 ou ultérieur |

374| `CLAUDE_CODE_RESUME_PROMPT` | Remplace le message de continuation que Claude Code envoie à Claude lorsque `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` poursuit un tour interrompu au lieu de renvoyer son prompt, ou lorsque vous reprenez un [appel d'outil différé](/docs/fr/hooks#defer-a-tool-call-for-later) avec `-p`. Par défaut `Continue from where you left off.`. Une chaîne vide utilise la valeur par défaut |377| `CLAUDE_CODE_RESUME_PROMPT` | Remplace le message de continuation que Claude Code envoie à Claude lorsque `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` poursuit un tour interrompu au lieu de renvoyer son prompt, ou lorsque vous reprenez un [appel d'outil différé](/docs/fr/hooks#defer-a-tool-call-for-later) avec `-p`. Valeur par défaut : `Continue from where you left off.`. Une chaîne vide utilise la valeur par défaut |

375| `CLAUDE_CODE_RETRY_WATCHDOG` | Définissez-la sur `1` pour les sessions sans surveillance, comme les harnais d'évaluation, les jobs CI ou les workers distants. Réessaie indéfiniment en cas d'erreurs de capacité `429` et `529` au lieu d'échouer après `CLAUDE_CODE_MAX_RETRIES` tentatives. Claude Code échoue immédiatement lorsqu'une requête à vitesse standard reçoit une erreur `429` signalant une limite de dépenses ou des crédits d'utilisation épuisés, même si elle provient d'un [plafond de dépenses de la passerelle](/docs/fr/errors#spend-limit-reached) qui se réinitialise selon un calendrier. Avant la v2.1.239, le watchdog réessayait indéfiniment dans ces cas. Pour les requêtes en mode rapide, consultez [Gérer les limites de débit](/docs/fr/fast-mode#handle-rate-limits). Le watchdog espace ses tentatives jusqu'à 5 minutes, ou jusqu'à la réinitialisation de la limite lorsque la réponse indique une heure de réinitialisation de la limite de débit, de sorte qu'une session qui atteint une limite d'utilisation attend la fin de la fenêtre restante. Dans la v2.1.199 ou version ultérieure, il porte également à 300, soit environ trois heures de backoff, le nombre de nouvelles tentatives par défaut pour les autres erreurs transitoires, comme les erreurs serveur, les expirations de délai et les connexions interrompues, et supprime le plafond de 15 sur `CLAUDE_CODE_MAX_RETRIES` si vous définissez explicitement cette variable. Nécessite Claude Code v2.1.186 ou version ultérieure |378| `CLAUDE_CODE_RETRY_WATCHDOG` | Définissez sur `1` pour les sessions sans surveillance telles que les harnais d'évaluation, les jobs CI ou les workers distants. Réessaie indéfiniment les erreurs de capacité `429` et `529` au lieu d'échouer après `CLAUDE_CODE_MAX_RETRIES` tentatives. Claude Code échoue immédiatement lorsqu'une requête à vitesse standard reçoit une erreur `429` signalant une limite de dépenses ou des crédits d'utilisation épuisés, même si elle provient d'un [plafond de dépenses de passerelle](/docs/fr/errors#spend-limit-reached) qui se réinitialise selon un calendrier. Avant la v2.1.239, le watchdog les réessayait indéfiniment. Pour les requêtes en mode rapide, voir [Gérer les limites de débit](/docs/fr/fast-mode#handle-rate-limits). Le watchdog espace les tentatives jusqu'à 5 minutes, ou jusqu'à la réinitialisation de la limite lorsque la réponse indique une heure de réinitialisation de la limite de débit, de sorte qu'une session qui atteint une limite d'utilisation patiente jusqu'à la fin de la fenêtre restante. Dans la v2.1.199 ou ultérieure, elle porte également à 300 le nombre de nouvelles tentatives par défaut pour les autres erreurs transitoires, telles que les erreurs serveur, les délais d'expiration et les connexions interrompues, soit environ trois heures d'attente progressive, et supprime le plafond de 15 sur `CLAUDE_CODE_MAX_RETRIES` si vous définissez explicitement cette variable. Nécessite Claude Code v2.1.186 ou ultérieur |

376| `CLAUDE_CODE_SAFE_MODE` | Définissez-la sur `1` pour démarrer en mode sans échec : CLAUDE.md, les skills, les plugins, les hooks, les serveurs MCP, les commandes et agents personnalisés, les styles de sortie, les workflows, les thèmes personnalisés, les raccourcis clavier personnalisés, les commandes de barre de statut et de suggestion de fichiers, les serveurs LSP et la mémoire automatique ne sont pas chargés, afin de dépanner une configuration défaillante. La politique des paramètres gérés s'applique toujours, y compris les hooks, la barre de statut et les commandes de suggestion de fichiers configurés par politique ; ce n'est pas le cas des plugins gérés, des skills gérés, du CLAUDE.md géré ni des serveurs MCP configurés par politique. Équivaut à transmettre [`--safe-mode`](/docs/fr/cli-reference#cli-flags). Les processus enfants lancés directement héritent de la variable |379| `CLAUDE_CODE_SAFE_MODE` | Définissez sur `1` pour démarrer en mode sans échec : CLAUDE.md, les skills, les plugins, les hooks, les serveurs MCP, les commandes et agents personnalisés, les styles de sortie, les workflows, les thèmes personnalisés, les raccourcis clavier personnalisés, les commandes de barre de statut et de suggestion de fichiers, les serveurs LSP et la mémoire automatique ne sont pas chargés, afin de dépanner une configuration défectueuse. La politique des paramètres gérés s'applique toujours, y compris les hooks, la barre de statut et les commandes de suggestion de fichiers configurés par la politique ; les plugins gérés, les skills gérés, le CLAUDE.md géré et les serveurs MCP configurés par la politique ne s'appliquent pas. Équivaut à transmettre [`--safe-mode`](/docs/fr/cli-reference#cli-flags). Les processus enfants lancés directement héritent de la variable |

377| `CLAUDE_CODE_SCRIPT_CAPS` | Objet JSON limitant le nombre de fois où certains scripts peuvent être invoqués par session lorsque `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` est défini. Les clés sont des sous-chaînes comparées au texte de la commande ; les valeurs sont des limites d'appels entières. Par exemple, `{"deploy.sh": 2}` permet d'appeler `deploy.sh` au plus deux fois. La correspondance se fait par sous-chaîne, de sorte que les astuces d'expansion du shell comme `./scripts/deploy.sh $(evil)` sont quand même décomptées du plafond. La démultiplication à l'exécution via `xargs` ou `find -exec` n'est pas détectée ; il s'agit d'un contrôle de défense en profondeur |380| `CLAUDE_CODE_SCRIPT_CAPS` | Objet JSON limitant le nombre de fois où des scripts spécifiques peuvent être invoqués par session lorsque `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` est définie. Les clés sont des sous-chaînes comparées au texte de la commande ; les valeurs sont des limites d'appels entières. Par exemple, `{"deploy.sh": 2}` permet d'appeler `deploy.sh` au maximum deux fois. La correspondance se fait par sous-chaîne, de sorte que les astuces d'expansion du shell comme `./scripts/deploy.sh $(evil)` sont tout de même décomptées du plafond. La multiplication à l'exécution via `xargs` ou `find -exec` n'est pas détectée ; il s'agit d'un contrôle de défense en profondeur |

378| `CLAUDE_CODE_SCROLL_SPEED` | Définit le multiplicateur de défilement de la molette de la souris dans le [rendu plein écran](/docs/fr/fullscreen#mouse-wheel-scrolling). Accepte toute valeur positive jusqu'à 20, y compris des valeurs fractionnaires inférieures à 1, comme `0.5`, pour ralentir le défilement accéléré du trackpad et de la molette dans les terminaux qui amplifient déjà les événements de molette. Définissez-la sur `3` pour reproduire le comportement de `vim` si votre terminal envoie un événement de molette par cran sans amplification. Ignorée dans le terminal des IDE JetBrains, où Claude Code utilise sa propre gestion du défilement |381| `CLAUDE_CODE_SCROLL_SPEED` | Définit le multiplicateur de défilement de la molette de la souris en [rendu plein écran](/docs/fr/fullscreen#mouse-wheel-scrolling). Accepte toute valeur positive jusqu'à 20, y compris des valeurs fractionnaires inférieures à 1 comme `0.5` pour ralentir le défilement accéléré du trackpad et de la molette dans les terminaux qui amplifient déjà les événements de molette. Définissez sur `3` pour correspondre à `vim` si votre terminal envoie un événement de molette par cran sans amplification. Ignorée dans le terminal des IDE JetBrains, où Claude Code utilise sa propre gestion du défilement |

379| `CLAUDE_CODE_SEND_FEEDBACK` | Définissez-la sur `0` pour désactiver le [feedback rédigé par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior) pour une session. Définissez-la sur `1` pour l'activer lorsque votre compte y a déjà accès ; la variable ne peut pas accorder l'accès à elle seule, et les autres commutateurs qui désactivent le feedback, comme `DISABLE_FEEDBACK_COMMAND` et la valeur `off` du paramètre [`feedbackDrafts`](/docs/fr/settings-reference#feedbackdrafts), continuent de s'appliquer |382| `CLAUDE_CODE_SEND_FEEDBACK` | Définissez sur `0` pour désactiver les [retours rédigés par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior) pour une session. Définissez sur `1` pour les activer lorsque votre compte y a déjà accès ; la variable ne peut pas accorder l'accès elle-même, et les autres interrupteurs qui désactivent les retours, comme `DISABLE_FEEDBACK_COMMAND` et la valeur `off` du paramètre [`feedbackDrafts`](/docs/fr/settings-reference#feedbackdrafts), s'appliquent toujours |

380| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Remplace le budget de temps, en millisecondes, des hooks [SessionEnd](/docs/fr/hooks#sessionend). La valeur sert également de délai d'expiration pour chaque hook qui ne définit pas son propre `timeout`. S'applique à la sortie de session, à `/clear` et au changement de session via `/resume` en mode interactif. Par défaut, le budget est de 1,5 seconde, automatiquement porté au `timeout` par hook le plus élevé configuré dans les fichiers de paramètres, dans la limite de 60 secondes. Les délais d'expiration des hooks fournis par des plugins n'augmentent pas le budget |383| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Remplace le budget de temps en millisecondes des hooks [SessionEnd](/docs/fr/hooks#sessionend). La valeur sert également de délai d'expiration pour chaque hook qui ne définit pas son propre `timeout`. S'applique à la sortie de session, à `/clear` et au changement de session via `/resume` en mode interactif. Par défaut, le budget est de 1,5 seconde, automatiquement porté au `timeout` par hook le plus élevé configuré dans les fichiers de paramètres, jusqu'à 60 secondes. Les délais d'expiration des hooks fournis par des plugins n'augmentent pas le budget |

381| `CLAUDE_CODE_SESSION_ID` | Définie automatiquement sur l'identifiant de la session en cours dans les sous-processus des outils Bash et PowerShell, dans ceux des [commandes de hook](/docs/fr/hooks) et dans ceux des [serveurs MCP](/docs/fr/mcp) stdio. Pour Bash, PowerShell et les hooks, elle correspond au champ `session_id` de l'entrée JSON du hook et est mise à jour lors de `/clear`. Un sous-processus de serveur MCP conserve l'identifiant avec lequel il a été lancé. Avec `--resume <session-id>`, il reçoit l'identifiant de la session reprise, comme les hooks et Bash. Avec `--continue` ou `--resume` sans identifiant explicite, il peut recevoir à la place l'identifiant initial du démarrage. À utiliser pour corréler les scripts et les outils externes avec la session Claude Code qui les a lancés |384| `CLAUDE_CODE_SESSION_ID` | Définie automatiquement sur l'ID de la session en cours dans les sous-processus des outils Bash et PowerShell, les sous-processus des [commandes de hook](/docs/fr/hooks) et les sous-processus des [serveurs MCP](/docs/fr/mcp) stdio. Pour Bash, PowerShell et les hooks, elle correspond au champ `session_id` de l'entrée JSON du hook et est mise à jour lors de `/clear`. Un sous-processus de serveur MCP conserve l'ID avec lequel il a été lancé. Avec `--resume <session-id>`, il reçoit l'ID de la session reprise, comme les hooks et Bash. Avec `--continue` ou `--resume` sans ID explicite, il peut recevoir à la place l'ID initial du démarrage. Utilisez-la pour corréler les scripts et les outils externes avec la session Claude Code qui les a lancés |

382| `CLAUDE_CODE_SHELL` | Définit le shell que Claude Code utilise pour exécuter les commandes de l'outil Bash. Accepte un chemin vers un binaire `bash` ou `zsh`, par exemple `/opt/homebrew/bin/bash`. Les autres shells, comme `fish`, ne sont pas pris en charge. Si la valeur n'est pas un chemin `bash` ou `zsh` fonctionnel, Claude Code l'ignore et se rabat sur la détection automatique. La détection automatique utilise votre `$SHELL` lorsqu'il pointe vers `bash` ou `zsh` ; sinon, elle choisit le premier `zsh`, puis `bash`, fonctionnel trouvé dans votre `PATH` et dans les emplacements d'installation standard |385| `CLAUDE_CODE_SHELL` | Définit le shell que Claude Code utilise pour exécuter les commandes de l'outil Bash. Accepte un chemin vers un binaire `bash` ou `zsh`, par exemple `/opt/homebrew/bin/bash`. Les autres shells comme `fish` ne sont pas pris en charge. Si la valeur n'est pas un chemin `bash` ou `zsh` fonctionnel, Claude Code l'ignore et se rabat sur la détection automatique. La détection automatique utilise votre `$SHELL` lorsqu'il pointe vers `bash` ou `zsh`, sinon elle choisit le premier `zsh` puis `bash` fonctionnel trouvé dans votre `PATH` et dans les emplacements d'installation standard |

383| `CLAUDE_CODE_SHELL_PREFIX` | Préfixe de commande qui enveloppe les commandes shell lancées par Claude Code : appels de l'outil Bash, commandes de [hook](/docs/fr/hooks), commandes de [barre de statut](/docs/fr/statusline) et commandes de démarrage des [serveurs MCP](/docs/fr/mcp) stdio. Les hooks PowerShell et les hooks de forme exec s'exécutent sans le préfixe. Utile pour la journalisation ou l'audit. Définir un simple chemin d'exécutable comme `/path/to/logger.sh` exécute chaque commande sous la forme `/path/to/logger.sh '<command>'`. Le wrapper reçoit la ligne de commande sous la forme d'un unique argument entre guillemets shell dans `$1` : il doit donc réévaluer `$1` avec un shell, par exemple `exec bash -c "$1"`. Traiter `$1` comme un simple chemin d'exécutable casse les serveurs MCP stdio qui transmettent des arguments, comme `npx -y <package>`. Pour les appels de l'outil Bash, `$1` contient l'invocation shell complète assemblée par Claude Code, y compris la configuration de l'environnement, et pas seulement la commande exécutée par Claude |386| `CLAUDE_CODE_SHELL_PREFIX` | Préfixe de commande qui encapsule les commandes shell lancées par Claude Code : appels de l'outil Bash, commandes de [hooks](/docs/fr/hooks), commandes de [barre de statut](/docs/fr/statusline) et commandes de démarrage des [serveurs MCP](/docs/fr/mcp) stdio. Les hooks PowerShell et les hooks en forme exec s'exécutent sans le préfixe. Utile pour la journalisation ou l'audit. Définir un simple chemin d'exécutable comme `/path/to/logger.sh` exécute chaque commande sous la forme `/path/to/logger.sh '<command>'`. L'encapsuleur reçoit la ligne de commande sous la forme d'un argument unique entre guillemets shell dans `$1`, il doit donc réévaluer `$1` avec un shell, par exemple `exec bash -c "$1"`. Traiter `$1` comme un simple chemin d'exécutable casse les serveurs MCP stdio qui transmettent des arguments comme `npx -y <package>`. Pour les appels de l'outil Bash, `$1` contient l'invocation shell complète assemblée par Claude Code, y compris la configuration de l'environnement, et pas seulement la commande exécutée par Claude |

384| `CLAUDE_CODE_SIMPLE` | Définissez-la sur `1` pour fonctionner avec un prompt système minimal et uniquement les outils Bash, de lecture de fichiers et de modification de fichiers. Les outils MCP issus de `--mcp-config` restent disponibles. Désactive la découverte automatique des hooks, des skills, des commandes personnalisées, des sous-agents, des plugins installés, des serveurs MCP, de la mémoire automatique et de CLAUDE.md. Les skills d'un répertoire que vous transmettez avec `--add-dir` sont toujours chargés. Les jetons OAuth et les identifiants du trousseau ne sont pas lus : l'authentification Anthropic doit donc provenir de `ANTHROPIC_API_KEY` ou d'un `apiKeyHelper` dans `--settings`. Équivaut à transmettre [`--bare`](/docs/fr/headless#start-faster-with-bare-mode) |387| `CLAUDE_CODE_SIMPLE` | Définissez sur `1` pour s'exécuter avec un prompt système minimal et uniquement les outils Bash, de lecture de fichiers et de modification de fichiers. Les outils MCP issus de `--mcp-config` restent disponibles. Désactive la découverte automatique des hooks, des skills, des commandes personnalisées, des sous-agents, des plugins installés, des serveurs MCP, de la mémoire automatique et de CLAUDE.md. Les skills d'un répertoire que vous transmettez avec `--add-dir` sont toujours chargés. Les jetons OAuth et les identifiants du trousseau ne sont pas lus, de sorte que l'authentification Anthropic doit provenir de `ANTHROPIC_API_KEY` ou d'un `apiKeyHelper` dans `--settings`. Équivaut à transmettre [`--bare`](/docs/fr/headless#start-faster-with-bare-mode) |

385| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Définissez-la sur `1` pour utiliser un prompt système plus court et des descriptions d'outils abrégées, quel que soit le modèle. Définissez-la sur `0`, `false`, `no` ou `off` pour refuser ce comportement, même sur les modèles où l'expérimentation ou la configuration serveur l'activerait autrement. L'ensemble complet des outils, les hooks, les serveurs MCP et la découverte de CLAUDE.md restent activés |388| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Définissez sur `1` pour utiliser un prompt système plus court et des descriptions d'outils abrégées sur n'importe quel modèle. Définissez sur `0`, `false`, `no` ou `off` pour le refuser, même sur les modèles où l'expérimentation ou la configuration du serveur l'activerait autrement. L'ensemble complet des outils, les hooks, les serveurs MCP et la découverte de CLAUDE.md restent activés |

386| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Ignore l'authentification côté client pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), pour les passerelles qui signent elles-mêmes les requêtes |389| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Ignore l'authentification côté client pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), pour les passerelles qui signent elles-mêmes les requêtes |

387| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Définissez-la sur `1` pour désactiver le cache en mémoire du processus des identifiants résolus à partir de la chaîne de fournisseurs d'identifiants AWS par défaut, afin que Claude Code résolve la chaîne à chaque requête API. Lorsque le cache est désactivé, un profil reposant sur SSO demande des identifiants à IAM Identity Center à chaque requête. Consultez [mise en cache des identifiants et délai d'expiration de la résolution](/docs/fr/amazon-bedrock#credential-caching-and-resolution-timeout). Nécessite Claude Code v2.1.207 ou version ultérieure |390| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Définissez sur `1` pour désactiver le cache en processus des identifiants résolus à partir de la chaîne de fournisseurs d'identifiants AWS par défaut, afin que Claude Code résolve la chaîne à chaque requête API. Avec le cache désactivé, un profil reposant sur SSO demande des identifiants à IAM Identity Center à chaque requête. Voir [mise en cache des identifiants et délai d'expiration de la résolution](/docs/fr/amazon-bedrock#credential-caching-and-resolution-timeout). Nécessite Claude Code v2.1.207 ou ultérieur |

388| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Ignore l'authentification AWS pour Amazon Bedrock (par exemple, lors de l'utilisation d'une passerelle LLM) |391| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Ignore l'authentification AWS pour Amazon Bedrock (par exemple, lors de l'utilisation d'une passerelle LLM) |

389| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Définissez-la sur `1` pour considérer comme disponible le [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) lorsque sa vérification de disponibilité échoue, pour les réseaux qui bloquent la requête directe de cette vérification vers `api.anthropic.com`. Claude Code respecte toujours une réponse « disabled by your organization » |392| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Définissez sur `1` pour considérer comme disponible une vérification de disponibilité du [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) ayant échoué, pour les réseaux qui bloquent la requête directe de la vérification vers `api.anthropic.com`. Claude Code respecte toujours une réponse « désactivé par votre organisation » |

390| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Définissez-la sur `1` pour ignorer la vérification côté client de la disponibilité du [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways), pour les proxys qui interceptent la requête de vérification au lieu de la refuser. L'API rejette toujours les requêtes en mode rapide lorsque votre organisation a désactivé le mode rapide |393| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Définissez sur `1` pour ignorer la vérification de disponibilité du [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) côté client, pour les proxys qui interceptent la requête de vérification plutôt que de la refuser. L'API rejette toujours les requêtes en mode rapide lorsque votre organisation a désactivé le mode rapide |

391| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Ignore l'authentification Azure pour Microsoft Foundry, pour un proxy ou une passerelle qui injecte son propre en-tête `Authorization`. Claude Code envoie les requêtes sans identifiants Azure et conserve l'en-tête `Authorization` que vous fournissez, par exemple via `ANTHROPIC_CUSTOM_HEADERS`. Ignorée lorsque `ANTHROPIC_FOUNDRY_API_KEY` ou `ANTHROPIC_FOUNDRY_AUTH_TOKEN` est défini. Avant la v2.1.203, cette variable empêchait le client Microsoft Foundry d'envoyer des requêtes, à moins qu'une clé API ne soit également définie |394| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Ignore l'authentification Azure pour Microsoft Foundry, pour un proxy ou une passerelle qui injecte son propre en-tête `Authorization`. Claude Code envoie les requêtes sans identifiants Azure et conserve l'en-tête `Authorization` que vous fournissez, par exemple via `ANTHROPIC_CUSTOM_HEADERS`. Ignorée lorsque `ANTHROPIC_FOUNDRY_API_KEY` ou `ANTHROPIC_FOUNDRY_AUTH_TOKEN` est définie. Avant la v2.1.203, cette variable empêchait le client Microsoft Foundry d'envoyer des requêtes à moins qu'une clé API soit également définie |

392| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Ignore l'authentification AWS pour Amazon Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM) |395| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Ignore l'authentification AWS pour Amazon Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM) |

393| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | Les [vérifications de modèles au démarrage](/docs/fr/amazon-bedrock#startup-model-checks) sur [Amazon Bedrock](/docs/fr/amazon-bedrock) et [Agent Platform de Google Cloud](/docs/fr/google-vertex-ai) mémorisent sur cette machine, pendant une journée au maximum, les modèles que votre compte ne peut pas invoquer. Définissez-la sur `1` pour désactiver cette mémorisation. Nécessite Claude Code v2.1.285 ou version ultérieure |396| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | Les [vérifications de modèles au démarrage](/docs/fr/amazon-bedrock#startup-model-checks) sur [Amazon Bedrock](/docs/fr/amazon-bedrock) et [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) mémorisent sur cette machine, pendant un jour au maximum, les modèles que votre compte ne peut pas invoquer. Définissez sur `1` pour désactiver cette mémorisation. Nécessite Claude Code v2.1.285 ou ultérieur |

394| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Définissez-la sur `1` pour ne pas écrire l'historique des prompts ni les transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n'apparaissent ni dans `--resume`, ni dans `--continue`, ni dans l'historique accessible avec la flèche haut. Utile pour les sessions scriptées éphémères |397| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Définissez sur `1` pour ne pas écrire l'historique des prompts et les transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n'apparaissent pas dans `--resume`, `--continue` ni dans l'historique accessible avec la flèche vers le haut. Utile pour les sessions scriptées éphémères |

395| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Ignore l'authentification Google pour Agent Platform de Google Cloud (par exemple, lors de l'utilisation d'une passerelle LLM) |398| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Ignore l'authentification Google pour Google Cloud's Agent Platform (par exemple, lors de l'utilisation d'une passerelle LLM) |

396| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Définissez-la sur `1` pour qu'une session démarrée avec `--output-format stream-json` écrive un [message de résultat indiquant pourquoi Claude Code a refusé de démarrer](/docs/fr/agent-sdk/typescript#startup_failure_reason) pour les échecs de démarrage qui, sinon, ne laissent qu'une trace sur stderr. Nécessite Claude Code v2.1.274 ou version ultérieure |399| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Définissez sur `1` pour qu'une session démarrée avec `--output-format stream-json` écrive un [message de résultat indiquant pourquoi Claude Code a refusé de démarrer](/docs/fr/agent-sdk/typescript#startup_failure_reason) pour les échecs de démarrage qui se terminent sinon uniquement par stderr. Nécessite Claude Code v2.1.274 ou ultérieur |

397| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Nombre maximal de fois consécutives où un hook [Stop](/docs/fr/hooks#stop) ou [SubagentStop](/docs/fr/hooks#subagentstop) peut empêcher la fin du tour avant que Claude Code ne passe outre et termine quand même le tour (par défaut : 8). Définissez-la sur `0` pour désactiver le plafond. Augmentez cette valeur si votre hook a légitimement besoin de plus d'itérations pour aboutir |400| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Nombre maximal de fois consécutives où un hook [Stop](/docs/fr/hooks#stop) ou [SubagentStop](/docs/fr/hooks#subagentstop) peut empêcher la fin du tour avant que Claude Code passe outre et termine quand même le tour (par défaut : 8). Définissez sur `0` pour désactiver le plafond. Augmentez cette valeur si votre hook a légitimement besoin de plus d'itérations pour aboutir |

398| `CLAUDE_CODE_SUBAGENT_MODEL` | Modèle par défaut des [sous-agents](/docs/fr/sub-agents#choose-a-model), des coéquipiers des [équipes d'agents](/docs/fr/agent-teams#specify-teammates-and-models) et des agents de [workflow](/docs/fr/workflows) auxquels aucun modèle n'est attribué d'une autre manière. Accepte un alias comme `haiku` ou un nom de modèle complet. Deux sources ont priorité sur elle : un modèle que Claude transmet lorsqu'il lance l'agent, et un champ `model` dans la définition de l'agent, y compris `inherit`. Pour changer cela, définissez [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/fr/sub-agents#run-every-subagent-on-one-model). Consultez [Choisir un modèle](/docs/fr/sub-agents#choose-a-model) pour l'ordre complet. La définir sur `inherit` revient à ne pas la définir. Avant la v2.1.251, cette variable remplaçait à la fois le modèle indiqué pour chaque invocation et le champ `model` de la définition |401| `CLAUDE_CODE_SUBAGENT_MODEL` | Modèle par défaut des [sous-agents](/docs/fr/sub-agents#choose-a-model), des coéquipiers d'une [équipe d'agents](/docs/fr/agent-teams#specify-teammates-and-models) et des agents de [workflow](/docs/fr/workflows) auxquels aucun modèle n'est attribué d'une autre manière. Accepte un alias comme `haiku` ou un nom de modèle complet. Deux sources ont priorité sur elle : un modèle que Claude transmet lorsqu'il lance l'agent, et un champ `model` dans la définition de l'agent, y compris `inherit`. Pour changer cela, définissez [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/fr/sub-agents#run-every-subagent-on-one-model). Voir [Choisir un modèle](/docs/fr/sub-agents#choose-a-model) pour l'ordre complet. La définir sur `inherit` revient à la laisser non définie. Avant la v2.1.251, cette variable remplaçait à la fois le modèle par invocation et le champ `model` de la définition |

399| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Définissez-la sur `1` pour imposer un seul modèle aux sous-agents, aux coéquipiers et aux agents de workflow. [Exécuter tous les sous-agents sur un seul modèle](/docs/fr/sub-agents#run-every-subagent-on-one-model) indique de quel modèle il s'agit. Nécessite Claude Code v2.1.257 ou version ultérieure |402| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Définissez sur `1` pour imposer un modèle unique aux sous-agents, aux coéquipiers et aux agents de workflow. [Exécuter tous les sous-agents sur un seul modèle](/docs/fr/sub-agents#run-every-subagent-on-one-model) indique de quel modèle il s'agit. Nécessite Claude Code v2.1.257 ou ultérieur |

400| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Définissez `5m` ou `1h`, les seules valeurs acceptées par Claude Code, pour choisir le [TTL du cache de prompt](/docs/fr/prompt-caching#cache-lifetime) des requêtes effectuées en dehors de la conversation principale, comme celles des [sous-agents](/docs/fr/sub-agents), des workflows et du travail en arrière-plan. A priorité sur le paramètre `subagentPromptCacheTtl` et sur `ENABLE_PROMPT_CACHING_1H`, tandis que `FORCE_PROMPT_CACHING_5M` l'emporte sur elle. L'API facture les écritures en cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou version ultérieure |403| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Définissez `5m` ou `1h`, les seules valeurs acceptées par Claude Code, pour choisir le [TTL du cache de prompt](/docs/fr/prompt-caching#cache-lifetime) des requêtes en dehors de la conversation principale, comme les [sous-agents](/docs/fr/sub-agents), les workflows et le travail en arrière-plan. A priorité sur le paramètre `subagentPromptCacheTtl` et sur `ENABLE_PROMPT_CACHING_1H`, et `FORCE_PROMPT_CACHING_5M` la remplace. L'API facture les écritures en cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur |

401| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Définissez-la sur `1` pour retirer les identifiants des environnements des sous-processus que Claude Code démarre, comme les commandes Bash, les hooks et les serveurs MCP stdio. Le nettoyage reconnaît les identifiants d'après le nom ou la valeur de leur variable, et laisse en place les jetons GitHub et les paramètres de proxy. Consultez [Ce que supprime le nettoyage de l'environnement des sous-processus](#what-the-subprocess-environment-scrub-removes). `claude-code-action` la définit automatiquement lorsque `allowed_non_write_users` est configuré |404| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Définissez sur `1` pour retirer les identifiants des environnements des sous-processus que Claude Code démarre, tels que les commandes Bash, les hooks et les serveurs MCP stdio. Le nettoyage reconnaît un identifiant secret par le nom de sa variable ou par sa valeur, et laisse en place les jetons GitHub et les paramètres de proxy. Voir [Ce que supprime le nettoyage de l'environnement des sous-processus](#what-the-subprocess-environment-scrub-removes). `claude-code-action` la définit automatiquement lorsque `allowed_non_write_users` est configuré |

402| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Définissez-la sur `1` en mode non interactif (le flag `-p`) pour attendre la fin de l'installation des plugins avant la première requête. Sans elle, les plugins s'installent en arrière-plan et peuvent ne pas être disponibles au premier tour. Combinez-la avec `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` pour borner l'attente |405| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Définissez sur `1` en mode non interactif (le flag `-p`) pour attendre la fin de l'installation des plugins avant la première requête. Sans cela, les plugins s'installent en arrière-plan et peuvent ne pas être disponibles au premier tour. Combinez-la avec `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` pour borner l'attente |

403| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Délai d'expiration en millisecondes pour l'installation synchrone des plugins. En cas de dépassement, Claude Code continue sans les plugins et journalise une erreur. Aucune valeur par défaut : sans cette variable, l'installation synchrone attend jusqu'à son achèvement |406| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Délai d'expiration en millisecondes pour l'installation synchrone des plugins. Lorsqu'il est dépassé, Claude Code continue sans les plugins et journalise une erreur. Aucune valeur par défaut : sans cette variable, l'installation synchrone attend jusqu'à la fin |

404| `CLAUDE_CODE_SYNC_SKILLS` | Définissez-la sur `1` en mode non interactif avec le flag `-p` pour que Claude Code télécharge, lors de cette exécution, les skills activés pour votre compte claude.ai et attende leur liste, jusqu'à `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, avant d'exécuter la première requête. Les téléchargements eux-mêmes se terminent en arrière-plan, et Claude attend le téléchargement d'un skill lorsqu'il invoque ce skill. Nécessite l'authentification claude.ai. Les sessions de terminal dans lesquelles vous êtes connecté avec votre compte claude.ai [téléchargent ces skills](/docs/fr/skills#where-synced-skills-load) dans `~/.claude/skills/synced/` et les resynchronisent environ toutes les 10 minutes sans cette variable ; ne la définissez donc que lorsqu'une exécution `-p` a besoin de vos skills à jour dès sa première requête. Avant la v2.1.273, les sessions de terminal ne les téléchargeaient que lors d'une exécution `-p` avec cette variable définie. Le nom de dossier `synced` est [réservé à ce téléchargement](/docs/fr/skills#where-skills-live). Avant la v2.1.227, les skills étaient téléchargés directement dans `~/.claude/skills/`. Claude Code applique des [règles supplémentaires aux skills téléchargés](/docs/fr/skills#how-synced-skills-behave), comme le fait de ne pas exécuter leurs commandes `!` sur votre machine |407| `CLAUDE_CODE_SYNC_SKILLS` | Définissez-la sur `1` en mode non interactif avec le flag `-p` pour que Claude Code télécharge les skills activés pour votre compte claude.ai lors de cette exécution et attende leur liste, jusqu'à `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, avant d'exécuter la première requête. Nécessite l'authentification claude.ai. Les sessions de terminal où vous vous connectez avec votre compte claude.ai [synchronisent ces skills](/docs/fr/skills#where-synced-skills-load) sans cette variable : ne la définissez donc que lorsqu'une exécution `-p` a besoin de vos skills actuels dès sa première requête |

405| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Délai d'expiration en millisecondes de la resynchronisation des skills exécutée en cours de session lorsqu'une application construite sur l'[Agent SDK](/docs/fr/agent-sdk/typescript#query-object) recharge les skills (par défaut : 30000). En cas de dépassement, le rechargement se poursuit avec les skills déjà arrivés, et les téléchargements restants se terminent en arrière-plan |408| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Délai d'expiration en millisecondes de la resynchronisation des skills qui s'exécute en cours de session lorsqu'une application construite sur l'[Agent SDK](/docs/fr/agent-sdk/typescript#query-object) recharge les skills (par défaut : 30000). Lorsqu'il est dépassé, le rechargement se poursuit avec les skills déjà arrivés, et les téléchargements restants se terminent en arrière-plan |

406| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Délai d'expiration, en millisecondes, pendant lequel la première requête attend la liste initiale des skills lorsque `CLAUDE_CODE_SYNC_SKILLS` est défini (par défaut : 5000). En cas de dépassement, la première requête s'exécute avec les skills déjà arrivés. Les téléchargements se terminent en arrière-plan dans tous les cas, et Claude attend le téléchargement d'un skill lorsqu'il invoque ce skill |409| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Délai d'expiration en millisecondes pendant lequel la première requête attend la liste initiale des skills lorsque `CLAUDE_CODE_SYNC_SKILLS` est définie (par défaut : 5000). Lorsqu'il est dépassé, la première requête s'exécute avec les skills déjà arrivés. Les téléchargements se terminent en arrière-plan dans tous les cas, et Claude attend le téléchargement d'un skill lorsqu'il invoque ce skill |

407| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Définissez-la sur `false` pour désactiver la coloration syntaxique dans l'affichage des diffs. Utile lorsque les couleurs interfèrent avec la configuration de votre terminal. Pour désactiver également la coloration dans les blocs de code et les aperçus de fichiers, utilisez le paramètre [`syntaxHighlightingDisabled`](/docs/fr/settings-reference#syntaxhighlightingdisabled) |410| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Définissez sur `false` pour désactiver la coloration syntaxique dans la sortie des diffs. Utile lorsque les couleurs interfèrent avec la configuration de votre terminal. Pour désactiver également la coloration dans les blocs de code et les aperçus de fichiers, utilisez le paramètre [`syntaxHighlightingDisabled`](/docs/fr/settings-reference#syntaxhighlightingdisabled) |

408| `CLAUDE_CODE_TASK_LIST_ID` | Partage une liste de tâches entre plusieurs sessions. Définissez le même identifiant dans plusieurs instances de Claude Code pour qu'elles se coordonnent sur une liste de tâches partagée, dans les [sessions qui disposent des outils Task](/docs/fr/tools-reference#task-tool-availability). Consultez [Liste des tâches](/docs/fr/interactive-mode#task-list) |411| `CLAUDE_CODE_TASK_LIST_ID` | Partage une liste de tâches entre sessions. Définissez le même ID dans plusieurs instances de Claude Code pour vous coordonner sur une liste de tâches partagée, dans les [sessions qui disposent des outils Task](/docs/fr/tools-reference#task-tool-availability). Voir [Liste des tâches](/docs/fr/interactive-mode#task-list) |

409| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Remplace la durée, en millisecondes, pendant laquelle une session non interactive attend à sa fermeture que son [équipe d'agents](/docs/fr/agent-teams) ait fini de se démanteler. Accepte des valeurs de 1000 à 60000 ; une valeur hors plage est ignorée et la valeur par défaut de 10000 s'applique. Nécessite Claude Code v2.1.206 ou version ultérieure |412| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Remplace, en millisecondes, la durée pendant laquelle une session non interactive attend à la sortie que son [équipe d'agents](/docs/fr/agent-teams) ait fini de se démanteler. Accepte des valeurs de 1000 à 60000 ; une valeur hors plage est ignorée et la valeur par défaut de 10000 s'applique. Nécessite Claude Code v2.1.206 ou ultérieur |

410| `CLAUDE_CODE_TMPDIR` | Remplace le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute `/claude-{uid}/` à ce chemin sous Unix, ou `/claude/` sous Windows. Par défaut : `/tmp` sous macOS, `os.tmpdir()` sous Linux et Windows. Sous macOS et Linux, les sous-processus Bash [en sandbox](/docs/fr/sandboxing) reçoivent un `$TMPDIR` de secours court, situé sous l'emplacement système par défaut, lorsque votre valeur de remplacement est un chemin long, car certains outils échouent lorsque les chemins temporaires sont trop longs. Les commandes Bash hors sandbox héritent du `$TMPDIR` de votre shell lorsqu'il est défini. Sous Windows natif, lorsque votre shell ne définit pas `$TMPDIR`, une commande Bash qui fait référence à `$TMPDIR` reçoit votre valeur de remplacement, ou `%TEMP%` si vous n'en avez pas défini. Les fichiers temporaires propres à Claude Code utilisent toujours votre valeur de remplacement. Définissez-la dans votre shell, dans vos paramètres utilisateur ou dans vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |413| `CLAUDE_CODE_TMPDIR` | Remplace le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute `/claude-{uid}/` à ce chemin sous Unix, ou `/claude/` sous Windows. Valeur par défaut : `/tmp` sur macOS, `os.tmpdir()` sur Linux et Windows. Sur macOS et Linux, les sous-processus Bash [en sandbox](/docs/fr/sandboxing) reçoivent un `$TMPDIR` de secours court sous l'emplacement par défaut du système lorsque votre remplacement est un chemin long, car certains outils échouent lorsque les chemins temporaires sont trop longs. Les commandes Bash hors sandbox héritent du `$TMPDIR` de votre shell lorsqu'il est défini. Sous Windows natif, lorsque votre shell ne définit pas `$TMPDIR`, une commande Bash qui fait référence à `$TMPDIR` reçoit votre remplacement, ou `%TEMP%` si vous n'en avez pas défini. Les fichiers temporaires propres à Claude Code utilisent toujours votre remplacement. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |

411| `CLAUDE_CODE_TMUX_TRUECOLOR` | Définissez-la sur n'importe quelle valeur non vide, comme `1`, pour autoriser la sortie truecolor 24 bits dans tmux. **La définir sur `0` ou `false` autorise quand même le truecolor**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour rétablir la limitation à 256 couleurs. Par défaut, Claude Code se limite à 256 couleurs lorsque `$TMUX` est défini, car tmux ne transmet pas les séquences d'échappement truecolor à moins d'être configuré pour le faire. Définissez cette variable après avoir ajouté `set -ga terminal-overrides ',*:Tc'` à votre `~/.tmux.conf`. Consultez [Configuration du terminal](/docs/fr/terminal-config) pour les autres paramètres tmux |414| `CLAUDE_CODE_TMUX_TRUECOLOR` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour autoriser la sortie truecolor 24 bits dans tmux. **La définir sur `0` ou `false` autorise tout de même le truecolor**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour rétablir la limitation à 256 couleurs. Par défaut, Claude Code se limite à 256 couleurs lorsque `$TMUX` est défini, car tmux ne transmet pas les séquences d'échappement truecolor à moins d'être configuré pour le faire. Définissez-la après avoir ajouté `set -ga terminal-overrides ',*:Tc'` à votre `~/.tmux.conf`. Voir [Configuration du terminal](/docs/fr/terminal-config) pour les autres paramètres tmux |

412| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Sous Linux et WSL, définissez-la sur une liste, séparée par des virgules, des types de processus que Claude Code [exclut du plafond de mémoire des outils](/docs/fr/tools-reference#memory-limit-on-linux-and-wsl), comme `mcp` ou `lsp`. Définissez `none` pour plafonner tous les types, ou `all-new` pour ne plafonner que les commandes des outils Bash, PowerShell et Monitor. Claude Code maintient les commandes des outils Bash, PowerShell et Monitor sous le plafond, quoi que vous indiquiez. Nécessite Claude Code v2.1.246 ou version ultérieure |415| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Sur Linux et WSL, définissez une liste, séparée par des virgules, des types de processus que Claude Code [exclut du plafond de mémoire des outils](/docs/fr/tools-reference#memory-limit-on-linux-and-wsl), comme `mcp` ou `lsp`. Définissez `none` pour plafonner tous les types, ou `all-new` pour ne plafonner que les commandes des outils Bash, PowerShell et Monitor. Claude Code maintient les commandes des outils Bash, PowerShell et Monitor sous le plafond, quoi que vous indiquiez. Nécessite Claude Code v2.1.246 ou ultérieur |

413| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Sous Linux et WSL, définissez-la sur une taille comme `4G` pour [plafonner la mémoire que peuvent utiliser les commandes des outils Bash et PowerShell](/docs/fr/tools-reference#memory-limit-on-linux-and-wsl), ainsi que celles de l'outil Monitor dans la v2.1.246 ou version ultérieure. Écrivez la taille en chiffres simples, seule pour un nombre d'octets ou avec un suffixe `K`, `M`, `G` ou `T`. Définissez `0` ou `off` pour désactiver le plafond. Une fois que le premier processus démarré par Claude Code a activé ou désactivé le plafond, toute modification de la valeur prend effet au prochain lancement de `claude`. Nécessite Claude Code v2.1.233 ou version ultérieure |416| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Sur Linux et WSL, définissez une taille comme `4G` pour [plafonner la mémoire que les commandes des outils Bash et PowerShell peuvent utiliser](/docs/fr/tools-reference#memory-limit-on-linux-and-wsl), ainsi que les commandes de l'outil Monitor dans la v2.1.246 ou ultérieure. Écrivez la taille en chiffres simples, seule pour un nombre d'octets ou avec un suffixe `K`, `M`, `G` ou `T`. Définissez `0` ou `off` pour désactiver le plafond. Une fois que le premier processus démarré par Claude Code a activé ou désactivé le plafond, une valeur modifiée prend effet au prochain lancement de `claude`. Nécessite Claude Code v2.1.233 ou ultérieur |

414| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Définissez-la sur `1` pour limiter la taille que peut atteindre le [fichier de transcription](/docs/fr/sessions#where-transcripts-are-stored) d'une longue session `-p` ou Agent SDK. Après chaque compaction, dès que le fichier dépasse 5 Mo, Claude Code supprime l'historique antérieur à cette compaction. La reprise de la session restaure la même conversation, que le fichier ait été réduit ou non. Définissez-la dans l'environnement à partir duquel vous démarrez Claude Code, car un bloc `env` des paramètres ne peut pas l'activer. Nécessite Claude Code v2.1.287 ou version ultérieure |417| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Définissez sur `1` pour limiter la croissance du [fichier de transcription](/docs/fr/sessions#where-transcripts-are-stored) d'une longue session `-p` ou Agent SDK. Après chaque compaction, dès que le fichier dépasse 5 Mo, Claude Code supprime l'historique antérieur à cette compaction. La reprise de la session restaure la même conversation, que le fichier ait été réduit ou non. Définissez-la dans l'environnement depuis lequel vous démarrez Claude Code, car un bloc `env` des paramètres ne peut pas l'activer. Nécessite Claude Code v2.1.287 ou ultérieur |

415| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Délai, en millisecondes, au-delà duquel Claude Code annule une boîte de dialogue qu'il transmet à un client distant, comme un hôte [Remote Control](/docs/fr/remote-control) ou SDK, ou la boîte de dialogue d'approbation d'un [message inter-sessions retenu](/docs/fr/cross-session-messaging#control-inbound-messages) ; les demandes de permission et les questions `AskUserQuestion` utilisent leurs propres flux et ne sont pas régies par ce délai. Dans Claude Code v2.1.236 ou version ultérieure, il limite également, en cours de session, la [demande de consentement aux crédits d'utilisation Fable](/docs/fr/model-config#fable-and-usage-credits) dans une session susceptible de s'exécuter sans surveillance. [Contrôler les messages entrants](/docs/fr/cross-session-messaging#control-inbound-messages) et [Sessions non interactives](/docs/fr/cross-session-messaging#non-interactive-sessions) décrivent l'ensemble des règles d'expiration des messages retenus, y compris les cas où le délai ne s'applique pas. Remplace le paramètre [`dialogExpiry`](/docs/fr/settings-reference#dialogexpiry). `0` ou une valeur négative désactive le délai |418| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Délai en millisecondes avant que Claude Code annule une boîte de dialogue qu'il transmet à un client distant, comme un hôte [Remote Control](/docs/fr/remote-control) ou SDK, ou la boîte de dialogue d'approbation d'un [message inter-sessions retenu](/docs/fr/cross-session-messaging#control-inbound-messages) ; les demandes de permission et les questions `AskUserQuestion` utilisent leurs propres flux et ne sont pas régies par cette variable. Dans Claude Code v2.1.236 ou ultérieur, elle borne également la [demande de consentement aux crédits d'utilisation Fable](/docs/fr/model-config#fable-and-usage-credits) en cours de session dans une session susceptible de s'exécuter sans surveillance. [Contrôler les messages entrants](/docs/fr/cross-session-messaging#control-inbound-messages) et [sessions non interactives](/docs/fr/cross-session-messaging#non-interactive-sessions) décrivent l'ensemble des règles d'expiration des messages retenus, y compris les cas où le délai ne s'applique pas. Remplace le paramètre [`dialogExpiry`](/docs/fr/settings-reference#dialogexpiry). `0` ou une valeur négative désactive le délai |

416| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Utiliser [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) |419| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Utiliser [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) |

417| `CLAUDE_CODE_USE_BEDROCK` | Utiliser [Amazon Bedrock](/docs/fr/amazon-bedrock) |420| `CLAUDE_CODE_USE_BEDROCK` | Utiliser [Amazon Bedrock](/docs/fr/amazon-bedrock) |

418| `CLAUDE_CODE_USE_FOUNDRY` | Utiliser [Microsoft Foundry](/docs/fr/microsoft-foundry) |421| `CLAUDE_CODE_USE_FOUNDRY` | Utiliser [Microsoft Foundry](/docs/fr/microsoft-foundry) |

419| `CLAUDE_CODE_USE_MANTLE` | Utiliser l'[endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) d'Amazon Bedrock |422| `CLAUDE_CODE_USE_MANTLE` | Utiliser l'[endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) d'Amazon Bedrock |

420| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Définissez-la sur `1` pour découvrir les commandes personnalisées, les sous-agents et les styles de sortie à l'aide des API de fichiers de Node.js au lieu de ripgrep. Définissez-la si le binaire ripgrep fourni est indisponible ou bloqué dans votre environnement. N'affecte ni Grep ni les outils de recherche de fichiers |423| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Définissez sur `1` pour découvrir les commandes personnalisées, les sous-agents et les styles de sortie à l'aide des API de fichiers de Node.js au lieu de ripgrep. Définissez-la si le binaire ripgrep intégré est indisponible ou bloqué dans votre environnement. N'affecte pas les outils Grep ni de recherche de fichiers |

421| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Contrôle l'outil PowerShell. Sous Windows sans Git Bash, l'outil est activé automatiquement ; définissez-la sur `0` pour le désactiver. Sous Windows avec Git Bash installé, l'outil est activé par défaut pour les comptes claude.ai et Console ; définissez-la sur `1` pour l'activer dans les sessions Amazon Bedrock, Agent Platform de Google Cloud et Microsoft Foundry, ou sur `0` pour le désactiver. Sous Linux, macOS et WSL, définissez-la sur `1` pour l'activer, ce qui nécessite que `pwsh` soit présent dans votre `PATH`. Lorsqu'il est activé sous Windows, Claude peut exécuter des commandes PowerShell nativement au lieu de passer par Git Bash. Consultez [Outil PowerShell](/docs/fr/tools-reference#powershell-tool) |424| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Contrôle l'outil PowerShell. Sous Windows sans Git Bash, l'outil est activé automatiquement ; définissez `0` pour le désactiver. Sous Windows avec Git Bash installé, l'outil est activé par défaut pour les comptes claude.ai et Console ; définissez `1` pour l'activer dans les sessions Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, ou `0` pour le désactiver. Sous Linux, macOS et WSL, définissez `1` pour l'activer, ce qui nécessite `pwsh` dans votre `PATH`. Lorsqu'il est activé sous Windows, Claude peut exécuter des commandes PowerShell nativement au lieu de passer par Git Bash. Voir [Outil PowerShell](/docs/fr/tools-reference#powershell-tool) |

422| `CLAUDE_CODE_USE_VERTEX` | Utiliser [Agent Platform de Google Cloud](/docs/fr/google-vertex-ai) |425| `CLAUDE_CODE_USE_VERTEX` | Utiliser [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) |

423| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Définissez le nombre de millisecondes pendant lesquelles [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior) conserve en cache la réponse de chaque URL récupérée. La valeur par défaut est `900000`, soit 15 minutes. N'accepte que des chiffres simples ; `0`, un nombre décimal ou toute autre écriture conserve la valeur par défaut. Claude Code lit la valeur une seule fois par lancement, de sorte qu'une modification dans un bloc `env` des paramètres s'applique au prochain lancement de `claude`. Nécessite Claude Code v2.1.233 ou ultérieur |426| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Définissez le nombre de millisecondes pendant lesquelles [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior) conserve en cache la réponse de chaque URL récupérée. La valeur par défaut est `900000`, soit 15 minutes. N'accepte que des chiffres simples ; `0`, un nombre décimal ou toute autre écriture conserve la valeur par défaut. Claude Code lit la valeur une fois par lancement, de sorte qu'une modification dans un bloc `env` des paramètres s'applique lors du prochain lancement de `claude`. Nécessite Claude Code v2.1.233 ou ultérieur |

424| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite supérieure, en millisecondes, du temps pendant lequel [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior) attend le téléchargement d'une page, y compris les redirections qu'il suit. Un téléchargement qui n'est pas terminé à cette échéance échoue avec une erreur de délai. La valeur par défaut est `300000`, soit cinq minutes. Définissez-la sur `0` pour supprimer la limite. N'accepte que des chiffres simples ; un nombre décimal ou toute autre écriture conserve la valeur par défaut. Nécessite Claude Code v2.1.268 ou ultérieur |427| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite supérieure, en millisecondes, du temps pendant lequel [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior) attend le téléchargement d'une page, y compris les redirections qu'il suit. Un téléchargement non terminé à l'issue de ce délai échoue avec une erreur de délai dépassé. La valeur par défaut est `300000`, soit cinq minutes. Définissez `0` pour supprimer la limite. N'accepte que des chiffres simples ; un nombre décimal ou toute autre écriture conserve la valeur par défaut. Nécessite Claude Code v2.1.268 ou ultérieur |

425| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Lorsque `CLAUDE_AUTO_BACKGROUND_TASKS` est défini sur `1`, durée pendant laquelle Claude Code attend avant chaque rappel invitant Claude à vérifier les [sous-agents en arrière-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) encore en cours d'exécution. Accepte une ou plusieurs attentes séparées par des virgules, en secondes entières de `1` à `86400`, comme `600` ou `600,1800,3600`. Chaque valeur correspond à l'attente avant le rappel suivant, et la dernière valeur se répète. N'accepte que des chiffres simples ; toute autre valeur ou écriture est traitée comme non définie. Lorsque la variable n'est pas définie, il n'y a aucun rappel. Nécessite Claude Code v2.1.283 ou ultérieur |428| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Lorsque `CLAUDE_AUTO_BACKGROUND_TASKS` est défini sur `1`, durée pendant laquelle Claude Code attend avant chaque rappel invitant Claude à vérifier les [sous-agents en arrière-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) encore en cours d'exécution. Accepte une ou plusieurs attentes séparées par des virgules, en secondes entières de `1` à `86400`, comme `600` ou `600,1800,3600`. Chaque valeur correspond à l'attente avant le rappel suivant, et la dernière valeur se répète. N'accepte que des chiffres simples ; toute autre valeur ou écriture est traitée comme non définie. Lorsque la variable n'est pas définie, aucun rappel n'a lieu. Nécessite Claude Code v2.1.283 ou ultérieur |

426| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Nombre d'agents qu'une seule exécution de [workflow](/docs/fr/workflows) exécute simultanément, de `1` à `256`. Par défaut, une exécution lance jusqu'à 16 agents simultanément, moins lorsque Claude Code dispose de moins de CPU ; les appels `agent()` en file d'attente attendent qu'un emplacement se libère. La transcription de chaque agent en cours d'exécution reste dans la mémoire de Claude Code, de sorte que des valeurs plus élevées augmentent l'utilisation de la mémoire. N'accepte que des chiffres simples ; les valeurs hors limites et les autres écritures conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou ultérieur |429| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Nombre d'agents qu'une seule exécution de [workflow](/docs/fr/workflows) exécute simultanément, de `1` à `256`. Par défaut, une exécution lance jusqu'à 16 agents simultanément, moins lorsque Claude Code dispose de moins de CPU ; les appels `agent()` en file d'attente attendent qu'un emplacement se libère. La transcription de chaque agent en cours d'exécution reste dans la mémoire de Claude Code, de sorte que des valeurs plus élevées augmentent l'utilisation de la mémoire. N'accepte que des chiffres simples ; les valeurs hors plage et les autres écritures conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou ultérieur |

427| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite supérieure, en millisecondes, du temps pendant lequel un agent de [workflow](/docs/fr/workflows) attend que la première réponse d'un agent frère partageant le même préfixe commence avant d'envoyer sa propre première requête. Lorsqu'un fan-out démarre plusieurs agents qui partagent un [préfixe de cache de prompt](/docs/fr/workflows#prompt-caching-in-a-fan-out), Claude Code retient tous les agents sauf le premier pendant au plus cette durée, afin que les autres lisent le préfixe mis en cache au lieu de le traiter chacun sans cache. Valeur par défaut : `5000`. Définissez-la sur `0` pour désactiver l'attente. Lorsque `DISABLE_PROMPT_CACHING` est défini, les agents n'attendent jamais. Nécessite Claude Code v2.1.229 ou ultérieur |430| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite supérieure, en millisecondes, du temps pendant lequel un agent de [workflow](/docs/fr/workflows) attend que la première réponse d'un agent frère partageant le même préfixe commence avant d'envoyer sa propre première requête. Lorsqu'un fan-out lance plusieurs agents qui partagent un [préfixe de cache de prompt](/docs/fr/workflows#prompt-caching-in-a-fan-out), Claude Code retient tous les agents sauf le premier pendant au plus cette durée, afin que les autres lisent le préfixe mis en cache au lieu de le traiter chacun sans cache. Valeur par défaut : `5000`. Définissez `0` pour désactiver l'attente. Lorsque `DISABLE_PROMPT_CACHING` est défini, les agents n'attendent jamais. Nécessite Claude Code v2.1.229 ou ultérieur |

428| `CLAUDE_CONFIG_DIR` | Remplace le répertoire de configuration (par défaut : `~/.claude`). Tous les paramètres, l'historique des sessions et les plugins sont stockés sous ce chemin. Pour les identifiants, consultez [où Claude Code stocke les identifiants](/docs/fr/authentication#credential-management). Utile pour exécuter plusieurs comptes côte à côte : par exemple, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |431| `CLAUDE_CONFIG_DIR` | Remplace le répertoire de configuration (par défaut : `~/.claude`). Tous les paramètres, l'historique des sessions et les plugins sont stockés sous ce chemin. Pour les identifiants, voir [où Claude Code stocke les identifiants](/docs/fr/authentication#credential-management). Utile pour exécuter plusieurs comptes côte à côte : par exemple, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Dans un fichier de paramètres, indiquez le [chemin absolu](#in-settings-files). Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |

429| `CLAUDE_DISABLE_ADOPT` | Définissez sur `1` pour arrêter le travail en arrière-plan en cours au lieu de le reprendre lorsque vous passez une session en arrière-plan en appuyant sur `←` ou avec [`/background`](/docs/fr/agent-view#from-inside-a-session). Claude Code vous demande de confirmer avant de passer en arrière-plan, puis arrête les tâches qui auraient sinon été reprises. Nécessite Claude Code v2.1.195 ou ultérieur |432| `CLAUDE_DISABLE_ADOPT` | Définissez `1` pour arrêter le travail en arrière-plan en cours au lieu de le conserver lorsque vous passez une session en arrière-plan en appuyant sur `←` ou avec [`/background`](/docs/fr/agent-view#from-inside-a-session). Claude Code vous demande de confirmer avant le passage en arrière-plan, puis arrête les tâches qui auraient sinon été conservées. Nécessite Claude Code v2.1.195 ou ultérieur |

430| `CLAUDE_EFFORT` | Définie automatiquement dans les sous-processus de l'outil Bash et les commandes de hook sur le [niveau d'effort](/docs/fr/model-config#adjust-effort-level) en vigueur au démarrage du sous-processus : `low`, `medium`, `high`, `xhigh` ou `max`. Correspond au champ `effort.level` transmis aux [hooks](/docs/fr/hooks). Définie uniquement lorsque le modèle actuel prend en charge le paramètre d'effort |433| `CLAUDE_EFFORT` | Définie automatiquement dans les sous-processus de l'outil Bash et les commandes de hook sur le [niveau d'effort](/docs/fr/model-config#adjust-effort-level) en vigueur au démarrage du sous-processus : `low`, `medium`, `high`, `xhigh` ou `max`. Correspond au champ `effort.level` transmis aux [hooks](/docs/fr/hooks). Définie uniquement lorsque le modèle actuel prend en charge le paramètre effort |

431| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Définissez sur `1` pour forcer l'activation du watchdog d'inactivité du streaming au niveau des octets, ou sur `0` pour forcer sa désactivation. `0` désactive également l'[échéance du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) sur les connexions où cette échéance s'applique. Lorsque la variable n'est pas définie, le watchdog est activé par défaut pour les connexions directes à l'API Anthropic et à [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), ainsi que pour les réponses en streaming sur les connexions de [passerelle](/docs/fr/gateways) atteintes via `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL` ; avant la v2.1.222, il ne s'exécutait pas sur ces connexions de passerelle, de sorte que le watchdog au niveau des événements pouvait y signaler un blocage alors même que des pings keep-alive arrivaient. Pour les délais d'expiration et l'interaction entre les minuteurs, consultez [Watchdogs d'inactivité du streaming](/docs/fr/network-config#streaming-idle-watchdogs) |434| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Définissez `1` pour forcer l'activation du watchdog d'inactivité du streaming au niveau des octets, ou `0` pour forcer sa désactivation. `0` désactive également le [délai du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) sur les connexions où ce délai s'applique. Lorsque la variable n'est pas définie, le watchdog est activé par défaut pour les connexions directes à l'API Anthropic et à [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), ainsi que pour les réponses en streaming sur les connexions de [passerelle](/docs/fr/gateways) atteintes via `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL` ; avant la v2.1.222, il ne s'exécutait pas sur ces connexions de passerelle, de sorte que le watchdog au niveau des événements pouvait y signaler un blocage alors même que des pings keep-alive arrivaient. Pour les délais d'expiration et l'interaction entre les minuteurs, voir [Watchdogs d'inactivité du streaming](/docs/fr/network-config#streaming-idle-watchdogs) |

432| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Définissez sur `1` pour activer le watchdog d'inactivité du streaming au niveau des octets sur les réponses `vnd.amazon.eventstream` d'Amazon Bedrock, ce qui active également l'[échéance du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) sur les requêtes de streaming Bedrock. Désactivé par défaut. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |435| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Définissez `1` pour activer le watchdog d'inactivité du streaming au niveau des octets sur les réponses Amazon Bedrock `vnd.amazon.eventstream`, ce qui active également le [délai du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) sur les requêtes de streaming Bedrock. Désactivé par défaut. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

433| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Définissez sur `0` pour forcer la désactivation du watchdog d'inactivité du streaming au niveau des événements, ou sur `1` pour forcer son activation. Lorsque la variable n'est pas définie, le watchdog est activé par défaut pour tous les fournisseurs. Avant la v2.1.196, la valeur par défaut non définie était contrôlée par le serveur sur l'API Anthropic directe et désactivée sur les autres fournisseurs. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` ; pour les autres minuteurs de blocage qui s'exécutent parallèlement à celui-ci, consultez [Watchdogs d'inactivité du streaming](/docs/fr/network-config#streaming-idle-watchdogs) |436| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Définissez `0` pour forcer la désactivation du watchdog d'inactivité du streaming au niveau des événements, ou `1` pour forcer son activation. Lorsque la variable n'est pas définie, le watchdog est activé par défaut pour tous les fournisseurs. Avant la v2.1.196, la valeur par défaut en l'absence de définition était contrôlée par le serveur sur l'API Anthropic directe et désactivée sur les autres fournisseurs. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` ; pour les autres minuteurs de blocage qui s'exécutent parallèlement à celui-ci, voir [Watchdogs d'inactivité du streaming](/docs/fr/network-config#streaming-idle-watchdogs) |

434| `CLAUDE_ENV_FILE` | Chemin vers un script shell dont Claude Code exécute le contenu avant chaque commande Bash dans le même processus shell, de sorte que les exports du fichier sont visibles par la commande. À utiliser pour conserver l'activation d'un virtualenv ou de conda d'une commande à l'autre. Également renseignée dynamiquement par les hooks [SessionStart](/docs/fr/hooks#persist-environment-variables), [Setup](/docs/fr/hooks#setup), [CwdChanged](/docs/fr/hooks#cwdchanged) et [FileChanged](/docs/fr/hooks#filechanged) |437| `CLAUDE_ENV_FILE` | Chemin vers un script shell dont Claude Code exécute le contenu avant chaque commande Bash dans le même processus shell, de sorte que les exports du fichier sont visibles par la commande. À utiliser pour conserver l'activation d'un virtualenv ou de conda d'une commande à l'autre. Également renseignée dynamiquement par les hooks [SessionStart](/docs/fr/hooks#persist-environment-variables), [Setup](/docs/fr/hooks#setup), [CwdChanged](/docs/fr/hooks#cwdchanged) et [FileChanged](/docs/fr/hooks#filechanged) |

435| `CLAUDE_JOB_DIR` | Définie par Claude Code dans chaque [session en arrière-plan](/docs/fr/agent-view) sur le répertoire `~/.claude/jobs/<id>` de cette session. Les commandes shell exécutées par la session en héritent. Écrivez les fichiers temporaires dans [`$CLAUDE_JOB_DIR/tmp`](/docs/fr/agent-view#where-state-is-stored). Les appels `Write` et `Edit` de Claude à cet emplacement ne demandent pas de permission, et le répertoire est supprimé lorsque la session est supprimée |438| `CLAUDE_JOB_DIR` | Définie par Claude Code dans chaque [session en arrière-plan](/docs/fr/agent-view) sur le répertoire `~/.claude/jobs/<id>` de cette session. Les commandes shell exécutées par la session en héritent. Écrivez les fichiers temporaires dans [`$CLAUDE_JOB_DIR/tmp`](/docs/fr/agent-view#where-state-is-stored). Les appels `Write` et `Edit` de Claude à cet emplacement ne demandent pas de permission, et le répertoire est supprimé lorsque la session est supprimée |

436| `CLAUDE_PID` | Claude Code définit cette variable sur son propre identifiant de processus dans les sous-processus qu'il lance : les commandes des outils Bash et PowerShell et les commandes de hook. Sous Linux, l'intégration shell de l'outil Bash l'utilise pour refuser un motif `pkill` qui correspondrait au processus Claude Code lui-même ; consultez [la référence des erreurs](/docs/fr/errors#pkill-pattern-matches-the-claude-code-process). Lisez-la depuis vos propres scripts pour identifier le processus parent Claude Code ou lui envoyer délibérément un signal. Nécessite Claude Code v2.1.214 ou ultérieur |439| `CLAUDE_PID` | Claude Code définit cette variable sur son propre identifiant de processus dans les sous-processus qu'il lance : les commandes des outils Bash et PowerShell et les commandes de hook. Sous Linux, l'intégration shell de l'outil Bash l'utilise pour refuser un motif `pkill` qui correspondrait au processus Claude Code lui-même ; voir [la référence des erreurs](/docs/fr/errors#pkill-pattern-matches-the-claude-code-process). Lisez-la depuis vos propres scripts pour identifier le processus parent Claude Code ou lui envoyer délibérément un signal. Nécessite Claude Code v2.1.214 ou ultérieur |

437| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Préfixe des noms de session [Remote Control](/docs/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est fourni. Par défaut, le nom d'hôte de votre machine, ce qui produit des noms comme `myhost-graceful-unicorn`. Le flag CLI `--remote-control-session-name-prefix` définit la même valeur pour une seule invocation |440| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Préfixe des noms de session [Remote Control](/docs/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est fourni. Par défaut, le nom d'hôte de votre machine, ce qui produit des noms comme `myhost-graceful-unicorn`. Le flag CLI `--remote-control-session-name-prefix` définit la même valeur pour une seule invocation |

438| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Échéance, en millisecondes, pour le premier octet de réponse d'une requête de streaming, sur les connexions où l'[échéance du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) s'applique. Pour savoir comment Claude Code la borne, le temps supplémentaire qu'il ajoute pour les corps de requête volumineux et la façon dont il choisit l'échéance lorsque vous ne définissez pas cette variable, consultez [No response from API](/docs/fr/errors#no-response-from-api). Nécessite Claude Code v2.1.242 ou ultérieur |441| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Délai, en millisecondes, pour le premier octet de réponse d'une requête de streaming, sur les connexions où le [délai du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) s'applique. Pour savoir comment Claude Code le borne, le temps supplémentaire qu'il ajoute pour les corps de requête volumineux et comment il choisit le délai lorsque cette variable n'est pas définie, voir [No response from API](/docs/fr/errors#no-response-from-api). Nécessite Claude Code v2.1.242 ou ultérieur |

439| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration, en millisecondes, avant que les watchdogs d'inactivité du streaming au niveau des événements et des octets ferment une connexion bloquée. Lorsque vous définissez explicitement cette variable, le minimum est `300000` (5 minutes) ; les valeurs inférieures sont silencieusement ramenées à ce minimum pour absorber les pauses de réflexion étendue et la mise en tampon des proxys, et le watchdog au niveau des octets plafonne la valeur à 30 minutes. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` a priorité sur cette variable pour le watchdog au niveau des octets. Pour les valeurs par défaut de chaque watchdog lorsque la variable n'est pas définie, consultez [Watchdogs d'inactivité du streaming](/docs/fr/network-config#streaming-idle-watchdogs) |442| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration, en millisecondes, avant que les watchdogs d'inactivité du streaming au niveau des événements et des octets ferment une connexion bloquée. Lorsque vous définissez explicitement cette variable, le minimum est `300000` (5 minutes) ; les valeurs inférieures sont silencieusement ramenées à ce minimum pour absorber les pauses de réflexion étendue et la mise en tampon des proxys, et le watchdog au niveau des octets plafonne la valeur à 30 minutes. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` a priorité sur cette variable pour le watchdog au niveau des octets. Pour les valeurs par défaut de chaque watchdog en l'absence de définition, voir [Watchdogs d'inactivité du streaming](/docs/fr/network-config#streaming-idle-watchdogs) |

440| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Supprimée dans la v2.1.260 et désormais sans effet. Plafonnait auparavant, en millisecondes, la durée d'exécution d'une [commande shell en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) lancée par un [sous-agent](/docs/fr/sub-agents), avec une valeur par défaut de 60 minutes. Consultez [les règles de durée de vie des commandes en arrière-plan](/docs/fr/tools-reference#background-commands) |443| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Supprimée dans la v2.1.260 et désormais sans effet. Plafonnait auparavant, en millisecondes, la durée d'exécution d'une [commande shell en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) lancée par un [sous-agent](/docs/fr/sub-agents), avec une valeur par défaut de 60 minutes. Voir [les règles de durée de vie des commandes en arrière-plan](/docs/fr/tools-reference#background-commands) |

441| `DEBUG` | Définissez sur `1` pour activer le mode débogage, ce qui équivaut à un lancement avec [`--debug`](/docs/fr/cli-reference#cli-flags). Les logs de débogage sont écrits dans `~/.claude/debug/<session-id>.txt`, ou dans le chemin défini par `CLAUDE_CODE_DEBUG_LOGS_DIR`. Seules les valeurs vraies `1`, `true`, `yes` et `on` activent le mode débogage, de sorte que des motifs d'espace de noms comme `DEBUG=express:*` définis pour d'autres outils ne le déclenchent pas |444| `DEBUG` | Définissez `1` pour activer le mode débogage, ce qui équivaut à un lancement avec [`--debug`](/docs/fr/cli-reference#cli-flags). Les logs de débogage sont écrits dans `~/.claude/debug/<session-id>.txt`, ou dans le chemin défini par `CLAUDE_CODE_DEBUG_LOGS_DIR`. Seules les valeurs vraies `1`, `true`, `yes` et `on` activent le mode débogage, de sorte que les motifs d'espace de noms comme `DEBUG=express:*` définis pour d'autres outils ne le déclenchent pas |

442| `DISABLE_AUTOUPDATER` | Définissez sur `1` pour désactiver les mises à jour automatiques en arrière-plan. La commande manuelle `claude update` fonctionne toujours. Utilisez `DISABLE_UPDATES` pour bloquer les deux |445| `DISABLE_AUTOUPDATER` | Définissez `1` pour désactiver les mises à jour automatiques en arrière-plan. La commande manuelle `claude update` fonctionne toujours. Utilisez `DISABLE_UPDATES` pour bloquer les deux |

443| `DISABLE_AUTO_COMPACT` | Définissez sur `1` pour désactiver la compaction automatique à l'approche de la limite de contexte. La commande manuelle `/compact` reste disponible. À utiliser lorsque vous souhaitez contrôler explicitement le moment de la compaction. Remplace le paramètre [`autoCompactEnabled`](/docs/fr/settings-reference#autocompactenabled) |446| `DISABLE_AUTO_COMPACT` | Définissez `1` pour désactiver la compaction automatique à l'approche de la limite de contexte. La commande manuelle `/compact` reste disponible. À utiliser lorsque vous souhaitez contrôler explicitement le moment de la compaction. Remplace le paramètre [`autoCompactEnabled`](/docs/fr/settings-reference#autocompactenabled) |

444| `DISABLE_COMPACT` | Définissez sur `1` pour désactiver toute compaction : la compaction automatique comme la commande manuelle `/compact` |447| `DISABLE_COMPACT` | Définissez `1` pour désactiver toute compaction : à la fois la compaction automatique et la commande manuelle `/compact` |

445| `DISABLE_COST_WARNINGS` | Définissez sur `1` pour désactiver les messages d'avertissement sur les coûts |448| `DISABLE_COST_WARNINGS` | Définissez `1` pour désactiver les messages d'avertissement sur les coûts |

446| `DISABLE_DOCTOR_COMMAND` | Définissez sur `1` pour masquer le skill de vérification de configuration [`/doctor`](/docs/fr/commands#all-commands) et son alias `/checkup`. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter de diagnostics de configuration depuis une session. N'affecte pas la commande de terminal `claude doctor`. Avant la v2.1.205, cette variable masquait la commande d'écran de diagnostic `/doctor` |449| `DISABLE_DOCTOR_COMMAND` | Définissez `1` pour masquer le skill de vérification de la configuration [`/doctor`](/docs/fr/commands#all-commands) et son alias `/checkup`. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter de diagnostics de configuration depuis une session. N'affecte pas la commande de terminal `claude doctor`. Avant la v2.1.205, cette variable masquait la commande d'écran de diagnostic `/doctor` |

447| `DISABLE_ERROR_REPORTING` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour refuser le signalement des erreurs. **La définir sur `0` ou `false` entraîne tout de même ce refus**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour réactiver le signalement des erreurs |450| `DISABLE_ERROR_REPORTING` | Définissez une valeur non vide quelconque, comme `1`, pour désactiver le signalement des erreurs. **La définir sur `0` ou `false` désactive tout de même le signalement**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour réactiver le signalement des erreurs |

448| `DISABLE_EXTRA_USAGE_COMMAND` | Définissez sur `1` pour masquer la commande `/usage-credits` qui permet aux utilisateurs d'acheter une utilisation supplémentaire au-delà des limites de débit |451| `DISABLE_EXTRA_USAGE_COMMAND` | Définissez `1` pour masquer la commande `/usage-credits` qui permet aux utilisateurs d'acheter de l'utilisation supplémentaire au-delà des limites de débit |

449| `DISABLE_FEEDBACK_COMMAND` | Définissez sur `1` pour désactiver la commande `/feedback` et les [commentaires rédigés par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior). Désactive également `/bug` et `/share`, qui effectuent leurs signalements par le même chemin ; avant la v2.1.212, il s'agissait d'alias de `/feedback`, de sorte que la commande était désactivée sous tous ses noms. L'ancien nom `DISABLE_BUG_COMMAND` est également accepté |452| `DISABLE_FEEDBACK_COMMAND` | Définissez `1` pour désactiver la commande `/feedback` et les [commentaires rédigés par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior). Désactive également `/bug` et `/share`, qui transmettent leurs signalements par le même canal ; avant la v2.1.212, ils étaient des alias de `/feedback`, de sorte que la commande était désactivée sous tous ses noms. L'ancien nom `DISABLE_BUG_COMMAND` est également accepté |

450| `DISABLE_GROWTHBOOK` | Définissez sur `1` ou `true` pour désactiver la récupération des feature flags GrowthBook et utiliser les valeurs par défaut du code pour chaque flag. Cela rend indisponibles [Remote Control](/docs/fr/remote-control#requirements) et les autres [fonctionnalités qui nécessitent la récupération des feature flags](#features-that-need-feature-flag-fetching). La définir sur `0` ou `false` laisse la récupération activée. La journalisation des événements de télémétrie reste activée sauf si `DISABLE_TELEMETRY` est également défini |453| `DISABLE_GROWTHBOOK` | Définissez `1` ou `true` pour désactiver la récupération des feature flags GrowthBook et utiliser les valeurs par défaut du code pour chaque flag. Cela rend indisponibles [Remote Control](/docs/fr/remote-control#requirements) et les autres [fonctionnalités qui nécessitent la récupération des feature flags](#features-that-need-feature-flag-fetching). La définir sur `0` ou `false` laisse la récupération activée. La journalisation des événements de télémétrie reste activée, sauf si `DISABLE_TELEMETRY` est également défini |

451| `DISABLE_INSTALLATION_CHECKS` | Définissez sur `1` pour désactiver les avertissements d'installation. À utiliser uniquement lorsque vous gérez manuellement l'emplacement d'installation, car cela peut masquer des problèmes avec les installations standard |454| `DISABLE_INSTALLATION_CHECKS` | Définissez `1` pour désactiver les avertissements d'installation. À utiliser uniquement lorsque vous gérez manuellement l'emplacement d'installation, car cela peut masquer des problèmes liés aux installations standard |

452| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Définissez sur `1` pour masquer la commande `/install-github-app`. Déjà masquée lors de l'utilisation de fournisseurs tiers (Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry) |455| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Définissez `1` pour masquer la commande `/install-github-app`. Déjà masquée lors de l'utilisation de fournisseurs tiers (Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry) |

453| `DISABLE_INTERLEAVED_THINKING` | Définissez sur `1` pour empêcher l'envoi de l'en-tête bêta de réflexion entrelacée. Utile lorsque votre passerelle LLM ou votre fournisseur ne prend pas en charge la [réflexion entrelacée](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |456| `DISABLE_INTERLEAVED_THINKING` | Définissez `1` pour empêcher l'envoi de l'en-tête bêta interleaved-thinking. Utile lorsque votre passerelle LLM ou votre fournisseur ne prend pas en charge la [réflexion entrelacée](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

454| `DISABLE_LOGIN_COMMAND` | Définissez sur `1` pour masquer la commande `/login`. Utile lorsque l'authentification est gérée en externe via des clés API ou `apiKeyHelper` |457| `DISABLE_LOGIN_COMMAND` | Définissez `1` pour masquer la commande `/login`. Utile lorsque l'authentification est gérée en externe via des clés API ou `apiKeyHelper` |

455| `DISABLE_LOGOUT_COMMAND` | Définissez sur `1` pour masquer la commande `/logout` |458| `DISABLE_LOGOUT_COMMAND` | Définissez `1` pour masquer la commande `/logout` |

456| `DISABLE_PROMPT_CACHING` | Définissez sur `1` pour désactiver le [prompt caching](/docs/fr/prompt-caching#disable-prompt-caching) pour tous les modèles (a priorité sur les paramètres propres à chaque modèle) |459| `DISABLE_PROMPT_CACHING` | Définissez `1` pour désactiver le [prompt caching](/docs/fr/prompt-caching#disable-prompt-caching) pour tous les modèles (a priorité sur les paramètres par modèle) |

457| `DISABLE_PROMPT_CACHING_FABLE` | Définissez sur `1` pour désactiver le prompt caching pour les modèles Fable |460| `DISABLE_PROMPT_CACHING_FABLE` | Définissez `1` pour désactiver le prompt caching pour les modèles Fable |

458| `DISABLE_PROMPT_CACHING_HAIKU` | Définissez sur `1` pour désactiver le prompt caching pour le [modèle Haiku par défaut](/docs/fr/prompt-caching#disable-prompt-caching), où qu'il s'exécute |461| `DISABLE_PROMPT_CACHING_HAIKU` | Définissez `1` pour désactiver le prompt caching pour le [modèle Haiku par défaut](/docs/fr/prompt-caching#disable-prompt-caching), quel que soit l'endroit où il s'exécute |

459| `DISABLE_PROMPT_CACHING_OPUS` | Définissez sur `1` pour désactiver le prompt caching pour le [modèle Opus par défaut](/docs/fr/prompt-caching#disable-prompt-caching) |462| `DISABLE_PROMPT_CACHING_OPUS` | Définissez `1` pour désactiver le prompt caching pour le [modèle Opus par défaut](/docs/fr/prompt-caching#disable-prompt-caching) |

460| `DISABLE_PROMPT_CACHING_SONNET` | Définissez sur `1` pour désactiver le prompt caching pour le [modèle Sonnet par défaut](/docs/fr/prompt-caching#disable-prompt-caching) |463| `DISABLE_PROMPT_CACHING_SONNET` | Définissez `1` pour désactiver le prompt caching pour le [modèle Sonnet par défaut](/docs/fr/prompt-caching#disable-prompt-caching) |

461| `DISABLE_TELEMETRY` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour refuser la télémétrie. **La définir sur `0` ou `false` entraîne tout de même ce refus**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour réactiver la télémétrie. Les événements de télémétrie n'incluent pas de données utilisateur comme du code, des chemins de fichiers ou des commandes Bash. Désactive également la [récupération des feature flags](#features-that-need-feature-flag-fetching). Consultez [Désactiver la télémétrie pour votre organisation](/docs/fr/managed-settings#turn-telemetry-off-for-your-organization) |464| `DISABLE_TELEMETRY` | Définissez une valeur non vide quelconque, comme `1`, pour désactiver la télémétrie. **La définir sur `0` ou `false` désactive tout de même la télémétrie**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour réactiver la télémétrie. Les événements de télémétrie n'incluent pas de données utilisateur comme le code, les chemins de fichiers ou les commandes Bash. Désactive également la [récupération des feature flags](#features-that-need-feature-flag-fetching). Voir [Désactiver la télémétrie pour votre organisation](/docs/fr/managed-settings#turn-telemetry-off-for-your-organization) |

462| `DISABLE_UPDATES` | Définissez sur `1` pour bloquer toutes les mises à jour, y compris les commandes manuelles `claude update` et `claude install`. Plus strict que `DISABLE_AUTOUPDATER`. À utiliser lorsque vous distribuez Claude Code par vos propres canaux et que les utilisateurs ne doivent pas effectuer eux-mêmes les mises à jour |465| `DISABLE_UPDATES` | Définissez `1` pour bloquer toutes les mises à jour, y compris les commandes manuelles `claude update` et `claude install`. Plus strict que `DISABLE_AUTOUPDATER`. À utiliser lorsque vous distribuez Claude Code par vos propres canaux et que les utilisateurs ne doivent pas effectuer eux-mêmes les mises à jour |

463| `DISABLE_UPGRADE_COMMAND` | Définissez sur `1` pour masquer la commande `/upgrade` |466| `DISABLE_UPGRADE_COMMAND` | Définissez `1` pour masquer la commande `/upgrade` |

464| `DO_NOT_TRACK` | Définissez sur `1` pour refuser la télémétrie, avec le même effet que `DISABLE_TELEMETRY`, y compris sur la [récupération des feature flags](#features-that-need-feature-flag-fetching). Claude Code lit cette variable comme un booléen standard, de sorte que `0` laisse la télémétrie activée, et la respecte en tant que convention inter-outils reconnue par de nombreuses CLI de développement |467| `DO_NOT_TRACK` | Définissez `1` pour désactiver la télémétrie, avec le même effet que `DISABLE_TELEMETRY`, y compris sur la [récupération des feature flags](#features-that-need-feature-flag-fetching). Claude Code lit cette variable comme un booléen standard, de sorte que `0` laisse la télémétrie activée, et la respecte en tant que convention inter-outils reconnue par de nombreux CLI pour développeurs |

465| `ENABLE_BETA_TRACING_DETAILED` | Définissez sur `1`, et définissez `BETA_TRACING_ENDPOINT` sur l'endpoint de votre collecteur OTLP/HTTP, pour activer le [traçage bêta détaillé](/docs/fr/monitoring-usage#traces-beta), qui ajoute des attributs de span porteurs de contenu et le span `claude_code.hook`. Les sessions CLI interactives nécessitent également que votre organisation figure sur la liste d'autorisation de la bêta. Les deux variables sont ignorées dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |468| `ENABLE_BETA_TRACING_DETAILED` | Définissez `1`, et définissez `BETA_TRACING_ENDPOINT` sur l'endpoint de votre collecteur OTLP/HTTP, pour activer le [traçage bêta détaillé](/docs/fr/monitoring-usage#traces-beta), qui ajoute des attributs de span porteurs de contenu et le span `claude_code.hook`. Les sessions CLI interactives nécessitent également que votre organisation figure sur la liste d'autorisation de la bêta. Les deux variables sont ignorées dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |

466| `ENABLE_CLAUDEAI_MCP_SERVERS` | Définissez sur `false` pour empêcher Claude Code de récupérer les [serveurs MCP claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai). Activé par défaut pour les utilisateurs connectés. Pour désactiver par projet ou par organisation, définissez plutôt [`disableClaudeAiConnectors`](/docs/fr/settings-reference#disableclaudeaiconnectors) dans les paramètres |469| `ENABLE_CLAUDEAI_MCP_SERVERS` | Définissez `false` pour empêcher Claude Code de récupérer les [serveurs MCP claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai). Activé par défaut pour les utilisateurs connectés. Pour désactiver cette fonctionnalité par projet ou par organisation, définissez plutôt [`disableClaudeAiConnectors`](/docs/fr/settings-reference#disableclaudeaiconnectors) dans les paramètres |

467| `ENABLE_PROMPT_CACHING_1H` | Définissez sur `1` pour demander un [TTL de cache de prompt](/docs/fr/prompt-caching#cache-lifetime) d'une heure au lieu des 5 minutes par défaut. Destiné aux utilisateurs de clés API, d'[Amazon Bedrock](/docs/fr/amazon-bedrock), de [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai), de [Microsoft Foundry](/docs/fr/microsoft-foundry) et de [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). Les utilisateurs disposant d'un abonnement, dans les limites de l'utilisation incluse, reçoivent automatiquement le TTL d'une heure sur la [conversation principale](/docs/fr/prompt-caching#which-ttl-each-request-gets). Les utilisateurs disposant d'un abonnement qui puisent dans leurs [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) peuvent la définir pour conserver le TTL d'une heure. Les écritures en cache d'une heure sont facturées à un tarif plus élevé. Pour choisir plutôt le TTL par catégorie de requêtes, utilisez `CLAUDE_CODE_PROMPT_CACHE_TTL` et `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, qui ont priorité sur cette variable |470| `ENABLE_PROMPT_CACHING_1H` | Définissez `1` pour demander une [durée de vie (TTL) du cache de prompt](/docs/fr/prompt-caching#cache-lifetime) d'une heure au lieu des 5 minutes par défaut. Destinée aux utilisateurs d'une clé API, d'[Amazon Bedrock](/docs/fr/amazon-bedrock), de [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai), de [Microsoft Foundry](/docs/fr/microsoft-foundry) et de [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). Les utilisateurs d'un abonnement dans le cadre de l'utilisation incluse bénéficient automatiquement du TTL d'une heure sur la [conversation principale](/docs/fr/prompt-caching#which-ttl-each-request-gets). Les utilisateurs d'un abonnement qui puisent dans leurs [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) peuvent la définir pour conserver le TTL d'une heure. Les écritures de cache d'une heure sont facturées à un tarif plus élevé. Pour choisir plutôt le TTL par catégorie de requêtes, utilisez `CLAUDE_CODE_PROMPT_CACHE_TTL` et `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, qui ont priorité sur cette variable |

468| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Dépréciée. Utilisez plutôt `ENABLE_PROMPT_CACHING_1H` |471| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Dépréciée. Utilisez plutôt `ENABLE_PROMPT_CACHING_1H` |

469| `ENABLE_TOOL_SEARCH` | Contrôle la [recherche d'outils MCP](/docs/fr/mcp#scale-with-mcp-tool-search). Lorsque la variable n'est pas définie, Claude Code diffère par défaut le chargement de tous les outils MCP. Il les charge toutefois dès le départ sur les modèles de Google Cloud's Agent Platform antérieurs à la génération Claude 4.5, sur un déploiement Microsoft Foundry hébergé sur Azure, et lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte qui n'est pas first-party. `true` diffère toujours le chargement et envoie l'en-tête bêta, sauf sur ces mêmes modèles Agent Platform et déploiements Microsoft Foundry ; les requêtes échouent sur les proxys qui ne prennent pas en charge `tool_reference`. `auto` charge dès le départ lorsque les définitions d'outils tiennent dans 10 % du contexte. `auto:N` définit un seuil personnalisé, comme `auto:5` pour 5 %. `false` charge tous les outils dès le départ. Une valeur que vous définissez vous-même est ignorée lorsque `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` est défini. Avant la v2.1.221, Claude Code désactivait la recherche d'outils pour tous les modèles sur Google Cloud's Agent Platform, sauf si vous définissiez cette variable sur `true` |472| `ENABLE_TOOL_SEARCH` | Contrôle [MCP Tool Search](/docs/fr/mcp#scale-with-mcp-tool-search). Si la variable n'est pas définie, Claude Code diffère par défaut le chargement de tous les outils MCP. Il les charge néanmoins dès le départ sur les modèles Google Cloud's Agent Platform antérieurs à la génération Claude 4.5, sur un déploiement Microsoft Foundry hébergé sur Azure, et lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte non first-party. `true` diffère toujours le chargement et envoie l'en-tête bêta, sauf sur ces mêmes modèles Agent Platform et déploiements Microsoft Foundry ; les requêtes échouent sur les proxys qui ne prennent pas en charge `tool_reference`. `auto` charge les outils dès le départ lorsque les définitions d'outils tiennent dans 10 % du contexte. `auto:N` définit un seuil personnalisé, comme `auto:5` pour 5 %. `false` charge tous les outils dès le départ. Une valeur que vous définissez vous-même est ignorée lorsque `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` est défini. Avant la v2.1.221, Claude Code désactivait la recherche d'outils pour tous les modèles sur Google Cloud's Agent Platform, sauf si vous définissiez cette variable sur `true` |

470| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour que Claude Code cesse de réessayer en cas d'erreurs de surcharge répétées pour tous les modèles lorsqu'aucun modèle de secours n'est configuré. **La définir sur `0` ou `false` active tout de même ce comportement**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour rétablir le comportement par défaut des nouvelles tentatives. Sans elle, Claude Code cesse de réessayer de cette manière sur les modèles qu'il reconnaît comme des modèles Opus, Fable ou Mythos lorsque vous vous authentifiez avec une clé API ou un [fournisseur tiers](/docs/fr/third-party-integrations) plutôt qu'avec un abonnement Claude. Sur Claude Code v2.1.160 ou ultérieur, Claude Code bascule sur votre [chaîne de modèles de secours](/docs/fr/model-config#fallback-model-chains) configurée en cas d'erreurs de surcharge répétées pour n'importe quel modèle principal, de sorte que cette variable n'affecte pas le basculement vers un modèle de secours |473| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Définissez une valeur non vide quelconque, comme `1`, pour que Claude Code cesse de réessayer en cas d'erreurs de surcharge répétées pour tous les modèles lorsqu'aucun modèle de secours n'est configuré. **La définir sur `0` ou `false` active tout de même ce comportement**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour rétablir le comportement par défaut des nouvelles tentatives. Sans elle, Claude Code cesse de réessayer de cette manière sur les modèles qu'il reconnaît comme des modèles Opus, Fable ou Mythos lorsque vous vous authentifiez avec une clé API ou un [fournisseur tiers](/docs/fr/third-party-integrations) plutôt qu'avec un abonnement Claude. Sur Claude Code v2.1.160 ou ultérieur, Claude Code bascule sur votre [chaîne de modèles de secours](/docs/fr/model-config#fallback-model-chains) configurée en cas d'erreurs de surcharge répétées pour tout modèle principal, de sorte que cette variable n'affecte pas le basculement vers un modèle de secours |

471| `FORCE_AUTOUPDATE_PLUGINS` | Définissez sur `1` pour forcer les mises à jour automatiques des plugins même lorsque le programme de mise à jour automatique principal est désactivé via `DISABLE_AUTOUPDATER` |474| `FORCE_AUTOUPDATE_PLUGINS` | Définissez `1` pour forcer les mises à jour automatiques des plugins même lorsque le programme de mise à jour automatique principal est désactivé via `DISABLE_AUTOUPDATER` |

472| `FORCE_HYPERLINK` | Définissez sur `1` pour activer les hyperliens OSC 8 cliquables lorsque votre terminal les prend en charge mais n'est pas détecté automatiquement, ou sur `0` pour les désactiver. Lorsque la variable n'est pas définie, Claude Code n'active les hyperliens que s'il détecte leur prise en charge par le terminal. Claude Code analyse cette valeur comme un nombre, et non comme un booléen, de sorte qu'une valeur comme `false`, `no` ou `off` active les hyperliens au lieu de les désactiver. Le [badge de PR ou de merge request](/docs/fr/interactive-mode#pr-review-status) du pied de page s'affiche sous forme d'hyperlien même lorsque Claude Code ne peut pas détecter la prise en charge par le terminal, par exemple via SSH. Définissez `0` pour afficher le badge en texte brut |475| `FORCE_HYPERLINK` | Définissez `1` pour activer les hyperliens OSC 8 cliquables lorsque votre terminal les prend en charge sans être détecté automatiquement, ou `0` pour les désactiver. Lorsque la variable n'est pas définie, Claude Code n'active les hyperliens que s'il détecte leur prise en charge par le terminal. Claude Code analyse cette valeur comme un nombre et non comme un booléen, de sorte qu'une valeur comme `false`, `no` ou `off` active les hyperliens au lieu de les désactiver. Le [badge de PR ou de merge request](/docs/fr/interactive-mode#pr-review-status) du pied de page s'affiche sous forme d'hyperlien même lorsque Claude Code ne peut pas détecter la prise en charge par le terminal, par exemple via SSH. Définissez `0` pour afficher le badge en texte brut |

473| `FORCE_PROMPT_CACHING_5M` | Définissez sur `1` pour forcer le TTL de cache de prompt de 5 minutes même lorsque le TTL d'une heure s'appliquerait autrement. Remplace `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` ainsi que les paramètres `promptCacheTtl` et `subagentPromptCacheTtl` |476| `FORCE_PROMPT_CACHING_5M` | Définissez `1` pour forcer le TTL de 5 minutes du cache de prompt même lorsque le TTL d'une heure s'appliquerait autrement. Remplace `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` ainsi que les paramètres `promptCacheTtl` et `subagentPromptCacheTtl` |

474| `HTTP_PROXY` | Spécifie le serveur proxy HTTP pour les connexions réseau |477| `HTTP_PROXY` | Spécifie le serveur proxy HTTP pour les connexions réseau |

475| `HTTPS_PROXY` | Spécifie le serveur proxy HTTPS pour les connexions réseau |478| `HTTPS_PROXY` | Spécifie le serveur proxy HTTPS pour les connexions réseau |

476| `IS_DEMO` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour activer le mode démo : masque votre adresse e-mail et le nom de votre organisation dans l'en-tête et la sortie de `/status`, et ignore l'onboarding. **La définir sur `0` ou `false` active tout de même le mode démo**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour le désactiver. Utile lors de la diffusion en streaming ou de l'enregistrement d'une session |479| `IS_DEMO` | Définissez une valeur non vide quelconque, comme `1`, pour activer le mode démo : masque votre adresse e-mail et le nom de votre organisation dans l'en-tête et dans la sortie de `/status`, et ignore l'onboarding. **La définir sur `0` ou `false` active tout de même le mode démo**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour le désactiver. Utile lors de la diffusion en streaming ou de l'enregistrement d'une session |

477| `MAX_MCP_OUTPUT_TOKENS` | Nombre maximal de tokens autorisés dans les réponses des outils MCP (par défaut : 25000). Claude Code affiche un avertissement lorsque la sortie dépasse 10 000 tokens. Les outils qui déclarent [`anthropic/maxResultSizeChars`](/docs/fr/mcp#raise-the-limit-for-a-specific-tool) utilisent plutôt cette limite en caractères pour le contenu textuel, mais le contenu image de ces outils reste soumis à cette variable. Un résultat textuel réussi de plus de 50 000 caractères provenant d'un outil sans cette annotation est [enregistré dans un fichier](/docs/fr/mcp#mcp-output-limits-and-warnings) quelle que soit cette variable |480| `MAX_MCP_OUTPUT_TOKENS` | Nombre maximal de tokens autorisés dans les réponses des outils MCP (par défaut : 25000). Claude Code affiche un avertissement lorsque la sortie dépasse 10 000 tokens. Les outils qui déclarent [`anthropic/maxResultSizeChars`](/docs/fr/mcp#raise-the-limit-for-a-specific-tool) utilisent plutôt cette limite de caractères pour le contenu textuel, mais le contenu image de ces outils reste soumis à cette variable. Un résultat textuel réussi de plus de 50 000 caractères provenant d'un outil sans cette annotation est [enregistré dans un fichier](/docs/fr/mcp#mcp-output-limits-and-warnings) quelle que soit cette variable |

478| `MAX_STRUCTURED_OUTPUT_RETRIES` | Nombre de tentatives que Claude Code autorise lorsque la réponse du modèle échoue à la validation par rapport au [`--json-schema`](/docs/fr/cli-reference#cli-flags) en mode non interactif avec le flag `-p` ; après ce nombre de tentatives infructueuses sans sortie valide, l'exécution échoue. Le même plafond s'applique lorsque la sortie structurée d'un sous-agent de [workflow](/docs/fr/workflows) échoue à la validation. Par défaut 5, soit une première tentative plus quatre nouvelles tentatives |481| `MAX_STRUCTURED_OUTPUT_RETRIES` | Nombre de tentatives que Claude Code autorise lorsque la réponse du modèle échoue à la validation par rapport au [`--json-schema`](/docs/fr/cli-reference#cli-flags) en mode non interactif avec le flag `-p` ; après ce nombre de tentatives échouées sans sortie valide, l'exécution échoue. La même limite s'applique lorsque la sortie structurée d'un sous-agent de [workflow](/docs/fr/workflows) échoue à la validation. La valeur par défaut est 5, soit une première tentative plus quatre nouvelles tentatives |

479| `MAX_THINKING_TOKENS` | Budget fixe de tokens pour la [réflexion étendue](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code le plafonne à un token de moins que le nombre maximal de tokens de sortie de la requête, et jamais en dessous de 1 024. Consultez `CLAUDE_CODE_MAX_OUTPUT_TOKENS` pour savoir comment cette limite est définie. Lorsque la variable n'est pas définie et que la réflexion est activée, les modèles dotés du [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level) choisissent eux-mêmes leur profondeur de réflexion, et les autres modèles utilisent le plafond. Définissez-la sur `0` pour désactiver la réflexion sur l'API Anthropic, sauf sur Opus 5.5, Sonnet 5.5 et les modèles Fable, dont la réflexion ne peut pas être désactivée. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations), `0` omet plutôt le paramètre `thinking`. Lorsque la réflexion est désactivée sur l'API Anthropic, Claude Code envoie l'effort `high` au lieu d'un niveau supérieur aux modèles dont il sait qu'ils [n'acceptent pas cette combinaison](/docs/fr/errors#effort-isnt-available-with-thinking-turned-off), comme Opus 5. Pour une valeur positive, Claude Code ignore le nombre lui-même sur les modèles à raisonnement adaptatif, sauf lorsque `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` désactive le raisonnement adaptatif |482| `MAX_THINKING_TOKENS` | Budget fixe de tokens pour la [réflexion étendue](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code le plafonne à un token de moins que le nombre maximal de tokens de sortie de la requête, et jamais en dessous de 1 024. Voir `CLAUDE_CODE_MAX_OUTPUT_TOKENS` pour savoir comment cette limite est définie. Lorsque la variable n'est pas définie et que la réflexion est activée, les modèles dotés du [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level) choisissent eux-mêmes leur profondeur de réflexion, et les autres modèles utilisent le plafond. Définissez `0` pour désactiver la réflexion sur l'API Anthropic, sauf sur Opus 5.5, Sonnet 5.5, Haiku 5.5 et les modèles Fable, dont la réflexion ne peut pas être désactivée. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations), `0` omet plutôt le paramètre `thinking`. Lorsque la réflexion est désactivée sur l'API Anthropic, Claude Code envoie l'effort `high` au lieu d'un niveau supérieur aux modèles dont il sait qu'ils [n'acceptent pas cette combinaison](/docs/fr/errors#effort-isnt-available-with-thinking-turned-off), comme Opus 5. Pour une valeur positive, Claude Code ignore le nombre lui-même sur les modèles à raisonnement adaptatif, sauf lorsque `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` désactive le raisonnement adaptatif |

480| `MCP_CLIENT_SECRET` | Secret client OAuth pour les serveurs MCP qui nécessitent des [identifiants préconfigurés](/docs/fr/mcp#use-pre-configured-oauth-credentials). Évite la demande interactive lors de l'ajout d'un serveur avec `--client-secret` |483| `MCP_CLIENT_SECRET` | Secret client OAuth pour les serveurs MCP qui nécessitent des [identifiants préconfigurés](/docs/fr/mcp#use-pre-configured-oauth-credentials). Évite la demande interactive lors de l'ajout d'un serveur avec `--client-secret` |

481| `MCP_CONNECTION_NONBLOCKING` | Contrôle si le démarrage attend la connexion des serveurs MCP avant la première requête. Le démarrage MCP est non bloquant par défaut : les serveurs se connectent en arrière-plan et leurs outils deviennent disponibles au fur et à mesure. Définissez sur `0` pour que Claude Code attende la connexion des serveurs avant la première requête. Les serveurs configurés avec [`alwaysLoad: true`](/docs/fr/mcp#exempt-a-server-from-deferral) font toujours attendre le démarrage, sauf lorsqu'ils sont servis depuis le [cache de découverte](/docs/fr/mcp#server-status-detail), car leurs outils doivent être présents lors de la construction du premier prompt. En mode non interactif (`-p`) sans `--input-format stream-json`, Claude Code attend également les serveurs encore en attente avant le premier tour, quelle que soit cette variable. Lorsque vous passez explicitement [`--mcp-config`](/docs/fr/cli-reference#cli-flags), l'attente bénéficie d'une échéance plus longue ; consultez l'entrée de ce flag pour l'exception relative aux serveurs en cache |484| `MCP_CONNECTION_NONBLOCKING` | Contrôle si le démarrage attend la connexion des serveurs MCP avant la première requête. Le démarrage MCP est non bloquant par défaut : les serveurs se connectent en arrière-plan et leurs outils deviennent disponibles au fur et à mesure. Définissez `0` pour que Claude Code attende la connexion des serveurs avant la première requête. Les serveurs configurés avec [`alwaysLoad: true`](/docs/fr/mcp#exempt-a-server-from-deferral) font tout de même attendre le démarrage, sauf lorsqu'ils sont servis depuis le [cache de découverte](/docs/fr/mcp#server-status-detail), car leurs outils doivent être présents lors de la construction du premier prompt. En mode non interactif (`-p`) sans `--input-format stream-json`, Claude Code attend également les serveurs encore en attente avant le premier tour, quelle que soit cette variable. Lorsque vous passez explicitement [`--mcp-config`](/docs/fr/cli-reference#cli-flags), l'attente dispose d'un délai plus long ; voir l'entrée de ce flag pour l'exception relative aux serveurs en cache |

482| `MCP_CONNECT_TIMEOUT_MS` | Durée, en millisecondes, pendant laquelle le démarrage MCP bloquant attend le lot de connexions avant de figer la liste des outils (par défaut : 5000). S'applique lorsque `MCP_CONNECTION_NONBLOCKING=0` ou pour les serveurs marqués [`alwaysLoad: true`](/docs/fr/mcp#exempt-a-server-from-deferral). Les serveurs encore en attente à l'échéance continuent de se connecter en arrière-plan. Distinct de `MCP_TIMEOUT`, qui limite la tentative de connexion d'un serveur individuel |485| `MCP_CONNECT_TIMEOUT_MS` | Durée, en millisecondes, pendant laquelle le démarrage MCP bloquant attend le lot de connexions avant de capturer la liste des outils (par défaut : 5000). S'applique lorsque `MCP_CONNECTION_NONBLOCKING=0` ou pour les serveurs marqués [`alwaysLoad: true`](/docs/fr/mcp#exempt-a-server-from-deferral). Les serveurs encore en attente à l'échéance continuent de se connecter en arrière-plan. Distinct de `MCP_TIMEOUT`, qui limite la tentative de connexion d'un serveur individuel |

483| `MCP_DISCOVERY_CACHE` | Active ou désactive le [cache de découverte MCP](/docs/fr/mcp#server-status-detail). Avec le cache activé, un serveur HTTP ou SSE distant que vous avez déjà utilisé peut afficher le [statut `cached`](/docs/fr/mcp#server-status-detail), et Claude Code le connecte lors de son premier appel d'outil plutôt qu'au démarrage. Le cache est désactivé par défaut, sauf si un déploiement progressif l'a activé pour votre compte. Définissez sur `1` pour l'activer, ou sur `0` pour le garder désactivé même lorsque le déploiement progressif l'a activé. Avant la v2.1.238, le cache était activé par défaut. Le statut `cached` nécessite Claude Code v2.1.221 ou ultérieur |486| `MCP_DISCOVERY_CACHE` | Active ou désactive le [cache de découverte MCP](/docs/fr/mcp#server-status-detail). Lorsque le cache est activé, un serveur HTTP ou SSE distant que vous avez déjà utilisé peut afficher le [statut `cached`](/docs/fr/mcp#server-status-detail), et Claude Code le connecte lors de son premier appel d'outil plutôt qu'au démarrage. Le cache est désactivé par défaut, sauf si un déploiement progressif l'a activé pour votre compte. Définissez `1` pour l'activer, ou `0` pour le maintenir désactivé même lorsque le déploiement progressif l'a activé. Avant la v2.1.238, le cache était activé par défaut. Le statut `cached` nécessite Claude Code v2.1.221 ou ultérieur |

484| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Âge maximal, en secondes, d'une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) (par défaut : 14400, soit 4 heures). Lors d'un démarrage où l'entrée est plus ancienne, Claude Code la supprime et connecte le serveur au démarrage, comme lorsque le cache est désactivé. Claude Code plafonne la valeur à 7 jours. Avant la v2.1.238, la valeur par défaut était 86400, soit 24 heures, et Claude Code ne plafonnait pas la valeur |487| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Âge maximal, en secondes, d'une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) (par défaut : 14400, soit 4 heures). Lors d'un démarrage où l'entrée est plus ancienne, Claude Code la supprime et connecte le serveur au démarrage, comme lorsque le cache est désactivé. Claude Code plafonne la valeur à 7 jours. Avant la v2.1.238, la valeur par défaut était 86400, soit 24 heures, et Claude Code ne plafonnait pas la valeur |

485| `MCP_DISCOVERY_CACHE_STRIKES` | Lors d'un démarrage où une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) est plus ancienne que `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code l'actualise en arrière-plan. Cette variable définit le nombre d'actualisations consécutives qui peuvent échouer avant que Claude Code supprime l'entrée et connecte plutôt le serveur au démarrage suivant (par défaut : 1). Augmentez-la si votre connexion réseau est parfois interrompue, afin qu'une seule actualisation échouée ne supprime pas l'entrée. Nécessite Claude Code v2.1.238 ou ultérieur |488| `MCP_DISCOVERY_CACHE_STRIKES` | Lors d'un démarrage où une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) est plus ancienne que `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code l'actualise en arrière-plan. Cette variable définit le nombre d'actualisations consécutives pouvant échouer avant que Claude Code supprime l'entrée et connecte plutôt le serveur au démarrage suivant (par défaut : 1). Augmentez-la si votre connexion réseau se coupe occasionnellement, afin qu'une seule actualisation échouée ne supprime pas l'entrée. Nécessite Claude Code v2.1.238 ou ultérieur |

486| `MCP_DISCOVERY_CACHE_TTL_S` | Durée, en secondes, pendant laquelle Claude Code utilise une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) sans l'actualiser (par défaut : 900). Lors d'un démarrage où l'entrée est plus ancienne, Claude Code l'utilise toujours mais l'actualise en arrière-plan. Une fois l'entrée plus ancienne que `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code la supprime. Claude Code plafonne la valeur à `MCP_DISCOVERY_CACHE_MAX_STALE_S`, qui vaut 4 heures par défaut. Avant la v2.1.238, Claude Code ne plafonnait pas la valeur |489| `MCP_DISCOVERY_CACHE_TTL_S` | Nombre de secondes pendant lesquelles Claude Code utilise une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) sans l'actualiser (par défaut : 900). Lors d'un démarrage où l'entrée est plus ancienne, Claude Code l'utilise toujours mais l'actualise en arrière-plan. Une fois l'entrée plus ancienne que `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code la supprime. Claude Code plafonne la valeur à `MCP_DISCOVERY_CACHE_MAX_STALE_S`, qui est de 4 heures par défaut. Avant la v2.1.238, Claude Code ne plafonnait pas la valeur |

487| `MCP_OAUTH_CALLBACK_PORT` | Port fixe pour le callback de redirection OAuth, en alternative à `--callback-port` lors de l'ajout d'un serveur MCP avec des [identifiants préconfigurés](/docs/fr/mcp#use-pre-configured-oauth-credentials) |490| `MCP_OAUTH_CALLBACK_PORT` | Port fixe pour le callback de redirection OAuth, en alternative à `--callback-port` lors de l'ajout d'un serveur MCP avec des [identifiants préconfigurés](/docs/fr/mcp#use-pre-configured-oauth-credentials) |

488| `MCP_PROTOCOL_NEGOTIATION` | Sur le [runtime client MCP v2](/docs/fr/mcp#mcp-client-runtimes) uniquement, indique si Claude Code sonde les serveurs pour la révision 2026-07-28 du protocole MCP. Définissez `auto` pour sonder les serveurs HTTP, les connecteurs claude.ai et les serveurs stdio, ou `legacy` pour n'en sonder aucun. Lorsque la variable n'est pas définie, Claude Code sonde les serveurs décrits dans [Runtimes client MCP](/docs/fr/mcp#mcp-client-runtimes). Toute autre valeur est ignorée avec un avertissement dans le log de débogage. Nécessite Claude Code v2.1.221 ou ultérieur |491| `MCP_PROTOCOL_NEGOTIATION` | Sur le [runtime client MCP v2](/docs/fr/mcp#mcp-client-runtimes) uniquement, indique si Claude Code sonde les serveurs pour la révision 2026-07-28 du protocole MCP. Définissez `auto` pour sonder les serveurs HTTP, les connecteurs claude.ai et les serveurs stdio, ou `legacy` pour n'en sonder aucun. Lorsque la variable n'est pas définie, Claude Code sonde les serveurs décrits dans [Runtimes client MCP](/docs/fr/mcp#mcp-client-runtimes). Toute autre valeur est ignorée avec un avertissement dans le log de débogage. Nécessite Claude Code v2.1.221 ou ultérieur |

489| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP distants (HTTP/SSE) à connecter en parallèle au démarrage (par défaut : 20) |492| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP distants (HTTP/SSE) à connecter en parallèle au démarrage (par défaut : 20) |

490| `MCP_SDK_GENERATION` | Fixe le [runtime client MCP](/docs/fr/mcp#mcp-client-runtimes) avec lequel ce processus se connecte aux serveurs MCP : `v1`, basé sur MCP TypeScript SDK 1.x, ou `v2`, basé sur [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Sans cette variable, Claude Code utilise v2, à partir des versions indiquées dans cette section. Sur Claude Code v2.1.221 ou ultérieur, le runtime v2 vérifie l'émetteur qu'un serveur OAuth MCP renvoie dans sa réponse d'autorisation et fait échouer la connexion avec une erreur commençant par `Issuer mismatch in authorization response` lorsqu'il ne correspond pas. Le runtime v1 n'effectue pas cette vérification. Si vous définissez une valeur non reconnue, Claude Code l'ignore et écrit un avertissement dans le log de débogage. Claude Code lit la valeur une seule fois par processus. Nécessite Claude Code v2.1.218 ou ultérieur |493| `MCP_SDK_GENERATION` | Fixe le [runtime client MCP](/docs/fr/mcp#mcp-client-runtimes) avec lequel ce processus se connecte aux serveurs MCP : `v1`, basé sur le MCP TypeScript SDK 1.x, ou `v2`, basé sur le [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Sans cette variable, Claude Code utilise v2, à partir des versions indiquées dans cette section. Sur Claude Code v2.1.221 ou ultérieur, le runtime v2 vérifie l'émetteur qu'un serveur OAuth MCP renvoie dans sa réponse d'autorisation et fait échouer la connexion avec une erreur commençant par `Issuer mismatch in authorization response` lorsqu'il ne correspond pas. Le runtime v1 n'effectue pas cette vérification. Si vous définissez une valeur non reconnue, Claude Code l'ignore et écrit un avertissement dans le log de débogage. Claude Code lit la valeur une fois par processus. Nécessite Claude Code v2.1.218 ou ultérieur |

491| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP locaux (stdio) à connecter en parallèle au démarrage (par défaut : 3) |494| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP locaux (stdio) à connecter en parallèle au démarrage (par défaut : 3) |

492| `MCP_TIMEOUT` | Délai d'expiration, en millisecondes, du démarrage des serveurs MCP (par défaut : 30000, soit 30 secondes) |495| `MCP_TIMEOUT` | Délai d'expiration, en millisecondes, pour le démarrage des serveurs MCP (par défaut : 30000, soit 30 secondes) |

493| `MCP_TOOL_TIMEOUT` | Délai d'expiration, en millisecondes, de l'exécution des outils MCP (par défaut : 100000000, environ 28 heures). Pour un serveur HTTP, SSE ou connecteur claude.ai, chaque requête expire également après 60 secondes par défaut ; définissez cette variable, ou le `timeout` propre au serveur, au-delà de 60000 pour relever cette limite par requête. Une valeur inférieure raccourcit toujours le délai d'expiration global de l'exécution de l'outil, mais laisse la limite par requête à 60 secondes. Les serveurs stdio et WebSocket n'ont pas de minuteur par requête. Un champ `timeout` propre au serveur dans `.mcp.json` remplace cette valeur pour ce serveur. Un `timeout` propre au serveur d'au moins 1000 définit également la fenêtre d'inactivité minimale des appels d'outils de ce serveur, de sorte que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` ne les interrompt jamais plus tôt ; ce plancher nécessite Claude Code v2.1.203 ou ultérieur. Pour la variable d'environnement, les valeurs inférieures à 1000 sont ramenées à une seconde ; pour le champ propre au serveur, les valeurs inférieures à 1000 sont ignorées |496| `MCP_TOOL_TIMEOUT` | Délai d'expiration, en millisecondes, pour l'exécution des outils MCP (par défaut : 100000000, soit environ 28 heures). Pour un serveur HTTP, SSE ou un connecteur claude.ai, chaque requête expire également après 60 secondes par défaut ; définissez cette variable, ou le `timeout` par serveur, au-dessus de 60000 pour relever cette limite par requête. Une valeur inférieure raccourcit tout de même le délai d'expiration global de l'exécution des outils, mais laisse la limite par requête à 60 secondes. Les serveurs stdio et WebSocket n'ont pas de minuteur par requête. Un champ `timeout` par serveur dans `.mcp.json` remplace cette valeur pour ce serveur. Un `timeout` par serveur d'au moins 1000 définit également la fenêtre d'inactivité minimale pour les appels d'outils de ce serveur, de sorte que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` ne les interrompt jamais plus tôt ; ce plancher nécessite Claude Code v2.1.203 ou ultérieur. Pour la variable d'environnement, les valeurs inférieures à 1000 sont ramenées à une seconde ; pour le champ par serveur, les valeurs inférieures à 1000 sont ignorées |

494| `NO_PROXY` | Liste des domaines et adresses IP vers lesquels les requêtes sont envoyées directement, sans passer par le proxy |497| `NO_PROXY` | Liste des domaines et adresses IP vers lesquels les requêtes sont envoyées directement, en contournant le proxy |

495| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard du SDK OpenTelemetry sur la longueur des valeurs d'attributs. Claude Code plafonne les attributs de télémétrie porteurs de contenu à la plus petite valeur entre celle-ci et `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, afin que le marqueur de troncature reste dans la limite du SDK. Claude Code lit de la même manière les variantes `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` et `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`, et la plus petite valeur définie s'applique à tous les signaux. Nécessite Claude Code v2.1.214 ou ultérieur. Consultez [Surveillance](/docs/fr/monitoring-usage#common-configuration-variables) |498| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard du SDK OpenTelemetry sur la longueur des valeurs d'attributs. Claude Code plafonne les attributs de télémétrie porteurs de contenu à la plus petite valeur entre celle-ci et `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, afin que le marqueur de troncature reste dans la limite du SDK. Claude Code lit de la même manière les variantes `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` et `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`, et la plus petite valeur définie s'applique à tous les signaux. Nécessite Claude Code v2.1.214 ou ultérieur. Voir [Surveillance](/docs/fr/monitoring-usage#common-configuration-variables) |

496| `OTEL_LOG_ASSISTANT_RESPONSES` | Définissez sur `1` pour inclure le texte de réponse du modèle dans les événements de log OpenTelemetry `assistant_response`. Lorsque la variable n'est pas définie, Claude Code utilise plutôt la valeur de `OTEL_LOG_USER_PROMPTS`. Définissez-la sur `0` pour conserver les réponses masquées même lorsque `OTEL_LOG_USER_PROMPTS` est défini. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Nécessite Claude Code v2.1.193 ou ultérieur. Consultez [Surveillance](/docs/fr/monitoring-usage#assistant-response-event) |499| `OTEL_LOG_ASSISTANT_RESPONSES` | Définissez `1` pour inclure le texte de la réponse du modèle dans les événements de log OpenTelemetry `assistant_response`. Lorsque la variable n'est pas définie, Claude Code utilise plutôt la valeur de `OTEL_LOG_USER_PROMPTS`. Définissez `0` pour conserver les réponses masquées même lorsque `OTEL_LOG_USER_PROMPTS` est défini. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Nécessite Claude Code v2.1.193 ou ultérieur. Voir [Surveillance](/docs/fr/monitoring-usage#assistant-response-event) |

497| `OTEL_LOG_MANAGED_SETTINGS` | Définissez sur `1` pour ajouter les paramètres gérés masqués, ainsi qu'un condensé SHA-256 des paramètres avant masquage, aux événements de log OpenTelemetry `managed_settings_resolved`. Désactivé par défaut. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés ; une valeur dans les paramètres de projet ou locaux ne l'active pas. Nécessite Claude Code v2.1.274 ou ultérieur. Consultez [Surveillance](/docs/fr/monitoring-usage#managed-settings-resolved-event) |500| `OTEL_LOG_MANAGED_SETTINGS` | Définissez `1` pour ajouter les paramètres gérés masqués, ainsi qu'un condensé SHA-256 des paramètres avant masquage, aux événements de log OpenTelemetry `managed_settings_resolved`. Désactivé par défaut. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés ; une valeur dans les paramètres de projet ou locaux ne l'active pas. Nécessite Claude Code v2.1.274 ou ultérieur. Voir [Surveillance](/docs/fr/monitoring-usage#managed-settings-resolved-event) |

498| `OTEL_LOG_RAW_API_BODIES` | Émet le JSON des requêtes et réponses de l'API Messages d'Anthropic sous forme d'événements de log `api_request_body` / `api_response_body`. Définissez sur `1` pour des corps intégrés tronqués à la limite de contenu, ou sur `file:<dir>` pour écrire les corps non tronqués sur le disque et émettre plutôt un chemin `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configure la limite de contenu, 60 Ko par défaut. Désactivé par défaut ; les corps incluent l'intégralité de l'historique de la conversation. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Consultez [Surveillance](/docs/fr/monitoring-usage#api-request-body-event) |501| `OTEL_LOG_RAW_API_BODIES` | Émet le JSON des requêtes et réponses de l'API Anthropic Messages sous forme d'événements de log `api_request_body` / `api_response_body`. Définissez `1` pour des corps intégrés tronqués à la limite de contenu, ou `file:<dir>` pour écrire les corps non tronqués sur le disque et émettre à la place un chemin `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configure la limite de contenu, de 60 Ko par défaut. Désactivé par défaut ; les corps incluent l'intégralité de l'historique de la conversation. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Voir [Surveillance](/docs/fr/monitoring-usage#api-request-body-event) |

499| `OTEL_LOG_TOOL_CONTENT` | Définissez sur `1` pour inclure le contenu des outils dans l'événement de span OpenTelemetry `tool.output`. Les attributs de span transportent le contenu des outils selon [leurs propres conditions](/docs/fr/monitoring-usage#new-context-gates). Nécessite le [traçage](/docs/fr/monitoring-usage#traces-beta). Désactivé par défaut pour protéger les données sensibles. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Consultez [Surveillance](/docs/fr/monitoring-usage#tool-output-span-event) |502| `OTEL_LOG_TOOL_CONTENT` | Définissez `1` pour inclure le contenu des outils dans l'événement de span OpenTelemetry `tool.output`. Les attributs de span transportent le contenu des outils selon [leurs propres conditions](/docs/fr/monitoring-usage#new-context-gates). Nécessite le [traçage](/docs/fr/monitoring-usage#traces-beta). Désactivé par défaut pour protéger les données sensibles. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Voir [Surveillance](/docs/fr/monitoring-usage#tool-output-span-event) |

500| `OTEL_LOG_TOOL_DETAILS` | Définissez sur `1` pour inclure les arguments d'entrée des outils ; les noms des serveurs MCP ; les noms des workflows créés par l'utilisateur ; les chaînes d'erreur brutes en cas d'échec d'un outil ; la `category` de refus dans les événements `api_refusal` ; les noms réels des agents, skills, plugins et serveurs MCP dans les [métriques de coûts et de tokens](/docs/fr/monitoring-usage#cost-counter) ; et d'autres détails sur les outils dans les métriques, traces et logs OpenTelemetry. Désactivé par défaut pour protéger les informations personnelles. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Consultez [Surveillance](/docs/fr/monitoring-usage) |503| `OTEL_LOG_TOOL_DETAILS` | Définissez `1` pour inclure les arguments d'entrée des outils ; les noms des serveurs MCP ; les noms des workflows créés par l'utilisateur ; les chaînes d'erreur brutes en cas d'échec des outils ; la `category` de refus sur les événements `api_refusal` ; les noms réels des agents, skills, plugins et serveurs MCP dans les [métriques de coût et de tokens](/docs/fr/monitoring-usage#cost-counter) ; et d'autres détails sur les outils dans les métriques, traces et logs OpenTelemetry. Désactivé par défaut pour protéger les données personnelles (PII). Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Voir [Surveillance](/docs/fr/monitoring-usage) |

501| `OTEL_LOG_USER_PROMPTS` | Définissez sur `1` pour inclure le texte des prompts utilisateur dans les traces et logs OpenTelemetry. Désactivé par défaut (les prompts sont masqués). Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Consultez [Surveillance](/docs/fr/monitoring-usage) |504| `OTEL_LOG_USER_PROMPTS` | Définissez `1` pour inclure le texte des prompts utilisateur dans les traces et logs OpenTelemetry. Désactivé par défaut (les prompts sont masqués). Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Voir [Surveillance](/docs/fr/monitoring-usage) |

502| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Définissez sur `false` pour exclure l'UUID du compte des attributs des métriques (par défaut : inclus). Consultez [Surveillance](/docs/fr/monitoring-usage) |505| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Définissez `false` pour exclure l'UUID du compte des attributs de métriques (par défaut : inclus). Voir [Surveillance](/docs/fr/monitoring-usage) |

503| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Définissez sur `true` pour inclure le point d'entrée de la session dans les attributs des métriques (par défaut : exclu). Ajoutée dans la v2.1.152. Consultez [Surveillance](/docs/fr/monitoring-usage) |506| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Définissez `true` pour inclure le point d'entrée de la session dans les attributs de métriques (par défaut : exclu). Ajoutée dans la v2.1.152. Voir [Surveillance](/docs/fr/monitoring-usage) |

504| `OTEL_METRICS_INCLUDE_REPOSITORY` | Définissez sur `true` pour étiqueter les métriques et événements OpenTelemetry avec des attributs `vcs.*` identifiant le dépôt de la session (par défaut : exclus). Nécessite Claude Code v2.1.269 ou ultérieur. Consultez [Attributs du dépôt](/docs/fr/monitoring-usage#repository-attributes) |507| `OTEL_METRICS_INCLUDE_REPOSITORY` | Définissez `true` pour marquer les métriques et événements OpenTelemetry avec des attributs `vcs.*` identifiant le dépôt de la session (par défaut : exclus). Nécessite Claude Code v2.1.269 ou ultérieur. Voir [Attributs de dépôt](/docs/fr/monitoring-usage#repository-attributes) |

505| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Depuis la v2.1.161, Claude Code associe les clés de `OTEL_RESOURCE_ATTRIBUTES` aux étiquettes des points de données des métriques. Définissez sur `false` pour les exclure (par défaut : incluses). Consultez [Surveillance](/docs/fr/monitoring-usage#multi-team-organization-support) |508| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Depuis la v2.1.161, Claude Code associe les clés de `OTEL_RESOURCE_ATTRIBUTES` aux libellés des points de données des métriques. Définissez `false` pour les exclure (par défaut : incluses). Voir [Surveillance](/docs/fr/monitoring-usage#multi-team-organization-support) |

506| `OTEL_METRICS_INCLUDE_SESSION_ID` | Définissez sur `false` pour exclure l'identifiant de session des attributs des métriques (par défaut : inclus). Consultez [Surveillance](/docs/fr/monitoring-usage) |509| `OTEL_METRICS_INCLUDE_SESSION_ID` | Définissez `false` pour exclure l'identifiant de session des attributs de métriques (par défaut : inclus). Voir [Surveillance](/docs/fr/monitoring-usage) |

507| `OTEL_METRICS_INCLUDE_VERSION` | Définissez sur `true` pour inclure la version de Claude Code dans les attributs des métriques (par défaut : exclue). Consultez [Surveillance](/docs/fr/monitoring-usage) |510| `OTEL_METRICS_INCLUDE_VERSION` | Définissez `true` pour inclure la version de Claude Code dans les attributs de métriques (par défaut : exclue). Voir [Surveillance](/docs/fr/monitoring-usage) |

508| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Remplace le budget de caractères des métadonnées de skills présentées à l'[outil Skill](/docs/fr/skills#control-who-invokes-a-skill). Le budget s'ajuste dynamiquement à 1 % de la fenêtre de contexte, avec une valeur de secours de 8 000 caractères. Ancien nom conservé pour la rétrocompatibilité |511| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Remplace le budget de caractères pour les métadonnées des skills présentées à l'[outil Skill](/docs/fr/skills#control-who-invokes-a-skill). Le budget s'ajuste dynamiquement à 1 % de la fenêtre de contexte, avec une valeur de secours de 8 000 caractères. Ancien nom conservé pour la rétrocompatibilité |

509| `TASK_MAX_OUTPUT_LENGTH` | Supprimée dans la v2.1.277 et désormais sans effet, tout comme l'outil `TaskOutput` qu'elle dimensionnait. Définissait auparavant le nombre maximal de caractères de la sortie d'une [tâche en arrière-plan](/docs/fr/tools-reference#background-commands) conservés par l'outil `TaskOutput`. Claude lit désormais le fichier de sortie d'une tâche en arrière-plan avec `Read` |512| `TASK_MAX_OUTPUT_LENGTH` | Supprimée dans la v2.1.277 et désormais sans effet, tout comme l'outil `TaskOutput` dont elle définissait la taille. Définissait auparavant le nombre maximal de caractères de la sortie d'une [tâche en arrière-plan](/docs/fr/tools-reference#background-commands) conservés par l'outil `TaskOutput`. Claude lit désormais le fichier de sortie d'une tâche en arrière-plan avec `Read` |

510| `USE_BUILTIN_RIPGREP` | Définissez sur `0` pour utiliser le `rg` installé sur le système au lieu du `rg` inclus avec Claude Code |513| `USE_BUILTIN_RIPGREP` | Définissez `0` pour utiliser le `rg` installé sur le système au lieu du `rg` inclus avec Claude Code |

511| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Remplace la région de Claude 3.5 Haiku lors de l'utilisation de Google Cloud's Agent Platform |514| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Remplace la région pour Claude 3.5 Haiku lors de l'utilisation de Google Cloud's Agent Platform |

512| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Remplace la région de Claude 3.5 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |515| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Remplace la région pour Claude 3.5 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |

513| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Remplace la région de Claude 3.7 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |516| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Remplace la région pour Claude 3.7 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |

514| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Remplace la région de Claude 4.0 Opus lors de l'utilisation de Google Cloud's Agent Platform |517| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Remplace la région pour Claude 4.0 Opus lors de l'utilisation de Google Cloud's Agent Platform |

515| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Remplace la région de Claude 4.0 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |518| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Remplace la région pour Claude 4.0 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |

516| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Remplace la région de Claude 4.1 Opus lors de l'utilisation de Google Cloud's Agent Platform |519| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Remplace la région pour Claude 4.1 Opus lors de l'utilisation de Google Cloud's Agent Platform |

517| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Remplace la région de Claude Opus 4.5 lors de l'utilisation de Google Cloud's Agent Platform |520| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Remplace la région pour Claude Opus 4.5 lors de l'utilisation de Google Cloud's Agent Platform |

518| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Remplace la région de Claude Sonnet 4.5 lors de l'utilisation de Google Cloud's Agent Platform |521| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Remplace la région pour Claude Sonnet 4.5 lors de l'utilisation de Google Cloud's Agent Platform |

519| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Remplace la région de Claude Opus 4.6 lors de l'utilisation de Google Cloud's Agent Platform |522| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Remplace la région pour Claude Opus 4.6 lors de l'utilisation de Google Cloud's Agent Platform |

520| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Remplace la région de Claude Sonnet 4.6 lors de l'utilisation de Google Cloud's Agent Platform |523| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Remplace la région pour Claude Sonnet 4.6 lors de l'utilisation de Google Cloud's Agent Platform |

521| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Remplace la région de Claude Opus 4.7 lors de l'utilisation de Google Cloud's Agent Platform |524| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Remplace la région pour Claude Opus 4.7 lors de l'utilisation de Google Cloud's Agent Platform |

522| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Remplace la région de Claude Opus 4.8 lors de l'utilisation de Google Cloud's Agent Platform |525| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Remplace la région pour Claude Opus 4.8 lors de l'utilisation de Google Cloud's Agent Platform |

523| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Remplace la région de Claude Opus 5.5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.280 |526| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Remplace la région pour Claude Opus 5.5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.280 |

524| `VERTEX_REGION_CLAUDE_5_5_SONNET` | Remplace la région de Claude Sonnet 5.5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.284 |527| `VERTEX_REGION_CLAUDE_5_5_SONNET` | Remplace la région pour Claude Sonnet 5.5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.284 |

525| `VERTEX_REGION_CLAUDE_5_OPUS` | Remplace la région de Claude Opus 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.219 |528| `VERTEX_REGION_CLAUDE_5_OPUS` | Remplace la région pour Claude Opus 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.219 |

526| `VERTEX_REGION_CLAUDE_5_SONNET` | Remplace la région de Claude Sonnet 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.197 |529| `VERTEX_REGION_CLAUDE_5_SONNET` | Remplace la région pour Claude Sonnet 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.197 |

527| `VERTEX_REGION_CLAUDE_FABLE_5` | Remplace la région de Claude Fable 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.170 |530| `VERTEX_REGION_CLAUDE_FABLE_5` | Remplace la région pour Claude Fable 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.170 |

528| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Remplace la région de Claude Fable 5.1 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.257 |531| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Remplace la région pour Claude Fable 5.1 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.257 |

529| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Remplace la région de Claude Haiku 4.5 lors de l'utilisation de Google Cloud's Agent Platform |532| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Remplace la région pour Claude Haiku 4.5 lors de l'utilisation de Google Cloud's Agent Platform |

530 533| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Remplace la région pour Claude Haiku 5.5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.293 |

531Les variables standard des exportateurs OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` et leurs variantes propres à chaque signal) sont également prises en charge. Consultez [Surveillance](/docs/fr/monitoring-usage) pour les détails de configuration.534 

535Les variables standard des exportateurs OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` et les variantes propres à chaque signal) sont également prises en charge. Voir [Surveillance](/docs/fr/monitoring-usage) pour les détails de configuration.

532 536 

533Définissez `CLAUDE_CODE_ENABLE_TELEMETRY` et les variables OpenTelemetry qui activent l'export, choisissent sa destination ou capturent du contenu dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Claude Code [les ignore dans les paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. `OTEL_RESOURCE_ATTRIBUTES` et les variables d'intervalle d'export, de délai d'expiration et de compression, comme `OTEL_METRIC_EXPORT_INTERVAL`, s'appliquent toujours depuis les paramètres de projet et locaux.537Définissez `CLAUDE_CODE_ENABLE_TELEMETRY` et les variables OpenTelemetry qui activent l'export, choisissent sa destination ou capturent du contenu dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Claude Code [les ignore dans les paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. `OTEL_RESOURCE_ATTRIBUTES` et les variables d'intervalle d'export, de délai d'expiration et de compression, comme `OTEL_METRIC_EXPORT_INTERVAL`, s'appliquent toujours depuis les paramètres de projet et locaux.

534 538 

errors.md +4 −5

Details

130| `unable to get local issuer certificate` | [Réseau](#ssl-certificate-errors) |130| `unable to get local issuer certificate` | [Réseau](#ssl-certificate-errors) |

131| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Réseau](#host-not-allowed-in-a-cloud-session) |131| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Réseau](#host-not-allowed-in-a-cloud-session) |

132| `proxy refused the connection` | [Réseau](#the-proxy-refused-the-connection) |132| `proxy refused the connection` | [Réseau](#the-proxy-refused-the-connection) |

133| `403` with `This GraphQL query is not enabled for this session` in a cloud session | [Proxy GitHub](/docs/fr/cloud-environments#github-proxy) |133| `403` avec `GitHub GraphQL is not available from Claude Code sessions` dans une session cloud | [Proxy GitHub](/docs/fr/cloud-environments#github-proxy) |

134| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [Réseau](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |134| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [Réseau](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |

135| `Couldn't reconnect to your Remote Control session` | [Réseau](#couldnt-reconnect-to-your-remote-control-session) |135| `Couldn't reconnect to your Remote Control session` | [Réseau](#couldnt-reconnect-to-your-remote-control-session) |

136| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Réseau](#sessions-ended-while-this-machine-was-offline) |136| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Réseau](#sessions-ended-while-this-machine-was-offline) |


197| `Cloud sessions cannot be created from a --restricted session` | [Erreurs de ligne de commande](#cloud-sessions-cannot-be-created-from-a-restricted-session) |197| `Cloud sessions cannot be created from a --restricted session` | [Erreurs de ligne de commande](#cloud-sessions-cannot-be-created-from-a-restricted-session) |

198| `Cloud sessions are disabled by your organization's policy` | [Erreurs de ligne de commande](#cloud-sessions-are-disabled-by-your-organizations-policy) |198| `Cloud sessions are disabled by your organization's policy` | [Erreurs de ligne de commande](#cloud-sessions-are-disabled-by-your-organizations-policy) |

199| `Couldn't verify your organization's policy for cloud sessions` | [Erreurs de ligne de commande](#cloud-sessions-are-disabled-by-your-organizations-policy) |199| `Couldn't verify your organization's policy for cloud sessions` | [Erreurs de ligne de commande](#cloud-sessions-are-disabled-by-your-organizations-policy) |

200| `Cloud sessions need a claude.ai sign-in` | [Impossible d'obtenir l'UUID de l'organisation](/docs/fr/claude-code-on-the-web#unable-to-get-organization-uuid) |

200| `Error: --json-schema is not a valid JSON Schema` | [Erreurs de ligne de commande](#the-json-schema-value-is-not-a-valid-json-schema) |201| `Error: --json-schema is not a valid JSON Schema` | [Erreurs de ligne de commande](#the-json-schema-value-is-not-a-valid-json-schema) |

201| `Error: Invalid --agents configuration:` | [Erreurs de ligne de commande](#invalid-agents-configuration) |202| `Error: Invalid --agents configuration:` | [Erreurs de ligne de commande](#invalid-agents-configuration) |

202| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Erreurs de ligne de commande](#invalid-agents-configuration) |203| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Erreurs de ligne de commande](#invalid-agents-configuration) |


387* Une connexion que Claude Code détecte comme ayant été interrompue par votre ordinateur qui s'endort au milieu d'une requête. Claude Code la compte comme une connexion interrompue selon les règles ci-dessus ; une fois que l'étiquette de tentative nomme la raison spécifique, elle lit `Connection lost while your computer was asleep`, et si le tour se termine après que Claude a terminé sa réflexion mais avant un texte ou un appel d'outil, le message lit `Your computer went to sleep before a response was produced`.388* Une connexion que Claude Code détecte comme ayant été interrompue par votre ordinateur qui s'endort au milieu d'une requête. Claude Code la compte comme une connexion interrompue selon les règles ci-dessus ; une fois que l'étiquette de tentative nomme la raison spécifique, elle lit `Connection lost while your computer was asleep`, et si le tour se termine après que Claude a terminé sa réflexion mais avant un texte ou un appel d'outil, le message lit `Your computer went to sleep before a response was produced`.

388* Un flux de réponse bloqué, lorsque les en-têtes de réponse sont arrivés mais aucune partie de la réponse de Claude n'est arrivée, ou lorsque Claude a terminé sa réflexion mais n'a pas commencé un texte ou un appel d'outil : Claude Code abandonne la connexion bloquée et renvoie la requête au maximum une fois, en dehors du budget de 10 tentatives ci-dessus. Si la réponse se bloque une deuxième fois après que Claude a terminé sa réflexion mais avant un texte ou un appel d'outil, Claude Code termine le tour avec `The response stalled before a response was produced`.389* Un flux de réponse bloqué, lorsque les en-têtes de réponse sont arrivés mais aucune partie de la réponse de Claude n'est arrivée, ou lorsque Claude a terminé sa réflexion mais n'a pas commencé un texte ou un appel d'outil : Claude Code abandonne la connexion bloquée et renvoie la requête au maximum une fois, en dehors du budget de 10 tentatives ci-dessus. Si la réponse se bloque une deuxième fois après que Claude a terminé sa réflexion mais avant un texte ou un appel d'outil, Claude Code termine le tour avec `The response stalled before a response was produced`.

389* Une requête en streaming à laquelle l'API ne répond jamais avec des en-têtes de réponse, sur une connexion où le [délai de premier octet s'exécute](/docs/fr/network-config#streaming-idle-watchdogs) : Claude Code l'abandonne à la date limite et la renvoie au maximum une fois par requête de modèle, dans le budget de tentatives, puis termine le tour avec [No response from API](#no-response-from-api) si cette tentative reste sans réponse aussi. Sur d'autres connexions, la requête attend `API_TIMEOUT_MS`. Lorsque vous définissez `CLAUDE_CODE_RETRY_WATCHDOG`, le plafond d'une tentative ne s'applique pas.390* Une requête en streaming à laquelle l'API ne répond jamais avec des en-têtes de réponse, sur une connexion où le [délai de premier octet s'exécute](/docs/fr/network-config#streaming-idle-watchdogs) : Claude Code l'abandonne à la date limite et la renvoie au maximum une fois par requête de modèle, dans le budget de tentatives, puis termine le tour avec [No response from API](#no-response-from-api) si cette tentative reste sans réponse aussi. Sur d'autres connexions, la requête attend `API_TIMEOUT_MS`. Lorsque vous définissez `CLAUDE_CODE_RETRY_WATCHDOG`, le plafond d'une tentative ne s'applique pas.

391* Une réponse en streaming que le filtre de contenu de sortie de l'API arrête avant que Claude n'ait terminé sa réflexion ou commencé un texte ou un appel d'outil. Claude Code renvoie la requête une fois, dans le budget de tentatives, et affiche [Output blocked by content filtering policy](#output-blocked-by-content-filtering-policy) si le filtre arrête également la deuxième réponse.

390* Les throttles 429 temporaires, mais pas le `429` de limite de dépenses d'une passerelle, qui n'est pas un throttle ; voir [Spend limit reached](#spend-limit-reached).392* Les throttles 429 temporaires, mais pas le `429` de limite de dépenses d'une passerelle, qui n'est pas un throttle ; voir [Spend limit reached](#spend-limit-reached).

391 * Lorsque vous êtes connecté avec un abonnement claude.ai, cela inclut les throttles 429 qui ne portent pas les en-têtes de quota de votre plan. Avant v2.1.199, Claude Code ne réessayait ces throttles que pour les connexions par clé API et Enterprise.393 * Lorsque vous êtes connecté avec un abonnement claude.ai, cela inclut les throttles 429 qui ne portent pas les en-têtes de quota de votre plan. Avant v2.1.199, Claude Code ne réessayait ces throttles que pour les connexions par clé API et Enterprise.

392* Une requête rejetée parce que l'entrée plus `max_tokens` dépasse la limite de contexte. La renvoyer inchangée échouerait de la même manière, donc Claude Code réessaie avec un `max_tokens` réduit, et arrête de réessayer et compacte à la place dans deux cas :394* Une requête rejetée parce que l'entrée plus `max_tokens` dépasse la limite de contexte. La renvoyer inchangée échouerait de la même manière, donc Claude Code réessaie avec un `max_tokens` réduit, et arrête de réessayer et compacte à la place dans deux cas :


405* Une [réponse en streaming Amazon Bedrock avec un type de contenu inattendu](#bedrock-streaming-response-has-an-unexpected-content-type), parce que la passerelle ou le proxy réécrivant la réponse réécrirait la nouvelle tentative de la même manière. Nécessite Claude Code v2.1.208 ou ultérieur.407* Une [réponse en streaming Amazon Bedrock avec un type de contenu inattendu](#bedrock-streaming-response-has-an-unexpected-content-type), parce que la passerelle ou le proxy réécrivant la réponse réécrirait la nouvelle tentative de la même manière. Nécessite Claude Code v2.1.208 ou ultérieur.

406* Une nouvelle tentative sans streaming d'une requête en streaming défaillante qui obtient un statut de succès mais [aucun message API Claude dans le corps](#api-returned-an-empty-or-malformed-response). Claude Code termine le tour avec cette erreur.408* Une nouvelle tentative sans streaming d'une requête en streaming défaillante qui obtient un statut de succès mais [aucun message API Claude dans le corps](#api-returned-an-empty-or-malformed-response). Claude Code termine le tour avec cette erreur.

407* Une requête que la vérification de politique de votre organisation a refusée, qui apparaît comme une ligne `API Error:` portant le message de refus. Les administrateurs de votre organisation configurent la vérification avec [Inference hooks](https://platform.claude.com/docs/en/manage-claude/inference-hooks), une fonctionnalité Claude Enterprise, et le message se termine par les instructions qu'ils ont configurées, ou par défaut vous dit de les contacter. Claude Code ne renvoie pas la requête refusée au même modèle ou à un [modèle de secours](/docs/fr/model-config#fallback-model-chains), parce que le refus concerne le contenu de la requête plutôt que le modèle. Avant v2.1.239, Claude Code pouvait renvoyer une requête refusée, sans streaming ou sur un modèle de secours configuré, avant de vous afficher le refus.409* Une requête que la vérification de politique de votre organisation a refusée, qui apparaît comme une ligne `API Error:` portant le message de refus. Les administrateurs de votre organisation configurent la vérification avec [Inference hooks](https://platform.claude.com/docs/en/manage-claude/inference-hooks), une fonctionnalité Claude Enterprise, et le message se termine par les instructions qu'ils ont configurées, ou par défaut vous dit de les contacter. Claude Code ne renvoie pas la requête refusée au même modèle ou à un [modèle de secours](/docs/fr/model-config#fallback-model-chains), parce que le refus concerne le contenu de la requête plutôt que le modèle. Avant v2.1.239, Claude Code pouvait renvoyer une requête refusée, sans streaming ou sur un modèle de secours configuré, avant de vous afficher le refus.

408* Une réponse que le filtre de contenu de sortie de l'API a bloquée. Claude Code affiche immédiatement [Output blocked by content filtering policy](#output-blocked-by-content-filtering-policy) et ne réessaie pas ni ne renvoie cette requête.

409 410 

410<h3 id="what-you-see-while-claude-code-retries-or-waits">411<h3 id="what-you-see-while-claude-code-retries-or-waits">

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


2299 2300 

2300**Que faire :**2301**Que faire :**

2301 2302 

2302* Redimensionnez l'image avant de la coller. L'API accepte les images jusqu'à 8 000 pixels sur le côté le plus long pour une seule image, ou 2 000 pixels quand de nombreuses images sont en contexte.2303* Redimensionnez l'image avant de la coller. L'API accepte les images jusqu'à 8 000 pixels sur le côté le plus long pour une seule image, ou 3 000 pixels quand plus de 20 images sont en contexte.

2303* Prenez une capture d'écran plus serrée de la région pertinente au lieu de l'écran complet2304* Prenez une capture d'écran plus serrée de la région pertinente au lieu de l'écran complet

2304 2305 

2305<h3 id="unable-to-resize-image">2306<h3 id="unable-to-resize-image">


2905API Error: Output blocked by content filtering policy2906API Error: Output blocked by content filtering policy

2906```2907```

2907 2908 

2908Claude Code affiche l'erreur dès que le blocage arrive et termine la requête à ce moment-là. Il ne réessaie pas la requête, ne la renvoie pas sans streaming et ne bascule pas vers un [modèle de secours](/docs/fr/model-config#fallback-model-chains). Avant v2.1.285, Claude Code pouvait renvoyer et réessayer une requête bloquée, parfois pendant plusieurs minutes, avant de vous afficher l'erreur.

2909 

2910**Que faire :**2909**Que faire :**

2911 2910 

2912* Reformulez votre dernier message ou adoptez une approche différente2911* Reformulez votre dernier message ou adoptez une approche différente

fast-mode.md +1 −1

Details

88 88 

89La tarification du mode rapide est forfaitaire sur toute la fenêtre de contexte de 1 M de jetons. Pour le taux Opus standard à comparer, consultez la [référence de tarification Claude](https://platform.claude.com/docs/en/about-claude/pricing).89La tarification du mode rapide est forfaitaire sur toute la fenêtre de contexte de 1 M de jetons. Pour le taux Opus standard à comparer, consultez la [référence de tarification Claude](https://platform.claude.com/docs/en/about-claude/pricing).

90 90 

91La première fois que vous activez le mode rapide dans une conversation, vous payez le prix complet du jeton d'entrée non mis en cache du mode rapide pour tout le contexte de la conversation. Plus vous êtes avancé dans une conversation, plus cela coûte cher, donc activer le mode rapide dès le départ est moins cher. Le coût s'applique une fois par conversation, donc désactiver le mode rapide et le réactiver plus tard ne le répète pas. Pour le mécanisme, consultez [comment le mode rapide interagit avec le cache de prompt](/docs/fr/prompt-caching#turning-on-fast-mode).91La première fois que vous activez le mode rapide dans une conversation, vous payez le prix complet du token d'entrée non mis en cache du mode rapide pour tout le contexte de la conversation. Plus vous êtes avancé dans une conversation, plus cela coûte cher, donc activer le mode rapide dès le départ est moins cher. Le coût s'applique une fois par conversation, donc désactiver le mode rapide et le réactiver plus tard ne le répète pas. Pour le mécanisme, consultez [comment le mode rapide interagit avec le cache de prompt](/docs/fr/prompt-caching#turning-on-fast-mode).

92 92 

93<h3 id="see-where-fast-mode-spend-appears">93<h3 id="see-where-fast-mode-spend-appears">

94 Voir où apparaît la dépense du mode rapide94 Voir où apparaît la dépense du mode rapide

Details

220</table>220</table>

221 221 

222<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Sur Google Cloud's Agent Platform, la recherche web est disponible pour les modèles Claude 4 et versions ultérieures.<br />222<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Sur Google Cloud's Agent Platform, la recherche web est disponible pour les modèles Claude 4 et versions ultérieures.<br />

223<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Sur ces fournisseurs, le mode auto prend en charge uniquement Claude Sonnet 5, Opus 4.7 ou versions ultérieures, et les modèles Fable. Consultez [Configuration du mode Auto](/docs/fr/auto-mode-config). Pour le mode de permission qu'une session sur ces fournisseurs démarre, consultez [Quel mode une session démarre](/docs/fr/permission-modes#which-mode-a-session-starts-in). Dans les versions v2.1.158 à v2.1.206, le mode auto sur ces fournisseurs nécessitait également de définir `CLAUDE_CODE_ENABLE_AUTO_MODE=1` ; v2.1.207 a supprimé cette exigence.<br />223<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Sur ces fournisseurs, le mode auto prend en charge uniquement Claude Sonnet 5 ou version ultérieure, Opus 4.7 ou version ultérieure, Haiku 5.5 et les modèles Fable. Consultez [Configuration du mode Auto](/docs/fr/auto-mode-config). Pour le mode de permission qu'une session sur ces fournisseurs démarre, consultez [Quel mode une session démarre](/docs/fr/permission-modes#which-mode-a-session-starts-in). Dans les versions v2.1.158 à v2.1.206, le mode auto sur ces fournisseurs nécessitait également de définir `CLAUDE_CODE_ENABLE_AUTO_MODE=1` ; v2.1.207 a supprimé cette exigence.<br />

224<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Soumis à votre accord avec le fournisseur de cloud.<br />224<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Soumis à votre accord avec le fournisseur de cloud.<br />

225<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Tableau de bord et API uniquement. Les [métriques de contribution](/docs/fr/analytics#enable-contribution-metrics) nécessitent une organisation Claude.ai Team ou Enterprise.<br />225<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Tableau de bord et API uniquement. Les [métriques de contribution](/docs/fr/analytics#enable-contribution-metrics) nécessitent une organisation Claude.ai Team ou Enterprise.<br />

226<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Nécessite Claude Code v2.1.224 ou version ultérieure sur macOS et Linux, y compris Linux dans WSL 2. Sur Windows natif, nécessite Claude Code v2.1.234 ou version ultérieure. Avec l'authentification par clé API, la messagerie est limitée à la même machine uniquement. Sur Amazon Bedrock, Claude Platform sur AWS, Google Cloud's Agent Platform et Microsoft Foundry, la messagerie est limitée à la même machine uniquement et nécessite Claude Code v2.1.248 ou version ultérieure. Claude peut trouver vos [sessions Claude Code sur le web](/docs/fr/claude-code-on-the-web) et vos sessions sur d'autres machines uniquement à partir d'une session connectée à [Remote Control](/docs/fr/remote-control). Pour vous connecter, vous avez besoin d'une connexion claude.ai et des autres [exigences de Remote Control](/docs/fr/remote-control#requirements). Consultez [Messagerie des sessions sur d'autres machines](/docs/fr/cross-session-messaging#message-sessions-on-other-machines).226<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Nécessite Claude Code v2.1.224 ou version ultérieure sur macOS et Linux, y compris Linux dans WSL 2. Sur Windows natif, nécessite Claude Code v2.1.234 ou version ultérieure. Avec l'authentification par clé API, la messagerie est limitée à la même machine uniquement. Sur Amazon Bedrock, Claude Platform sur AWS, Google Cloud's Agent Platform et Microsoft Foundry, la messagerie est limitée à la même machine uniquement et nécessite Claude Code v2.1.248 ou version ultérieure. Claude peut trouver vos [sessions cloud](/docs/fr/claude-code-on-the-web) et vos sessions sur d'autres machines uniquement à partir d'une session connectée à [Remote Control](/docs/fr/remote-control). Pour vous connecter, vous avez besoin d'une connexion claude.ai et des autres [exigences de Remote Control](/docs/fr/remote-control#requirements). Consultez [Messagerie des sessions sur d'autres machines](/docs/fr/cross-session-messaging#message-sessions-on-other-machines).

227 227 

228<Note>228<Note>

229 Si vous vous authentifiez via une [passerelle LLM](/docs/fr/llm-gateway), la disponibilité des fonctionnalités correspond au fournisseur sous-jacent vers lequel la passerelle transfère, sauf pour les fonctionnalités que Claude Code désactive lui-même. Chaque fois que `ANTHROPIC_BASE_URL` pointe vers un hôte autre que `api.anthropic.com`, Claude Code désactive des fonctionnalités telles que [Remote Control](/docs/fr/remote-control#requirements) et [paramètres gérés par le serveur](/docs/fr/server-managed-settings#platform-availability), quelle que soit la passerelle transfère. Certaines fonctionnalités exclusives à Anthropic telles que l'[Advisor](/docs/fr/advisor) ne fonctionnent que si la passerelle transfère les demandes intactes à l'API Anthropic.229 Si vous vous authentifiez via une [passerelle LLM](/docs/fr/llm-gateway), la disponibilité des fonctionnalités correspond au fournisseur sous-jacent vers lequel la passerelle transfère, sauf pour les fonctionnalités que Claude Code désactive lui-même. Chaque fois que `ANTHROPIC_BASE_URL` pointe vers un hôte autre que `api.anthropic.com`, Claude Code désactive des fonctionnalités telles que [Remote Control](/docs/fr/remote-control#requirements) et [paramètres gérés par le serveur](/docs/fr/server-managed-settings#platform-availability), quelle que soit la passerelle transfère. Certaines fonctionnalités exclusives à Anthropic telles que l'[Advisor](/docs/fr/advisor) ne fonctionnent que si la passerelle transfère les demandes intactes à l'API Anthropic.


244 **Support partiel :**244 **Support partiel :**

245 245 

246 * [Desktop](/docs/fr/desktop) : uniquement via [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)246 * [Desktop](/docs/fr/desktop) : uniquement via [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

247 * [Auto mode](/docs/fr/auto-mode-config) : Sonnet 5, Opus 4.7 ou versions ultérieures, et modèles Fable uniquement247 * [Auto mode](/docs/fr/auto-mode-config) : Sonnet 5 ou version ultérieure, Opus 4.7 ou version ultérieure, Haiku 5.5 et modèles Fable uniquement

248 * [Messagerie inter-sessions](/docs/fr/cross-session-messaging) : entre vos sessions sur cette machine uniquement <sup><a href="#fn5">5</a></sup>248 * [Messagerie inter-sessions](/docs/fr/cross-session-messaging) : entre vos sessions sur cette machine uniquement <sup><a href="#fn5">5</a></sup>

249 * [Rétention zéro donnée](/docs/fr/zero-data-retention) : soumis à votre accord AWS249 * [Rétention zéro donnée](/docs/fr/zero-data-retention) : soumis à votre accord AWS

250 250 


270 270 

271 * [Desktop](/docs/fr/desktop) : via les [paramètres gérés](https://claude.com/docs/third-party/claude-desktop/configuration) ou [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)271 * [Desktop](/docs/fr/desktop) : via les [paramètres gérés](https://claude.com/docs/third-party/claude-desktop/configuration) ou [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

272 * [Web search](/docs/fr/tools-reference#websearch-tool-behavior) : modèles Claude 4 et versions ultérieures272 * [Web search](/docs/fr/tools-reference#websearch-tool-behavior) : modèles Claude 4 et versions ultérieures

273 * [Auto mode](/docs/fr/auto-mode-config) : Sonnet 5, Opus 4.7 ou versions ultérieures, et modèles Fable uniquement273 * [Auto mode](/docs/fr/auto-mode-config) : Sonnet 5 ou version ultérieure, Opus 4.7 ou version ultérieure, Haiku 5.5 et modèles Fable uniquement

274 * [Messagerie inter-sessions](/docs/fr/cross-session-messaging) : entre vos sessions sur cette machine uniquement <sup><a href="#fn5">5</a></sup>274 * [Messagerie inter-sessions](/docs/fr/cross-session-messaging) : entre vos sessions sur cette machine uniquement <sup><a href="#fn5">5</a></sup>

275 * [Rétention zéro donnée](/docs/fr/zero-data-retention) : soumis à votre accord Google Cloud275 * [Rétention zéro donnée](/docs/fr/zero-data-retention) : soumis à votre accord Google Cloud

276 276 


284 284 

285 * [Desktop](/docs/fr/desktop) : uniquement via [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)285 * [Desktop](/docs/fr/desktop) : uniquement via [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

286 * [Web search](/docs/fr/tools-reference#websearch-tool-behavior) : [déploiements hébergés sur Anthropic](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) uniquement286 * [Web search](/docs/fr/tools-reference#websearch-tool-behavior) : [déploiements hébergés sur Anthropic](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) uniquement

287 * [Auto mode](/docs/fr/auto-mode-config) : Sonnet 5, Opus 4.7 ou versions ultérieures, et modèles Fable uniquement287 * [Auto mode](/docs/fr/auto-mode-config) : Sonnet 5 ou version ultérieure, Opus 4.7 ou version ultérieure, Haiku 5.5 et modèles Fable uniquement

288 * [Messagerie inter-sessions](/docs/fr/cross-session-messaging) : entre vos sessions sur cette machine uniquement <sup><a href="#fn5">5</a></sup>288 * [Messagerie inter-sessions](/docs/fr/cross-session-messaging) : entre vos sessions sur cette machine uniquement <sup><a href="#fn5">5</a></sup>

289 * [Rétention zéro donnée](/docs/fr/zero-data-retention) : soumis à votre accord Azure289 * [Rétention zéro donnée](/docs/fr/zero-data-retention) : soumis à votre accord Azure

290 290 

glossary.md +27 −27

Details

130 130 

131Un fichier markdown d'instructions persistantes que vous écrivez pour Claude, chargé au début de chaque session en tant que message utilisateur après l'invite système. Mettez les conventions de projet, les notes d'architecture et les règles « toujours faire X » ici. Project-root CLAUDE.md survit à [compaction](#compaction) et est relu à nouveau à partir du disque après.131Un fichier markdown d'instructions persistantes que vous écrivez pour Claude, chargé au début de chaque session en tant que message utilisateur après l'invite système. Mettez les conventions de projet, les notes d'architecture et les règles « toujours faire X » ici. Project-root CLAUDE.md survit à [compaction](#compaction) et est relu à nouveau à partir du disque après.

132 132 

133Vous pouvez placer CLAUDE.md au niveau du projet dans `./CLAUDE.md` ou `./.claude/CLAUDE.md`, au niveau utilisateur dans `~/.claude/CLAUDE.md`, ou comme [managed policy](#managed-settings) pour votre organisation. Tous les fichiers découverts sont concaténés dans le contexte plutôt que de se remplacer les uns les autres, ordonnés du champ d'application le plus large au plus spécifique. Claude Code peut également charger les fichiers [AGENTS.md](#agents-md) d'un projet, seuls ou aux côtés de CLAUDE.md.133Vous pouvez placer CLAUDE.md dans la portée projet dans `./CLAUDE.md` ou `./.claude/CLAUDE.md`, dans la portée utilisateur dans `~/.claude/CLAUDE.md`, ou comme [politique gérée](#managed-settings) pour votre organisation. Tous les fichiers découverts sont concaténés dans le contexte plutôt que de se remplacer les uns les autres, ordonnés de la portée la plus large à la plus spécifique. Claude Code peut également charger les fichiers [AGENTS.md](#agents-md) d'un projet à la place de CLAUDE.md.

134 134 

135En savoir plus : [CLAUDE.md files](/docs/fr/memory#claude-md-files)135En savoir plus : [CLAUDE.md files](/docs/fr/memory#claude-md-files)

136 136 


196 Effort level196 Effort level

197</h3>197</h3>

198 198 

199Un paramètre qui contrôle le raisonnement adaptatif, ce qui permet au modèle de décider s'il doit réfléchir et dans quelle mesure à chaque étape. Un effort plus élevé signifie plus de tokens de réflexion et un raisonnement plus profond ; un effort plus faible est plus rapide et moins cher. L'effort est pris en charge sur les modèles Fable, sur Opus 4.6 et versions ultérieures, ainsi que sur Sonnet 4.6 et versions ultérieures.199Un paramètre qui contrôle le raisonnement adaptatif, ce qui permet au modèle de décider s'il doit réfléchir et dans quelle mesure à chaque étape. Un effort plus élevé signifie plus de tokens de réflexion et un raisonnement plus profond ; un effort plus faible est plus rapide et moins cher. L'effort est pris en charge sur les modèles Fable, sur Opus 4.6 et versions ultérieures, sur Sonnet 4.6 et versions ultérieures, ainsi que sur Haiku 5.5.

200 200 

201En savoir plus : [Adjust effort level](/docs/fr/model-config#adjust-effort-level)201En savoir plus : [Adjust effort level](/docs/fr/model-config#adjust-effort-level)

202 202 


380 Sandboxing380 Sandboxing

381</h3>381</h3>

382 382 

383Isolation du système de fichiers et du réseau au niveau du système d'exploitation pour l'outil Bash. Les commandes s'exécutent à l'intérieur d'une limite que vous définissez à l'avance, afin que Claude puisse travailler librement sans invites d'approbation par commande. Le sandboxing est une couche séparée des [permission rules](#permission-rule).383Isolation du système de fichiers et du réseau au niveau du système d'exploitation pour l'outil Bash. Les commandes s'exécutent à l'intérieur d'une limite que vous définissez à l'avance, afin que Claude puisse travailler librement sans demandes d'approbation par commande. Le sandboxing est une couche séparée des [règles de permission](#permission-rule).

384 384 

385En savoir plus : [Sandboxing](/docs/fr/sandboxing)385En savoir plus : [Sandboxing](/docs/fr/sandboxing)

386 386 


388 Session388 Session

389</h3>389</h3>

390 390 

391Une conversation liée à votre répertoire actuel, avec sa propre [context window](#context-window) indépendante. Les sessions peuvent être reprises avec `claude -c`, bifurquées avec `--fork-session` pour préserver l'historique sous un nouvel ID de session, ou exécutées en parallèle sur les terminaux. L'exécution de `/clear` démarre une nouvelle session ; la session précédente reste stockée et est disponible via `/resume`. La transcription de chaque session est stockée sous `~/.claude/projects/`.391Une conversation liée à votre répertoire actuel, avec sa propre [fenêtre de contexte](#context-window) indépendante. Les sessions peuvent être reprises avec `claude -c`, bifurquées avec `--fork-session` pour préserver l'historique sous un nouvel ID de session, ou exécutées en parallèle sur les terminaux. L'exécution de `/clear` démarre une nouvelle session ; la session précédente reste stockée et est disponible via `/resume`. La transcription de chaque session est stockée sous `~/.claude/projects/`.

392 392 

393En savoir plus : [Work with sessions](/docs/fr/how-claude-code-works#work-with-sessions)393En savoir plus : [Travailler avec les sessions](/docs/fr/how-claude-code-works#work-with-sessions)

394 394 

395<h3 id="settings-layers">395<h3 id="settings-layers">

396 Settings layers396 Couches de paramètres

397</h3>397</h3>

398 398 

399La hiérarchie à partir de laquelle Claude Code lit la configuration, par ordre de priorité du plus élevé au plus bas : [managed policy](#managed-settings), arguments de ligne de commande, paramètres locaux à `.claude/settings.local.json`, paramètres de projet à `.claude/settings.json`, puis paramètres utilisateur à `~/.claude/settings.json`. Les tableaux fusionnent entre les couches ; les scalaires à une couche supérieure remplacent les couches inférieures. Voir [Settings precedence](/docs/fr/settings#settings-precedence).399La hiérarchie à partir de laquelle Claude Code lit la configuration, par ordre de priorité du plus élevé au plus bas : [politique gérée](#managed-settings), paramètres que vous transmettez avec le flag `--settings`, paramètres locaux à `.claude/settings.local.json`, paramètres de projet à `.claude/settings.json`, puis paramètres utilisateur à `~/.claude/settings.json`. Les tableaux fusionnent entre les couches ; les scalaires à une couche supérieure remplacent les couches inférieures. Voir [Priorité des paramètres](/docs/fr/settings#settings-precedence).

400 400 

401En savoir plus : [Settings files](/docs/fr/settings#where-settings-live)401En savoir plus : [Fichiers de paramètres](/docs/fr/settings#where-settings-live)

402 402 

403<h3 id="skill">403<h3 id="skill">

404 Skill404 Skill

405</h3>405</h3>

406 406 

407Un fichier `SKILL.md` contenant des instructions, des connaissances ou un flux de travail que Claude ajoute à sa boîte à outils. Claude charge une skill automatiquement lorsqu'elle est pertinente, ou vous l'invoquez directement avec `/skill-name`. Les skills suivent la norme Agent Skills ouverte ; Claude Code l'étend avec le contrôle d'invocation et l'exécution de subagent.407Un fichier `SKILL.md` contenant des instructions, des connaissances ou un workflow que Claude ajoute à sa boîte à outils. Claude charge un skill automatiquement lorsqu'il est pertinent, ou vous l'invoquez directement avec `/skill-name`. Les skills suivent la norme ouverte Agent Skills ; Claude Code l'étend avec le contrôle d'invocation et l'exécution en sous-agent.

408 408 

409Les skills sont le successeur recommandé aux commandes personnalisées. Un fichier à `.claude/commands/deploy.md` et un à `.claude/skills/deploy/SKILL.md` créent tous deux `/deploy` et fonctionnent de la même manière ; les fichiers de commande existants continuent de fonctionner.409Les skills sont le successeur recommandé des commandes personnalisées. Un fichier à `.claude/commands/deploy.md` et un à `.claude/skills/deploy/SKILL.md` créent tous deux `/deploy` et fonctionnent de la même manière ; les fichiers de commande existants continuent de fonctionner.

410 410 

411En savoir plus : [Extend Claude with skills](/docs/fr/skills)411En savoir plus : [Étendre Claude avec des skills](/docs/fr/skills)

412 412 

413<h3 id="subagent">413<h3 id="subagent">

414 Subagent414 Sous-agent

415</h3>415</h3>

416 416 

417Un assistant IA spécialisé qui s'exécute dans sa propre fenêtre de contexte avec une invite système personnalisée, un accès à des outils spécifiques et des permissions indépendantes. Il travaille sur une tâche déléguée et retourne un résumé à la conversation principale. Utilisez les subagents pour garder les grandes explorations hors de votre contexte principal ou pour exécuter des recherches parallèles. Un subagent reste à l'intérieur de la session qui l'a créé. Pour transmettre les résultats entre des sessions distinctes que vous exécutez vous-même, utilisez [cross-session messaging](/docs/fr/cross-session-messaging).417Un assistant IA spécialisé qui s'exécute dans sa propre fenêtre de contexte avec un prompt système personnalisé, un accès à des outils spécifiques et des permissions indépendantes. Il travaille sur une tâche déléguée et retourne un résumé à la conversation principale. Utilisez les sous-agents pour garder les grandes explorations hors de votre contexte principal ou pour exécuter des recherches parallèles. Un sous-agent reste à l'intérieur de la session qui l'a créé. Pour transmettre les résultats entre des sessions distinctes que vous exécutez vous-même, utilisez la [messagerie inter-sessions](/docs/fr/cross-session-messaging).

418 418 

419Les subagents intégrés incluent Explore, Plan et à usage général.419Les sous-agents intégrés incluent Explore, Plan et general-purpose.

420 420 

421En savoir plus : [Create custom subagents](/docs/fr/sub-agents)421En savoir plus : [Créer des sous-agents personnalisés](/docs/fr/sub-agents)

422 422 

423<h3 id="surface">423<h3 id="surface">

424 Surface424 Surface

425</h3>425</h3>

426 426 

427N'importe quel endroit où vous accédez à Claude Code : la CLI, VS Code, JetBrains, Desktop ou claude.ai. Toutes les surfaces partagent le même moteur. Les sessions sur votre machine lisent votre CLAUDE.md local, vos paramètres et vos skills ; les [cloud sessions](/docs/fr/cloud-environments#what-carries-over-from-your-setup) commencent par un clone frais de votre référentiel et ne lisent pas `~/.claude/` sur votre machine. Slack et l'extension Chrome sont des intégrations qui se connectent à une surface plutôt que des surfaces elles-mêmes.427N'importe quel endroit où vous accédez à Claude Code : la CLI, VS Code, JetBrains, Desktop ou claude.ai. Toutes les surfaces partagent le même moteur. Les sessions sur votre machine lisent votre CLAUDE.md local, vos paramètres et vos skills ; les [sessions cloud](/docs/fr/cloud-environments#what-carries-over-from-your-setup) commencent à partir d'un nouveau clone de votre dépôt et ne lisent pas `~/.claude/` sur votre machine. Slack et l'extension Chrome sont des intégrations qui se connectent à une surface plutôt que des surfaces elles-mêmes.

428 428 

429En savoir plus : [Platforms and integrations](/docs/fr/platforms)429En savoir plus : [Plateformes et intégrations](/docs/fr/platforms)

430 430 

431<h3 id="system-prompt">431<h3 id="system-prompt">

432 System prompt432 Prompt système

433</h3>433</h3>

434 434 

435Les instructions que Claude Code envoie avant votre conversation à chaque demande, couvrant la façon dont Claude utilise les outils, se comporte en toute sécurité et formate ses réponses. Vous pouvez ajouter au system prompt avec `--append-system-prompt` ou le remplacer avec `--system-prompt`. Le system prompt est la première couche du [prompt cache](/docs/fr/prompt-caching#how-the-cache-is-organized).435Les instructions que Claude Code envoie avant votre conversation à chaque requête, couvrant la façon dont Claude utilise les outils, se comporte en toute sécurité et formate ses réponses. Vous pouvez compléter le prompt système avec `--append-system-prompt` ou le remplacer avec `--system-prompt`. Le prompt système est la première couche du [cache de prompts](/docs/fr/prompt-caching#how-the-cache-is-organized).

436 436 

437Vos fichiers [CLAUDE.md](#claude-md) et les instructions de votre [output style](#output-style) ne font pas partie du system prompt. Claude Code les fournit dans la conversation en tant que [system reminder](#system-reminder).437Vos fichiers [CLAUDE.md](#claude-md) et les instructions de votre [style de sortie](#output-style) ne font pas partie du prompt système. Claude Code les fournit dans la conversation en tant que [rappels système](#system-reminder).

438 438 

439En savoir plus : [System prompt flags](/docs/fr/cli-reference#system-prompt-flags)439En savoir plus : [Flags du prompt système](/docs/fr/cli-reference#system-prompt-flags)

440 440 

441<h3 id="system-reminder">441<h3 id="system-reminder">

442 System reminder442 Rappel système

443</h3>443</h3>

444 444 

445Un message que Claude Code, en tant que [harness](#agentic-harness), ajoute à la conversation pour donner du contexte à Claude. Vous n'envoyez pas vous-même de system reminders. Claude Code les insère au fur et à mesure qu'une session s'exécute, par exemple au démarrage de la session, lorsqu'un hook retourne du texte, ou lorsqu'un fichier change sur le disque. Claude les lit aux côtés de vos messages. Les éléments suivants atteignent tous Claude en tant que system reminders :445Un message que Claude Code, en tant que [harness](#agentic-harness), ajoute à la conversation pour donner du contexte à Claude. Vous n'envoyez pas vous-même de rappels système. Claude Code les insère au fur et à mesure qu'une session s'exécute, par exemple au démarrage de la session, lorsqu'un hook retourne du texte, ou lorsqu'un fichier change sur le disque. Claude les lit aux côtés de vos messages. Les éléments suivants atteignent tous Claude en tant que rappels système :

446 446 

447* Vos fichiers [CLAUDE.md](#claude-md)447* Vos fichiers [CLAUDE.md](#claude-md)

448* Les instructions de votre [output style](#output-style)448* Les instructions de votre [style de sortie](#output-style)

449* Texte qu'un [hook](#hook) retourne en tant que `additionalContext`449* Le texte qu'un [hook](#hook) retourne en tant que `additionalContext`

450* La liste des [skills](#skill) disponibles450* La liste des [skills](#skill) disponibles

451* Une note indiquant qu'un fichier que Claude a lu précédemment a changé sur le disque451* Une note indiquant qu'un fichier que Claude a lu précédemment a changé sur le disque

452* Les lignes d'attribution de commit et de pull request452* Les lignes d'attribution de commit et de pull request

453 453 

454Dans une demande API enregistrée, un system reminder apparaît enveloppé dans des balises `<system-reminder>` à l'intérieur d'un message utilisateur, ou sur certains modèles en tant que message séparé avec le rôle `system`.454Dans une requête API enregistrée, un rappel système apparaît enveloppé dans des balises `<system-reminder>` à l'intérieur d'un message utilisateur, ou sur certains modèles en tant que message séparé avec le rôle `system`.

455 455 

456En savoir plus : [Context Claude Code adds outside the system prompt](/docs/fr/agent-sdk/modifying-system-prompts#context-claude-code-adds-outside-the-system-prompt)456En savoir plus : [Contexte que Claude Code ajoute en dehors du prompt système](/docs/fr/agent-sdk/modifying-system-prompts#context-claude-code-adds-outside-the-system-prompt)

457 457 

458<h2 id="t">458<h2 id="t">

459 T459 T

Details

210export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1210export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

211```211```

212 212 

213La plupart des versions de modèle ont une variable `VERTEX_REGION_CLAUDE_*` correspondante. Consultez la [référence des variables d'environnement](/docs/fr/env-vars) pour la liste complète. Vérifiez [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) pour déterminer quels modèles prennent en charge les points de terminaison globaux par rapport aux points de terminaison régionaux uniquement.213La plupart des versions de modèle ont une variable `VERTEX_REGION_CLAUDE_*` correspondante. Consultez la [référence des variables d'environnement](/docs/fr/env-vars#variables) pour la liste complète. Vérifiez [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) pour déterminer quels modèles prennent en charge les endpoints globaux par rapport aux endpoints régionaux uniquement.

214 214 

215Si une valeur de région ne ressemble pas à un nom de région ou d'emplacement, Claude Code la traite comme non définie. Par exemple, Claude Code traite une valeur contenant une barre oblique, un point ou un espace comme non définie. Claude Code revient à une source différente pour chaque variable :215Si une valeur de région ne ressemble pas à un nom de région ou d'emplacement, Claude Code la traite comme non définie. Par exemple, Claude Code traite une valeur contenant une barre oblique, un point ou un espace comme non définie. Claude Code revient à une source différente pour chaque variable :

216 216 


364 364 

365* Confirmez que le modèle est activé dans [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)365* Confirmez que le modèle est activé dans [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)

366* Vérifiez que le modèle est disponible dans l'emplacement que vous avez spécifié. Certains modèles ne sont proposés que sur les emplacements `global` ou multi-régions tels que `eu` et `us`, pas dans les régions spécifiques366* Vérifiez que le modèle est disponible dans l'emplacement que vous avez spécifié. Certains modèles ne sont proposés que sur les emplacements `global` ou multi-régions tels que `eu` et `us`, pas dans les régions spécifiques

367* Si vous utilisez `CLOUD_ML_REGION=global`, vérifiez que vos modèles prennent en charge les points de terminaison globaux dans [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) sous « Fonctionnalités prises en charge ». Pour les modèles qui ne prennent pas en charge les points de terminaison globaux, soit :367* Si vous utilisez `CLOUD_ML_REGION=global`, vérifiez que vos modèles prennent en charge les endpoints globaux dans [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) sous « Fonctionnalités prises en charge ». Pour les modèles qui ne prennent pas en charge les endpoints globaux, soit :

368 * Spécifiez un modèle pris en charge via `ANTHROPIC_MODEL` ou `ANTHROPIC_DEFAULT_HAIKU_MODEL`, soit368 * Spécifiez un modèle pris en charge via `ANTHROPIC_MODEL` ou `ANTHROPIC_DEFAULT_HAIKU_MODEL`, soit

369 * Définissez une région ou un emplacement multi-région à l'aide des variables d'environnement `VERTEX_REGION_<MODEL_NAME>`369 * Définissez une région ou un emplacement multi-région à l'aide de la variable `VERTEX_REGION_CLAUDE_*` du modèle, répertoriée dans la [référence des variables d'environnement](/docs/fr/env-vars#variables)

370 370 

371Si vous rencontrez des erreurs 429 :371Si vous rencontrez des erreurs 429 :

372 372 

headless.md +22 −6

Details

219 Suivre les messages des sous-agents219 Suivre les messages des sous-agents

220</h4>220</h4>

221 221 

222Les messages des [sous-agents](/docs/fr/sub-agents) apparaissent dans le flux sous forme de messages `assistant` et `user` dont le champ `parent_tool_use_id` est l'ID de l'appel d'outil qui a généré le sous-agent. Les messages de la conversation principale portent `null` dans ce champ.222Les messages des [sous-agents](/docs/fr/sub-agents) et des skills qui [s'exécutent dans un sous-agent](/docs/fr/skills#run-skills-in-a-subagent) apparaissent dans le flux sous forme de messages `assistant` et `user`. Leur champ `parent_tool_use_id` indique à quelle exécution chacun appartient. Les messages de la conversation principale portent `null` dans ce champ.

223 223 

224Le premier message d'un sous-agent s'exécutant en [avant-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) est un message `user` portant l'invite qui le pilote. Après ce premier message, Claude Code émet :224Le premier message d'un skill dupliqué, ou d'un sous-agent s'exécutant en [avant-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background), est un message `user` portant le prompt ou le contenu du skill qui le pilote. Après ce premier message, Claude Code émet :

225 225 

226* **Par défaut** : les blocs `tool_use` et `tool_result` du sous-agent.226* **Par défaut** : les blocs `tool_use` et `tool_result` de l'exécution.

227* **Avec [`--forward-subagent-text`](/docs/fr/cli-reference#cli-flags) ou [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/fr/env-vars)** : les blocs de texte et de réflexion du sous-agent également, afin que vous puissiez reconstruire la transcription de chaque sous-agent. Cela nécessite Claude Code v2.1.211 ou ultérieur.227* **Avec [`--forward-subagent-text`](/docs/fr/cli-reference#cli-flags) ou [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/fr/env-vars)** : les blocs de texte et de réflexion de l'exécution également, afin que vous puissiez reconstruire la transcription de chaque exécution.

228 228 

229Lorsque vous activez l'une ou l'autre option, Claude Code transfère les messages des [sous-agents à chaque profondeur d'imbrication](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents), qu'ils aient été générés avec l'outil Agent ou démarrés en tant que [compétence dupliquée](/docs/fr/skills#run-skills-in-a-subagent). Les messages des sous-agents qu'une compétence dupliquée génère, et des compétences dupliquées démarrées à l'intérieur d'un sous-agent ou d'une autre compétence dupliquée, nécessitent Claude Code v2.1.275 ou ultérieur. Dans `parent_tool_use_id`, les messages du sous-agent imbriqué portent l'ID de l'appel d'outil Agent ou Skill qui l'a démarré, afin que vous puissiez reconstruire l'arborescence d'imbrication complète en suivant ces ID. Avant la v2.1.219, les messages des sous-agents imbriqués n'apparaissaient pas dans le flux.229Lorsque vous activez l'une ou l'autre option, Claude Code transfère les messages des [sous-agents à chaque profondeur d'imbrication](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents), que chacun ait été généré avec l'outil Agent ou démarré en tant que skill dupliqué. Dans `parent_tool_use_id`, les messages du sous-agent imbriqué portent l'ID de l'appel d'outil Agent ou Skill qui l'a démarré, afin que vous puissiez reconstruire l'arborescence d'imbrication complète en suivant ces ID.

230 230 

231Les compétences qui [s'exécutent dans un sous-agent](/docs/fr/skills#run-skills-in-a-subagent) apparaissent dans le flux de la même manière : le premier message de la compétence dupliquée est un message `user` portant le contenu de la compétence qui pilote l'exécution. Si vous activez l'une ou l'autre option, le flux porte également les blocs de texte et de réflexion de la compétence dupliquée. Avant la v2.1.265, seuls les blocs `tool_use` et `tool_result` d'une compétence dupliquée apparaissaient dans le flux.231Une exécution que Claude démarre avec un appel d'outil porte l'ID de cet appel d'outil. Un skill dupliqué que vous démarrez en passant `/<skill-name>` comme prompt n'a pas d'appel d'outil, ses messages portent donc à la place une valeur `forked-command-` et arrivent une fois son exécution terminée. Repérez la façon dont l'exécution a démarré dans la première colonne :

232 

233| Comment l'exécution démarre | `parent_tool_use_id` | Quand ses messages arrivent |

234| :- | :- | :- |

235| Claude appelle l'outil Agent depuis la conversation principale | L'ID de ce bloc `tool_use` Agent | Pendant que le sous-agent travaille |

236| Claude appelle l'outil Skill pour un skill dupliqué depuis la conversation principale | L'ID de ce bloc `tool_use` Skill | Pendant que le skill dupliqué travaille |

237| Vous passez `/<skill-name>` comme prompt | Une valeur qui commence par `forked-command-` | Ensemble et dans l'ordre une fois le skill dupliqué terminé |

238 

239Pour un skill dupliqué démarré depuis le prompt, faites correspondre `parent_tool_use_id` sur le préfixe `forked-command-`, car le nom qui le suit peut différer de celui que vous avez saisi.

240 

241Si certains de ces messages manquent dans votre flux, comparez votre version de Claude Code à ces versions minimales :

242 

243* **`--forward-subagent-text` et `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`** : v2.1.211 ou ultérieur

244* **Transfert à chaque profondeur d'imbrication** : v2.1.219 ou ultérieur

245* **Un skill dupliqué que Claude démarre avec l'outil Skill depuis la conversation principale** : v2.1.86 ou ultérieur pour ses blocs `tool_use` et `tool_result`, et v2.1.265 ou ultérieur pour son premier message `user` et ses blocs de texte et de réflexion

246* **Messages des sous-agents qu'un skill dupliqué génère, et des skills dupliqués démarrés à l'intérieur d'un sous-agent ou d'un autre skill dupliqué** : v2.1.275 ou ultérieur

247* **Messages d'un skill dupliqué que vous démarrez en passant `/<skill-name>` comme prompt** : v2.1.287 ou ultérieur

232 248 

233<h4 id="handle-api-retries">249<h4 id="handle-api-retries">

234 Gérer les tentatives d'API250 Gérer les tentatives d'API

hooks.md +8 −6

Details

63| `DirectoryAdded` | Quand un répertoire de travail est ajouté en milieu de session via `/add-dir` ou la demande de contrôle SDK `register_repo_root` |63| `DirectoryAdded` | Quand un répertoire de travail est ajouté en milieu de session via `/add-dir` ou la demande de contrôle SDK `register_repo_root` |

64| `FileChanged` | Quand un fichier surveillé change sur le disque. Le champ `matcher` spécifie les noms de fichiers à surveiller |64| `FileChanged` | Quand un fichier surveillé change sur le disque. Le champ `matcher` spécifie les noms de fichiers à surveiller |

65| `WorktreeCreate` | Quand un worktree est en cours de création via `--worktree`, `isolation: "worktree"`, ou pour une session en arrière-plan. Remplace le comportement git par défaut |65| `WorktreeCreate` | Quand un worktree est en cours de création via `--worktree`, `isolation: "worktree"`, ou pour une session en arrière-plan. Remplace le comportement git par défaut |

66| `WorktreeRemove` | Quand un worktree est supprimé à la sortie de la session, quand un sous-agent se termine, ou quand vous supprimez une session en arrière-plan |66| `WorktreeRemove` | Quand un worktree créé par un hook `WorktreeCreate` est en cours de suppression |

67| `PreCompact` | Avant la compaction du contexte |67| `PreCompact` | Avant la compaction du contexte |

68| `PostCompact` | Après la compaction du contexte est complétée |68| `PostCompact` | Après la compaction du contexte est complétée |

69| `PreModelSwitch` | Avant que Claude Code applique un changement de modèle que vous ou un client avez demandé. Peut bloquer le changement |69| `PreModelSwitch` | Avant que Claude Code applique un changement de modèle que vous ou un client avez demandé. Peut bloquer le changement |


3274 WorktreeRemove3274 WorktreeRemove

3275</h3>3275</h3>

3276 3276 

3277S'exécute lorsqu'un worktree est en cours de suppression. C'est le pendant de nettoyage de [WorktreeCreate](#worktreecreate). L'événement se déclenche lorsque :3277S'exécute lorsque Claude Code nettoie un worktree créé par votre hook [`WorktreeCreate`](#worktreecreate). L'événement se déclenche lorsque :

3278 3278 

3279* vous quittez une session `--worktree` et choisissez de la supprimer3279* Vous quittez une [session de worktree](/docs/fr/worktrees#start-claude-in-a-worktree) interactive et choisissez de supprimer le worktree lorsque Claude Code vous le demande

3280* un sous-agent avec `isolation: "worktree"` se termine3280* Vous quittez une session de worktree interactive que vous n'avez pas [nommée](/docs/fr/sessions#name-your-sessions), Claude Code ne trouve aucun fichier modifié ou non suivi, et il supprime le worktree sans vous le demander

3281* vous supprimez une [session en arrière-plan](/docs/fr/agent-view#what-deleting-a-session-removes) dont le worktree a été créé par le hook3281* Vous supprimez une [session en arrière-plan](/docs/fr/agent-view#what-deleting-a-session-removes) qui s'exécute dans le worktree

3282 

3283Claude Code utilise git pour rechercher les fichiers modifiés ou non suivis ; il n'en trouve donc aucun dans un worktree qui n'est pas un checkout git ni situé à l'intérieur de l'un d'eux, même lorsque le répertoire contient du travail non commité. Vérifiez la présence de ce travail dans votre hook WorktreeRemove avant qu'il ne supprime quoi que ce soit.

3282 3284 

3283Pour les worktrees basés sur git, Claude Code gère automatiquement le nettoyage avec `git worktree remove`. Si vous avez configuré un hook WorktreeCreate, associez-le à un hook WorktreeRemove pour contrôler le nettoyage des worktrees qu'il crée :3285Pour les worktrees basés sur git, Claude Code gère automatiquement le nettoyage avec `git worktree remove`. Si vous avez configuré un hook WorktreeCreate, associez-le à un hook WorktreeRemove pour contrôler le nettoyage des worktrees qu'il crée :

3284 3286 

3285* **Aucun hook WorktreeRemove** : lorsque vous quittez une session `--worktree` et choisissez la suppression, Claude Code se rabat sur `git worktree remove --force` sur le chemin renvoyé par votre hook WorktreeCreate, de sorte qu'un worktree reconnu par git est supprimé. Un worktree que git ne reconnaît pas, par exemple un worktree créé par votre hook avec un système de gestion de versions autre que git, reste sur le disque. Pour savoir ce que la suppression d'une [session en arrière-plan](/docs/fr/agent-view#what-deleting-a-session-removes) fait d'un worktree créé par un hook, consultez les règles de suppression de la vue agent.3287* **Aucun hook WorktreeRemove** : lorsque Claude Code supprime le worktree au moment où vous quittez une session de worktree, il se rabat sur `git worktree remove --force` sur le chemin renvoyé par votre hook WorktreeCreate, de sorte qu'un worktree reconnu par git est supprimé. Un worktree que git ne reconnaît pas, par exemple un worktree créé par votre hook avec un système de gestion de versions autre que git, reste sur le disque. Pour savoir ce que fait la suppression d'une [session en arrière-plan](/docs/fr/agent-view#what-deleting-a-session-removes) avec un worktree créé par un hook, consultez les règles de suppression de la vue agent.

3286* **Le hook se termine avec le code 0** : le worktree est considéré comme supprimé. Claude Code ne lit rien d'autre du hook ; assurez-vous donc que votre hook a bien supprimé le répertoire.3288* **Le hook se termine avec le code 0** : le worktree est considéré comme supprimé. Claude Code ne lit rien d'autre du hook ; assurez-vous donc que votre hook a bien supprimé le répertoire.

3287* **Le hook se termine avec un code non nul** : la suppression échoue si le répertoire situé à `worktree_path` existe toujours ensuite, et le worktree reste sur le disque sans solution de repli git. Un hook qui a supprimé le répertoire avant de se terminer avec un code non nul est considéré comme ayant supprimé le worktree. Pour savoir comment l'échec est signalé, consultez [Entrée de WorktreeRemove](#worktreeremove-input).3289* **Le hook se termine avec un code non nul** : la suppression échoue si le répertoire situé à `worktree_path` existe toujours ensuite, et le worktree reste sur le disque sans solution de repli git. Un hook qui a supprimé le répertoire avant de se terminer avec un code non nul est considéré comme ayant supprimé le worktree. Pour savoir comment l'échec est signalé, consultez [Entrée de WorktreeRemove](#worktreeremove-input).

3288 3290 

hooks-guide.md +1 −1

Details

526| `DirectoryAdded` | Quand un répertoire de travail est ajouté en milieu de session via `/add-dir` ou la demande de contrôle SDK `register_repo_root` |526| `DirectoryAdded` | Quand un répertoire de travail est ajouté en milieu de session via `/add-dir` ou la demande de contrôle SDK `register_repo_root` |

527| `FileChanged` | Quand un fichier surveillé change sur le disque. Le champ `matcher` spécifie les noms de fichiers à surveiller |527| `FileChanged` | Quand un fichier surveillé change sur le disque. Le champ `matcher` spécifie les noms de fichiers à surveiller |

528| `WorktreeCreate` | Quand un worktree est en cours de création via `--worktree`, `isolation: "worktree"`, ou pour une session en arrière-plan. Remplace le comportement git par défaut |528| `WorktreeCreate` | Quand un worktree est en cours de création via `--worktree`, `isolation: "worktree"`, ou pour une session en arrière-plan. Remplace le comportement git par défaut |

529| `WorktreeRemove` | Quand un worktree est supprimé à la sortie de la session, quand un sous-agent se termine, ou quand vous supprimez une session en arrière-plan |529| `WorktreeRemove` | Quand un worktree créé par un hook `WorktreeCreate` est en cours de suppression |

530| `PreCompact` | Avant la compaction du contexte |530| `PreCompact` | Avant la compaction du contexte |

531| `PostCompact` | Après la compaction du contexte est complétée |531| `PostCompact` | Après la compaction du contexte est complétée |

532| `PreModelSwitch` | Avant que Claude Code applique un changement de modèle que vous ou un client avez demandé. Peut bloquer le changement |532| `PreModelSwitch` | Avant que Claude Code applique un changement de modèle que vous ou un client avez demandé. Peut bloquer le changement |

Details

76* **Votre projet.** Les fichiers de votre répertoire et sous-répertoires, plus les fichiers ailleurs avec votre permission.76* **Votre projet.** Les fichiers de votre répertoire et sous-répertoires, plus les fichiers ailleurs avec votre permission.

77* **Votre terminal.** N'importe quelle commande que vous pourriez exécuter : outils de build, git, gestionnaires de paquets, utilitaires système, scripts. Si vous pouvez le faire à partir de la ligne de commande, Claude aussi.77* **Votre terminal.** N'importe quelle commande que vous pourriez exécuter : outils de build, git, gestionnaires de paquets, utilitaires système, scripts. Si vous pouvez le faire à partir de la ligne de commande, Claude aussi.

78* **Votre état git.** La branche actuelle, les modifications non validées, et l'historique récent des commits.78* **Votre état git.** La branche actuelle, les modifications non validées, et l'historique récent des commits.

79* **Votre [CLAUDE.md](/docs/fr/memory).** Un fichier markdown où vous stockez les instructions spécifiques au projet, les conventions, et le contexte que Claude devrait connaître à chaque session. Si votre référentiel dispose d'un AGENTS.md pour d'autres agents de codage, Claude [peut le lire](/docs/fr/memory#agents-md) seul ou aux côtés de CLAUDE.md.79* **Votre [CLAUDE.md](/docs/fr/memory).** Un fichier markdown où vous stockez les instructions spécifiques au projet, les conventions, et le contexte que Claude devrait connaître à chaque session. Si votre dépôt dispose d'un AGENTS.md pour d'autres agents de codage, Claude [peut le lire](/docs/fr/memory#agents-md) à la place d'un CLAUDE.md.

80* **[Mémoire automatique](/docs/fr/memory#auto-memory).** Les apprentissages que Claude sauvegarde automatiquement au fur et à mesure que vous travaillez, comme vos préférences. Les 200 premières lignes ou 25 KB de MEMORY.md, selon ce qui vient en premier, se chargent au début de chaque session.80* **[Mémoire automatique](/docs/fr/memory#auto-memory).** Les apprentissages que Claude sauvegarde automatiquement au fur et à mesure que vous travaillez, comme vos préférences. Les 200 premières lignes ou 25 KB de MEMORY.md, selon ce qui vient en premier, se chargent au début de chaque session.

81* **Les extensions que vous configurez.** [Les serveurs MCP](/docs/fr/mcp) pour les services externes, [les skills](/docs/fr/skills) pour les workflows, [les subagents](/docs/fr/sub-agents) pour le travail délégué, et [Claude dans Chrome](/docs/fr/chrome) pour l'interaction avec le navigateur.81* **Les extensions que vous configurez.** [Les serveurs MCP](/docs/fr/mcp) pour les services externes, [les skills](/docs/fr/skills) pour les workflows, [les subagents](/docs/fr/sub-agents) pour le travail délégué, et [Claude dans Chrome](/docs/fr/chrome) pour l'interaction avec le navigateur.

82 82 

Details

42| `Ctrl+Entrée` ou `Ctrl+X Ctrl+S` | Envoyer les messages en attente maintenant | Envoie vos [messages en attente](#queue-messages-while-claude-works) et votre brouillon avec eux, immédiatement. [Quand Claude Code envoie ce que vous avez mis en attente](#when-claude-code-sends-what-you-queued) couvre ce qui se passe au tour sur lequel Claude travaille. En [mode shell](#shell-mode-with-prefix), la touche met en attente votre commande uniquement. Dans les terminaux qui ne signalent pas les touches étendues, `Ctrl+Entrée` arrive sous la forme d'une simple `Entrée` ; `Ctrl+X Ctrl+S` fonctionne dans n'importe quel terminal. Nécessite Claude Code v2.1.275 ou version ultérieure |42| `Ctrl+Entrée` ou `Ctrl+X Ctrl+S` | Envoyer les messages en attente maintenant | Envoie vos [messages en attente](#queue-messages-while-claude-works) et votre brouillon avec eux, immédiatement. [Quand Claude Code envoie ce que vous avez mis en attente](#when-claude-code-sends-what-you-queued) couvre ce qui se passe au tour sur lequel Claude travaille. En [mode shell](#shell-mode-with-prefix), la touche met en attente votre commande uniquement. Dans les terminaux qui ne signalent pas les touches étendues, `Ctrl+Entrée` arrive sous la forme d'une simple `Entrée` ; `Ctrl+X Ctrl+S` fonctionne dans n'importe quel terminal. Nécessite Claude Code v2.1.275 ou version ultérieure |

43| `Shift+Tab`, ou `Alt+M` sur Windows lorsque le runtime Node ou Bun n'active pas le mode d'entrée VT | Parcourir les modes de permission | Parcourez `default` (étiqueté Manuel dans l'indicateur de mode), `acceptEdits`, `plan`, et, le cas échéant, `bypassPermissions` puis `auto`. À partir de `auto`, la première pression bascule vers `default`. Consultez [modes de permission](/docs/fr/permission-modes). Sur un prompt de permission de fichier, la même touche ferme un [champ de commentaire](/docs/fr/permissions#add-a-comment-when-you-answer-a-permission-prompt) ouvert. Sans champ ouvert, il sélectionne l'option qui autorise l'action pour le reste de la session, lorsque le prompt offre cette option |43| `Shift+Tab`, ou `Alt+M` sur Windows lorsque le runtime Node ou Bun n'active pas le mode d'entrée VT | Parcourir les modes de permission | Parcourez `default` (étiqueté Manuel dans l'indicateur de mode), `acceptEdits`, `plan`, et, le cas échéant, `bypassPermissions` puis `auto`. À partir de `auto`, la première pression bascule vers `default`. Consultez [modes de permission](/docs/fr/permission-modes). Sur un prompt de permission de fichier, la même touche ferme un [champ de commentaire](/docs/fr/permissions#add-a-comment-when-you-answer-a-permission-prompt) ouvert. Sans champ ouvert, il sélectionne l'option qui autorise l'action pour le reste de la session, lorsque le prompt offre cette option |

44| `Option+P` (macOS) ou `Alt+P` (Windows/Linux) | Changer de modèle | Changez de modèles sans effacer votre prompt |44| `Option+P` (macOS) ou `Alt+P` (Windows/Linux) | Changer de modèle | Changez de modèles sans effacer votre prompt |

45| `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Basculer la réflexion étendue | Activez ou désactivez le mode de réflexion étendue. N'a aucun effet sur Opus 5.5, Sonnet 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue. Fonctionne sur macOS sans configurer Option en tant que Meta |45| `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Basculer la réflexion étendue | Activez ou désactivez le mode de réflexion étendue. N'a aucun effet sur Opus 5.5, Sonnet 5.5, Haiku 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue. Fonctionne sur macOS sans configurer Option en tant que Meta |

46| `Option+O` (macOS) ou `Alt+O` (Windows/Linux) | Basculer le mode rapide | Activez ou désactivez le [mode rapide](/docs/fr/fast-mode) |46| `Option+O` (macOS) ou `Alt+O` (Windows/Linux) | Basculer le mode rapide | Activez ou désactivez le [mode rapide](/docs/fr/fast-mode) |

47 47 

48<h3 id="text-editing">48<h3 id="text-editing">

keybindings.md +3 −2

Details

299| :- | :- | :- |299| :- | :- | :- |

300| `footer:next` | Droite | Élément de pied de page suivant |300| `footer:next` | Droite | Élément de pied de page suivant |

301| `footer:previous` | Gauche | Élément de pied de page précédent |301| `footer:previous` | Gauche | Élément de pied de page précédent |

302| `footer:up` | Haut | Naviguer vers le haut dans le pied de page (désélectionne en haut) |302| `footer:up` | Haut, Ctrl+P | Naviguer vers le haut dans le pied de page (désélectionne en haut) |

303| `footer:down` | Bas | Naviguer vers le bas dans le pied de page |303| `footer:down` | Bas, Ctrl+N | Naviguer vers le bas dans le pied de page |

304| `footer:openSelected` | Entrée | Ouvrir l'élément de pied de page sélectionné |304| `footer:openSelected` | Entrée | Ouvrir l'élément de pied de page sélectionné |

305| `footer:clearSelection` | Échap | Effacer la sélection du pied de page |305| `footer:clearSelection` | Échap | Effacer la sélection du pied de page |

306| `footer:close` | x | Arrêter l'[agent](/docs/fr/sub-agents#observe-and-steer-running-forks) ou le [workflow](/docs/fr/workflows#manage-runs) sélectionné, ou rejeter sa ligne s'il n'est plus en cours d'exécution |

306| `footer:dismiss` | (non lié) | Lier une touche à cette action n'a aucun effet, et un `keybindings.json` qui la nomme reste valide. Avant v2.1.281, Retour arrière et Suppr y étaient liés et rejetaient le lien d'artefact sélectionné du pied de page. |307| `footer:dismiss` | (non lié) | Lier une touche à cette action n'a aucun effet, et un `keybindings.json` qui la nomme reste valide. Avant v2.1.281, Retour arrière et Suppr y étaient liés et rejetaient le lien d'artefact sélectionné du pied de page. |

307 308 

308Quand un élément de pied de page est sélectionné, comme une ligne dans le panneau agent sous l'invite, `Entrée` l'ouvre même quand vous reliez `Entrée` dans le contexte `Chat` à `chat:queueSubmit` ou `chat:newline`.309Quand un élément de pied de page est sélectionné, comme une ligne dans le panneau agent sous l'invite, `Entrée` l'ouvre même quand vous reliez `Entrée` dans le contexte `Chat` à `chat:queueSubmit` ou `chat:newline`.

Details

216* **Distribuée par un administrateur** : si votre organisation a [déployé la configuration](/docs/fr/llm-gateway-rollout#distribute-through-managed-settings), l'application de bureau route via la passerelle sans configuration de votre côté216* **Distribuée par un administrateur** : si votre organisation a [déployé la configuration](/docs/fr/llm-gateway-rollout#distribute-through-managed-settings), l'application de bureau route via la passerelle sans configuration de votre côté

217* **Configurée localement** : pour les appareils sans configuration distribuée par un administrateur, ouvrez Help → Troubleshooting → Enable Developer Mode, qui redémarre l'application avec un menu Developer. Ensuite, ouvrez Developer → Configure Third-Party Inference et entrez l'URL de base de votre passerelle. Une configuration distribuée par un administrateur a la priorité et rend ce formulaire en lecture seule217* **Configurée localement** : pour les appareils sans configuration distribuée par un administrateur, ouvrez Help → Troubleshooting → Enable Developer Mode, qui redémarre l'application avec un menu Developer. Ensuite, ouvrez Developer → Configure Third-Party Inference et entrez l'URL de base de votre passerelle. Une configuration distribuée par un administrateur a la priorité et rend ce formulaire en lecture seule

218 218 

219Avec la configuration de passerelle active, l'application de bureau exécute les sessions sur votre machine locale uniquement : le sélecteur d'environnement n'offre pas de sessions SSH ou d'environnements cloud hébergés par Anthropic, et [Remote Control](/docs/fr/remote-control) n'est pas disponible. Pour utiliser Claude Code sur un hôte distant via la passerelle, exécutez la CLI sur cet hôte avec [`ANTHROPIC_BASE_URL` et l'identifiant de passerelle](#set-the-base-url-and-credential) définis là.219Avec la configuration de passerelle active, le sélecteur d'environnement ne propose pas d'environnements cloud hébergés par Anthropic, et [Remote Control](/docs/fr/remote-control) n'est pas disponible.

220 

221Les sessions SSH sont en bêta avec une configuration de passerelle et nécessitent Claude Desktop v1.40609.0 ou une version ultérieure. Avant de vous connecter, vérifiez la liste d'autorisation et l'adresse de la passerelle :

222 

223* **Hôtes autorisés** : les sessions SSH sont désactivées par défaut. Pour les activer, vous ou votre administrateur répertoriez les hôtes autorisés dans la clé [`sshHostAllowlist`](https://claude.com/docs/third-party/claude-desktop/configuration#sshhostallowlist) de la configuration d'inférence tierce

224* **Adresse de la passerelle** : la machine distante se connecte elle-même à la passerelle, de sorte qu'une passerelle sur `localhost` sur votre ordinateur ne fonctionne pas pour les sessions SSH

225 

226Consultez [Sessions SSH à distance dans Claude Desktop sur 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions). Vous pouvez également exécuter la CLI sur l'hôte distant avec [`ANTHROPIC_BASE_URL` et l'identifiant de passerelle](#set-the-base-url-and-credential) définis là.

220 227 

221Si l'application de bureau affiche `Gateway was unreachable`, l'application n'a pas pu atteindre l'URL de base configurée au démarrage ; vérifiez l'URL et le chemin réseau avec le [test curl ci-dessus](#verify-the-connection).228Si l'application de bureau affiche `Gateway was unreachable`, l'application n'a pas pu atteindre l'URL de base configurée au démarrage ; vérifiez l'URL et le chemin réseau avec le [test curl ci-dessus](#verify-the-connection).

222 229 

managed-mcp.md +17 −5

Details

347 Comment les entrées `serverUrl` correspondent347 Comment les entrées `serverUrl` correspondent

348</h4>348</h4>

349 349 

350Les URL supportent les caractères génériques `*` n'importe où dans le motif, y compris le schéma. La correspondance du nom d'hôte est insensible à la casse et ignore un point FQDN final, donc `https://Mcp.Example.com/*` correspond à `https://mcp.example.com/api`. Les chemins restent sensibles à la casse.350Les URL prennent en charge les caractères génériques `*`, y compris `*` comme schéma entier. La correspondance du nom d'hôte est insensible à la casse et ignore un point FQDN final, donc `https://Mcp.Example.com/*` correspond à `https://mcp.example.com/api`. Les chemins restent sensibles à la casse. Si vous n'indiquez aucun port, la façon dont vous écrivez le nom d'hôte détermine si le motif correspond uniquement au port par défaut du schéma ou à tous les ports :

351 

352* **Nom d'hôte écrit en entier** : le port par défaut uniquement, 443 pour `https` et 80 pour `http`

353* **Nom d'hôte contenant un `*`** : tous les ports

351 354 

352Le tableau montre ce que les motifs courants autorisent :355Le tableau montre ce que les motifs courants autorisent :

353 356 

354| Motif | Autorise |357| Motif | Autorise |

355| :- | :- |358| :- | :- |

356| `https://mcp.example.com/*` | Tous les chemins sur un domaine spécifique |359| `https://mcp.example.com/*` | Tous les chemins sur un domaine spécifique, sur le port 443 uniquement |

357| `https://mcp.example.com` | Aussi tous les chemins sur ce domaine. Un motif sans chemin correspond à n'importe quel chemin |360| `https://mcp.example.com` | Aussi tous les chemins sur ce domaine, sur le port 443 uniquement. Un motif sans chemin correspond à n'importe quel chemin |

358| `https://*.example.com/*` | N'importe quel sous-domaine de `example.com` |361| `https://mcp.example.com:8443/*` | Tous les chemins sur ce domaine, sur le port 8443 uniquement |

362| `https://mcp.example.com:*/*` | Tous les chemins sur ce domaine, sur n'importe quel port, 443 compris |

363| `https://*.example.com/*` | N'importe quel sous-domaine de `example.com`, sur n'importe quel port |

359| `http://localhost:*/*` | N'importe quel port sur localhost |364| `http://localhost:*/*` | N'importe quel port sur localhost |

360| `*://mcp.example.com/*` | N'importe quel schéma vers un domaine spécifique |365| `*://mcp.example.com/*` | N'importe quel schéma vers un domaine spécifique, chaque schéma sur son port par défaut uniquement |

366 

367Les entrées de `deniedMcpServers` font correspondre les ports de la même façon, choisissez donc une entrée pour `staging.example.com` en fonction des ports et des schémas que vous devez bloquer :

368 

369* `https://staging.example.com/*` : bloque les serveurs `https` sur cet hôte sur le port 443 uniquement, donc ne bloque pas un serveur à `https://staging.example.com:8443/api`

370* `https://staging.example.com:*/*` : bloque les serveurs `https` sur cet hôte sur tous les ports

371* `*://staging.example.com:*/*` : bloque cet hôte quel que soit le schéma et sur n'importe quel port

361 372 

362<h4 id="how-policy-entries-expand">373<h4 id="how-policy-entries-expand">

363 Variables d'environnement dans les entrées `serverCommand` et `serverUrl`374 Variables d'environnement dans les entrées `serverCommand` et `serverUrl`


529 | :- | :- |540 | :- | :- |

530 | Serveur HTTP à `https://mcp.example.com/api` | Autorisé : correspond au motif d'URL de liste blanche, pas de correspondance de liste noire |541 | Serveur HTTP à `https://mcp.example.com/api` | Autorisé : correspond au motif d'URL de liste blanche, pas de correspondance de liste noire |

531 | Serveur HTTP à `https://staging.example.com/api` | Bloqué : correspond aux deux, mais la liste noire a la priorité |542 | Serveur HTTP à `https://staging.example.com/api` | Bloqué : correspond aux deux, mais la liste noire a la priorité |

543 | Serveur HTTP à `https://staging.example.com:8443/api` | Autorisé : correspond au motif d'URL de la liste d'autorisation, [pas de correspondance dans la liste de refus sur ce port](#how-serverurl-entries-match) |

532 | Serveur HTTP à `https://other.com/mcp` | Bloqué : ne correspond pas à la liste blanche |544 | Serveur HTTP à `https://other.com/mcp` | Bloqué : ne correspond pas à la liste blanche |

533</Accordion>545</Accordion>

534 546 

memory.md +2 −2

Details

8 8 

9Chaque session Claude Code commence avec une fenêtre de contexte vierge. Deux mécanismes transportent les connaissances d'une session à l'autre :9Chaque session Claude Code commence avec une fenêtre de contexte vierge. Deux mécanismes transportent les connaissances d'une session à l'autre :

10 10 

11* **Fichiers CLAUDE.md** : instructions que vous écrivez pour donner à Claude un contexte persistant. Claude peut également lire les fichiers [`AGENTS.md`](#agents-md) d'un référentiel, seuls ou aux côtés de CLAUDE.md11* **Fichiers CLAUDE.md** : instructions que vous écrivez pour donner à Claude un contexte persistant. Claude peut également lire les [fichiers `AGENTS.md`](#agents-md) d'un dépôt à la place de CLAUDE.md

12* **Mémoire automatique** : notes que Claude écrit lui-même en fonction de vos corrections et préférences12* **Mémoire automatique** : notes que Claude écrit lui-même en fonction de vos corrections et préférences

13 13 

14Cette page couvre comment :14Cette page couvre comment :

15 15 

16* [Écrire et organiser les fichiers CLAUDE.md](#claude-md-files)16* [Écrire et organiser les fichiers CLAUDE.md](#claude-md-files)

17* [Utiliser un fichier AGENTS.md existant](#agents-md) comme instructions de votre projet, seul ou aux côtés de CLAUDE.md17* [Utiliser un fichier AGENTS.md existant](#agents-md) comme instructions de votre projet

18* [Limiter les règles à des types de fichiers spécifiques](#organize-rules-with-claude/rules/) avec `.claude/rules/`18* [Limiter les règles à des types de fichiers spécifiques](#organize-rules-with-claude/rules/) avec `.claude/rules/`

19* [Configurer la mémoire automatique](#auto-memory) pour que Claude prenne des notes automatiquement19* [Configurer la mémoire automatique](#auto-memory) pour que Claude prenne des notes automatiquement

20* [Dépanner](#troubleshoot-memory-issues) quand les instructions ne sont pas suivies20* [Dépanner](#troubleshoot-memory-issues) quand les instructions ne sont pas suivies

mobile.md +1 −1

Details

89Le client mobile couvre la plupart de ce dont une session a besoin, avec quelques limitations :89Le client mobile couvre la plupart de ce dont une session a besoin, avec quelques limitations :

90 90 

91* **Commandes locales uniquement** : les commandes qui s'exécutent uniquement dans l'interface du terminal, telles que `/plugin` et `/resume`, ne fonctionnent pas depuis l'application. Les [limitations de Remote Control](/docs/fr/remote-control#limitations) listent les commandes qui fonctionnent depuis mobile et comment leur comportement diffère.91* **Commandes locales uniquement** : les commandes qui s'exécutent uniquement dans l'interface du terminal, telles que `/plugin` et `/resume`, ne fonctionnent pas depuis l'application. Les [limitations de Remote Control](/docs/fr/remote-control#limitations) listent les commandes qui fonctionnent depuis mobile et comment leur comportement diffère.

92* **Modes de permission** : les sessions cloud offrent Accept edits, Plan et Auto dans le menu déroulant du mode, et les sessions Remote Control offrent Manual, Accept edits et Plan. Vous ne pouvez pas sélectionner Bypass permissions depuis l'application dans les deux cas, et vous ne pouvez pas sélectionner Auto pour une session Remote Control. Consultez [changer les modes de permission](/docs/fr/permission-modes#switch-permission-modes).92* **Modes de permission** : les sessions cloud offrent Accept edits, Plan et Auto, et les sessions Remote Control offrent Manual, Accept edits, Plan et Auto. Vous ne pouvez pas sélectionner Bypass permissions depuis l'application dans les deux cas. Consultez [changer les modes de permission](/docs/fr/permission-modes#switch-permission-modes) pour savoir quand Auto est disponible.

93* **Plans Dispatch** : Dispatch nécessite un plan Pro ou Max et n'est pas disponible sur Team ou Enterprise.93* **Plans Dispatch** : Dispatch nécessite un plan Pro ou Max et n'est pas disponible sur Team ou Enterprise.

94 94 

95<h2 id="related-resources">95<h2 id="related-resources">

model-config.md +36 −23

Details

43| **`opus[1m]`** | Utilise Opus avec une [fenêtre de contexte de 1 million de jetons](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) pour les longues sessions |43| **`opus[1m]`** | Utilise Opus avec une [fenêtre de contexte de 1 million de jetons](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) pour les longues sessions |

44| **`opusplan`** | Mode spécial qui utilise `opus` pendant le mode plan, puis bascule vers `sonnet` pour l'exécution |44| **`opusplan`** | Mode spécial qui utilise `opus` pendant le mode plan, puis bascule vers `sonnet` pour l'exécution |

45 45 

46La version à laquelle les alias `opus` et `sonnet` se résolvent dépend du fournisseur :46Les alias `opus`, `sonnet` et `haiku` se résolvent à la version la plus récente sur l'API Anthropic et à une version antérieure chez certains autres fournisseurs :

47 47 

48| Fournisseur | `opus` | `sonnet` |48| Fournisseur | `opus` | `sonnet` | `haiku` |

49| :- | :- | :- |49| :- | :- | :- | :- |

50| API Anthropic | Opus 5.5 | Sonnet 5.5 |50| API Anthropic | Opus 5.5 | Sonnet 5.5 | Haiku 5.5 |

51| [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) | Opus 5.5 | Sonnet 4.6 |51| [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) | Opus 5.5 | Sonnet 4.6 | Haiku 4.5 |

52| Amazon Bedrock, Agent Platform de Google Cloud | Opus 5.5 | Sonnet 4.5 |52| Amazon Bedrock, Agent Platform de Google Cloud | Opus 5.5 | Sonnet 4.5 | Haiku 4.5 |

53| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 |53| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 | Haiku 4.5 |

54 54 

55<span id="fable-alias-resolution" />55<span id="fable-alias-resolution" />

56 56 


58 58 

59Une passerelle qui n'est pas configurée pour servir `claude-fable-5-1` rejette les demandes pour ce modèle. Pour utiliser Fable 5.1 via une passerelle qui le sert, sélectionnez-le avec `/model claude-fable-5-1`.59Une passerelle qui n'est pas configurée pour servir `claude-fable-5-1` rejette les demandes pour ce modèle. Pour utiliser Fable 5.1 via une passerelle qui le sert, sélectionnez-le avec `/model claude-fable-5-1`.

60 60 

61Lorsqu'un alias se résout à un modèle plus ancien, les modèles plus récents sont disponibles en sélectionnant explicitement le nom de modèle complet ou en définissant `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.61Lorsque `opus` ou `sonnet` se résout à un modèle plus ancien, les modèles plus récents sont disponibles en sélectionnant explicitement le nom de modèle complet ou en définissant `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.

62 62 

63Les versions antérieures résolvent ces alias à des modèles plus anciens. Pour la version à laquelle chaque alias a changé, consultez [Historique des versions](#version-history).63Les versions antérieures résolvent ces alias à des modèles plus anciens. Pour la version à laquelle chaque alias a changé, consultez [Historique des versions](#version-history).

64 64 

65Les alias pointent vers la version recommandée pour votre fournisseur et se mettent à jour au fil du temps. Pour épingler une version spécifique, utilisez le nom de modèle complet, par exemple `claude-opus-5-5`, ou définissez la variable d'environnement correspondante comme `ANTHROPIC_DEFAULT_OPUS_MODEL`.65Les alias pointent vers la version recommandée pour votre fournisseur et se mettent à jour au fil du temps. Pour épingler une version spécifique, utilisez le nom de modèle complet, par exemple `claude-opus-5-5`, ou définissez la variable d'environnement correspondante comme `ANTHROPIC_DEFAULT_OPUS_MODEL`.

66 66 

67<Note>67<Note>

68 Sonnet 5.5 nécessite Claude Code v2.1.284 ou ultérieur, et Opus 5.5 nécessite v2.1.280 ou ultérieur. Si une demande pour l'un d'eux à partir d'une version plus ancienne échoue, consultez [Claude Code ne supporte pas ce modèle](/docs/fr/errors#claude-code-does-not-support-this-model). Exécutez `claude update` pour mettre à jour.68 Sonnet 5.5 nécessite Claude Code v2.1.284 ou ultérieur, et Opus 5.5 nécessite v2.1.280 ou ultérieur. Si une requête pour l'un d'eux à partir d'une version plus ancienne échoue, consultez [Claude Code ne supporte pas ce modèle](/docs/fr/errors#claude-code-does-not-support-this-model). Utilisez v2.1.293 ou ultérieur avec Haiku 5.5. Exécutez `claude update` pour mettre à jour.

69</Note>69</Note>

70 70 

71<h3 id="work-with-fable">71<h3 id="work-with-fable">


156 156 

157Les prix dans le sélecteur `/model` apparaissent lorsque Claude Code communique avec l'API Anthropic, directement ou via une [passerelle LLM](/docs/fr/llm-gateway) qui la proxifie, et le prix sur une ligne est le prix du modèle que cette ligne sélectionne. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations) tels qu'Amazon Bedrock et sur la [passerelle d'applications Claude](/docs/fr/claude-apps-gateway), votre fournisseur ou passerelle détermine ce que vous payez, donc les lignes du sélecteur n'affichent aucun prix. Le prix est une étiquette d'affichage uniquement ; il n'affecte pas le modèle qu'une ligne sélectionne ou ce que votre fournisseur facture. Avant v2.1.206, [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et les sessions de passerelle affichaient les prix de liste d'Anthropic, et une ligne pouvait afficher le prix d'un modèle différent de celui qu'elle sélectionnait.157Les prix dans le sélecteur `/model` apparaissent lorsque Claude Code communique avec l'API Anthropic, directement ou via une [passerelle LLM](/docs/fr/llm-gateway) qui la proxifie, et le prix sur une ligne est le prix du modèle que cette ligne sélectionne. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations) tels qu'Amazon Bedrock et sur la [passerelle d'applications Claude](/docs/fr/claude-apps-gateway), votre fournisseur ou passerelle détermine ce que vous payez, donc les lignes du sélecteur n'affichent aucun prix. Le prix est une étiquette d'affichage uniquement ; il n'affecte pas le modèle qu'une ligne sélectionne ou ce que votre fournisseur facture. Avant v2.1.206, [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et les sessions de passerelle affichaient les prix de liste d'Anthropic, et une ligne pouvait afficher le prix d'un modèle différent de celui qu'elle sélectionnait.

158 158 

159Les sessions reprises démarrées avec `claude --resume`, `--continue`, ou le sélecteur `/resume` conservent le modèle qu'elles utilisaient lorsque la transcription a été enregistrée, indépendamment du paramètre `model` actuel. Si le modèle restauré a été retiré ou est exclu par [`availableModels`](#restrict-model-selection), la session revient à l'ordre de priorité normal. Cela empêche le choix `/model` d'une autre session de modifier le modèle à la reprise. Sur les fournisseurs qui utilisent des ID de déploiement spécifiques au fournisseur plutôt que des ID de modèle Anthropic, tels qu'Amazon Bedrock, Agent Platform de Google Cloud et Microsoft Foundry, le modèle de transcription n'est pas restauré du tout et la session résout son modèle via l'ordre de priorité normal.159Les sessions reprises démarrées avec `claude --resume`, `--continue`, ou le sélecteur `/resume` conservent le modèle qu'elles utilisaient lorsque la transcription a été enregistrée. Si le modèle restauré a été retiré ou est exclu par [`availableModels`](#restrict-model-selection), la session revient à l'ordre de priorité normal. Sur les fournisseurs qui utilisent des ID de déploiement spécifiques au fournisseur plutôt que des ID de modèle Anthropic, tels qu'Amazon Bedrock, Agent Platform de Google Cloud et Microsoft Foundry, le modèle de transcription n'est pas restauré du tout et la session résout son modèle via l'ordre de priorité normal.

160 

161Si votre paramètre `model` est `haiku`, une session enregistrée sur un modèle Haiku reprend sur le modèle auquel `haiku` se résout désormais. Par exemple, une fois que `haiku` se résout à Haiku 5.5, une session enregistrée sur Haiku 4.5 reprend sur Haiku 5.5.

160 162 

161Un modèle que vous choisissez pour le nouveau lancement avec `--model` ou `ANTHROPIC_MODEL` conserve toujours la priorité sur le modèle restauré. À partir de v2.1.195, une variable de la famille [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables) aussi. [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) peut aussi, selon les conditions énumérées dans sa section.163Un modèle que vous choisissez pour le nouveau lancement avec `--model` ou `ANTHROPIC_MODEL` conserve toujours la priorité sur le modèle restauré. À partir de v2.1.195, une variable de la famille [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables) aussi. [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) peut aussi, selon les conditions énumérées dans sa section.

162 164 


645| Modèle | Niveaux |647| Modèle | Niveaux |

646| :- | :- |648| :- | :- |

647| Fable 5.1 et Fable 5 | `low`, `medium`, `high`, `xhigh`, `max` |649| Fable 5.1 et Fable 5 | `low`, `medium`, `high`, `xhigh`, `max` |

648| Opus 5.5, Sonnet 5.5, Opus 5, Sonnet 5, Opus 4.8 et Opus 4.7 | `low`, `medium`, `high`, `xhigh`, `max` |650| Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 et Opus 4.7 | `low`, `medium`, `high`, `xhigh`, `max` |

649| Opus 4.6 et Sonnet 4.6 | `low`, `medium`, `high`, `max` |651| Opus 4.6 et Sonnet 4.6 | `low`, `medium`, `high`, `max` |

650 652 

651Si vous définissez un niveau que le modèle actif ne supporte pas, Claude Code revient au niveau le plus élevé supporté au niveau ou en dessous de celui que vous avez défini. Par exemple, `xhigh` s'exécute comme `high` sur Opus 4.6. Votre organisation ou vos propres paramètres peuvent également limiter les niveaux qu'un modèle offre ; voir [Limites d'effort de l'organisation](#organization-effort-limits).653Si vous définissez un niveau que le modèle actif ne supporte pas, Claude Code revient au niveau le plus élevé supporté au niveau ou en dessous de celui que vous avez défini. Par exemple, `xhigh` s'exécute comme `high` sur Opus 4.6. Votre organisation ou vos propres paramètres peuvent également limiter les niveaux qu'un modèle offre ; voir [Limites d'effort de l'organisation](#organization-effort-limits).


654 656 

6551. Un choix explicite : la variable d'environnement [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/fr/env-vars#variables), le lancement avec `--effort`, ou `/effort` dans la session ([un `/effort` non interactif a un effet plus étroit](#non-interactive-effort))6571. Un choix explicite : la variable d'environnement [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/fr/env-vars#variables), le lancement avec `--effort`, ou `/effort` dans la session ([un `/effort` non interactif a un effet plus étroit](#non-interactive-effort))

6562. Vos paramètres : le niveau que vous avez enregistré pour le modèle ou une clé [`effortLevel`](/docs/fr/settings-reference#effortlevel), avec la priorité entre eux et entre les fichiers de paramètres énoncée à [`modelSettings`](/docs/fr/settings-reference#modelsettings)6582. Vos paramètres : le niveau que vous avez enregistré pour le modèle ou une clé [`effortLevel`](/docs/fr/settings-reference#effortlevel), avec la priorité entre eux et entre les fichiers de paramètres énoncée à [`modelSettings`](/docs/fr/settings-reference#modelsettings)

6573. L'effort par défaut du modèle : `high` sur chaque modèle qui supporte l'effort, sauf qu'Opus 5.5 et Sonnet 5.5 sont par défaut à `medium`, Opus 4.7 est par défaut à `xhigh`, et, quand votre organisation définit un niveau d'effort par défaut pour son [modèle par défaut de l'organisation](#organization-default-model), ce niveau est le défaut quand vous exécutez ce modèle. Après un secours automatique du modèle, voir [Niveau d'effort après un secours](#effort-level-after-a-fallback) pour le niveau qui s'applique.6593. L'effort par défaut du modèle : `high` sur chaque modèle qui supporte l'effort, sauf qu'Opus 5.5, Sonnet 5.5 et Haiku 5.5 sont par défaut à `medium`, Opus 4.7 est par défaut à `xhigh`, et, quand votre organisation définit un niveau d'effort par défaut pour son [modèle par défaut de l'organisation](#organization-default-model), ce niveau est le défaut quand vous exécutez ce modèle. Après un secours automatique du modèle, voir [Niveau d'effort après un secours](#effort-level-after-a-fallback) pour le niveau qui s'applique.

658 660 

659Opus 5.5 démarre à `medium` sauf si l'une des sources ci-dessus définit un niveau pour lui, et un `effortLevel` de niveau supérieur dans votre fichier de paramètres utilisateur ne compte pas pour Opus 5.5. Cette clé est la forme plus ancienne que `/effort` écrivait avant que Claude Code enregistre les niveaux par modèle : elle continue à s'appliquer où elle s'appliquait avant, sur Opus 5, Fable 5.1 et les modèles antérieurs, tandis qu'Opus 5.5 et les modèles publiés après lui démarrent à leur propre défaut jusqu'à ce que vous choisissiez un niveau pour eux avec `/effort` ou le sélecteur `/model`. Un `effortLevel` de niveau supérieur dans les paramètres de projet, locaux ou gérés, ou un passé avec `--settings`, s'applique à chaque modèle.661Opus 5.5 démarre à `medium` sauf si l'une des sources ci-dessus définit un niveau pour lui, et un `effortLevel` de niveau supérieur dans votre fichier de paramètres utilisateur ne compte pas pour Opus 5.5. Cette clé est la forme plus ancienne que `/effort` écrivait avant que Claude Code enregistre les niveaux par modèle : elle continue à s'appliquer où elle s'appliquait avant, sur Opus 5, Fable 5.1 et les modèles antérieurs, tandis qu'Opus 5.5 et les modèles publiés après lui démarrent à leur propre défaut jusqu'à ce que vous choisissiez un niveau pour eux avec `/effort` ou le sélecteur `/model`. Un `effortLevel` de niveau supérieur dans les paramètres de projet, locaux ou gérés, ou un passé avec `--settings`, s'applique à chaque modèle.

660 662 


709| Niveau | Quand l'utiliser |711| Niveau | Quand l'utiliser |

710| :- | :- |712| :- | :- |

711| `low` | Échanges rapides où vous examinez chaque résultat, comme le brainstorming, un premier brouillon, ou une petite modification comme un renommage |713| `low` | Échanges rapides où vous examinez chaque résultat, comme le brainstorming, un premier brouillon, ou une petite modification comme un renommage |

712| `medium` | Le défaut sur Opus 5.5 et Sonnet 5.5, où il convient au travail d'ingénierie quotidien avec une portée claire, comme l'implémentation d'une nouvelle fonctionnalité. Sur d'autres modèles, réduit l'utilisation de jetons pour le travail sensible aux coûts qui peut faire des compromis sur une certaine intelligence |714| `medium` | Le défaut sur Opus 5.5, Sonnet 5.5 et Haiku 5.5. Sur Opus 5.5 et Sonnet 5.5, il convient au travail d'ingénierie quotidien avec une portée claire, comme l'implémentation d'une nouvelle fonctionnalité. Sur les modèles avec un défaut plus élevé, réduit l'utilisation de tokens pour le travail sensible aux coûts qui peut sacrifier une part d'intelligence |

713| `high` | Travail où la vérification compte ou les cas limites sont probables, comme corriger un bug dans une base de code existante. Le défaut sur chaque modèle sauf Opus 5.5, Sonnet 5.5 et Opus 4.7 |715| `high` | Travail où la vérification compte ou les cas limites sont probables, comme corriger un bug dans une base de code existante. Le défaut sur chaque modèle sauf Opus 5.5, Sonnet 5.5, Haiku 5.5 et Opus 4.7 |

714| `xhigh` | Raisonnement plus profond à une dépense de jetons plus élevée. Le défaut sur Opus 4.7 |716| `xhigh` | Raisonnement plus profond à une dépense de jetons plus élevée. Le défaut sur Opus 4.7 |

715| `max` | Problèmes difficiles que vous voulez que Claude travaille sans vous, comme trouver des vulnérabilités de sécurité. `max` peut montrer des rendements décroissants et est sujet à la surréflexion, donc testez avant d'adopter largement |717| `max` | Problèmes difficiles que vous voulez que Claude travaille sans vous, comme trouver des vulnérabilités de sécurité. `max` peut montrer des rendements décroissants et est sujet à la surréflexion, donc testez avant d'adopter largement |

716| `ultracode` | Un paramètre Claude Code plutôt qu'un niveau : planifie un [flux de travail dynamique](/docs/fr/workflows) pour chaque tâche substantielle à quel que soit le niveau d'effort |718| `ultracode` | Un paramètre Claude Code plutôt qu'un niveau : planifie un [flux de travail dynamique](/docs/fr/workflows) pour chaque tâche substantielle à quel que soit le niveau d'effort |


753 755 

754Le raisonnement adaptatif rend la réflexion optionnelle à chaque étape, de sorte que Claude peut répondre plus rapidement aux invites de routine et réserver une réflexion plus profonde pour les étapes qui en bénéficient. Si vous voulez que Claude pense plus ou moins souvent que le niveau actuel ne produit, vous pouvez le dire directement dans votre invite ou dans `CLAUDE.md` ; le modèle répond à cette orientation dans son paramètre d'effort.756Le raisonnement adaptatif rend la réflexion optionnelle à chaque étape, de sorte que Claude peut répondre plus rapidement aux invites de routine et réserver une réflexion plus profonde pour les étapes qui en bénéficient. Si vous voulez que Claude pense plus ou moins souvent que le niveau actuel ne produit, vous pouvez le dire directement dans votre invite ou dans `CLAUDE.md` ; le modèle répond à cette orientation dans son paramètre d'effort.

755 757 

756Les modèles Fable, Sonnet 5 et ultérieur, et Opus 4.7 et ultérieur utilisent toujours le raisonnement adaptatif. Le mode de budget de réflexion fixe et `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` ne s'y appliquent pas.758Les modèles Fable, Sonnet 5 et ultérieurs, Haiku 5.5, et Opus 4.7 et ultérieurs utilisent toujours le raisonnement adaptatif. Le mode de budget de réflexion fixe et `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` ne s'y appliquent pas.

757 759 

758Sur Opus 4.6 et Sonnet 4.6, vous pouvez définir `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` pour revenir au budget de réflexion fixe précédent contrôlé par `MAX_THINKING_TOKENS`. Voir [variables d'environnement](/docs/fr/env-vars).760Sur Opus 4.6 et Sonnet 4.6, vous pouvez définir `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` pour revenir au budget de réflexion fixe précédent contrôlé par `MAX_THINKING_TOKENS`. Voir [variables d'environnement](/docs/fr/env-vars).

759 761 


767| :- | :- |769| :- | :- |

768| Basculer pour la session actuelle | Appuyez sur `Option+T` sur macOS ou `Alt+T` sur Windows et Linux |770| Basculer pour la session actuelle | Appuyez sur `Option+T` sur macOS ou `Alt+T` sur Windows et Linux |

769| Définir le défaut global | Exécutez `/config` et basculez le mode de réflexion. Enregistré comme `alwaysThinkingEnabled` dans `~/.claude/settings.json` |771| Définir le défaut global | Exécutez `/config` et basculez le mode de réflexion. Enregistré comme `alwaysThinkingEnabled` dans `~/.claude/settings.json` |

770| Désactiver via une variable d'environnement | Définissez [`MAX_THINKING_TOKENS=0`](/docs/fr/env-vars), qui désactive la réflexion sur l'API Anthropic sauf sur Opus 5.5, Sonnet 5.5 et les modèles Fable. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations), Claude Code omet le paramètre `thinking` à la place, et les modèles à raisonnement adaptatif peuvent toujours réfléchir |772| Désactiver via une variable d'environnement | Définissez [`MAX_THINKING_TOKENS=0`](/docs/fr/env-vars), qui désactive la réflexion sur l'API Anthropic sauf sur Opus 5.5, Sonnet 5.5, Haiku 5.5 et les modèles Fable. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations), Claude Code omet le paramètre `thinking` à la place, et les modèles à raisonnement adaptatif peuvent toujours réfléchir |

771 773 

772Vous ne pouvez pas désactiver la réflexion sur Opus 5.5, Sonnet 5.5 ou les modèles Fable. Le basculement de session et le `/config` affichent `Thinking can't be turned off` pour ces modèles à la place d'offrir le basculement, et une `alwaysThinkingEnabled: false` enregistrée ou `MAX_THINKING_TOKENS=0` n'a aucun effet là. Sur ces modèles, le modèle décide à chaque étape combien penser en fonction du niveau d'effort. Le paramètre enregistré s'applique à nouveau quand vous basculez vers un modèle qui l'accepte.774Vous ne pouvez pas désactiver la réflexion sur Opus 5.5, Sonnet 5.5, Haiku 5.5 ou les modèles Fable. Le basculement de session et la ligne `/config` affichent `Thinking can't be turned off` pour ces modèles au lieu de proposer le basculement, et un `alwaysThinkingEnabled: false` enregistré ou `MAX_THINKING_TOKENS=0` n'a aucun effet sur eux. Sur ces modèles, le modèle décide à chaque étape dans quelle mesure réfléchir en fonction du niveau d'effort. Le paramètre enregistré s'applique à nouveau quand vous basculez vers un modèle qui l'accepte.

773 775 

774Claude Code réduit la sortie de réflexion par défaut. Appuyez sur `Ctrl+O` pour basculer le mode verbeux et voir le raisonnement en tant que texte gris en italique. Les sessions interactives sur l'API Anthropic reçoivent des blocs de réflexion édités par défaut, donc définissez `showThinkingSummaries: true` dans les [paramètres](/docs/fr/settings) si vous voulez les résumés complets disponibles quand vous développez. Vous êtes facturé pour tous les jetons de réflexion générés, même quand réduits ou édités.776Claude Code réduit la sortie de réflexion par défaut. Appuyez sur `Ctrl+O` pour basculer le mode verbeux et voir le raisonnement en tant que texte gris en italique. Les sessions interactives sur l'API Anthropic reçoivent des blocs de réflexion édités par défaut, donc définissez `showThinkingSummaries: true` dans les [paramètres](/docs/fr/settings) si vous voulez les résumés complets disponibles quand vous développez. Vous êtes facturé pour tous les jetons de réflexion générés, même quand réduits ou édités.

775 777 


779 Contexte étendu781 Contexte étendu

780</h3>782</h3>

781 783 

782Fable 5.1, Fable 5, Sonnet 5 et ultérieur, Opus 4.6 et ultérieur, et Sonnet 4.6 supportent une [fenêtre de contexte de 1 million de jetons](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) pour les sessions longues avec de grandes bases de code.784Fable 5.1, Fable 5, Sonnet 5 et ultérieurs, Haiku 5.5, Opus 4.6 et ultérieurs, et Sonnet 4.6 supportent une [fenêtre de contexte de 1 million de tokens](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) pour les sessions longues avec de grandes bases de code.

783 785 

784Sur l'API Anthropic, Fable 5.1, Fable 5, Sonnet 5 et ultérieur, et Opus 4.7 et ultérieur s'exécutent avec la fenêtre de 1M par défaut sur chaque plan, y compris Pro. Vous ne sélectionnez pas une variante `[1m]` ou n'activez pas les crédits d'utilisation pour la fenêtre de 1M sur ces modèles. L'utilisation de Fable elle-même peut être facturée aux crédits d'utilisation sur certains plans ; voir [Fable et crédits d'utilisation](#fable-and-usage-credits).786Sur l'API Anthropic, Fable 5.1, Fable 5, Sonnet 5 et ultérieurs, Haiku 5.5, et Opus 4.7 et ultérieurs s'exécutent avec la fenêtre de 1M sur chaque plan, y compris Pro. Vous n'avez pas à sélectionner une variante `[1m]` ni à activer les crédits d'utilisation pour la fenêtre de 1M sur ces modèles. L'utilisation de Fable elle-même peut être facturée aux crédits d'utilisation sur certains plans ; voir [Fable et crédits d'utilisation](#fable-and-usage-credits).

785 787 

786Opus 4.6 et Sonnet 4.6 n'atteignent 1M que via leur variante `[1m]`, et l'accès à cette variante dépend de votre plan. Sur les plans Max, Team et Enterprise, y compris les sièges Team Standard et Team Premium, Opus 4.6 avec un contexte de 1M est inclus avec votre abonnement. Sonnet 4.6 avec un contexte de 1M nécessite des [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) sur chaque plan d'abonnement, y compris Max.788Opus 4.6 et Sonnet 4.6 n'atteignent 1M que via leur variante `[1m]`, et l'accès à cette variante dépend de votre plan. Sur les plans Max, Team et Enterprise, y compris les sièges Team Standard et Team Premium, Opus 4.6 avec un contexte de 1M est inclus avec votre abonnement. Sonnet 4.6 avec un contexte de 1M nécessite des [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) sur chaque plan d'abonnement, y compris Max.

787 789 


795 797 

796<span id="context-window-behind-a-gateway" />798<span id="context-window-behind-a-gateway" />

797 799 

798Si vous définissez `ANTHROPIC_BASE_URL` sur une [passerelle LLM](/docs/fr/llm-gateway) ou un autre proxy, Claude Code donne à chaque modèle qu'il reconnaît la même fenêtre de contexte que celle du modèle sur l'API Anthropic. Fable 5.1, Fable 5, Sonnet 5 et ultérieurs, et Opus 4.7 et ultérieurs obtiennent la fenêtre de 1M sans variante `[1m]` à sélectionner, et un modèle qui n'atteint 1M que via sa variante `[1m]`, comme Opus 4.6, s'exécute à 200K sans elle. Claude Code ne peut pas détecter une limite inférieure appliquée par la passerelle ou le serveur situé derrière elle. Si votre passerelle rejette les requêtes au-delà de 200K tokens, définissez [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/fr/env-vars) dans l'environnement qui démarre Claude Code, afin que les sessions sur chaque modèle [se compactent à cette limite](#set-the-auto-compact-window).800Si vous définissez `ANTHROPIC_BASE_URL` sur une [passerelle LLM](/docs/fr/llm-gateway) ou un autre proxy, Claude Code donne à chaque modèle qu'il reconnaît la même fenêtre de contexte que celle du modèle sur l'API Anthropic. Fable 5.1, Fable 5, Sonnet 5 et ultérieurs, Haiku 5.5, et Opus 4.7 et ultérieurs obtiennent la fenêtre de 1M sans variante `[1m]` à sélectionner, et un modèle qui n'atteint 1M que via sa variante `[1m]`, comme Opus 4.6, s'exécute à 200K sans elle. Claude Code ne peut pas détecter une limite inférieure appliquée par la passerelle ou le serveur situé derrière elle. Si votre passerelle rejette les requêtes au-delà de 200K tokens, définissez [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/fr/env-vars) dans l'environnement qui démarre Claude Code, afin que les sessions sur chaque modèle [se compactent à cette limite](#set-the-auto-compact-window).

799 801 

800Pour désactiver le contexte de 1M, définissez `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code supprime les variantes de modèle de 1M du sélecteur de modèle. Sur les modèles avec une fenêtre de 1M native, comme Sonnet 5 et les modèles Fable, il traite également le modèle comme ayant une fenêtre de contexte de 200K :802Pour désactiver le contexte de 1M, définissez `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code supprime les variantes de modèle de 1M du sélecteur de modèle. Sur les modèles avec une fenêtre de 1M native, comme Sonnet 5 et les modèles Fable, il traite également le modèle comme ayant une fenêtre de contexte de 200K :

801 803 


804 806 

805Avant la v2.1.223, Claude Code tenait uniquement Sonnet 5, Opus 4.8 et Opus 5 sessions à 200K. Voir [variables d'environnement](/docs/fr/env-vars).807Avant la v2.1.223, Claude Code tenait uniquement Sonnet 5, Opus 4.8 et Opus 5 sessions à 200K. Voir [variables d'environnement](/docs/fr/env-vars).

806 808 

807La fenêtre de contexte de 1M utilise la tarification standard du modèle sans prime pour les jetons au-delà de 200K. Pour les plans où le contexte étendu est inclus avec votre abonnement, l'utilisation reste couverte par votre abonnement. Pour les plans qui accèdent au contexte étendu via des crédits d'utilisation, les jetons sont facturés aux crédits d'utilisation.809La fenêtre de contexte de 1M utilise la tarification standard du modèle sans prime pour les tokens au-delà de 200K, sauf sur Haiku 5.5, qui [coûte plus cher sur les prompts de plus de 100K tokens](#haiku-5-5-context-window-and-pricing). Pour les plans où le contexte étendu est inclus avec votre abonnement, l'utilisation reste couverte par votre abonnement. Pour les plans qui accèdent au contexte étendu via des crédits d'utilisation, les tokens sont facturés aux crédits d'utilisation.

808 810 

809Si votre compte supporte le contexte de 1M, l'option apparaît dans le sélecteur `/model` dans les dernières versions de Claude Code. Si vous ne la voyez pas, redémarrez votre session, et sur un fournisseur tiers vérifiez si votre déploiement [a épinglé le modèle](#pin-models-for-third-party-deployments) avec une variable `ANTHROPIC_DEFAULT_*_MODEL`.811Si votre compte supporte le contexte de 1M, l'option apparaît dans le sélecteur `/model` dans les dernières versions de Claude Code. Si vous ne la voyez pas, redémarrez votre session, et sur un fournisseur tiers vérifiez si votre déploiement [a épinglé le modèle](#pin-models-for-third-party-deployments) avec une variable `ANTHROPIC_DEFAULT_*_MODEL`.

810 812 


831 833 

832* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`** : tient les sessions sur chaque modèle avec une fenêtre de 1M native à une fenêtre de 200K ; voir [Contexte étendu](#extended-context) pour comment la retenue est appliquée. Utile pour les déploiements qui ont besoin de limiter le contexte.834* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`** : tient les sessions sur chaque modèle avec une fenêtre de 1M native à une fenêtre de 200K ; voir [Contexte étendu](#extended-context) pour comment la retenue est appliquée. Utile pour les déploiements qui ont besoin de limiter le contexte.

833 835 

836<h4 id="haiku-5-5-context-window-and-pricing">

837 Fenêtre de contexte et tarification de Haiku 5.5

838</h4>

839 

840Sur l'API Anthropic, Haiku 5.5 s'exécute avec la fenêtre de contexte de 1M sur chaque plan, sans suffixe `[1m]` à sélectionner. Son ID de modèle est `claude-haiku-5-5`. Pour l'utiliser, exécutez `/model claude-haiku-5-5` dans une session, ou démarrez Claude Code depuis votre shell avec `claude --model claude-haiku-5-5`.

841 

842Une requête Haiku 5.5 coûte plus cher par token quand son prompt dépasse 100K tokens. Consultez la [tarification d'Anthropic](https://platform.claude.com/docs/en/about-claude/pricing) pour les deux tarifs.

843 

844Les sessions se compactent automatiquement à environ 967K tokens par défaut. Pour compacter plus tôt, [définissez une fenêtre de compaction automatique plus petite](#set-the-auto-compact-window) pour le modèle.

845 

834<h2 id="context-window-and-auto-compaction">846<h2 id="context-window-and-auto-compaction">

835 Fenêtre de contexte et compaction automatique847 Fenêtre de contexte et compaction automatique

836</h2>848</h2>


865* Les [sessions cloud](/docs/fr/claude-code-on-the-web) se compactent à mesure que la conversation approche de la limite du modèle877* Les [sessions cloud](/docs/fr/claude-code-on-the-web) se compactent à mesure que la conversation approche de la limite du modèle

866* Sonnet 4.6 et Opus 4.6 sans [contexte étendu](#extended-context) se compactent à la limite de 200 K, tout comme Opus 4.8 et versions ultérieures lorsqu'ils s'exécutent avec une fenêtre de contexte de 200 K, comme sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry878* Sonnet 4.6 et Opus 4.6 sans [contexte étendu](#extended-context) se compactent à la limite de 200 K, tout comme Opus 4.8 et versions ultérieures lorsqu'ils s'exécutent avec une fenêtre de contexte de 200 K, comme sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry

867* Lorsque vous définissez [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/fr/env-vars), les modèles avec une fenêtre native de 1 M, comme Sonnet 5 et les modèles Fable, se compactent à la limite de 200 K879* Lorsque vous définissez [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/fr/env-vars), les modèles avec une fenêtre native de 1 M, comme Sonnet 5 et les modèles Fable, se compactent à la limite de 200 K

868* Les modèles s'exécutant avec une fenêtre native de 1 M se compactent avant que la fenêtre ne se remplisse, à environ 967 K jetons par défaut. Sur l'API Anthropic, ceux-ci incluent Sonnet 5, les modèles Fable, et Opus 4.7 et versions ultérieures. Sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, consultez [Épingler les modèles pour les déploiements tiers](#pin-models-for-third-party-deployments) pour savoir quels modèles s'exécutent avec cette fenêtre. Derrière une `ANTHROPIC_BASE_URL` personnalisée, consultez [la fenêtre de contexte derrière une passerelle](#context-window-behind-a-gateway)880* Les modèles s'exécutant avec une fenêtre native de 1 M se compactent avant que la fenêtre ne se remplisse, à environ 967 K tokens par défaut. Sur l'API Anthropic, ceux-ci incluent Sonnet 5, Haiku 5.5, les modèles Fable, et Opus 4.7 et versions ultérieures. Sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, consultez [Épingler les modèles pour les déploiements tiers](#pin-models-for-third-party-deployments) pour savoir quels modèles s'exécutent avec cette fenêtre. Derrière une `ANTHROPIC_BASE_URL` personnalisée, consultez [la fenêtre de contexte derrière une passerelle](#context-window-behind-a-gateway)

869* Les sessions sur un ID de modèle que Claude Code ne reconnaît pas, comme un alias de [passerelle LLM](/docs/fr/llm-gateway), se compactent à la fenêtre de contexte que Claude Code suppose pour l'ID ; consultez [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](#correct-the-window-for-a-gateway-or-custom-model-id)881* Les sessions sur un ID de modèle que Claude Code ne reconnaît pas, comme un alias de [passerelle LLM](/docs/fr/llm-gateway), se compactent à la fenêtre de contexte que Claude Code suppose pour l'ID ; consultez [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](#correct-the-window-for-a-gateway-or-custom-model-id)

870 882 

871<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">883<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">


1093 1105 

1094| Version | Modification |1106| Version | Modification |

1095| :- | :- |1107| :- | :- |

1108| v2.1.293 | `haiku` résout vers Haiku 5.5 sur l'API Anthropic |

1096| v2.1.284 | `sonnet` résout vers Sonnet 5.5 sur l'API Anthropic |1109| v2.1.284 | `sonnet` résout vers Sonnet 5.5 sur l'API Anthropic |

1097| v2.1.280 | `opus` résout vers Opus 5.5 sur l'API Anthropic, Claude Platform sur AWS, Amazon Bedrock et Agent Platform de Google Cloud |1110| v2.1.280 | `opus` résout vers Opus 5.5 sur l'API Anthropic, Claude Platform sur AWS, Amazon Bedrock et Agent Platform de Google Cloud |

1098| v2.1.257 | `fable` résout vers Fable 5.1, sauf dans les sessions de passerelle des applications Claude |1111| v2.1.257 | `fable` résout vers Fable 5.1, sauf dans les sessions de passerelle des applications Claude |


1100| v2.1.207 | `opus` résout vers Opus 4.8 sur Claude Platform sur AWS, Amazon Bedrock et Agent Platform |1113| v2.1.207 | `opus` résout vers Opus 4.8 sur Claude Platform sur AWS, Amazon Bedrock et Agent Platform |

1101| v2.1.197 | `sonnet` résout vers Sonnet 5 sur l'API Anthropic |1114| v2.1.197 | `sonnet` résout vers Sonnet 5 sur l'API Anthropic |

1102| v2.1.154 | `opus` résout vers Opus 4.8 sur l'API Anthropic |1115| v2.1.154 | `opus` résout vers Opus 4.8 sur l'API Anthropic |

1103| Antérieur | `opus` résout vers Opus 4.7 sur Claude Platform sur AWS et vers Opus 4.6 sur Amazon Bedrock et Agent Platform. `fable` résout vers Fable 5 sur chaque fournisseur |1116| Antérieur | `opus` résout vers Opus 4.7 sur Claude Platform sur AWS et vers Opus 4.6 sur Amazon Bedrock et Agent Platform. `fable` résout vers Fable 5 et `haiku` résout vers Haiku 4.5 sur chaque fournisseur |

Details

551* **Paramètres gérés par le serveur** : ajoutez-les au bloc `env` des [paramètres gérés par le serveur](/docs/fr/server-managed-settings) de votre organisation. Claude Code récupère ces paramètres au démarrage partout où [les paramètres gérés par le serveur s'appliquent](/docs/fr/model-config#surface-coverage), ce qui inclut les machines de vos utilisateurs et les sessions cloud autres que les sessions du canal Claude Tag. Les sessions Claude Tag ne reçoivent pas vos paramètres gérés par le serveur, donc cette route ne les configure pas.551* **Paramètres gérés par le serveur** : ajoutez-les au bloc `env` des [paramètres gérés par le serveur](/docs/fr/server-managed-settings) de votre organisation. Claude Code récupère ces paramètres au démarrage partout où [les paramètres gérés par le serveur s'appliquent](/docs/fr/model-config#surface-coverage), ce qui inclut les machines de vos utilisateurs et les sessions cloud autres que les sessions du canal Claude Tag. Les sessions Claude Tag ne reçoivent pas vos paramètres gérés par le serveur, donc cette route ne les configure pas.

552* **Les variables de l'environnement** : ajoutez-les aux [variables d'environnement](/docs/fr/cloud-environments#set-environment-variables) d'un environnement cloud pour configurer uniquement les sessions qui s'exécutent dans cet environnement. C'est la route qui atteint les sessions Claude Tag.552* **Les variables de l'environnement** : ajoutez-les aux [variables d'environnement](/docs/fr/cloud-environments#set-environment-variables) d'un environnement cloud pour configurer uniquement les sessions qui s'exécutent dans cet environnement. C'est la route qui atteint les sessions Claude Tag.

553 553 

554Quiconque utilise un environnement peut lire ses variables, donc ne mettez pas une credential là, comme un jeton de collecteur dans `OTEL_EXPORTER_OTLP_HEADERS`. Une [credential API](/docs/fr/cloud-environments#add-api-credentials) sur l'environnement n'aide pas non plus, car l'export de télémétrie propre de Claude Code est l'une des [requêtes qui ne reçoivent jamais la credential](/docs/fr/cloud-environments#requests-that-never-get-the-credential). Si votre collecteur nécessite une credential, configurez l'export entier via les paramètres gérés par le serveur à la place, car lorsque vous définissez une credential là, [Claude Code supprime les variables de point de terminaison définies en dehors des paramètres gérés](#how-managed-settings-lock-the-otlp-destination).554Quiconque utilise un environnement peut lire ses variables, donc n'y placez pas d'identifiants, comme un jeton de collecteur dans `OTEL_EXPORTER_OTLP_HEADERS`. Un [secret réseau](/docs/fr/cloud-environments#add-api-credentials) sur l'environnement n'aide pas non plus, car l'export de télémétrie propre de Claude Code est l'une des [requêtes qui ne reçoivent jamais le secret](/docs/fr/cloud-environments#requests-that-never-get-the-credential). Si votre collecteur nécessite des identifiants, configurez l'export entier via les paramètres gérés par le serveur à la place, car lorsque vous y définissez des identifiants, [Claude Code supprime les variables d'endpoint définies en dehors des paramètres gérés](#how-managed-settings-lock-the-otlp-destination).

555 555 

556Gardez ces contraintes à l'esprit lorsque vous configurez la télémétrie pour les sessions cloud :556Gardez ces contraintes à l'esprit lorsque vous configurez la télémétrie pour les sessions cloud :

557 557 

overview.md +7 −5

Details

28 curl -fsSL https://claude.ai/install.sh | bash28 curl -fsSL https://claude.ai/install.sh | bash

29 ```29 ```

30 30 

31 Sur Windows, votre invite affiche `PS C:\` quand vous êtes dans PowerShell et `C:\` sans le `PS` quand vous êtes dans CMD.

32 

31 **Windows PowerShell :**33 **Windows PowerShell :**

32 34 

33 ```powershell theme={null}35 ```powershell theme={null}


42 44 

43 Quand l'installateur se termine, ouvrez une nouvelle fenêtre de terminal et exécutez `claude --version`. Une installation fonctionnelle affiche un numéro de version. Si votre shell dit que `claude` n'est pas trouvé ou n'est pas reconnu, le répertoire d'installation n'est pas encore sur votre PATH : consultez [Corriger votre PATH](/docs/fr/troubleshoot-install#command-not-found-claude-after-installation).45 Quand l'installateur se termine, ouvrez une nouvelle fenêtre de terminal et exécutez `claude --version`. Une installation fonctionnelle affiche un numéro de version. Si votre shell dit que `claude` n'est pas trouvé ou n'est pas reconnu, le répertoire d'installation n'est pas encore sur votre PATH : consultez [Corriger votre PATH](/docs/fr/troubleshoot-install#command-not-found-claude-after-installation).

44 46 

45 Si vous voyez `The token '&&' is not a valid statement separator`, vous êtes dans PowerShell, pas dans CMD. Si vous voyez `'irm' is not recognized as an internal or external command`, vous êtes dans CMD, pas dans PowerShell. Votre invite affiche `PS C:\` quand vous êtes dans PowerShell et `C:\` sans le `PS` quand vous êtes dans CMD.47 Si vous voyez `The token '&&' is not a valid statement separator`, vous êtes dans PowerShell, pas dans CMD. Si vous voyez `'irm' is not recognized as an internal or external command`, vous êtes dans CMD, pas dans PowerShell.

46 48 

47 Si la commande d'installation échoue avec `syntax error near unexpected token '<'`, un `403`, ou une autre erreur curl, consultez [Dépannage de l'installation](/docs/fr/troubleshoot-install#find-your-error) pour faire correspondre l'erreur à une solution et pour connaître les méthodes d'installation alternatives.49 Si la commande d'installation échoue avec `syntax error near unexpected token '<'`, un `403`, ou toute autre erreur, consultez [Dépannage de l'installation](/docs/fr/troubleshoot-install#find-your-error) pour faire correspondre l'erreur à une solution et pour connaître les méthodes d'installation alternatives.

48 50 

49 [Git for Windows](https://git-scm.com/downloads/win) est recommandé sur Windows natif afin que Claude Code puisse utiliser l'outil Bash. Si Git for Windows n'est pas installé, Claude Code utilise PowerShell comme outil shell à la place. Les configurations WSL n'ont pas besoin de Git for Windows.51 [Git for Windows](https://git-scm.com/downloads/win) est recommandé sur Windows natif afin que Claude Code puisse utiliser l'outil Bash. Si Git for Windows n'est pas installé, Claude Code utilise PowerShell comme outil shell à la place. Les configurations WSL n'ont pas besoin de Git for Windows.

50 52 


85 claude87 claude

86 ```88 ```

87 89 

88 Vous serez invité à vous connecter lors de la première utilisation. Si vous avez défini la variable d'environnement `ANTHROPIC_API_KEY`, Claude Code ignore l'invite de connexion et vous demande plutôt d'approuver la clé. C'est tout ! [Continuez avec le Démarrage rapide →](/docs/fr/quickstart)90 Claude Code vous demande de vous connecter lors de la première utilisation. Si vous avez défini la variable d'environnement `ANTHROPIC_API_KEY` et que vous approuvez la clé lorsque Claude Code vous demande s'il doit l'utiliser, Claude Code ignore l'invite de connexion. [Continuez avec le Démarrage rapide →](/docs/fr/quickstart)

89 91 

90 <Tip>92 <Tip>

91 Consultez la [configuration avancée](/docs/fr/setup) pour les options d'installation, les mises à jour manuelles ou les instructions de désinstallation. Visitez la [résolution des problèmes d'installation](/docs/fr/troubleshoot-install) si vous rencontrez des problèmes.93 Consultez la [configuration avancée](/docs/fr/setup) pour les options d'installation, les mises à jour manuelles ou les instructions de désinstallation. Visitez la [résolution des problèmes d'installation](/docs/fr/troubleshoot-install) si vous rencontrez des problèmes.


163 claude "commit my changes with a descriptive message"165 claude "commit my changes with a descriptive message"

164 ```166 ```

165 167 

166 En CI, vous pouvez automatiser l'examen du code et le triage des problèmes avec [GitHub Actions](/docs/fr/github-actions) ou [GitLab CI/CD](/docs/fr/gitlab-ci-cd).168 En CI, vous pouvez automatiser la revue de code et le triage des problèmes avec [GitHub Actions](/docs/fr/github-actions) ou [GitLab CI/CD](/docs/fr/gitlab-ci-cd).

167 </Accordion>169 </Accordion>

168 170 

169 <Accordion title="Connecter vos outils avec MCP" icon="plug">171 <Accordion title="Connecter vos outils avec MCP" icon="plug">


171 </Accordion>173 </Accordion>

172 174 

173 <Accordion title="Personnaliser avec des instructions, des skills et des hooks" icon="sliders">175 <Accordion title="Personnaliser avec des instructions, des skills et des hooks" icon="sliders">

174 [`CLAUDE.md`](/docs/fr/memory) est un fichier markdown que vous ajoutez à la racine de votre projet que Claude Code lit au début de chaque session. Utilisez-le pour définir les normes de codage, les décisions architecturales, les bibliothèques préférées et les listes de contrôle d'examen. Si votre référentiel possède déjà un `AGENTS.md` pour d'autres agents de codage, Claude Code [peut le lire](/docs/fr/memory#agents-md) seul ou aux côtés de `CLAUDE.md`. Claude construit également une [mémoire automatique](/docs/fr/memory#auto-memory) au fur et à mesure qu'il travaille, en sauvegardant les apprentissages entre les sessions sans que vous ayez à écrire quoi que ce soit.176 [`CLAUDE.md`](/docs/fr/memory) est un fichier markdown que vous ajoutez à la racine de votre projet et que Claude Code lit au début de chaque session. Utilisez-le pour définir les normes de codage, les décisions architecturales, les bibliothèques préférées et les listes de contrôle de revue. Si votre dépôt possède déjà un `AGENTS.md` pour d'autres agents de codage, Claude Code [peut le lire](/docs/fr/memory#agents-md) à la place d'un `CLAUDE.md`. Claude construit également une [mémoire automatique](/docs/fr/memory#auto-memory) au fur et à mesure qu'il travaille, en sauvegardant les apprentissages entre les sessions sans que vous ayez à écrire quoi que ce soit.

175 177 

176 Créez des [skills](/docs/fr/skills) pour empaqueter les flux de travail répétables que votre équipe peut partager, comme `/review-pr` ou `/deploy-staging`.178 Créez des [skills](/docs/fr/skills) pour empaqueter les flux de travail répétables que votre équipe peut partager, comme `/review-pr` ou `/deploy-staging`.

177 179 

Details

233 </Tab>233 </Tab>

234 234 

235 <Tab title="Web and mobile">235 <Tab title="Web and mobile">

236 Utilisez la liste déroulante de mode à côté de la zone de saisie sur [claude.ai/code](https://claude.ai/code) ou dans l'application mobile. Les invites de permission apparaissent dans claude.ai pour approbation. Les modes qui apparaissent dépendent de l'endroit où la session s'exécute :236 Sur [claude.ai/code](https://claude.ai/code), utilisez la liste déroulante de mode à côté de la zone de saisie. Dans l'application mobile, appuyez sur le bouton **+** dans la zone de saisie, puis sur **Permission**. Les sessions cloud et les sessions Remote Control proposent des modes de permission différents :

237 237 

238 * **[Sessions cloud](/docs/fr/claude-code-on-the-web)** : Accept edits, Plan et Auto. Accept edits correspond au mode `default` : les sessions cloud pré-approuvent les modifications de fichiers quel que soit le mode, donc la liste déroulante affiche Accept edits au lieu de Manual. Les sessions cloud honorent toujours `defaultMode: "acceptEdits"` à partir des paramètres. Le mode Auto n'apparaît que quand votre organisation le permet et que le modèle sélectionné le supporte. Bypass permissions n'est pas disponible.238 * **[Sessions cloud](/docs/fr/claude-code-on-the-web)** : Accept edits, Plan et Auto. Accept edits correspond au mode `default` : les sessions cloud pré-approuvent les modifications de fichiers quel que soit le mode, donc la liste déroulante affiche Accept edits au lieu de Manual. Les sessions cloud honorent toujours `defaultMode: "acceptEdits"` à partir des paramètres. Le mode Auto n'apparaît que quand votre organisation le permet et que le modèle sélectionné le supporte. Bypass permissions n'est pas disponible.

239 * **[Sessions Remote Control](/docs/fr/remote-control)** sur votre machine locale : Manual, Accept edits et Plan pour une session que vous avez démarrée vous-même, et vous ne pouvez pas sélectionner Auto ou Bypass permissions à partir de l'application. Pour un fil de projet s'exécutant sur votre ordinateur, voir [Exécuter un fil sur votre propre ordinateur](/docs/fr/claude-projects#run-a-thread-on-your-own-computer).239 * **[Sessions Remote Control](/docs/fr/remote-control)** sur votre machine locale : Manual, Accept edits, Plan et Auto pour une session que vous avez démarrée vous-même, et vous ne pouvez pas sélectionner Bypass permissions à partir de l'application. Pour utiliser Auto, la session doit satisfaire les [conditions de disponibilité](#eliminate-prompts-with-auto-mode) du mode auto. Pour un fil de projet s'exécutant sur votre ordinateur, voir [Exécuter un fil sur votre propre ordinateur](/docs/fr/claude-projects#run-a-thread-on-your-own-computer).

240 * Sauf pour Bypass permissions, la liste déroulante affiche le mode de permission dans lequel se trouve la session locale, y compris un mode défini à partir du terminal. Elle se met à jour quand le mode de permission change dans l'application ou dans le terminal.240 * Sauf pour Bypass permissions, la liste déroulante affiche le mode de permission dans lequel se trouve la session locale, y compris un mode défini à partir du terminal. Elle se met à jour quand le mode de permission change dans l'application ou dans le terminal.

241 * Les sessions hébergées par l'[application de bureau](/docs/fr/desktop) ou l'[extension VS Code](/docs/fr/vs-code) signalent les changements de mode de permission à claude.ai au fur et à mesure qu'ils se produisent, de la même manière que les sessions hébergées dans un terminal.241 * Les sessions hébergées par l'[application de bureau](/docs/fr/desktop) ou l'[extension VS Code](/docs/fr/vs-code) signalent les changements de mode de permission à claude.ai au fur et à mesure qu'ils se produisent, de la même manière que les sessions hébergées dans un terminal.

242 * Avant v2.1.202, les sessions connectées avec `/remote-control` ou `claude --remote-control` ne signalaient pas du tout leur mode de permission, donc claude.ai et l'application mobile pouvaient afficher un mode de permission dans lequel la session n'était pas. L'inadéquation affectait uniquement l'étiquette. Claude Code générait des invites de permission à partir du mode de permission réel de la session, et elles apparaissaient toujours dans l'application pour approbation.242 * Avant v2.1.202, les sessions connectées avec `/remote-control` ou `claude --remote-control` ne signalaient pas du tout leur mode de permission, donc claude.ai et l'application mobile pouvaient afficher un mode de permission dans lequel la session n'était pas. L'inadéquation affectait uniquement l'étiquette. Claude Code générait des demandes de permission à partir du mode de permission réel de la session, et elles apparaissaient toujours dans l'application pour approbation.

243 243 

244 Pour Remote Control, la machine locale exécutant la session doit être connectée avec votre compte claude.ai ; les clés API ne sont pas supportées. Vous pouvez également définir le mode de permission de démarrage lors du lancement de cette session locale :244 Pour Remote Control, la machine locale exécutant la session doit être connectée avec votre compte claude.ai ; les clés API ne sont pas supportées. Vous pouvez également définir le mode de permission de démarrage lors du lancement de cette session locale :

245 245 


333 333 

334* **Plan** : Tous les plans.334* **Plan** : Tous les plans.

335* **Organisation** : sur Team et Enterprise, le mode auto est disponible par défaut. Les administrateurs peuvent le désactiver pour l'organisation en définissant `permissions.disableAutoMode` sur `"disable"` dans les [paramètres gérés](/docs/fr/managed-settings).335* **Organisation** : sur Team et Enterprise, le mode auto est disponible par défaut. Les administrateurs peuvent le désactiver pour l'organisation en définissant `permissions.disableAutoMode` sur `"disable"` dans les [paramètres gérés](/docs/fr/managed-settings).

336* **Modèle** : sur l'API Anthropic et [Claude Platform sur AWS](/docs/fr/claude-platform-on-aws), Claude Opus 4.6 ou ultérieur, Sonnet 4.6 ou ultérieur, ou un [modèle Fable](/docs/fr/model-config#work-with-fable). Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions de [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) connectées, uniquement Claude Sonnet 5 ou ultérieur, Opus 4.7 ou ultérieur, et les modèles Fable. Les modèles plus anciens, y compris Sonnet 4.5, Opus 4.5, Haiku et les modèles claude-3, ne sont pris en charge sur aucun fournisseur.336* **Modèle** : sur l'API Anthropic et [Claude Platform sur AWS](/docs/fr/claude-platform-on-aws), Claude Opus 4.6 ou ultérieur, Sonnet 4.6 ou ultérieur, Haiku 5.5, ou un [modèle Fable](/docs/fr/model-config#work-with-fable). Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions de [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) connectées, uniquement Claude Sonnet 5 ou ultérieur, Opus 4.7 ou ultérieur, Haiku 5.5, et les modèles Fable. Les modèles plus anciens, y compris Sonnet 4.5, Opus 4.5, Haiku 4.5 et les modèles claude-3, ne sont pris en charge sur aucun fournisseur.

337* **Fournisseur** : disponible par défaut sur l'API Anthropic, Claude Platform sur AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions de passerelle d'applications Claude connectées.337* **Fournisseur** : disponible par défaut sur l'API Anthropic, Claude Platform sur AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions de passerelle d'applications Claude connectées.

338 338 

339Si Claude Code signale que le mode auto n'est pas disponible, vérifiez d'abord ces exigences et si un fichier de paramètres définit [`disableAutoMode`](/docs/fr/settings-reference#disableautomode). Anthropic peut également avoir désactivé le mode auto côté serveur, ou le serveur peut avoir rejeté le mode auto pour votre compte. Une session qui a reçu l'une ou l'autre réponse garde le mode auto désactivé jusqu'à la fin de la session, alors démarrez une nouvelle session plus tard.339Si Claude Code signale que le mode auto n'est pas disponible, vérifiez d'abord ces exigences et si un fichier de paramètres définit [`disableAutoMode`](/docs/fr/settings-reference#disableautomode). Anthropic peut également avoir désactivé le mode auto côté serveur, ou le serveur peut avoir rejeté le mode auto pour votre compte. Une session qui a reçu l'une ou l'autre réponse garde le mode auto désactivé jusqu'à la fin de la session, alors démarrez une nouvelle session plus tard.


348 348 

349Sur [Amazon Bedrock](/docs/fr/amazon-bedrock), [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai), [Microsoft Foundry](/docs/fr/microsoft-foundry) et les sessions de [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) connectées, le mode auto est disponible par défaut. Quand rien d'autre ne définit un mode de permission, c'est aussi le [mode de permission intégré de démarrage](#which-mode-a-session-starts-in), sur les versions que le tableau de cette section énumère. Pour choisir vous-même le mode de permission de démarrage, définissez `permissions.defaultMode` comme le décrit [Démarrer dans un mode de permission différent](#start-in-a-different-mode), ou choisissez un mode de permission dans l'indicateur de mode de l'extension VS Code.349Sur [Amazon Bedrock](/docs/fr/amazon-bedrock), [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai), [Microsoft Foundry](/docs/fr/microsoft-foundry) et les sessions de [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) connectées, le mode auto est disponible par défaut. Quand rien d'autre ne définit un mode de permission, c'est aussi le [mode de permission intégré de démarrage](#which-mode-a-session-starts-in), sur les versions que le tableau de cette section énumère. Pour choisir vous-même le mode de permission de démarrage, définissez `permissions.defaultMode` comme le décrit [Démarrer dans un mode de permission différent](#start-in-a-different-mode), ou choisissez un mode de permission dans l'indicateur de mode de l'extension VS Code.

350 350 

351Seuls Claude Sonnet 5 ou ultérieur, Opus 4.7 ou ultérieur, et les modèles Fable sont pris en charge sur ces fournisseurs. Sur tout autre modèle, la session démarre en Manual à la place.351Seuls Claude Sonnet 5 ou ultérieur, Opus 4.7 ou ultérieur, Haiku 5.5 et les modèles Fable sont pris en charge sur ces fournisseurs. Sur tout autre modèle, la session démarre en Manual à la place. Le mode auto avec Haiku 5.5 sur ces fournisseurs nécessite Claude Code v2.1.293 ou ultérieur.

352 352 

353Pour empêcher les développeurs d'utiliser le mode auto, définissez `disableAutoMode` sur `"disable"` dans les [paramètres gérés](/docs/fr/managed-settings). Cela supprime `auto` du cycle `Shift+Tab`, et une session démarrée avec `--permission-mode auto` démarre en Manual à la place. Une session déjà en cours d'exécution en mode auto le quitte quand le paramètre l'atteint à partir d'une [source déployée par l'administrateur](/docs/fr/managed-settings#which-managed-source-claude-code-uses), et affiche `auto mode disabled by settings`. Avant v2.1.251, une session en cours d'exécution gardait le mode auto jusqu'à la fin.353Pour empêcher les développeurs d'utiliser le mode auto, définissez `disableAutoMode` sur `"disable"` dans les [paramètres gérés](/docs/fr/managed-settings). Cela supprime `auto` du cycle `Shift+Tab`, et une session démarrée avec `--permission-mode auto` démarre en Manual à la place. Une session déjà en cours d'exécution en mode auto le quitte quand le paramètre l'atteint à partir d'une [source déployée par l'administrateur](/docs/fr/managed-settings#which-managed-source-claude-code-uses), et affiche `auto mode disabled by settings`. Avant v2.1.251, une session en cours d'exécution gardait le mode auto jusqu'à la fin.

354 354 

plugin-evals.md +1 −1

Details

122 122 

123 La découverte la plus courante au premier abord est un `Δ` proche de zéro avec l'évaluateur `tool_used: Skill` du cas échouant, ce qui signifie que Claude ne choisit pas votre skill sur une formulation naturelle. Ajustez la [`description`](/docs/fr/skills#frontmatter-reference) de la skill, exécutez `claude plugin eval .` à nouveau, et comparez.123 La découverte la plus courante au premier abord est un `Δ` proche de zéro avec l'évaluateur `tool_used: Skill` du cas échouant, ce qui signifie que Claude ne choisit pas votre skill sur une formulation naturelle. Ajustez la [`description`](/docs/fr/skills#frontmatter-reference) de la skill, exécutez `claude plugin eval .` à nouveau, et comparez.

124 124 

125 Pour itérer sur un cas à moindre coût, exécutez un seul bras une fois. Une seule exécution est bruyante, donc confirmez tout changement aux trois exécutions par défaut avant de lui faire confiance. Avec un seul bras, le tableau affiche les colonnes `SCORE` et `PASS%` au lieu de `WITH`, `W/OUT`, et `Δ` :125 Pour itérer sur un cas avec moins d'exécutions, exécutez un seul bras une fois. Une seule exécution est bruyante, donc confirmez tout changement aux trois exécutions par défaut avant de lui faire confiance. Avec un seul bras, le tableau affiche les colonnes `SCORE` et `PASS%` au lieu de `WITH`, `W/OUT`, et `Δ` :

126 126 

127 ```bash theme={null}127 ```bash theme={null}

128 claude plugin eval . --case <case-name> --runs 1 --ablation none128 claude plugin eval . --case <case-name> --runs 1 --ablation none

Details

733You are a security reviewer. Read the changed files and report injection, authentication, and secrets-handling risks.733You are a security reviewer. Read the changed files and report injection, authentication, and secrets-handling risks.

734```734```

735 735 

736Cet agent est nommé `my-plugin:security-reviewer`, et l'utilisateur peut l'[invoquer explicitement](/docs/fr/sub-agents#invoke-subagents-explicitly) avec `@agent-my-plugin:security-reviewer`. La forme du nom est `<plugin>:<name>`, où `<name>` provient du frontmatter, ou du nom du fichier quand il n'y en a pas.736Cet agent est nommé `my-plugin:security-reviewer`, et l'utilisateur peut l'[invoquer explicitement](/docs/fr/sub-agents#invoke-subagents-explicitly) avec `@agent-my-plugin:security-reviewer`. La forme du nom est `<plugin>:<name>`, où `<name>` provient du champ `name` du frontmatter, ou du nom du fichier quand ce champ est absent.

737 737 

738La clé de manifeste `agents` remplace le scan `agents/`.738La clé de manifeste `agents` remplace le scan `agents/`.

739 739 

Details

428 428 

429| Élément | Ce qu'il dessine | Où |429| Élément | Ce qu'il dessine | Où |

430| :- | :- | :- |430| :- | :- | :- |

431| `Box` | Un conteneur flex. Prend des props de mise en page comme `flexDirection`, `columnGap`, `padding`, `borderStyle`, et `width`. | Partout |431| `Box` | Un conteneur flex. Prend des props de mise en page comme `flexDirection`, `columnGap`, `padding`, [`borderStyle`](/docs/fr/plugins/mods/reference#box-border-styles), et `width`. | Partout |

432| `Text` | Texte stylisé. Prend `color`, `bold`, `dimColor`, `italic`, et `wrap`. Une `color` est une clé de thème ou une couleur comme `'red'`. Un `wrap` est `'wrap'`, `'truncate'`, `'truncate-start'`, `'truncate-middle'`, ou `'truncate-end'`. | Partout |432| `Text` | Texte stylisé. Prend `color`, `bold`, `dimColor`, `italic`, et `wrap`. Une `color` est une clé de thème ou une couleur comme `'red'`. Un `wrap` est `'wrap'`, `'truncate'`, `'truncate-start'`, `'truncate-middle'`, ou `'truncate-end'`. | Partout |

433| `Button` | Un contrôle qui appelle `onPress` | Partout |433| `Button` | Un contrôle qui appelle `onPress` | Partout |

434| `Link`, `Code`, `Markdown` | Un lien avec `href` et une `label` optionnelle, un bloc de code, et du texte formaté comme les réponses de Claude. `Markdown` prend son contenu dans une prop `text`, pas dans `children`, et a besoin d'une `key` quand vous passez `onLinkPress`. | Partout |434| `Link`, `Code`, `Markdown` | Un lien avec `href` et une `label` optionnelle, un bloc de code, et du texte formaté comme les réponses de Claude. `Markdown` prend son contenu dans une prop `text`, pas dans `children`, et a besoin d'une `key` quand vous passez `onLinkPress`. | Partout |


563De nombreux volets sont un champ de texte avec une liste en dessous. L'exemple de cette section est un volet de notes : vous tapez une note et appuyez sur Entrée pour l'ajouter, et chaque note a un bouton `x` qui la supprime. Avec deux notes ajoutées, le terminal dessine le volet de cette façon :563De nombreux volets sont un champ de texte avec une liste en dessous. L'exemple de cette section est un volet de notes : vous tapez une note et appuyez sur Entrée pour l'ajouter, et chaque note a un bouton `x` qui la supprime. Avec deux notes ajoutées, le terminal dessine le volet de cette façon :

564 564 

565```text theme={null}565```text theme={null}

566╭──────────────────────────────────────────────────────────╮566╭────────────────────────────────────────────────────────✕─╮

567│ Note: Type a note and press Enter ⏎ add ✕ │567│ Note: Type a note and press Enter ⏎ add │

568│ x buy milk │568│ x buy milk │

569│ x call bob │569│ x call bob │

570╰──────────────────────────────────────────────────────────╯570╰──────────────────────────────────────────────────────────╯

571```571```

572 572 

573Le `✕` sur la bordure supérieure est la marque propre à Claude Code pour fermer le volet.

574 

573L'exemple utilise ces techniques :575L'exemple utilise ces techniques :

574 576 

575* **Prendre l'entrée tapée** : un `Input` appelle `onSubmit(value)` avec le texte du champ quand l'utilisateur appuie sur Entrée, et `onInput(value)` à chaque changement577* **Prendre l'entrée tapée** : un `Input` appelle `onSubmit(value)` avec le texte du champ quand l'utilisateur appuie sur Entrée, et `onInput(value)` à chaque changement

Details

242Pour adapter un arbre à son point de rendu, lisez ces props dans le hook :242Pour adapter un arbre à son point de rendu, lisez ces props dans le hook :

243 243 

244* **Largeur d'un `Pane` ou du bandeau** : dessinez selon `e.props.bodyColumns`244* **Largeur d'un `Pane` ou du bandeau** : dessinez selon `e.props.bodyColumns`

245* **Hauteur d'un `Pane` à côté de la transcription** : lorsque `e.props.placement` vaut `'dock'`, `e.props.scroll.bodyRows` est le nombre de lignes dont dispose le volet245* **Hauteur d'un `Pane` à côté de la transcription** : lorsque `e.props.placement` vaut `'dock'`, `e.props.scroll.bodyRows` est le nombre de lignes dont dispose le volet pour votre arbre

246* **Hauteur d'un `Pane` au-dessus du prompt** : lorsque `e.props.placement` vaut `'inline'`, le volet s'agrandit avec votre arbre jusqu'à une limite, et `bodyRows` correspond à cette limite. Le [champ `rows` de `$.ui.open`](/docs/fr/plugins/mods/interface#open-a-pane-at-the-right-time) permet de demander une limite différente.246* **Hauteur d'un `Pane` au-dessus du prompt** : lorsque `e.props.placement` vaut `'inline'`, le volet s'agrandit avec votre arbre jusqu'à une limite, et `bodyRows` correspond à cette limite. Le [champ `rows` de `$.ui.open`](/docs/fr/plugins/mods/interface#open-a-pane-at-the-right-time) permet de demander une limite différente.

247 247 

248Un arbre plus haut que le volet défile d'un seul bloc.248Un arbre plus haut que le volet défile d'un seul bloc.


255 255 

256| Élément | Props principales | Terminal | Desktop |256| Élément | Props principales | Terminal | Desktop |

257| :- | :- | :-: | :-: |257| :- | :- | :-: | :-: |

258| [`Box`](/docs/fr/plugins/mods/interface#build-a-tree-from-elements) | `key`, disposition flex, `gap`, `padding`, `margin`, `width`, `height`, `borderStyle`, `backgroundColor`, `position`, `hover` | ✓ | ✓ |258| [`Box`](/docs/fr/plugins/mods/interface#build-a-tree-from-elements) | `key`, disposition flex, `gap`, `padding`, `margin`, `width`, `height`, [`borderStyle`](#box-border-styles), `backgroundColor`, `position`, `hover` | ✓ | ✓ |

259| [`Text`](/docs/fr/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, `bold`, `italic`, `underline`, `dimColor`, `inverse`, `wrap` | ✓ | ✓ |259| [`Text`](/docs/fr/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, `bold`, `italic`, `underline`, `dimColor`, `inverse`, `wrap` | ✓ | ✓ |

260| [`Button`](/docs/fr/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ |260| [`Button`](/docs/fr/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ |

261| `Link` | `href`, `label` | ✓ | ✓ |261| `Link` | `href`, `label` | ✓ | ✓ |


270 270 

271Autres règles pour `Button` : `action` nomme l'une des propres [actions de raccourci clavier](/docs/fr/keybindings) de Claude Code, et le raccourci de l'utilisateur pour cette action presse le bouton lorsque ce raccourci est une combinaison de touches ou une touche avec modificateur. Un `hotkey` numérique sur un bouton du bandeau se déclenche aussi lorsque l'utilisateur tape ce seul chiffre dans un prompt vide puis marque une pause. Lorsque deux boutons d'un même dessin désignent le même `hotkey`, c'est le dernier qui l'obtient. `autoFocus` n'accepte que `true` sur tout contrôle : omettez donc la prop pour le désactiver.271Autres règles pour `Button` : `action` nomme l'une des propres [actions de raccourci clavier](/docs/fr/keybindings) de Claude Code, et le raccourci de l'utilisateur pour cette action presse le bouton lorsque ce raccourci est une combinaison de touches ou une touche avec modificateur. Un `hotkey` numérique sur un bouton du bandeau se déclenche aussi lorsque l'utilisateur tape ce seul chiffre dans un prompt vide puis marque une pause. Lorsque deux boutons d'un même dessin désignent le même `hotkey`, c'est le dernier qui l'obtient. `autoFocus` n'accepte que `true` sur tout contrôle : omettez donc la prop pour le désactiver.

272 272 

273<h3 id="box-border-styles">

274 Styles de bordure de `Box`

275</h3>

276 

277Pour dessiner une bordure autour d'une `Box`, définissez sa prop `borderStyle` sur l'un de ces noms, comme dans `borderStyle: 'round'`. Chaque ligne indique ce que le terminal dessine pour ce nom et montre le bord supérieur de la bordure.

278 

279| `borderStyle` | Ce que dessine le terminal | Bord supérieur |

280| :- | :- | :- |

281| `'single'` | Traits fins avec des coins carrés | `┌──┐` |

282| `'double'` | Traits doubles | `╔══╗` |

283| `'round'` | Traits fins avec des coins arrondis | `╭──╮` |

284| `'bold'` | Traits épais | `┏━━┓` |

285| `'singleDouble'` | Traits fins en haut et en bas, traits doubles sur les côtés | `╓──╖` |

286| `'doubleSingle'` | Traits doubles en haut et en bas, traits fins sur les côtés | `╒══╕` |

287| `'classic'` | Les caractères ASCII `+`, `-` et `\|` | `+--+` |

288| `'arrow'` | Des flèches qui pointent vers l'intérieur de la `Box` | `↘↓↓↙` |

289| `'dashed'` | Traits en pointillés avec des coins vides | `╌╌` |

290| `'quote'` | Une barre, `▎`, le long du côté gauche et des cellules vides sur les trois autres côtés | Vide |

291 

292Une `Box` dont la prop `borderStyle` désigne tout autre nom, comme `'rounded'`, est dessinée sans bordure.

293 

273<h2 id="limits">294<h2 id="limits">

274 Limites295 Limites

275</h2>296</h2>

Details

15<Note>15<Note>

16 Ces cas sont couverts sur d'autres pages :16 Ces cas sont couverts sur d'autres pages :

17 17 

18 * **Pourquoi les portées, le cache et la précédence se comportent de cette façon** : lisez [Référence du chargement des plugins](/docs/fr/plugins/loading)18 * **Pourquoi les portées, le cache et la priorité se comportent de cette façon** : lisez [Référence du chargement des plugins](/docs/fr/plugins/loading)

19 * **Recherche d'un drapeau, d'un champ ou d'une commande** : utilisez la [référence des commandes de plugin](/docs/fr/plugins/cli-reference), la [référence du manifeste](/docs/fr/plugins/manifest-reference) ou la [référence de la marketplace](/docs/fr/plugins/marketplace-reference)19 * **Recherche d'un flag, d'un champ ou d'une commande** : utilisez la [référence des commandes de plugin](/docs/fr/plugins/cli-reference), la [référence du manifeste](/docs/fr/plugins/manifest-reference) ou la [référence de la marketplace](/docs/fr/plugins/marketplace-reference)

20 * **Un message `hooks module not loaded` ou `hooks module did not load`** : le plugin est un [mod](/docs/fr/plugins/mods/overview), lisez donc [Le mod ne se charge pas](/docs/fr/plugins/mods/troubleshoot#the-mod-doesn’t-load)

20</Note>21</Note>

21 22 

22Recherchez le message exact que vous avez vu. Chaque message est répertorié sous l'étape qui le produit, ce qui n'est pas toujours la commande que vous avez exécutée. Par exemple, une installation peut échouer parce qu'une marketplace est manquante, donc ce message se trouve sous [Ajouter une marketplace](#add-a-marketplace).23Recherchez le message exact que vous avez vu. Chaque message est répertorié sous l'étape qui le produit, ce qui n'est pas toujours la commande que vous avez exécutée. Par exemple, une installation peut échouer parce qu'une marketplace est manquante, donc ce message se trouve sous [Ajouter une marketplace](#add-a-marketplace).

prompt-caching.md +22 −22

Details

14 Comment le cache est organisé14 Comment le cache est organisé

15</h2>15</h2>

16 16 

17Chaque fois que vous envoyez un message dans Claude Code, il effectue une nouvelle requête API. Le modèle ne se souvient de rien entre les requêtes, donc Claude Code renvoie le contexte complet : l'invite système, votre contexte de projet, tous les messages et résultats d'outils précédents, et votre nouveau message. Le nouveau contenu est ajouté à la fin, ce qui signifie que la plupart de chaque requête est identique à celle précédente. La mise en cache des invites est la façon dont l'API évite de retraiter la partie qui n'a pas changé.17Chaque fois que vous envoyez un message dans Claude Code, il effectue une nouvelle requête API. Le modèle ne se souvient de rien entre les requêtes, donc Claude Code renvoie le contexte complet : le prompt système, votre contexte de projet, tous les messages et résultats d'outils précédents, et votre nouveau message. Le nouveau contenu est ajouté à la fin, ce qui signifie que la plupart de chaque requête est identique à celle précédente. Le prompt caching est la façon dont l'API évite de retraiter la partie qui n'a pas changé.

18 18 

19L'API met en cache en faisant correspondre le début de chaque requête, appelé le préfixe, avec le contenu qu'elle a récemment traité. À un tour normal, le préfixe est la requête entière précédente et seul l'échange le plus récent est nouveau. La correspondance est exacte, donc une modification n'importe où dans le préfixe recalcule tout ce qui suit. Il n'y a pas de mise en cache par fichier ou par segment. Consultez [comment fonctionne la mise en cache des invites](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#how-prompt-caching-works) dans la référence API pour le mécanisme sous-jacent.19L'API met en cache en faisant correspondre le début de chaque requête, appelé le préfixe, avec le contenu qu'elle a récemment traité. À un tour normal, le préfixe est la requête entière précédente et seul l'échange le plus récent est nouveau. La correspondance est exacte, donc une modification n'importe où dans le préfixe recalcule tout ce qui suit. Il n'y a pas de mise en cache par fichier ou par segment. Consultez [comment fonctionne le prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#how-prompt-caching-works) dans la référence API pour le mécanisme sous-jacent.

20 20 

21<img src="https://mintcdn.com/claude-code/VbDJw--l6T9a9Wvm/images/prompt-caching-prefix.svg?fit=max&auto=format&n=VbDJw--l6T9a9Wvm&q=85&s=f2e8f0b8298a50305fe428ca3f1d1594" className="dark:hidden" alt="Quatre tours affichés sous forme de barres horizontales croissantes. La requête de chaque tour contient tout ce qui provient du tour précédent plus l'échange le plus récent ajouté à la fin. Aux tours deux et trois, le préfixe inchangé est lu à partir du cache et seul le nouvel échange est traité. Au tour quatre, l'invite système a changé, donc le préfixe ne correspond plus et la requête entière est retraitée et écrite." width="720" height="454" data-path="images/prompt-caching-prefix.svg" />21<img src="https://mintcdn.com/claude-code/VbDJw--l6T9a9Wvm/images/prompt-caching-prefix.svg?fit=max&auto=format&n=VbDJw--l6T9a9Wvm&q=85&s=f2e8f0b8298a50305fe428ca3f1d1594" className="dark:hidden" alt="Quatre tours affichés sous forme de barres horizontales croissantes. La requête de chaque tour contient tout ce qui provient du tour précédent plus l'échange le plus récent ajouté à la fin. Aux tours deux et trois, le préfixe inchangé est lu à partir du cache et seul le nouvel échange est traité. Au tour quatre, le prompt système a changé, donc le préfixe ne correspond plus et la requête entière est retraitée et écrite." width="720" height="454" data-path="images/prompt-caching-prefix.svg" />

22 22 

23<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/prompt-caching-prefix-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=297dc1c639f0915cae858d0c4b6f3be5" className="hidden dark:block" alt="Quatre tours affichés sous forme de barres horizontales croissantes. La requête de chaque tour contient tout ce qui provient du tour précédent plus l'échange le plus récent ajouté à la fin. Aux tours deux et trois, le préfixe inchangé est lu à partir du cache et seul le nouvel échange est traité. Au tour quatre, l'invite système a changé, donc le préfixe ne correspond plus et la requête entière est retraitée et écrite." width="720" height="454" data-path="images/prompt-caching-prefix-dark.svg" />23<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/prompt-caching-prefix-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=297dc1c639f0915cae858d0c4b6f3be5" className="hidden dark:block" alt="Quatre tours affichés sous forme de barres horizontales croissantes. La requête de chaque tour contient tout ce qui provient du tour précédent plus l'échange le plus récent ajouté à la fin. Aux tours deux et trois, le préfixe inchangé est lu à partir du cache et seul le nouvel échange est traité. Au tour quatre, le prompt système a changé, donc le préfixe ne correspond plus et la requête entière est retraitée et écrite." width="720" height="454" data-path="images/prompt-caching-prefix-dark.svg" />

24 24 

25Pour tirer le meilleur parti de la correspondance des préfixes, Claude Code organise chaque requête de sorte que le contenu qui change rarement entre les tours vient en premier :25Pour tirer le meilleur parti de la correspondance des préfixes, Claude Code organise chaque requête de sorte que le contenu qui change rarement entre les tours vient en premier :

26 26 

27| Couche | Contenu | Change quand |27| Couche | Contenu | Change quand |

28| - | - | - |28| - | - | - |

29| Invite système | Instructions principales, définitions d'outils | L'ensemble des définitions d'outils chargées change |29| Prompt système | Instructions principales, définitions d'outils | L'ensemble des définitions d'outils chargées change |

30| Contexte du projet | CLAUDE.md, mémoire automatique, règles non délimitées | La session commence, ou après `/clear` ou `/compact` |30| Contexte du projet | CLAUDE.md, mémoire automatique, règles non délimitées | La session commence, ou après `/clear` ou `/compact` |

31| Conversation | Vos messages, les réponses de Claude, les résultats d'outils | À chaque tour |31| Conversation | Vos messages, les réponses de Claude, les résultats d'outils | À chaque tour |

32 32 

33Une modification de la couche de conversation laisse l'invite système et le contexte du projet en cache. Une modification de l'invite système invalide tout, car tout le contenu ultérieur se trouve maintenant derrière un préfixe différent. La troisième colonne donne les déclencheurs courants plutôt qu'une liste exhaustive, et les sections ci-dessous couvrent l'ensemble complet.33Une modification de la couche de conversation laisse le prompt système et le contexte du projet en cache. Une modification du prompt système invalide tout, car tout le contenu ultérieur se trouve maintenant derrière un préfixe différent. La troisième colonne donne les déclencheurs courants plutôt qu'une liste exhaustive, et les sections ci-dessous couvrent l'ensemble complet.

34 34 

35La règle de correspondance des préfixes explique la plupart des comportements sur cette page. Le [mode Plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) et le [chargement des compétences](/docs/fr/skills), par exemple, ajoutent leurs instructions sous forme de messages de conversation, de sorte que le préfixe en cache reste intact.35La règle de correspondance des préfixes explique la plupart des comportements sur cette page. Le [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) et le [chargement des skills](/docs/fr/skills), par exemple, ajoutent leurs instructions sous forme de messages de conversation, de sorte que le préfixe en cache reste intact.

36 36 

37Deux paramètres n'apparaissent pas dans le tableau des couches mais affectent toujours ce qui reste en cache :37Deux paramètres n'apparaissent pas dans le tableau des couches mais affectent toujours ce qui reste en cache :

38 38 

39* **Modèle** : chaque modèle a son propre cache. Changer de modèle recalcule la requête entière même lorsque le contenu est identique. Consultez [Changer de modèle](#switching-models) ci-dessous.39* **Modèle** : chaque modèle a son propre cache. Changer de modèle recalcule la requête entière même lorsque le contenu est identique. Consultez [Changer de modèle](#switching-models) ci-dessous.

40* **Niveau d'effort** : sur la plupart des modèles, chaque niveau d'effort a son propre cache, donc changer d'effort en cours de session recalcule la requête entière. Sur Opus 5.5, Sonnet 5.5, et Fable 5.1 avec une clé API ou un abonnement Claude, le cache reste intact par défaut. Consultez [Changer le niveau d'effort](#changing-effort-level) ci-dessous.40* **Niveau d'effort** : sur la plupart des modèles, chaque niveau d'effort a son propre cache, donc changer d'effort en cours de session recalcule la requête entière. Sur Opus 5.5, Sonnet 5.5, Haiku 5.5 et Fable 5.1 avec une clé API ou un abonnement Claude, le cache reste intact par défaut. Consultez [Changer le niveau d'effort](#changing-effort-level) ci-dessous.

41 41 

42<Tip>42<Tip>

43 Choisissez votre modèle et votre niveau d'effort au début d'une session, puis réservez `/compact` pour les pauses naturelles entre les tâches. Moins vous apportez de modifications en cours de tâche, plus votre taux de succès du cache est élevé.43 Choisissez votre modèle et votre niveau d'effort au début d'une session, puis réservez `/compact` pour les pauses naturelles entre les tâches. Moins vous apportez de modifications en cours de tâche, plus votre taux de succès du cache est élevé.


56 56 

57Claude Code ajoute également le contexte système en cours de conversation, comme les avis de modification de fichiers, et marque ce bloc pour la mise en cache sur chaque fournisseur et connexion sauf si vous définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities), auquel cas ce bloc est envoyé sans cache.57Claude Code ajoute également le contexte système en cours de conversation, comme les avis de modification de fichiers, et marque ce bloc pour la mise en cache sur chaque fournisseur et connexion sauf si vous définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities), auquel cas ce bloc est envoyé sans cache.

58 58 

59Au point de terminaison propre du fournisseur, Amazon Bedrock et son [point de terminaison Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint), Agent Platform de Google Cloud, et Microsoft Foundry mettent en cache le bloc de la même manière que l'API Claude.59À l'endpoint propre du fournisseur, Amazon Bedrock et son [endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint), Agent Platform de Google Cloud, et Microsoft Foundry mettent en cache le bloc de la même manière que l'API Claude.

60 60 

61Lorsque vos requêtes passent par une [passerelle LLM](/docs/fr/llm-gateway), un `ANTHROPIC_BASE_URL` personnalisé, ou un remplacement d'URL de base du fournisseur cloud tel que [`ANTHROPIC_BEDROCK_BASE_URL`](/docs/fr/env-vars), ce qui reste en cache dépend de la façon dont la passerelle gère les [marqueurs `cache_control`](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#explicit-cache-breakpoints) que Claude Code envoie :61Lorsque vos requêtes passent par une [passerelle LLM](/docs/fr/llm-gateway), un `ANTHROPIC_BASE_URL` personnalisé, ou un remplacement d'URL de base du fournisseur cloud tel que [`ANTHROPIC_BEDROCK_BASE_URL`](/docs/fr/env-vars), ce qui reste en cache dépend de la façon dont la passerelle gère les [marqueurs `cache_control`](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#explicit-cache-breakpoints) que Claude Code envoie :

62 62 

63* **Les transmet inchangés** : le bloc et votre conversation se mettent en cache de la même manière qu'au point de terminaison propre du fournisseur.63* **Les transmet inchangés** : le bloc et votre conversation se mettent en cache de la même manière qu'à l'endpoint propre du fournisseur.

64* **Rejette la requête marquée avec une erreur `400` nommant `cache_control`** : Claude Code renvoie la requête avec le marqueur déplacé du bloc vers votre dernier message de conversation, et le garde là pour le reste de la conversation. Le bloc est facturé comme entrée non mise en cache ; votre conversation reste mise en cache.64* **Rejette la requête marquée avec une erreur `400` nommant `cache_control`** : Claude Code renvoie la requête avec le marqueur déplacé du bloc vers votre dernier message de conversation, et le garde là pour le reste de la conversation. Le bloc est facturé comme entrée non mise en cache ; votre conversation reste mise en cache.

65* **Supprime les marqueurs tout en retournant le succès** : l'historique de votre conversation entière est facturé comme entrée non mise en cache à chaque tour. Une passerelle qui convertit le contenu du système sous forme de bloc en une chaîne simple supprime le marqueur de la même manière.65* **Supprime les marqueurs tout en retournant le succès** : l'historique de votre conversation entière est facturé comme entrée non mise en cache à chaque tour. Une passerelle qui convertit le contenu du système sous forme de bloc en une chaîne simple supprime le marqueur de la même manière.

66 66 


78* [Connexion ou suppression d'un serveur MCP](#connecting-or-removing-an-mcp-server)78* [Connexion ou suppression d'un serveur MCP](#connecting-or-removing-an-mcp-server)

79* [Activation ou désactivation d'un plugin](#enabling-or-disabling-a-plugin)79* [Activation ou désactivation d'un plugin](#enabling-or-disabling-a-plugin)

80* [Refus d'un outil entier](#denying-an-entire-tool)80* [Refus d'un outil entier](#denying-an-entire-tool)

81* [Compactage de la conversation](#compacting-the-conversation)81* [Compaction de la conversation](#compacting-the-conversation)

82* [Accumulation de nombreuses images](#accumulating-many-images)82* [Accumulation de nombreuses images](#accumulating-many-images)

83* [Mise à niveau de Claude Code](#upgrading-claude-code)83* [Mise à niveau de Claude Code](#upgrading-claude-code)

84 84 


98 98 

99[Le basculement automatique du modèle](/docs/fr/model-config#automatic-model-fallback) sur les modèles Fable, Opus 5.5, Sonnet 5.5 et Opus 5 est également un changement de modèle. Lorsqu'un classificateur de sécurité signale une requête dans une catégorie qui a un modèle de secours, Claude Code réexécute la requête sur ce modèle et la session continue là.99[Le basculement automatique du modèle](/docs/fr/model-config#automatic-model-fallback) sur les modèles Fable, Opus 5.5, Sonnet 5.5 et Opus 5 est également un changement de modèle. Lorsqu'un classificateur de sécurité signale une requête dans une catégorie qui a un modèle de secours, Claude Code réexécute la requête sur ce modèle et la session continue là.

100 100 

101Lorsque le frontmatter d'une skill ou d'une commande nomme un [`model`](/docs/fr/skills#frontmatter-reference) autre que le modèle actuel de la session, ce tour est également un changement de modèle : la prochaine requête lit l'intégralité de l'historique de conversation sans aucun cache hit. Le modèle de session reprend à votre prochaine invite. Une skill `context: fork` définit le [modèle du sous-agent forké](/docs/fr/skills#run-skills-in-a-subagent) à la place.101Lorsque le frontmatter d'une skill ou d'une commande nomme un [`model`](/docs/fr/skills#frontmatter-reference) autre que le modèle actuel de la session, ce tour est également un changement de modèle : la prochaine requête lit l'intégralité de l'historique de conversation sans aucun cache hit. Le modèle de session reprend à votre prochain prompt. Une skill `context: fork` définit le [modèle du sous-agent forké](/docs/fr/skills#run-skills-in-a-subagent) à la place.

102 102 

103<h3 id="changing-effort-level">103<h3 id="changing-effort-level">

104 Modification du niveau d'effort104 Modification du niveau d'effort


106 106 

107Sur la plupart des modèles, modifier le [niveau d'effort](/docs/fr/model-config#adjust-effort-level) en cours de session signifie que la prochaine requête lit l'intégralité de l'historique de conversation sans aucun cache hit. Tant que le cache est encore chaud, Claude Code vous demande de confirmer le changement d'abord.107Sur la plupart des modèles, modifier le [niveau d'effort](/docs/fr/model-config#adjust-effort-level) en cours de session signifie que la prochaine requête lit l'intégralité de l'historique de conversation sans aucun cache hit. Tant que le cache est encore chaud, Claude Code vous demande de confirmer le changement d'abord.

108 108 

109Sur Opus 5.5, Sonnet 5.5 et Fable 5.1 avec une clé API ou un abonnement Claude, modifier l'effort conserve le cache, et Claude Code applique le nouveau niveau sans demander. Cela ne s'applique pas sur Amazon Bedrock, sur la plateforme Agent de Google Cloud, ou sur une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway), ou lorsque vous définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) ou que votre organisation a une configuration HIPAA.109Sur Opus 5.5, Sonnet 5.5, Haiku 5.5 et Fable 5.1 avec une clé API ou un abonnement Claude, modifier l'effort conserve le cache, et Claude Code applique le nouveau niveau sans demander. Cela ne s'applique pas sur Amazon Bedrock, sur la plateforme Agent de Google Cloud, ou sur une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway), ou lorsque vous définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) ou que votre organisation a une configuration HIPAA.

110 110 

111Avant la v2.1.260, modifier l'effort sur Fable 5.1 avec une clé API ou un abonnement Claude invalidait également le cache.111Avant la v2.1.260, modifier l'effort sur Fable 5.1 avec une clé API ou un abonnement Claude invalidait également le cache.

112 112 


114 Activation du mode rapide114 Activation du mode rapide

115</h3>115</h3>

116 116 

117L'activation du [mode rapide](/docs/fr/fast-mode) ajoute un en-tête de requête qui fait partie de la clé de cache, donc la première requête que Claude Code envoie avec le mode rapide activé lit l'intégralité de l'historique de conversation sans aucun cache hit. Claude Code définit cet en-tête une fois au démarrage d'un tour et le conserve pour tout le tour, donc lorsque vous activez le mode rapide pendant que Claude travaille, le cache miss de l'en-tête se produit à la première requête de votre tour suivant. Ces jetons d'entrée non mis en cache sont facturés aux [tarifs du mode rapide](/docs/fr/fast-mode#understand-the-cost-tradeoff), c'est pourquoi l'activation au début d'une session coûte moins cher que l'activation profondément dans une longue session. Si votre modèle actuel ne supporte pas le mode rapide, l'activation du mode rapide [bascule également votre modèle](#switching-models), et ce basculement démarre un nouveau cache à partir de la prochaine requête du tour en cours.117L'activation du [mode rapide](/docs/fr/fast-mode) ajoute un en-tête de requête qui fait partie de la clé de cache, donc la première requête que Claude Code envoie avec le mode rapide activé lit l'intégralité de l'historique de conversation sans aucun cache hit. Claude Code définit cet en-tête une fois au démarrage d'un tour et le conserve pour tout le tour, donc lorsque vous activez le mode rapide pendant que Claude travaille, le cache miss de l'en-tête se produit à la première requête de votre tour suivant. Ces tokens d'entrée non mis en cache sont facturés aux [tarifs du mode rapide](/docs/fr/fast-mode#understand-the-cost-tradeoff), c'est pourquoi l'activation au début d'une session coûte moins cher que l'activation profondément dans une longue session. Si votre modèle actuel ne supporte pas le mode rapide, l'activation du mode rapide [bascule également votre modèle](#switching-models), et ce basculement démarre un nouveau cache à partir de la prochaine requête du tour en cours.

118 118 

119Le coût s'applique une fois par conversation. Après le premier tour en mode rapide, Claude Code continue d'envoyer l'en-tête et varie uniquement le paramètre de vitesse de la requête, qui ne fait pas partie de la clé de cache. Désactiver le mode rapide, le [basculement automatique vers la vitesse standard](/docs/fr/fast-mode#handle-rate-limits) après une limite de débit, et le réactiver plus tard conservent tous le cache. Si vous [manquez de crédits d'utilisation](/docs/fr/fast-mode#handle-rate-limits) en cours de session, Claude Code réessaie chaque requête en mode rapide rejetée à la vitesse standard de la même manière, donc ce basculement conserve également le cache. `/clear` et `/compact` réinitialisent cela, puisqu'ils reconstruisent le cache à ces points de toute façon.119Le coût s'applique une fois par conversation. Après le premier tour en mode rapide, Claude Code continue d'envoyer l'en-tête et varie uniquement le paramètre de vitesse de la requête, qui ne fait pas partie de la clé de cache. Désactiver le mode rapide, le [basculement automatique vers la vitesse standard](/docs/fr/fast-mode#handle-rate-limits) après une limite de débit, et le réactiver plus tard conservent tous le cache. Si vous [manquez de crédits d'utilisation](/docs/fr/fast-mode#handle-rate-limits) en cours de session, Claude Code réessaie chaque requête en mode rapide rejetée à la vitesse standard de la même manière, donc ce basculement conserve également le cache. `/clear` et `/compact` réinitialisent cela, puisqu'ils reconstruisent le cache à ces points de toute façon.

120 120 


122 Connexion ou suppression d'un serveur MCP122 Connexion ou suppression d'un serveur MCP

123</h3>123</h3>

124 124 

125Les définitions d'outils se trouvent dans la couche d'invite système, donc le cache s'invalide lorsque l'ensemble des définitions d'outils dans la requête change entre les tours. Basculer l'[outil conseiller](/docs/fr/advisor) est une exception : sa définition se trouve après le point de rupture du cache, donc l'activation ou la désactivation de `/advisor` conserve le préfixe mis en cache intact. Qu'un changement de [serveur MCP](/docs/fr/mcp) fasse cela dépend de si la [recherche d'outils](/docs/fr/mcp#scale-with-mcp-tool-search) diffère les outils MCP de la session, la valeur par défaut sur les modèles supportés :125Les définitions d'outils se trouvent dans la couche du prompt système, donc le cache s'invalide lorsque l'ensemble des définitions d'outils dans la requête change entre les tours. Basculer l'[outil conseiller](/docs/fr/advisor) est une exception : sa définition se trouve après le point de rupture du cache, donc l'activation ou la désactivation de `/advisor` conserve le préfixe mis en cache intact. Qu'un changement de [serveur MCP](/docs/fr/mcp) fasse cela dépend de si la [recherche d'outils](/docs/fr/mcp#scale-with-mcp-tool-search) diffère les outils MCP de la session, la valeur par défaut sur les modèles supportés :

126 126 

127* **Outils différés** : Claude Code conserve la liste d'outils de la première requête de la conversation pour toute la conversation, donc un serveur se connectant ou se déconnectant en cours de session ne perturbe rien de déjà mis en cache. Un serveur qui finit de se connecter après la première requête fournit ses outils comme des définitions différées que Claude charge à la demande.127* **Outils différés** : Claude Code conserve la liste d'outils de la première requête de la conversation pour toute la conversation, donc un serveur se connectant ou se déconnectant en cours de session ne perturbe rien de déjà mis en cache. Un serveur qui finit de se connecter après la première requête fournit ses outils comme des définitions différées que Claude charge à la demande.

128* **Outils chargés en amont** : l'ajout d'une définition invalide le cache, et il en va de même pour la suppression intentionnelle d'une. Cela s'applique lorsque la recherche d'outils est [en dessous de son seuil `auto`, désactivée ou indisponible](/docs/fr/mcp#configure-tool-search), par exemple sur les modèles de la plateforme Agent de Google Cloud antérieurs à la génération Claude 4.5, avec une passerelle `ANTHROPIC_BASE_URL` personnalisée, ou sur un [déploiement Microsoft Foundry hébergé sur Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) une fois que Claude Code détecte que le déploiement rejette la recherche d'outils.128* **Outils chargés en amont** : l'ajout d'une définition invalide le cache, et il en va de même pour la suppression intentionnelle d'une. Cela s'applique lorsque la recherche d'outils est [en dessous de son seuil `auto`, désactivée ou indisponible](/docs/fr/mcp#configure-tool-search), par exemple sur les modèles de la plateforme Agent de Google Cloud antérieurs à la génération Claude 4.5, avec une passerelle `ANTHROPIC_BASE_URL` personnalisée, ou sur un [déploiement Microsoft Foundry hébergé sur Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) une fois que Claude Code détecte que le déploiement rejette la recherche d'outils.


198Seule une règle de refus qui correspond à la position du nom d'outil bloque un outil de cette manière : un nom d'outil nu, la forme équivalente `Bash(*)`, ou un [glob de nom d'outil](/docs/fr/permissions#tool-name-wildcards) comme `"*"`. Un glob qui correspond uniquement aux outils MCP, comme `"mcp__*"`, bloque ces outils de la même manière. Les règles de refus délimitées comme `Bash(rm *)`, et toutes les règles d'autorisation et de demande, ne changent pas les outils que Claude voit. Claude Code les vérifie lorsque Claude tente un appel, laissant le préfixe intact.198Seule une règle de refus qui correspond à la position du nom d'outil bloque un outil de cette manière : un nom d'outil nu, la forme équivalente `Bash(*)`, ou un [glob de nom d'outil](/docs/fr/permissions#tool-name-wildcards) comme `"*"`. Un glob qui correspond uniquement aux outils MCP, comme `"mcp__*"`, bloque ces outils de la même manière. Les règles de refus délimitées comme `Bash(rm *)`, et toutes les règles d'autorisation et de demande, ne changent pas les outils que Claude voit. Claude Code les vérifie lorsque Claude tente un appel, laissant le préfixe intact.

199 199 

200<h3 id="compacting-the-conversation">200<h3 id="compacting-the-conversation">

201 Compactage de la conversation201 Compaction de la conversation

202</h3>202</h3>

203 203 

204Le [compactage](/docs/fr/context-window#what-survives-compaction) remplace votre historique de messages par un résumé. Par conception, cela invalide la couche de conversation, puisque la prochaine requête a un nouvel historique plus court qui ne partage pas de préfixe avec l'ancien. Claude Code réutilise la couche d'invite système sauf si la conversation a été [reprise tout en conservant une invite système qui aurait autrement changé](#resuming-a-session) ; dans ce cas, le premier compactage bascule vers l'invite actuelle et cette couche se reconstruit une fois. Il recharge le contexte du projet à partir du disque, qui ne cache les hits que si CLAUDE.md et la mémoire sont inchangés depuis le début de la session.204La [compaction](/docs/fr/context-window#what-survives-compaction) remplace votre historique de messages par un résumé. Par conception, cela invalide la couche de conversation, puisque la prochaine requête a un nouvel historique plus court qui ne partage pas de préfixe avec l'ancien. Claude Code réutilise la couche du prompt système sauf si la conversation a été [reprise tout en conservant un prompt système qui aurait autrement changé](#resuming-a-session) ; dans ce cas, la première compaction bascule vers le prompt actuel et cette couche se reconstruit une fois. Il recharge le contexte du projet à partir du disque, qui ne produit des cache hits que si CLAUDE.md et la mémoire sont inchangés depuis le début de la session.

205 205 

206Pour produire le résumé, Claude Code envoie une requête séparée avec la même invite système, les mêmes outils et le même historique que votre conversation, plus une instruction de résumé ajoutée comme dernier message utilisateur. Tant que le cache est chaud, cette requête lit votre préfixe à partir du cache, donc un `/compact` en cours de session coûte une fraction de ce que la taille du contexte suggère et passe la plupart de son temps à générer le résumé.206Pour produire le résumé, Claude Code envoie une requête séparée avec le même prompt système, les mêmes outils et le même historique que votre conversation, plus une instruction de résumé ajoutée comme dernier message utilisateur. Tant que le cache est chaud, cette requête lit votre préfixe à partir du cache, donc un `/compact` en cours de session coûte une fraction de ce que la taille du contexte suggère et passe la plupart de son temps à générer le résumé.

207 207 

208Après une pause plus longue que la [durée de vie du cache](#cache-lifetime), il n'y a pas de cache à lire, donc la requête de résumé retraite l'historique complet en tant qu'entrée non mise en cache. C'est pourquoi `/compact` coûte le plus lorsque vous [reprenez une ancienne session](/docs/fr/sessions#resume-from-a-summary). Dans les deux cas, chaud et froid, le tour après compactage reconstruit le cache de conversation pour seulement le résumé beaucoup plus court, donc ce tour n'est pas la partie lente.208Après une pause plus longue que la [durée de vie du cache](#cache-lifetime), il n'y a pas de cache à lire, donc la requête de résumé retraite l'historique complet en tant qu'entrée non mise en cache. C'est pourquoi `/compact` coûte le plus lorsque vous [reprenez une ancienne session](/docs/fr/sessions#resume-from-a-summary). Dans les deux cas, chaud et froid, le tour après compaction reconstruit le cache de conversation pour seulement le résumé beaucoup plus court, donc ce tour n'est pas la partie lente.

209 209 

210<Tip>210<Tip>

211 Le compactage joue en votre faveur lorsque le contexte que vous rejetez est du contenu dont vous n'avez plus besoin. Pour choisir quand son surcoût se produit, exécutez `/compact` à une pause naturelle dans votre travail, par exemple entre les tâches, au lieu d'attendre que le compactage automatique se déclenche en cours de tâche. Si vous avez suivi un chemin que vous voulez abandonner entièrement, [`/rewind`](#rewinding-the-conversation) à un tour antérieur à la place. Le rembobinage tronque jusqu'à un préfixe qui est déjà mis en cache, plutôt que d'en construire un nouveau comme le fait le compactage.211 La compaction joue en votre faveur lorsque le contexte que vous rejetez est du contenu dont vous n'avez plus besoin. Pour choisir quand son surcoût se produit, exécutez `/compact` à une pause naturelle dans votre travail, par exemple entre les tâches, au lieu d'attendre que la compaction automatique se déclenche en cours de tâche. Si vous avez suivi un chemin que vous voulez abandonner entièrement, utilisez plutôt [`/rewind`](#rewinding-the-conversation) pour revenir à un tour antérieur. Le rembobinage tronque jusqu'à un préfixe qui est déjà mis en cache, plutôt que d'en construire un nouveau comme le fait la compaction.

212</Tip>212</Tip>

213 213 

214<h3 id="accumulating-many-images">214<h3 id="accumulating-many-images">


225 Mise à niveau de Claude Code225 Mise à niveau de Claude Code

226</h3>226</h3>

227 227 

228Une nouvelle version de Claude Code met généralement à jour l'invite système ou les définitions d'outils, donc la première conversation que vous démarrez après une mise à niveau construit son cache à partir du début. La [mise à jour automatique](/docs/fr/setup#auto-updates) télécharge les nouvelles versions en arrière-plan mais les applique au prochain lancement, jamais en cours de session, donc vous voyez cela comme un premier tour non mis en cache après redémarrage plutôt qu'une surprise pendant une session. Définissez `DISABLE_AUTOUPDATER=1` pour contrôler quand les mises à niveau s'appliquent.228Une nouvelle version de Claude Code met généralement à jour le prompt système ou les définitions d'outils, donc la première conversation que vous démarrez après une mise à niveau construit son cache à partir du début. La [mise à jour automatique](/docs/fr/setup#auto-updates) télécharge les nouvelles versions en arrière-plan mais les applique au prochain lancement, jamais en cours de session, donc vous voyez cela comme un premier tour non mis en cache après redémarrage plutôt qu'une surprise pendant une session. Définissez `DISABLE_AUTOUPDATER=1` pour contrôler quand les mises à niveau s'appliquent.

229 229 

230<Note>230<Note>

231 Pour ce qu'il en coûte de reprendre une conversation que vous avez commencée avant la mise à niveau, voir [Reprise d'une session](#resuming-a-session).231 Pour ce qu'il en coûte de reprendre une conversation que vous avez commencée avant la mise à niveau, voir [Reprise d'une session](#resuming-a-session).


328| Conversation principale | Une heure | Cinq minutes |328| Conversation principale | Une heure | Cinq minutes |

329| Tout le reste | Cinq minutes, sauf les requêtes d'assistance contrôlées par le serveur, qui obtiennent une heure | Cinq minutes |329| Tout le reste | Cinq minutes, sauf les requêtes d'assistance contrôlées par le serveur, qui obtiennent une heure | Cinq minutes |

330 330 

331Une fois que vous dépassez la limite d'utilisation de votre plan et que Claude Code puise dans les [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), vous êtes facturé pour cette utilisation, donc Claude Code baisse la conversation principale au TTL de cinq minutes moins cher. Pour conserver le TTL d'une heure là, [choisissez le TTL vous-même](#choose-the-ttl-yourself).331Une fois que vous dépassez la limite d'utilisation de votre plan et que Claude Code puise dans les [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), vous êtes facturé pour cette utilisation, donc Claude Code fait passer la conversation principale au TTL de cinq minutes, qui facture les écritures de cache à un taux plus bas. Pour conserver le TTL d'une heure là, [choisissez le TTL vous-même](#choose-the-ttl-yourself).

332 332 

333<h3 id="choose-the-ttl-yourself">333<h3 id="choose-the-ttl-yourself">

334 Choisissez le TTL vous-même334 Choisissez le TTL vous-même

Details

1342 },1342 },

1343 "review-your-changes-before": {1343 "review-your-changes-before": {

1344 title: "Examiner vos modifications avant de faire un commit",1344 title: "Examiner vos modifications avant de faire un commit",

1345 teaches: "Attrapez les problèmes tant qu'ils sont encore bon marché à corriger. Claude lit les fichiers modifiés en entier, pas seulement les lignes de diff, afin qu'il repère les problèmes qu'un auto-examen rapide manquerait.",1345 teaches: "Repérez les problèmes tant qu'ils demandent moins de travail à corriger. Claude lit les fichiers modifiés en entier, pas seulement les lignes de diff, afin qu'il repère les problèmes qu'un auto-examen rapide manquerait.",

1346 next: "Exécutez `/code-review` pour la même vérification en une commande",1346 next: "Exécutez `/code-review` pour la même vérification en une commande",

1347 prompt: "examinez mes modifications non commitées et signalez tout ce qui semble risqué avant que je fasse un commit"1347 prompt: "examinez mes modifications non commitées et signalez tout ce qui semble risqué avant que je fasse un commit"

1348 },1348 },

quickstart.md +52 −86

Details

4 4 

5# Démarrage rapide5# Démarrage rapide

6 6 

7> Bienvenue dans Claude Code !7> Installez Claude Code dans votre terminal, connectez-vous et utilisez la CLI pour explorer votre base de code et effectuer votre première modification de code.

8 8 

9Ce guide de démarrage rapide vous permettra d'utiliser l'assistance au codage alimentée par l'IA en quelques minutes. À la fin, vous comprendrez comment utiliser Claude Code pour les tâches de développement courantes.9Ce démarrage rapide couvre Claude Code dans votre terminal : l'installation de la CLI, la connexion lors de votre première session et son utilisation pour les tâches de développement courantes dans votre propre projet.

10 10 

11<h2 id="before-you-begin">11<h2 id="before-you-begin">

12 Avant de commencer12 Avant de commencer


15Assurez-vous que vous avez :15Assurez-vous que vous avez :

16 16 

17* Un terminal ou une invite de commande ouvert17* Un terminal ou une invite de commande ouvert

18 * Si vous n'avez jamais utilisé le terminal auparavant, consultez le [guide du terminal](/docs/fr/terminal-guide)

19* Un projet de code avec lequel travailler18* Un projet de code avec lequel travailler

20* Un [abonnement Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team ou Enterprise), un compte [Claude Console](https://platform.claude.com/), ou un accès via un [fournisseur cloud pris en charge](/docs/fr/third-party-integrations)19* Un [abonnement Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team ou Enterprise), un compte [Claude Console](https://platform.claude.com/), ou un accès via un [fournisseur cloud pris en charge](/docs/fr/third-party-integrations)

21 20 

22<Note>21<Note>

23 Ce guide couvre le CLI du terminal. Claude Code est également disponible sur le [web](https://claude.ai/code), en tant qu'[application de bureau](/docs/fr/desktop), dans [VS Code](/docs/fr/vs-code) et [les IDE JetBrains](/docs/fr/jetbrains), dans [Slack](/docs/fr/slack), et en CI/CD avec [GitHub Actions](/docs/fr/github-actions) et [GitLab](/docs/fr/gitlab-ci-cd). Voir [toutes les interfaces](/docs/fr/overview#use-claude-code-everywhere).22 Ces cas sont couverts sur d'autres pages :

23 

24 * **Vous n'avez jamais utilisé de terminal** : commencez par le [guide du terminal](/docs/fr/terminal-guide)

25 * **Vous souhaitez utiliser Claude Code ailleurs que dans le terminal** : Claude Code est également disponible sur le [web](https://claude.ai/code), en tant qu'[application de bureau](/docs/fr/desktop), dans [VS Code](/docs/fr/vs-code) et [les IDE JetBrains](/docs/fr/jetbrains), dans [Slack](/docs/fr/slack), et en CI/CD avec [GitHub Actions](/docs/fr/github-actions) et [GitLab](/docs/fr/gitlab-ci-cd). Voir [toutes les interfaces](/docs/fr/overview#use-claude-code-everywhere).

24</Note>26</Note>

25 27 

26<h2 id="step-1-install-claude-code">28<h2 id="step-1-install-claude-code">


37 curl -fsSL https://claude.ai/install.sh | bash39 curl -fsSL https://claude.ai/install.sh | bash

38 ```40 ```

39 41 

42 Sur Windows, votre invite affiche `PS C:\` quand vous êtes dans PowerShell et `C:\` sans le `PS` quand vous êtes dans CMD.

43 

40 **Windows PowerShell :**44 **Windows PowerShell :**

41 45 

42 ```powershell theme={null}46 ```powershell theme={null}


51 55 

52 Quand l'installateur se termine, ouvrez une nouvelle fenêtre de terminal et exécutez `claude --version`. Une installation fonctionnelle affiche un numéro de version. Si votre shell dit que `claude` n'est pas trouvé ou n'est pas reconnu, le répertoire d'installation n'est pas encore sur votre PATH : consultez [Corriger votre PATH](/docs/fr/troubleshoot-install#command-not-found-claude-after-installation).56 Quand l'installateur se termine, ouvrez une nouvelle fenêtre de terminal et exécutez `claude --version`. Une installation fonctionnelle affiche un numéro de version. Si votre shell dit que `claude` n'est pas trouvé ou n'est pas reconnu, le répertoire d'installation n'est pas encore sur votre PATH : consultez [Corriger votre PATH](/docs/fr/troubleshoot-install#command-not-found-claude-after-installation).

53 57 

54 Si vous voyez `The token '&&' is not a valid statement separator`, vous êtes dans PowerShell, pas dans CMD. Si vous voyez `'irm' is not recognized as an internal or external command`, vous êtes dans CMD, pas dans PowerShell. Votre invite affiche `PS C:\` quand vous êtes dans PowerShell et `C:\` sans le `PS` quand vous êtes dans CMD.58 Si vous voyez `The token '&&' is not a valid statement separator`, vous êtes dans PowerShell, pas dans CMD. Si vous voyez `'irm' is not recognized as an internal or external command`, vous êtes dans CMD, pas dans PowerShell.

55 59 

56 Si la commande d'installation échoue avec `syntax error near unexpected token '<'`, un `403`, ou une autre erreur curl, consultez [Dépannage de l'installation](/docs/fr/troubleshoot-install#find-your-error) pour faire correspondre l'erreur à une solution et pour connaître les méthodes d'installation alternatives.60 Si la commande d'installation échoue avec `syntax error near unexpected token '<'`, un `403`, ou toute autre erreur, consultez [Dépannage de l'installation](/docs/fr/troubleshoot-install#find-your-error) pour faire correspondre l'erreur à une solution et pour connaître les méthodes d'installation alternatives.

57 61 

58 [Git for Windows](https://git-scm.com/downloads/win) est recommandé sur Windows natif afin que Claude Code puisse utiliser l'outil Bash. Si Git for Windows n'est pas installé, Claude Code utilise PowerShell comme outil shell à la place. Les configurations WSL n'ont pas besoin de Git for Windows.62 [Git for Windows](https://git-scm.com/downloads/win) est recommandé sur Windows natif afin que Claude Code puisse utiliser l'outil Bash. Si Git for Windows n'est pas installé, Claude Code utilise PowerShell comme outil shell à la place. Les configurations WSL n'ont pas besoin de Git for Windows.

59 63 


95 99 

96La commande affiche un numéro de version suivi de `(Claude Code)`.100La commande affiche un numéro de version suivi de `(Claude Code)`.

97 101 

98<h2 id="step-2-log-in-to-your-account">102<h2 id="step-2-start-your-first-session">

99 Étape 2 : Se connecter à votre compte103 Étape 2 : Démarrer votre première session

100</h2>104</h2>

101 105 

102Claude Code nécessite un compte pour être utilisé. Démarrez une session interactive avec la commande `claude` et vous serez invité à vous connecter lors de la première utilisation :106Ouvrez votre terminal dans n'importe quel répertoire de projet et démarrez Claude Code :

103 107 

104```bash theme={null}108```bash theme={null}

109cd /path/to/your/project

105claude110claude

106```111```

107 112 

108Pour les comptes Claude abonnement ou Console, suivez les invites pour terminer l'authentification dans votre navigateur. Si vous avez défini la variable d'environnement `ANTHROPIC_API_KEY`, Claude Code ignore l'invite de connexion et vous demande d'approuver la clé à la place. Pour changer de compte ultérieurement ou vous réauthentifier, tapez `/login` dans la session en cours :113Remplacez `/path/to/your/project` par le chemin du projet sur lequel vous souhaitez travailler.

109 114 

110```text wrap theme={null}115Claude Code vous demande de vous connecter lors de la première utilisation. Pour les comptes d'abonnement Claude ou Console, suivez les instructions pour terminer l'authentification dans votre navigateur. Si vous avez défini la variable d'environnement `ANTHROPIC_API_KEY` et que vous approuvez la clé lorsque Claude Code vous demande s'il doit l'utiliser, Claude Code ignore l'invite de connexion.

111/login

112```

113 116 

114Vous pouvez vous connecter en utilisant l'un de ces types de compte :117Vous pouvez vous connecter avec l'un de ces types de comptes :

115 118 

116* [Claude Pro, Max, Team ou Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (recommandé)119* [Claude Pro, Max, Team ou Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (recommandé)

117* [Claude Console](https://platform.claude.com/) (accès API avec crédits prépayés). Lors de la première connexion, un espace de travail « Claude Code » est automatiquement créé dans la Console pour un suivi centralisé des coûts.120* [Claude Console](https://platform.claude.com/) (accès à l'API avec des crédits prépayés). Lors de la première connexion, un espace de travail « Claude Code » est automatiquement créé dans la Console pour un suivi centralisé des coûts.

118* [Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](/docs/fr/third-party-integrations) (fournisseurs cloud d'entreprise)121* [Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](/docs/fr/third-party-integrations) (fournisseurs cloud d'entreprise)

119* Une passerelle [Claude apps gateway](/docs/fr/claude-apps-gateway) auto-hébergée, si votre organisation en exécute une : votre administrateur préconfigure l'URL de la passerelle, et `/login` ouvre directement l'écran **Cloud gateway** pour que vous vous connectiez avec l'authentification unique d'entreprise122* Une [passerelle Claude apps](/docs/fr/claude-apps-gateway) auto-hébergée, si votre organisation en exploite une : votre administrateur préconfigure l'URL de la passerelle, et `/login` s'ouvre directement sur l'écran **Cloud gateway** pour que vous vous connectiez avec le SSO de votre entreprise

120 

121Une fois connecté, vos identifiants sont stockés et vous n'aurez pas besoin de vous reconnecter. En savoir plus dans [Gestion des identifiants](/docs/fr/authentication#credential-management).

122 

123<h2 id="step-3-start-your-first-session">

124 Étape 3 : Démarrer votre première session

125</h2>

126 

127Ouvrez votre terminal dans n'importe quel répertoire de projet et démarrez Claude Code :

128 

129```bash theme={null}

130cd /path/to/your/project

131claude

132```

133 123 

134Remplacez `/path/to/your/project` par le chemin du projet sur lequel vous souhaitez travailler.124Une fois connecté, vos identifiants sont enregistrés et vous n'aurez plus besoin de vous reconnecter. Pour en savoir plus, consultez [Gestion des identifiants](/docs/fr/authentication#credential-management).

135 125 

136Vous verrez l'invite de Claude Code avec la version, le modèle actuel et le répertoire de travail affichés au-dessus. Tapez `/help` pour les commandes disponibles ou `/resume` pour continuer une conversation précédente.126Le prompt de Claude Code s'affiche, avec la version, le modèle actuel et le répertoire de travail indiqués au-dessus. Tapez `/help` pour afficher les commandes disponibles ou `/resume` pour reprendre une conversation précédente. Pour changer de compte ultérieurement ou vous authentifier à nouveau, tapez `/login` dans la session en cours.

137 127 

138<h2 id="step-4-ask-your-first-question">128<h2 id="step-3-ask-your-first-question">

139 Étape 4 : Posez votre première question129 Étape 3 : Posez votre première question

140</h2>130</h2>

141 131 

142Commençons par comprendre votre base de code. Essayez l'une de ces commandes :132Essayez l'une de ces commandes :

143 133 

144```text wrap theme={null}134```text wrap theme={null}

145what does this project do?135what does this project do?


159explain the folder structure149explain the folder structure

160```150```

161 151 

162Vous pouvez également demander à Claude ses propres capacités :152Vous pouvez également interroger Claude sur ses propres capacités :

163 153 

164```text wrap theme={null}154```text wrap theme={null}

165what can Claude Code do?155what can Claude Code do?


174```164```

175 165 

176<Note>166<Note>

177 Claude Code lit vos fichiers de projet selon les besoins. Vous n'avez pas à ajouter manuellement du contexte.167 Claude Code lit les fichiers de votre projet selon les besoins. Vous n'avez pas besoin d'ajouter manuellement du contexte.

178</Note>168</Note>

179 169 

180<h2 id="step-5-make-your-first-code-change">170<h2 id="step-4-make-your-first-code-change">

181 Étape 5 : Effectuez votre première modification de code171 Étape 4 : Effectuer votre première modification de code

182</h2>172</h2>

183 173 

184Maintenant, faisons en sorte que Claude Code fasse du vrai codage. Essayez une tâche simple :174Essayez une petite tâche :

185 175 

186```text wrap theme={null}176```text wrap theme={null}

187add a hello world function to the main file177add a hello world function to the main file

188```178```

189 179 

190Claude Code trouve le fichier approprié et vous montre la modification. S'il vous demande avant d'effectuer la modification, sélectionnez **Oui** pour approuver.180Claude Code trouve le fichier approprié et vous montre la modification. S'il vous demande votre accord avant d'effectuer la modification, sélectionnez **Yes** pour l'approuver.

191 181 

192Avec Claude Code v2.1.283 ou version ultérieure, le mode auto est le [mode de permission de démarrage intégré](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) pour les sessions de terminal interactives : un classificateur examine les actions au lieu de vous, et Claude modifie la plupart des fichiers et exécute la plupart des commandes sans vous demander. Sur les versions antérieures, le mode auto est le mode de permission de démarrage intégré uniquement sur les plans Pro, Max et Team. Pour la session que vous démarrez juste après l'installation, consultez [Première session après une installation ou une mise à jour](/docs/fr/env-vars#first-session-after-an-install-or-upgrade).182Le [mode de permission](/docs/fr/permission-modes) de la session détermine les actions que Claude peut effectuer sans vous demander au préalable. Appuyez sur `Shift+Tab` à tout moment pour changer le mode de permission de la session en cours.

193 183 

194<Note>184<h2 id="step-5-use-git-with-claude-code">

195 Vos paramètres ou votre organisation peuvent définir un mode de permission de démarrage différent. [Quel mode de permission une session démarre](/docs/fr/permission-modes#which-mode-a-session-starts-in) énumère ce qui le fait. Appuyez sur `Shift+Tab` à tout moment pour basculer le mode de permission de la session dans laquelle vous vous trouvez.185 Étape 5 : Utiliser Git avec Claude Code

196</Note>

197 

198<h2 id="step-6-use-git-with-claude-code">

199 Étape 6 : Utiliser Git avec Claude Code

200</h2>186</h2>

201 187 

202Claude Code rend les opérations Git conversationnelles :188Claude Code rend les opérations Git conversationnelles :


209commit my changes with a descriptive message195commit my changes with a descriptive message

210```196```

211 197 

212Vous pouvez également demander des opérations Git plus complexes :198Vous pouvez également utiliser des prompts pour des opérations Git plus complexes :

213 199 

214```text wrap theme={null}200```text wrap theme={null}

215create a new branch called feature/quickstart201create a new branch called feature/quickstart


223help me resolve merge conflicts209help me resolve merge conflicts

224```210```

225 211 

226<h2 id="step-7-fix-a-bug-or-add-a-feature">212<h2 id="step-6-fix-a-bug-or-add-a-feature">

227 Étape 7 : Corriger un bug ou ajouter une fonctionnalité213 Étape 6 : Corriger un bug ou ajouter une fonctionnalité

228</h2>214</h2>

229 215 

230Claude est compétent pour le débogage et l'implémentation de fonctionnalités.216Décrivez ce que vous souhaitez en langage naturel :

231 

232Décrivez ce que vous voulez en langage naturel :

233 217 

234```text wrap theme={null}218```text wrap theme={null}

235add input validation to the user registration form219add input validation to the user registration form

236```220```

237 221 

238Ou corrigez les problèmes existants :222Ou corrigez des problèmes existants :

239 223 

240```text wrap theme={null}224```text wrap theme={null}

241there's a bug where users can submit empty forms - fix it225there's a bug where users can submit empty forms - fix it

242```226```

243 227 

244Claude Code va :228<h2 id="step-7-test-out-other-common-workflows">

245 229 Étape 7 : Tester d'autres workflows courants

246* Localiser le code pertinent

247* Comprendre le contexte

248* Implémenter une solution

249* Exécuter les tests si disponibles

250 

251<h2 id="step-8-test-out-other-common-workflows">

252 Étape 8 : Testez d'autres flux de travail courants

253</h2>230</h2>

254 231 

255Il existe plusieurs façons de travailler avec Claude :232Il existe de nombreuses façons de travailler avec Claude :

256 233 

257**Refactoriser le code**234**Refactoriser du code**

258 235 

259```text wrap theme={null}236```text wrap theme={null}

260refactor the authentication module to use async/await instead of callbacks237refactor the authentication module to use async/await instead of callbacks


272update the README with installation instructions249update the README with installation instructions

273```250```

274 251 

275**Révision de code**252**Revue de code**

276 253 

277```text wrap theme={null}254```text wrap theme={null}

278review my changes and suggest improvements255review my changes and suggest improvements

279```256```

280 257 

281<Tip>258<Tip>

282 Parlez à Claude comme vous le feriez avec un collègue utile. Décrivez ce que vous voulez réaliser, et il vous aidera à y arriver.259 Parlez à Claude comme vous le feriez avec un collègue serviable. Décrivez ce que vous souhaitez accomplir, et il vous aidera à y parvenir.

283</Tip>260</Tip>

284 261 

285<h2 id="essential-commands">262<h2 id="essential-commands">


357 334 

358Maintenant que vous avez appris les bases, explorez des fonctionnalités plus avancées :335Maintenant que vous avez appris les bases, explorez des fonctionnalités plus avancées :

359 336 

360<CardGroup cols={2}>337* [Comment fonctionne Claude Code](/docs/fr/how-claude-code-works) : comprendre la boucle agentique, les outils intégrés et comment Claude Code interagit avec votre projet

361 <Card title="Comment fonctionne Claude Code" icon="microchip" href="/docs/fr/how-claude-code-works">338* [Bonnes pratiques](/docs/fr/best-practices) : obtenez de meilleurs résultats avec un prompting efficace et une configuration de projet appropriée

362 Comprendre la boucle agentique, les outils intégrés et comment Claude Code interagit avec votre projet339* [Workflows courants](/docs/fr/common-workflows) : guides étape par étape pour les tâches courantes

363 </Card>340* [Étendre Claude Code](/docs/fr/features-overview) : personnalisez avec CLAUDE.md, skills, hooks, MCP et bien plus

364 

365 <Card title="Meilleures pratiques" icon="star" href="/docs/fr/best-practices">

366 Obtenez de meilleurs résultats avec un prompting efficace et une configuration de projet appropriée

367 </Card>

368 

369 <Card title="Flux de travail courants" icon="graduation-cap" href="/docs/fr/common-workflows">

370 Guides étape par étape pour les tâches courantes

371 </Card>

372 341 

373 <Card title="Étendre Claude Code" icon="puzzle-piece" href="/docs/fr/features-overview">342Consultez la [configuration avancée](/docs/fr/setup) pour les options d'installation, les mises à jour manuelles ou les instructions de désinstallation.

374 Personnalisez avec CLAUDE.md, skills, hooks, MCP et bien plus

375 </Card>

376</CardGroup>

377 343 

378<h2 id="getting-help">344<h2 id="getting-help">

379 Obtenir de l'aide345 Obtenir de l'aide

380</h2>346</h2>

381 347 

382* **Dans Claude Code** : Tapez `/help` ou demandez « comment faire... »348* **Dans Claude Code** : Tapez `/help` ou posez une question du type « comment faire... »

383* **Documentation** : Vous êtes ici ! Parcourez les autres guides349* **Documentation** : Parcourez les autres guides de ce site

384* **Cours** : Suivez [Claude Code 101](https://academy.claude.com/courses/claude-code-101) et d'autres cours gratuits à votre rythme sur [Claude Academy](https://academy.claude.com/)350* **Cours** : Suivez [Claude Code 101](https://academy.claude.com/courses/claude-code-101) et d'autres cours gratuits à votre rythme sur [Claude Academy](https://academy.claude.com/)

385* **Communauté** : Rejoignez notre [Discord](https://www.anthropic.com/discord) pour des conseils et du support351* **Communauté** : Rejoignez le [serveur Discord](https://www.anthropic.com/discord) pour des conseils et du support

Details

365</h2>365</h2>

366 366 

367* **Une session distante par processus interactif** : en dehors du mode serveur, chaque instance Claude Code prend en charge une session distante à la fois. Utilisez le [mode serveur](#start-a-remote-control-session) pour exécuter plusieurs sessions simultanées à partir d'un seul processus.367* **Une session distante par processus interactif** : en dehors du mode serveur, chaque instance Claude Code prend en charge une session distante à la fois. Utilisez le [mode serveur](#start-a-remote-control-session) pour exécuter plusieurs sessions simultanées à partir d'un seul processus.

368* **Le processus local doit rester actif** : Remote Control s'exécute en tant que processus local. Si vous fermez le terminal, quittez l'application de bureau ou VS Code, ou arrêtez autrement le processus `claude`, la session se met hors ligne jusqu'à ce que vous la [rétablissiez](#resume-sessions-after-stopping-the-server). Pour maintenir une session en cours d'exécution sur une machine distante après vous être déconnecté de SSH, démarrez-la dans `tmux` ou `screen`.368* **Le processus local doit rester actif** : Remote Control s'exécute en tant que processus local. Si vous fermez le terminal, quittez l'application de bureau ou VS Code, ou arrêtez autrement le processus `claude`, la session se met hors ligne jusqu'à ce que vous la [rétablissiez](#resume-sessions-after-stopping-the-server). Si vous exécutez `claude` depuis un terminal sur une machine distante, démarrez-le dans `tmux` ou `screen` pour que la session reste active après votre déconnexion de SSH.

369* **Sessions plantées en mode serveur** : si une session servie par `claude remote-control` plante, envoyez-lui un message depuis un appareil connecté. Claude Code la sert à nouveau. Vous n'avez pas besoin de redémarrer le serveur. Nécessite Claude Code v2.1.238 ou version ultérieure.369* **Sessions plantées en mode serveur** : si une session servie par `claude remote-control` plante, envoyez-lui un message depuis un appareil connecté. Claude Code la sert à nouveau. Vous n'avez pas besoin de redémarrer le serveur. Nécessite Claude Code v2.1.238 ou version ultérieure.

370* **Refus HTTP 403 sur une session connectée** : une fois qu'une session interactive est connectée, Claude Code continue à réessayer pendant trois minutes au maximum lorsque quelque chose entre votre machine et les serveurs d'Anthropic répond avec HTTP 403, ce qui peut se produire après un changement de VPN ou de réseau. Si les refus persistent plus longtemps, Claude Code se déconnecte, et la raison indique ce qui a refusé : une périphérie réseau, ou un proxy, un VPN ou un pare-feu sur votre propre réseau.370* **Refus HTTP 403 sur une session connectée** : une fois qu'une session interactive est connectée, Claude Code continue à réessayer pendant trois minutes au maximum lorsque quelque chose entre votre machine et les serveurs d'Anthropic répond avec HTTP 403, ce qui peut se produire après un changement de VPN ou de réseau. Si les refus persistent plus longtemps, Claude Code se déconnecte, et la raison indique ce qui a refusé : une périphérie réseau, ou un proxy, un VPN ou un pare-feu sur votre propre réseau.

371* **Panne réseau prolongée** : si votre machine est allumée mais ne peut pas accéder au réseau, ce que vous faites ensuite dépend du mode :371* **Panne réseau prolongée** : si votre machine est allumée mais ne peut pas accéder au réseau, ce que vous faites ensuite dépend du mode :

routines.md +1 −1

Details

93 Choisissez un [environnement cloud](/docs/fr/cloud-environments) pour la routine. Les environnements contrôlent ce à quoi la session cloud a accès :93 Choisissez un [environnement cloud](/docs/fr/cloud-environments) pour la routine. Les environnements contrôlent ce à quoi la session cloud a accès :

94 94 

95 * **Network access** : définissez le niveau d'accès à Internet disponible pendant chaque exécution95 * **Network access** : définissez le niveau d'accès à Internet disponible pendant chaque exécution

96 * **Environment variables** : fournissez des valeurs que Claude peut utiliser pendant chaque exécution. Elles sont [visibles à quiconque utilise l'environnement](/docs/fr/cloud-environments#what-carries-over-from-your-setup), donc sur les plans Pro et Max, stockez les clés pour les API que Claude appelle pendant une exécution en tant que [API credentials](/docs/fr/cloud-environments#add-api-credentials) à la place. Cette section liste également les demandes qui ne reçoivent jamais d'identifiant96 * **Environment variables** : fournissez des valeurs que Claude peut utiliser pendant chaque exécution. Elles sont [visibles à quiconque utilise l'environnement](/docs/fr/cloud-environments#what-carries-over-from-your-setup), donc sur les plans Pro et Max, stockez plutôt les clés pour les API que Claude appelle pendant une exécution en tant que [secrets réseau](/docs/fr/cloud-environments#add-api-credentials). Cette section liste également les requêtes qui ne reçoivent jamais de secret

97 * **Setup script** : installez les dépendances et les outils dont la routine a besoin. Le résultat est [mis en cache](/docs/fr/cloud-environments#environment-caching), de sorte que le script ne se réexécute pas à chaque session97 * **Setup script** : installez les dépendances et les outils dont la routine a besoin. Le résultat est [mis en cache](/docs/fr/cloud-environments#environment-caching), de sorte que le script ne se réexécute pas à chaque session

98 98 

99 Un environnement **Default** est fourni avec un accès réseau **Trusted**, qui permet uniquement la [liste d'autorisation par défaut](/docs/fr/cloud-environments#default-allowed-domains) des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants à travers le réseau de la session. Les connecteurs que vous ajoutez à la routine atteignent leurs services via les serveurs d'Anthropic, donc ils n'ont pas besoin de modifications de liste d'autorisation. Si votre routine doit atteindre vos propres services directement, ou un domaine en dehors de cette liste, modifiez l'[accès réseau](/docs/fr/cloud-environments#network-access) de l'environnement avant d'exécuter. Pour utiliser un environnement séparé, [créez-en un](/docs/fr/cloud-environments#configure-your-environment) d'abord.99 Un environnement **Default** est fourni avec un accès réseau **Trusted**, qui permet uniquement la [liste d'autorisation par défaut](/docs/fr/cloud-environments#default-allowed-domains) des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants à travers le réseau de la session. Les connecteurs que vous ajoutez à la routine atteignent leurs services via les serveurs d'Anthropic, donc ils n'ont pas besoin de modifications de liste d'autorisation. Si votre routine doit atteindre vos propres services directement, ou un domaine en dehors de cette liste, modifiez l'[accès réseau](/docs/fr/cloud-environments#network-access) de l'environnement avant d'exécuter. Pour utiliser un environnement séparé, [créez-en un](/docs/fr/cloud-environments#configure-your-environment) d'abord.

Details

104 Exemple de script104 Exemple de script

105</h2>105</h2>

106 106 

107Le script ci-dessous exécute la boucle complète contre `$CLAUDE_TEST_ENVIRONMENT_ID`, l'ID `ccpool_...` de votre environnement de test, affiché dans la boîte de dialogue de détail de l'environnement sur la page d'administration ou retourné par l'[appel create-environment](#create-a-dedicated-test-environment), et affirme sur une phrase sentinelle dans chaque réponse. Exécutez-le à partir d'une extraction git du référentiel dans lequel vous voulez que la session fonctionne, après avoir démarré un runner sur cet hôte avec le hook de capture installé et `E2E_REPLY_DIR` exporté.107Le script ci-dessous exécute la boucle complète contre `$CLAUDE_TEST_ENVIRONMENT_ID`, l'ID `ccpool_...` de votre environnement de test, affiché dans la boîte de dialogue de détail de l'environnement sur la page d'administration ou retourné par l'[appel create-environment](#create-a-dedicated-test-environment), et affirme sur une phrase sentinelle dans chaque réponse. Exécutez-le à partir d'une extraction git du dépôt dans lequel vous voulez que la session fonctionne, après avoir démarré un runner sur cet hôte avec le hook de capture installé et `E2E_REPLY_DIR` exporté. Connectez-vous d'abord avec un compte claude.ai sur la machine qui exécute le script, comme décrit dans [S'authentifier depuis la CI](#authenticate-from-ci). Sans cette connexion, le premier envoi échoue avec une erreur telle que `Unable to get organization UUID for cloud session creation`.

108 108 

109```bash theme={null}109```bash theme={null}

110#!/usr/bin/env bash110#!/usr/bin/env bash

Details

43 <Step title="Ouvrir la console d'administration">43 <Step title="Ouvrir la console d'administration">

44 Dans la console claude.ai, accédez à [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code).44 Dans la console claude.ai, accédez à [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code).

45 45 

46 Si le lien vous redirige vers une page Organization settings différente au lieu de la page Claude Code, votre compte n'a pas le rôle requis. Les rôles Admin et autres rôles non-Propriétaire ne peuvent pas afficher ou modifier les paramètres gérés, donc demandez à un Propriétaire ou Propriétaire principal de votre organisation de faire la modification. Consultez [Contrôle d'accès](#access-control).46 Dans une organisation Team ou Enterprise, si la page indique que vous n'avez pas accès, demandez à un [Propriétaire ou Propriétaire principal](#access-control) d'effectuer la modification.

47 </Step>47 </Step>

48 48 

49 <Step title="Définir vos paramètres">49 <Step title="Définir vos paramètres">


149 Précédence des paramètres149 Précédence des paramètres

150</h3>150</h3>

151 151 

152Les paramètres gérés par le serveur et les [paramètres gérés par le point de terminaison](/docs/fr/managed-settings#delivery-mechanisms) occupent tous deux le niveau le plus élevé dans la [hiérarchie des paramètres](/docs/fr/settings#settings-precedence) de Claude Code. Aucun autre niveau de paramètres ne peut les remplacer, y compris les arguments de ligne de commande, à l'exception des [exceptions à la précédence des paramètres gérés](/docs/fr/settings#exceptions-to-managed-settings-precedence).152Les paramètres gérés par le serveur et les [paramètres gérés par l'endpoint](/docs/fr/managed-settings#delivery-mechanisms) occupent tous deux le niveau le plus élevé dans la [hiérarchie des paramètres](/docs/fr/settings#settings-precedence) de Claude Code. Une clé que vous définissez ici a priorité sur la même clé dans les propres fichiers de paramètres d'un utilisateur ou dans une valeur `--settings`, à l'exception des [exceptions à la priorité des paramètres gérés](/docs/fr/settings#exceptions-to-managed-settings-precedence).

153 153 

154Au sein du niveau géré, Claude Code utilise par défaut la première source qui livre au moins une clé de stratégie, en vérifiant d'abord les paramètres gérés par le serveur, puis les paramètres gérés par le point de terminaison, à l'exception des [clés d'exception couvertes ensuite](#per-key-exceptions-across-managed-sources). [Comment Claude Code combine les sources gérées](/docs/fr/managed-settings#precedence-within-the-managed-tier) contient le classement complet, l'exception pour les clés de contrôle, et l'opt-in qui s'applique à chaque source.154Au sein du niveau géré, Claude Code utilise par défaut la première source qui livre au moins une clé de stratégie, en vérifiant d'abord les paramètres gérés par le serveur, puis les paramètres gérés par le point de terminaison, à l'exception des [clés d'exception couvertes ensuite](#per-key-exceptions-across-managed-sources). [Comment Claude Code combine les sources gérées](/docs/fr/managed-settings#precedence-within-the-managed-tier) contient le classement complet, l'exception pour les clés de contrôle, et l'opt-in qui s'applique à chaque source.

155 155 

sessions.md +30 −28

Details

22| `claude --resume` | Ouvre le [sélecteur de sessions](#use-the-session-picker) |22| `claude --resume` | Ouvre le [sélecteur de sessions](#use-the-session-picker) |

23| `claude --resume <name>` | Reprend directement la session nommée |23| `claude --resume <name>` | Reprend directement la session nommée |

24| `claude --resume <transcript-path>` | Reprend la conversation stockée dans le fichier de [transcription](#where-transcripts-are-stored) `.jsonl` à ce chemin absolu |24| `claude --resume <transcript-path>` | Reprend la conversation stockée dans le fichier de [transcription](#where-transcripts-are-stored) `.jsonl` à ce chemin absolu |

25| `claude --from-pr <number>` | Ouvre le sélecteur de sessions filtré aux sessions liées à cette demande de tirage |25| `claude --from-pr <number>` | Ouvre le sélecteur de sessions filtré aux sessions liées à cette pull request |

26| `/resume` | Bascule vers une conversation différente depuis une session active |26| `/resume` | Bascule vers une conversation différente depuis une session active |

27 27 

28Claude Code laisse les sessions créées avec [`claude -p`](/docs/fr/headless) ou le [SDK Agent](/docs/fr/agent-sdk/overview) en dehors du sélecteur de sessions et en dehors de `claude --continue`. Vous pouvez toujours en reprendre une en passant son ID de session à `claude --resume <session-id>`. Avec `claude --continue`, Claude Code ignore également les [sessions dont la première invite était `/loop`](#where-the-session-picker-looks). Lorsque vous exécutez [`claude -p --continue`](/docs/fr/headless#continue-conversations), Claude Code inclut les sessions `-p`, SDK et `/loop`.28Claude Code laisse les sessions créées avec [`claude -p`](/docs/fr/headless) ou le [SDK Agent](/docs/fr/agent-sdk/overview) en dehors du sélecteur de sessions et en dehors de `claude --continue`. Vous pouvez toujours en reprendre une en passant son ID de session à `claude --resume <session-id>`. Avec `claude --continue`, Claude Code ignore également les [sessions dont le premier prompt était `/loop`](#where-the-session-picker-looks). Lorsque vous exécutez [`claude -p --continue`](/docs/fr/headless#continue-conversations), Claude Code inclut les sessions `-p`, SDK et `/loop`.

29 29 

30Vous pouvez exécuter `claude --resume <session-id>` depuis n'importe quel répertoire, ce qui vous permet de reprendre une session qui a démarré ailleurs ou qui s'est déplacée avec [`/cd`](/docs/fr/commands). Claude Code cherche l'ID dans cet ordre :30Vous pouvez exécuter `claude --resume <session-id>` depuis n'importe quel répertoire, ce qui vous permet de reprendre une session qui a démarré ailleurs ou qui s'est déplacée avec [`/cd`](/docs/fr/commands). Claude Code cherche l'ID dans cet ordre :

31 31 


44 44 

45Lorsque la conversation que vous reprenez avec `claude --resume` ou `/resume` appartient à une [session en arrière-plan](/docs/fr/agent-view) qui est toujours en cours d'exécution, Claude Code ouvre la session en cours d'exécution elle-même. Avec `--bg` sur la ligne de commande, la reprise est une [expédition en arrière-plan](/docs/fr/agent-view#from-your-shell) à la place. Avant la v2.1.285, Claude Code refusait et vous disait d'ouvrir la session avec `claude attach <id>`, ou de l'arrêter d'abord avec `claude stop <id>`.45Lorsque la conversation que vous reprenez avec `claude --resume` ou `/resume` appartient à une [session en arrière-plan](/docs/fr/agent-view) qui est toujours en cours d'exécution, Claude Code ouvre la session en cours d'exécution elle-même. Avec `--bg` sur la ligne de commande, la reprise est une [expédition en arrière-plan](/docs/fr/agent-view#from-your-shell) à la place. Avant la v2.1.285, Claude Code refusait et vous disait d'ouvrir la session avec `claude attach <id>`, ou de l'arrêter d'abord avec `claude stop <id>`.

46 46 

47* **Depuis votre shell** : `claude --resume <session>` exécute [`claude attach`](/docs/fr/agent-view#attach-to-a-session) sur cette session dans le même terminal au lieu de charger la transcription elle-même. Une invite que vous passez sur la ligne de commande, comme dans `claude --resume <session> "check the tests too"`, va à la session comme son prochain tour d'abord, et Claude Code affiche `Sent your prompt to the background session (<id>); opening it…` avant de s'attacher. `claude -p --resume <session> "prompt"` tapé à un terminal fait la même chose, donc `-p` ne garde pas cette exécution non-interactive.47* **Depuis votre shell** : `claude --resume <session>` exécute [`claude attach`](/docs/fr/agent-view#attach-to-a-session) sur cette session dans le même terminal au lieu de charger la transcription elle-même. Un prompt que vous passez sur la ligne de commande, comme dans `claude --resume <session> "check the tests too"`, va d'abord à la session comme son prochain tour, et Claude Code affiche `Sent your prompt to the background session (<id>); opening it…` avant de s'attacher. `claude -p --resume <session> "prompt"` tapé dans un terminal fait la même chose, donc `-p` ne garde pas cette exécution non-interactive.

48 48 

49 Claude Code n'ouvre pas la session lorsque la ligne de commande contient l'un de ceux-ci :49 Claude Code n'ouvre pas la session lorsque la ligne de commande contient l'un de ceux-ci :

50 50 

51 * Entrée ou sortie redirigée ou canalisée51 * Entrée ou sortie redirigée ou canalisée

52 * Drapeaux qui configurent la session, tels que `--permission-mode`, `--model` ou `--settings`52 * Flags qui configurent la session, tels que `--permission-mode`, `--model` ou `--settings`

53 * Drapeaux qui lisent la sortie, tels que `--output-format json` ou `--json-schema`53 * Flags qui lisent la sortie, tels que `--output-format json` ou `--json-schema`

54 * Drapeaux qui limitent ou rembobinent l'exécution, tels que `--max-turns` ou `--max-budget-usd`54 * Flags qui limitent ou rembobinent l'exécution, tels que `--max-turns` ou `--max-budget-usd`

55 55 

56 Avec l'un de ceux-ci, ou lorsque la [vue agent est désactivée](/docs/fr/agent-view#turn-off-agent-view), Claude Code n'envoie rien et se termine avec le statut 1, en affichant que la session s'exécute en arrière-plan ainsi que la commande `claude attach <id>` qui l'ouvre, ou en vous disant de la trouver dans `claude agents` lorsqu'il ne peut pas déterminer l'ID. Ajoutez `--fork-session` pour reprendre une copie de la conversation à la place. Pour continuer la conversation elle-même dans une session qui vous appartient, avec vos drapeaux appliqués, exécutez `claude stop <id>` puis répétez la commande.56 Avec l'un de ceux-ci, ou lorsque la [vue agent est désactivée](/docs/fr/agent-view#turn-off-agent-view), Claude Code n'envoie rien et se termine avec le statut 1, en affichant que la session s'exécute en arrière-plan ainsi que la commande `claude attach <id>` qui l'ouvre, ou en vous disant de la trouver dans `claude agents` lorsqu'il ne peut pas déterminer l'ID. Ajoutez `--fork-session` pour reprendre une copie de la conversation à la place. Pour continuer la conversation elle-même dans une session qui vous appartient, avec vos flags appliqués, exécutez `claude stop <id>` puis répétez la commande.

57 57 

58 Une invite qui commence par `/` ou `!` n'est pas envoyée, et non plus aucune invite pendant que la session attend votre réponse à une question. Dans les deux cas, Claude Code n'ouvre pas la session, et le message inclut `Your prompt was not sent to it` avec la raison.58 Un prompt qui commence par `/` ou `!` n'est pas envoyé, et aucun prompt ne l'est non plus pendant que la session attend votre réponse à une question. Dans les deux cas, Claude Code n'ouvre pas la session, et le message inclut `Your prompt was not sent to it` avec la raison.

59* **Depuis l'intérieur d'une session** : `/resume` déplace votre conversation actuelle en arrière-plan et attache ce terminal à la session en cours d'exécution, en affichant `Opening "<title>", running in the background (<id>)`. Appuyez sur `←` sur une invite vide pour revenir à la vue agent, qui liste également la conversation que vous avez laissée. Lorsque la conversation actuelle ne peut pas se déplacer en arrière-plan, par exemple parce que vous êtes déjà attaché à une session en arrière-plan ou que la persistance de session est désactivée, `/resume` affiche la commande `claude attach` à exécuter à la place.59* **Depuis l'intérieur d'une session** : `/resume` déplace votre conversation actuelle en arrière-plan et attache ce terminal à la session en cours d'exécution, en affichant `Opening "<title>", running in the background (<id>)`. Appuyez sur `←` sur un prompt vide pour revenir à la vue agent, qui liste également la conversation que vous avez laissée. Lorsque la conversation actuelle ne peut pas se déplacer en arrière-plan, par exemple parce que vous êtes déjà attaché à une session en arrière-plan ou que la persistance de session est désactivée, `/resume` affiche la commande `claude attach` à exécuter à la place.

60 60 

61<h3 id="what-a-resumed-session-restores">61<h3 id="what-a-resumed-session-restores">

62 Ce qu'une session reprise restaure62 Ce qu'une session reprise restaure


65Lorsque Claude Code charge une conversation à partir de sa transcription, la session reprise restaure la conversation ainsi que l'état enregistré en elle :65Lorsque Claude Code charge une conversation à partir de sa transcription, la session reprise restaure la conversation ainsi que l'état enregistré en elle :

66 66 

67* Historique de conversation : l'historique complet, y compris les appels d'outils et les résultats. Un outil qui était toujours en cours d'exécution lorsque le processus précédent s'est terminé, par exemple lors d'un plantage, ne se termine pas ou ne s'exécute pas à nouveau lorsque vous reprenez. Claude voit l'appel marqué comme interrompu avant que son résultat ne soit enregistré et on lui dit de vérifier s'il a pris effet avant de l'exécuter à nouveau, sauf si [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/fr/env-vars#variables) est défini. Avant la v2.1.281, Claude Code supprimait l'appel interrompu de la conversation ou le montrait à Claude comme un appel que vous aviez interrompu.67* Historique de conversation : l'historique complet, y compris les appels d'outils et les résultats. Un outil qui était toujours en cours d'exécution lorsque le processus précédent s'est terminé, par exemple lors d'un plantage, ne se termine pas ou ne s'exécute pas à nouveau lorsque vous reprenez. Claude voit l'appel marqué comme interrompu avant que son résultat ne soit enregistré et on lui dit de vérifier s'il a pris effet avant de l'exécuter à nouveau, sauf si [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/fr/env-vars#variables) est défini. Avant la v2.1.281, Claude Code supprimait l'appel interrompu de la conversation ou le montrait à Claude comme un appel que vous aviez interrompu.

68* Modèle : la session continue sur le modèle qu'elle utilisait. Le modèle n'est pas restauré lorsqu'il a été retiré ou n'est pas autorisé par `availableModels`, lorsqu'un drapeau `--model` ou une variable d'environnement de la famille `ANTHROPIC_MODEL` en choisit un au lancement, ou sur les fournisseurs qui utilisent des ID de déploiement spécifiques au fournisseur, tels que [Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry](/docs/fr/third-party-integrations) ; voir [configuration du modèle](/docs/fr/model-config#setting-your-model) pour l'ordre de résolution.68* Modèle : la session continue sur le modèle qu'elle utilisait, sauf dans les cas décrits dans [Définir votre modèle](/docs/fr/model-config#setting-your-model).

69* Agent : une session démarrée avec [`--agent`](/docs/fr/sub-agents#invoke-subagents-explicitly) ou le paramètre `agent` continue en tant que cet agent, en conservant ses restrictions d'outils et son modèle. Passez `--agent` lors de la reprise pour en choisir un différent ; pour l'invite système dans l'un ou l'autre cas, voir [Drapeaux d'invite système dans les conversations reprises](/docs/fr/cli-reference#system-prompt-flags-in-resumed-conversations). Claude Code cherche l'agent dans deux endroits : le répertoire d'origine de la session, à condition que vous ayez [approuvé cet espace de travail](/docs/fr/permissions#project-allow-rules-and-workspace-trust), puis le répertoire depuis lequel vous reprenez, donc un agent limité au projet se charge toujours lorsque vous reprenez depuis un autre répertoire. Si Claude Code ne trouve pas l'agent dans l'un ou l'autre endroit, la session reprend avec les outils par défaut et affiche un [avertissement nommant l'agent](/docs/fr/errors#session-agent-no-longer-available).69* Agent : une session démarrée avec [`--agent`](/docs/fr/sub-agents#invoke-subagents-explicitly) ou le paramètre `agent` continue en tant que cet agent, en conservant ses restrictions d'outils et son modèle. Passez `--agent` lors de la reprise pour en choisir un différent ; pour le prompt système dans l'un ou l'autre cas, voir [Flags de prompt système dans les conversations reprises](/docs/fr/cli-reference#system-prompt-flags-in-resumed-conversations). Claude Code cherche l'agent dans deux endroits : le répertoire d'origine de la session, à condition que vous ayez [approuvé cet espace de travail](/docs/fr/permissions#project-allow-rules-and-workspace-trust), puis le répertoire depuis lequel vous reprenez, donc un agent limité au projet se charge toujours lorsque vous reprenez depuis un autre répertoire. Si Claude Code ne trouve pas l'agent dans l'un ou l'autre endroit, la session reprend avec les outils par défaut et affiche un [avertissement nommant l'agent](/docs/fr/errors#session-agent-no-longer-available).

70* Mode de permission : si vous reprenez depuis un terminal avec `claude --continue`, `claude --resume <session-id>` ou `claude --resume <name>` lorsque le nom correspond à une session, sans `-p`, Claude Code restaure le mode de permission dans lequel se trouvait la session, sauf dans les cas de [mode de permission à la reprise](#permission-mode-on-resume), qui couvre également le sélecteur de sessions, `/resume` et la reprise avec `claude -p`. Passez `--permission-mode` ou `--dangerously-skip-permissions` pour remplacer le mode restauré.70* Mode de permission : si vous reprenez depuis un terminal avec `claude --continue`, `claude --resume <session-id>` ou `claude --resume <name>` lorsque le nom correspond à une session, sans `-p`, Claude Code restaure le mode de permission dans lequel se trouvait la session, sauf dans les cas de [mode de permission à la reprise](#permission-mode-on-resume), qui couvre également le sélecteur de sessions, `/resume` et la reprise avec `claude -p`. Passez `--permission-mode` ou `--dangerously-skip-permissions` pour remplacer le mode restauré.

71* Objectif actif : un [objectif](/docs/fr/goal#resume-with-an-active-goal) qui était toujours actif lorsque la session s'est terminée se poursuit ; son nombre de tours, son minuteur et sa ligne de base de dépense de jetons se réinitialisent.71* Objectif actif : un [objectif](/docs/fr/goal#resume-with-an-active-goal) qui était toujours actif lorsque la session s'est terminée se poursuit ; son nombre de tours, son minuteur et sa ligne de base de dépense de tokens se réinitialisent.

72* Tâches planifiées : les [tâches qui n'ont pas expiré](/docs/fr/scheduled-tasks#limitations) sont restaurées. Les tâches Bash en arrière-plan et les tâches de surveillance ne le sont pas.72* Tâches planifiées : les [tâches qui n'ont pas expiré](/docs/fr/scheduled-tasks#limitations) sont restaurées. Les tâches Bash en arrière-plan et les tâches de surveillance ne le sont pas.

73* Travail en arrière-plan : un [sous-agent en arrière-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background), une commande Bash en arrière-plan, ou un [flux de travail](/docs/fr/workflows) qui s'est terminé avec le processus précédent s'affiche dans la transcription reprise comme une note indiquant qu'il ne s'est pas terminé. Claude Code ne démarre pas un tour à partir de ces notes ; Claude les lit avec votre prochaine invite.73* Travail en arrière-plan : un [sous-agent en arrière-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background), une commande Bash en arrière-plan, ou un [workflow](/docs/fr/workflows) qui s'est terminé avec le processus précédent s'affiche dans la transcription reprise comme une note indiquant qu'il ne s'est pas terminé. Claude Code ne démarre pas un tour à partir de ces notes ; Claude les lit avec votre prochain prompt.

74 74 

75Tous les drapeaux de configuration du lancement d'origine ne sont pas restaurés. Si la session dépendait de `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model` ou de répertoires ajoutés avec `--add-dir`, passez-les à nouveau lorsque vous reprenez ; les répertoires ajoutés en milieu de session avec `/add-dir` ne sont pas restaurés non plus, bien que le sélecteur de sessions les utilise toujours pour localiser la session. Les fichiers de paramètres standard, tels que `settings.json` et `settings.local.json`, sont relus au lancement, donc la configuration qui s'y trouve n'a pas besoin d'être passée à nouveau. Pour `--system-prompt` et `--append-system-prompt`, voir [Drapeaux d'invite système dans les conversations reprises](/docs/fr/cli-reference#system-prompt-flags-in-resumed-conversations).75Tous les flags de configuration du lancement d'origine ne sont pas restaurés. Si la session dépendait de `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model` ou de répertoires ajoutés avec `--add-dir`, passez-les à nouveau lorsque vous reprenez ; les répertoires ajoutés en milieu de session avec `/add-dir` ne sont pas restaurés non plus, bien que le sélecteur de sessions les utilise toujours pour localiser la session. Les fichiers de paramètres standard, tels que `settings.json` et `settings.local.json`, sont relus au lancement, donc la configuration qui s'y trouve n'a pas besoin d'être passée à nouveau. Pour `--system-prompt` et `--append-system-prompt`, voir [Flags de prompt système dans les conversations reprises](/docs/fr/cli-reference#system-prompt-flags-in-resumed-conversations).

76 76 

77<h4 id="permission-mode-on-resume">77<h4 id="permission-mode-on-resume">

78 Mode de permission à la reprise78 Mode de permission à la reprise


83* Terminal : `claude --continue`, `claude --resume <session-id>` ou `claude --resume <name>` lorsque le nom correspond à une session, sans `-p`. Claude Code restaure le mode de permission dans lequel se trouvait la session, sauf dans les cas du tableau. Passez `--permission-mode` ou `--dangerously-skip-permissions` pour remplacer le mode restauré.83* Terminal : `claude --continue`, `claude --resume <session-id>` ou `claude --resume <name>` lorsque le nom correspond à une session, sans `-p`. Claude Code restaure le mode de permission dans lequel se trouvait la session, sauf dans les cas du tableau. Passez `--permission-mode` ou `--dangerously-skip-permissions` pour remplacer le mode restauré.

84* Non-interactif : `claude -p --resume` ou `claude -p --continue`. Claude Code démarre l'exécution dans le mode de permission qu'une nouvelle exécution `claude -p` démarrerait, sauf qu'une session qui s'est terminée en mode plan reprend en mode plan selon les [conditions ci-dessous](#resume-in-plan-mode-with-p).84* Non-interactif : `claude -p --resume` ou `claude -p --continue`. Claude Code démarre l'exécution dans le mode de permission qu'une nouvelle exécution `claude -p` démarrerait, sauf qu'une session qui s'est terminée en mode plan reprend en mode plan selon les [conditions ci-dessous](#resume-in-plan-mode-with-p).

85* VS Code : le panneau de conversation de l'extension. Le tableau couvre uniquement une conversation qui s'est terminée en mode plan ; pour le reste, voir [reprendre les conversations passées](/docs/fr/vs-code#resume-past-conversations).85* VS Code : le panneau de conversation de l'extension. Le tableau couvre uniquement une conversation qui s'est terminée en mode plan ; pour le reste, voir [reprendre les conversations passées](/docs/fr/vs-code#resume-past-conversations).

86* Sélecteur de sessions au lancement : une session que vous sélectionnez dans le [sélecteur de sessions](#use-the-session-picker), que vous l'ayez ouvert avec `claude --resume` seul, `claude --from-pr` ou un nom qui correspond à plus d'une session. Claude Code ne restaure pas le mode de permission stocké. Il démarre la session dans le mode de permission qu'il démarrerait une nouvelle session depuis la même ligne de commande.86* Sélecteur de sessions au lancement : une session que vous sélectionnez dans le [sélecteur de sessions](#use-the-session-picker), que vous l'ayez ouvert avec `claude --resume` seul, `claude --from-pr` ou un nom qui correspond à plus d'une session. Claude Code démarre la session dans le mode de permission dans lequel il démarrerait une nouvelle session depuis la même ligne de commande, sauf qu'une session qui s'est terminée en mode plan reprend en mode plan, à moins que vous ne passiez `--permission-mode`, `--dangerously-skip-permissions` ou `--fork-session`. Aucun autre mode de permission stocké n'est restauré.

87* `/resume` à l'intérieur d'une session, avec ou sans argument : Claude Code ne restaure pas le mode de permission stocké. La conversation vers laquelle vous basculez continue dans le mode de permission dans lequel se trouve votre session actuelle.87* `/resume` à l'intérieur d'une session, avec ou sans argument : la conversation vers laquelle vous basculez continue dans le mode de permission dans lequel se trouve votre session actuelle, sauf qu'une conversation qui s'est terminée en mode plan reprend en mode plan, même si vous avez lancé Claude Code avec `--permission-mode` ou `--dangerously-skip-permissions`. Si cette conversation était déjà ouverte plus tôt dans cette exécution de Claude Code, comme la conversation dans laquelle vous avez commencé ou une conversation que vous avez quittée avec `/clear` ou `/resume`, elle continue plutôt dans votre mode de permission actuel.

88 88 

89La restauration du mode plan sur les chemins non-interactif et VS Code nécessite Claude Code v2.1.246 ou ultérieur. Chaque ligne nomme le mode de permission dans lequel la session s'est terminée, lequel des chemins terminal, non-interactif et VS Code vous la reprenez par, et le mode de permission dans lequel Claude Code démarre la session reprise.89La restauration du mode plan sur les chemins non-interactif et VS Code nécessite Claude Code v2.1.246 ou ultérieur. Chaque ligne nomme le mode de permission dans lequel la session s'est terminée, lequel des chemins terminal, non-interactif et VS Code vous empruntez pour la reprendre, et le mode de permission dans lequel Claude Code démarre la session reprise.

90 90 

91| Session terminée en | Comment vous la reprenez | Mode de permission après la reprise |91| Session terminée en | Comment vous la reprenez | Mode de permission après la reprise |

92| :- | :- | :- |92| :- | :- | :- |

93| `bypassPermissions` | Terminal | Le mode de permission qu'une nouvelle session démarrerait. Pour [contourner les permissions](/docs/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode) à nouveau, activez-le au lancement avec l'un de ses drapeaux de lancement ou `permissions.defaultMode: "bypassPermissions"` dans les [paramètres utilisateur, `--settings` ou gérés](/docs/fr/settings-reference#permissions-defaultmode) |93| `bypassPermissions` | Terminal | Le mode de permission qu'une nouvelle session démarrerait. Pour [contourner les permissions](/docs/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode) à nouveau, activez-le au lancement avec l'un de ses flags de lancement ou `permissions.defaultMode: "bypassPermissions"` dans les [paramètres utilisateur, `--settings` ou gérés](/docs/fr/settings-reference#permissions-defaultmode) |

94| `plan` | Terminal | Le mode de permission qu'une nouvelle session démarrerait |94| `plan` | Terminal | Mode plan. Avec `--fork-session`, le mode de permission dans lequel une nouvelle session démarrerait |

95| `auto` | Terminal | `auto`, uniquement lorsque votre compte répond toujours aux [exigences du mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) |95| `auto` | Terminal | `auto`, uniquement lorsque votre compte répond toujours aux [exigences du mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) |

96| Manuel | Terminal | Manuel lorsqu'une nouvelle session démarrerait en mode auto à partir de la [valeur par défaut intégrée](/docs/fr/permission-modes#which-mode-a-session-starts-in). Lorsqu'un `defaultMode` d'un fichier de paramètres [prend effet](/docs/fr/permission-modes#which-mode-a-session-starts-in), Claude Code démarre la session reprise dans ce mode à la place |96| Manuel | Terminal | Manuel lorsqu'une nouvelle session démarrerait en mode auto à partir de la [valeur par défaut intégrée](/docs/fr/permission-modes#which-mode-a-session-starts-in). Lorsqu'un `defaultMode` d'un fichier de paramètres [prend effet](/docs/fr/permission-modes#which-mode-a-session-starts-in), Claude Code démarre la session reprise dans ce mode à la place |

97| `plan` | Non-interactif, selon les [conditions ci-dessous](#resume-in-plan-mode-with-p) | Mode plan |97| `plan` | Non-interactif, selon les [conditions ci-dessous](#resume-in-plan-mode-with-p) | Mode plan |

98| N'importe quel mode | Non-interactif, dans tout autre cas | Le mode de permission qu'une nouvelle exécution `claude -p` démarrerait |98| N'importe quel mode | Non-interactif, dans tout autre cas | Le mode de permission qu'une nouvelle exécution `claude -p` démarrerait |

99| `plan` | VS Code | Mode plan, avec [les exceptions sur la page VS Code](/docs/fr/vs-code#resume-past-conversations) |99| `plan` | VS Code | Mode plan, avec [les exceptions sur la page VS Code](/docs/fr/vs-code#resume-past-conversations) |

100 100 

101<a id="resume-in-plan-mode-with-p" />

102 

101<h5 id="resume-in-plan-mode-with-p">103<h5 id="resume-in-plan-mode-with-p">

102 Reprendre en mode plan avec `-p`104 Reprendre en mode plan avec `-p`

103</h5>105</h5>


113 Reprendre à partir d'un résumé115 Reprendre à partir d'un résumé

114</h3>116</h3>

115 117 

116Sur un plan Pro ou Max, lorsque vous reprenez une session qui a été inactive pendant plus d'une heure environ et dépasse 100 000 jetons, Claude Code restaure la conversation puis ouvre une boîte de dialogue avant que vous n'envoyiez votre premier message. Le [cache de prompt](/docs/fr/prompt-caching#cache-lifetime) de la session a expiré à ce moment-là, donc la prochaine demande traite l'historique complet une fois, quel que soit l'option de la boîte de dialogue que vous choisissez.118Sur un plan Pro ou Max, lorsque vous reprenez une session qui a été inactive pendant plus d'une heure environ et dépasse 100 000 tokens, Claude Code restaure la conversation puis ouvre une boîte de dialogue avant que vous n'envoyiez votre premier message. Le [cache de prompt](/docs/fr/prompt-caching#cache-lifetime) de la session a expiré à ce moment-là, donc la prochaine requête traite l'historique complet une fois, quelle que soit l'option de la boîte de dialogue que vous choisissez.

117 119 

118La boîte de dialogue offre trois façons de continuer la session. Elles diffèrent dans la quantité de conversation que chacune porte dans les demandes ultérieures, ce qui est un compromis entre conserver tous les détails et envoyer moins de jetons par demande :120La boîte de dialogue offre trois façons de continuer la session. Elles diffèrent dans la quantité de conversation que chacune porte dans les requêtes ultérieures, ce qui est un compromis entre conserver tous les détails et envoyer moins de tokens par requête :

119 121 

120* **Reprendre à partir du résumé** : exécute [`/compact`](/docs/fr/context-window#what-survives-compaction) immédiatement. Claude Code envoie une demande de résumé sur l'historique complet, puis remplace l'historique par le résumé, vos échanges les plus récents et jusqu'à cinq fichiers récemment lus. Les demandes ultérieures portent le résumé au lieu de l'historique complet.122* **Reprendre à partir du résumé** : exécute [`/compact`](/docs/fr/context-window#what-survives-compaction) immédiatement. Claude Code envoie une requête de résumé sur l'historique complet, puis remplace l'historique par le résumé, vos échanges les plus récents et jusqu'à cinq fichiers récemment lus. Les requêtes ultérieures portent le résumé au lieu de l'historique complet.

121* **Reprendre la session complète telle quelle** : charge la conversation inchangée. Après que vous ayez envoyé votre premier message, Claude Code retraite et re-met en cache l'historique complet, puis le relit à partir du cache sur les demandes ultérieures tant que le cache reste actif.123* **Reprendre la session complète telle quelle** : charge la conversation inchangée. Après que vous avez envoyé votre premier message, Claude Code retraite et remet en cache l'historique complet, puis le relit à partir du cache sur les requêtes ultérieures tant que le cache reste actif.

122* **Ne me le demandez plus** : reprend la session complète et arrête d'afficher la boîte de dialogue sur toutes les reprises futures.124* **Ne me le demandez plus** : reprend la session complète et arrête d'afficher la boîte de dialogue sur toutes les reprises futures.

123 125 

124Reprendre tel quel conserve tous les détails de la conversation disponibles, à un coût par demande qui s'adapte à la taille de la conversation. Reprendre à partir du résumé coûte moins cher à chaque demande ultérieure car il porte le résumé au lieu de l'historique complet, mais tout ce que le résumé omet n'est plus dans le contexte de Claude. Voir [pourquoi l'utilisation augmente dans une longue session](/docs/fr/costs#why-usage-climbs-in-a-long-session) pour savoir d'où provient ce coût par demande.126Reprendre tel quel conserve tous les détails de la conversation disponibles, à un coût par requête qui s'adapte à la taille de la conversation. Reprendre à partir du résumé coûte moins cher à chaque requête ultérieure car il porte le résumé au lieu de l'historique complet, mais tout ce que le résumé omet n'est plus dans le contexte de Claude. Voir [pourquoi l'utilisation augmente dans une longue session](/docs/fr/costs#why-usage-climbs-in-a-long-session) pour savoir d'où provient ce coût par requête.

125 127 

126<h3 id="where-the-session-picker-looks">128<h3 id="where-the-session-picker-looks">

127 Où le sélecteur de sessions cherche129 Où le sélecteur de sessions cherche


132* Les sessions du worktree courant, y compris les [sessions en arrière-plan](/docs/fr/agent-view), qui sont marquées `bg` dans la liste134* Les sessions du worktree courant, y compris les [sessions en arrière-plan](/docs/fr/agent-view), qui sont marquées `bg` dans la liste

133* Les sessions démarrées ailleurs qui ont ajouté le répertoire courant avec `/add-dir`135* Les sessions démarrées ailleurs qui ont ajouté le répertoire courant avec `/add-dir`

134 136 

135Utilisez `Ctrl+W` pour élargir à tous les worktrees du référentiel ou `Ctrl+A` pour élargir à chaque projet sur cette machine.137Utilisez `Ctrl+W` pour élargir à tous les worktrees du dépôt ou `Ctrl+A` pour élargir à chaque projet sur cette machine.

136 138 

137Les sessions dont la première invite était une commande [`/loop`](/docs/fr/scheduled-tasks#run-a-prompt-repeatedly-with-%2Floop) n'apparaissent pas dans le sélecteur, et `claude --continue` les ignore également. L'exécution de `/loop` plus tard dans une conversation ne masque pas la session. Avant la v2.1.211, une exécution `/loop` au début d'une conversation masquait la session du sélecteur de manière permanente.139Les sessions dont le premier prompt était une commande [`/loop`](/docs/fr/scheduled-tasks#run-a-prompt-repeatedly-with-%2Floop) n'apparaissent pas dans le sélecteur, et `claude --continue` les ignore également. L'exécution de `/loop` plus tard dans une conversation ne masque pas la session. Avant la v2.1.211, une exécution `/loop` au début d'une conversation masquait la session du sélecteur de manière permanente.

138 140 

139Le déplacement d'une session avec [`/cd`](/docs/fr/commands) la réinstalle dans le stockage de projet du nouveau répertoire, ce qui la fait apparaître dans le sélecteur de ce répertoire par la suite. À partir de la v2.1.196, une session déplacée reste absente du sélecteur de l'ancien répertoire même après un plantage ou une fermeture forcée. Sur les versions antérieures, elle pouvait aussi réapparaître dans la liste de l'ancien répertoire après une fermeture qui n'était pas propre lorsque l'ancien chemin contenait des caractères spéciaux tels que des traits de soulignement.141Le déplacement d'une session avec [`/cd`](/docs/fr/commands) la réinstalle dans le stockage de projet du nouveau répertoire, ce qui la fait apparaître dans le sélecteur de ce répertoire par la suite. À partir de la v2.1.196, une session déplacée reste absente du sélecteur de l'ancien répertoire même après un plantage ou une fermeture forcée. Sur les versions antérieures, elle pouvait aussi réapparaître dans la liste de l'ancien répertoire après une fermeture qui n'était pas propre lorsque l'ancien chemin contenait des caractères spéciaux tels que des traits de soulignement.

140 142 

141Lorsque vous sélectionnez une session d'un autre worktree du même référentiel, Claude Code la reprend sur place ; lorsque le propre worktree de la session n'existe plus, Claude Code [la reprend dans votre répertoire courant](/docs/fr/worktrees#resume-a-worktree-session). Lorsque vous sélectionnez une session d'un projet non lié, Claude Code copie une commande `cd` et de reprise dans votre presse-papiers à la place. Si le répertoire de ce projet n'existe plus, Claude Code reprend la session dans votre répertoire courant plutôt que de copier une commande `cd` qui échouerait.143Lorsque vous sélectionnez une session d'un autre worktree du même dépôt, Claude Code la reprend sur place ; lorsque le propre worktree de la session n'existe plus, Claude Code [la reprend dans votre répertoire courant](/docs/fr/worktrees#resume-a-worktree-session). Lorsque vous sélectionnez une session d'un projet non lié, Claude Code copie une commande `cd` et de reprise dans votre presse-papiers à la place. Si le répertoire de ce projet n'existe plus, Claude Code reprend la session dans votre répertoire courant plutôt que de copier une commande `cd` qui échouerait.

142 144 

143La reprise par nom se résout dans le référentiel courant et ses worktrees. Les deux formes recherchent une correspondance exacte et la reprennent directement même si elle se trouve dans un worktree différent :145La reprise par nom se résout dans le dépôt courant et ses worktrees. Les deux formes recherchent une correspondance exacte et la reprennent directement même si elle se trouve dans un worktree différent :

144 146 

145| Commande | Correspondance exacte | Nom ambigu |147| Commande | Correspondance exacte | Nom ambigu |

146| :- | :- | :- |148| :- | :- | :- |

settings.md +37 −35

Details

405| Portée | Fichier | Qui est affecté | Utilisez-le pour |405| Portée | Fichier | Qui est affecté | Utilisez-le pour |

406| :- | :- | :- | :- |406| :- | :- | :- | :- |

407| Utilisateur | `~/.claude/settings.json` | Vous, dans chaque projet sur cette machine | Préférences personnelles : thème, mode éditeur, modèle par défaut, vos propres règles de permission |407| Utilisateur | `~/.claude/settings.json` | Vous, dans chaque projet sur cette machine | Préférences personnelles : thème, mode éditeur, modèle par défaut, vos propres règles de permission |

408| Projet partagé | `.claude/settings.json` | Tout le monde travaillant dans le dossier qui le contient. Dans un référentiel git, validez-le pour que vos coéquipiers l'obtiennent | Permissions d'équipe, hooks, plugins, et les variables d'environnement dont le projet a besoin |408| Projet partagé | `.claude/settings.json` | Tout le monde travaillant dans le dossier qui le contient. Dans un dépôt git, faites-en un commit pour que vos coéquipiers l'obtiennent | Permissions d'équipe, hooks, plugins, et les variables d'environnement dont le projet a besoin |

409| Projet local | `.claude/settings.local.json` | Vous, dans ce seul projet. Claude Code le garde hors de git quand il crée le fichier ; si vous le créez à la main, ajoutez-le à `.gitignore` vous-même | Remplacements personnels pour un projet, et test avant de partager |409| Projet local | `.claude/settings.local.json` | Vous, dans ce seul projet. Claude Code le garde hors de git quand il crée le fichier ; si vous le créez à la main, ajoutez-le à `.gitignore` vous-même | Remplacements personnels pour un projet, et test avant de partager |

410| Géré | `managed-settings.json` et autres [sources gérées](/docs/fr/managed-settings#delivery-mechanisms) | Tout le monde dans votre organisation auquel elle est déployée ; rien de ce que vous définissez ne la remplace, à part quelques [exceptions sensibles à la sécurité](#exceptions-to-managed-settings-precedence) | Politique de sécurité et exigences de conformité |410| Géré | `managed-settings.json` et autres [sources gérées](/docs/fr/managed-settings#delivery-mechanisms) | Tout le monde auquel votre organisation le déploie ; [Priorité des paramètres](#settings-precedence) indique ce qui peut le remplacer | Politique de sécurité et exigences de conformité |

411 411 

412Dans la colonne Fichier, `~/.claude` est le dossier `.claude` dans votre répertoire personnel, et un `.claude` nu est le dossier `.claude` à l'intérieur de votre projet.412Dans la colonne Fichier, `~/.claude` est le dossier `.claude` dans votre répertoire personnel, et un `.claude` nu est le dossier `.claude` à l'intérieur de votre projet.

413 413 


426<SettingsScope />426<SettingsScope />

427 427 

428* **`~/.claude/settings.json`** : chaque projet sur votre machine, et rien sur celle de votre coéquipier ou dans la session cloud428* **`~/.claude/settings.json`** : chaque projet sur votre machine, et rien sur celle de votre coéquipier ou dans la session cloud

429* **`acme-app/.claude/settings.json`** : votre `acme-app/`. Il atteint le clone de votre coéquipier et la session cloud uniquement si vous validez le fichier dans le contrôle de version ; jusqu'à ce que vous le fassiez, c'est un fichier sur votre disque comme n'importe quel autre et personne d'autre ne l'a429* **`acme-app/.claude/settings.json`** : votre `acme-app/`. Il atteint le clone de votre coéquipier et la session cloud uniquement si vous faites un commit du fichier dans le contrôle de version ; jusqu'à ce que vous le fassiez, c'est un fichier sur votre disque comme n'importe quel autre et personne d'autre ne l'a

430* **`acme-app/.claude/settings.local.json`** : votre `acme-app/` uniquement. Claude Code l'ajoute à vos exclusions git globales la première fois qu'il écrit le fichier, donc il reste hors de vos commits ; si vous créez le fichier à la main, [ajoutez-le à `.gitignore` vous-même](#keep-personal-settings-out-of-a-repository)430* **`acme-app/.claude/settings.local.json`** : votre `acme-app/` uniquement. Claude Code l'ajoute à vos exclusions git globales la première fois qu'il écrit le fichier, donc il reste hors de vos commits ; si vous créez le fichier à la main, [ajoutez-le à `.gitignore` vous-même](#keep-personal-settings-out-of-a-repository)

431* **Paramètres gérés**, qu'il s'agisse d'un fichier `managed-settings.json`, d'une politique MDM, ou de [paramètres gérés par le serveur](/docs/fr/server-managed-settings) à partir de la console claude.ai : chaque projet sur chaque machine auquel votre organisation la déploie, ou auquel vous vous connectez avec votre compte d'organisation. Seuls les paramètres gérés par le serveur atteignent la session cloud431* **Paramètres gérés**, qu'il s'agisse d'un fichier `managed-settings.json`, d'une politique MDM, ou de [paramètres gérés par le serveur](/docs/fr/server-managed-settings) à partir de la console claude.ai : chaque projet sur chaque machine auquel votre organisation la déploie, ou auquel vous vous connectez avec votre compte d'organisation. Seuls les paramètres gérés par le serveur atteignent la session cloud

432 432 


439L'installation de Claude Code ne crée aucun fichier de paramètres. Si votre machine ou projet en a déjà un, il provient de l'une de ces sources :439L'installation de Claude Code ne crée aucun fichier de paramètres. Si votre machine ou projet en a déjà un, il provient de l'une de ces sources :

440 440 

441* **Géré** : votre organisation la déploie. Vous ne la créez ni ne l'éditez.441* **Géré** : votre organisation la déploie. Vous ne la créez ni ne l'éditez.

442* **Projet partagé** : un projet qui utilise déjà Claude Code peut en avoir un validé. Sinon, créez-le à `.claude/settings.json` dans le dossier du projet.442* **Projet partagé** : un projet qui utilise déjà Claude Code peut en avoir un commité. Sinon, créez-le à `.claude/settings.json` dans le dossier du projet.

443* **Utilisateur** et **Projet local** : créez-les vous-même, ou laissez Claude Code les créer. Il écrit `~/.claude/settings.json` la première fois que vous modifiez une option dans le menu `/config` qu'il stocke dans les paramètres utilisateur, comme le thème, et `.claude/settings.local.json` la première fois que vous donnez une approbation permanente sur une invite de permission, comme « Oui, et ne me demande plus » pour une commande Bash. Quelques options `/config`, y compris **Afficher les conseils**, s'enregistrent dans `.claude/settings.local.json` à la place du fichier utilisateur.443* **Utilisateur** et **Projet local** : créez-les vous-même, ou laissez Claude Code les créer. Il écrit `~/.claude/settings.json` la première fois que vous modifiez une option dans le menu `/config` qu'il stocke dans les paramètres utilisateur, comme le thème, et `.claude/settings.local.json` la première fois que vous donnez une approbation permanente sur une demande de permission, comme « Oui, et ne me demande plus » pour une commande Bash. Quelques options `/config`, y compris **Afficher les conseils**, s'enregistrent dans `.claude/settings.local.json` à la place du fichier utilisateur.

444 444 

445<Info>445<Info>

446 Sur Windows, `~/.claude` signifie `%USERPROFILE%\.claude`. Pour garder les fichiers du répertoire personnel ailleurs, définissez [`CLAUDE_CONFIG_DIR`](/docs/fr/env-vars) ; Claude Code stocke alors vos paramètres, l'historique de session, et les plugins à la place.446 Sur Windows, `~/.claude` signifie `%USERPROFILE%\.claude`. Pour garder les fichiers du répertoire personnel ailleurs, définissez [`CLAUDE_CONFIG_DIR`](/docs/fr/env-vars) ; Claude Code stocke alors vos paramètres, l'historique de session, et les plugins à la place.


452 Partagez les paramètres avec votre équipe452 Partagez les paramètres avec votre équipe

453</h3>453</h3>

454 454 

455Validez `.claude/settings.json` pour que tout le monde qui clone le référentiel obtienne les mêmes permissions, hooks, et plugins. Chaque coéquipier peut toujours le remplacer pour lui-même dans son propre `.claude/settings.local.json`, donc les exceptions personnelles n'ont pas besoin d'une validation. Pour un fichier d'équipe complet, voir [les paramètres partagés d'une équipe](/docs/fr/settings-example#a-teams-shared-settings).455Commitez `.claude/settings.json` pour que tout le monde qui clone le dépôt obtienne les mêmes permissions, hooks, et plugins. Chaque coéquipier peut toujours le remplacer pour lui-même dans son propre `.claude/settings.local.json`, donc les exceptions personnelles n'ont pas besoin d'un commit. Pour un fichier d'équipe complet, voir [les paramètres partagés d'une équipe](/docs/fr/settings-example#a-teams-shared-settings).

456 456 

457Certains de ce que vous validez attendent que chaque coéquipier [fasse confiance au dossier](/docs/fr/permissions#project-allow-rules-and-workspace-trust), et quelques clés ne prennent jamais effet à partir d'un fichier de référentiel ; [Dépannez un paramètre qui ne s'applique pas](#common-cases) couvre les deux.457Une partie de ce que vous commitez attend que chaque coéquipier [fasse confiance au dossier](/docs/fr/permissions#project-allow-rules-and-workspace-trust), et quelques clés ne prennent jamais effet à partir d'un fichier de dépôt ; [Dépannez un paramètre qui ne s'applique pas](#common-cases) couvre les deux.

458 458 

459<span id="local-settings-file" />459<span id="local-settings-file" />

460 460 


465<span id="keep-personal-settings-out-of-the-repository" />465<span id="keep-personal-settings-out-of-the-repository" />

466 466 

467<h3 id="keep-personal-settings-out-of-a-repository">467<h3 id="keep-personal-settings-out-of-a-repository">

468 Gardez les paramètres personnels hors d'un référentiel468 Gardez les paramètres personnels hors d'un dépôt

469</h3>469</h3>

470 470 

471Pour modifier un paramètre pour vous-même dans un projet sans le modifier pour vos coéquipiers, enregistrez-le dans `.claude/settings.local.json` à l'intérieur du projet. Claude Code applique ce fichier sur le `.claude/settings.json` validé, donc si le fichier de votre équipe définit `"model": "claude-sonnet-5"` et que vous voulez Opus, mettez `"model": "claude-opus-5-5"` dans votre fichier local et seules vos sessions changent.471Pour modifier un paramètre pour vous-même dans un projet sans le modifier pour vos coéquipiers, enregistrez-le dans `.claude/settings.local.json` à l'intérieur du projet. Claude Code applique ce fichier sur le `.claude/settings.json` commité, donc si le fichier de votre équipe définit `"model": "claude-sonnet-5"` et que vous voulez Opus, mettez `"model": "claude-opus-5-5"` dans votre fichier local et seules vos sessions changent.

472 472 

473Claude Code écrit également dans ce fichier, le garde hors de vos commits, et applique ses règles allow sans l'étape de confiance :473Claude Code écrit également dans ce fichier, le garde hors de vos commits, et applique ses règles allow sans l'étape de confiance :

474 474 

475* **Claude Code l'écrit aussi.** Quand Claude demande la permission d'exécuter une commande Bash et que vous choisissez « Oui, et ne me demande plus », Claude Code enregistre cette [approbation de permission](/docs/fr/permissions#permission-system) ici comme une règle `allow`.475* **Claude Code l'écrit aussi.** Quand Claude demande la permission d'exécuter une commande Bash et que vous choisissez « Oui, et ne me demande plus », Claude Code enregistre cette [approbation de permission](/docs/fr/permissions#permission-system) ici comme une règle `allow`.

476* **Vous n'avez pas besoin de le gitignorer vous-même, sauf si vous l'avez créé à la main.** La première fois que Claude Code écrit le fichier dans un référentiel git qui ne l'ignore pas déjà, il ajoute `**/.claude/settings.local.json` à votre fichier d'exclusions git global, donc le fichier reste hors de vos commits dans chaque référentiel. Ce fichier est `core.excludesFile` quand votre configuration git globale le définit à un chemin absolu ou préfixé par `~` ; sinon c'est `$XDG_CONFIG_HOME/git/ignore`, ou `~/.config/git/ignore` quand `XDG_CONFIG_HOME` n'est pas défini. Si vous avez créé le fichier à la main et que Claude Code ne l'a pas encore écrit, ajoutez-le à `.gitignore` vous-même.476* **Vous n'avez pas besoin de le gitignorer vous-même, sauf si vous l'avez créé à la main.** La première fois que Claude Code écrit le fichier dans un dépôt git qui ne l'ignore pas déjà, il ajoute `**/.claude/settings.local.json` à votre fichier d'exclusions git global, donc le fichier reste hors de vos commits dans chaque dépôt. Ce fichier est `core.excludesFile` quand votre configuration git globale le définit à un chemin absolu ou préfixé par `~` ; sinon c'est `$XDG_CONFIG_HOME/git/ignore`, ou `~/.config/git/ignore` quand `XDG_CONFIG_HOME` n'est pas défini. Si vous avez créé le fichier à la main et que Claude Code ne l'a pas encore écrit, ajoutez-le à `.gitignore` vous-même.

477* **Ses règles allow n'attendent pas la confiance tant que le fichier reste non suivi.** Parce que le fichier est le vôtre et non celui du référentiel, Claude Code applique ses règles `allow` sans l'étape de [confiance de l'espace de travail](/docs/fr/permissions#project-allow-rules-and-workspace-trust) qu'il exige pour le fichier validé. Si le fichier est suivi par git, l'étape de confiance s'applique aussi ; voir [Quand votre fichier de paramètres locaux a besoin de confiance](/docs/fr/permissions#when-your-local-settings-file-needs-trust).477* **Ses règles allow n'attendent pas la confiance tant que le fichier reste non suivi.** Parce que le fichier est le vôtre et non celui du dépôt, Claude Code applique ses règles `allow` sans l'étape de [confiance de l'espace de travail](/docs/fr/permissions#project-allow-rules-and-workspace-trust) qu'il exige pour le fichier commité. Si le fichier est suivi par git, l'étape de confiance s'applique aussi ; voir [Quand votre fichier de paramètres locaux a besoin de confiance](/docs/fr/permissions#when-your-local-settings-file-needs-trust).

478 478 

479<span id="where-claude-code-looks-for-each-file" />479<span id="where-claude-code-looks-for-each-file" />

480 480 


483<span id="local-allow-rules-dont-wait-for-workspace-trust" />483<span id="local-allow-rules-dont-wait-for-workspace-trust" />

484 484 

485<h4 id="where-claude-code-keeps-the-local-file-in-a-git-repository">485<h4 id="where-claude-code-keeps-the-local-file-in-a-git-repository">

486 Où Claude Code garde le fichier local dans un référentiel git486 Où Claude Code garde le fichier local dans un dépôt git

487</h4>487</h4>

488 488 

489Quand Claude demande la permission d'exécuter une commande Bash et que vous choisissez « Oui, et ne me demande plus », Claude Code enregistre cette approbation comme une règle `allow` dans `.claude/settings.local.json`. Si vous démarrez Claude Code dans un sous-répertoire d'un référentiel git, il lit et écrit ce fichier à la racine du référentiel et applique l'approbation dans tout le référentiel. Dans un [worktree](/docs/fr/worktrees), il utilise le fichier à la racine du checkout principal.489Quand Claude demande la permission d'exécuter une commande Bash et que vous choisissez « Oui, et ne me demande plus », Claude Code enregistre cette approbation comme une règle `allow` dans `.claude/settings.local.json`. Si vous démarrez Claude Code dans un sous-répertoire d'un dépôt git, il lit et écrit ce fichier à la racine du dépôt et applique l'approbation dans tout le dépôt. Dans un [worktree](/docs/fr/worktrees), il utilise le fichier à la racine du checkout principal.

490 490 

491Deux règles qualifient l'emplacement racine :491Deux règles qualifient l'emplacement racine :

492 492 

493* **Quand le fichier reste avec `.claude/settings.json` à la place** : en dehors d'un référentiel git, quand la racine du référentiel est votre répertoire personnel, sur Windows, ou quand la racine du référentiel ou son entrée `.git` ou `.claude` n'est pas possédée par votre utilisateur.493* **Quand le fichier reste avec `.claude/settings.json` à la place** : en dehors d'un dépôt git, quand la racine du dépôt est votre répertoire personnel, sur Windows, ou quand la racine du dépôt ou son entrée `.git` ou `.claude` n'est pas possédée par votre utilisateur.

494* **Les chemins dans le fichier ne s'ancrent pas à la racine du référentiel** : une règle de permission qui commence par `/` ou un chemin sandbox relatif [s'ancre au répertoire de travail principal de la session](/docs/fr/permissions#read-and-edit) à la place.494* **Les chemins dans le fichier ne s'ancrent pas à la racine du dépôt** : une règle de permission qui commence par `/` ou un chemin sandbox relatif [s'ancre au répertoire de travail principal de la session](/docs/fr/permissions#read-and-edit) à la place.

495 495 

496Avant v2.1.211, Claude Code gardait le fichier dans le répertoire de démarrage. Il lit toujours un fichier qu'une version antérieure a laissé là à côté du fichier racine ; où les deux définissent la même clé, la valeur de la racine s'applique, et les règles de permission des deux fichiers s'appliquent. L'assistant [`resolveSettings()`](/docs/fr/agent-sdk/typescript#resolvesettings) du SDK Agent lit toujours le fichier à partir du répertoire de démarrage.496Avant v2.1.211, Claude Code gardait le fichier dans le répertoire de démarrage. Il lit toujours un fichier qu'une version antérieure a laissé là à côté du fichier racine ; où les deux définissent la même clé, la valeur de la racine s'applique, et les règles de permission des deux fichiers s'appliquent. L'assistant [`resolveSettings()`](/docs/fr/agent-sdk/typescript#resolvesettings) du SDK Agent lit toujours le fichier à partir du répertoire de démarrage.

497 497 

498Claude Code lit le `.claude/settings.json` partagé à partir du [répertoire de travail principal](/docs/fr/permissions#working-directories) de la session, donc pour utiliser un fichier validé à la racine du référentiel, démarrez Claude Code là. Après avoir [déplacé la session avec `/cd`](/docs/fr/permissions#move-the-session-to-another-directory), Claude Code lit les deux fichiers de projet à partir du nouveau répertoire à la place, plaçant le fichier local par les mêmes règles. Les lire à partir du répertoire vers lequel vous avez déplacé nécessite Claude Code v2.1.246 ou ultérieur.498Claude Code lit le `.claude/settings.json` partagé à partir du [répertoire de travail principal](/docs/fr/permissions#working-directories) de la session, donc pour utiliser un fichier commité à la racine du dépôt, démarrez Claude Code là. Après avoir [déplacé la session avec `/cd`](/docs/fr/permissions#move-the-session-to-another-directory), Claude Code lit les deux fichiers de projet à partir du nouveau répertoire à la place, plaçant le fichier local par les mêmes règles. Les lire à partir du répertoire vers lequel vous avez déplacé nécessite Claude Code v2.1.246 ou ultérieur.

499 499 

500<span id="managed-settings-delivery" />500<span id="managed-settings-delivery" />

501 501 


650<span id="which-value-wins" />650<span id="which-value-wins" />

651 651 

652<h2 id="settings-precedence">652<h2 id="settings-precedence">

653 Précédence des paramètres653 Priorité des paramètres

654</h2>654</h2>

655 655 

656Quand la même clé apparaît à plus d'un endroit, Claude Code utilise la valeur du niveau le plus élevé qui la définit. La pile ci-dessous montre les niveaux, le plus élevé en haut ; une clé à un niveau plus élevé remplace la même clé n'importe où en dessous.656Quand la même clé apparaît à plus d'un endroit, Claude Code utilise la valeur du niveau le plus élevé qui la définit. La pile ci-dessous montre les niveaux, le plus élevé en haut ; une clé à un niveau plus élevé remplace la même clé n'importe où en dessous.


659 659 

660En ordre, priorité la plus élevée en premier :660En ordre, priorité la plus élevée en premier :

661 661 

6621. **Paramètres gérés** : paramètres que votre organisation déploie, par un fichier `managed-settings.json`, une politique MDM, ou [paramètres gérés par le serveur](/docs/fr/server-managed-settings) à partir de la console claude.ai. Rien de ce que vous définissez ne les remplace : une clé que vous passez avec `--settings` ne remplace pas la même clé gérée, et un indicateur comme `--model` choisit uniquement parmi les modèles que votre organisation autorise. Un `model` géré définit le modèle avec lequel chaque session démarre, et vous pouvez toujours basculer avec `/model` ; le verrou est [`availableModels`](/docs/fr/settings-reference#availablemodels), qui contraint `/model`, `--model`, et la clé `model` dans vos propres fichiers. Quand votre organisation fournit plus d'une source gérée, les règles pour [la précédence au sein du niveau géré](/docs/fr/managed-settings#precedence-within-the-managed-tier) disent ce que Claude Code lit à partir de chacune.6621. **Paramètres gérés** : paramètres que votre organisation déploie, par un fichier `managed-settings.json`, une politique MDM, ou [paramètres gérés par le serveur](/docs/fr/server-managed-settings) à partir de la console claude.ai. Rien dans vos propres fichiers de paramètres ni dans `--settings` ne remplace une clé gérée, et un flag comme `--model` choisit uniquement parmi les modèles que votre organisation autorise. Un [`model`](/docs/fr/settings-reference#model) géré est une valeur par défaut de départ, pas un verrou ; les verrous sont [`availableModels`](/docs/fr/settings-reference#availablemodels) et [`deniedModels`](/docs/fr/settings-reference#deniedmodels). Quand votre organisation fournit plus d'une source gérée, les règles de [priorité au sein du niveau géré](/docs/fr/managed-settings#precedence-within-the-managed-tier) indiquent ce que Claude Code lit à partir de chacune.

6632. **Arguments de ligne de commande** : indicateurs que vous passez quand vous démarrez `claude` à partir d'un terminal, pour une session ; voir [Modifiez un paramètre pour une session](#change-a-setting-for-one-session). Claude Code fusionne le JSON que vous passez avec `--settings <file-or-json>` avec vos fichiers de paramètres par les mêmes règles que les autres niveaux : il prend une clé que vous définissez ici sur la même clé dans les paramètres locaux, projet ou utilisateur, et garde la valeur de niveau inférieur pour une clé que vous omettez.6632. **Ligne de commande** : le JSON que vous passez avec `--settings <file-or-json>` quand vous démarrez `claude`, pour cette session uniquement ; voir [Modifiez un paramètre pour une session](#change-a-setting-for-one-session). Une clé que vous y définissez remplace la même clé dans vos fichiers de paramètres de projet et utilisateur, et une clé que vous omettez garde la valeur issue de ces fichiers. D'autres flags, comme `--model`, définissent une seule chose pour la session et ne font pas partie de cette pile ; l'entrée d'une clé dans la [référence des paramètres](/docs/fr/settings-reference) indique quels flags la remplacent.

6643. **Paramètres de projet local** (`.claude/settings.local.json`) : vos paramètres personnels pour ce projet.6643. **Paramètres de projet local** (`.claude/settings.local.json`) : vos paramètres personnels pour ce projet.

6654. **Paramètres de projet partagés** (`.claude/settings.json`) : paramètres que votre équipe valide dans le contrôle de source.6654. **Paramètres de projet partagés** (`.claude/settings.json`) : paramètres que votre équipe valide dans le contrôle de source.

6665. **Paramètres utilisateur** (`~/.claude/settings.json`) : vos paramètres personnels pour chaque projet.6665. **Paramètres utilisateur** (`~/.claude/settings.json`) : vos paramètres personnels pour chaque projet.

667 667 

668Les variables d'environnement ne sont pas un niveau dans cette pile. Quand un comportement a à la fois une variable shell et une clé de paramètres, lequel s'applique est décidé par paire, pas par niveau : `ANTHROPIC_MODEL` exportée dans votre shell s'applique sur la clé `model` à partir de n'importe quel fichier, tandis que `ANTHROPIC_DEFAULT_MODEL` s'applique uniquement quand aucun fichier ne définit `model`. La [référence des variables d'environnement](/docs/fr/env-vars#precedence) dit quelles clés ont une paire et lequel Claude Code lit en premier. Un bloc `env` à l'intérieur d'un fichier de paramètres est une clé ordinaire et suit les niveaux ci-dessus.668Les variables d'environnement ne sont pas un niveau dans cette pile. Quand un comportement a à la fois une variable shell et une clé de paramètres, lequel s'applique est décidé par paire, pas par niveau : `ANTHROPIC_MODEL` exportée dans votre shell s'applique sur la clé `model` à partir de n'importe quel fichier, tandis que `ANTHROPIC_DEFAULT_MODEL` s'applique uniquement quand aucun fichier ne définit `model`. La [référence des variables d'environnement](/docs/fr/env-vars#precedence) dit quelles clés ont une paire et lequel Claude Code lit en premier. Un bloc `env` à l'intérieur d'un fichier de paramètres est une clé ordinaire et suit les niveaux ci-dessus.

669 669 

670Pour quelques clés sensibles à la sécurité, Claude Code honore une valeur plus stricte d'un niveau inférieur sur une valeur gérée ; [Exceptions à la précédence des paramètres gérés](#exceptions-to-managed-settings-precedence) les énumère.670Pour quelques clés sensibles à la sécurité, Claude Code honore une valeur plus stricte d'un niveau inférieur sur une valeur gérée ; [Exceptions à la priorité des paramètres gérés](#exceptions-to-managed-settings-precedence) les énumère.

671 671 

672<h3 id="lists-merge-instead-of-overriding">672<h3 id="lists-merge-instead-of-overriding">

673 Les listes fusionnent au lieu de remplacer673 Les listes fusionnent au lieu de remplacer


676Quand vous définissez la même clé de liste, comme `permissions.allow`, dans plus d'un fichier, Claude Code combine les listes au lieu de choisir une, donc chaque fichier peut ajouter des entrées sans supprimer celles d'un autre fichier. Quatre clés qui contiennent des listes de modèles ou des entrées par modèle suivent leurs propres règles :676Quand vous définissez la même clé de liste, comme `permissions.allow`, dans plus d'un fichier, Claude Code combine les listes au lieu de choisir une, donc chaque fichier peut ajouter des entrées sans supprimer celles d'un autre fichier. Quatre clés qui contiennent des listes de modèles ou des entrées par modèle suivent leurs propres règles :

677 677 

678* [`fallbackModel`](/docs/fr/settings-reference#fallbackmodel) est une chaîne ordonnée où la position porte du sens, donc Claude Code prend la valeur entière du fichier de priorité la plus élevée qui la définit.678* [`fallbackModel`](/docs/fr/settings-reference#fallbackmodel) est une chaîne ordonnée où la position porte du sens, donc Claude Code prend la valeur entière du fichier de priorité la plus élevée qui la définit.

679* [`modelPicker`](/docs/fr/settings-reference#modelpicker) contient une liste ordonnée de lignes plus un indicateur de remplacement, donc Claude Code ne fusionne jamais les lignes de deux sources. Il prend la valeur entière du plus élevé des paramètres gérés, `--settings`, et des paramètres utilisateur qui la définit, et ignore la clé dans les paramètres de projet et locaux. Nécessite Claude Code v2.1.242 ou ultérieur.679* [`modelPicker`](/docs/fr/settings-reference#modelpicker) contient une liste ordonnée de lignes plus un flag de remplacement, donc Claude Code ne fusionne jamais les lignes de deux sources. Il prend la valeur entière du plus élevé des paramètres gérés, `--settings`, et des paramètres utilisateur qui la définit, et ignore la clé dans les paramètres de projet et locaux. Nécessite Claude Code v2.1.242 ou ultérieur.

680* [`availableModels`](/docs/fr/settings-reference#availablemodels) : quand les paramètres gérés que Claude Code applique la définissent, Claude Code applique cette liste telle quelle et ignore les entrées que vous ajoutez dans les paramètres utilisateur, projet ou locaux, sauf si une application qui intègre Claude Code fournit sa propre liste de modèles ; voir [Exceptions à la précédence des paramètres gérés](#exceptions-to-managed-settings-precedence). Entre les sources gérées, la liste ne fusionne jamais non plus ; [comment Claude Code combine les sources gérées](/docs/fr/managed-settings#how-claude-code-combines-managed-sources) dit quelle liste de source s'applique. Entre les portées non gérées, Claude Code fusionne les tableaux comme d'habitude.680* [`availableModels`](/docs/fr/settings-reference#availablemodels) : quand les paramètres gérés que Claude Code applique la définissent, Claude Code applique cette liste telle quelle et ignore les entrées que vous ajoutez dans les paramètres utilisateur, projet ou locaux, sauf si une application qui intègre Claude Code fournit sa propre liste de modèles ; voir [Exceptions à la priorité des paramètres gérés](#exceptions-to-managed-settings-precedence). Entre les sources gérées, la liste ne fusionne jamais non plus ; [comment Claude Code combine les sources gérées](/docs/fr/managed-settings#how-claude-code-combines-managed-sources) dit quelle liste de source s'applique. Entre les portées non gérées, Claude Code fusionne les tableaux comme d'habitude.

681* [`modelSettings`](/docs/fr/settings-reference#modelsettings) : Claude Code la résout un modèle à la fois, avec [`effortLevel`](/docs/fr/settings-reference#effortlevel). L'entrée `modelSettings` indique quel fichier s'applique à un modèle.681* [`modelSettings`](/docs/fr/settings-reference#modelsettings) : Claude Code la résout un modèle à la fois, avec [`effortLevel`](/docs/fr/settings-reference#effortlevel). L'entrée `modelSettings` indique de quel fichier provient la valeur qui s'applique à un modèle.

682 682 

683<span id="examples" />683<span id="examples" />

684 684 

685<h3 id="precedence-examples">685<h3 id="precedence-examples">

686 Exemples de précédence686 Exemples de priorité

687</h3>687</h3>

688 688 

689Pendant que Claude travaille, Claude Code affiche un conseil d'une ligne sous le spinner, comme « Utilisez /config pour modifier votre mode de permission par défaut (y compris Plan Mode) ». Supposons que vous vouliez ces conseils désactivés, donc vous définissez [`spinnerTipsEnabled`](/docs/fr/settings-reference#spinnertipsenabled) à `false` dans `~/.claude/settings.json`. Chaque scénario ci-dessous est quelque chose qui peut les réactiver, et ce que vous pouvez faire à ce sujet.689Pendant que Claude travaille, Claude Code affiche un conseil d'une ligne sous le spinner, comme « Utilisez /config pour modifier votre mode de permission par défaut (y compris le mode plan) ». Supposons que vous vouliez ces conseils désactivés, donc vous définissez [`spinnerTipsEnabled`](/docs/fr/settings-reference#spinnertipsenabled) à `false` dans `~/.claude/settings.json`. Chaque scénario ci-dessous est quelque chose qui peut les réactiver, et ce que vous pouvez faire à ce sujet.

690 690 

691<h4 id="team-settings-override-personal-settings">691<h4 id="team-settings-override-personal-settings">

692 Les paramètres d'équipe remplacent les paramètres personnels692 Les paramètres d'équipe remplacent les paramètres personnels


713Vous récupérez votre valeur à la session suivante ; `--settings` dure une session et n'écrit dans aucun fichier.713Vous récupérez votre valeur à la session suivante ; `--settings` dure une session et n'écrit dans aucun fichier.

714 714 

715<h4 id="a-flag-or-environment-variable-sets-the-same-thing">715<h4 id="a-flag-or-environment-variable-sets-the-same-thing">

716 Un indicateur ou une variable d'environnement définit la même chose716 Un flag ou une variable d'environnement définit la même chose

717</h4>717</h4>

718 718 

719Certaines clés ont un indicateur de ligne de commande ou une variable d'environnement qui remplace la valeur des paramètres indépendamment du fichier qui l'a défini : `ANTHROPIC_MODEL` remplace le paramètre [`model`](/docs/fr/settings-reference#model), et `--model` remplace les deux pour une session.719Certaines clés ont un flag de ligne de commande ou une variable d'environnement qui remplace la valeur des paramètres indépendamment du fichier qui l'a défini : `ANTHROPIC_MODEL` remplace le paramètre [`model`](/docs/fr/settings-reference#model), et `--model` remplace les deux pour une session.

720 720 

721Que vous puissiez récupérer votre valeur dépend de la clé : supprimez la variable ou retirez l'indicateur, et vérifiez l'entrée de la clé sur la [référence des paramètres](/docs/fr/settings-reference) et la ligne de la variable sur la [référence des variables d'environnement](/docs/fr/env-vars) pour lequel Claude Code utilise.721Que vous puissiez récupérer votre valeur dépend de la clé : supprimez la variable ou retirez le flag, et vérifiez l'entrée de la clé sur la [référence des paramètres](/docs/fr/settings-reference) et la ligne de la variable sur la [référence des variables d'environnement](/docs/fr/env-vars) pour lequel Claude Code utilise.

722 722 

723<span id="keys-ignored-in-a-repository-file" />723<span id="keys-ignored-in-a-repository-file" />

724 724 


740 740 

741Quelque chose d'autre définit la même clé, le fichier ne peut pas définir cette valeur, ou le fichier n'a pas été chargé :741Quelque chose d'autre définit la même clé, le fichier ne peut pas définir cette valeur, ou le fichier n'a pas été chargé :

742 742 

743* **Un niveau plus élevé la définit.** Un autre fichier de paramètres, un indicateur `--settings`, ou une source gérée définit la clé au-dessus de la vôtre ; la [pile](#settings-precedence) dit lequel. Un indicateur ou une variable d'environnement peut aussi remplacer la clé de son propre chef, décidé clé par clé ; l'entrée de la clé sur la [référence des paramètres](/docs/fr/settings-reference) dit lequel Claude Code utilise, et l'[entrée `env`](/docs/fr/settings-reference#env) couvre une valeur `env` gérée par rapport à une exportation shell.743* **Un niveau plus élevé la définit.** Un autre fichier de paramètres, un flag `--settings`, ou une source gérée définit la clé au-dessus de la vôtre ; la [pile](#settings-precedence) dit lequel. Un flag ou une variable d'environnement peut aussi remplacer la clé de son propre chef, décidé clé par clé ; l'entrée de la clé sur la [référence des paramètres](/docs/fr/settings-reference) dit lequel Claude Code utilise, et l'[entrée `env`](/docs/fr/settings-reference#env) couvre une valeur `env` gérée par rapport à une exportation shell.

744* **Une clé de sécurité garde sa valeur stricte.** Pour quelques clés, Claude Code honore la valeur restrictive à partir de n'importe quel fichier, donc un `true` de projet pour [`disableClaudeAiConnectors`](/docs/fr/settings-reference#disableclaudeaiconnectors) reste activé ; voir [Exceptions à la précédence des paramètres gérés](#exceptions-to-managed-settings-precedence).744* **Une clé de sécurité garde sa valeur stricte.** Pour quelques clés, Claude Code honore la valeur restrictive à partir de n'importe quel fichier, donc un `true` de projet pour [`disableClaudeAiConnectors`](/docs/fr/settings-reference#disableclaudeaiconnectors) reste activé ; voir [Exceptions à la priorité des paramètres gérés](#exceptions-to-managed-settings-precedence).

745* **Le fichier ne peut pas définir cette valeur.** Les valeurs [`permissions.defaultMode`](/docs/fr/settings-reference#permissions-defaultmode) `auto` et `bypassPermissions` ne prennent pas effet à partir des paramètres de projet ou locaux ; définissez-les dans les paramètres utilisateur ou gérés à la place, ou passez `--permission-mode` pour une session. Avant v2.1.257, `bypassPermissions` prenait effet à partir de n'importe quel fichier.745* **Le fichier ne peut pas définir cette valeur.** Les valeurs [`permissions.defaultMode`](/docs/fr/settings-reference#permissions-defaultmode) `auto` et `bypassPermissions` ne prennent pas effet à partir des paramètres de projet ou locaux ; définissez-les dans les paramètres utilisateur ou gérés à la place, ou passez `--permission-mode` pour une session. Avant v2.1.257, `bypassPermissions` prenait effet à partir de n'importe quel fichier.

746 746 

747 Une variable d'exportation de télémétrie dans un bloc [`env`](/docs/fr/settings-reference#env) ne prend pas effet à partir des paramètres de projet ou locaux non plus, à part quelques valeurs off. [Variables que Claude Code ignore dans `env`](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) énumère les variables et ces valeurs.747 Une variable d'exportation de télémétrie dans un bloc [`env`](/docs/fr/settings-reference#env) ne prend pas effet à partir des paramètres de projet ou locaux non plus, à part quelques valeurs off. [Variables que Claude Code ignore dans `env`](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) énumère les variables et ces valeurs.


767 767 

768Deux choses empêchent une clé dans `.claude/settings.json` de s'appliquer pour tout le monde qui la clone :768Deux choses empêchent une clé dans `.claude/settings.json` de s'appliquer pour tout le monde qui la clone :

769 769 

770* **Claude Code ignore la clé dans un fichier de référentiel.** Cherchez `User, local, or managed`, `User or managed`, `Managed`, ou `Global config` dans la colonne Scope de l'[index des paramètres](/docs/fr/settings-reference#settings-index). Ces clés ne s'appliquent jamais à partir du fichier partagé, à part quelques-unes qu'un fichier de référentiel peut toujours désactiver. Chacune de ces entrées le dit sur sa ligne Scope. Les clés `Global config` s'appliquent uniquement à partir de `~/.claude.json`.770* **Claude Code ignore la clé dans un fichier de dépôt.** Cherchez `User, local, or managed`, `User or managed`, `Managed`, ou `Global config` dans la colonne Scope de l'[index des paramètres](/docs/fr/settings-reference#settings-index). Ces clés ne s'appliquent jamais à partir du fichier partagé, à part quelques-unes qu'un fichier de dépôt peut toujours désactiver. Chacune de ces entrées le dit sur sa ligne Scope. Les clés `Global config` s'appliquent uniquement à partir de `~/.claude.json`.

771 771 

772 À l'intérieur de la clé `env`, les variables d'exportation de télémétrie ne s'appliquent jamais à partir du fichier partagé non plus, à part quelques valeurs off ; voir [Variables que Claude Code ignore dans `env`](/docs/fr/settings-reference#variables-claude-code-ignores-in-env).772 À l'intérieur de la clé `env`, les variables d'exportation de télémétrie ne s'appliquent jamais à partir du fichier partagé non plus, à part quelques valeurs off ; voir [Variables que Claude Code ignore dans `env`](/docs/fr/settings-reference#variables-claude-code-ignores-in-env).

773* **La clé attend la confiance.** Les règles `permissions.allow`, `permissions.additionalDirectories`, `extraKnownMarketplaces`, et la plupart des valeurs [`env`](/docs/fr/settings-reference#env) s'appliquent uniquement après que chaque coéquipier [fasse confiance au dossier](/docs/fr/permissions#project-allow-rules-and-workspace-trust). Jusqu'à ce qu'ils le fassent, ils voient toujours des invites et n'obtiennent pas les plugins d'une marketplace que le fichier déclare. Les règles `deny` et `ask` s'appliquent immédiatement.773* **La clé attend la confiance.** Les règles `permissions.allow`, `permissions.additionalDirectories`, `extraKnownMarketplaces`, et la plupart des valeurs [`env`](/docs/fr/settings-reference#env) s'appliquent uniquement après que chaque coéquipier [fasse confiance au dossier](/docs/fr/permissions#project-allow-rules-and-workspace-trust). Jusqu'à ce qu'ils le fassent, ils voient toujours des demandes de permission et n'obtiennent pas les plugins d'une marketplace que le fichier déclare. Les règles `deny` et `ask` s'appliquent immédiatement.

774 774 

775<h4 id="permission-rules-combine-differently-than-you-expected">775<h4 id="permission-rules-combine-differently-than-you-expected">

776 Les règles de permission se combinent différemment que vous ne l'attendiez776 Les règles de permission se combinent différemment que vous ne l'attendiez

777</h4>777</h4>

778 778 

779* **Vous avez choisi « Oui, et ne me demande plus » sur une invite de permission mais vous êtes toujours invité pour le même outil.** Ce choix a enregistré une règle `allow` dans votre fichier local, et une règle `allow` là ne surclasse pas une règle `ask` à partir d'un fichier de projet ou géré ; [comment les règles de permission se combinent](/docs/fr/permissions#settings-precedence) explique l'ordre. Dans l'extension VS Code, la carte d'approbation vous permet de choisir le fichier de destination, y compris le fichier partagé du projet, ce qui change la règle pour tout le monde ; dans la CLI, Claude Code écrit uniquement dans votre fichier local.779* **Vous avez choisi « Oui, et ne plus me demander » sur une demande de permission mais on vous demande toujours la permission pour le même outil.** Ce choix a enregistré une règle `allow` dans votre fichier local, et une règle `allow` là ne surclasse pas une règle `ask` à partir d'un fichier de projet ou géré ; [comment les règles de permission se combinent](/docs/fr/permissions#settings-precedence) explique l'ordre. Dans l'extension VS Code, la carte d'approbation vous permet de choisir le fichier de destination, y compris le fichier partagé du projet, ce qui change la règle pour tout le monde ; dans la CLI, Claude Code écrit uniquement dans votre fichier local.

780* **Les règles allow de votre organisation s'appliquent toujours à côté des vôtres.** C'est attendu : Claude Code fusionne [`permissions.allow`](/docs/fr/settings-reference#permissions-allow) entre les portées, sauf si votre organisation définit [`allowManagedPermissionRulesOnly`](/docs/fr/settings-reference#allowmanagedpermissionrulesonly).780* **Les règles allow de votre organisation s'appliquent toujours à côté des vôtres.** C'est attendu : Claude Code fusionne [`permissions.allow`](/docs/fr/settings-reference#permissions-allow) entre les portées, sauf si votre organisation définit [`allowManagedPermissionRulesOnly`](/docs/fr/settings-reference#allowmanagedpermissionrulesonly).

781 781 

782<span id="security-keys-where-the-stricter-value-applies" />782<span id="security-keys-where-the-stricter-value-applies" />

783 783 

784<h3 id="exceptions-to-managed-settings-precedence">784<h3 id="exceptions-to-managed-settings-precedence">

785 Exceptions à la précédence des paramètres gérés785 Exceptions à la priorité des paramètres gérés

786</h3>786</h3>

787 787 

788Pour quelques clés dont les valeurs restreignent une session, Claude Code honore une valeur restrictive d'une portée qui ne pourrait autrement pas remplacer les paramètres gérés. Trouvez la clé dans ce tableau pour voir quelle valeur elle honore et d'où.788Pour quelques clés dont les valeurs restreignent une session, Claude Code honore une valeur restrictive d'une portée qui ne pourrait autrement pas remplacer les paramètres gérés. Trouvez la clé dans ce tableau pour voir quelle valeur elle honore et d'où.


792| [`disableClaudeAiConnectors`](/docs/fr/settings-reference#disableclaudeaiconnectors) | `true` à partir de n'importe quelle portée | Honorée même quand une source gérée définit `false` |792| [`disableClaudeAiConnectors`](/docs/fr/settings-reference#disableclaudeaiconnectors) | `true` à partir de n'importe quelle portée | Honorée même quand une source gérée définit `false` |

793| [`enableArtifact`](/docs/fr/settings-reference#enableartifact) | `false` à partir de n'importe quelle portée, et `disableArtifact: true` à partir de n'importe quelle portée | Honorée même quand une source gérée définit `true` ; rien ne réactive l'[outil Artifact](/docs/fr/artifacts#disable-artifacts). Nécessite Claude Code v2.1.242 ou ultérieur |793| [`enableArtifact`](/docs/fr/settings-reference#enableartifact) | `false` à partir de n'importe quelle portée, et `disableArtifact: true` à partir de n'importe quelle portée | Honorée même quand une source gérée définit `true` ; rien ne réactive l'[outil Artifact](/docs/fr/artifacts#disable-artifacts). Nécessite Claude Code v2.1.242 ou ultérieur |

794| [`isolatePeerMachines`](/docs/fr/settings-reference#isolatepeermachines) | `true` à partir de n'importe quelle portée | Honorée même quand une source gérée définit `false` |794| [`isolatePeerMachines`](/docs/fr/settings-reference#isolatepeermachines) | `true` à partir de n'importe quelle portée | Honorée même quand une source gérée définit `false` |

795| [`permissions.blockReadsOutsideWorkingDirectories`](/docs/fr/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` à partir de n'importe quelle portée | Honorée même quand une source gérée définit `false`. Nécessite Claude Code v2.1.257 ou ultérieur |

796| [`autoMode.classifyAllShell`](/docs/fr/settings-reference#automode-classifyallshell) | `true` à partir de `~/.claude/settings.json` ou `--settings` | Honorée même quand une source gérée définit `false` |

795| [`remoteControlAtStartup`](/docs/fr/settings-reference#remotecontrolatstartup) | `false` à partir de `.claude/settings.json` ou `.claude/settings.local.json` | Honorée même quand une source gérée définit `true` ; un `true` de projet ou local est ignoré |797| [`remoteControlAtStartup`](/docs/fr/settings-reference#remotecontrolatstartup) | `false` à partir de `.claude/settings.json` ou `.claude/settings.local.json` | Honorée même quand une source gérée définit `true` ; un `true` de projet ou local est ignoré |

796| [`crossSessionInbound`](/docs/fr/settings-reference#crosssessioninbound) | Une valeur plus stricte à partir de `.claude/settings.json` ou `.claude/settings.local.json`, sur l'échelle `accept` \< `hold` \< `refuse` | Honorée sur les valeurs gérées, `--settings`, et utilisateur ; une valeur de projet ou local qui n'est pas plus stricte est ignorée |798| [`crossSessionInbound`](/docs/fr/settings-reference#crosssessioninbound) | Une valeur plus stricte à partir de `.claude/settings.json` ou `.claude/settings.local.json`, sur l'échelle `accept` \< `hold` \< `refuse` | Honorée sur les valeurs gérées, `--settings`, et utilisateur ; une valeur de projet ou local qui n'est pas plus stricte est ignorée |

797| [`useAutoModeDuringPlan`](/docs/fr/settings-reference#useautomodeduringplan) | `false` à partir de n'importe quelle source gérée, `--settings`, `~/.claude/settings.json`, ou `.claude/settings.local.json` | Honorée même quand la source gérée gagnante définit `true` ; un `false` dans `.claude/settings.json` est ignoré |799| [`useAutoModeDuringPlan`](/docs/fr/settings-reference#useautomodeduringplan) | `false` à partir de n'importe quelle source gérée, `--settings`, `~/.claude/settings.json`, ou `.claude/settings.local.json` | Honorée même quand la source gérée gagnante définit `true` ; un `false` dans `.claude/settings.json` est ignoré |


799| [`syncClaudeAiPlugins`](/docs/fr/settings-reference#syncclaudeaiplugins) | `false` à partir de n'importe quelle source gérée, `--settings`, `~/.claude/settings.json`, ou `.claude/settings.local.json` | Honorée même quand la source gérée gagnante définit `true` ; un `false` dans `.claude/settings.json` est ignoré |801| [`syncClaudeAiPlugins`](/docs/fr/settings-reference#syncclaudeaiplugins) | `false` à partir de n'importe quelle source gérée, `--settings`, `~/.claude/settings.json`, ou `.claude/settings.local.json` | Honorée même quand la source gérée gagnante définit `true` ; un `false` dans `.claude/settings.json` est ignoré |

800| [`maxEffortLevel`](/docs/fr/settings-reference#maxeffortlevel) | Un plafond inférieur à partir de n'importe quelle portée, y compris `--settings` | Honorée même quand les paramètres gérés que Claude Code applique définissent un plafond plus élevé ; le plafond le plus bas s'applique. Nécessite Claude Code v2.1.267 ou ultérieur |802| [`maxEffortLevel`](/docs/fr/settings-reference#maxeffortlevel) | Un plafond inférieur à partir de n'importe quelle portée, y compris `--settings` | Honorée même quand les paramètres gérés que Claude Code applique définissent un plafond plus élevé ; le plafond le plus bas s'applique. Nécessite Claude Code v2.1.267 ou ultérieur |

801 803 

802Une application qui exécute Claude Code à l'intérieur d'elle-même et définit [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/fr/env-vars) est aussi une exception. Claude Code prend la configuration de modèle de cette application sur les clés `model`, `fallbackModel`, `modelPicker`, et `modelOverrides` à partir de chaque source gérée, et sur les variables de sélection de modèle dans un bloc `env` géré, comme `ANTHROPIC_MODEL` et la famille `ANTHROPIC_DEFAULT_*_MODEL`. Claude Code garde une liste blanche [`availableModels`](/docs/fr/settings-reference#availablemodels) gérée en vigueur sauf si l'application fournit la sienne.804Une application qui exécute Claude Code à l'intérieur d'elle-même et définit [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/fr/env-vars) est aussi une exception. Claude Code prend la configuration de modèle de cette application sur les clés `model`, `fallbackModel`, `modelPicker`, et `modelOverrides` à partir de chaque source gérée, et sur les variables de sélection de modèle dans un bloc `env` géré, comme `ANTHROPIC_MODEL` et la famille `ANTHROPIC_DEFAULT_*_MODEL`. Claude Code garde une liste d'autorisation [`availableModels`](/docs/fr/settings-reference#availablemodels) gérée en vigueur sauf si l'application fournit la sienne.

803 805 

804<h2 id="settings-in-cloud-sessions">806<h2 id="settings-in-cloud-sessions">

805 Paramètres dans les sessions cloud807 Paramètres dans les sessions cloud

Details

870 870 

871Désactivez la [réflexion étendue](/docs/fr/model-config#extended-thinking) pour chaque session en définissant ceci à `false`. La réflexion est activée par défaut, donc `true` ne change rien. La plupart des gens définissent ceci via `/config` plutôt qu'en éditant le fichier.871Désactivez la [réflexion étendue](/docs/fr/model-config#extended-thinking) pour chaque session en définissant ceci à `false`. La réflexion est activée par défaut, donc `true` ne change rien. La plupart des gens définissent ceci via `/config` plutôt qu'en éditant le fichier.

872 872 

873Sur les modèles qui réfléchissent toujours, comme Opus 5.5, Sonnet 5.5, et les modèles Fable, `false` n'a aucun effet. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations), Claude Code omet le paramètre `thinking` au lieu de désactiver la réflexion, donc les modèles de raisonnement adaptatif peuvent toujours réfléchir. Avec la réflexion désactivée sur l'API Anthropic, Claude Code envoie l'effort `high` au lieu d'un niveau supérieur aux modèles qu'il sait [ne pas accepter cette combinaison](/docs/fr/errors#effort-isnt-available-with-thinking-turned-off), comme Opus 5.873Sur les modèles qui réfléchissent toujours, comme Opus 5.5, Sonnet 5.5, Haiku 5.5 et les modèles Fable, `false` n'a aucun effet. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations), Claude Code omet le paramètre `thinking` au lieu de désactiver la réflexion, donc les modèles de raisonnement adaptatif peuvent toujours réfléchir. Avec la réflexion désactivée sur l'API Anthropic, Claude Code envoie l'effort `high` au lieu d'un niveau supérieur aux modèles qu'il sait [ne pas accepter cette combinaison](/docs/fr/errors#effort-isnt-available-with-thinking-turned-off), comme Opus 5.

874 874 

875* **Portée** : [`Tout fichier`](#scopes)875* **Portée** : [`Tout fichier`](#scopes)

876* **Type** : Booléen876* **Type** : Booléen

setup.md +5 −3

Details

49 curl -fsSL https://claude.ai/install.sh | bash49 curl -fsSL https://claude.ai/install.sh | bash

50 ```50 ```

51 51 

52 Sur Windows, votre invite affiche `PS C:\` quand vous êtes dans PowerShell et `C:\` sans le `PS` quand vous êtes dans CMD.

53 

52 **Windows PowerShell :**54 **Windows PowerShell :**

53 55 

54 ```powershell theme={null}56 ```powershell theme={null}


63 65 

64 Quand l'installateur se termine, ouvrez une nouvelle fenêtre de terminal et exécutez `claude --version`. Une installation fonctionnelle affiche un numéro de version. Si votre shell dit que `claude` n'est pas trouvé ou n'est pas reconnu, le répertoire d'installation n'est pas encore sur votre PATH : consultez [Corriger votre PATH](/docs/fr/troubleshoot-install#command-not-found-claude-after-installation).66 Quand l'installateur se termine, ouvrez une nouvelle fenêtre de terminal et exécutez `claude --version`. Une installation fonctionnelle affiche un numéro de version. Si votre shell dit que `claude` n'est pas trouvé ou n'est pas reconnu, le répertoire d'installation n'est pas encore sur votre PATH : consultez [Corriger votre PATH](/docs/fr/troubleshoot-install#command-not-found-claude-after-installation).

65 67 

66 Si vous voyez `The token '&&' is not a valid statement separator`, vous êtes dans PowerShell, pas dans CMD. Si vous voyez `'irm' is not recognized as an internal or external command`, vous êtes dans CMD, pas dans PowerShell. Votre invite affiche `PS C:\` quand vous êtes dans PowerShell et `C:\` sans le `PS` quand vous êtes dans CMD.68 Si vous voyez `The token '&&' is not a valid statement separator`, vous êtes dans PowerShell, pas dans CMD. Si vous voyez `'irm' is not recognized as an internal or external command`, vous êtes dans CMD, pas dans PowerShell.

67 69 

68 Si la commande d'installation échoue avec `syntax error near unexpected token '<'`, un `403`, ou une autre erreur curl, consultez [Dépannage de l'installation](/docs/fr/troubleshoot-install#find-your-error) pour faire correspondre l'erreur à une solution et pour connaître les méthodes d'installation alternatives.70 Si la commande d'installation échoue avec `syntax error near unexpected token '<'`, un `403`, ou toute autre erreur, consultez [Dépannage de l'installation](/docs/fr/troubleshoot-install#find-your-error) pour faire correspondre l'erreur à une solution et pour connaître les méthodes d'installation alternatives.

69 71 

70 [Git for Windows](https://git-scm.com/downloads/win) est recommandé sur Windows natif afin que Claude Code puisse utiliser l'outil Bash. Si Git for Windows n'est pas installé, Claude Code utilise PowerShell comme outil shell à la place. Les configurations WSL n'ont pas besoin de Git for Windows.72 [Git for Windows](https://git-scm.com/downloads/win) est recommandé sur Windows natif afin que Claude Code puisse utiliser l'outil Bash. Si Git for Windows n'est pas installé, Claude Code utilise PowerShell comme outil shell à la place. Les configurations WSL n'ont pas besoin de Git for Windows.

71 73 


204 206 

205Claude Code nécessite un compte Pro, Max, Team, Enterprise ou Console. Le plan gratuit Claude.ai n'inclut pas l'accès à Claude Code. Vous pouvez également utiliser Claude Code avec un fournisseur d'API tiers comme [Amazon Bedrock](/docs/fr/amazon-bedrock), [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) ou [Microsoft Foundry](/docs/fr/microsoft-foundry).207Claude Code nécessite un compte Pro, Max, Team, Enterprise ou Console. Le plan gratuit Claude.ai n'inclut pas l'accès à Claude Code. Vous pouvez également utiliser Claude Code avec un fournisseur d'API tiers comme [Amazon Bedrock](/docs/fr/amazon-bedrock), [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) ou [Microsoft Foundry](/docs/fr/microsoft-foundry).

206 208 

207Après l'installation, connectez-vous en exécutant `claude` et en suivant les invites du navigateur. Si la variable d'environnement `ANTHROPIC_API_KEY` est définie, Claude Code vous demande une fois d'approuver la clé au lieu d'ouvrir un navigateur. Consultez [Authentification](/docs/fr/authentication) pour tous les types de comptes et les options de configuration d'équipe.209Après l'installation, connectez-vous en exécutant `claude` et en suivant les invites du navigateur. Si vous avez défini la variable d'environnement `ANTHROPIC_API_KEY` et que vous approuvez la clé lorsque Claude Code vous demande s'il doit l'utiliser, Claude Code ignore l'invite de connexion. Consultez [Authentification](/docs/fr/authentication) pour tous les types de comptes et les options de configuration d'équipe.

208 210 

209<h2 id="update-claude-code">211<h2 id="update-claude-code">

210 Mettre à jour Claude Code212 Mettre à jour Claude Code

skills.md +7 −2

Details

237 237 

238Dans une session Cowork ou cloud, Claude Code charge les skills activées pour votre compte claude.ai, et [Skills dans les sessions Cowork et cloud](#skills-in-cowork-and-cloud-sessions) dit comment choisir quelles skills ces sessions obtiennent.238Dans une session Cowork ou cloud, Claude Code charge les skills activées pour votre compte claude.ai, et [Skills dans les sessions Cowork et cloud](#skills-in-cowork-and-cloud-sessions) dit comment choisir quelles skills ces sessions obtiennent.

239 239 

240Dans votre terminal, Claude Code synchronise ces skills dans les sessions où vous vous connectez avec votre compte claude.ai. Quand la session démarre, Claude Code télécharge les skills de votre compte dans `~/.claude/skills/synced/` en arrière-plan, puis vérifie claude.ai pour les modifications environ toutes les 10 minutes pendant que la session s'exécute. Quand une vérification trouve qu'une skill a été ajoutée, éditée ou désactivée sur claude.ai, Claude Code l'ajoute, la met à jour ou la supprime dans la session en cours sans redémarrage. La synchronisation dans les sessions de terminal nécessite Claude Code v2.1.273 ou ultérieur.240Dans votre terminal, Claude Code synchronise ces skills dans les sessions où vous vous connectez avec votre compte claude.ai. Quand la session démarre, Claude Code télécharge les skills de votre compte dans `~/.claude/skills/synced/` en arrière-plan, puis vérifie les modifications sur claude.ai pendant que la session s'exécute. Quand une vérification constate qu'un skill a été ajouté, édité ou désactivé sur claude.ai, Claude Code l'ajoute, le met à jour ou le supprime dans la session en cours sans redémarrage. La synchronisation dans les sessions de terminal nécessite Claude Code v2.1.273 ou ultérieur.

241 241 

242La synchronisation ne retarde jamais le démarrage, car Claude attend le téléchargement d'une skill uniquement quand il l'invoque. Une exécution courte [non-interactive](/docs/fr/headless) peut donc se terminer avant qu'une skill nouvellement ajoutée ne soit téléchargée, auquel cas une session ultérieure la télécharge. Pour faire en sorte qu'une exécution non-interactive télécharge vos skills et attende la liste avant de répondre à l'invite, définissez [`CLAUDE_CODE_SYNC_SKILLS`](/docs/fr/env-vars#variables) sur `1`.242Les vérifications s'exécutent moins souvent lorsque la session est inactive :

243 

244* **Pendant que vous ou Claude travaillez dans la session** : une vérification s'exécute environ toutes les 10 minutes.

245* **Pendant que la session est inactive** : une vérification s'exécute environ toutes les 40 minutes. Quand vous tapez à nouveau dans la session, Claude Code vérifie dans les quelques minutes qui suivent si la dernière vérification date de plus de 10 minutes.

246 

247La synchronisation ne retarde jamais le démarrage, car Claude attend le téléchargement d'un skill uniquement quand il l'invoque. Une exécution courte [non interactive](/docs/fr/headless) peut donc se terminer avant qu'un skill nouvellement ajouté ne soit téléchargé, auquel cas une session ultérieure le télécharge. Pour faire en sorte qu'une exécution non interactive télécharge vos skills et attende la liste avant de répondre au prompt, définissez [`CLAUDE_CODE_SYNC_SKILLS`](/docs/fr/env-vars#variables) sur `1`. Avant v2.1.273, les sessions de terminal ne les téléchargeaient que dans une exécution `-p` avec cette variable définie.

243 248 

244Claude Code ne synchronise que dans une session qui se connecte avec votre compte claude.ai et [récupère les drapeaux de fonctionnalités depuis Anthropic](/docs/fr/env-vars#features-that-need-feature-flag-fetching). Il ne synchronise pas dans ces sessions :249Claude Code ne synchronise que dans une session qui se connecte avec votre compte claude.ai et [récupère les drapeaux de fonctionnalités depuis Anthropic](/docs/fr/env-vars#features-that-need-feature-flag-fetching). Il ne synchronise pas dans ces sessions :

245 250 

sub-agents.md +4 −4

Details

310 310 

311| Champ | Obligatoire | Description |311| Champ | Obligatoire | Description |

312| :- | :- | :- |312| :- | :- | :- |

313| `name` | Oui | Identifiant unique, tel que `code-reviewer` ou `reviewer-v2`. Les [hooks](/docs/fr/hooks#subagentstart) reçoivent cette valeur comme `agent_type`. Le nom du fichier n'a pas besoin de correspondre. Les noms ne peuvent pas contenir `:`, qui est réservé aux [identifiants limités au plugin](/docs/fr/plugins/overview) tels que `my-plugin:reviewer`. Claude Code ne charge pas un fichier dont le nom en contient un et enregistre une erreur dans le journal de débogage. Avant la v2.1.218, de tels noms étaient acceptés |313| `name` | Oui | Identifiant unique d'au plus 256 caractères, tel que `code-reviewer` ou `reviewer-v2`. Les [hooks](/docs/fr/hooks#subagentstart) reçoivent cette valeur comme `agent_type`. Le nom du fichier n'a pas besoin de correspondre. Les noms ne peuvent pas contenir `:`, qui est réservé aux [identifiants limités au plugin](/docs/fr/plugins/overview) tels que `my-plugin:reviewer` |

314| `description` | Oui | Quand Claude doit déléguer à ce sous-agent |314| `description` | Oui | Quand Claude doit déléguer à ce sous-agent |

315| `tools` | Non | [Outils](#available-tools) que le sous-agent peut utiliser, sous forme de chaîne séparée par des virgules telle que `Read, Grep, Bash` ou une liste YAML. Hérite de tous les outils disponibles pour les sous-agents s'il est omis. Si aucune entrée de la liste ne se résout en un outil, le sous-agent échoue généralement au [lancement](/docs/fr/errors#agent-would-be-spawned-with-zero-tools) avec une erreur nommant les entrées. Pour précharger les Skills dans le contexte, utilisez le champ `skills` plutôt que de lister `Skill` ici |315| `tools` | Non | [Outils](#available-tools) que le sous-agent peut utiliser, sous forme de chaîne séparée par des virgules telle que `Read, Grep, Bash` ou une liste YAML. Hérite de tous les outils disponibles pour les sous-agents s'il est omis. Si aucune entrée de la liste ne se résout en un outil, le sous-agent échoue généralement au [lancement](/docs/fr/errors#agent-would-be-spawned-with-zero-tools) avec une erreur nommant les entrées. Pour précharger les Skills dans le contexte, utilisez le champ `skills` plutôt que de lister `Skill` ici |

316| `disallowedTools` | Non | Outils à refuser, supprimés de la liste héritée ou spécifiée. Même format que `tools`. Une entrée avec un spécificateur, tel que `Bash(git push *)`, supprime toujours l'[outil entier](#available-tools) |316| `disallowedTools` | Non | Outils à refuser, supprimés de la liste héritée ou spécifiée. Même format que `tools`. Une entrée avec un spécificateur, tel que `Bash(git push *)`, supprime toujours l'[outil entier](#available-tools) |


348 348 

349* **Pas de `name`** : Claude Code traite le fichier comme de la documentation conservée à côté de vos agents.349* **Pas de `name`** : Claude Code traite le fichier comme de la documentation conservée à côté de vos agents.

350* **Un `---` d'ouverture qui n'est pas la première ligne du fichier** : Claude Code lit le fichier comme n'ayant pas de frontmatter et le traite comme de la documentation.350* **Un `---` d'ouverture qui n'est pas la première ligne du fichier** : Claude Code lit le fichier comme n'ayant pas de frontmatter et le traite comme de la documentation.

351* **Un `name` qui commence par `-` ou contient `:`** : Claude Code ignore le fichier et écrit une erreur dans le journal de débogage. Consultez la ligne `name` dans le tableau ci-dessus.351* **Un `name` qui commence par `-`, contient `:` ou dépasse 256 caractères** : Claude Code ignore le fichier et écrit une erreur dans le journal de débogage.

352* **Un `name` mais pas de `description`** : Claude Code ignore le fichier et écrit la raison dans le journal de débogage.352* **Un `name` mais pas de `description`** : Claude Code ignore le fichier et écrit la raison dans le journal de débogage.

353* **YAML qui ne s'analyse pas** : Claude Code ne lit aucun champ du fichier, l'ignore et écrit l'erreur d'analyse dans le journal de débogage.353* **YAML qui ne s'analyse pas** : Claude Code ne lit aucun champ du fichier, l'ignore et écrit l'erreur d'analyse dans le journal de débogage.

354 354 


1164 1164 

1165* Lorsqu'un sous-agent se termine, Claude reçoit son ID d'agent.1165* Lorsqu'un sous-agent se termine, Claude reçoit son ID d'agent.

1166* Les agents Explore et Plan intégrés sont ponctuels et ne retournent pas d'ID d'agent, de sorte que Claude ne peut pas les reprendre. Utilisez `general-purpose` ou un sous-agent personnalisé lorsque vous avez besoin de continuer le travail.1166* Les agents Explore et Plan intégrés sont ponctuels et ne retournent pas d'ID d'agent, de sorte que Claude ne peut pas les reprendre. Utilisez `general-purpose` ou un sous-agent personnalisé lorsque vous avez besoin de continuer le travail.

1167* Lorsqu'un sous-agent s'arrête à sa limite [`maxTurns`](#supported-frontmatter-fields), Claude Code marque la sortie retournée comme partielle. Pour les sous-agents qui retournent un ID d'agent, Claude Code note également dans le résultat que Claude peut envoyer un message au sous-agent pour continuer à partir de là où il s'est arrêté.1167* Lorsqu'un sous-agent s'arrête à sa limite [`maxTurns`](#supported-frontmatter-fields), Claude Code marque la sortie retournée comme partielle, et Claude peut reprendre le sous-agent pour continuer son travail.

1168 1168 

1169Claude utilise l'outil `SendMessage` avec l'ID ou le nom de l'agent comme champ `to` pour le reprendre. `SendMessage` ne nécessite pas que les [équipes d'agents](/docs/fr/agent-teams) soient activées ; seuls les messages de protocole d'équipe structurés comme `shutdown_request` et `plan_approval_response` le font. Au-delà des sous-agents et des coéquipiers, dans les sessions où la messagerie inter-sessions est activée, Claude peut utiliser le même outil pour envoyer un message à [vos autres sessions Claude Code](/docs/fr/cross-session-messaging), sur cette machine ou [au-delà](/docs/fr/cross-session-messaging#message-sessions-on-other-machines).1169Claude utilise l'outil `SendMessage` avec l'ID ou le nom de l'agent comme champ `to` pour le reprendre. `SendMessage` ne nécessite pas que les [équipes d'agents](/docs/fr/agent-teams) soient activées ; seuls les messages de protocole d'équipe structurés comme `shutdown_request` et `plan_approval_response` le font. Au-delà des sous-agents et des coéquipiers, dans les sessions où la messagerie inter-sessions est activée, Claude peut utiliser le même outil pour envoyer un message à [vos autres sessions Claude Code](/docs/fr/cross-session-messaging), sur cette machine ou [au-delà](/docs/fr/cross-session-messaging#message-sessions-on-other-machines).

1170 1170 


1279| Permissions | Les invites s'affichent dans votre terminal | [Les invites s'affichent dans votre session principale](#run-subagents-in-foreground-or-background) lors de l'exécution en arrière-plan |1279| Permissions | Les invites s'affichent dans votre terminal | [Les invites s'affichent dans votre session principale](#run-subagents-in-foreground-or-background) lors de l'exécution en arrière-plan |

1280| Cache d'invite | Partagé avec la session principale | Cache séparé |1280| Cache d'invite | Partagé avec la session principale | Cache séparé |

1281 1281 

1282Parce que l'invite système d'un fork et les définitions d'outils sont identiques au parent, sa première demande réutilise le [cache d'invite](/docs/fr/prompt-caching#subagents-and-the-cache) du parent. Cela rend le forking moins cher que la génération d'un sous-agent frais pour les tâches qui ont besoin du même contexte.1282Comme le prompt système d'un fork et ses définitions d'outils sont identiques à ceux du parent, sa première requête réutilise le [cache de prompt](/docs/fr/prompt-caching#subagents-and-the-cache) du parent. Grâce à cette réutilisation, un fork coûte moins cher qu'un sous-agent frais pour les tâches qui ont besoin du même contexte.

1283 1283 

1284Lorsque Claude génère un fork via l'outil Agent, il peut passer `isolation: "worktree"` pour que les modifications de fichiers du fork soient écrites dans un git worktree séparé au lieu de votre extraction. Un fork ne peut pas générer d'autres forks.1284Lorsque Claude génère un fork via l'outil Agent, il peut passer `isolation: "worktree"` pour que les modifications de fichiers du fork soient écrites dans un git worktree séparé au lieu de votre extraction. Un fork ne peut pas générer d'autres forks.

1285 1285 

vs-code.md +22 −7

Details

40 40 

41L'extension s'installe également dans d'autres forks de VS Code comme Devin Desktop ou Kiro. Recherchez « Claude Code » dans la vue Extensions de l'éditeur, ou installez à partir du [registre Open VSX](https://open-vsx.org/extension/Anthropic/claude-code). Si votre éditeur ne peut pas installer l'extension, [installez l'interface CLI](/docs/fr/quickstart) et exécutez `claude` dans son terminal intégré à la place. L'interface CLI fonctionne dans n'importe quel terminal.41L'extension s'installe également dans d'autres forks de VS Code comme Devin Desktop ou Kiro. Recherchez « Claude Code » dans la vue Extensions de l'éditeur, ou installez à partir du [registre Open VSX](https://open-vsx.org/extension/Anthropic/claude-code). Si votre éditeur ne peut pas installer l'extension, [installez l'interface CLI](/docs/fr/quickstart) et exécutez `claude` dans son terminal intégré à la place. L'interface CLI fonctionne dans n'importe quel terminal.

42 42 

43Pour exécuter Claude Code dans un dev container, consultez [Conteneurs de développement](/docs/fr/devcontainer).

44 

43<Note>Si l'extension n'apparaît pas après l'installation, redémarrez VS Code ou exécutez « Developer: Reload Window » à partir de la Palette de commandes.</Note>45<Note>Si l'extension n'apparaît pas après l'installation, redémarrez VS Code ou exécutez « Developer: Reload Window » à partir de la Palette de commandes.</Note>

44 46 

45<h2 id="get-started">47<h2 id="get-started">


606| `environmentVariables` | `[]` | Définissez les variables d'environnement pour le processus Claude. Utilisez plutôt les paramètres Claude Code pour la configuration partagée. Une entrée [`CLAUDE_CONFIG_DIR`](/docs/fr/env-vars) ne s'applique que si sa valeur est un chemin absolu ; l'extension ne développe pas `~` et ignore une valeur relative. |608| `environmentVariables` | `[]` | Définissez les variables d'environnement pour le processus Claude. Utilisez plutôt les paramètres Claude Code pour la configuration partagée. Une entrée [`CLAUDE_CONFIG_DIR`](/docs/fr/env-vars) ne s'applique que si sa valeur est un chemin absolu ; l'extension ne développe pas `~` et ignore une valeur relative. |

607| `disableLoginPrompt` | `false` | Ignorez les invites d'authentification (pour les configurations de fournisseur tiers) |609| `disableLoginPrompt` | `false` | Ignorez les invites d'authentification (pour les configurations de fournisseur tiers) |

608| `allowDangerouslySkipPermissions` | `false` | Ajoute Bypass permissions au sélecteur de mode. Utilisez-le uniquement dans les sandboxes sans accès à Internet. |610| `allowDangerouslySkipPermissions` | `false` | Ajoute Bypass permissions au sélecteur de mode. Utilisez-le uniquement dans les sandboxes sans accès à Internet. |

609| `claudeProcessWrapper` | - | Exécutable utilisé pour lancer le processus Claude. Le chemin binaire fourni est transmis en tant qu'argument lorsqu'il est présent. Définissez-le sur un binaire `claude` installé séparément si la version de l'extension n'en inclut pas un pour votre plateforme. Dans une configuration encapsulée, les conversations commencent en mode Manual sauf si vous définissez `initialPermissionMode` ou avez choisi Manual, Edit automatically ou Auto dans une conversation antérieure, car l'extension ignore les paramètres et les étapes par défaut intégrées là ; voir [Switch permission modes](/docs/fr/permission-modes#switch-permission-modes). Une erreur « Unsupported platform » à l'activation signifie qu'aucun binaire n'est fourni pour votre plateforme ; voir [which platforms have prebuilt binaries](/docs/fr/troubleshoot-install#native-binary-not-found-after-npm-install). |611| `claudeProcessWrapper` | - | Exécutable utilisé pour lancer le processus Claude. Le chemin binaire fourni est transmis en tant qu'argument lorsqu'il est présent. Définissez-le sur un binaire `claude` installé séparément si la version de l'extension n'en inclut pas un pour votre plateforme. |

610 612 

611<h2 id="use-a-screen-reader">613<h2 id="use-a-screen-reader">

612 Utiliser un lecteur d'écran614 Utiliser un lecteur d'écran


783 785 

784Votre code reste privé. Claude Code traite votre code pour fournir une assistance, mais ne l'utilise pas pour entraîner les modèles. Pour plus de détails sur la gestion des données et comment refuser la journalisation, consultez [Données et confidentialité](/docs/fr/data-usage).786Votre code reste privé. Claude Code traite votre code pour fournir une assistance, mais ne l'utilise pas pour entraîner les modèles. Pour plus de détails sur la gestion des données et comment refuser la journalisation, consultez [Données et confidentialité](/docs/fr/data-usage).

785 787 

786Avec les autorisations de modification automatique activées, Claude Code peut modifier les fichiers de configuration de VS Code (comme `settings.json` ou `tasks.json`) que VS Code peut exécuter automatiquement. Pour réduire les risques lorsque vous travaillez avec du code non approuvé :788Avec les permissions de modification automatique activées, Claude Code peut modifier les fichiers de configuration de VS Code (comme `settings.json` ou `tasks.json`) que VS Code peut exécuter automatiquement. Pour réduire les risques lorsque vous travaillez avec du code non approuvé :

787 789 

788* Activez le [Mode restreint de VS Code](https://code.visualstudio.com/docs/editor/workspace-trust#_restricted-mode) pour les espaces de travail non approuvés790* Activez le [Mode restreint de VS Code](https://code.visualstudio.com/docs/editor/workspace-trust#_restricted-mode) pour les espaces de travail non approuvés

789* Utilisez le mode Manuel au lieu de Modifier automatiquement ou Auto pour les modifications791* Utilisez le mode Manuel au lieu de Modifier automatiquement ou Auto pour les modifications


797 799 

798Le serveur est nommé `ide` et est masqué de `/mcp` car il n'y a rien à configurer. Si votre organisation utilise un hook `PreToolUse` pour créer une liste d'autorisation des outils MCP, vous devrez cependant savoir qu'il existe.800Le serveur est nommé `ide` et est masqué de `/mcp` car il n'y a rien à configurer. Si votre organisation utilise un hook `PreToolUse` pour créer une liste d'autorisation des outils MCP, vous devrez cependant savoir qu'il existe.

799 801 

800**Contexte de sélection et de fichier ouvert.** Lors de la connexion, le CLI inclut votre sélection d'éditeur actuelle et le chemin du fichier actif comme contexte sur chaque invite que vous envoyez. La transcription affiche une ligne `⧉ Selected N lines from <file>` lorsque cela se produit.802**Contexte de sélection et de fichier ouvert.** Lors de la connexion, le CLI inclut votre sélection d'éditeur actuelle et le chemin du fichier actif comme contexte sur chaque prompt que vous envoyez. La transcription affiche une ligne `⧉ Selected N lines from <file>` lorsque cela se produit.

801 803 

802Si vous [mettez en file d'attente un message pendant que Claude travaille](/docs/fr/interactive-mode#queue-messages-while-claude-works), il conserve la sélection que vous aviez lorsque vous avez appuyé sur `Entrée`, quelle que soit votre sélection ultérieure.804Si vous [mettez en file d'attente un message pendant que Claude travaille](/docs/fr/interactive-mode#queue-messages-while-claude-works), il conserve la sélection que vous aviez lorsque vous avez appuyé sur `Entrée`, quelle que soit votre sélection ultérieure.

803 805 


805 807 

806Si vous désactivez le [paramètre Attacher le fichier ouvert](#extension-settings), le CLI reçoit le chemin du fichier actif uniquement lorsque vous avez du texte sélectionné dedans.808Si vous désactivez le [paramètre Attacher le fichier ouvert](#extension-settings), le CLI reçoit le chemin du fichier actif uniquement lorsque vous avez du texte sélectionné dedans.

807 809 

808**Transport et authentification.** Le serveur se lie à `127.0.0.1` sur un port aléatoire dans la plage 10000–65535, et le port n'est pas configurable. Le transport est un `ws://` non chiffré ; comme la socket est en boucle locale uniquement, tout processus qui pourrait capturer le trafic peut également lire le jeton du fichier de verrouillage, donc TLS n'ajouterait pas de protection. Chaque activation d'extension génère un jeton d'authentification aléatoire frais, l'écrit dans un fichier de verrouillage à `~/.claude/ide/<port>.lock`, et le CLI doit le présenter comme l'en-tête `X-Claude-Code-Ide-Authorization` pour se connecter. Le fichier de verrouillage a des autorisations `0600` dans un répertoire `0700`, donc seul l'utilisateur exécutant VS Code peut le lire. Si `CLAUDE_CONFIG_DIR` est défini, le fichier de verrouillage est écrit dans `$CLAUDE_CONFIG_DIR/ide/` à la place.810**Transport et authentification.** Le serveur se lie à `127.0.0.1` sur un port aléatoire dans la plage 10000–65535, et le port n'est pas configurable. Le transport est un `ws://` non chiffré ; comme la socket est en boucle locale uniquement, tout processus qui pourrait capturer le trafic peut également lire le jeton du fichier de verrouillage, donc TLS n'ajouterait pas de protection. Chaque activation d'extension génère un jeton d'authentification aléatoire frais, l'écrit dans un fichier de verrouillage à `~/.claude/ide/<port>.lock`, et le CLI doit le présenter comme l'en-tête `X-Claude-Code-Ide-Authorization` pour se connecter. Le fichier de verrouillage a des permissions `0600` dans un répertoire `0700`, donc seul l'utilisateur exécutant VS Code peut le lire. Si `CLAUDE_CONFIG_DIR` est défini, le fichier de verrouillage est écrit dans `$CLAUDE_CONFIG_DIR/ide/` à la place.

809 811 

810**Outils exposés au modèle.** Le serveur héberge une douzaine d'outils, mais seulement deux sont visibles au modèle. Le reste est un RPC interne que le CLI utilise pour sa propre interface utilisateur — ouvrir les diffs, lire les sélections, enregistrer les fichiers — et sont filtrés avant que la liste des outils n'atteigne Claude.812**Outils exposés au modèle.** Le serveur héberge une douzaine d'outils, mais seulement deux sont visibles au modèle. Les autres sont des RPC internes que le CLI utilise pour sa propre interface utilisateur, comme ouvrir les diffs, lire les sélections et enregistrer les fichiers. Ils sont filtrés avant que la liste des outils n'atteigne Claude.

811 813 

812| Nom de l'outil (tel que vu par les hooks) | Ce qu'il fait | Lecture seule |814| Nom de l'outil (tel que vu par les hooks) | Ce qu'il fait | Lecture seule |

813| - | - | - |815| - | - | - |

814| `mcp__ide__getDiagnostics` | Retourne les diagnostics du serveur de langage — les erreurs et avertissements dans le panneau Problèmes de VS Code. Optionnellement limité à un fichier. | Oui |816| `mcp__ide__getDiagnostics` | Retourne les diagnostics du serveur de langage : les erreurs et avertissements dans le panneau Problèmes de VS Code. Optionnellement limité à un fichier. | Oui |

815| `mcp__ide__executeCode` | Exécute le code Python dans le kernel du notebook Jupyter actif. Voir le flux de confirmation ci-dessous. | Non |817| `mcp__ide__executeCode` | Exécute le code Python dans le kernel du notebook Jupyter actif. Voir le flux de confirmation ci-dessous. | Non |

816 818 

817**Diagnostics dans le panneau de chat.** Dans le panneau de chat, avec Claude Code v2.1.285 ou ultérieur, Claude lit le panneau Problèmes de VS Code via un serveur intégré distinct nommé `claude-vscode`. Claude peut lui demander les erreurs et avertissements actuels dans un fichier, ou dans tous les fichiers pour lesquels VS Code dispose de diagnostics.819**Diagnostics dans le panneau de chat.** Dans le panneau de chat, avec Claude Code v2.1.285 ou ultérieur, Claude lit le panneau Problèmes de VS Code via un serveur intégré distinct nommé `claude-vscode`. Claude peut lui demander les erreurs et avertissements actuels dans un fichier, ou dans tous les fichiers pour lesquels VS Code dispose de diagnostics.


833 835 

834Une règle de refus `Read` ne couvre aucun de ces deux outils ; bloquez-les donc par leur nom avec une [règle de refus](/docs/fr/permissions#mcp), comme le fait l'exemple.836Une règle de refus `Read` ne couvre aucun de ces deux outils ; bloquez-les donc par leur nom avec une [règle de refus](/docs/fr/permissions#mcp), comme le fait l'exemple.

835 837 

836**L'exécution Jupyter demande toujours d'abord.** `mcp__ide__executeCode` ne peut rien exécuter silencieusement. À chaque appel, le code est inséré comme une nouvelle cellule à la fin du notebook actif, VS Code le fait défiler dans la vue, et un Quick Pick natif vous demande d'**Exécuter** ou d'**Annuler**. Annuler — ou fermer le sélecteur avec `Esc` — retourne une erreur à Claude et rien ne s'exécute. L'outil refuse également catégoriquement lorsqu'il n'y a pas de notebook actif, lorsque l'extension Jupyter (`ms-toolsai.jupyter`) n'est pas installée, ou lorsque le kernel n'est pas Python.838**L'exécution Jupyter demande toujours d'abord.** `mcp__ide__executeCode` ne peut rien exécuter silencieusement. À chaque appel, le code est inséré comme une nouvelle cellule à la fin du notebook actif, VS Code le fait défiler dans la vue, et un Quick Pick natif vous demande d'**Exécuter** ou d'**Annuler**. Annuler, ou fermer le sélecteur avec `Esc`, retourne une erreur à Claude et rien ne s'exécute. L'outil refuse également catégoriquement lorsqu'il n'y a pas de notebook actif, lorsque l'extension Jupyter (`ms-toolsai.jupyter`) n'est pas installée, ou lorsque le kernel n'est pas Python.

837 839 

838<Note>840<Note>

839 La confirmation Quick Pick est séparée des hooks `PreToolUse`. Une entrée de liste d'autorisation pour `mcp__ide__executeCode` permet à Claude de *proposer* d'exécuter une cellule ; le Quick Pick à l'intérieur de VS Code est ce qui lui permet de l'*exécuter réellement*.841 La confirmation Quick Pick est séparée des hooks `PreToolUse`. Une entrée de liste d'autorisation pour `mcp__ide__executeCode` permet à Claude de *proposer* d'exécuter une cellule ; le Quick Pick à l'intérieur de VS Code est ce qui lui permet de l'*exécuter réellement*.


845 Résoudre les problèmes courants847 Résoudre les problèmes courants

846</h2>848</h2>

847 849 

850Les erreurs de connexion, de réseau et de lancement ont leurs propres entrées dans les pages de dépannage de l'installation et de référence des erreurs. Trouvez ce que vous voyez dans le tableau, puis suivez le lien.

851 

852| Ce que vous voyez | Où aller |

853| - | - |

854| `API Error: 403 Request not allowed` après vous être connecté | [403 Forbidden après la connexion](/docs/fr/troubleshoot-install#403-forbidden-after-login) |

855| On vous demande de vous reconnecter alors que vous êtes déjà connecté | [Non connecté ou jeton expiré](/docs/fr/troubleshoot-install#not-logged-in-or-token-expired) |

856| Les identifiants du fournisseur cloud fonctionnent dans votre terminal mais pas dans l'extension | [Identifiants Bedrock, Agent Platform ou Foundry non chargés](/docs/fr/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) |

857| `SSL certificate verification failed` ou `Self-signed certificate detected` | [Erreurs de certificat SSL](/docs/fr/errors#ssl-certificate-errors) |

858| `Claude Code process exited with code 1`, ou un autre code | [Claude Code process exited with code N](/docs/fr/errors#claude-code-process-exited-with-code-n) |

859| `Could not locate the Claude CLI on PATH` | [Could not locate the Claude CLI on PATH](/docs/fr/errors#could-not-locate-the-claude-cli-on-path) |

860| `The connection to Claude Code ended before this message completed` | [The connection to Claude Code ended before this message completed](/docs/fr/errors#the-connection-to-claude-code-ended-before-this-message-completed) |

861| `claude` est introuvable dans le terminal intégré de VS Code | [Exécuter la CLI dans VS Code](#run-cli-in-vs-code) |

862 

848<h3 id="extension-won’t-install">863<h3 id="extension-won’t-install">

849 L'extension ne s'installe pas864 L'extension ne s'installe pas

850</h3>865</h3>

Details

50| **Utilise votre configuration locale** | Non, référentiel uniquement | Oui | Oui |50| **Utilise votre configuration locale** | Non, référentiel uniquement | Oui | Oui |

51| **Nécessite GitHub** | Oui, ou [regroupez un référentiel local](/docs/fr/claude-code-on-the-web#send-local-repositories-without-github) via `--cloud` | Non | Non |51| **Nécessite GitHub** | Oui, ou [regroupez un référentiel local](/docs/fr/claude-code-on-the-web#send-local-repositories-without-github) via `--cloud` | Non | Non |

52| **Continue de s'exécuter si vous vous déconnectez** | Oui | Non | Tant que la session reste ouverte sur votre machine |52| **Continue de s'exécuter si vous vous déconnectez** | Oui | Non | Tant que la session reste ouverte sur votre machine |

53| **[Modes de permission](/docs/fr/permission-modes)** | Accepter les modifications, Plan, Auto | Tous les modes dans le terminal ; consultez [Changer les modes de permission](/docs/fr/permission-modes#switch-permission-modes) pour l'IDE et l'application Desktop | Manuel, Accepter les modifications, ou Plan depuis claude.ai et l'application mobile |53| **[Modes de permission](/docs/fr/permission-modes)** | Accepter les modifications, Plan, Auto | Tous les modes dans le terminal ; consultez [Changer les modes de permission](/docs/fr/permission-modes#switch-permission-modes) pour l'IDE et l'application Desktop | Manuel, Accepter les modifications, Plan, ou Auto depuis claude.ai et l'application mobile |

54| **Accès réseau** | Configurable par environnement | Réseau de votre machine | Réseau de votre machine |54| **Accès réseau** | Configurable par environnement | Réseau de votre machine | Réseau de votre machine |

55 55 

56Consultez la [documentation du démarrage rapide du terminal](/docs/fr/quickstart), [Application Desktop](/docs/fr/desktop), ou [Remote Control](/docs/fr/remote-control) pour configurer les sessions locales.56Consultez la [documentation du démarrage rapide du terminal](/docs/fr/quickstart), [Application Desktop](/docs/fr/desktop), ou [Remote Control](/docs/fr/remote-control) pour configurer les sessions locales.


145Avec GitHub connecté et un environnement créé, vous êtes prêt à soumettre des tâches.145Avec GitHub connecté et un environnement créé, vous êtes prêt à soumettre des tâches.

146 146 

147<Steps>147<Steps>

148 <Step title="Sélectionnez un référentiel et une branche">148 <Step title="Sélectionnez un dépôt et une branche">

149 Depuis [claude.ai/code](https://claude.ai/code) ou l'onglet Code dans l'application mobile Claude, cliquez sur le sélecteur de référentiel sous la zone de saisie et choisissez un référentiel dans lequel Claude doit travailler. Chaque référentiel affiche un sélecteur de branche. Changez-le pour démarrer Claude à partir d'une branche de fonctionnalité au lieu de la branche par défaut. Vous pouvez ajouter plusieurs référentiels pour travailler sur plusieurs dans une seule session.149 Depuis [claude.ai/code](https://claude.ai/code) ou l'onglet Code dans l'application mobile Claude, cliquez sur le sélecteur de dépôt sous la zone de saisie et choisissez un dépôt dans lequel Claude doit travailler. Chaque dépôt affiche un sélecteur de branche. Changez-le pour démarrer Claude à partir d'une branche de fonctionnalité au lieu de la branche par défaut. Vous pouvez ajouter plusieurs dépôts pour travailler sur plusieurs dans une seule session.

150 </Step>150 </Step>

151 151 

152 <Step title="Choisissez un mode de permission">152 <Step title="Choisissez un mode de permission">

153 Le menu déroulant du mode à côté de l'entrée affiche le mode dans lequel la session s'exécutera :153 Le [contrôle du mode de permission](/docs/fr/permission-modes#switch-permission-modes) affiche le mode de permission dans lequel la session s'exécutera :

154 154 

155 * **Auto** : un classificateur examine les actions de Claude au lieu de vous demander. Apparaît lorsque votre organisation autorise le mode auto et que le modèle sélectionné le supporte155 * **Auto** : un classificateur examine les actions de Claude au lieu de vous demander. Apparaît lorsque votre organisation autorise le mode auto et que le modèle sélectionné le supporte

156 * **Accepter les modifications** : Claude effectue des modifications et pousse une branche sans s'arrêter pour approbation156 * **Accepter les modifications** : Claude effectue des modifications et pousse une branche sans s'arrêter pour approbation

workflows.md +6 −1

Details

522 522 

523Pour désactiver les workflows pour toute votre organisation, définissez `"disableWorkflows": true` dans les [paramètres gérés](/docs/fr/server-managed-settings), ou utilisez le bouton bascule sur la page des [paramètres d'administration Claude Code](https://claude.ai/admin-settings/claude-code).523Pour désactiver les workflows pour toute votre organisation, définissez `"disableWorkflows": true` dans les [paramètres gérés](/docs/fr/server-managed-settings), ou utilisez le bouton bascule sur la page des [paramètres d'administration Claude Code](https://claude.ai/admin-settings/claude-code).

524 524 

525Quand les workflows sont désactivés, les commandes de workflow groupées et la compétence `/workflow-authoring` ne sont pas disponibles, le mot-clé `ultracode` ne déclenche plus une exécution, et le bouton bascule **Ultracode** est supprimé de `/effort`. Une exécution qui était déjà en cours continue.525Quand les workflows sont désactivés :

526 

527* `/workflows`, les commandes de workflow et le skill `/workflow-authoring` ne sont pas disponibles

528* Le mot-clé `ultracode` ne déclenche plus d'exécution, et le bouton bascule **Ultracode** est supprimé de `/effort`

529 

530Une exécution qui était déjà en cours continue.

526 531 

527Désactiver les workflows rend également [ultracode](#let-claude-decide-with-ultracode) indisponible. Aucun paramètre géré n'exclut ultracode seul : partout où il est [disponible](/docs/fr/model-config#when-ultracode-is-available), les utilisateurs peuvent l'activer avec `/effort ultracode`. Une [limite d'effort](/docs/fr/model-config#organization-effort-limits) abaisse le niveau d'effort qu'une session avec ultracode activé exécute, mais ne désactive pas ultracode.532Désactiver les workflows rend également [ultracode](#let-claude-decide-with-ultracode) indisponible. Aucun paramètre géré n'exclut ultracode seul : partout où il est [disponible](/docs/fr/model-config#when-ultracode-is-available), les utilisateurs peuvent l'activer avec `/effort ultracode`. Une [limite d'effort](/docs/fr/model-config#organization-effort-limits) abaisse le niveau d'effort qu'une session avec ultracode activé exécute, mais ne désactive pas ultracode.

528 533 

worktrees.md +3 −1

Details

6 6 

7> Isolez les sessions Claude Code parallèles dans des git worktrees séparés pour que les modifications ne se heurtent pas. Couvre le flag `--worktree`, l'isolation des subagents, `.worktreeinclude`, le nettoyage et les hooks VCS non-git.7> Isolez les sessions Claude Code parallèles dans des git worktrees séparés pour que les modifications ne se heurtent pas. Couvre le flag `--worktree`, l'isolation des subagents, `.worktreeinclude`, le nettoyage et les hooks VCS non-git.

8 8 

9Un [git worktree](https://git-scm.com/docs/git-worktree) est un répertoire de travail séparé avec ses propres fichiers et branche, partageant le même historique de dépôt et la même télécommande que votre extraction principale. Exécuter chaque session Claude Code dans son propre worktree signifie que les modifications dans une session ne touchent jamais les fichiers d'une autre, vous pouvez donc avoir Claude construisant une fonctionnalité dans un terminal tout en corrigeant un bug dans un second.9Un [git worktree](https://git-scm.com/docs/git-worktree) est un répertoire de travail séparé avec ses propres fichiers et branche, partageant le même historique de dépôt et le même dépôt distant que votre extraction principale. Exécuter chaque session Claude Code dans son propre worktree lui donne une copie séparée des fichiers à modifier, de sorte qu'une session peut développer une fonctionnalité pendant qu'une seconde corrige un bug.

10 10 

11<Note>11<Note>

12 Les worktrees nécessitent un dépôt git ; pour les autres systèmes de contrôle de version, [configurez des hooks pour remplacer la logique git](#non-git-version-control). Dans l'[application de bureau](/docs/fr/desktop#work-in-parallel-with-sessions), sélectionnez l'option **worktree** quand vous démarrez une session pour lui donner son propre worktree.12 Les worktrees nécessitent un dépôt git ; pour les autres systèmes de contrôle de version, [configurez des hooks pour remplacer la logique git](#non-git-version-control). Dans l'[application de bureau](/docs/fr/desktop#work-in-parallel-with-sessions), sélectionnez l'option **worktree** quand vous démarrez une session pour lui donner son propre worktree.


104* **Redirections Git** : Claude Code bloque une commande Bash ou Monitor qui redirige git vers l'extraction principale. La redirection peut provenir de `git -C`, `--git-dir`, une variable `GIT_DIR` ou `GIT_WORK_TREE`, ou un `cd` dans l'extraction principale avant d'exécuter git.104* **Redirections Git** : Claude Code bloque une commande Bash ou Monitor qui redirige git vers l'extraction principale. La redirection peut provenir de `git -C`, `--git-dir`, une variable `GIT_DIR` ou `GIT_WORK_TREE`, ou un `cd` dans l'extraction principale avant d'exécuter git.

105* **Forme de la commande** : Claude Code bloque une commande Bash ou Monitor quand il ne peut pas vérifier à partir du texte de la commande que tout git que la commande exécute reste à l'intérieur du worktree. Cela se produit, par exemple, quand le nom de la commande est calculé à l'exécution, quand la syntaxe ne peut pas être analysée, ou quand une expansion telle que `${!name}` ou `${ command; }` pourrait exécuter une commande que le texte ne précise pas. Claude Code indique à Claude comment réécrire la commande refusée, par exemple en la divisant en commandes simples et séparées. Vous ne pouvez pas désactiver cette vérification.105* **Forme de la commande** : Claude Code bloque une commande Bash ou Monitor quand il ne peut pas vérifier à partir du texte de la commande que tout git que la commande exécute reste à l'intérieur du worktree. Cela se produit, par exemple, quand le nom de la commande est calculé à l'exécution, quand la syntaxe ne peut pas être analysée, ou quand une expansion telle que `${!name}` ou `${ command; }` pourrait exécuter une commande que le texte ne précise pas. Claude Code indique à Claude comment réécrire la commande refusée, par exemple en la divisant en commandes simples et séparées. Vous ne pouvez pas désactiver cette vérification.

106 106 

107Ces vérifications lisent le chemin ciblé par une modification, le répertoire dans lequel une commande s'exécute et le texte de la commande. Aucune d'elles ne suit les fichiers qu'une commande shell écrit, de sorte qu'une commande qui écrit dans l'extraction principale sans y exécuter git, comme `cp` ou une redirection shell, n'est pas refusée par celles-ci. Claude Code traite cette commande comme n'importe quelle autre commande shell : le fait qu'elle s'exécute ou qu'elle vous demande une permission dépend donc de votre [mode de permission](/docs/fr/permission-modes) et de vos règles.

108 

107Les vérifications s'appliquent au dépôt à partir duquel vous avez lancé Claude Code. Elles couvrent également l'extraction principale à laquelle un worktree lié est lié. Pour les commandes PowerShell, Claude Code applique uniquement la vérification du répertoire de travail.109Les vérifications s'appliquent au dépôt à partir duquel vous avez lancé Claude Code. Elles couvrent également l'extraction principale à laquelle un worktree lié est lié. Pour les commandes PowerShell, Claude Code applique uniquement la vérification du répertoire de travail.

108 110 

109Claude voit chaque refus comme une erreur d'outil qui nomme le worktree et dit comment procéder. Pour une commande refusée, consultez [ce que le message de refus signifie et comment le résoudre](/docs/fr/errors#command-blocked-by-the-worktree-isolation-checks).111Claude voit chaque refus comme une erreur d'outil qui nomme le worktree et dit comment procéder. Pour une commande refusée, consultez [ce que le message de refus signifie et comment le résoudre](/docs/fr/errors#command-blocked-by-the-worktree-isolation-checks).