144| [`permissions.allow`](#permissions-allow) | Approuver sans demande les [utilisations d'outils](https://code.claude.com/docs/fr/permissions.md#permission-rule-syntax) listées | Paramètres de permission | Tout fichier |144| [`permissions.allow`](#permissions-allow) | Approuver sans demande les [utilisations d'outils](https://code.claude.com/docs/fr/permissions.md#permission-rule-syntax) listées | Paramètres de permission | Tout fichier |
145| [`permissions.ask`](#permissions-ask) | Toujours demander avant les [utilisations d'outils](https://code.claude.com/docs/fr/permissions.md#permission-rule-syntax) listées | Paramètres de permission | Tout fichier |145| [`permissions.ask`](#permissions-ask) | Toujours demander avant les [utilisations d'outils](https://code.claude.com/docs/fr/permissions.md#permission-rule-syntax) listées | Paramètres de permission | Tout fichier |
146| [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | Faire refuser par les outils de fichiers les lectures en dehors des [répertoires de travail](https://code.claude.com/docs/fr/permissions.md#working-directories), dans tous les modes de permission | Paramètres de permission | Tout fichier |146| [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | Faire refuser par les outils de fichiers les lectures en dehors des [répertoires de travail](https://code.claude.com/docs/fr/permissions.md#working-directories), dans tous les modes de permission | Paramètres de permission | Tout fichier |
147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Faire refuser par les outils `Write`, `Edit` et `NotebookEdit` les chemins situés en dehors des [répertoires de travail](https://code.claude.com/docs/fr/permissions.md#working-directories), dans tous les modes de permission, à l'exception de [certains fichiers propres à Claude Code](#what-the-write-block-refuses-and-what-stays-writable) | Paramètres de permission | Tout fichier |
147| [`permissions.defaultMode`](#permissions-defaultmode) | Définir le [mode de permission](https://code.claude.com/docs/fr/permission-modes.md#which-mode-a-session-starts-in) dans lequel démarrent les nouvelles sessions | Paramètres de permission | Tout fichier |148| [`permissions.defaultMode`](#permissions-defaultmode) | Définir le [mode de permission](https://code.claude.com/docs/fr/permission-modes.md#which-mode-a-session-starts-in) dans lequel démarrent les nouvelles sessions | Paramètres de permission | Tout fichier |
148| [`permissions.deny`](#permissions-deny) | Bloquer les [utilisations d'outils](https://code.claude.com/docs/fr/permissions.md#permission-rule-syntax) listées, y compris la lecture de fichiers contenant des secrets | Paramètres de permission | Tout fichier |149| [`permissions.deny`](#permissions-deny) | Bloquer les [utilisations d'outils](https://code.claude.com/docs/fr/permissions.md#permission-rule-syntax) listées, y compris la lecture de fichiers contenant des secrets | Paramètres de permission | Tout fichier |
149| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Empêcher quiconque d'entrer en [mode bypassPermissions](https://code.claude.com/docs/fr/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Paramètres de permission | Tout fichier |150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Empêcher quiconque d'entrer en [mode bypassPermissions](https://code.claude.com/docs/fr/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Paramètres de permission | Tout fichier |
663Pour plafonner l'effort d'un modèle plutôt que de définir son niveau, ajoutez un champ [`maxEffortLevel`](#maxeffortlevel) à l'entrée de ce modèle. Ce champ nécessite Claude Code v2.1.267 ou ultérieure.664Pour plafonner l'effort d'un modèle plutôt que de définir son niveau, ajoutez un champ [`maxEffortLevel`](#maxeffortlevel) à l'entrée de ce modèle. Ce champ nécessite Claude Code v2.1.267 ou ultérieure.
664 665
665* **Portée** : [`Any file`](#scopes)666* **Portée** : [`Any file`](#scopes)
666* **Type** : objet associant un nom de modèle à un objet comportant l'un des champs suivants :667* **Type** : objet associant un nom de modèle à un objet comportant un ou plusieurs des champs suivants :
667 * `effortLevel` : l'une des valeurs `"low"`, `"medium"`, `"high"` ou `"xhigh"`668 * `effortLevel` : l'une des valeurs `"low"`, `"medium"`, `"high"` ou `"xhigh"`
668 * [`maxEffortLevel`](#maxeffortlevel) : le niveau d'effort le plus élevé auquel le modèle peut s'exécuter669 * [`maxEffortLevel`](#maxeffortlevel) : le niveau d'effort le plus élevé auquel le modèle peut s'exécuter
669 * `autoCompactWindow` : un nombre de tokens de `100000` à `1000000`, ou `"auto"` pour la fenêtre adaptée au modèle. [`/autocompact`](https://code.claude.com/docs/fr/model-config#set-the-auto-compact-window) enregistre sa valeur ici. Pour ce modèle, la valeur a priorité sur un [`autoCompactWindow`](#autocompactwindow) de premier niveau dans le même fichier de paramètres. Nécessite Claude Code v2.1.288 ou ultérieure670 * `autoCompactWindow` : un nombre de tokens de `100000` à `1000000`, ou `"auto"` pour la fenêtre adaptée au modèle. [`/autocompact`](https://code.claude.com/docs/fr/model-config#set-the-auto-compact-window) enregistre sa valeur ici. Pour ce modèle, la valeur a priorité sur un [`autoCompactWindow`](#autocompactwindow) de premier niveau dans le même fichier de paramètres. Nécessite Claude Code v2.1.288 ou ultérieure
901Contrôlez quels outils Claude peut utiliser sans demander, lesquels invitent toujours, et lesquels sont bloqués, et définissez le [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) qu'une session démarre. Chaque clé `permissions.*` ci-dessous s'imbrique sous cet objet.902Contrôlez quels outils Claude peut utiliser sans demander, lesquels invitent toujours, et lesquels sont bloqués, et définissez le [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) qu'une session démarre. Chaque clé `permissions.*` ci-dessous s'imbrique sous cet objet.
902 903
903* **Portée** : [`Any file`](#scopes)904* **Portée** : [`Any file`](#scopes)
904* **Type** : objet avec `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `defaultMode`, `disableBypassPermissionsMode` et `disableAutoMode`905* **Type** : objet avec `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `disableBypassPermissionsMode` et `disableAutoMode`
905* **Défaut** : non défini906* **Défaut** : non défini
906 907
907Cet exemple approuve les commandes `npm run` sans demander, invite avant `git push`, bloque les lectures de `.env`, et démarre les sessions en `acceptEdits` :908Cet exemple approuve les commandes `npm run` sans demander, invite avant `git push`, bloque les lectures de `.env`, et démarre les sessions en `acceptEdits` :
1062}1063}
1063```1064```
1064 1065
1066Pour lever le blocage, supprimez la clé de chaque fichier de paramètres qui la définit, puis redémarrez chaque session en cours.
1067
1065Les répertoires que vous ajoutez avec `--add-dir`, `/add-dir` ou `additionalDirectories` dans vos paramètres utilisateur ou gérés comptent comme répertoires de travail pour le blocage. Les répertoires ajoutés uniquement dans les paramètres du dépôt ne comptent pas : ceux dans `.claude/settings.json`, et ceux dans `.claude/settings.local.json` sauf si git signale ce fichier comme non suivi. Dans un répertoire qui n'est pas un dépôt git, ou quand git suit le fichier, Claude Code traite `.claude/settings.local.json` comme des paramètres fournis par le dépôt, donc mettez les répertoires que vous voulez garder lisibles dans vos paramètres utilisateur à la place.1068Les répertoires que vous ajoutez avec `--add-dir`, `/add-dir` ou `additionalDirectories` dans vos paramètres utilisateur ou gérés comptent comme répertoires de travail pour le blocage. Les répertoires ajoutés uniquement dans les paramètres du dépôt ne comptent pas : ceux dans `.claude/settings.json`, et ceux dans `.claude/settings.local.json` sauf si git signale ce fichier comme non suivi. Dans un répertoire qui n'est pas un dépôt git, ou quand git suit le fichier, Claude Code traite `.claude/settings.local.json` comme des paramètres fournis par le dépôt, donc mettez les répertoires que vous voulez garder lisibles dans vos paramètres utilisateur à la place.
1066 1069
1067Quand [`autoMemoryDirectory`](#automemorydirectory) provient du `.claude/settings.json` du projet, ou d'un `.claude/settings.local.json` [traité comme fourni par le dépôt](https://code.claude.com/docs/fr/permissions.md#when-your-local-settings-file-needs-trust), Claude Code ne charge aucune [mémoire automatique](https://code.claude.com/docs/fr/memory.md#storage-location) de ce répertoire et n'en enregistre aucune.1070Quand [`autoMemoryDirectory`](#automemorydirectory) provient du `.claude/settings.json` du projet, ou d'un `.claude/settings.local.json` [traité comme fourni par le dépôt](https://code.claude.com/docs/fr/permissions.md#when-your-local-settings-file-needs-trust), Claude Code ne charge aucune [mémoire automatique](https://code.claude.com/docs/fr/memory.md#storage-location) de ce répertoire et n'en enregistre aucune.
1068 1071
1069Pour lever le blocage, supprimez la clé de chaque fichier de paramètres qui la définit, puis démarrez une nouvelle session.
1070
1071#### Commandes sandboxées sous le blocage1072#### Commandes sandboxées sous le blocage
1072 1073
1073Quand le [sandboxing](https://code.claude.com/docs/fr/sandboxing.md) est activé, le blocage couvre aussi les commandes sandboxées. Claude Code leur refuse l'accès en lecture à votre répertoire personnel et aux autres racines qui contiennent les fichiers utilisateur : `/Users`, `/home`, `/root`, `/Volumes`, `/mnt`, `/media`, `/run/media` et `/srv`. Il réouvre ensuite les répertoires de travail, les [worktrees](https://code.claude.com/docs/fr/worktrees.md) que Claude Code crée dans la session, le répertoire temporaire de la session, et les parties de `~/.claude` dont les commandes ont besoin, comme les skills et les plugins. Pendant que le blocage est en vigueur, les entrées `allowRead` et `allowWrite` des paramètres du dépôt ne comptent pas.1074Quand le [sandboxing](https://code.claude.com/docs/fr/sandboxing.md) est activé, le blocage couvre aussi les commandes sandboxées. Claude Code leur refuse l'accès en lecture à votre répertoire personnel et aux autres racines qui contiennent les fichiers utilisateur : `/Users`, `/home`, `/root`, `/Volumes`, `/mnt`, `/media`, `/run/media` et `/srv`. Il réouvre ensuite les répertoires de travail, les [worktrees](https://code.claude.com/docs/fr/worktrees.md) que Claude Code crée dans la session, le répertoire temporaire de la session, et les parties de `~/.claude` dont les commandes ont besoin, comme les skills et les plugins. Pendant que le blocage est en vigueur, les entrées `allowRead` et `allowWrite` des paramètres du dépôt ne comptent pas.
1092 1093
1093Si un fichier réouvert contient un secret, comme un jeton `http.extraHeader`, ajoutez son chemin à [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread). Une entrée `denyRead` qui couvre un fichier a toujours priorité sur cette réouverture.1094Si un fichier réouvert contient un secret, comme un jeton `http.extraHeader`, ajoutez son chemin à [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread). Une entrée `denyRead` qui couvre un fichier a toujours priorité sur cette réouverture.
1094 1095
1096### `permissions.blockWritesOutsideWorkingDirectories`
1097
1098Faites refuser par les outils `Write`, `Edit` et `NotebookEdit` les chemins en dehors de vos [répertoires de travail](https://code.claude.com/docs/fr/permissions.md#working-directories) dans chaque mode de permission, y compris `bypassPermissions`, à l'exception de [certains fichiers propres à Claude Code](#what-the-write-block-refuses-and-what-stays-writable). La clé ne limite pas les commandes shell, les outils MCP ni les programmes que les hooks exécutent. Pour limiter où les commandes shell écrivent, activez le [sandboxing](https://code.claude.com/docs/fr/sandboxing.md). Nécessite Claude Code v2.1.314 ou ultérieur.
1099
1100Une fois la clé activée, Claude Code supprime aussi les outils `EnterWorktree` et `ExitWorktree` ou refuse les appels à ceux-ci. Pour continuer à travailler dans des worktrees, suivez [Claude n'a pas d'outil `EnterWorktree`](https://code.claude.com/docs/fr/worktrees#claude-has-no-enterworktree-tool).
1101
1102* **Portée** : [`Any file`](#scopes). Un `true` dans n'importe quel fichier que la session charge s'applique, donc un dépôt peut activer le blocage pour lui-même mais ne peut pas lever le vôtre. Dans une [session cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md), Claude Code peut ne pas appliquer la clé, car les outils de fichiers s'exécutent dans un conteneur qui constitue lui-même la frontière.
1103* **Type** : Booléen
1104 * `true` : active le blocage
1105 * `false` : identique à non défini ; le blocage s'applique toujours si un autre fichier définit `true`
1106* **Défaut** : non défini, donc les écritures en dehors des répertoires de travail suivent votre [mode de permission](https://code.claude.com/docs/fr/permission-modes.md). Le blocage est aussi actif tant que Claude Code ne peut pas lire l'objet `permissions` dans vos [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md#keys-that-fail-closed).
1107
1108```json settings.json theme={null}
1109{
1110 "permissions": {
1111 "blockWritesOutsideWorkingDirectories": true
1112 }
1113}
1114```
1115
1116Pour tester le blocage, demandez à Claude d'utiliser l'outil Write pour créer un fichier en dehors de vos répertoires de travail, comme `~/block-test.txt` si votre répertoire personnel n'en fait pas partie. Claude Code refuse l'appel, et le refus indique que le [paramètre bloque les écritures en dehors des répertoires de travail](https://code.claude.com/docs/fr/errors.md#setting-blocks-writes-outside-the-working-directories).
1117
1118Pour lever le blocage, supprimez la clé de chaque fichier de paramètres qui la définit, puis redémarrez Claude Code.
1119
1120#### Ce que le blocage en écriture refuse et ce qui reste inscriptible
1121
1122Certains fichiers propres à Claude Code restent inscriptibles, comme les fichiers de plan, le [scratchpad](https://code.claude.com/docs/fr/claude-directory.md#session-scratchpad-directory), le répertoire `tmp` d'une [session en arrière-plan](https://code.claude.com/docs/fr/agent-view.md), et les fichiers `.md` de la [mémoire automatique](https://code.claude.com/docs/fr/memory.md#storage-location) de ce projet.
1123
1124En plus de vos propres fichiers en dehors des répertoires de travail, le blocage refuse les écritures vers :
1125
1126* **Les fichiers de paramètres de Claude Code** : Claude Code [refuse ces écritures](https://code.claude.com/docs/fr/errors.md#writes-to-claude-code-settings-files-are-blocked) à l'intérieur des répertoires de travail également, car un fichier de paramètres peut lever le blocage. Modifiez vous-même les fichiers de paramètres.
1127* **Un répertoire que seuls les paramètres du dépôt ajoutent** : un répertoire que [`additionalDirectories`](#permissions-additionaldirectories) liste uniquement dans `.claude/settings.json`, ou dans `.claude/settings.local.json` sauf si git signale ce fichier comme non suivi
1128* **Le worktree d'un sous-agent** : les modifications de fichiers d'un sous-agent [`isolation: worktree`](https://code.claude.com/docs/fr/worktrees#isolate-subagents-with-worktrees) sont refusées quand son worktree se trouve en dehors des répertoires de travail
1129* **La mémoire automatique dans un répertoire choisi par le dépôt** : un répertoire que [`autoMemoryDirectory`](#automemorydirectory) nomme dans les paramètres du dépôt
1130
1131Les fichiers de paramètres restent refusés quoi que vous ajoutiez. Pour laisser passer une écriture dans l'un des autres cas, [ajoutez un répertoire de travail](#let-one-directory-through-the-read-or-write-block). `/add-dir` nécessite un répertoire existant, donc indiquez le répertoire `.claude/worktrees` à la racine du dépôt pour les worktrees de sous-agents.
1132
1133#### Laisser passer un répertoire à travers le blocage en lecture ou en écriture
1134
1135Pour permettre à Claude d'atteindre un répertoire en dehors du projet pendant que `blockReadsOutsideWorkingDirectories` ou `blockWritesOutsideWorkingDirectories` vaut `true`, ajoutez-le comme répertoire de travail. Exécutez `/add-dir <directory>` dans la session, passez `--add-dir <directory>` au démarrage de Claude Code, ou listez-le sous `additionalDirectories` dans vos paramètres utilisateur ou gérés. Aucune [règle d'autorisation](https://code.claude.com/docs/fr/permissions.md#read-and-edit) ne permet aux outils de fichiers de Claude de franchir l'un ou l'autre blocage.
1136
1095### `permissions.defaultMode`1137### `permissions.defaultMode`
1096 1138
1097Définissez le [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) que les nouvelles sessions démarrent. Quand vous le laissez non défini, les sessions démarrent dans la [valeur par défaut intégrée](https://code.claude.com/docs/fr/permission-modes.md#which-mode-a-session-starts-in) pour votre surface.1139Définissez le [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) que les nouvelles sessions démarrent. Quand vous le laissez non défini, les sessions démarrent dans la [valeur par défaut intégrée](https://code.claude.com/docs/fr/permission-modes.md#which-mode-a-session-starts-in) pour votre surface.
2204 2246
2205## Mémoire et contexte2247## Mémoire et contexte
2206 2248
2207Contrôlez ce que Claude Code charge dans le contexte, comment il compacte et où il conserve la mémoire et les plans. Voir [Gérer le contexte](https://code.claude.com/docs/fr/context-window.md) et [Mémoire](https://code.claude.com/docs/fr/memory.md).2249Contrôlez ce que Claude Code charge dans le contexte, la façon dont il le compacte et l'endroit où il conserve la mémoire et les plans. Consultez [Gérer le contexte](https://code.claude.com/docs/fr/context-window.md) et [Mémoire](https://code.claude.com/docs/fr/memory.md).
2208 2250
2209### `autoCompactEnabled`2251### `autoCompactEnabled`
2210 2252
2211Faites en sorte que Claude Code [compacte la conversation automatiquement](https://code.claude.com/docs/fr/context-window.md#when-your-context-fills-up) lorsque le contexte approche de la limite. Apparaît dans `/config` sous **Auto-compact**, et le basculer là-bas écrit cette clé dans vos paramètres utilisateur.2253Demandez à Claude Code de [compacter la conversation automatiquement](https://code.claude.com/docs/fr/context-window.md#when-your-context-fills-up) lorsque le contexte approche de la limite. Apparaît dans `/config` sous le nom **Auto-compact**, et le basculer à cet endroit écrit cette clé dans vos paramètres utilisateur.
2212 2254
2213* **Scope** : [`Any file`](#scopes)2255* **Portée** : [`Any file`](#scopes)
2214* **Type** : Boolean2256* **Type** : booléen
2215 * `true` : Claude Code compacte la conversation automatiquement lorsque le contexte approche de la limite2257 * `true` : Claude Code compacte la conversation automatiquement lorsque le contexte approche de la limite
2216 * `false` : Claude Code ne compacte pas automatiquement2258 * `false` : Claude Code ne compacte pas automatiquement
2217* **Default** : `true`2259* **Valeur par défaut** : `true`
2218* **Per-session overrides** : [`DISABLE_AUTO_COMPACT`](https://code.claude.com/docs/fr/env-vars) désactive le compactage automatique pour une session ; celui des deux qui le désactive, l'autre ne peut pas le réactiver2260* **Remplacements par session** : [`DISABLE_AUTO_COMPACT`](https://code.claude.com/docs/fr/env-vars) désactive la compaction automatique pour une session ; quel que soit celui des deux qui la désactive, l'autre ne peut pas la réactiver
2219 2261
2220```json settings.json theme={null}2262```json settings.json theme={null}
2221{2263{
2223}2265}
2224```2266```
2225 2267
2226La commande manuelle `/compact` continue de fonctionner tandis que la compaction automatique est désactivée. Si vous désactivez la compaction automatique, la [compaction en cas d'inactivité](#idlecompaction) est également désactivée.2268La commande manuelle `/compact` continue de fonctionner lorsque la compaction automatique est désactivée. Si vous désactivez la compaction automatique, la [compaction en cas d'inactivité](#idlecompaction) est également désactivée.
2227 2269
2228### `autoCompactWindow`2270### `autoCompactWindow`
2229 2271
2230Définissez le remplissage du contexte avant que Claude Code [compacte automatiquement](https://code.claude.com/docs/fr/context-window.md#when-your-context-fills-up).2272Définissez le niveau de remplissage de la fenêtre de contexte à partir duquel Claude Code [compacte automatiquement](https://code.claude.com/docs/fr/context-window.md#when-your-context-fills-up).
2231 2273
2232* **Scope** : [`Any file`](#scopes)2274* **Portée** : [`Any file`](#scopes)
2233* **Type** : nombre de tokens, de `100000` à `1000000`. Claude Code plafonne la valeur à la fenêtre de contexte de votre modèle ; l'[aperçu des modèles](https://platform.claude.com/docs/en/about-claude/models/overview) répertorie la fenêtre de chaque modèle2275* **Type** : nombre de tokens, de `100000` à `1000000`. Claude Code plafonne la valeur à la fenêtre de contexte de votre modèle ; la [vue d'ensemble des modèles](https://platform.claude.com/docs/en/about-claude/models/overview) indique la fenêtre de chaque modèle
2234* **Default** : non défini, donc Claude Code choisit une fenêtre adaptée à votre modèle2276* **Valeur par défaut** : non définie, Claude Code choisit donc une fenêtre adaptée à votre modèle
2235* **Per-session overrides** : [`--autocompact`](https://code.claude.com/docs/fr/cli-reference#cli-flags) a la priorité sur cette clé pour une session, et [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/fr/env-vars) a la priorité sur les deux, sauf si Claude Code [ignore la valeur de la variable](https://code.claude.com/docs/fr/model-config.md#claude_code_auto_compact_window-values)2277* **Remplacements par session** : [`--autocompact`](https://code.claude.com/docs/fr/cli-reference#cli-flags) a priorité sur cette clé pour une session, et [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/fr/env-vars) a priorité sur les deux, sauf si Claude Code [ignore la valeur de la variable](https://code.claude.com/docs/fr/model-config.md#claude_code_auto_compact_window-values)
2236 2278
2237```json settings.json theme={null}2279```json settings.json theme={null}
2238{2280{
2240}2282}
2241```2283```
2242 2284
2243La commande [`/autocompact`](https://code.claude.com/docs/fr/commands#all-commands) enregistre une fenêtre pour le modèle actuel sous [`modelSettings`](#modelsettings), qui a la priorité sur cette clé dans le même fichier pour ce modèle. [Définir la fenêtre de compaction automatique](https://code.claude.com/docs/fr/model-config.md#set-the-auto-compact-window) explique comment la commande, le flag, la variable et le paramètre interagissent.2285La commande [`/autocompact`](https://code.claude.com/docs/fr/commands#all-commands) enregistre une fenêtre pour le modèle actuel sous [`modelSettings`](#modelsettings), qui a priorité sur cette clé dans le même fichier pour ce modèle. [Définir la fenêtre de compaction automatique](https://code.claude.com/docs/fr/model-config.md#set-the-auto-compact-window) explique comment la commande, le flag, la variable et le paramètre interagissent.
2244 2286
2245### `autoMemoryDirectory`2287### `autoMemoryDirectory`
2246 2288
2247Stockez la [mémoire automatique](https://code.claude.com/docs/fr/memory.md#storage-location) dans un répertoire de votre choix au lieu de la valeur par défaut par projet.2289Stockez la [mémoire automatique](https://code.claude.com/docs/fr/memory.md#storage-location) dans le répertoire de votre choix au lieu du répertoire par défaut propre à chaque projet.
2248 2290
2249* **Scope** : [`Any file`](#scopes)2291* **Portée** : [`Any file`](#scopes)
2250* **Type** : string, un chemin de répertoire absolu ou préfixé par `~/`2292* **Type** : chaîne, un chemin de répertoire absolu ou préfixé par `~/`
2251* **Default** : non défini, donc Claude Code utilise `~/.claude/projects/<project>/memory/`2293* **Valeur par défaut** : non définie, Claude Code utilise donc `~/.claude/projects/<project>/memory/`
2252 2294
2253```json settings.json theme={null}2295```json settings.json theme={null}
2254{2296{
2256}2298}
2257```2299```
2258 2300
2259À partir des paramètres de projet ou locaux, Claude Code honore cette clé selon la même [règle de confiance d'espace de travail que les hooks](https://code.claude.com/docs/fr/permissions.md#what-runs-before-you-trust-a-folder), car un référentiel cloné peut fournir ces fichiers.2301Depuis les paramètres de projet ou locaux, Claude Code respecte cette clé selon la même [règle de confiance de l'espace de travail que les hooks](https://code.claude.com/docs/fr/permissions.md#what-runs-before-you-trust-a-folder), puisqu'un dépôt cloné peut fournir ces fichiers.
2260 2302
2261### `autoMemoryEnabled`2303### `autoMemoryEnabled`
2262 2304
2263Activez ou désactivez la [mémoire automatique](https://code.claude.com/docs/fr/memory.md#enable-or-disable-auto-memory). Lorsque `false`, Claude ne lit pas et n'écrit pas dans le répertoire de mémoire automatique. Vous pouvez également le basculer avec `/memory` pendant une session, ce qui écrit cette clé dans vos paramètres utilisateur.2305Activez ou désactivez la [mémoire automatique](https://code.claude.com/docs/fr/memory.md#enable-or-disable-auto-memory). Avec `false`, Claude ne lit ni n'écrit dans le répertoire de mémoire automatique. Vous pouvez également la basculer avec `/memory` pendant une session, ce qui écrit cette clé dans vos paramètres utilisateur.
2264 2306
2265* **Scope** : [`Any file`](#scopes)2307* **Portée** : [`Any file`](#scopes)
2266* **Type** : Boolean2308* **Type** : booléen
2267 * `true` : identique à non défini ; la mémoire automatique reste activée sauf si quelque chose qui surclasse cette clé la désactive pour la session, comme `--bare`, le mode sécurisé ou `CLAUDE_CODE_DISABLE_AUTO_MEMORY`2309 * `true` : équivaut à une valeur non définie ; la mémoire automatique reste activée, sauf si un élément prioritaire sur cette clé la désactive pour la session, comme `--bare`, le mode sans échec ou `CLAUDE_CODE_DISABLE_AUTO_MEMORY`
2268 * `false` : Claude ne lit pas et n'écrit pas dans le répertoire de mémoire automatique2310 * `false` : Claude ne lit ni n'écrit dans le répertoire de mémoire automatique
2269* **Default** : `true`2311* **Valeur par défaut** : `true`
2270* **Per-session overrides** : [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](https://code.claude.com/docs/fr/env-vars) a la priorité sur cette clé pour une session, dans les deux sens2312* **Remplacements par session** : [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](https://code.claude.com/docs/fr/env-vars) a priorité sur cette clé pour une session, dans un sens comme dans l'autre
2271 2313
2272```json settings.json theme={null}2314```json settings.json theme={null}
2273{2315{
2277 2319
2278### `bashOutputMaxChars`2320### `bashOutputMaxChars`
2279 2321
2280Définissez le nombre de caractères de la [sortie d'une commande Bash ou PowerShell réussie que Claude reçoit en ligne](https://code.claude.com/docs/fr/tools-reference.md#output-limits). Lorsque la sortie dépasse la limite, Claude Code l'enregistre dans un fichier et Claude reçoit un court aperçu plus le chemin du fichier. Augmentez la limite lorsque la sortie de commande, comme une compilation détaillée ou un journal complet de suite de tests, dépasse régulièrement la valeur par défaut et que vous souhaitez que Claude la lise sans ouvrir le fichier. Nécessite Claude Code v2.1.261 ou ultérieur.2322Définissez le nombre de caractères de la [sortie d'une commande Bash ou PowerShell réussie que Claude reçoit directement](https://code.claude.com/docs/fr/tools-reference.md#output-limits). Lorsque la sortie dépasse la limite, Claude Code l'enregistre dans un fichier et Claude reçoit un court aperçu ainsi que le chemin du fichier. Augmentez la limite lorsque la sortie des commandes, comme un build verbeux ou le log complet d'une suite de tests, dépasse régulièrement la valeur par défaut et que vous souhaitez que Claude la lise sans ouvrir le fichier. Nécessite Claude Code v2.1.261 ou une version ultérieure.
2281 2323
2282* **Scope** : [`Any file`](#scopes)2324* **Portée** : [`Any file`](#scopes)
2283* **Type** : nombre de caractères, un entier positif. Claude Code limite la valeur à la plage `4000` à `128000`2325* **Type** : nombre de caractères, un entier positif. Claude Code ramène la valeur dans la plage `4000` à `128000`
2284* **Default** : non défini, donc Claude reçoit jusqu'à 30 000 caractères en ligne2326* **Valeur par défaut** : non définie, Claude reçoit donc jusqu'à 30 000 caractères directement
2285 2327
2286```json settings.json theme={null}2328```json settings.json theme={null}
2287{2329{
2293 2335
2294### `claudeMd`2336### `claudeMd`
2295 2337
2296Injectez les instructions de style CLAUDE.md en tant que mémoire gérée par l'organisation sans déployer un fichier séparé. Claude Code charge le texte en tant qu'entrée de mémoire gérée avant les fichiers CLAUDE.md utilisateur et projet.2338Injectez des instructions de type CLAUDE.md en tant que mémoire gérée par l'organisation, sans déployer de fichier distinct. Claude Code charge le texte comme une entrée de mémoire gérée, avant les fichiers CLAUDE.md utilisateur et de projet.
2297 2339
2298* **Scope** : [`Managed`](#scopes)2340* **Portée** : [`Managed`](#scopes)
2299* **Type** : string, le texte d'un fichier CLAUDE.md ; écrivez-le comme vous le feriez pour le fichier, Markdown inclus, avec les sauts de ligne comme `\n`2341* **Type** : chaîne, le texte d'un fichier CLAUDE.md ; rédigez-le comme vous le feriez pour le fichier, Markdown compris, avec les sauts de ligne sous la forme `\n`
2300* **Default** : non défini2342* **Valeur par défaut** : non définie
2301 2343
2302Cet exemple déploie deux règles sous forme de courte liste Markdown :2344Cet exemple déploie deux règles sous la forme d'une courte liste Markdown :
2303 2345
2304```json managed-settings.json theme={null}2346```json managed-settings.json theme={null}
2305{2347{
2307}2349}
2308```2350```
2309 2351
2310Voir [Déployer CLAUDE.md à l'échelle de l'organisation](https://code.claude.com/docs/fr/memory.md#deploy-organization-wide-claude-md).2352Consultez [Déployer un CLAUDE.md à l'échelle de l'organisation](https://code.claude.com/docs/fr/memory.md#deploy-organization-wide-claude-md).
2311 2353
2312### `claudeMdExcludes`2354### `claudeMdExcludes`
2313 2355
2314Ignorez les fichiers `CLAUDE.md` spécifiques lorsque Claude Code charge la [mémoire](https://code.claude.com/docs/fr/memory.md#exclude-specific-claude-md-files). Dans un grand monorepo, utilisez-le pour ignorer les fichiers CLAUDE.md d'autres équipes qui ne sont pas pertinents pour votre travail ; [Exclure les fichiers CLAUDE.md non pertinents](https://code.claude.com/docs/fr/large-codebases.md#exclude-irrelevant-claude-md-files) dans le guide des grands codebases explique ce cas. Les motifs correspondent aux chemins de fichiers absolus.2356Ignorez certains fichiers `CLAUDE.md` lorsque Claude Code charge la [mémoire](https://code.claude.com/docs/fr/memory.md#exclude-specific-claude-md-files). Dans un grand monorepo, utilisez-la pour ignorer les fichiers CLAUDE.md d'autres équipes qui ne concernent pas votre travail ; la section [Exclure les fichiers CLAUDE.md non pertinents](https://code.claude.com/docs/fr/large-codebases.md#exclude-irrelevant-claude-md-files) du guide sur les grandes bases de code détaille ce cas. Les motifs sont comparés aux chemins de fichiers absolus.
2315 2357
2316* **Scope** : [`Any file`](#scopes)2358* **Portée** : [`Any file`](#scopes)
2317* **Type** : array of strings, chacun un motif glob ou un chemin absolu2359* **Type** : tableau de chaînes, chacune étant un motif glob ou un chemin absolu
2318* **Default** : non défini, donc Claude Code charge chaque CLAUDE.md qu'il trouve2360* **Valeur par défaut** : non définie, Claude Code charge donc chaque CLAUDE.md qu'il trouve
2319 2361
2320```json settings.json theme={null}2362```json settings.json theme={null}
2321{2363{
2323}2365}
2324```2366```
2325 2367
2326Les exclusions s'appliquent uniquement aux fichiers de mémoire utilisateur, projet et local ; les fichiers CLAUDE.md de politique gérée ne peuvent pas être exclus.2368Les exclusions s'appliquent uniquement aux fichiers de mémoire utilisateur, de projet et locaux ; les fichiers CLAUDE.md de politique gérée ne peuvent pas être exclus.
2327 2369
2328### `env`2370### `env`
2329 2371
2330Définissez les variables d'environnement pour chaque session et pour les sous-processus que Claude Code démarre à partir de celle-ci. Toute variable dans la [référence des variables d'environnement](https://code.claude.com/docs/fr/env-vars.md) peut aller ici, ce qui est comment vous l'appliquez à chaque session ou la déployez à votre équipe. Les paramètres de projet et locaux ne peuvent pas définir [certaines d'entre elles](#variables-claude-code-ignores-in-env).2372Définissez des variables d'environnement pour chaque session et pour les sous-processus que Claude Code lance depuis celle-ci. La plupart des variables de la [référence des variables d'environnement](https://code.claude.com/docs/fr/env-vars.md) peuvent être placées ici, ce qui vous permet d'en appliquer une à chaque session ou de la déployer auprès de votre équipe. Les paramètres de projet et locaux ne peuvent pas définir [certaines d'entre elles](#variables-claude-code-ignores-in-env).
2331 2373
2332* **Scope** : [`Any file`](#scopes)2374* **Portée** : [`Any file`](#scopes)
2333* **Type** : object mapping variable names to string values2375* **Type** : objet associant des noms de variables à des valeurs de type chaîne
2334* **Default** : non défini2376* **Valeur par défaut** : non définie
2335 2377
2336Cet exemple désactive le compactage automatique et achemine les demandes d'API via un proxy :2378Cet exemple désactive la compaction automatique et fait transiter les requêtes API par un proxy :
2337 2379
2338```json settings.json theme={null}2380```json settings.json theme={null}
2339{2381{
2344}2386}
2345```2387```
2346 2388
2347#### Comment les valeurs `env` interagissent avec votre shell2389#### Interaction des valeurs `env` avec votre shell
2348 2390
2349* Une valeur ici écrase la même variable exportée dans votre shell, et lorsque plus d'un fichier de paramètres définit une variable, celle avec la [plus haute priorité](https://code.claude.com/docs/fr/settings.md#settings-precedence) s'applique. [Variables que Claude Code ignore dans `env`](#variables-claude-code-ignores-in-env) répertorie les exceptions pour les paramètres de projet et locaux.2391* Une valeur définie ici remplace la même variable exportée dans votre shell, et lorsque plusieurs fichiers de paramètres définissent une variable, c'est celui ayant la [priorité la plus élevée](https://code.claude.com/docs/fr/settings.md#settings-precedence) qui s'applique. [Variables que Claude Code ignore dans `env`](#variables-claude-code-ignores-in-env) répertorie les exceptions pour les paramètres de projet et locaux.
2350* Lorsque l'application Claude Desktop ou un [environnement auto-hébergé](https://code.claude.com/docs/fr/self-hosted-environments) démarre la session, l'environnement de lancement qu'il construit a la priorité à la place : Claude Code ignore une valeur `env` de n'importe quel fichier de paramètres pour une variable que l'environnement de lancement a déjà définie. Le [journal de débogage](https://code.claude.com/docs/fr/debug-your-config.md) nomme chaque variable ignorée.2392* Lorsque l'application Claude Desktop ou un runner d'[environnement auto-hébergé](https://code.claude.com/docs/fr/self-hosted-environments) démarre la session, c'est l'environnement de lancement qu'il construit qui a priorité : Claude Code ignore une valeur `env` provenant de n'importe quel fichier de paramètres pour une variable que l'environnement de lancement définit déjà. Le [log de débogage](https://code.claude.com/docs/fr/debug-your-config.md) nomme chaque variable ignorée.
2351* Pour annuler une exportation de shell, définissez la variable sur `""`. Claude Code traite une valeur vide comme non définie pour la sélection du fournisseur, et les sous-processus héritent de la valeur vide.2393* Pour annuler un export du shell, définissez la variable sur `""`. Claude Code traite une valeur vide comme non définie pour la sélection du fournisseur, et les sous-processus héritent de la valeur vide.
2352* `NO_COLOR` et `FORCE_COLOR` définis ici ne parviennent qu'aux sous-processus. Pour modifier les couleurs de l'interface de Claude Code lui-même, définissez-les dans votre shell avant de lancer `claude`.2394* `NO_COLOR` et `FORCE_COLOR` définies ici n'atteignent que les sous-processus. Pour modifier les couleurs de l'interface de Claude Code elle-même, définissez-les dans votre shell avant de lancer `claude`.
2353* Les valeurs ici sont du texte brut dans le fichier de paramètres et parviennent à chaque sous-processus que Claude Code démarre. Pour un jeton porteur OTLP qui tourne, utilisez [`otelHeadersHelper`](#otelheadershelper) ; pour les identifiants d'API, utilisez [`apiKeyHelper`](#apikeyhelper).2395* Les valeurs définies ici sont en texte brut dans le fichier de paramètres et atteignent chaque sous-processus que Claude Code lance. Pour un jeton bearer OTLP soumis à rotation, utilisez [`otelHeadersHelper`](#otelheadershelper) ; pour les identifiants d'API, utilisez [`apiKeyHelper`](#apikeyhelper).
2354 2396
2355#### Quand Claude Code applique les valeurs `env`2397#### Quand Claude Code applique les valeurs `env`
2356 2398
2357* À partir des paramètres utilisateur, `--settings` et des paramètres gérés : au démarrage, et à nouveau dans la session en cours lorsqu'une modification enregistrée modifie le `env` fusionné.2399* Depuis les paramètres utilisateur, `--settings` et les paramètres gérés : au démarrage, puis de nouveau dans la session en cours lorsqu'une modification enregistrée change le `env` fusionné.
2358* À partir des paramètres de projet et locaux : après avoir approuvé l'espace de travail, ou au démarrage en mode `-p`, qui n'affiche jamais la boîte de dialogue de confiance, et à nouveau lorsqu'une modification enregistrée modifie le `env` fusionné.2400* Depuis les paramètres de projet et locaux : après que vous avez fait confiance à l'espace de travail, ou au démarrage en mode `-p`, qui n'affiche jamais la boîte de dialogue de confiance, puis de nouveau lorsqu'une modification enregistrée change le `env` fusionné.
2359* Les variables que Claude Code classe comme sûres, telles que la sélection du modèle, les délais d'attente et les limites, et les basculements de fonctionnalités : au démarrage à partir de chaque fichier de paramètres, à l'exception des [variables que les paramètres de projet et locaux ne peuvent pas définir](#variables-claude-code-ignores-in-env).2401* Variables que Claude Code classe comme sûres, telles que la sélection du modèle, les délais d'expiration et limites, et les bascules de fonctionnalités : au démarrage depuis chaque fichier de paramètres, à l'exception des [variables que les paramètres de projet et locaux ne peuvent pas définir](#variables-claude-code-ignores-in-env).
2360* Après avoir [déplacé la session avec `/cd`](https://code.claude.com/docs/fr/permissions#move-the-session-to-another-directory) sur v2.1.246 ou ultérieur : les valeurs `env` du nouveau répertoire du projet et locales, en plus de celles du répertoire précédent.2402* Après avoir [déplacé la session avec `/cd`](https://code.claude.com/docs/fr/permissions#move-the-session-to-another-directory) sur v2.1.246 ou une version ultérieure : les valeurs `env` de projet et locales du nouveau répertoire, en plus de celles du répertoire précédent.
2361 2403
2362#### Variables que Claude Code ignore dans `env`2404#### Variables que Claude Code ignore dans `env`
2363 2405
2364* Les paramètres de projet et locaux ne peuvent pas définir les variables qu'un dépôt extrait ne devrait pas contrôler ; définissez-les plutôt dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Claude Code supprime chacune d'elles, à l'exception de quelques valeurs qui désactivent la télémétrie, et consigne un avertissement que vous pouvez voir avec `claude --debug`. Elles incluent :2406* Les paramètres de projet et locaux ne peuvent pas définir les variables qu'un dépôt extrait ne devrait pas contrôler ; définissez-les plutôt dans votre shell, vos paramètres utilisateur ou les paramètres gérés. Claude Code écarte chacune d'elles, à l'exception de quelques valeurs qui désactivent la télémétrie, et consigne un avertissement que vous pouvez voir avec `claude --debug`. Elles comprennent :
2365 2407
2366 * Les variables qui choisissent où Claude Code stocke ou écrit ses propres fichiers : `CLAUDE_CONFIG_DIR`, `CLAUDE_CODE_TMPDIR` et les variables de répertoire du système d'exploitation telles que `HOME`, `TMPDIR`, `TMP`, `TEMP` et la famille `XDG_*`.2408 * Les variables qui déterminent l'endroit où Claude Code stocke ou écrit ses propres fichiers : `CLAUDE_CONFIG_DIR`, `CLAUDE_CODE_TMPDIR`, et les variables de répertoire du système d'exploitation comme `HOME`, `TMPDIR`, `TMP`, `TEMP` et la famille `XDG_*`.
2367 * Les variables Windows qui choisissent les programmes et la configuration à l'échelle de la machine pour les processus que Claude Code démarre, telles que `SystemRoot`, `ComSpec`, `ProgramData`, `LOCALAPPDATA`, `PATHEXT`, `PSModulePath` et la famille `ProgramFiles`.2409 * Les variables Windows qui choisissent les programmes et la configuration à l'échelle de la machine pour les processus que Claude Code lance, comme `SystemRoot`, `ComSpec`, `ProgramData`, `LOCALAPPDATA`, `PATHEXT`, `PSModulePath` et la famille `ProgramFiles`.
2368 * Les variables qui exportent le contenu de la session : [`OTEL_LOG_RAW_API_BODIES`](https://code.claude.com/docs/fr/env-vars#variables) et la paire de traçage bêta détaillée `ENABLE_BETA_TRACING_DETAILED` et `BETA_TRACING_ENDPOINT`.2410 * Les variables qui exportent le contenu de la session : [`OTEL_LOG_RAW_API_BODIES`](https://code.claude.com/docs/fr/env-vars#variables) et la paire de traçage bêta détaillé `ENABLE_BETA_TRACING_DETAILED` et `BETA_TRACING_ENDPOINT`.
2369 * Les variables [OpenTelemetry exporter](https://code.claude.com/docs/fr/monitoring-usage.md) qui activent la télémétrie, choisissent où elle va ou choisissent quel contenu elle capture :2411 * Les variables de l'[exportateur OpenTelemetry](https://code.claude.com/docs/fr/monitoring-usage.md) qui activent la télémétrie, choisissent sa destination ou choisissent le contenu qu'elle capture :
2370 2412
2371 * `CLAUDE_CODE_ENABLE_TELEMETRY`, plus la paire de télémétrie améliorée bêta `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` et `ENABLE_ENHANCED_TELEMETRY_BETA`2413 * `CLAUDE_CODE_ENABLE_TELEMETRY`, ainsi que la paire bêta de télémétrie améliorée `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` et `ENABLE_ENHANCED_TELEMETRY_BETA`
2372 * Les sélecteurs d'exportateur `OTEL_LOGS_EXPORTER`, `OTEL_METRICS_EXPORTER` et `OTEL_TRACES_EXPORTER`2414 * Les sélecteurs d'exportateur `OTEL_LOGS_EXPORTER`, `OTEL_METRICS_EXPORTER` et `OTEL_TRACES_EXPORTER`
2373 * Les variables de contenu `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_ASSISTANT_RESPONSES`, `OTEL_LOG_TOOL_CONTENT` et `OTEL_LOG_TOOL_DETAILS`2415 * Les variables de contenu `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_ASSISTANT_RESPONSES`, `OTEL_LOG_TOOL_CONTENT` et `OTEL_LOG_TOOL_DETAILS`
2374 * Les variables `OTEL_EXPORTER_OTLP_*` dont les noms se terminent par `_ENDPOINT`, `_HEADERS`, `_PROTOCOL`, `_CERTIFICATE`, `_CLIENT_KEY` ou `_INSECURE`, dans les formes génériques et par signal, telles que `OTEL_EXPORTER_OTLP_ENDPOINT` et `OTEL_EXPORTER_OTLP_METRICS_HEADERS`2416 * Les variables `OTEL_EXPORTER_OTLP_*` dont le nom se termine par `_ENDPOINT`, `_HEADERS`, `_PROTOCOL`, `_CERTIFICATE`, `_CLIENT_KEY` ou `_INSECURE`, sous leurs formes générique et par signal, comme `OTEL_EXPORTER_OTLP_ENDPOINT` et `OTEL_EXPORTER_OTLP_METRICS_HEADERS`
2375 * `OTEL_EXPORTER_PROMETHEUS_HOST` et `OTEL_EXPORTER_PROMETHEUS_PORT`2417 * `OTEL_EXPORTER_PROMETHEUS_HOST` et `OTEL_EXPORTER_PROMETHEUS_PORT`
2376 2418
2377 Seules ces valeurs s'appliquent toujours à partir des paramètres de projet et locaux, car elles désactivent quelque chose : `none` pour les trois sélecteurs d'exportateur, et une valeur désactivée telle que `0` pour `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_CONTENT` et `OTEL_LOG_TOOL_DETAILS`. Une telle valeur remplace la même variable dans vos paramètres utilisateur, mais pas celle que l'environnement à partir duquel vous lancez Claude Code, un fichier `--settings` ou les paramètres gérés définissent.2419 Seules ces valeurs s'appliquent encore depuis les paramètres de projet et locaux, car elles désactivent quelque chose : `none` pour les trois sélecteurs d'exportateur, et une valeur de désactivation comme `0` pour `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_CONTENT` et `OTEL_LOG_TOOL_DETAILS`. Une telle valeur remplace la même variable dans vos paramètres utilisateur, mais pas celle définie par l'environnement depuis lequel vous démarrez Claude Code, par un fichier `--settings` ou par les paramètres gérés.
2378 2420
2379 Lorsqu'un fichier de paramètres de projet ou locaux définit une variable dans ce groupe, une session interactive locale affiche un avis au démarrage. Exécutez `/status` ou `claude doctor` pour voir lesquels Claude Code a ignorés et lesquels ont désactivé la télémétrie ; les deux répertorient les noms, jamais les valeurs. Une exécution non interactive avec `-p` ou une session Agent SDK n'affiche aucun avis, donc vérifiez que votre collecteur reçoit toujours des données après la mise à niveau. S'il ne le fait pas, définissez les variables dans vos paramètres utilisateur, paramètres gérés, l'environnement du travail ou un fichier que vous transmettez avec `--settings`.2421 Lorsqu'un fichier de paramètres de projet ou local définit une variable de ce groupe, une session interactive locale affiche un avis au démarrage. Exécutez `/status` ou `claude doctor` pour voir celles que Claude Code a ignorées et celles qui ont désactivé la télémétrie ; les deux affichent les noms, jamais les valeurs. Une exécution non interactive avec `-p` ou une session Agent SDK n'affiche aucun avis ; vérifiez donc que votre collecteur reçoit toujours des données après la mise à niveau. Si ce n'est pas le cas, définissez les variables dans vos paramètres utilisateur, les paramètres gérés, l'environnement du job ou un fichier que vous transmettez avec `--settings`.
2380 2422
2381 Ignorer ce groupe dans les paramètres de projet et locaux nécessite Claude Code v2.1.282 ou ultérieur.2423 L'ignorance de ce groupe dans les paramètres de projet et locaux nécessite Claude Code v2.1.282 ou une version ultérieure.
2382 * Les variables qui changent la façon dont Claude Code démarre ou se synchronise, telles que `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` et `CLAUDE_CODE_PLUGIN_SEED_DIR`.2424 * Les variables qui modifient la façon dont Claude Code démarre ou se synchronise, comme `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` et `CLAUDE_CODE_PLUGIN_SEED_DIR`.
2383 * La variable du [mode lecteur d'écran](https://code.claude.com/docs/fr/accessibility.md) `CLAUDE_AX_SCREEN_READER` et les autres variables dont les noms commencent par `CLAUDE_AX_`, telles que [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/fr/env-vars#variables).2425 * La variable du [mode lecteur d'écran](https://code.claude.com/docs/fr/accessibility.md) `CLAUDE_AX_SCREEN_READER` et les autres variables dont le nom commence par `CLAUDE_AX_`, comme [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/fr/env-vars#variables).
2384 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/fr/env-vars#variables), qui définit le minuteur d'une boîte de dialogue sans réponse.2426 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/fr/env-vars#variables), qui définit le minuteur d'une boîte de dialogue restée sans réponse.
2385 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/fr/env-vars#variables), qui désactive le traitement des pièces jointes.2427 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/fr/env-vars#variables), qui désactive le traitement des pièces jointes.
2386 * [`CLAUDE_CODE_DISABLE_FILE_MENTIONS`](https://code.claude.com/docs/fr/env-vars#variables), qui empêche Claude Code de développer les mentions `@` de fichiers et de répertoires.2428 * [`CLAUDE_CODE_DISABLE_FILE_MENTIONS`](https://code.claude.com/docs/fr/env-vars#variables), qui empêche Claude Code de développer les mentions `@` de fichiers et de répertoires.
2387 2429
2388 Avant v2.1.251, les paramètres de projet et locaux pouvaient également définir les variables de cette liste qui choisissent où Claude Code écrit ses fichiers ou qui exportent le contenu de la session, sauf `HOME` et `XDG_CONFIG_HOME`. Avant v2.1.290, ils pouvaient également définir les variables de minuteur de boîte de dialogue et `CLAUDE_CODE_DISABLE_ATTACHMENTS`.2430 Avant v2.1.251, les paramètres de projet et locaux pouvaient également définir les variables de cette liste qui choisissent l'endroit où Claude Code écrit ses fichiers ou qui exportent le contenu de la session, à l'exception de `HOME` et `XDG_CONFIG_HOME`. Avant v2.1.290, ils pouvaient également définir les variables de minuteur de boîte de dialogue et `CLAUDE_CODE_DISABLE_ATTACHMENTS`.
2389* Les variables d'identité que les environnements d'hébergement de Claude Code possèdent, telles que `CLAUDE_CODE_REMOTE` et `CLAUDE_CODE_ACCOUNT_UUID`, sont ignorées de chaque fichier.2431* Les variables d'identité propres aux environnements d'hébergement de Claude Code, comme `CLAUDE_CODE_REMOTE` et `CLAUDE_CODE_ACCOUNT_UUID`, sont ignorées depuis tous les fichiers.
2390* [`CLAUDE_CODE_MESSAGING_SOCKET` et `CLAUDE_CODE_MESSAGING_TOKEN`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code exporte lui-même, sont ignorées de chaque fichier. Ignorer la variable de socket nécessite Claude Code v2.1.224 ou ultérieur, et ignorer le jeton nécessite v2.1.228 ou ultérieur.2432* [`CLAUDE_CODE_MESSAGING_SOCKET` et `CLAUDE_CODE_MESSAGING_TOKEN`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code exporte lui-même, sont ignorées depuis tous les fichiers. L'ignorance de la variable de socket nécessite Claude Code v2.1.224 ou une version ultérieure, et celle du jeton nécessite v2.1.228 ou une version ultérieure.
2391* [`CLAUDE_CODE_PROJECT_DIR_NAME`](https://code.claude.com/docs/fr/sessions#name-the-project-directory-yourself), que Claude Code lit uniquement à partir de l'environnement de lancement, est ignorée de chaque fichier ; nécessite v2.1.234 ou ultérieur.2433* [`CLAUDE_CODE_PROJECT_DIR_NAME`](https://code.claude.com/docs/fr/sessions#name-the-project-directory-yourself), que Claude Code lit uniquement depuis l'environnement de lancement, est ignorée depuis tous les fichiers ; nécessite v2.1.234 ou une version ultérieure.
2392* [`CLAUDE_CODE_RESTRICTED`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, est ignorée de chaque fichier.2434* [`CLAUDE_CODE_RESTRICTED`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code lit uniquement depuis l'environnement de lancement, est ignorée depuis tous les fichiers.
2393* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, est ignorée de chaque fichier. La variable nécessite Claude Code v2.1.283 ou ultérieur.2435* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code lit uniquement depuis l'environnement de lancement, est ignorée depuis tous les fichiers. La variable nécessite Claude Code v2.1.283 ou une version ultérieure.
2394* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`, `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`, `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` et `CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, sont ignorées de chaque fichier.2436* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`, `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`, `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` et `CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code lit uniquement depuis l'environnement de lancement, sont ignorées depuis tous les fichiers.
2395* [`CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, est ignorée de chaque fichier.2437* [`CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code lit uniquement depuis l'environnement de lancement, est ignorée depuis tous les fichiers.
2396* [`CLAUDE_CODE_WARN_DISK_FREE_GIB` et `CLAUDE_CODE_WARN_MEMORY_FREE_GIB`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, sont ignorées de chaque fichier. Les variables nécessitent Claude Code v2.1.304 ou ultérieur.2438* [`CLAUDE_CODE_WARN_DISK_FREE_GIB` et `CLAUDE_CODE_WARN_MEMORY_FREE_GIB`](https://code.claude.com/docs/fr/env-vars#variables), que Claude Code lit uniquement depuis l'environnement de lancement, sont ignorées depuis tous les fichiers. Les variables nécessitent Claude Code v2.1.304 ou une version ultérieure.
2397 2439
2398### `fileCheckpointingEnabled`2440### `fileCheckpointingEnabled`
2399 2441
2400Faites en sorte que Claude Code crée des instantanés de fichiers avant chaque modification afin que [`/rewind`](https://code.claude.com/docs/fr/checkpointing) puisse les restaurer. Apparaît dans `/config` sous **Rewind code (checkpoints)**, et le basculer là-bas écrit cette clé dans vos paramètres utilisateur.2442Demandez à Claude Code de prendre un instantané des fichiers avant chaque modification afin que [`/rewind`](https://code.claude.com/docs/fr/checkpointing) puisse les restaurer. Apparaît dans `/config` sous le nom **Rewind code (checkpoints)**, et le basculer à cet endroit écrit cette clé dans vos paramètres utilisateur.
2401 2443
2402* **Scope** : [`Any file`](#scopes)2444* **Portée** : [`Any file`](#scopes)
2403* **Type** : Boolean2445* **Type** : booléen
2404 * `true` : Claude Code crée des instantanés de fichiers avant chaque modification afin que `/rewind` puisse les restaurer2446 * `true` : Claude Code prend un instantané des fichiers avant chaque modification afin que `/rewind` puisse les restaurer
2405 * `false` : Claude Code ne crée pas d'instantanés de fichiers, donc `/rewind` ne peut pas les restaurer2447 * `false` : Claude Code ne prend pas d'instantané des fichiers, donc `/rewind` ne peut pas les restaurer
2406* **Default** : `true`2448* **Valeur par défaut** : `true`
2407* **Per-session overrides** : [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](https://code.claude.com/docs/fr/env-vars) désactive les points de contrôle pour une session ; celui des deux qui le désactive, l'autre ne peut pas le réactiver2449* **Remplacements par session** : [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](https://code.claude.com/docs/fr/env-vars) désactive le checkpointing pour une session ; quel que soit celui des deux qui le désactive, l'autre ne peut pas le réactiver
2408 2450
2409```json settings.json theme={null}2451```json settings.json theme={null}
2410{2452{
2412}2454}
2413```2455```
2414 2456
2415Dans une exécution `-p` ou une session Agent SDK, Claude Code ignore cette clé. Le SDK active les points de contrôle avec son option `enableFileCheckpointing`, et une exécution `-p` nue a besoin de `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true`. Voir [File checkpointing in the Agent SDK](https://code.claude.com/docs/fr/agent-sdk/file-checkpointing.md).2457Dans une exécution `-p` ou une session Agent SDK, Claude Code ignore cette clé. Le SDK active le checkpointing avec son option `enableFileCheckpointing`, et une exécution `-p` seule nécessite `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true`. Consultez [Checkpointing de fichiers dans l'Agent SDK](https://code.claude.com/docs/fr/agent-sdk/file-checkpointing.md).
2416 2458
2417### `idleCompaction`2459### `idleCompaction`
2418 2460
2419La compaction en cas d'inactivité [compacte](https://code.claude.com/docs/fr/context-window.md#what-survives-compaction) une longue conversation que vous avez laissée de côté. Votre prochain message envoie alors un résumé au lieu de la conversation entière. Une fois compactée, la conversation affiche un avis :2461La compaction en cas d'inactivité [compacte](https://code.claude.com/docs/fr/context-window.md#what-survives-compaction) une longue conversation que vous avez laissée de côté. Votre message suivant envoie alors un résumé au lieu de l'intégralité de la conversation. Une fois compactée, la conversation affiche un avis :
2420 2462
2421* **Terminal** : une ligne qui commence par `Compacted while idle, before the prompt cache expired`2463* **Terminal** : une ligne commençant par `Compacted while idle, before the prompt cache expired`
2422* **[Panneau de chat VS Code](#idle-compaction-in-vs-code-and-the-desktop-app)** : un avis qui inclut `a summary written while you were away`2464* **[Panneau de chat VS Code](#idle-compaction-in-vs-code-and-the-desktop-app)** : un avis qui inclut `a summary written while you were away`
2423* **[Application de bureau](#idle-compaction-in-vs-code-and-the-desktop-app)** : le même avis, dans une ligne dont le libellé inclut `Claude Code notice`. Si vous ne voyez pas cette ligne ou son texte, passez au [mode d'affichage Verbose](https://code.claude.com/docs/fr/desktop.md#switch-view-modes).2465* **[Application de bureau](#idle-compaction-in-vs-code-and-the-desktop-app)** : le même avis, dans une ligne dont le libellé inclut `Claude Code notice`. Si vous ne voyez pas cette ligne ou son texte, passez au [mode d'affichage Verbose](https://code.claude.com/docs/fr/desktop.md#switch-view-modes).
2424 2466
2426 2468
2427* **Session** : vous êtes dans une session de terminal interactive, dans le panneau de chat de l'extension VS Code, ou dans l'onglet Code de l'application de bureau lorsque la session s'exécute sur votre machine ou via SSH2469* **Session** : vous êtes dans une session de terminal interactive, dans le panneau de chat de l'extension VS Code, ou dans l'onglet Code de l'application de bureau lorsque la session s'exécute sur votre machine ou via SSH
2428* **Compaction automatique** : [`autoCompactEnabled`](#autocompactenabled) est activé2470* **Compaction automatique** : [`autoCompactEnabled`](#autocompactenabled) est activé
2429* **Cache de prompt** : la conversation utilise le [TTL d'une heure du cache de prompt](https://code.claude.com/docs/fr/prompt-caching.md#which-ttl-each-request-gets)2471* **Cache de prompt** : la conversation utilise le [TTL de cache de prompt d'une heure](https://code.claude.com/docs/fr/prompt-caching.md#which-ttl-each-request-gets)
2430* **Feature flags** : Claude Code peut [récupérer les feature flags auprès d'Anthropic](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching)
2431* **Taille** : le contexte de la conversation a atteint le seuil de tokens, que vous pouvez [modifier](#change-the-idle-compaction-threshold) par rapport à sa valeur par défaut de 200 0002472* **Taille** : le contexte de la conversation a atteint le seuil de tokens, que vous pouvez [modifier](#change-the-idle-compaction-threshold) par rapport à sa valeur par défaut de 200 000
2432* **Temps d'inactivité** : environ une heure s'est écoulée depuis la dernière requête, et votre ordinateur reste en éveil jusque-là2473* **Durée d'inactivité** : environ une heure s'est écoulée depuis la dernière requête, et votre ordinateur reste allumé jusque-là
2433 2474
2434Pour désactiver la compaction en cas d'inactivité, définissez cette clé sur `false`.2475Pour désactiver la compaction en cas d'inactivité, définissez cette clé sur `false`.
2435 2476
2436* **Scope** : [`Any file`](#scopes)2477* **Portée** : [`Any file`](#scopes)
2437* **Type** : Boolean2478* **Type** : booléen
2438 * `true` : Claude Code compacte les conversations inactives qui remplissent les conditions2479 * `true` : Claude Code compacte les conversations inactives qui remplissent les conditions
2439 * `false` : Claude Code ne compacte pas pendant que votre session est inactive2480 * `false` : Claude Code ne compacte pas lorsque votre session est inactive
2440* **Default** : `true`2481* **Valeur par défaut** : `true`
2441* **Per-session overrides** : [`DISABLE_AUTO_COMPACT`](https://code.claude.com/docs/fr/env-vars) désactive la compaction en cas d'inactivité en même temps que la compaction automatique2482* **Remplacements par session** : [`DISABLE_AUTO_COMPACT`](https://code.claude.com/docs/fr/env-vars) désactive la compaction en cas d'inactivité en même temps que la compaction automatique
2442 2483
2443```json settings.json theme={null}2484```json settings.json theme={null}
2444{2485{
2446}2487}
2447```2488```
2448 2489
2449Pour désactiver ou activer la compaction en cas d'inactivité depuis une session de terminal, exécutez `/config` et modifiez la ligne **Idle compaction**. Votre choix est enregistré dans vos paramètres utilisateur et s'applique immédiatement. La ligne nécessite Claude Code v2.1.302 ou ultérieur. Si vous utilisez l'une de ces versions et que `/config` n'affiche pas la ligne, vérifiez les causes suivantes :2490Pour désactiver ou activer la compaction en cas d'inactivité depuis une session de terminal, exécutez `/config` et modifiez la ligne **Idle compaction**. Votre choix est enregistré dans vos paramètres utilisateur et s'applique immédiatement. La ligne nécessite Claude Code v2.1.302 ou une version ultérieure. Si vous utilisez l'une de ces versions et que `/config` n'affiche pas la ligne, vérifiez les causes suivantes :
2450 2491
2451* **Une autre source de paramètres définit la clé** : une valeur dans les paramètres gérés, le flag `--settings` ou un fichier de paramètres de projet ou local remplace vos paramètres utilisateur. Modifiez plutôt la clé dans cette source2492* **Une autre source de paramètres définit la clé** : une valeur dans les paramètres gérés, le flag `--settings` ou un fichier de paramètres de projet ou local remplace vos paramètres utilisateur. Modifiez plutôt la clé dans cette source
2452* **Les feature flags sont indisponibles** : lorsque Claude Code ne peut pas [récupérer les feature flags auprès d'Anthropic](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching), la compaction en cas d'inactivité ne s'exécute pas, il n'y a donc rien à désactiver2493* **Les feature flags sont indisponibles sur une version antérieure à v2.1.314** : lorsque Claude Code ne peut pas [récupérer les feature flags auprès d'Anthropic](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching), la compaction en cas d'inactivité ne s'exécute pas ; il n'y a donc rien à désactiver
2453 2494
2454La clé nécessite Claude Code v2.1.290 ou ultérieur. Sur une version antérieure, qui ignore cette clé, désactivez [`autoCompactEnabled`](#autocompactenabled) pour arrêter la compaction en cas d'inactivité.2495La clé nécessite Claude Code v2.1.290 ou une version ultérieure. Sur une version antérieure, qui ignore cette clé, désactivez [`autoCompactEnabled`](#autocompactenabled) pour arrêter la compaction en cas d'inactivité.
2455 2496
2456#### Modifier le seuil de compaction en cas d'inactivité2497#### Modifier le seuil de compaction en cas d'inactivité
2457 2498
2458Définissez [`CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS`](https://code.claude.com/docs/fr/env-vars) sur le nombre de tokens que le contexte d'une conversation doit atteindre avant que la compaction en cas d'inactivité ne s'y applique. Utilisez un nombre entier positif. Les valeurs inférieures à `100000` sont relevées à `100000`, le seuil le plus bas.2499Définissez [`CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS`](https://code.claude.com/docs/fr/env-vars) sur le nombre de tokens que le contexte d'une conversation doit atteindre pour que la compaction en cas d'inactivité s'y applique. Utilisez un nombre entier positif. Les valeurs inférieures à `100000` sont relevées à `100000`, le seuil le plus bas.
2459 2500
2460Avec la valeur par défaut, une conversation sur une fenêtre de contexte de 200K se compacte automatiquement avant d'atteindre 200 000 tokens. Cet exemple abaisse le seuil à 150 000 afin que ces conversations soient éligibles :2501Avec la valeur par défaut, une conversation sur une fenêtre de contexte de 200K se compacte automatiquement avant d'atteindre 200 000 tokens. Cet exemple abaisse le seuil à 150 000 afin que ces conversations soient concernées :
2461 2502
2462```json settings.json theme={null}2503```json settings.json theme={null}
2463{2504{
2469 2510
2470#### Compaction en cas d'inactivité dans VS Code et l'application de bureau2511#### Compaction en cas d'inactivité dans VS Code et l'application de bureau
2471 2512
2472Un avis comme celui-ci signifie que Claude Code [a remplacé votre conversation précédente par un résumé](https://code.claude.com/docs/fr/context-window.md#what-survives-compaction) à partir duquel Claude travaille désormais :2513Un avis comme celui-ci signifie que Claude Code a [remplacé votre conversation antérieure par un résumé](https://code.claude.com/docs/fr/context-window.md#what-survives-compaction) à partir duquel Claude travaille désormais :
2473 2514
2474```text theme={null}2515```text theme={null}
2475Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json2516Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json
2479 2520
2480### `plansDirectory`2521### `plansDirectory`
2481 2522
2482Choisissez où Claude Code stocke les fichiers de plan qu'il écrit en [mode plan](https://code.claude.com/docs/fr/permission-modes.md#analyze-before-you-edit-with-plan-mode). Claude Code résout le chemin par rapport à la racine du projet.2523Choisissez l'endroit où Claude Code stocke les fichiers de plan qu'il écrit en [mode plan](https://code.claude.com/docs/fr/permission-modes.md#analyze-before-you-edit-with-plan-mode). Claude Code résout le chemin relativement à la racine du projet.
2483 2524
2484* **Scope** : [`Any file`](#scopes)2525* **Portée** : [`Any file`](#scopes)
2485* **Type** : string, a path relative to the project root2526* **Type** : chaîne, un chemin relatif à la racine du projet
2486* **Default** : non défini, donc Claude Code utilise `~/.claude/plans`2527* **Valeur par défaut** : non définie, Claude Code utilise donc `~/.claude/plans`
2487 2528
2488```json settings.json theme={null}2529```json settings.json theme={null}
2489{2530{
2491}2532}
2492```2533```
2493 2534
2494Claude Code stocke les plans dans `~/.claude/plans` au lieu du répertoire que vous avez défini dans des cas tels que ceux-ci :2535Claude Code stocke les plans dans `~/.claude/plans` au lieu du répertoire que vous avez défini dans des cas comme ceux-ci :
2495 2536
2496* **En dehors de la racine du projet** : le chemin se résout en dehors de la racine du projet, comme le fait `"../plans"`.2537* **En dehors de la racine du projet** : le chemin se résout en dehors de la racine du projet, comme c'est le cas pour `"../plans"`.
2497* **Barre oblique inverse sur macOS, Linux et WSL** : le chemin résolu contient une barre oblique inverse, comme le fait `"docs\\plans"` de style Windows. Écrivez `"docs/plans"`, qui fonctionne aussi sous Windows.2538* **Barre oblique inverse sur macOS, Linux et WSL** : le chemin résolu contient une barre oblique inverse, comme c'est le cas pour `"docs\\plans"` de style Windows. Écrivez `"docs/plans"`, qui fonctionne également sous Windows.
2498 2539
2499### `skillListingBudgetFraction`2540### `skillListingBudgetFraction`
2500 2541
2501À chaque tour, Claude voit un [listing de vos compétences](https://code.claude.com/docs/fr/skills.md#skill-descriptions-are-cut-short) avec leurs descriptions, et Claude Code plafonne ce listing à une part de la fenêtre de contexte. Lorsque le listing dépasse le plafond, Claude Code conserve le nom de chaque compétence mais supprime les descriptions des compétences les moins utilisées, afin que Claude puisse toujours invoquer ces compétences mais soit moins susceptible d'en choisir une de sa propre initiative. Augmentez cette clé pour conserver plus de descriptions visibles au détriment de plus de contexte par tour.2542À chaque tour, Claude voit une [liste de vos skills](https://code.claude.com/docs/fr/skills.md#skill-descriptions-are-cut-short) avec leurs descriptions, et Claude Code plafonne cette liste à une part de la fenêtre de contexte. Lorsque la liste dépasse le plafond, Claude Code conserve le nom de chaque skill mais supprime les descriptions des skills les moins utilisés ; Claude peut donc toujours invoquer ces skills, mais il est moins susceptible d'en choisir un de lui-même. Augmentez cette clé pour garder davantage de descriptions visibles, au prix d'un contexte plus important à chaque tour.
2502 2543
2503* **Scope** : [`Any file`](#scopes)2544* **Portée** : [`Any file`](#scopes)
2504* **Type** : number, a fraction greater than `0` and at most `1`2545* **Type** : nombre, une fraction supérieure à `0` et au plus égale à `1`
2505* **Default** : `0.01`, which reserves 1% of the context window2546* **Valeur par défaut** : `0.01`, ce qui réserve 1 % de la fenêtre de contexte
2506 2547
2507```json settings.json theme={null}2548```json settings.json theme={null}
2508{2549{
2510}2551}
2511```2552```
2512 2553
2513Pour voir la quantité de contexte utilisée par le listing et les compétences qui contribuent le plus, exécutez `/doctor`.2554Pour voir la quantité de contexte utilisée par la liste et les skills qui y contribuent le plus, exécutez `/doctor`.
2514 2555
2515### `skillListingMaxDescChars`2556### `skillListingMaxDescChars`
2516 2557
2517À chaque tour, Claude voit un [listing de vos compétences](https://code.claude.com/docs/fr/skills.md#skill-descriptions-are-cut-short) qui affiche le texte `description` et `when_to_use` de chaque compétence. Cette clé plafonne le nombre de caractères de ce texte que Claude Code affiche par compétence ; le texte plus long est coupé au plafond.2558À chaque tour, Claude voit une [liste de vos skills](https://code.claude.com/docs/fr/skills.md#skill-descriptions-are-cut-short) qui affiche le texte `description` et `when_to_use` de chaque skill. Cette clé plafonne le nombre de caractères de ce texte que Claude Code affiche par skill ; un texte plus long est coupé au plafond.
2518 2559
2519* **Scope** : [`Any file`](#scopes)2560* **Portée** : [`Any file`](#scopes)
2520* **Type** : number of characters, a positive integer2561* **Type** : nombre de caractères, un entier positif
2521* **Default** : `1536`2562* **Valeur par défaut** : `1536`
2522 2563
2523```json settings.json theme={null}2564```json settings.json theme={null}
2524{2565{
2526}2567}
2527```2568```
2528 2569
2529Augmentez-le pour conserver les descriptions longues intactes au détriment de plus de contexte par tour ; diminuez-le pour adapter plus de compétences sous [`skillListingBudgetFraction`](#skilllistingbudgetfraction).2570Augmentez-la pour conserver les longues descriptions intactes, au prix d'un contexte plus important à chaque tour ; réduisez-la pour faire tenir davantage de skills sous [`skillListingBudgetFraction`](#skilllistingbudgetfraction).
2530 2571
2531### `taskOutputMaxChars`2572### `taskOutputMaxChars`
2532 2573
2533> [!WARNING]2574> [!WARNING]
2534>2575>
2535> Supprimé dans v2.1.277, ainsi que l'outil `TaskOutput` qu'il dimensionnait. Le définir n'a aucun effet sur les versions actuelles. Claude lit le [fichier de sortie](https://code.claude.com/docs/fr/tools-reference.md#background-commands) d'une tâche en arrière-plan avec `Read` à la place.2576> Supprimée dans v2.1.277, en même temps que l'outil `TaskOutput` dont elle déterminait la taille. La définir n'a aucun effet sur les versions actuelles. Claude lit désormais le [fichier de sortie](https://code.claude.com/docs/fr/tools-reference.md#background-commands) d'une tâche en arrière-plan avec `Read`.
2536 2577
2537Jusqu'à v2.1.276, vous définissiez cette clé au nombre de caractères de la [sortie d'une tâche en arrière-plan](https://code.claude.com/docs/fr/tools-reference.md#background-commands) que Claude reçoit en ligne lorsqu'il lisait la tâche avec l'outil `TaskOutput`.2578Jusqu'à v2.1.276, vous définissiez cette clé sur le nombre de caractères de la sortie d'une [tâche en arrière-plan](https://code.claude.com/docs/fr/tools-reference.md#background-commands) que Claude recevait directement lorsqu'il lisait la tâche avec l'outil `TaskOutput`.
2538 2579
2539## Interface et terminal2580## Interface et terminal
2540 2581
