Documentation 2026-11-11 22:59 UTC to 2026-11-12 22:01 UTC

298 298 

299### Les écritures en miroir sont au mieux299### Les écritures en miroir sont au mieux

300 300 

301Si `append()` rejette, le SDK réessaie le lot jusqu'à deux fois supplémentaires avec un délai court, pour un maximum de trois tentatives au total. Un appel qui expire n'est pas réessayé, car l'appel original peut toujours aboutir. Si le lot échoue toujours, le SDK enregistre l'erreur, émet un message `{ type: "system", subtype: "mirror_error" }` dans l'itérateur, supprime le lot, et continue la requête. Parce qu'un lot réessayé peut redélivrer des entrées qui ont déjà abouti, dédupliquez par `entry.uuid` dans votre implémentation de `append()`.301Si `append()` rejette, le SDK réessaie le lot jusqu'à deux fois supplémentaires avec un délai court, pour un maximum de trois tentatives au total. Un appel qui expire n'est pas réessayé, car l'appel original peut toujours aboutir. Parce qu'un lot réessayé peut redélivrer des entrées qui ont déjà abouti, dédupliquez par `entry.uuid` dans votre implémentation de `append()`, et conservez chaque entrée qui n'a pas de `uuid`.

302 302 

303Une panne du magasin n'interrompt pas l'agent, puisque le sous-processus écrit localement d'abord. Surveillez `mirror_error` si vous devez détecter une perte de données du magasin. Sur une exécution [reprise à partir du magasin](#resume-from-the-store), un lot supprimé n'a pas de copie survivante une fois l'exécution terminée.303Si le lot échoue toujours, le SDK consigne l'erreur, émet un message `{ type: "system", subtype: "mirror_error" }` dans l'itérateur, supprime le lot, et continue la requête. Une panne du magasin n'interrompt pas l'agent, puisque le sous-processus écrit localement d'abord. Surveillez `mirror_error` pour détecter une perte de données du magasin. Sur une exécution [reprise à partir du magasin](#resume-from-the-store), un lot supprimé n'a pas de copie survivante une fois l'exécution terminée.

304 304 

305### `getSessionMessages` retourne la chaîne post-compaction305### `getSessionMessages` retourne la chaîne post-compaction

306 306 

148 148 

149#### Désactiver les scripts dans les prévisualisations SSH et WSL pour votre organisation149#### Désactiver les scripts dans les prévisualisations SSH et WSL pour votre organisation

150 150 

151Pour empêcher les [prévisualisations HTML dans les sessions SSH et WSL](#preview-html-files-in-ssh-and-wsl-sessions) d'exécuter des scripts, définissez le [paramètre géré `disableBrowserExternalNavigation`](#managed-settings) sur `true`. Avec ce paramètre, les utilisateurs ne peuvent pas non plus [naviguer sur des sites externes](#restrict-external-browsing-for-your-organization) dans le panneau Browser.151Pour empêcher les [prévisualisations HTML dans les sessions SSH et WSL](#preview-html-files-in-ssh-and-wsl-sessions) d'exécuter des scripts, définissez le [paramètre géré `disableRemotePreviewScripts`](#managed-settings) sur `true`. Les utilisateurs peuvent toujours naviguer sur des sites externes. Nécessite Claude Desktop v5.1231.0 ou ultérieur.

152 152 

153Définissez-le dans vos [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md), ou dans une [politique MDM ou un fichier de paramètres gérés de Claude Code](https://code.claude.com/docs/fr/managed-settings.md#where-each-mechanism-stores-the-policy) sur l'ordinateur qui exécute Desktop. Desktop ne le lit ni depuis la machine distante ni depuis la distribution WSL. Avec un [fournisseur tiers](https://code.claude.com/docs/fr/third-party-integrations.md), utilisez la politique MDM ou le fichier.153> [!NOTE]

154>

155> Les versions antérieures ignorent `disableRemotePreviewScripts`. Pour y bloquer les scripts, mettez Desktop à jour, ou définissez également `disableBrowserExternalNavigation` sur `true`. Les utilisateurs [ne peuvent alors plus naviguer sur des sites externes](#restrict-external-browsing-for-your-organization) sur aucun ordinateur qui reçoit `disableBrowserExternalNavigation`.

156 

157Définissez chaque clé dans vos [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md), ou dans une [politique MDM ou un fichier de paramètres gérés de Claude Code](https://code.claude.com/docs/fr/managed-settings.md#where-each-mechanism-stores-the-policy) sur l'ordinateur qui exécute Desktop. Desktop ne lit ces clés ni depuis la machine distante, ni depuis la distribution WSL, ni depuis un [`policyHelper`](https://code.claude.com/docs/fr/settings-reference#policyhelper), ni depuis les [politiques propres à Desktop](#device-management-policies). Avec un [fournisseur tiers](https://code.claude.com/docs/fr/third-party-integrations.md), utilisez la politique MDM ou le fichier.

154 158 

155> [!WARNING]159> [!WARNING]

156>160>

160 164 

161Demandez ensuite aux utilisateurs de redémarrer Desktop pour garantir que le paramètre s'applique, et indiquez-leur à quoi s'attendre :165Demandez ensuite aux utilisateurs de redémarrer Desktop pour garantir que le paramètre s'applique, et indiquez-leur à quoi s'attendre :

162 166 

163* **Fichiers qu'ils ouvrent** : la prévisualisation n'exécute pas de scripts, donc les graphiques et tableaux dessinés par des scripts restent vides167* **Fichiers qu'ils ouvrent** : la prévisualisation n'exécute pas de scripts, donc les graphiques et tableaux dessinés par des scripts restent vides. Son avis commence par `This preview doesn't run scripts`.

164* **Prévisualisations qui exécutent des scripts** : si Desktop prend en compte le paramètre avant le redémarrage, elles se ferment. Les utilisateurs voient `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`168* **Prévisualisations qui exécutent des scripts** : si Desktop prend en compte le paramètre avant le redémarrage, elles se ferment. Les utilisateurs voient `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`

165* **Fichiers qu'ils exportent** : si un utilisateur [exporte un fichier](#preview-html-files-in-ssh-and-wsl-sessions) et l'ouvre dans un navigateur, ses scripts s'y exécutent, avec ou sans ce paramètre169* **Fichiers qu'ils exportent** : si un utilisateur [exporte un fichier](#preview-html-files-in-ssh-and-wsl-sessions) et l'ouvre dans un navigateur, ses scripts s'y exécutent, avec ou sans ce paramètre

166 170 

171##### Vérifier si des scripts s'exécutent encore sur un ordinateur

172 

173Après le redémarrage, ouvrez un fichier HTML depuis une session SSH ou WSL sur cet ordinateur. Si l'avis au-dessus de la prévisualisation commence par `This preview doesn't load anything from the web`, les scripts s'y exécutent encore. Vérifiez la [version de Desktop](#check-your-version), l'emplacement où vous avez placé la clé, et que sa valeur est bien le booléen JSON `true`.

174 

167### Naviguer sur des sites externes175### Naviguer sur des sites externes

168 176 

169Le panneau Browser est un navigateur à onglets : vous pouvez donc ouvrir de la documentation, des outils de suivi des tickets ou tout autre site à côté de votre application en cours d'exécution. Pour ouvrir le Browser, appuyez sur **Cmd+Shift+B** sur macOS ou sur **Ctrl+Shift+B** sur Windows, ou cliquez sur **Browser** dans la barre de titre de la session. Vous pouvez vous connecter à des sites dans le panneau, y compris via des flux de connexion en popup tels que Google OAuth.177Le panneau Browser est un navigateur à onglets : vous pouvez donc ouvrir de la documentation, des outils de suivi des tickets ou tout autre site à côté de votre application en cours d'exécution. Pour ouvrir le Browser, appuyez sur **Cmd+Shift+B** sur macOS ou sur **Ctrl+Shift+B** sur Windows, ou cliquez sur **Browser** dans la barre de titre de la session. Vous pouvez vous connecter à des sites dans le panneau, y compris via des flux de connexion en popup tels que Google OAuth.

2037| `browserExternalPageTools` | définissez sur `"disabled"` pour empêcher Claude d'utiliser des outils pour lire ou agir sur des pages externes dans le [volet Navigateur](#browse-external-sites). Les utilisateurs peuvent toujours naviguer vers des sites externes eux-mêmes, et les aperçus des serveurs de développement locaux ne sont pas affectés. |2045| `browserExternalPageTools` | définissez sur `"disabled"` pour empêcher Claude d'utiliser des outils pour lire ou agir sur des pages externes dans le [volet Navigateur](#browse-external-sites). Les utilisateurs peuvent toujours naviguer vers des sites externes eux-mêmes, et les aperçus des serveurs de développement locaux ne sont pas affectés. |

2038| `disableMobileSimulatorTools` | définissez sur `true` pour bloquer les outils de Claude pour contrôler et capturer les appareils dans le [volet iOS Simulator](https://code.claude.com/docs/fr/desktop-ios-simulator.md#turn-off-simulator-access). Le volet reste utilisable pour les appuis de l'utilisateur ; seul l'accès de Claude est supprimé. La valeur doit être le booléen JSON `true` ; la chaîne `"true"` est ignorée. |2046| `disableMobileSimulatorTools` | définissez sur `true` pour bloquer les outils de Claude pour contrôler et capturer les appareils dans le [volet iOS Simulator](https://code.claude.com/docs/fr/desktop-ios-simulator.md#turn-off-simulator-access). Le volet reste utilisable pour les appuis de l'utilisateur ; seul l'accès de Claude est supprimé. La valeur doit être le booléen JSON `true` ; la chaîne `"true"` est ignorée. |

2039| `disableBrowserExternalNavigation` | définissez sur `true` pour désactiver complètement la navigation externe dans le [volet Navigateur](#browse-external-sites). Ni les utilisateurs ni Claude ne peuvent naviguer vers des sites externes, et les aperçus des serveurs de développement localhost ne sont pas affectés. Les aperçus HTML dans les sessions SSH et WSL [n'exécutent pas de scripts](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). La valeur doit être le booléen JSON `true` ; la chaîne `"true"` est ignorée. |2047| `disableBrowserExternalNavigation` | définissez sur `true` pour désactiver complètement la navigation externe dans le [volet Navigateur](#browse-external-sites). Ni les utilisateurs ni Claude ne peuvent naviguer vers des sites externes, et les aperçus des serveurs de développement localhost ne sont pas affectés. Les aperçus HTML dans les sessions SSH et WSL [n'exécutent pas de scripts](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). La valeur doit être le booléen JSON `true` ; la chaîne `"true"` est ignorée. |

2048| `disableRemotePreviewScripts` | définissez sur `true` pour [désactiver uniquement les scripts dans les aperçus HTML](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) dans les sessions SSH et WSL. Desktop ne le lit pas à partir de la machine distante ni de la distribution WSL. La valeur doit être le booléen JSON `true` ; la chaîne `"true"` est ignorée. Nécessite Claude Desktop v5.1231.0 ou version ultérieure. |

2040| `sshConfigs` | pré-configurez les [connexions SSH](#pre-configure-ssh-connections-for-your-team) qui apparaissent dans le sélecteur d'environnement. Les utilisateurs ne peuvent pas supprimer les connexions gérées ni modifier quoi que ce soit d'autre que leur propre **Worktree folder**. |2049| `sshConfigs` | pré-configurez les [connexions SSH](#pre-configure-ssh-connections-for-your-team) qui apparaissent dans le sélecteur d'environnement. Les utilisateurs ne peuvent pas supprimer les connexions gérées ni modifier quoi que ce soit d'autre que leur propre **Worktree folder**. |

2041| `sshHostCommands` | fournissez aux utilisateurs des [connexions SSH dont l'hôte provient d'une commande](#distribute-commands-to-your-team), en plus des leurs. Desktop le lit à partir du fichier de paramètres gérés ou de la politique MDM sur l'ordinateur, et l'ignore dans les [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md). Nécessite Claude Desktop v3.6556.0 ou version ultérieure sur macOS ou Linux, ou v4.16336.0 ou version ultérieure sur Windows, avec une connexion via un compte Claude. Sur Windows, Desktop doit également [se connecter via le client OpenSSH](#use-your-ssh-configuration). |2050| `sshHostCommands` | fournissez aux utilisateurs des [connexions SSH dont l'hôte provient d'une commande](#distribute-commands-to-your-team), en plus des leurs. Desktop le lit à partir du fichier de paramètres gérés ou de la politique MDM sur l'ordinateur, et l'ignore dans les [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md). Nécessite Claude Desktop v3.6556.0 ou version ultérieure sur macOS ou Linux, ou v4.16336.0 ou version ultérieure sur Windows, avec une connexion via un compte Claude. Sur Windows, Desktop doit également [se connecter via le client OpenSSH](#use-your-ssh-configuration). |

2042| `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. Lecture à partir des paramètres gérés uniquement. |2051| `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. Lecture à partir des paramètres gérés uniquement. |

2044| `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. |2053| `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. |

2045| `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 le [bloc `desktop`](https://code.claude.com/docs/fr/claude-apps-gateway-config#claude-desktop-overlay) d'une politique de 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](https://code.claude.com/docs/fr/managed-mcp.md#provide-servers-through-managed-settings) qui lui est propre, avec une forme d'entrée différente. |2054| `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 le [bloc `desktop`](https://code.claude.com/docs/fr/claude-apps-gateway-config#claude-desktop-overlay) d'une politique de 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](https://code.claude.com/docs/fr/managed-mcp.md#provide-servers-through-managed-settings) qui lui est propre, avec une forme d'entrée différente. |

2046 2055 

2047Si vous désactivez une fonctionnalité avec `browserExternalPageTools`, `disableMobileSimulatorTools` ou `disableBrowserExternalNavigation` dans la [politique MDM ou le fichier de paramètres gérés de rang le plus élevé](https://code.claude.com/docs/fr/managed-settings.md#how-claude-code-combines-managed-sources) d'un ordinateur, la fonctionnalité reste désactivée sur cet ordinateur. Elle reste désactivée même lorsque vos [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md) laissent cette clé non définie ou autorisent la fonctionnalité. N'utilisez pas de valeur de registre `HKCU` au niveau de l'utilisateur à cette fin. Pour réactiver la fonctionnalité, supprimez la valeur partout où vous l'avez définie. Nécessite Claude Desktop v4.4212.0 ou version ultérieure.2056Si vous désactivez une fonctionnalité avec l'une de ces quatre clés dans la [politique MDM ou le fichier de paramètres gérés de rang le plus élevé](https://code.claude.com/docs/fr/managed-settings.md#how-claude-code-combines-managed-sources) d'un ordinateur, la fonctionnalité reste désactivée sur cet ordinateur :

2057 

2058* **`browserExternalPageTools`, `disableMobileSimulatorTools`, `disableBrowserExternalNavigation`** : nécessite Claude Desktop v4.4212.0 ou version ultérieure

2059* **`disableRemotePreviewScripts`** : nécessite Claude Desktop v5.1231.0 ou version ultérieure

2060 

2061Elle reste désactivée même lorsque vos [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md) laissent cette clé non définie ou autorisent la fonctionnalité. N'utilisez pas de valeur de registre `HKCU` au niveau de l'utilisateur à cette fin. Pour réactiver la fonctionnalité, supprimez la valeur partout où vous l'avez définie.

2048 2062 

2049Les 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`](https://code.claude.com/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](https://code.claude.com/docs/fr/model-config.md#surface-coverage).2063Les 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`](https://code.claude.com/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](https://code.claude.com/docs/fr/model-config.md#surface-coverage).

2050 2064 

2109>2123>

2110> Vérifiez la valeur de `forceLoginOrgUUID` avant de la déployer. Si l'ID n'est pas celui de votre organisation, les personnes de votre organisation ne peuvent pas utiliser Claude Desktop, sauf si elles appartiennent également à une organisation avec cet ID. Pour rétablir la situation, déployez l'ID correct et demandez-leur de redémarrer Claude Desktop.2124> Vérifiez la valeur de `forceLoginOrgUUID` avant de la déployer. Si l'ID n'est pas celui de votre organisation, les personnes de votre organisation ne peuvent pas utiliser Claude Desktop, sauf si elles appartiennent également à une organisation avec cet ID. Pour rétablir la situation, déployez l'ID correct et demandez-leur de redémarrer Claude Desktop.

2111 2125 

2112Si vous définissez `forceLoginMethod` et `forceLoginOrgUUID` dans les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) de Claude Code, vous ne modifiez pas l'écran de connexion de Claude Desktop.2126Si vous définissez `forceLoginMethod` et `forceLoginOrgUUID` dans les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) de Claude Code, vous ne modifiez pas l'écran de connexion de Claude Desktop. Une personne peut toujours utiliser Claude Desktop avec sa propre clé API Claude ou son [compte Claude Console](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in), et exécuter ainsi des sessions de l'onglet Code.

2127 

2128Pour l'en empêcher, déployez également `forceLoginOrgUUID` dans la politique Claude Desktop (dans `HKLM` sur Windows), avec l'ID de votre organisation claude.ai. Sauf si la politique elle-même [sélectionne l'API Claude](https://claude.com/docs/third-party/claude-desktop/claude-api#choose-an-authentication-approach), Claude Desktop cesse d'utiliser la propre clé API ou le propre compte Console d'une personne au prochain lancement de l'application.

2129 

2130Vérifiez deux cas avant de le déployer :

2131 

2132* **Organisations Claude Console** : ne déployez pas `forceLoginOrgUUID` seul avec l'ID d'une organisation Claude Console, sinon vous bloqueriez l'accès de vos collaborateurs à Claude Desktop. Consultez plutôt [Quels appareils proposent la connexion par compte Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in).

2133* **Enterprise Admin Console** : si elle fournit la configuration Claude Desktop de vos ordinateurs, mettez-les d'abord à jour vers Claude Desktop v2.37337.0 ou version ultérieure, car les versions antérieures l'ignorent une fois cette clé définie. Voir [Conserver un appareil sur son profil géré](https://claude.com/docs/third-party/claude-desktop/admin-console#keep-a-device-on-its-managed-profile).

2113 2134 

2114### Exigences d'accès réseau2135### Exigences d'accès réseau

2115 2136 

5466This conversation is already open in another running Claude session — use that one, or close it and try again5466This conversation is already open in another running Claude session — use that one, or close it and try again

5467```5467```

5468 5468 

5469* **`running in another terminal`** : un terminal détient la conversation, par exemple un terminal dans lequel vous l'avez reprise avec `claude --resume` ou `/resume`. La ligne affiche également `Open in a terminal`.5469* **`running in another terminal`** : un processus autre qu'une session en arrière-plan détient la conversation, par exemple une exécution de `claude -p`, ou un terminal dans lequel vous l'avez reprise avec `claude --resume` ou `/resume`. La ligne affiche également `Open in a terminal`.

5470* **`already open in another running Claude session`** : un autre processus Claude Code non interactif la détient, par exemple un processus de [session en arrière-plan](https://code.claude.com/docs/fr/agent-view.md#the-supervisor-process) pour la même conversation qui ne s'est pas encore terminé.5470* **`already open in another running Claude session`** : une autre [session en arrière-plan](https://code.claude.com/docs/fr/agent-view.md#the-supervisor-process) la détient.

5471 5471 

5472**Que faire :**5472**Que faire :**

5473 5473 

5474* Poursuivez la conversation dans le processus qui l'a ouverte, ou quittez ce processus et ouvrez à nouveau la ligne5474* Pour `running in another terminal` : poursuivez dans ce terminal, ou quittez ce processus ou laissez-le se terminer, puis réessayez

5475* Pour `already open in another running Claude session` : utilisez cette session, ou arrêtez-la, puis réessayez

5475 5476 

5476Avant la v2.1.248, seul le refus `already open in another running Claude session` existait : une conversation reprise dans un terminal n'était pas considérée comme ouverte, et ouvrir la ligne lançait un second processus Claude Code écrivant dans la même conversation.5477Avant la v2.1.248, seul le refus `already open in another running Claude session` existait : une conversation reprise dans un terminal n'était pas considérée comme ouverte, et ouvrir la ligne lançait un second processus Claude Code écrivant dans la même conversation.

5477 5478 

218 218 

219## Mods intégrés à Claude Code219## Mods intégrés à Claude Code

220 220 

221Certaines fonctionnalités propres à Claude Code sont des mods. Pour voir ceux que votre session possède, exécutez `/plugin` à l'invite Claude Code et allez à l'onglet **Installed**, qui les répertorie sous **Built-in**. Vous ne pouvez pas mettre à jour ou désinstaller un mod intégré, et la dernière colonne du tableau indique comment désactiver chacun d'eux. La ligne [`mods active`](#see-which-mods-a-session-loaded) exclut les mods intégrés.221Certaines fonctionnalités propres à Claude Code sont des mods. Pour voir ceux que votre session possède, exécutez `/plugin` à l'invite Claude Code et allez à l'onglet **Installed**, qui les répertorie sous **Built-in**. Vous ne pouvez pas mettre à jour ou désinstaller un mod intégré. La [ligne `mods active`](#see-which-mods-a-session-loaded) exclut les mods intégrés.

222 222 

223Ce tableau répertorie chaque entrée par le nom que `/plugin` affiche :223Ce tableau répertorie certaines des entrées **Built-in** par le nom que `/plugin` affiche :

224 224 

225| Nom dans `/plugin` | Ce qu'il fait | Où il est activé | Comment le désactiver |225| Nom dans `/plugin` | Ce qu'il fait | Où il est activé | Comment le désactiver |

226| :- | :- | :- | :- |226| :- | :- | :- | :- |

231| `cc-plugin-telemetry` | Envoie les enregistrements d'analyse que Claude Code et ses mods intégrés journalisent | Partout où les analyses propres à Claude Code sont activées | Désactivez-le dans `/plugin`, ou désactivez les analyses, par exemple avec [`DISABLE_TELEMETRY`](https://code.claude.com/docs/fr/env-vars) |231| `cc-plugin-telemetry` | Envoie les enregistrements d'analyse que Claude Code et ses mods intégrés journalisent | Partout où les analyses propres à Claude Code sont activées | Désactivez-le dans `/plugin`, ou désactivez les analyses, par exemple avec [`DISABLE_TELEMETRY`](https://code.claude.com/docs/fr/env-vars) |

232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/fr/interactive-mode.md#you-should-know-suggestions) : un agent auxiliaire affiche une note au-dessus de l'invite lorsqu'il trouve quelque chose que vous avez pu manquer | Désactivé jusqu'à ce que vous [l'activiez](https://code.claude.com/docs/fr/interactive-mode.md#you-should-know-suggestions) | Désactivez-le dans `/plugin` |232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/fr/interactive-mode.md#you-should-know-suggestions) : un agent auxiliaire affiche une note au-dessus de l'invite lorsqu'il trouve quelque chose que vous avez pu manquer | Désactivé jusqu'à ce que vous [l'activiez](https://code.claude.com/docs/fr/interactive-mode.md#you-should-know-suggestions) | Désactivez-le dans `/plugin` |

233 233 

234Pour un plugin **Built-in** qui ne figure pas dans le tableau, [ouvrez ses détails dans `/plugin`](https://code.claude.com/docs/fr/plugins/install#manage-installed-plugins) pour savoir ce qu'il fait ou pour le désactiver.

235 

234Les paramètres et les flags qui arrêtent les mods installés, tels que `disableAllHooks`, `--bare` et `--safe-mode`, n'arrêtent pas les mods intégrés.236Les paramètres et les flags qui arrêtent les mods installés, tels que `disableAllHooks`, `--bare` et `--safe-mode`, n'arrêtent pas les mods intégrés.

235 237 

236### Lire le code source des mods intégrés238### Lire le code source des mods intégrés

194| `session.receive` | `($, e) => ({ text: e.text })`. Déclenchez-le avec `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`. |194| `session.receive` | `($, e) => ({ text: e.text })`. Déclenchez-le avec `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`. |

195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |

196 196 

197`expect` a les assertions `toBe`, `toEqual`, `toMatch`, `toMatchObject`, `toContain`, `toBeDefined`, `toBeUndefined`, et `toThrow`, et `.not` avant n'importe lequel d'entre eux.197### Vérifier un résultat avec `expect`

198 

199Le kit propose ces assertions, et celle que vous choisissez se place après la valeur que vous vérifiez, comme dans `expect(answer.text).toBe('ok')` :

200 

201* **Égalité** : `toBe` pour la même valeur ou le même objet, `toEqual` pour la structure, `toStrictEqual` pour la structure plus les champs `undefined` et le prototype, et `toMatchObject` pour les champs que vous nommez

202* **Texte** : `toMatch`, qui accepte une expression régulière ou une sous-chaîne, `toStartWith` et `toEndWith`

203* **Nombres** : `toBeGreaterThan`, `toBeGreaterThanOrEqual`, `toBeLessThan`, `toBeLessThanOrEqual`

204* **Contenu** : `toContain` pour une sous-chaîne ou un membre, `toContainEqual` pour un membre comparé par structure, `toHaveLength` et `toHaveProperty`

205* **Présence et type** : `toBeDefined`, `toBeUndefined`, `toBeNull`, `toBeTruthy`, `toBeFalsy`, `toBeNaN`, `toBeInstanceOf`

206* **Levée d'exceptions** : `toThrow`, pour une fonction que `expect` appelle, ou pour une promesse que vous vérifiez avec `.rejects`

207 

208Placez `.not` devant une assertion pour vérifier le contraire, et `.resolves` ou `.rejects` pour vérifier la valeur avec laquelle une promesse se règle.

198 209 

199Quand un `expect` échoue à l'intérieur d'un stub ou d'un hook que vous avez passé à `on` sous forme de fonction simple plutôt que de générateur asynchrone, le test échoue. Le moteur ignore ce hook, et la sortie de l'échec le nomme, par exemple `in the test's store.set hook`.210Quand un `expect` échoue à l'intérieur d'un stub ou d'un hook que vous avez passé à `on` sous forme de fonction simple plutôt que de générateur asynchrone, le test échoue. Le moteur ignore ce hook, et la sortie de l'échec le nomme, par exemple `in the test's store.set hook`.

200 211 

86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Rejeter des serveurs spécifiques du fichier [`.mcp.json`](https://code.claude.com/docs/fr/mcp#project-scope) d'un projet | MCP | Tout fichier |86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Rejeter des serveurs spécifiques du fichier [`.mcp.json`](https://code.claude.com/docs/fr/mcp#project-scope) d'un projet | MCP | Tout fichier |

87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Bloquer les outils de Claude dans le volet iOS Simulator de l'[application de bureau](https://code.claude.com/docs/fr/desktop.md) | Outils | Géré |87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Bloquer les outils de Claude dans le volet iOS Simulator de l'[application de bureau](https://code.claude.com/docs/fr/desktop.md) | Outils | Géré |

88| [`disableRemoteControl`](#disableremotecontrol) | Désactiver [Remote Control](https://code.claude.com/docs/fr/remote-control.md) partout où il peut démarrer | Distant, bureau et notifications | Tout fichier |88| [`disableRemoteControl`](#disableremotecontrol) | Désactiver [Remote Control](https://code.claude.com/docs/fr/remote-control.md) partout où il peut démarrer | Distant, bureau et notifications | Tout fichier |

89| [`disableRemotePreviewScripts`](#disableremotepreviewscripts) | Désactiver les scripts dans les aperçus HTML de l'[application de bureau](https://code.claude.com/docs/fr/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) dans les sessions SSH et WSL | Distant, bureau et notifications | Géré |

89| [`disableSideloadFlags`](#disablesideloadflags) | Rejeter les flags de la CLI qui chargent latéralement des [plugins](https://code.claude.com/docs/fr/plugins/overview.md), des [sous-agents](https://code.claude.com/docs/fr/sub-agents.md) et des [serveurs MCP](https://code.claude.com/docs/fr/mcp.md) | Entreprise et paramètres gérés | Géré |90| [`disableSideloadFlags`](#disablesideloadflags) | Rejeter les flags de la CLI qui chargent latéralement des [plugins](https://code.claude.com/docs/fr/plugins/overview.md), des [sous-agents](https://code.claude.com/docs/fr/sub-agents.md) et des [serveurs MCP](https://code.claude.com/docs/fr/mcp.md) | Entreprise et paramètres gérés | Géré |

90| [`disableSkillShellExecution`](#disableskillshellexecution) | Empêcher les [skills](https://code.claude.com/docs/fr/skills.md) et les commandes personnalisées d'exécuter du shell en ligne | Plugins et skills | Tout fichier |91| [`disableSkillShellExecution`](#disableskillshellexecution) | Empêcher les [skills](https://code.claude.com/docs/fr/skills.md) et les commandes personnalisées d'exécuter du shell en ligne | Plugins et skills | Tout fichier |

91| [`disableWorkflows`](#disableworkflows) | Désactiver les [workflows dynamiques](https://code.claude.com/docs/fr/workflows.md) pour tout le monde ; utilisez `enableWorkflows` pour vous-même | Hooks et automatisation | Tout fichier |92| [`disableWorkflows`](#disableworkflows) | Désactiver les [workflows dynamiques](https://code.claude.com/docs/fr/workflows.md) pour tout le monde ; utilisez `enableWorkflows` pour vous-même | Hooks et automatisation | 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 |148| [`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 |

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) par défaut des nouvelles sessions | Paramètres de permission | Tout fichier |149| [`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) par défaut des nouvelles sessions | 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 |150| [`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 |

151| [`permissions.denyInsteadOfPrompting`](#permissions-denyinsteadofprompting) | Refuser les appels d'outils qui attendraient une [demande de permission](https://code.claude.com/docs/fr/permissions.md#permission-system), afin qu'une session que personne ne surveille continue de fonctionner | Paramètres de permission | Utilisateur ou géré |

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 |152| [`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 |

151| [`plansDirectory`](#plansdirectory) | Choisir où le [mode plan](https://code.claude.com/docs/fr/permission-modes.md#analyze-before-you-edit-with-plan-mode) écrit les fichiers de plan | Mémoire et contexte | Tout fichier |153| [`plansDirectory`](#plansdirectory) | Choisir où le [mode plan](https://code.claude.com/docs/fr/permission-modes.md#analyze-before-you-edit-with-plan-mode) écrit les fichiers de plan | Mémoire et contexte | Tout fichier |

152| [`pluginConfigs`](#pluginconfigs) | Conserver les réponses que vous avez données dans la boîte de dialogue de configuration d'un [plugin](https://code.claude.com/docs/fr/plugins/overview.md) | Plugins et skills | Utilisateur ou géré |154| [`pluginConfigs`](#pluginconfigs) | Conserver les réponses que vous avez données dans la boîte de dialogue de configuration d'un [plugin](https://code.claude.com/docs/fr/plugins/overview.md) | Plugins et skills | Utilisateur ou géré |

228| [`statusLine`](#statusline) | Exécuter votre propre commande pour afficher une [barre de statut](https://code.claude.com/docs/fr/statusline.md) sous la zone de saisie | Interface et terminal | Tout fichier |230| [`statusLine`](#statusline) | Exécuter votre propre commande pour afficher une [barre de statut](https://code.claude.com/docs/fr/statusline.md) sous la zone de saisie | Interface et terminal | Tout fichier |

229| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Définir la liste d'autorisation des sources de [marketplaces](https://code.claude.com/docs/fr/plugins/overview.md) que les utilisateurs peuvent ajouter et depuis lesquelles ils peuvent installer | Plugins et skills | Géré |231| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Définir la liste d'autorisation des sources de [marketplaces](https://code.claude.com/docs/fr/plugins/overview.md) que les utilisateurs peuvent ajouter et depuis lesquelles ils peuvent installer | Plugins et skills | Géré |

230| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Bloquer les [skills](https://code.claude.com/docs/fr/skills.md), [agents](https://code.claude.com/docs/fr/sub-agents.md), [hooks](https://code.claude.com/docs/fr/hooks.md) et [serveurs MCP](https://code.claude.com/docs/fr/mcp.md) provenant des sources utilisateur et projet | Plugins et skills | Géré |232| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Bloquer les [skills](https://code.claude.com/docs/fr/skills.md), [agents](https://code.claude.com/docs/fr/sub-agents.md), [hooks](https://code.claude.com/docs/fr/hooks.md) et [serveurs MCP](https://code.claude.com/docs/fr/mcp.md) provenant des sources utilisateur et projet | Plugins et skills | Géré |

231| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Restreindre les [agents](https://code.claude.com/docs/fr/sub-agents.md) aux sources de plugins et gérées | Plugins et skills | Géré |233| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Bloquer les [agents](https://code.claude.com/docs/fr/sub-agents.md) provenant des sources utilisateur et projet | Plugins et skills | Géré |

232| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Restreindre les [hooks](https://code.claude.com/docs/fr/hooks.md) aux sources de plugins et gérées | Plugins et skills | Géré |234| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Bloquer les [hooks](https://code.claude.com/docs/fr/hooks.md) provenant des sources utilisateur et projet | Plugins et skills | Géré |

233| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Restreindre les [serveurs MCP](https://code.claude.com/docs/fr/mcp.md) aux sources de plugins et gérées | Plugins et skills | Géré |235| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Bloquer les [serveurs MCP](https://code.claude.com/docs/fr/mcp.md) provenant des sources utilisateur et projet | Plugins et skills | Géré |

234| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Restreindre les [skills](https://code.claude.com/docs/fr/skills.md) aux sources de plugins et gérées | Plugins et skills | Géré |236| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Bloquer les [skills](https://code.claude.com/docs/fr/skills.md) provenant des sources utilisateur et projet | Plugins et skills | Géré |

235| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Choisir la [durée de vie du cache de prompts](https://code.claude.com/docs/fr/prompt-caching.md#cache-lifetime) pour les sous-agents et les autres requêtes hors de la conversation principale | Modèle et réponses | Tout fichier |237| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Choisir la [durée de vie du cache de prompts](https://code.claude.com/docs/fr/prompt-caching.md#cache-lifetime) pour les sous-agents et les autres requêtes hors de la conversation principale | Modèle et réponses | Tout fichier |

236| [`subagentStatusLine`](#subagentstatusline) | Réécrire les lignes de l'affichage des tâches des [sous-agents](https://code.claude.com/docs/fr/sub-agents.md) avec votre propre commande | Interface et terminal | Tout fichier |238| [`subagentStatusLine`](#subagentstatusline) | Réécrire les lignes de l'affichage des tâches des [sous-agents](https://code.claude.com/docs/fr/sub-agents.md) avec votre propre commande | Interface et terminal | Tout fichier |

237| [`switchModelsOnFlag`](#switchmodelsonflag) | Changer de modèle automatiquement ou faire une pause lorsqu'un [classifieur de sécurité](https://code.claude.com/docs/fr/model-config.md#ask-before-switching) signale une requête | Modèle et réponses | Tout fichier |239| [`switchModelsOnFlag`](#switchmodelsonflag) | Changer de modèle automatiquement ou faire une pause lorsqu'un [classifieur de sécurité](https://code.claude.com/docs/fr/model-config.md#ask-before-switching) signale une requête | Modèle et réponses | Tout fichier |

288}290}

289```291```

290 292 

291La clé n'a aucun effet chez les fournisseurs où l'advisor [n'est pas disponible](https://code.claude.com/docs/fr/advisor.md#requirements), comme Amazon Bedrock et Claude Platform on AWS. `"fable"` nécessite l'[accès à Fable](https://code.claude.com/docs/fr/advisor.md#choose-an-advisor-model).293La clé n'a aucun effet chez les fournisseurs où l'advisor [n'est pas disponible](https://code.claude.com/docs/fr/advisor.md#requirements), comme Amazon Bedrock. Sur Claude Platform on AWS, la clé nécessite Claude Code v2.1.300 ou ultérieure. `"fable"` nécessite l'[accès à Fable](https://code.claude.com/docs/fr/advisor.md#choose-an-advisor-model).

292 294 

293### `alwaysThinkingEnabled`295### `alwaysThinkingEnabled`

294 296 

448 450 

449Activez le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) pour les sessions où il est disponible, pour un travail interactif comme l'itération rapide ou le débogage en direct, lorsque vous privilégiez la vitesse au prix d'un coût par token plus élevé. En général, vous ne modifiez pas cette clé vous-même. Exécuter `/fast` écrit `fastMode: true` dans `~/.claude/settings.json`, et l'exécuter à nouveau pour désactiver le mode rapide supprime la clé.451Activez le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) pour les sessions où il est disponible, pour un travail interactif comme l'itération rapide ou le débogage en direct, lorsque vous privilégiez la vitesse au prix d'un coût par token plus élevé. En général, vous ne modifiez pas cette clé vous-même. Exécuter `/fast` écrit `fastMode: true` dans `~/.claude/settings.json`, et l'exécuter à nouveau pour désactiver le mode rapide supprime la clé.

450 452 

451Seuls Fable 5.2, Opus 5.5, Opus 5 et Opus 4.8 prennent en charge le mode rapide. Exécuter `/fast` depuis un autre modèle vous fait basculer sur Opus, et passer à un modèle non pris en charge désactive le mode rapide. Consultez [Changer de modèle lorsque le mode rapide est activé](https://code.claude.com/docs/fr/fast-mode.md#switch-models-while-fast-mode-is-on).453Sur l'API Anthropic, seuls Fable 5.2, Opus 5.5, Opus 5 et Opus 4.8 prennent en charge le mode rapide. Exécuter `/fast` depuis un autre modèle vous fait basculer sur Opus, et passer à un modèle non pris en charge désactive le mode rapide. Consultez [Changer de modèle lorsque le mode rapide est activé](https://code.claude.com/docs/fr/fast-mode.md#switch-models-while-fast-mode-is-on). Sur Agent Platform de Google Cloud, [`/fast` vous fait plutôt basculer sur Fable 5.2](https://code.claude.com/docs/fr/fast-mode#use-fast-mode-on-agent-platform) et n'écrit pas cette clé, et Claude Code ignore un `true` enregistré.

452 454 

453* **Portée** : [`Any file`](#scopes)455* **Portée** : [`Any file`](#scopes)

454* **Type** : booléen456* **Type** : booléen

904Contrôlez quels outils Claude peut utiliser sans demander, lesquels déclenchent une demande de confirmation, et lesquels sont bloqués. Définissez aussi le [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) par défaut des nouvelles sessions. Chaque clé `permissions.*` ci-dessous s'imbrique sous cet objet.906Contrôlez quels outils Claude peut utiliser sans demander, lesquels déclenchent une demande de confirmation, et lesquels sont bloqués. Définissez aussi le [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) par défaut des nouvelles sessions. Chaque clé `permissions.*` ci-dessous s'imbrique sous cet objet.

905 907 

906* **Portée** : [`Any file`](#scopes)908* **Portée** : [`Any file`](#scopes)

907* **Type** : objet avec `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `disableBypassPermissionsMode` et `disableAutoMode`909* **Type** : objet avec `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `denyInsteadOfPrompting`, `disableBypassPermissionsMode` et `disableAutoMode`

908* **Défaut** : non défini910* **Défaut** : non défini

909 911 

910Cet exemple approuve les commandes `npm run` sans demander, invite avant `git push`, bloque les lectures de `.env`, et démarre les sessions en `acceptEdits` :912Cet exemple approuve les commandes `npm run` sans demander, invite avant `git push`, bloque les lectures de `.env`, et démarre les sessions en `acceptEdits` :

1163 1165 

1164Les règles de permission se superposent à chaque mode : les règles `deny` bloquent dans chaque mode, y compris `bypassPermissions`. Consultez [Modes de permission](https://code.claude.com/docs/fr/permission-modes.md). Dans les sessions cloud, Claude Code honore uniquement `acceptEdits`, `plan`, `default` et `auto` de cette clé. Pour les conversations que l'extension VS Code démarre, consultez [quel paramètre l'extension lit pour le mode de permission de démarrage](https://code.claude.com/docs/fr/permission-modes.md#switch-permission-modes).1166Les règles de permission se superposent à chaque mode : les règles `deny` bloquent dans chaque mode, y compris `bypassPermissions`. Consultez [Modes de permission](https://code.claude.com/docs/fr/permission-modes.md). Dans les sessions cloud, Claude Code honore uniquement `acceptEdits`, `plan`, `default` et `auto` de cette clé. Pour les conversations que l'extension VS Code démarre, consultez [quel paramètre l'extension lit pour le mode de permission de démarrage](https://code.claude.com/docs/fr/permission-modes.md#switch-permission-modes).

1165 1167 

1168### `permissions.denyInsteadOfPrompting`

1169 

1170Définissez cette clé sur `true` pour qu'une session continue de s'exécuter quand personne n'est là pour répondre à une demande de permission. Claude Code refuse un appel d'outil qui attendrait autrement une réponse à une demande de permission, et le tour continue. Nécessite Claude Code v2.1.319 ou ultérieur.

1171 

1172Un appel est exécuté si une règle d'autorisation, votre [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) ou le classificateur du mode auto l'approuve. Pour autoriser la plupart des appels qui déclencheraient autrement une demande, répondez depuis un [hook `PermissionRequest`](https://code.claude.com/docs/fr/hooks#permissionrequest).

1173 

1174* **Portée** : [`User or managed`](#scopes), et `--settings`. Un dépôt ne peut pas la définir pour vous.

1175* **Type** : Booléen

1176 * `true` : Claude Code refuse les appels qui déclencheraient autrement une demande

1177 * `false` : identique à non défini ; les appels sont toujours refusés si une autre de ces sources définit `true`

1178* **Défaut** : non défini, donc un appel qui nécessite une approbation vous est soumis par une demande

1179 

1180Dans `~/.claude/settings.json`, cet exemple démarre les sessions en mode auto et refuse tout ce qui aboutirait encore à une demande de permission :

1181 

1182```json settings.json theme={null}

1183{

1184 "permissions": {

1185 "defaultMode": "auto",

1186 "denyInsteadOfPrompting": true

1187 }

1188}

1189```

1190 

1191La clé s'applique dans les exécutions `-p`, les sessions de terminal interactives, l'[extension VS Code](https://code.claude.com/docs/fr/vs-code.md), les sessions locales dans l'[application Desktop](https://code.claude.com/docs/fr/desktop.md), les [sous-agents](https://code.claude.com/docs/fr/sub-agents.md) et les [équipes d'agents](https://code.claude.com/docs/fr/agent-teams.md). Pour refuser plutôt ce qui déclencherait une demande dans une seule exécution [non interactive](https://code.claude.com/docs/fr/headless.md), passez [`--permission-prompts none`](https://code.claude.com/docs/fr/headless#turn-off-permission-prompts-in-unattended-runs) avec `-p`.

1192 

1193#### Ce que `denyInsteadOfPrompting` arrête d'autre

1194 

1195Avec le paramètre activé, Claude Code arrête aussi ces demandes de réponse :

1196 

1197* **Outils de question et de plan** : Claude Code omet [`AskUserQuestion`](https://code.claude.com/docs/fr/tools-reference#askuserquestion-tool-behavior), `EnterPlanMode` et `ExitPlanMode`, de sorte qu'une session en mode plan ne peut pas en sortir d'elle-même. Un coéquipier dans une équipe d'agents conserve `EnterPlanMode` et `ExitPlanMode`

1198* **Élicitation MCP** : Claude Code annule une [requête d'élicitation](https://code.claude.com/docs/fr/mcp.md#respond-to-mcp-elicitation-requests) sauf si un [hook `Elicitation`](https://code.claude.com/docs/fr/hooks#elicitation) y répond

1199* **Hôtes de permission** : Claude Code n'interroge pas votre [callback `canUseTool`](https://code.claude.com/docs/fr/agent-sdk/user-input) ni [`--permission-prompt-tool`](https://code.claude.com/docs/fr/cli-reference#cli-flags). Pour approuver des appels depuis du code, répondez depuis un hook `PermissionRequest`. Certains appels sont refusés avant qu'un hook soit consulté, comme une [suppression de chemin critique](https://code.claude.com/docs/fr/permission-modes.md#critical-path-removals-in-each-permission-mode) en mode `auto` qu'aucune règle ask ne couvre.

1200* **Avis de facturation du classificateur** : là où l'[avis sur les requêtes facturées du classificateur](https://code.claude.com/docs/fr/auto-mode-classifier-billing.md) ouvrirait un dialogue, Claude Code ne l'affiche pas et refuse les actions qui nécessitent ces requêtes

1201 

1202Une session peut encore attendre le [dialogue de confiance d'espace de travail](https://code.claude.com/docs/fr/permissions.md#project-allow-rules-and-workspace-trust) et l'[approbation des serveurs MCP du projet](https://code.claude.com/docs/fr/mcp.md#project-server-approvals-and-workspace-trust). Répondez aux deux avant de laisser la session s'exécuter.

1203 

1204#### Messages de `denyInsteadOfPrompting`

1205 

1206Ces messages signalent des appels refusés. Ce ne sont pas des demandes, donc rien n'attend votre réponse.

1207 

1208Le refus que Claude lit peut commencer par ce texte :

1209 

1210```text theme={null}

1211Permission for this tool use was denied. It requires approval, and this session has no approval surface

1212```

1213 

1214Dans la sortie `stream-json`, [les exécutions qui émettent un message `permission_denied`](https://code.claude.com/docs/fr/agent-sdk/typescript#sdkpermissiondeniedmessage) signalent ce `decision_reason` :

1215 

1216```text theme={null}

1217no approval surface in this session; permission request denied automatically

1218```

1219 

1220En mode auto avec le paramètre activé, le tour se termine après 20 appels consécutifs que le classificateur a bloqués ou qu'une [vérification de sécurité a refusés](https://code.claude.com/docs/fr/errors.md#auto-mode-cannot-determine-the-safety-of-an-action), et vous voyez ce message :

1221 

1222```text theme={null}

122320 actions were refused and no work went ahead in between, so Claude stopped.

1224```

1225 

1226Une exécution `-p` signale ce tour comme `error_during_execution`.

1227 

1166### `permissions.disableBypassPermissionsMode`1228### `permissions.disableBypassPermissionsMode`

1167 1229 

1168Empêchez quiconque d'entrer en mode `bypassPermissions`. Claude Code rejette alors le flag `--dangerously-skip-permissions`, et ignore le `permissionMode: bypassPermissions` d'une [définition d'agent](https://code.claude.com/docs/fr/sub-agents.md#permission-modes), donc le sous-agent s'exécute avec le mode de permission de la session parent.1230Empêchez quiconque d'entrer en mode `bypassPermissions`. Claude Code rejette alors le flag `--dangerously-skip-permissions`, et ignore le `permissionMode: bypassPermissions` d'une [définition d'agent](https://code.claude.com/docs/fr/sub-agents.md#permission-modes), donc le sous-agent s'exécute avec le mode de permission de la session parent.

1202 1264 

1203Ignorez le dialogue de confirmation que Claude Code affiche avant qu'une session entre en mode `bypassPermissions`, que ce soit via `--dangerously-skip-permissions` ou via `defaultMode: "bypassPermissions"`. Claude Code écrit `true` ici dans vos paramètres utilisateur quand vous acceptez ce dialogue une fois.1265Ignorez le dialogue de confirmation que Claude Code affiche avant qu'une session entre en mode `bypassPermissions`, que ce soit via `--dangerously-skip-permissions` ou via `defaultMode: "bypassPermissions"`. Claude Code écrit `true` ici dans vos paramètres utilisateur quand vous acceptez ce dialogue une fois.

1204 1266 

1205* **Portée** : [`User, local, or managed`](#scopes). Un dépôt non approuvé ne peut pas ignorer le dialogue pour vous.1267* **Portée** : [`User, local, or managed`](#scopes), et les fichiers passés avec `--settings`. Les [sessions en arrière-plan](https://code.claude.com/docs/fr/permission-modes.md#bypass-permissions-ignored-in-a-background-session) ne prennent en compte que les paramètres utilisateur et gérés. Un dépôt non approuvé ne peut pas ignorer le dialogue pour vous.

1206* **Type** : Booléen1268* **Type** : Booléen

1207 * `true` : Claude Code ignore le dialogue de confirmation avant qu'une session entre en mode `bypassPermissions`1269 * `true` : Claude Code ignore le dialogue de confirmation avant qu'une session entre en mode `bypassPermissions`

1208 * `false` : identique à non défini ; le dialogue apparaît sauf si un de ces fichiers définit `true`1270 * `false` : identique à non défini ; le dialogue apparaît sauf si un de ces fichiers définit `true`

3132 3194 

3133### `syntaxHighlightingDisabled`3195### `syntaxHighlightingDisabled`

3134 3196 

3135Claude Code colore le code par langage dans les diffs, les blocs de code, et les aperçus de fichier qu'il affiche dans le terminal, avec son surlignage intégré ; aucun plugin ou serveur de langage n'est impliqué. Définissez cette clé à `true` pour les afficher en texte brut à la place, par exemple si les couleurs entrent en conflit avec votre thème de terminal ou ralentissent un lecteur d'écran.3197Claude Code colore le code selon le langage dans les diffs, les blocs de code et les aperçus de fichiers qu'il affiche dans le terminal, avec son surligneur intégré. Définissez cette clé à `true` pour les afficher en texte brut à la place, par exemple si les couleurs entrent en conflit avec le thème de votre terminal ou ralentissent un lecteur d'écran.

3136 3198 

3137* **Portée** : [`N'importe quel fichier`](#scopes)3199* **Portée** : [`N'importe quel fichier`](#scopes)

3138* **Type** : Booléen3200* **Type** : Booléen

4110 4172 

4111### `strictPluginOnlyCustomization`4173### `strictPluginOnlyCustomization`

4112 4174 

4113Bloquez les skills, agents, hooks et serveurs MCP provenant de sources utilisateur et projet, afin qu'ils ne puissent provenir que de plugins ou de paramètres gérés. Combinez-le avec [`strictKnownMarketplaces`](#strictknownmarketplaces) pour contrôler la chaîne d'approvisionnement de personnalisation complète : la liste d'autorisation de marketplace contrôle les plugins que les utilisateurs peuvent installer.4175Bloquez les skills, agents, hooks et serveurs MCP provenant de sources utilisateur et projet. Combinez-le avec [`strictKnownMarketplaces`](#strictknownmarketplaces) pour choisir les marketplaces à partir desquelles les utilisateurs peuvent installer des plugins. Ajoutez [`disableSideloadFlags`](#disablesideloadflags) pour rejeter les flags CLI qui chargent latéralement des plugins, agents et serveurs MCP pour une seule exécution.

4114 4176 

4115* **Scope** : [`Managed`](#scopes)4177* **Scope** : [`Managed`](#scopes)

4116* **Type** : `true` pour verrouiller les quatre types de personnalisation, ou un tableau nommant les types à verrouiller, parmi `"skills"`, `"agents"`, `"hooks"`, et `"mcp"`4178* **Type** : `true` pour les verrouiller tous, ou un tableau nommant ceux à verrouiller, parmi `"skills"`, `"agents"`, `"hooks"`, et `"mcp"`

4117* **Default** : unset, donc rien n'est verrouillé4179* **Default** : unset, donc rien n'est verrouillé

4118 4180 

4119Cet exemple verrouille les skills et hooks et laisse les agents et serveurs MCP déverrouillés :4181Cet exemple verrouille les skills et hooks et laisse les agents et serveurs MCP déverrouillés :

4216Chaque portée sert un objectif différent :4278Chaque portée sert un objectif différent :

4217 4279 

4218* **Paramètres utilisateur** : vos préférences personnelles de plugin4280* **Paramètres utilisateur** : vos préférences personnelles de plugin

4219* **Paramètres de projet** : plugins partagés avec tout le monde dans le dépôt4281* **Paramètres de projet** : plugins activés pour tout le monde dans le dépôt. Cela ne les installe pas, donc chaque utilisateur [les installe](https://code.claude.com/docs/fr/plugins/org.md#require-plugins-per-repository).

4220* **Paramètres locaux** : remplacements par machine, ignorés par git lorsque Claude Code enregistre un paramètre là4282* **Paramètres locaux** : remplacements par machine, ignorés par git lorsque Claude Code enregistre un paramètre là

4221* **Paramètres gérés** : politique à l'échelle de l'organisation. Un plugin défini à `false` ici est bloqué de l'installation à chaque portée et masqué de la marketplace4283* **Paramètres gérés** : politique à l'échelle de l'organisation. Un plugin défini à `false` ici est bloqué de l'installation à chaque portée et masqué de la marketplace

4222 4284 

4223Les paramètres de projet ont priorité sur les paramètres utilisateur, donc définir un plugin à `false` dans `~/.claude/settings.json` ne désactive pas un plugin que le `.claude/settings.json` du projet active. Pour refuser un plugin activé par le projet sur votre machine, définissez-le à `false` dans `.claude/settings.local.json` à la place. Les plugins forcément activés par les paramètres gérés ne peuvent pas être désactivés de cette façon, puisque les paramètres gérés remplacent les paramètres locaux.4285Les paramètres de projet ont priorité sur les paramètres utilisateur, donc définir un plugin à `false` dans `~/.claude/settings.json` ne désactive pas un plugin que le `.claude/settings.json` du projet active. Pour refuser un plugin activé par le projet sur votre machine, définissez-le à `false` dans `.claude/settings.local.json` à la place. Les plugins forcément activés par les paramètres gérés ne peuvent pas être désactivés de cette façon, puisque les paramètres gérés remplacent les paramètres locaux.

4224 4286 

4225L'activation d'un plugin à partir d'une source externe telle qu'un dépôt GitHub ou un package npm dans le `.claude/settings.json` d'un projet ne l'installe pas pour d'autres personnes. Sur chaque chemin qui charge les plugins, Claude Code signale le plugin comme non installé jusqu'à ce que chaque utilisateur [l'installe lui-même](https://code.claude.com/docs/fr/plugins/org.md#require-plugins-per-repository).

4226 

4227### `extraKnownMarketplaces`4287### `extraKnownMarketplaces`

4228 4288 

4229Enregistrez des marketplaces de plugins supplémentaires par nom, afin que les personnes qui ouvrent le dépôt, ou tout le monde que vos paramètres gérés atteignent, obtiennent la marketplace sans l'ajouter eux-mêmes. Claude Code enregistre chaque marketplace qu'il ne connaît pas déjà. Que le plugin que [`enabledPlugins`](#enabledplugins) nomme à partir de celle-ci s'installe dépend de la source du plugin et du fichier qui l'active ; cette entrée a les règles.4289Enregistrez des marketplaces de plugins supplémentaires par nom, afin que les personnes qui ouvrent le dépôt, ou tout le monde que vos paramètres gérés atteignent, obtiennent la marketplace sans l'ajouter eux-mêmes. Claude Code enregistre chaque marketplace qu'il ne connaît pas déjà. Que le plugin que [`enabledPlugins`](#enabledplugins) nomme à partir de celle-ci s'installe dépend de la source du plugin et du fichier qui l'active ; [Activé dans les paramètres de projet mais non installé](https://code.claude.com/docs/fr/plugins/loading.md#enabled-in-project-settings-but-not-installed) présente les règles.

4230 4290 

4231* **Scope** : [`Any file`](#scopes). Claude Code honore les entrées dans le `.claude/settings.json` ou `.claude/settings.local.json` d'un dépôt uniquement après que vous acceptiez la boîte de dialogue de confiance de l'espace de travail pour ce dossier ; dans un dossier que vous n'avez pas approuvé, y compris une exécution `-p` là, il les ignore sans message.4291* **Scope** : [`Any file`](#scopes). Claude Code honore les entrées dans le `.claude/settings.json` ou `.claude/settings.local.json` d'un dépôt uniquement après que vous acceptiez la boîte de dialogue de confiance de l'espace de travail pour ce dossier ; dans un dossier que vous n'avez pas approuvé, y compris une exécution `-p` là, il les ignore sans message.

4232* **Type** : objet mappant un nom de marketplace à un objet avec un objet `source` et un Boolean `autoUpdate` optionnel4292* **Type** : objet mappant un nom de marketplace à un objet avec un objet `source` et un Boolean `autoUpdate` optionnel

4354 4414 

4355Listez les plugins gérés dont les [mods](https://code.claude.com/docs/fr/plugins/mods/overview.md) s'exécutent avant chaque mod qu'un utilisateur installe, dans l'ordre listé. Lorsque vous définissez cette clé dans les paramètres gérés, nommez `sec-default@builtin` dans la liste pour conserver le garde-fou intégré. Dans les paramètres gérés, Claude Code ignore un id dont le plugin ne compte pas comme celui de votre organisation. Consultez [Installer les mods de votre organisation et définir l'ordre](https://code.claude.com/docs/fr/plugins/mods/admin.md#install-your-organizations-mods) pour ces conditions et pour la façon dont les deux clés d'ordre fonctionnent ensemble.4415Listez les plugins gérés dont les [mods](https://code.claude.com/docs/fr/plugins/mods/overview.md) s'exécutent avant chaque mod qu'un utilisateur installe, dans l'ordre listé. Lorsque vous définissez cette clé dans les paramètres gérés, nommez `sec-default@builtin` dans la liste pour conserver le garde-fou intégré. Dans les paramètres gérés, Claude Code ignore un id dont le plugin ne compte pas comme celui de votre organisation. Consultez [Installer les mods de votre organisation et définir l'ordre](https://code.claude.com/docs/fr/plugins/mods/admin.md#install-your-organizations-mods) pour ces conditions et pour la façon dont les deux clés d'ordre fonctionnent ensemble.

4356 4416 

4357* **Scope** : [`User or managed`](#scopes). Claude Code lit la clé à partir des paramètres gérés. Il lit la clé à partir des paramètres utilisateur uniquement sur une machine sans paramètres gérés, dans une session dont les identifiants ne proviennent pas d'un `/login` Team ou Enterprise. Il ignore la clé dans les paramètres de projet et locaux et dans un fichier `--settings`.4417* **Scope** : [`User or managed`](#scopes). Claude Code lit la clé à partir des paramètres gérés. Il lit la clé à partir des paramètres utilisateur uniquement sur une machine sans paramètres gérés ni fichier `managed-mcp.json`, dans une session dont les identifiants ne proviennent pas d'un `/login` Team ou Enterprise. Il ignore la clé dans les paramètres de projet et locaux et dans un fichier `--settings`.

4358* **Type** : tableau de chaînes `plugin-name@marketplace-name`4418* **Type** : tableau de chaînes `plugin-name@marketplace-name`

4359* **Default** : unset4419* **Default** : unset

4360 4420 

4374 4434 

4375Listez les plugins gérés dont les [mods](https://code.claude.com/docs/fr/plugins/mods/overview.md) s'exécutent après chaque mod qu'un utilisateur installe, dans l'ordre listé. Un id listé à la fois dans `prependPlugins` et `appendPlugins` est placé en tête. Dans les paramètres gérés, Claude Code ignore un id dont le plugin ne [compte pas comme celui de votre organisation](https://code.claude.com/docs/fr/plugins/mods/admin.md#install-your-organizations-mods).4435Listez les plugins gérés dont les [mods](https://code.claude.com/docs/fr/plugins/mods/overview.md) s'exécutent après chaque mod qu'un utilisateur installe, dans l'ordre listé. Un id listé à la fois dans `prependPlugins` et `appendPlugins` est placé en tête. Dans les paramètres gérés, Claude Code ignore un id dont le plugin ne [compte pas comme celui de votre organisation](https://code.claude.com/docs/fr/plugins/mods/admin.md#install-your-organizations-mods).

4376 4436 

4377* **Scope** : [`User or managed`](#scopes). Claude Code lit la clé à partir des paramètres gérés. Il lit la clé à partir des paramètres utilisateur uniquement sur une machine sans paramètres gérés, dans une session dont les identifiants ne proviennent pas d'un `/login` Team ou Enterprise. Il ignore la clé dans les paramètres de projet et locaux et dans un fichier `--settings`.4437* **Scope** : [`User or managed`](#scopes). Claude Code lit la clé à partir des paramètres gérés. Il lit la clé à partir des paramètres utilisateur uniquement sur une machine sans paramètres gérés ni fichier `managed-mcp.json`, dans une session dont les identifiants ne proviennent pas d'un `/login` Team ou Enterprise. Il ignore la clé dans les paramètres de projet et locaux et dans un fichier `--settings`.

4378* **Type** : tableau de chaînes `plugin-name@marketplace-name`4438* **Type** : tableau de chaînes `plugin-name@marketplace-name`

4379* **Default** : unset4439* **Default** : unset

4380 4440 

4612 4672 

4613### `crossSessionInbound`4673### `crossSessionInbound`

4614 4674 

4615Choisissez ce que cette session fait avec les [messages provenant de vos autres sessions Claude Code](https://code.claude.com/docs/fr/cross-session-messaging.md#control-inbound-messages). Quand aucune valeur ne s'applique, Claude Code décide par message à partir des classes de mode de permission des deux sessions. Nécessite Claude Code v2.1.224 ou ultérieur.4675Choisissez ce que cette session fait avec les [messages provenant de vos autres sessions Claude Code](https://code.claude.com/docs/fr/cross-session-messaging.md#control-inbound-messages). Quand aucune valeur ne s'applique, Claude Code décide par message à partir des classes de mode de permission des deux sessions.

4616 4676 

4617* **Scope** : [`Any file`](#scopes). Une valeur de projet ou locale s'applique uniquement quand elle est plus stricte que la valeur des paramètres gérés, du flag `--settings`, ou des paramètres utilisateur.4677* **Scope** : [`Any file`](#scopes). Une valeur de projet ou locale s'applique uniquement quand elle est plus stricte que la valeur des paramètres gérés, du flag `--settings`, ou des paramètres utilisateur.

4618* **Type** : string, l'un de :4678* **Type** : string, l'un de :

4946}5006}

4947```5007```

4948 5008 

5009### `disableRemotePreviewScripts`

5010 

5011Empêcher l'exécution de scripts lorsque des personnes [prévisualisent un fichier HTML](https://code.claude.com/docs/fr/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) depuis une session SSH ou WSL dans l'application de bureau. La navigation externe dans le volet Browser n'est pas affectée.

5012 

5013L'application de bureau lit cette clé ; le CLI du terminal l'ignore. Nécessite Claude Desktop v5.1231.0 ou ultérieur. Les versions antérieures ignorent la clé : pour y bloquer les scripts, définissez également [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation), qui désactive aussi la navigation externe.

5014 

5015* **Portée** : [`Géré`](#scopes). L'application de bureau ne lit pas la clé depuis la machine distante ni depuis la distribution WSL.

5016* **Type** : Booléen ; seul le Booléen JSON `true` a un effet

5017 * `true` : les aperçus HTML dans les sessions SSH et WSL n'exécutent pas de scripts

5018 * `false` : la clé ne désactive pas les scripts

5019* **Défaut** : non défini, donc la clé n'a aucun effet

5020 

5021Si l'ordinateur qui exécute l'application de bureau ne reçoit aucun autre paramètre géré de Claude Code, définissez également [`parentSettingsBehavior`](#parentsettingsbehavior) sur `"merge"` dans les paramètres gérés que vous créez. Sur Windows, si vous créez un fichier de paramètres gérés, les utilisateurs perdent également les sessions WSL jusqu'à ce que vous [les autorisiez](https://code.claude.com/docs/fr/admin-setup.md#wsl-sessions-in-claude-code-desktop). [Désactiver les scripts dans les aperçus SSH et WSL pour votre organisation](https://code.claude.com/docs/fr/desktop.md#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) explique ces deux points et indique où définir la clé.

5022 

5023Cet exemple montre la clé seule, telle que vous l'ajouteriez aux paramètres gérés qu'un ordinateur reçoit déjà :

5024 

5025```json managed-settings.json theme={null}

5026{

5027 "disableRemotePreviewScripts": true

5028}

5029```

5030 

5031L'application de bureau ignore toute autre valeur, et une valeur qui n'est pas un Booléen, comme la chaîne `"true"` ou `1`, consigne également un avertissement.

5032 

4949### `enableArtifact`5033### `enableArtifact`

4950 5034 

4951Désactiver l'outil [Artifact](https://code.claude.com/docs/fr/artifacts.md), qui publie la sortie de session en tant que page web privée sur claude.ai. Quand vous désactivez la ligne **Artifacts** dans `/config`, Claude Code écrit cette clé dans vos paramètres utilisateur, donc vous ne l'éditez généralement pas à la main.5035Désactiver l'outil [Artifact](https://code.claude.com/docs/fr/artifacts.md), qui publie la sortie de session en tant que page web privée sur claude.ai. Quand vous désactivez la ligne **Artifacts** dans `/config`, Claude Code écrit cette clé dans vos paramètres utilisateur, donc vous ne l'éditez généralement pas à la main.

5219 5303 

5220### `forceLoginMethod`5304### `forceLoginMethod`

5221 5305 

5222Restreignez le type de compte avec lequel les utilisateurs peuvent se connecter. Définissez `"claudeai"` pour n'autoriser que les comptes claude.ai, `"console"` pour n'autoriser que les comptes Claude Console, ou `"gateway"` pour diriger les utilisateurs vers une [passerelle cloud](https://code.claude.com/docs/fr/claude-apps-gateway) au lieu d'une connexion first-party. Les administrateurs le définissent dans les paramètres gérés et l'associent à [`forceLoginOrgUUID`](#forceloginorguuid) pour maintenir les connexions claude.ai des développeurs au sein d'une seule organisation.5306Restreignez le type de compte avec lequel les utilisateurs peuvent se connecter : `"claudeai"` pour la connexion claude.ai ou `"console"` pour la connexion Claude Console. Définissez `"gateway"` pour diriger les utilisateurs vers une [passerelle cloud](https://code.claude.com/docs/fr/claude-apps-gateway) au lieu d'une connexion first-party. Les administrateurs le définissent dans les paramètres gérés et l'associent à [`forceLoginOrgUUID`](#forceloginorguuid) pour maintenir les connexions claude.ai des développeurs au sein d'une seule organisation.

5223 5307 

5224Si vous le définissez sur `"claudeai"` dans n'importe quel fichier de paramètres, Claude Code cesse également de proposer la [connexion Console sans clé](https://code.claude.com/docs/fr/authentication.md#sign-in-without-an-api-key) dans les sessions auxquelles ce fichier s'applique. Avec `"console"` seul, les utilisateurs peuvent encore accéder à la connexion sans clé après un échec de connexion. Pour que Claude Code cesse de la proposer, consultez [Cesser de proposer la connexion sans clé sur les machines gérées](https://code.claude.com/docs/fr/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines), qui répertorie également ce que `forceLoginOrgUUID` modifie par ailleurs.5308Si vous le définissez sur `"claudeai"` dans n'importe quel fichier de paramètres, Claude Code cesse également de proposer la [connexion Console sans clé](https://code.claude.com/docs/fr/authentication.md#sign-in-without-an-api-key) dans les sessions auxquelles ce fichier s'applique. Avec `"console"` seul, les utilisateurs peuvent encore accéder à la connexion sans clé après un échec de connexion. Pour que Claude Code cesse de la proposer, consultez [Cesser de proposer la connexion sans clé sur les machines gérées](https://code.claude.com/docs/fr/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines), qui répertorie également ce que `forceLoginOrgUUID` modifie par ailleurs.

5225 5309 

5226* **Portée** : [`Any file`](#scopes). Claude Code prend en compte `"gateway"` depuis les mêmes sources que [`forceLoginGatewayUrl`](#forcelogingatewayurl) et le traite comme non défini partout ailleurs.5310* **Portée** : [`Any file`](#scopes). Claude Code prend en compte `"gateway"` depuis les mêmes sources que [`forceLoginGatewayUrl`](#forcelogingatewayurl) et le traite comme non défini partout ailleurs.

5227* **Type** : chaîne, parmi :5311* **Type** : chaîne, parmi :

5228 * `"claudeai"` : seuls les comptes claude.ai peuvent se connecter5312 * `"claudeai"` : connexion claude.ai

5229 * `"console"` : seuls les comptes Claude Console peuvent se connecter5313 * `"console"` : connexion Claude Console

5230 * `"gateway"` : Claude Code dirige les utilisateurs vers une passerelle cloud au lieu d'une connexion first-party5314 * `"gateway"` : Claude Code dirige les utilisateurs vers une passerelle cloud au lieu d'une connexion first-party

5231* **Valeur par défaut** : non défini, donc les utilisateurs choisissent une méthode de connexion5315* **Valeur par défaut** : non défini, donc les utilisateurs choisissent une méthode de connexion

5232 5316 

5471 5555 

5472Définissez le nombre de jours pendant lesquels Claude Code conserve les [transcriptions de session et autres données d'application](https://code.claude.com/docs/fr/claude-directory.md#cleaned-up-automatically) avant de les supprimer. Claude Code exécute la suppression en tant que balayage en arrière-plan après le démarrage d'une session, tant qu'il peut déterminer en toute sécurité la période de rétention. Le balayage supprime les transcriptions sans afficher de message, donc une session que vous n'avez pas utilisée plus longtemps que la période de rétention n'apparaît plus dans le sélecteur [`/resume`](https://code.claude.com/docs/fr/sessions#resume-a-session).5556Définissez le nombre de jours pendant lesquels Claude Code conserve les [transcriptions de session et autres données d'application](https://code.claude.com/docs/fr/claude-directory.md#cleaned-up-automatically) avant de les supprimer. Claude Code exécute la suppression en tant que balayage en arrière-plan après le démarrage d'une session, tant qu'il peut déterminer en toute sécurité la période de rétention. Le balayage supprime les transcriptions sans afficher de message, donc une session que vous n'avez pas utilisée plus longtemps que la période de rétention n'apparaît plus dans le sélecteur [`/resume`](https://code.claude.com/docs/fr/sessions#resume-a-session).

5473 5557 

5558Par défaut, Claude Code conserve au-delà de cette période les transcriptions des sessions que vous avez démarrées ou continuées le plus récemment dans Claude Desktop ou Cowork, même si vous définissez vous-même cette clé. Cette période [s'applique toutefois à elles dans certains cas](https://code.claude.com/docs/fr/claude-directory.md#cleaned-up-automatically), par exemple avec la configuration HIPAA. Avant la v2.1.248, Claude Code les supprimait après cette période.

5559 

5474* **Portée** : [`Any file`](#scopes)5560* **Portée** : [`Any file`](#scopes)

5475* **Type** : nombre de jours, un nombre entier, minimum `1`5561* **Type** : nombre de jours, un nombre entier, minimum `1`

5476* **Valeur par défaut** : `30`5562* **Valeur par défaut** : `30`

5485 5571 

5486### `desktopSessionCleanupPeriodDays`5572### `desktopSessionCleanupPeriodDays`

5487 5573 

5488Définissez une limite d'âge en jours pour les transcriptions des sessions que vous avez démarrées ou continuées le plus récemment dans Claude Desktop ou Cowork. Sans cette clé, Claude Code [conserve ces transcriptions à tout âge](https://code.claude.com/docs/fr/claude-directory.md#cleaned-up-automatically). Claude Code supprime chacune une fois qu'elle est plus ancienne que cette limite et [`cleanupPeriodDays`](#cleanupperioddays), donc avec `cleanupPeriodDays` à sa valeur par défaut de 30, une valeur de `7` les conserve toujours 30 jours. [Nettoyage automatique](https://code.claude.com/docs/fr/claude-directory.md#cleaned-up-automatically) répertorie les cas où `cleanupPeriodDays` s'applique à la place et où Claude Code ignore cette clé. Nécessite Claude Code v2.1.248 ou version ultérieure.5574Définissez une limite d'âge en jours pour les transcriptions des sessions que vous avez démarrées ou continuées le plus récemment dans Claude Desktop ou Cowork. Sans cette clé, Claude Code [conserve ces transcriptions à tout âge](https://code.claude.com/docs/fr/claude-directory.md#cleaned-up-automatically), sauf dans certains cas, par exemple pour une session que vous avez supprimée dans Claude Desktop. Nécessite Claude Code v2.1.248 ou version ultérieure.

5575 

5576Claude Code supprime chaque transcription une fois qu'elle est plus ancienne à la fois que cette limite et que [`cleanupPeriodDays`](#cleanupperioddays), donc avec `cleanupPeriodDays` à sa valeur par défaut de 30, une valeur de `7` les conserve toujours 30 jours. [Nettoyage automatique](https://code.claude.com/docs/fr/claude-directory.md#cleaned-up-automatically) répertorie les cas où `cleanupPeriodDays` s'applique à la place et où Claude Code ignore cette clé.

5489 5577 

5490* **Portée** : [`User or managed`](#scopes). Claude Code lit également la clé à partir d'un fichier que vous transmettez avec `--settings`, et l'ignore dans les paramètres de projet et locaux.5578* **Portée** : [`User or managed`](#scopes). Claude Code lit également la clé à partir d'un fichier que vous transmettez avec `--settings`, et l'ignore dans les paramètres de projet et locaux.

5491* **Type** : nombre de jours, un nombre entier, minimum `0`5579* **Type** : nombre de jours, un nombre entier, minimum `0`