SpyBara
Go Premium

Documentation 2026-06-23 22:00 UTC to 2026-06-24 22:02 UTC

26 files changed +183 −63. View all changes and history on the product overview
2026
Thu 25 06:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

admin-setup.md +3 −2

Details

63 63 

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

65 65 

66Quel que soit le mécanisme que vous choisissez, les valeurs gérées prennent précédence sur les paramètres utilisateur et projet. Les paramètres de tableau tels que `permissions.allow` et `permissions.deny` fusionnent les entrées de toutes les sources, donc les développeurs peuvent étendre les listes gérées mais pas les supprimer.66Quel que soit le mécanisme que vous choisissez, les valeurs gérées prennent précédence sur les paramètres utilisateur et projet. Les paramètres de tableau tels que `permissions.allow` et `permissions.deny` fusionnent les entrées de toutes les sources, donc les développeurs peuvent étendre les listes gérées mais pas les supprimer, avec [deux exceptions](/fr/settings#settings-precedence) où la valeur gérée remplace les couches inférieures plutôt que de fusionner : `fallbackModel` et `availableModels`.

67 67 

68Consultez [Paramètres gérés par le serveur](/fr/server-managed-settings) et [Fichiers de paramètres et précédence](/fr/settings#settings-files).68Consultez [Paramètres gérés par le serveur](/fr/server-managed-settings) et [Fichiers de paramètres et précédence](/fr/settings#settings-files).

69 69 


74Les paramètres gérés peuvent verrouiller les outils, l'exécution du sandbox, restreindre les serveurs MCP et les sources de plugins, et contrôler les hooks qui s'exécutent. Chaque ligne est une surface de contrôle avec les clés de paramètres qui la pilotent.74Les paramètres gérés peuvent verrouiller les outils, l'exécution du sandbox, restreindre les serveurs MCP et les sources de plugins, et contrôler les hooks qui s'exécutent. Chaque ligne est une surface de contrôle avec les clés de paramètres qui la pilotent.

75 75 

76| Contrôle | Ce qu'il fait | Paramètres clés |76| Contrôle | Ce qu'il fait | Paramètres clés |

77| :----------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- |77| :----------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- |

78| [Règles de permission](/fr/permissions) | Autoriser, demander ou refuser des outils et commandes spécifiques | `permissions.allow`, `permissions.deny` |78| [Règles de permission](/fr/permissions) | Autoriser, demander ou refuser des outils et commandes spécifiques | `permissions.allow`, `permissions.deny` |

79| [Verrouillage des permissions](/fr/permissions#managed-only-settings) | Seules les règles de permission gérées s'appliquent ; désactiver `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |79| [Verrouillage des permissions](/fr/permissions#managed-only-settings) | Seules les règles de permission gérées s'appliquent ; désactiver `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |

80| [Sandboxing](/fr/sandboxing) | Isolation du système de fichiers et du réseau au niveau du système d'exploitation avec listes blanches de domaines | `sandbox.enabled`, `sandbox.network.allowedDomains` |80| [Sandboxing](/fr/sandboxing) | Isolation du système de fichiers et du réseau au niveau du système d'exploitation avec listes blanches de domaines | `sandbox.enabled`, `sandbox.network.allowedDomains` |


84| [Verrouillage de la personnalisation](/fr/settings#strictpluginonlycustomization) | Bloquer les skills, agents, hooks et serveurs MCP provenant de sources utilisateur et projet, afin qu'ils ne proviennent que de plugins ou de paramètres gérés | `strictPluginOnlyCustomization` |84| [Verrouillage de la personnalisation](/fr/settings#strictpluginonlycustomization) | Bloquer les skills, agents, hooks et serveurs MCP provenant de sources utilisateur et projet, afin qu'ils ne proviennent que de plugins ou de paramètres gérés | `strictPluginOnlyCustomization` |

85| [Restrictions des hooks](/fr/settings#hook-configuration) | Seuls les hooks gérés se chargent ; restreindre les URL des hooks HTTP | `allowManagedHooksOnly`, `allowedHttpHookUrls` |85| [Restrictions des hooks](/fr/settings#hook-configuration) | Seuls les hooks gérés se chargent ; restreindre les URL des hooks HTTP | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

86| [Désactiver la vue agent](/fr/agent-view#how-background-sessions-are-hosted) | Désactiver `claude agents`, `--bg`, `/background`, et le superviseur à la demande | `disableAgentView` |86| [Désactiver la vue agent](/fr/agent-view#how-background-sessions-are-hosted) | Désactiver `claude agents`, `--bg`, `/background`, et le superviseur à la demande | `disableAgentView` |

87| [Restrictions de modèle](/fr/model-config#restrict-model-selection) | Restreindre les modèles que les utilisateurs peuvent sélectionner, et optionnellement appliquer également la liste blanche à la sélection du modèle par défaut. Consultez [couverture de surface](/fr/model-config#surface-coverage) pour voir comment ce paramètre atteint l'interface CLI, web et IDE | `availableModels`, `enforceAvailableModels` |

87| [Plancher de version](/fr/settings) | Empêcher la mise à jour automatique d'installer en dessous d'un minimum à l'échelle de l'organisation | `minimumVersion` |88| [Plancher de version](/fr/settings) | Empêcher la mise à jour automatique d'installer en dessous d'un minimum à l'échelle de l'organisation | `minimumVersion` |

88| [Plage de version requise](/fr/settings) | Refuser de démarrer complètement lorsque la version en cours d'exécution est en dehors d'une plage approuvée par l'organisation. Plus fort que `minimumVersion`, qui bloque uniquement les rétrograder | `requiredMinimumVersion`, `requiredMaximumVersion` |89| [Plage de version requise](/fr/settings) | Refuser de démarrer complètement lorsque la version en cours d'exécution est en dehors d'une plage approuvée par l'organisation. Plus fort que `minimumVersion`, qui bloque uniquement les rétrograder | `requiredMinimumVersion`, `requiredMaximumVersion` |

89 90 

advisor.md +4 −4

Details

52/advisor opus52/advisor opus

53```53```

54 54 

55Votre sélection est enregistrée dans `advisorModel` dans vos paramètres utilisateur et persiste entre les sessions. Si votre modèle principal actuel ne supporte pas l'advisor, la sélection est toujours enregistrée et s'active lorsque vous basculez vers un [modèle principal compatible](#choose-an-advisor-model) avec [`/model`](/fr/model-config#setting-your-model).55Votre sélection est enregistrée dans `advisorModel` dans vos paramètres utilisateur et persiste entre les sessions. Si la liste d'autorisation [`availableModels`](/fr/model-config#restrict-model-selection) de votre organisation exclut le modèle advisor enregistré, l'advisor n'est pas invoqué jusqu'à ce que vous choisissiez un modèle autorisé avec `/advisor`. Si votre modèle principal actuel ne supporte pas l'advisor, la sélection est toujours enregistrée et s'active lorsque vous basculez vers un [modèle principal compatible](#choose-an-advisor-model) avec [`/model`](/fr/model-config#setting-your-model).

56 56 

57<h3 id="set-advisormodel-in-settings">57<h3 id="set-advisormodel-in-settings">

58 Définir `advisorModel` dans les paramètres58 Définir `advisorModel` dans les paramètres


76claude --advisor opus76claude --advisor opus

77```77```

78 78 

79Le drapeau a la priorité sur le paramètre `advisorModel` pour cette session. Contrairement à `/advisor`, qui enregistre une sélection inactive, le drapeau se termine avec une erreur si le modèle principal de la session ne supporte pas l'advisor.79Le drapeau a la priorité sur le paramètre `advisorModel` pour cette session. Il se termine avec une erreur si le modèle principal de la session ne supporte pas l'advisor, ou si le modèle advisor demandé est exclu par la liste d'autorisation [`availableModels`](/fr/model-config#restrict-model-selection) de votre organisation.

80 80 

81<h2 id="choose-an-advisor-model">81<h2 id="choose-an-advisor-model">

82 Choisir un modèle advisor82 Choisir un modèle advisor


182L'advisor est l'une de plusieurs façons de combiner les forces des modèles. Choisissez en fonction de quand vous voulez qu'un deuxième modèle soit impliqué.182L'advisor est l'une de plusieurs façons de combiner les forces des modèles. Choisissez en fonction de quand vous voulez qu'un deuxième modèle soit impliqué.

183 183 

184| Approche | Quand le modèle plus puissant s'exécute | Comment il démarre |184| Approche | Quand le modèle plus puissant s'exécute | Comment il démarre |

185| ---------------------------------------------------------------- | --------------------------------------------------------------- | ---------------------------------------------- |185| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |

186| Outil advisor | Aux points de décision en milieu de tâche | Claude l'appelle quand il a besoin de conseils |186| Outil advisor | Aux points de décision en milieu de tâche | Claude l'appelle quand il a besoin de conseils |

187| [`opusplan`](/fr/model-config#opusplan-model-setting) | Pendant le mode plan, puis bascule vers Sonnet pour l'exécution | Vous entrez en mode plan |187| [`opusplan`](/fr/model-config#opusplan-model-setting) | Pendant le mode plan quand [autorisé par `availableModels`](/fr/model-config#restrict-model-selection), puis bascule vers Sonnet pour l'exécution | Vous entrez en mode plan |

188| [Sous-agents](/fr/sub-agents#choose-a-model) avec `model` défini | Pour l'ensemble de la sous-tâche déléguée | Claude délègue, ou vous invoquez le sous-agent |188| [Sous-agents](/fr/sub-agents#choose-a-model) avec `model` défini | Pour l'ensemble de la sous-tâche déléguée | Claude délègue, ou vous invoquez le sous-agent |

189| [`/model`](/fr/model-config#setting-your-model) | Pour tous les tours ultérieurs | Vous changez de modèle |189| [`/model`](/fr/model-config#setting-your-model) | Pour tous les tours ultérieurs | Vous changez de modèle |

190 190 

Details

86`settingSources` couvre les paramètres utilisateur, projet et locaux. Quelques entrées sont lues indépendamment de sa valeur :86`settingSources` couvre les paramètres utilisateur, projet et locaux. Quelques entrées sont lues indépendamment de sa valeur :

87 87 

88| Entrée | Comportement | Pour désactiver |88| Entrée | Comportement | Pour désactiver |

89| :--------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |89| :--------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

90| Paramètres de politique gérée | Toujours chargés quand présents sur l'hôte | Supprimez le fichier de paramètres gérés |90| Paramètres de politique gérée | Politique gérée par le point de terminaison, qu'il s'agisse d'une plist MDM, d'une politique de registre ou de fichiers de paramètres gérés, se charge à partir de l'hôte ; les [paramètres gérés par le serveur](/fr/server-managed-settings) sont récupérés quand la session s'authentifie avec une connexion OAuth d'organisation ou une clé API directement configurée, sur une [configuration éligible](/fr/server-managed-settings#platform-availability) | Politique de point de terminaison : supprimez le fichier de paramètres gérés, la plist ou la politique de registre de l'hôte. Paramètres gérés par le serveur : contrôlés par votre administrateur d'organisation ; ne peuvent pas être désactivés à partir du SDK |

91| Configuration globale `~/.claude.json` | Toujours lue | Relocalisez avec `CLAUDE_CONFIG_DIR` dans `env` |91| Configuration globale `~/.claude.json` | Toujours lue | Relocalisez avec `CLAUDE_CONFIG_DIR` dans `env` |

92| Mémoire automatique à `~/.claude/projects/<project>/memory/` | Chargée par défaut dans l'invite système | Définissez `autoMemoryEnabled: false` dans les paramètres, ou `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` dans `env` |92| Mémoire automatique à `~/.claude/projects/<project>/memory/` | Chargée par défaut dans l'invite système | Définissez `autoMemoryEnabled: false` dans les paramètres, ou `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` dans `env` |

93| [Connecteurs MCP de claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai) | Chargés quand la méthode d'authentification active est un abonnement claude.ai. Passer `mcpServers: {}` ne les supprime pas | Définissez `strictMcpConfig: true`, [`disableClaudeAiConnectors: true`](/fr/mcp#disable-claude-ai-connectors) dans les paramètres, ou `ENABLE_CLAUDEAI_MCP_SERVERS=false` dans `env` |93| [Connecteurs MCP de claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai) | Chargés quand la méthode d'authentification active est un abonnement claude.ai. Passer `mcpServers: {}` ne les supprime pas | Définissez `strictMcpConfig: true`, [`disableClaudeAiConnectors: true`](/fr/mcp#disable-claude-ai-connectors) dans les paramètres, ou `ENABLE_CLAUDEAI_MCP_SERVERS=false` dans `env` |

94 94 

95<Warning>95<Warning>

96 Ne vous fiez pas aux options par défaut de `query()` pour l'isolation multi-locataire. Parce que les entrées ci-dessus sont lues indépendamment de `settingSources`, un processus SDK peut récupérer la configuration au niveau de l'hôte et la mémoire par répertoire. Pour les déploiements multi-locataires, exécutez chaque locataire dans son propre système de fichiers et définissez `settingSources: []` plus `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` dans `env`. Voir [Déploiement sécurisé](/fr/agent-sdk/secure-deployment).96 Ne vous fiez pas aux options par défaut de `query()` pour l'isolation multi-locataire. Parce que les entrées ci-dessus sont lues indépendamment de `settingSources`, un processus SDK peut récupérer la configuration au niveau de l'hôte et la mémoire par répertoire. Pour les déploiements multi-locataires, exécutez chaque locataire dans son propre système de fichiers et définissez `settingSources: []` plus `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` dans `env`. Les [paramètres gérés par le serveur](/fr/server-managed-settings) sont récupérés quand le processus s'authentifie avec une credential d'organisation ; l'isolation du système de fichiers ne les supprime pas. Voir [Déploiement sécurisé](/fr/agent-sdk/secure-deployment).

97</Warning>97</Warning>

98 98 

99<h2 id="project-instructions-claude-md-and-rules">99<h2 id="project-instructions-claude-md-and-rules">

Details

897```897```

898 898 

899| Propriété | Type | Par défaut | Description |899| Propriété | Type | Par défaut | Description |

900| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |900| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

902| `allowed_tools` | `list[str]` | `[]` | Outils à approuver automatiquement sans demander. Ceci ne restreint pas Claude à seulement ces outils ; les outils non listés passent par `permission_mode` et `can_use_tool`. Utilisez `disallowed_tools` pour bloquer les outils. Voir [Permissions](/fr/agent-sdk/permissions#allow-and-deny-rules) |902| `allowed_tools` | `list[str]` | `[]` | Outils à approuver automatiquement sans demander. Ceci ne restreint pas Claude à seulement ces outils ; les outils non listés passent par `permission_mode` et `can_use_tool`. Utilisez `disallowed_tools` pour bloquer les outils. Voir [Permissions](/fr/agent-sdk/permissions#allow-and-deny-rules) |

903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | Configuration du prompt système. Passez une chaîne pour un prompt personnalisé, ou utilisez `{"type": "preset", "preset": "claude_code"}` pour le prompt système de Claude Code. Ajoutez `"append"` pour étendre le preset |903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | Configuration du prompt système. Passez une chaîne pour un prompt personnalisé, ou utilisez `{"type": "preset", "preset": "claude_code"}` pour le prompt système de Claude Code. Ajoutez `"append"` pour étendre le preset |


933| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Sous-agents définis programmatiquement |933| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Sous-agents définis programmatiquement |

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

935| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Configurez le comportement du sandbox programmatiquement. Voir [Paramètres du sandbox](#sandboxsettings) pour les détails |935| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Configurez le comportement du sandbox programmatiquement. Voir [Paramètres du sandbox](#sandboxsettings) pour les détails |

936| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Contrôlez quels paramètres du système de fichiers charger. Passez `[]` pour désactiver les paramètres utilisateur, projet et locaux. Les paramètres de politique gérée se chargent indépendamment. Voir [Utiliser les fonctionnalités de Claude Code](/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) |936| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Contrôlez quels paramètres du système de fichiers charger. Passez `[]` pour désactiver les paramètres utilisateur, projet et locaux. Les paramètres de politique gérée se chargent indépendamment ; les paramètres gérés par le serveur sont récupérés quand la session s'authentifie avec une credential d'organisation sur une [configuration éligible](/fr/server-managed-settings#platform-availability). Voir [Utiliser les fonctionnalités de Claude Code](/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) pour les entrées qui sont lues indépendamment de cette option, et comment les désactiver |

937| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Compétences disponibles pour la session. Passez `"all"` pour activer chaque compétence découverte, ou une liste de noms de compétences. Quand défini, le SDK ajoute l'outil Skill à `allowed_tools` automatiquement. Si vous passez aussi `tools`, incluez `"Skill"` dans cette liste. Voir [Compétences](/fr/agent-sdk/skills) |937| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Compétences disponibles pour la session. Passez `"all"` pour activer chaque compétence découverte, ou une liste de noms de compétences. Quand défini, le SDK ajoute l'outil Skill à `allowed_tools` automatiquement. Si vous passez aussi `tools`, incluez `"Skill"` dans cette liste. Voir [Compétences](/fr/agent-sdk/skills) |

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

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


1022 Comportement par défaut1022 Comportement par défaut

1023</h4>1023</h4>

1024 1024 

1025Quand `setting_sources` est omis ou `None`, `query()` charge les mêmes paramètres du système de fichiers que le CLI Claude Code : utilisateur, projet et local. Les paramètres de politique gérée sont chargés dans tous les cas. Voir [Ce que settingSources ne contrôle pas](/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) pour les entrées qui sont lues indépendamment de cette option, et comment les désactiver.1025Quand `setting_sources` est omis ou `None`, `query()` charge les mêmes paramètres du système de fichiers que le CLI Claude Code : utilisateur, projet et local. Les paramètres de politique gérée sont chargés dans tous les cas ; les paramètres gérés par le serveur sont récupérés quand la session s'authentifie avec une credential d'organisation sur une [configuration éligible](/fr/server-managed-settings#platform-availability). Voir [Ce que settingSources ne contrôle pas](/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) pour les entrées qui sont lues indépendamment de cette option, et comment les désactiver.

1026 1026 

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

1028 Pourquoi utiliser setting\_sources1028 Pourquoi utiliser setting\_sources

Details

421| Paramètre | Type | Par défaut | Description |421| Paramètre | Type | Par défaut | Description |

422| :------------------------------ | :------------------------------------ | :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |422| :------------------------------ | :------------------------------------ | :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

423| `options.cwd` | `string` | `process.cwd()` | Répertoire pour résoudre les paramètres de projet et locaux par rapport à |423| `options.cwd` | `string` | `process.cwd()` | Répertoire pour résoudre les paramètres de projet et locaux par rapport à |

424| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Toutes les sources | Quelles sources du système de fichiers charger. Passez `[]` pour ignorer les paramètres utilisateur, projet et locaux. Les paramètres de politique gérée se chargent dans tous les cas |424| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Toutes les sources | Quelles sources du système de fichiers charger. Passez `[]` pour ignorer les paramètres utilisateur, projet et locaux. Les paramètres de politique gérée se chargent dans tous les cas. Les paramètres gérés par le serveur sont pris à partir de `serverManagedSettings` quand l'hôte les transmet, ou lus à partir du cache sur disque de l'interface CLI sinon ; l'instantané ne les récupère pas à partir du réseau |

425| `options.managedSettings` | `Settings` | `undefined` | Paramètres de politique restrictive fournis par l'hôte d'intégration. Supprimés par défaut quand un niveau géré déployé par l'administrateur est présent ; fusionnés sous ce niveau quand [`parentSettingsBehavior`](/fr/settings#available-settings) est `"merge"`. Les clés non restrictives telles que `model` sont silencieusement supprimées pour que cette option puisse renforcer la politique gérée mais pas l'assouplir |425| `options.managedSettings` | `Settings` | `undefined` | Paramètres de politique restrictive fournis par l'hôte d'intégration. Supprimés par défaut quand un niveau géré déployé par l'administrateur est présent ; fusionnés sous ce niveau quand [`parentSettingsBehavior`](/fr/settings#available-settings) est `"merge"`. Les clés non restrictives telles que `model` sont silencieusement supprimées pour que cette option puisse renforcer la politique gérée mais pas l'assouplir |

426| `options.serverManagedSettings` | `Settings` | `undefined` | Charge utile de paramètres gérés par le serveur depuis `/api/claude_code/settings`. Les clés non restrictives passent sans filtre |426| `options.serverManagedSettings` | `Settings` | `undefined` | Charge utile de paramètres gérés par le serveur depuis `/api/claude_code/settings`. Les clés non restrictives passent sans filtre |

427 427 


517| `sessionStore` | [`SessionStore`](/fr/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Refléter les transcriptions de session vers un backend externe pour que n'importe quel hôte puisse les reprendre. Voir [Persister les sessions vers un stockage externe](/fr/agent-sdk/session-storage) |517| `sessionStore` | [`SessionStore`](/fr/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Refléter les transcriptions de session vers un backend externe pour que n'importe quel hôte puisse les reprendre. Voir [Persister les sessions vers un stockage externe](/fr/agent-sdk/session-storage) |

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

519| `settings` | `string \| Settings` | `undefined` | Objet [paramètres](/fr/settings) en ligne ou chemin vers un fichier de paramètres. Remplit la couche de paramètres d'indicateur dans l'[ordre de précédence](/fr/settings#settings-precedence). Modifiez à l'exécution avec [`applyFlagSettings()`](#applyflagsettings) |519| `settings` | `string \| Settings` | `undefined` | Objet [paramètres](/fr/settings) en ligne ou chemin vers un fichier de paramètres. Remplit la couche de paramètres d'indicateur dans l'[ordre de précédence](/fr/settings#settings-precedence). Modifiez à l'exécution avec [`applyFlagSettings()`](#applyflagsettings) |

520| `settingSources` | [`SettingSource`](#settingsource)`[]` | Paramètres par défaut de CLI (toutes les sources) | Contrôler les paramètres du système de fichiers à charger. Passez `[]` pour désactiver les paramètres utilisateur, projet et locaux. Les paramètres de politique gérée se chargent indépendamment. Voir [Utiliser les fonctionnalités Claude Code](/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) |520| `settingSources` | [`SettingSource`](#settingsource)`[]` | Paramètres par défaut de CLI (toutes les sources) | Contrôler les paramètres du système de fichiers à charger. Passez `[]` pour désactiver les paramètres utilisateur, projet et locaux. Les paramètres de politique gérée se chargent indépendamment ; les paramètres gérés par le serveur sont récupérés quand la session s'authentifie avec une credential d'organisation sur une [configuration éligible](/fr/server-managed-settings#platform-availability). Voir [Utiliser les fonctionnalités Claude Code](/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

521| `skills` | `string[] \| 'all'` | `undefined` | Compétences disponibles pour la session. Passez `'all'` pour activer chaque compétence découverte, ou une liste de noms de compétences. Quand défini, le SDK ajoute l'outil Skill à `allowedTools` automatiquement. Si vous passez également `tools`, incluez `'Skill'` dans cette liste. Voir [Compétences](/fr/agent-sdk/skills) |521| `skills` | `string[] \| 'all'` | `undefined` | Compétences disponibles pour la session. Passez `'all'` pour activer chaque compétence découverte, ou une liste de noms de compétences. Quand défini, le SDK ajoute l'outil Skill à `allowedTools` automatiquement. Si vous passez également `tools`, incluez `'Skill'` dans cette liste. Voir [Compétences](/fr/agent-sdk/skills) |

522| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Fonction personnalisée pour générer le processus Claude Code. Utilisez pour exécuter Claude Code dans des VM, des conteneurs ou des environnements distants |522| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Fonction personnalisée pour générer le processus Claude Code. Utilisez pour exécuter Claude Code dans des VM, des conteneurs ou des environnements distants |

523| `stderr` | `(data: string) => void` | `undefined` | Rappel pour la sortie stderr |523| `stderr` | `(data: string) => void` | `undefined` | Rappel pour la sortie stderr |


765 Comportement par défaut765 Comportement par défaut

766</h4>766</h4>

767 767 

768Quand `settingSources` est omis ou `undefined`, `query()` charge les mêmes paramètres du système de fichiers que la CLI Claude Code : utilisateur, projet et local. Les paramètres de politique gérée sont chargés dans tous les cas. Voir [Ce que settingSources ne contrôle pas](/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) pour les entrées qui sont lues indépendamment de cette option, et comment les désactiver.768Quand `settingSources` est omis ou `undefined`, `query()` charge les mêmes paramètres du système de fichiers que la CLI Claude Code : utilisateur, projet et local. Les paramètres de politique gérée sont chargés dans tous les cas ; les paramètres gérés par le serveur sont récupérés quand la session s'authentifie avec une credential d'organisation sur une [configuration éligible](/fr/server-managed-settings#platform-availability). Voir [Ce que settingSources ne contrôle pas](/fr/agent-sdk/claude-code-features#what-settingsources-does-not-control) pour les entrées qui sont lues indépendamment de cette option, et comment les désactiver.

769 769 

770<h4 id="why-use-settingsources">770<h4 id="why-use-settingsources">

771 Pourquoi utiliser settingSources771 Pourquoi utiliser settingSources

Details

477export CLAUDE_CODE_USE_MANTLE=1477export CLAUDE_CODE_USE_MANTLE=1

478```478```

479 479 

480Pour afficher un modèle Mantle dans le sélecteur `/model`, répertoriez son ID dans `availableModels` dans votre [fichier de paramètres](/fr/settings). Ce paramètre restreint également le sélecteur aux entrées répertoriées, donc incluez chaque alias que vous souhaitez garder disponible :480Pour afficher un modèle Mantle dans le sélecteur `/model`, répertoriez son ID dans `availableModels` dans votre [fichier de paramètres](/fr/settings). Ce paramètre restreint également le sélecteur aux entrées répertoriées. Répertorier `anthropic.claude-haiku-4-5` supprime l'alias `haiku` nu du sélecteur, donc répertoriez également les préfixes de version ou les ID complets pour les versions que vous souhaitez garder sélectionnables. Voir [Comportement de fusion](/fr/model-config#merge-behavior) :

481 481 

482```json theme={null}482```json theme={null}

483{483{

484 "availableModels": ["opus", "sonnet", "haiku", "anthropic.claude-haiku-4-5"]484 "availableModels": ["opus", "sonnet", "claude-haiku-4-5", "anthropic.claude-haiku-4-5"]

485}485}

486```486```

487 487 

Details

63 Ce qui est disponible dans les sessions cloud63 Ce qui est disponible dans les sessions cloud

64</h3>64</h3>

65 65 

66Les sessions cloud commencent par un clone frais de votre référentiel. Tout ce qui est validé dans le référentiel est disponible. Tout ce que vous avez installé ou configuré uniquement sur votre propre machine ne l'est pas.66Les sessions cloud commencent par un clone frais de votre référentiel. Tout ce qui est validé dans le référentiel est disponible. Tout ce que vous avez installé ou configuré uniquement sur votre propre machine ne l'est pas ; la politique de votre organisation arrive séparément via les [paramètres gérés par le serveur](/fr/server-managed-settings).

67 67 

68| | Disponible dans les sessions cloud | Pourquoi |68| | Disponible dans les sessions cloud | Pourquoi |

69| :-------------------------------------------------------------------------------- | :--------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |69| :------------------------------------------------------------------------------------- | :--------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

70| Votre `CLAUDE.md` du référentiel | Oui | Fait partie du clone |70| Votre `CLAUDE.md` du référentiel | Oui | Fait partie du clone |

71| Vos hooks `.claude/settings.json` du référentiel | Oui | Fait partie du clone |71| Vos hooks `.claude/settings.json` du référentiel | Oui | Fait partie du clone |

72| Vos serveurs MCP `.mcp.json` du référentiel | Oui | Fait partie du clone |72| Vos serveurs MCP `.mcp.json` du référentiel | Oui | Fait partie du clone |

73| Votre `.claude/rules/` du référentiel | Oui | Fait partie du clone |73| Votre `.claude/rules/` du référentiel | Oui | Fait partie du clone |

74| Votre `.claude/skills/`, `.claude/agents/`, `.claude/commands/` du référentiel | Oui | Fait partie du clone |74| Votre `.claude/skills/`, `.claude/agents/`, `.claude/commands/` du référentiel | Oui | Fait partie du clone |

75| Plugins déclarés dans `.claude/settings.json` | Oui | Installés au démarrage de la session à partir de la [marketplace](/fr/plugin-marketplaces) que vous avez déclarée. Nécessite un accès réseau pour atteindre la source de la marketplace |75| Plugins déclarés dans `.claude/settings.json` | Oui | Installés au démarrage de la session à partir de la [marketplace](/fr/plugin-marketplaces) que vous avez déclarée. Nécessite un accès réseau pour atteindre la source de la marketplace |

76| Votre [paramètres gérés par le serveur](/fr/server-managed-settings) de l'organisation | Oui | Récupérés depuis les serveurs d'Anthropic au démarrage de la session. Consultez [Couverture de surface](/fr/model-config#surface-coverage) pour savoir comment `availableModels` est appliqué dans les sessions cloud. Les paramètres déployés sur votre appareil via MDM ou des fichiers de paramètres gérés ne s'appliquent pas, car la session s'exécute sur une VM gérée par Anthropic |

76| Votre `~/.claude/CLAUDE.md` utilisateur | Non | Vit sur votre machine, pas dans le référentiel |77| Votre `~/.claude/CLAUDE.md` utilisateur | Non | Vit sur votre machine, pas dans le référentiel |

77| Votre `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` utilisateur | Non | Vivent sur votre machine, pas dans le référentiel. Validez-les plutôt dans le répertoire `.claude/` du référentiel. Les compétences que vous activez sur claude.ai sont chargées automatiquement dans les sessions cloud |78| Votre `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` utilisateur | Non | Vivent sur votre machine, pas dans le référentiel. Validez-les plutôt dans le répertoire `.claude/` du référentiel. Les compétences que vous activez sur claude.ai sont chargées automatiquement dans les sessions cloud |

78| Plugins activés uniquement dans vos paramètres utilisateur | Non | Les `enabledPlugins` limités à l'utilisateur vivent dans `~/.claude/settings.json`. Déclarez-les plutôt dans le `.claude/settings.json` du référentiel |79| Plugins activés uniquement dans vos paramètres utilisateur | Non | Les `enabledPlugins` limités à l'utilisateur vivent dans `~/.claude/settings.json`. Déclarez-les plutôt dans le `.claude/settings.json` du référentiel |


80| Jetons API statiques et identifiants | Non | Aucun magasin de secrets dédié n'existe encore. Voir ci-dessous |81| Jetons API statiques et identifiants | Non | Aucun magasin de secrets dédié n'existe encore. Voir ci-dessous |

81| Authentification interactive comme AWS SSO | Non | Non pris en charge. SSO nécessite une connexion basée sur le navigateur qui ne peut pas s'exécuter dans une session cloud |82| Authentification interactive comme AWS SSO | Non | Non pris en charge. SSO nécessite une connexion basée sur le navigateur qui ne peut pas s'exécuter dans une session cloud |

82 83 

83Pour rendre la configuration disponible dans les sessions cloud, validez-la dans le référentiel. Un magasin de secrets dédié n'est pas encore disponible. Les variables d'environnement et les scripts de configuration sont stockés dans la configuration de l'environnement, visibles à quiconque peut modifier cet environnement. Si vous avez besoin de secrets dans une session cloud, ajoutez-les comme variables d'environnement en gardant cette visibilité à l'esprit.84Pour rendre votre propre configuration disponible dans les sessions cloud, validez-la dans le référentiel ; la politique de l'organisation arrive séparément via les [paramètres gérés par le serveur](/fr/server-managed-settings). Un magasin de secrets dédié n'est pas encore disponible. Les variables d'environnement et les scripts de configuration sont stockés dans la configuration de l'environnement, visibles à quiconque peut modifier cet environnement. Si vous avez besoin de secrets dans une session cloud, ajoutez-les comme variables d'environnement en gardant cette visibilité à l'esprit.

84 85 

85<h3 id="installed-tools">86<h3 id="installed-tools">

86 Outils installés87 Outils installés


245| S'exécute | Avant le lancement de Claude Code, lorsqu'aucun [environnement en cache](#environment-caching) n'est disponible | Après le lancement de Claude Code, sur chaque session y compris les sessions reprises |246| S'exécute | Avant le lancement de Claude Code, lorsqu'aucun [environnement en cache](#environment-caching) n'est disponible | Après le lancement de Claude Code, sur chaque session y compris les sessions reprises |

246| Portée | Environnements cloud uniquement | Local et cloud |247| Portée | Environnements cloud uniquement | Local et cloud |

247 248 

248Les hooks SessionStart peuvent également être définis dans votre `~/.claude/settings.json` au niveau de l'utilisateur localement, mais les paramètres au niveau de l'utilisateur ne sont pas transférés aux sessions cloud. Dans le cloud, seuls les hooks validés dans le référentiel s'exécutent.249Les hooks SessionStart peuvent également être définis dans votre `~/.claude/settings.json` au niveau de l'utilisateur localement, mais les paramètres au niveau de l'utilisateur ne sont pas transférés aux sessions cloud. Dans le cloud, les hooks proviennent du référentiel et des [paramètres gérés par le serveur](/fr/server-managed-settings) de votre organisation.

249 250 

250<h3 id="install-dependencies-with-a-sessionstart-hook">251<h3 id="install-dependencies-with-a-sessionstart-hook">

251 Installer les dépendances avec un hook SessionStart252 Installer les dépendances avec un hook SessionStart

commands.md +1 −1

Details

88| `/ide` | Gérer les intégrations IDE et afficher l'état |88| `/ide` | Gérer les intégrations IDE et afficher l'état |

89| `/init` | Initialiser le projet avec un guide `CLAUDE.md`. Définissez `CLAUDE_CODE_NEW_INIT=1` pour un flux interactif qui vous guide également à travers les skills, les hooks et les fichiers de mémoire personnelle |89| `/init` | Initialiser le projet avec un guide `CLAUDE.md`. Définissez `CLAUDE_CODE_NEW_INIT=1` pour un flux interactif qui vous guide également à travers les skills, les hooks et les fichiers de mémoire personnelle |

90| `/insights` | Générer un rapport analysant vos sessions Claude Code, y compris les domaines de projet, les modèles d'interaction et les points de friction |90| `/insights` | Générer un rapport analysant vos sessions Claude Code, y compris les domaines de projet, les modèles d'interaction et les points de friction |

91| `/install-github-app` | Configurer l'application [Claude GitHub Actions](/fr/github-actions) pour un référentiel. Vous guide dans la sélection d'un référentiel et la configuration de l'intégration |91| `/install-github-app` | Installer l'application Claude GitHub pour un référentiel, avec une étape optionnelle pour configurer les workflows [GitHub Actions](/fr/github-actions) et les secrets. Vous guide dans la sélection d'un référentiel et la configuration de l'intégration |

92| `/install-slack-app` | Installer l'application Claude Slack. Ouvre un navigateur pour terminer le flux OAuth |92| `/install-slack-app` | Installer l'application Claude Slack. Ouvre un navigateur pour terminer le flux OAuth |

93| `/keybindings` | Ouvrir votre fichier de [raccourcis clavier](/fr/keybindings) |93| `/keybindings` | Ouvrir votre fichier de [raccourcis clavier](/fr/keybindings) |

94| `/login` | Se connecter à votre compte Anthropic |94| `/login` | Se connecter à votre compte Anthropic |

desktop.md +8 −4

Details

691 Paramètres gérés691 Paramètres gérés

692</h3>692</h3>

693 693 

694Les paramètres gérés remplacent les paramètres du projet et de l'utilisateur et s'appliquent quand Desktop génère des sessions CLI. Vous pouvez définir ces clés dans le fichier [paramètres gérés](/fr/settings#settings-precedence) de votre organisation ou les pousser à distance via la console d'administration.694Les paramètres gérés remplacent les paramètres du projet et de l'utilisateur et s'appliquent aux sessions Claude Code dans Desktop. Vous pouvez définir ces clés dans le fichier [paramètres gérés](/fr/settings#settings-precedence) de votre organisation ou les pousser à distance via la console d'administration.

695 695 

696| Clé | Description |696| Clé | Description |

697| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |697| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

698| `permissions.disableBypassPermissionsMode` | définissez sur `"disable"` pour empêcher les utilisateurs d'activer le mode de contournement des permissions. |698| `permissions.disableBypassPermissionsMode` | définissez sur `"disable"` pour empêcher les utilisateurs d'activer le mode de contournement des permissions. |

699| `disableAutoMode` | définissez sur `"disable"` pour empêcher les utilisateurs d'activer le mode [Auto](/fr/permission-modes#eliminate-prompts-with-auto-mode). Supprime Auto du sélecteur de mode. Également accepté sous `permissions`. |699| `disableAutoMode` | définissez sur `"disable"` pour empêcher les utilisateurs d'activer le mode [Auto](/fr/permission-modes#eliminate-prompts-with-auto-mode). Supprime Auto du sélecteur de mode. Également accepté sous `permissions`. |

700| `autoMode` | personnalisez ce que le classificateur du mode auto fait confiance et bloque dans votre organisation. Voir [Configurer le mode auto](/fr/auto-mode-config). |700| `autoMode` | personnalisez ce que le classificateur du mode auto fait confiance et bloque dans votre organisation. Voir [Configurer le mode auto](/fr/auto-mode-config). |

701| `sshConfigs` | pré-configurez les [connexions SSH](#pre-configure-ssh-connections-for-your-team) qui apparaissent dans la liste déroulante de l'environnement. Les utilisateurs ne peuvent pas modifier ou supprimer les connexions gérées. |701| `sshConfigs` | pré-configurez les [connexions SSH](#pre-configure-ssh-connections-for-your-team) qui apparaissent dans la liste déroulante de l'environnement. Les utilisateurs ne peuvent pas modifier ou supprimer les connexions gérées. |

702| `sshHostAllowlist` | restreignez les [sessions SSH](#restrict-which-ssh-hosts-users-can-connect-to) aux hôtes dont le nom d'hôte résolu correspond à l'un de ces modèles. Un tableau vide désactive les sessions SSH. Lecture à partir des paramètres gérés uniquement. |702| `sshHostAllowlist` | restreignez les [sessions SSH](#restrict-which-ssh-hosts-users-can-connect-to) aux hôtes dont le nom d'hôte résolu correspond à l'un de ces modèles. Un tableau vide désactive les sessions SSH. Lecture à partir des paramètres gérés uniquement. |

703| `managedMcpServers` | poussez les configurations du serveur MCP à tous les utilisateurs dans un déploiement tiers. Chaque entrée spécifie un transport de `"http"`, `"sse"` ou `"stdio"`, les détails de connexion et optionnellement une carte `toolPolicy` qui restreint les outils de ce serveur que les utilisateurs peuvent invoquer. Disponible dans les déploiements Desktop tiers (3P) uniquement. |703| `managedMcpServers` | poussez les configurations du serveur MCP à tous les utilisateurs dans un déploiement tiers. Chaque entrée spécifie un transport de `"http"`, `"sse"` ou `"stdio"`, les détails de connexion et optionnellement une carte `toolPolicy` qui restreint les outils de ce serveur que les utilisateurs peuvent invoquer. Disponible dans les déploiements Desktop tiers (3P) uniquement. Livrez cette clé via le fichier de paramètres gérés ou MDM, car les déploiements tiers ne reçoivent pas les paramètres de la console d'administration. |

704 704 

705Un fichier de paramètres gérés déployé sur le disque de chaque machine s'applique aux sessions Desktop. Les paramètres gérés poussés à distance via la console d'administration atteignent actuellement uniquement les sessions CLI et IDE, donc pour les déploiements Desktop, distribuez le fichier via MDM ou utilisez les [contrôles de la console d'administration](#admin-console-controls) ci-dessus.705Les paramètres gérés qui atteignent une session Desktop dépendent de l'endroit cette session s'exécute. Les restrictions de modèle telles que [`availableModels`](/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](/fr/model-config#surface-coverage).

706 

707* **Sessions locales sur cette machine** : un fichier de paramètres gérés déployé sur le disque s'applique. Les paramètres gérés poussés à distance via la console d'administration atteignent également ces sessions sur l'API d'Anthropic lorsque la session s'authentifie avec une connexion d'organisation ou une clé API directement configurée, en suivant la même [précédence des paramètres](/fr/settings#settings-precedence) que le CLI du terminal.

708* **[Sessions cloud](#cloud-sessions)** : s'exécutent sur des machines virtuelles gérées par Anthropic et reçoivent uniquement les [paramètres gérés par le serveur](/fr/server-managed-settings).

709* **[Sessions SSH](#ssh-sessions)** : la session lit le fichier de paramètres gérés à partir de l'hôte distant. Desktop lui-même lit `sshConfigs` et `sshHostAllowlist` à partir des paramètres gérés de la machine locale lors de la création de la connexion.

706 710 

707`permissions.disableBypassPermissionsMode` et `disableAutoMode` fonctionnent également dans les paramètres utilisateur et projet, mais les placer dans les paramètres gérés empêche les utilisateurs de les remplacer. `autoMode` est lu à partir des paramètres utilisateur, `.claude/settings.local.json` et des paramètres gérés, mais pas à partir du `.claude/settings.json` coché : un référentiel cloné ne peut pas injecter ses propres règles de classificateur. Pour la liste complète des paramètres gérés uniquement, y compris `allowManagedPermissionRulesOnly` et `allowManagedHooksOnly`, voir [paramètres gérés uniquement](/fr/permissions#managed-only-settings).711`permissions.disableBypassPermissionsMode` et `disableAutoMode` fonctionnent également dans les paramètres utilisateur et projet, mais les placer dans les paramètres gérés empêche les utilisateurs de les remplacer. `autoMode` est lu à partir des paramètres utilisateur, `.claude/settings.local.json` et des paramètres gérés, mais pas à partir du `.claude/settings.json` coché : un référentiel cloné ne peut pas injecter ses propres règles de classificateur. Pour la liste complète des paramètres gérés uniquement, y compris `allowManagedPermissionRulesOnly` et `allowManagedHooksOnly`, voir [paramètres gérés uniquement](/fr/permissions#managed-only-settings).

708 712 

Details

330 330 

331La vue détaillée affiche les composants que le plugin contribue : commandes, skills, agents, hooks, serveurs MCP et serveurs LSP. Le même inventaire est disponible depuis la ligne de commande avec `claude plugin details`.331La vue détaillée affiche les composants que le plugin contribue : commandes, skills, agents, hooks, serveurs MCP et serveurs LSP. Le même inventaire est disponible depuis la ligne de commande avec `claude plugin details`.

332 332 

333Dans Claude Code v2.1.187 et versions ultérieures, l'onglet Installed ajoute un groupe **Not used recently** pour les plugins de marketplace que vous avez installés vous-même mais que vous n'avez pas invoqués depuis au moins deux semaines et sur au moins 10 sessions, et la vue détaillée affiche une ligne **Last used** pour chaque plugin. Utilisez ces informations pour trouver les plugins que vous n'utilisez plus mais qui ajoutent toujours un coût de démarrage et de contexte, puis désactivez-les ou désinstallez-les.

334 

335Les plugins que votre organisation gère ou que vous chargez avec `--plugin-dir` ne sont jamais listés comme inutilisés, et les plugins qui contribuent un serveur LSP, un thème, un style de sortie, un moniteur ou un workflow ne sont jamais listés non plus, car ils fournissent de la valeur sans une invocation à suivre. Le groupe et la ligne **Last used** sont tous deux masqués quand votre organisation restreint les marketplaces avec [`strictKnownMarketplaces`](/fr/settings#strictknownmarketplaces).

336 

333Quand vous installez un plugin qui déclare des dépendances, la sortie d'installation liste quelles dépendances ont été auto-installées avec lui.337Quand vous installez un plugin qui déclare des dépendances, la sortie d'installation liste quelles dépendances ont été auto-installées avec lui.

334 338 

335Vous pouvez également gérer les plugins avec des commandes directes.339Vous pouvez également gérer les plugins avec des commandes directes.

env-vars.md +2 −1

Details

203| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Définissez sur `1` pour actualiser l'état du plugin aux limites de tour en [mode non interactif](/fr/headless) après la fin d'une installation en arrière-plan. Désactivé par défaut car l'actualisation modifie l'invite système en milieu de session, ce qui invalide la [mise en cache des invites](/fr/prompt-caching) pour ce tour |203| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Définissez sur `1` pour actualiser l'état du plugin aux limites de tour en [mode non interactif](/fr/headless) après la fin d'une installation en arrière-plan. Désactivé par défaut car l'actualisation modifie l'invite système en milieu de session, ce qui invalide la [mise en cache des invites](/fr/prompt-caching) pour ce tour |

204| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Définissez sur `1` pour acheminer le sondage de qualité de session « Comment Claude se débrouille-t-il ? » vers votre propre [collecteur OpenTelemetry](/fr/monitoring-usage) lorsque le trafic non essentiel lié à Anthropic est bloqué. Les évaluations du sondage sont émises uniquement en tant qu'événements OTEL vers votre collecteur configuré. Aucune donnée de sondage n'est envoyée à Anthropic dans ce mode. S'applique lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, et n'a aucun effet autrement. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` et la politique de rétroaction produit de l'organisation prennent la priorité |204| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Définissez sur `1` pour acheminer le sondage de qualité de session « Comment Claude se débrouille-t-il ? » vers votre propre [collecteur OpenTelemetry](/fr/monitoring-usage) lorsque le trafic non essentiel lié à Anthropic est bloqué. Les évaluations du sondage sont émises uniquement en tant qu'événements OTEL vers votre collecteur configuré. Aucune donnée de sondage n'est envoyée à Anthropic dans ce mode. S'applique lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, et n'a aucun effet autrement. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` et la politique de rétroaction produit de l'organisation prennent la priorité |

205| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Contrôle si les entrées d'appel d'outil se transmettent en continu depuis l'API au fur et à mesure que Claude les génère. Avec ceci désactivé, une grande entrée d'outil telle qu'une longue écriture de fichier n'arrive qu'après que Claude ait terminé de la générer, ce qui peut sembler qu'il se bloque. Activé par défaut sur l'API Anthropic. Sur Bedrock et Vertex, activé par modèle où le conteneur déployé le prend en charge. Définissez sur `0` pour refuser. Définissez sur `1` pour forcer l'activation lors du routage via un proxy via `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Désactivé par défaut sur Foundry et les connexions [gateway](/fr/llm-gateway) |205| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Contrôle si les entrées d'appel d'outil se transmettent en continu depuis l'API au fur et à mesure que Claude les génère. Avec ceci désactivé, une grande entrée d'outil telle qu'une longue écriture de fichier n'arrive qu'après que Claude ait terminé de la générer, ce qui peut sembler qu'il se bloque. Activé par défaut sur l'API Anthropic. Sur Bedrock et Vertex, activé par modèle où le conteneur déployé le prend en charge. Définissez sur `0` pour refuser. Définissez sur `1` pour forcer l'activation lors du routage via un proxy via `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Désactivé par défaut sur Foundry et les connexions [gateway](/fr/llm-gateway) |

206| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Définissez sur `1` pour remplir le sélecteur `/model` à partir du point de terminaison `/v1/models` de votre passerelle lorsque `ANTHROPIC_BASE_URL` pointe vers une passerelle compatible Anthropic telle que LiteLLM, Kong ou un proxy interne. Désactivé par défaut car les passerelles soutenues par une clé API partagée afficheraient autrement à chaque utilisateur chaque modèle auquel la clé peut accéder. Les modèles découverts sont toujours filtrés par la liste d'autorisation [`availableModels`](/fr/settings#available-settings) |206| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Définissez sur `1` pour remplir le sélecteur `/model` à partir du point de terminaison `/v1/models` de votre passerelle lorsque `ANTHROPIC_BASE_URL` pointe vers une passerelle compatible Anthropic telle que LiteLLM, Kong ou un proxy interne. Désactivé par défaut car les passerelles soutenues par une clé API partagée afficheraient autrement à chaque utilisateur chaque modèle auquel la clé peut accéder. Les modèles découverts sont toujours filtrés par la liste d'autorisation [`availableModels`](/fr/settings#available-settings) que la session reçoit ; livrez la liste via [MDM ou un fichier de paramètres gérés](/fr/settings#settings-files), car la [livraison gérée par le serveur n'est pas disponible sur les configurations de passerelle](/fr/server-managed-settings#platform-availability) |

207| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Supprimé dans v2.1.142, lorsque le [mode rapide](/fr/fast-mode) par défaut a changé d'Opus 4.6 à Opus 4.7 |207| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Supprimé dans v2.1.142, lorsque le [mode rapide](/fr/fast-mode) par défaut a changé d'Opus 4.6 à Opus 4.7 |

208| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Définissez sur `false` pour désactiver les suggestions d'invite (le bouton bascule « Suggestions d'invite » dans `/config`). Ce sont les prédictions grisées qui apparaissent dans votre entrée d'invite après que Claude répond. Voir [Suggestions d'invite](/fr/interactive-mode#prompt-suggestions) |208| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Définissez sur `false` pour désactiver les suggestions d'invite (le bouton bascule « Suggestions d'invite » dans `/config`). Ce sont les prédictions grisées qui apparaissent dans votre entrée d'invite après que Claude répond. Voir [Suggestions d'invite](/fr/interactive-mode#prompt-suggestions) |

209| `CLAUDE_CODE_ENABLE_TASKS` | Contrôle si les sessions utilisent les outils Task structurés (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) ou l'outil `TodoWrite` hérité. {/* min-version: 2.1.142 */}À partir de Claude Code v2.1.142, les outils Task sont le défaut dans tous les modes. Définissez sur `0` pour revenir à `TodoWrite`. Voir [Liste des tâches](/fr/interactive-mode#task-list) et [Migrer vers les outils Task](/fr/agent-sdk/todo-tracking#migrate-to-task-tools) |209| `CLAUDE_CODE_ENABLE_TASKS` | Contrôle si les sessions utilisent les outils Task structurés (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) ou l'outil `TodoWrite` hérité. {/* min-version: 2.1.142 */}À partir de Claude Code v2.1.142, les outils Task sont le défaut dans tous les modes. Définissez sur `0` pour revenir à `TodoWrite`. Voir [Liste des tâches](/fr/interactive-mode#task-list) et [Migrer vers les outils Task](/fr/agent-sdk/todo-tracking#migrate-to-task-tools) |


230| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Nombre maximal d'outils en lecture seule et de subagents qui peuvent s'exécuter en parallèle (par défaut : 10). Les valeurs plus élevées augmentent le parallélisme mais consomment plus de ressources |230| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Nombre maximal d'outils en lecture seule et de subagents qui peuvent s'exécuter en parallèle (par défaut : 10). Les valeurs plus élevées augmentent le parallélisme mais consomment plus de ressources |

231| `CLAUDE_CODE_MAX_TURNS` | Plafonner le nombre de tours d'agent lorsqu'aucune limite explicite n'est transmise. Équivalent à la transmission de [`--max-turns`](/fr/cli-reference#cli-flags), qui prend la priorité lorsque les deux sont définis. Une valeur qui n'est pas un entier positif est rejetée au démarrage avec une erreur plutôt que traitée comme aucun plafond |231| `CLAUDE_CODE_MAX_TURNS` | Plafonner le nombre de tours d'agent lorsqu'aucune limite explicite n'est transmise. Équivalent à la transmission de [`--max-turns`](/fr/cli-reference#cli-flags), qui prend la priorité lorsque les deux sont définis. Une valeur qui n'est pas un entier positif est rejetée au démarrage avec une erreur plutôt que traitée comme aucun plafond |

232| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Définissez sur `1` pour générer les serveurs MCP stdio avec uniquement un environnement de base sûr plus l'`env` configuré du serveur, au lieu d'hériter de votre environnement shell |232| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Définissez sur `1` pour générer les serveurs MCP stdio avec uniquement un environnement de base sûr plus l'`env` configuré du serveur, au lieu d'hériter de votre environnement shell |

233| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}Délai d'expiration d'inactivité en millisecondes pour les appels d'outils MCP distants (par défaut : 300 000, ou 5 minutes). Lorsqu'un serveur MCP HTTP, SSE, WebSocket ou [connecteur claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai) n'envoie aucune réponse et aucune notification de progression pendant ce temps, l'appel d'outil s'interrompt avec une erreur au lieu d'attendre le `MCP_TOOL_TIMEOUT` mural. Définissez sur `0` pour désactiver la vérification d'inactivité. Les valeurs inférieures à 1 000 sont augmentées à une seconde, et la valeur est plafonnée au `MCP_TOOL_TIMEOUT` effectif. Ne s'applique pas aux serveurs stdio ou IDE. Nécessite Claude Code v2.1.187 ou ultérieur |

233| `CLAUDE_CODE_NATIVE_CURSOR` | Définissez sur `1` pour afficher le curseur propre du terminal au curseur d'entrée au lieu d'un bloc dessiné. Le curseur respecte les paramètres de clignotement, de forme et de focus du terminal |234| `CLAUDE_CODE_NATIVE_CURSOR` | Définissez sur `1` pour afficher le curseur propre du terminal au curseur d'entrée au lieu d'un bloc dessiné. Le curseur respecte les paramètres de clignotement, de forme et de focus du terminal |

234| `CLAUDE_CODE_NEW_INIT` | Définissez sur `1` pour faire exécuter `/init` un flux de configuration interactif. Le flux demande quels fichiers générer, y compris CLAUDE.md, skills et hooks, avant d'explorer la base de code et de les écrire. Sans cette variable, `/init` génère un CLAUDE.md automatiquement sans demander. |235| `CLAUDE_CODE_NEW_INIT` | Définissez sur `1` pour faire exécuter `/init` un flux de configuration interactif. Le flux demande quels fichiers générer, y compris CLAUDE.md, skills et hooks, avant d'explorer la base de code et de les écrire. Sans cette variable, `/init` génère un CLAUDE.md automatiquement sans demander. |

235| `CLAUDE_CODE_NO_FLICKER` | Définissez sur `1` pour activer le [rendu en plein écran](/fr/fullscreen), un aperçu de recherche qui réduit le scintillement et maintient la mémoire plate dans les longues conversations. Équivalent au paramètre [`tui`](/fr/settings#available-settings) ; vous pouvez également basculer avec `/tui fullscreen` |236| `CLAUDE_CODE_NO_FLICKER` | Définissez sur `1` pour activer le [rendu en plein écran](/fr/fullscreen), un aperçu de recherche qui réduit le scintillement et maintient la mémoire plate dans les longues conversations. Équivalent au paramètre [`tui`](/fr/settings#available-settings) ; vous pouvez également basculer avec `/tui fullscreen` |

errors.md +17 −0

Details

55| `Extra inputs are not permitted` | [Erreurs de requête](#extra-inputs-are-not-permitted) |55| `Extra inputs are not permitted` | [Erreurs de requête](#extra-inputs-are-not-permitted) |

56| `There's an issue with the selected model` | [Erreurs de requête](#there%E2%80%99s-an-issue-with-the-selected-model) |56| `There's an issue with the selected model` | [Erreurs de requête](#there%E2%80%99s-an-issue-with-the-selected-model) |

57| `Claude Opus is not available with the Claude Pro plan` | [Erreurs de requête](#claude-opus-is-not-available-with-the-claude-pro-plan) |57| `Claude Opus is not available with the Claude Pro plan` | [Erreurs de requête](#claude-opus-is-not-available-with-the-claude-pro-plan) |

58| `Model ... is restricted by your organization's settings` | [Erreurs de requête](#model-is-restricted-by-your-organization%E2%80%99s-settings) |

58| `thinking.type.enabled is not supported for this model` | [Erreurs de requête](#thinking-type-enabled-is-not-supported-for-this-model) |59| `thinking.type.enabled is not supported for this model` | [Erreurs de requête](#thinking-type-enabled-is-not-supported-for-this-model) |

59| `max_tokens must be greater than thinking.budget_tokens` | [Erreurs de requête](#thinking-budget-exceeds-output-limit) |60| `max_tokens must be greater than thinking.budget_tokens` | [Erreurs de requête](#thinking-budget-exceeds-output-limit) |

60| `API Error: 400 due to tool use concurrency issues` | [Erreurs de requête](#tool-use-or-thinking-block-mismatch) |61| `API Error: 400 due to tool use concurrency issues` | [Erreurs de requête](#tool-use-or-thinking-block-mismatch) |


706* Si vous avez récemment mis à niveau votre plan et voyez toujours cela, exécutez `/logout` puis `/login`. Le jeton stocké reflète votre plan au moment où vous vous êtes connecté, donc la mise à niveau sur le web ne prend effet dans une session existante que jusqu'à ce que vous vous réauthentifiiez.707* Si vous avez récemment mis à niveau votre plan et voyez toujours cela, exécutez `/logout` puis `/login`. Le jeton stocké reflète votre plan au moment où vous vous êtes connecté, donc la mise à niveau sur le web ne prend effet dans une session existante que jusqu'à ce que vous vous réauthentifiiez.

707* Consultez [claude.com/pricing](https://claude.com/pricing) pour savoir quels modèles chaque plan inclut708* Consultez [claude.com/pricing](https://claude.com/pricing) pour savoir quels modèles chaque plan inclut

708 709 

710<h3 id="model-is-restricted-by-your-organization’s-settings">

711 Model is restricted by your organization's settings

712</h3>

713 

714Votre administrateur d'organisation a désactivé ce modèle dans la Claude Console, ou il est exclu par une liste d'autorisation [`availableModels`](/fr/model-config#restrict-model-selection) dans les paramètres gérés. Lorsque le modèle restreint a été défini avec `--model`, `ANTHROPIC_MODEL` ou le paramètre `model`, Claude Code substitue un modèle autorisé et continue. Taper `/model <name>` pour un modèle restreint est rejeté avec `Run /model to choose a different model.` et la session conserve son modèle actuel.

715 

716```text theme={null}

717Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

718```

719 

720**Que faire :**

721 

722* Exécutez `/model` pour choisir parmi les modèles que votre organisation autorise. Les modèles restreints sont masqués du sélecteur.

723* Si le modèle restreint a été défini dans `--model`, `ANTHROPIC_MODEL` ou le champ `model` d'un fichier de paramètres, supprimez ou mettez à jour cette valeur pour que l'avis ne se reproduise pas à chaque lancement

724* Si vous avez besoin d'accès au modèle restreint, demandez à votre administrateur d'organisation de l'activer. Consultez [Organization model restrictions](/fr/model-config#organization-model-restrictions).

725 

709<h3 id="thinking-type-enabled-is-not-supported-for-this-model">726<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

710 thinking.type.enabled is not supported for this model727 thinking.type.enabled is not supported for this model

711</h3>728</h3>

fast-mode.md +1 −1

Details

115* **Activation par l'administrateur pour Team et Enterprise** : le mode rapide est désactivé par défaut pour les organisations Team et Enterprise. Un administrateur doit explicitement [activer le mode rapide](#enable-fast-mode-for-your-organization) avant que les utilisateurs puissent y accéder.115* **Activation par l'administrateur pour Team et Enterprise** : le mode rapide est désactivé par défaut pour les organisations Team et Enterprise. Un administrateur doit explicitement [activer le mode rapide](#enable-fast-mode-for-your-organization) avant que les utilisateurs puissent y accéder.

116 116 

117<Note>117<Note>

118 Si votre administrateur n'a pas activé le mode rapide pour votre organisation, la commande `/fast` affichera « Le mode rapide a été désactivé par votre organisation. » Si la liste d'autorisation [`availableModels`](/fr/model-config#restrict-model-selection) de votre organisation exclut le modèle Opus du mode rapide, `/fast` est refusé avec « n'est pas dans les modèles autorisés de votre organisation ».118 Si votre administrateur n'a pas activé le mode rapide pour votre organisation, la commande `/fast` affichera « Le mode rapide a été désactivé par votre organisation. » Si la liste d'autorisation [`availableModels`](/fr/model-config#restrict-model-selection) de votre organisation exclut le modèle Opus du mode rapide, `/fast` est refusé avec « n'est pas dans les modèles autorisés de votre organisation ». L'exception est une session déjà en cours d'exécution sur un modèle Opus autorisé qui prend en charge le mode rapide : `/fast` s'applique alors à ce modèle.

119</Note>119</Note>

120 120 

121<h3 id="enable-fast-mode-for-your-organization">121<h3 id="enable-fast-mode-for-your-organization">

fullscreen.md +1 −0

Details

56 56 

57* **Cliquez dans l'entrée d'invite** pour positionner votre curseur n'importe où dans le texte que vous tapez.57* **Cliquez dans l'entrée d'invite** pour positionner votre curseur n'importe où dans le texte que vous tapez.

58* **Cliquez sur une suggestion dans la liste de commandes `/` ou de fichiers `@`** pour l'accepter. Le survol met en évidence la ligne sous votre curseur.58* **Cliquez sur une suggestion dans la liste de commandes `/` ou de fichiers `@`** pour l'accepter. Le survol met en évidence la ligne sous votre curseur.

59* **Cliquez sur une option dans un menu de sélection** pour la choisir. Cela couvre les invites de permission, `/model`, `/config` et autres dialogues qui affichent une liste d'options. Le survol affiche un pointeur sur la ligne sous votre curseur. {/* min-version: 2.1.187 */}Nécessite Claude Code v2.1.187 ou ultérieur.

59* **Cliquez sur un résultat d'outil réduit** pour le développer et voir la sortie complète. Cliquez à nouveau pour le réduire. L'appel d'outil et son résultat se développent ensemble. Seuls les messages qui ont plus à afficher sont cliquables.60* **Cliquez sur un résultat d'outil réduit** pour le développer et voir la sortie complète. Cliquez à nouveau pour le réduire. L'appel d'outil et son résultat se développent ensemble. Seuls les messages qui ont plus à afficher sont cliquables.

60* **Maintenez `Cmd` sur macOS, ou `Ctrl` sur Linux et Windows, et cliquez sur une URL ou un chemin de fichier** pour l'ouvrir. Les chemins de fichiers dans la sortie de l'outil, comme ceux imprimés après une modification ou une écriture, s'ouvrent dans votre application par défaut. Les URLs `http://` et `https://` simples s'ouvrent dans votre navigateur. {/* min-version: 2.1.181 */}À partir de la v2.1.181, un simple clic sans maintenir `Cmd` ou `Ctrl` n'ouvre plus les liens, ce qui correspond au comportement du terminal natif. Dans le terminal intégré VS Code et les terminaux basés sur xterm.js similaires, Claude Code se défère au gestionnaire de lien du terminal, qui utilise le même geste.61* **Maintenez `Cmd` sur macOS, ou `Ctrl` sur Linux et Windows, et cliquez sur une URL ou un chemin de fichier** pour l'ouvrir. Les chemins de fichiers dans la sortie de l'outil, comme ceux imprimés après une modification ou une écriture, s'ouvrent dans votre application par défaut. Les URLs `http://` et `https://` simples s'ouvrent dans votre navigateur. {/* min-version: 2.1.181 */}À partir de la v2.1.181, un simple clic sans maintenir `Cmd` ou `Ctrl` n'ouvre plus les liens, ce qui correspond au comportement du terminal natif. Dans le terminal intégré VS Code et les terminaux basés sur xterm.js similaires, Claude Code se défère au gestionnaire de lien du terminal, qui utilise le même geste.

61* **Cliquez et glissez** pour sélectionner du texte n'importe où dans la conversation. Double-cliquez pour sélectionner un mot, en correspondant avec les limites de mots d'iTerm2 afin qu'un chemin de fichier se sélectionne comme une unité. Triple-cliquez pour sélectionner la ligne.62* **Cliquez et glissez** pour sélectionner du texte n'importe où dans la conversation. Double-cliquez pour sélectionner un mot, en correspondant avec les limites de mots d'iTerm2 afin qu'un chemin de fichier se sélectionne comme une unité. Triple-cliquez pour sélectionner la ligne.

Details

44 Configuration rapide44 Configuration rapide

45</h2>45</h2>

46 46 

47Le moyen le plus simple de configurer cette action est via Claude Code dans le terminal. Ouvrez simplement claude et exécutez `/install-github-app`.47Exécutez `/install-github-app` dans le terminal Claude Code pour configurer l'intégration de manière interactive. La commande installe l'application Claude GitHub sur votre repository et vous guide ensuite à travers l'ajout des workflows GitHub Actions et du secret de clé API.

48 48 

49Cette commande vous guidera à travers la configuration de l'application GitHub et des secrets requis.49Après l'installation de l'application GitHub, la commande vous demande si vous souhaitez continuer avec la configuration de GitHub Actions. Dans Claude Code v2.1.187 et versions ultérieures, vous pouvez choisir **Ignorer pour l'instant** pour arrêter avec seulement l'application installée et revenir aux étapes de workflow et de secret en exécutant `/install-github-app` à nouveau. Les versions antérieures passent directement à la sélection du workflow.

50 50 

51<Note>51<Note>

52 * Vous devez être administrateur du repository pour installer l'application GitHub et ajouter des secrets52 * Vous devez être administrateur du repository pour installer l'application GitHub et ajouter des secrets

glossary.md +2 −2

Details

208 Managed settings208 Managed settings

209</h3>209</h3>

210 210 

211Un fichier de paramètres appliqué à l'échelle de l'organisation par l'informatique ou DevOps, placé à un chemin au niveau du système d'exploitation en dehors de `~/.claude`. Les utilisateurs ne peuvent pas remplacer ou exclure les paramètres gérés. Utilisez ceci pour les politiques de sécurité, les exigences de conformité ou les outils standardisés sur une flotte.211Les paramètres gérés sont des paramètres appliqués à l'échelle de l'organisation par l'informatique ou DevOps, fournis par les serveurs d'Anthropic via la console d'administration ou déployés sur les appareils à un chemin au niveau du système d'exploitation en dehors de `~/.claude`. Les utilisateurs ne peuvent pas remplacer les paramètres gérés à partir de portées de priorité inférieure. La livraison gérée par le serveur s'applique sur les [configurations éligibles](/fr/server-managed-settings#platform-availability) ; consultez les [Considérations de sécurité](/fr/server-managed-settings#security-considerations). Utilisez ceci pour les politiques de sécurité, les exigences de conformité ou les outils standardisés sur une flotte.

212 212 

213En savoir plus : [Server-managed settings](/fr/server-managed-settings)213En savoir plus : [Server-managed settings](/fr/server-managed-settings) · [Settings files](/fr/settings#settings-files)

214 214 

215<h3 id="mcp-model-context-protocol">215<h3 id="mcp-model-context-protocol">

216 MCP (Model Context Protocol)216 MCP (Model Context Protocol)

Details

268 * Appuyez sur `Ctrl+C` pour annuler et restaurer votre entrée d'origine268 * Appuyez sur `Ctrl+C` pour annuler et restaurer votre entrée d'origine

269 * Appuyez sur `Retour arrière` sur une recherche vide pour annuler269 * Appuyez sur `Retour arrière` sur une recherche vide pour annuler

270 270 

271La recherche affiche les commandes correspondantes avec le terme de recherche mis en évidence, afin que vous puissiez trouver et réutiliser les entrées précédentes.271La recherche charge les 100 invites uniques les plus récentes dans la portée sélectionnée, avec les doublons réduits à l'occurrence la plus récente. Les invites correspondantes s'affichent avec le terme de recherche mis en évidence, afin que vous puissiez trouver et réutiliser les entrées précédentes.

272 272 

273<h2 id="background-bash-commands">273<h2 id="background-bash-commands">

274 Commandes bash en arrière-plan274 Commandes bash en arrière-plan


374| :-------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |374| :-------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

375| `Espace`, `Entrée`, `Échap` | Rejeter la réponse et revenir à l'invite |375| `Espace`, `Entrée`, `Échap` | Rejeter la réponse et revenir à l'invite |

376| `Haut` / `Bas` | Faire défiler la réponse |376| `Haut` / `Bas` | Faire défiler la réponse |

377| `Gauche` / `Droite` | {/* min-version: 2.1.187 */}Naviguer entre cette réponse et vos réponses `/btw` antérieures de la session. `Gauche` se déplace vers les réponses plus anciennes et `Droite` revient vers la réponse actuelle. Nécessite Claude Code v2.1.187 ou version ultérieure |

377| `c` | Copier la réponse dans votre presse-papiers en tant que Markdown brut. Utilisez ceci au lieu de la sélection à la souris, qui capture le rendu du terminal avec retour à la ligne plutôt que le texte source |378| `c` | Copier la réponse dans votre presse-papiers en tant que Markdown brut. Utilisez ceci au lieu de la sélection à la souris, qui capture le rendu du terminal avec retour à la ligne plutôt que le texte source |

378| `f` | Diviser en une nouvelle session. La division hérite de la conversation parent plus cette question et réponse en tant que tours de transcription réels, vous pouvez donc continuer avec un accès complet aux outils. La session d'origine est conservée sous [`/resume`](/fr/commands). Disponible uniquement dans les sessions locales |379| `f` | Diviser en une nouvelle session. La division hérite de la conversation parent plus cette question et réponse en tant que tours de transcription réels, vous pouvez donc continuer avec un accès complet aux outils. La session d'origine est conservée sous [`/resume`](/fr/commands). Disponible uniquement dans les sessions locales |

379| `x` | Effacer la liste des échanges `/btw` antérieurs affichés au-dessus de la réponse actuelle |380| `x` | Effacer la liste des échanges `/btw` antérieurs affichés au-dessus de la réponse actuelle |

mcp.md +2 −0

Details

218 218 

219Le `timeout` par serveur est une limite stricte en temps réel par appel d'outil, et les notifications de progression du serveur ne l'étendent pas. Les valeurs inférieures à 1000 sont ignorées et passent à `MCP_TOOL_TIMEOUT`, ou à sa valeur par défaut d'environ 28 heures lorsque cette variable n'est pas définie. {/* min-version: 2.1.162 */}Avant la v2.1.162, les valeurs inférieures à 1000 étaient arrondies à une seconde. Pour les serveurs HTTP et SSE, le budget du premier octet par requête de récupération a un minimum de 60 secondes.219Le `timeout` par serveur est une limite stricte en temps réel par appel d'outil, et les notifications de progression du serveur ne l'étendent pas. Les valeurs inférieures à 1000 sont ignorées et passent à `MCP_TOOL_TIMEOUT`, ou à sa valeur par défaut d'environ 28 heures lorsque cette variable n'est pas définie. {/* min-version: 2.1.162 */}Avant la v2.1.162, les valeurs inférieures à 1000 étaient arrondies à une seconde. Pour les serveurs HTTP et SSE, le budget du premier octet par requête de récupération a un minimum de 60 secondes.

220 220 

221À partir de la v2.1.187, un appel d'outil à un serveur HTTP, SSE, WebSocket distant, ou un [connecteur claude.ai](#use-mcp-servers-from-claude-ai) qui n'envoie aucune réponse et aucune notification de progression pendant 5 minutes s'interrompt avec une erreur au lieu d'attendre la limite en temps réel. Définissez la variable d'environnement [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/fr/env-vars) en millisecondes pour modifier la fenêtre d'inactivité, ou définissez-la à `0` pour désactiver la vérification. Les serveurs Stdio sont des processus locaux et ne sont pas soumis au délai d'expiration d'inactivité.

222 

221<h3 id="plugin-provided-mcp-servers">223<h3 id="plugin-provided-mcp-servers">

222 Serveurs MCP fournis par les plugins224 Serveurs MCP fournis par les plugins

223</h3>225</h3>

model-config.md +69 −16

Details

90 90 

91L'indicateur `--model` et la variable d'environnement `ANTHROPIC_MODEL` s'appliquent uniquement à la session que vous lancez avec eux. Pour exécuter différents modèles dans différents terminaux en même temps, lancez chacun avec son propre indicateur `--model` plutôt que de basculer avec `/model`.91L'indicateur `--model` et la variable d'environnement `ANTHROPIC_MODEL` s'appliquent uniquement à la session que vous lancez avec eux. Pour exécuter différents modèles dans différents terminaux en même temps, lancez chacun avec son propre indicateur `--model` plutôt que de basculer avec `/model`.

92 92 

93Les sessions reprises démarrées avec `claude --resume`, `--continue`, ou le sélecteur `/resume` conservent le modèle qu'elles utilisaient lorsque la transcription a été enregistrée, indépendamment du paramètre `model` actuel. Si ce modèle a été retiré, la session revient à l'ordre de priorité normal. Cela empêche le choix `/model` d'une autre session de modifier le modèle à la reprise.93Les sessions reprises démarrées avec `claude --resume`, `--continue`, ou le sélecteur `/resume` conservent le modèle qu'elles utilisaient lorsque la transcription a été enregistrée, indépendamment du paramètre `model` actuel. Si ce modèle a été retiré ou est exclu par [`availableModels`](#restrict-model-selection), la session revient à l'ordre de priorité normal. Cela empêche le choix `/model` d'une autre session de modifier le modèle à la reprise.

94 94 

95Lorsque le modèle actif au démarrage provient des paramètres du projet ou gérés plutôt que de votre propre sélection, l'en-tête de démarrage indique quel fichier de paramètres l'a défini. Exécutez `/model` pour remplacer ; le paramètre du projet ou géré se réapplique au prochain lancement.95Lorsque le modèle actif au démarrage provient des paramètres du projet ou gérés plutôt que de votre propre sélection, l'en-tête de démarrage indique quel fichier de paramètres l'a défini. Exécutez `/model` pour remplacer ; le paramètre du projet ou géré se réapplique au prochain lancement.

96 96 


121 Restreindre la sélection du modèle121 Restreindre la sélection du modèle

122</h2>122</h2>

123 123 

124Les administrateurs d'entreprise peuvent utiliser `availableModels` dans les [paramètres gérés ou de politique](/fr/settings#settings-files) pour restreindre les modèles que les utilisateurs peuvent sélectionner.124Les administrateurs d'entreprise peuvent utiliser `availableModels` dans les [paramètres gérés ou de politique](/fr/settings#settings-files) pour restreindre les modèles que les utilisateurs peuvent sélectionner. Les entrées correspondent à une famille de modèles telle que `sonnet`, un préfixe de version tel que `claude-sonnet-4-5`, ou un ID de modèle complet tel que `claude-sonnet-4-5-20250929`.

125 125 

126Lorsque `availableModels` est défini, la liste d'autorisation s'applique à chaque surface où un utilisateur peut nommer un modèle :126Lorsque `availableModels` est défini, la liste d'autorisation s'applique à chaque surface où un utilisateur peut nommer un modèle :

127 127 

128* **Modèle de session principale** : `/model`, le drapeau `--model`, et la variable d'environnement `ANTHROPIC_MODEL`128* **Modèle de session principale** : `/model`, le drapeau `--model`, la variable d'environnement `ANTHROPIC_MODEL`, le paramètre `model`, et le modèle restauré lors de la [reprise d'une session](#setting-your-model)

129* **Résolution d'alias** : {/* min-version: 2.1.176 */}les variables d'environnement `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, et `ANTHROPIC_DEFAULT_FABLE_MODEL` ne peuvent pas rediriger un alias autorisé vers un modèle en dehors de la liste129* **Résolution d'alias** : {/* min-version: 2.1.176 */}les variables d'environnement `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, et `ANTHROPIC_DEFAULT_FABLE_MODEL` ne peuvent pas rediriger un alias autorisé vers un modèle en dehors de la liste

130* **Mode rapide** : {/* min-version: 2.1.176 */}`/fast` refuse de basculer lorsque cela changerait implicitement vers un modèle Opus en dehors de la liste, avec le message « is not in your organization's allowed models »130* **Mode rapide** : {/* min-version: 2.1.176 */}`/fast` refuse de basculer lorsque cela changerait implicitement vers un modèle Opus en dehors de la liste, avec le message « is not in your organization's allowed models »

131* **Modèles de sous-agent** : le champ `model` dans le frontmatter du [sous-agent](/fr/sub-agents#choose-a-model), le paramètre `model` de l'outil Agent, le sélecteur de modèle dans `/agents`, et `CLAUDE_CODE_SUBAGENT_MODEL`131* **Modèles de sous-agent** : le champ `model` dans le frontmatter du [sous-agent](/fr/sub-agents#choose-a-model), le paramètre `model` de l'outil Agent, le sélecteur de modèle dans `/agents`, et `CLAUDE_CODE_SUBAGENT_MODEL`

132* **Modèle de conseiller** : le paramètre [`advisorModel`](/fr/advisor) configuré132* **Modèles de compétence et de commande** : le frontmatter `model` dans les [compétences et commandes](/fr/skills)

133* **Chaînes de secours** : les éléments d'une [chaîne de modèle de secours](#fallback-model-chains) en dehors de la liste sont supprimés133* **Modèle de conseiller** : le paramètre [`advisorModel`](/fr/advisor) configuré et le drapeau `--advisor`

134* **Modèle d'agent d'arrière-plan** : le modèle sélectionné dans le [sélecteur de dispatch](/fr/agent-view)

134 135 

135Le basculement vers un modèle bloqué avec `/model` est rejeté avec une erreur, tandis qu'un drapeau `--model` bloqué ou une valeur `ANTHROPIC_MODEL` est remplacée au démarrage par un avertissement nommant à la fois les modèles demandés et substitués, et la session démarre sur le modèle par défaut. Un remplacement de sous-agent ou de conseiller bloqué revient au modèle hérité ou par défaut plutôt que d'échouer la demande.136Le basculement vers un modèle bloqué avec `/model` est rejeté avec une erreur, tandis qu'un drapeau `--model` bloqué, une valeur `ANTHROPIC_MODEL`, ou une valeur de paramètre `model` est remplacée au démarrage par un avertissement nommant à la fois les modèles demandés et substitués, et la session démarre sur le modèle par défaut. Un remplacement de sous-agent, de compétence ou de commande bloqué revient au modèle hérité ou par défaut plutôt que d'échouer la demande ; un paramètre `advisorModel` bloqué désactive le conseiller pour la session, tandis qu'une valeur de drapeau `--advisor` bloquée quitte avec une erreur au lancement. Les modèles exclus sont masqués du sélecteur `/model`.

137 

138Les changements de modèle automatiques sont vérifiés de la même manière : les éléments d'une [chaîne de modèle de secours](#fallback-model-chains) en dehors de la liste d'autorisation sont supprimés, une mise à niveau en mode plan telle que [`opusplan`](#opusplan-model-setting) vers un modèle exclu est ignorée afin que la planification continue sur le modèle de la session, et un [repli automatique de modèle](#automatic-model-fallback) dont la cible est exclue ne s'exécute pas, de sorte que la demande signalée se termine par un refus. L'activation du [mode rapide](/fr/fast-mode) est refusée lorsque le modèle sur lequel la session s'exécuterait ensuite est en dehors de la liste d'autorisation.

136 139 

137```json theme={null}140```json theme={null}

138{141{


140}143}

141```144```

142 145 

146<h3 id="surface-coverage">

147 Couverture de surface

148</h3>

149 

150Chaque surface applique la liste d'autorisation qu'elle reçoit. Le mécanisme de livraison qui atteint chaque surface diffère :

151 

152| Mécanisme de livraison | CLI et IDE | Sessions locales de bureau | Sessions web, mobile et cloud | Agent SDK et non-interactif | Cowork |

153| :------------------------------------------------------------------------------------------------ | :--------- | :------------------------- | :---------------------------- | :-------------------------- | :------------------ |

154| [Paramètres gérés par le serveur](/fr/server-managed-settings) depuis la console d'administration | Appliqué | Appliqué | Appliqué | Appliqué | Non livré |

155| [Fichiers de paramètres gérés ou MDM](/fr/settings#settings-files) | Appliqué | Appliqué | Non livré | Appliqué | Appliqué où déployé |

156 

157* Les sessions cloud, sur [Claude Code sur le web](/fr/claude-code-on-the-web) ou dans l'application de bureau, s'exécutent sur des machines virtuelles gérées par Anthropic : les paramètres déployés sur votre appareil ne les atteignent pas, donc livrez la liste d'autorisation via les paramètres gérés par le serveur. Un changement de modèle en milieu de session dans une session cloud est rejeté lorsque le modèle demandé est exclu par la liste d'autorisation. Le rejet côté serveur à la création de session s'applique aux [restrictions de modèle d'organisation](#organization-model-restrictions), pas à la clé de paramètres `availableModels`.

158* Cowork, l'onglet de travail agentique dans l'application Claude Desktop, n'est pas une surface Claude Code et ne reçoit pas les paramètres gérés par le serveur par conception. Un fichier de paramètres gérés s'applique aux sessions Cowork lorsqu'il est présent où la session s'exécute ; les sessions Cowork distantes s'exécutent sur des machines virtuelles gérées par Anthropic, où un fichier déployé sur l'appareil n'est pas présent.

159* Les sessions sur les [fournisseurs tiers](/fr/server-managed-settings#platform-availability) tels que Bedrock, Vertex AI, Foundry, et [Claude Platform sur AWS](/fr/claude-platform-on-aws) ne reçoivent pas les paramètres gérés par le serveur, donc livrez la liste d'autorisation via MDM ou des fichiers de paramètres gérés là-bas.

160* La livraison gérée par le serveur nécessite également que la session s'authentifie avec une connexion d'organisation ou une clé API directement configurée. Les flottes qui génèrent des clés uniquement via un script [`apiKeyHelper`](/fr/settings#available-settings) doivent livrer la liste d'autorisation via MDM ou des fichiers de paramètres gérés.

161* L'onglet Code de bureau héberge également les [sessions SSH](/fr/desktop#ssh-sessions), qui lisent le fichier de paramètres gérés depuis l'hôte distant sur lequel elles s'exécutent. Voir [Paramètres gérés de bureau](/fr/desktop#managed-settings).

162* Les sélecteurs de modèle sur claude.ai et dans l'application de bureau masquent ou grisent les modèles exclus par la liste d'autorisation de votre organisation. L'état du sélecteur est une commodité pour les utilisateurs ; l'application se fait dans la session.

163 

143<h3 id="default-model-behavior">164<h3 id="default-model-behavior">

144 Comportement du modèle par défaut165 Comportement du modèle par défaut

145</h3>166</h3>

146 167 

147Par défaut, l'option Par défaut dans le sélecteur de modèle n'est pas affectée par `availableModels`. Elle reste disponible et représente la valeur par défaut du système [basée sur le niveau d'abonnement de l'utilisateur](#default-model-setting).168L'option Par défaut dans le sélecteur de modèle n'est pas affectée par `availableModels` sauf si [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) est également défini. En soi, `availableModels` laisse Par défaut disponible, se résolvant au système par défaut d'exécution [basé sur le niveau d'abonnement de l'utilisateur](#default-model-setting). Si la valeur par défaut du niveau est un modèle que vous avez l'intention de restreindre, définissez également `enforceAvailableModels`.

148 169 

149Pour étendre la liste d'autorisation à l'option Par défaut, définissez `enforceAvailableModels` sur `true` dans les paramètres gérés ou de politique aux côtés d'une liste `availableModels` non vide. Lorsque la valeur par défaut du niveau n'est pas dans la liste d'autorisation, Par défaut se résout à la première entrée autorisée au lieu de la valeur par défaut du niveau. Cela nécessite Claude Code v2.1.175 ou ultérieur.170Un tableau `availableModels` vide n'engage jamais l'application du modèle par défaut : avec `availableModels: []`, les sélections de modèle nommées sont bloquées mais le modèle Par défaut pour le type de compte reste utilisable indépendamment de `enforceAvailableModels`.

150 171 

151Un tableau `availableModels` vide n'engage jamais l'application. Même avec `availableModels: []`, les utilisateurs peuvent toujours utiliser Claude Code avec le modèle Par défaut pour leur niveau indépendamment de `enforceAvailableModels`.172<h3 id="enforce-the-allowlist-for-the-default-model">

173 Appliquer la liste d'autorisation au modèle par défaut

174</h3>

175 

176Définissez `enforceAvailableModels: true` aux côtés d'une liste `availableModels` non vide dans les paramètres gérés pour étendre la liste d'autorisation à l'option Par défaut. Cela nécessite Claude Code v2.1.175 ou ultérieur.

177 

178```json theme={null}

179{

180 "availableModels": ["sonnet", "haiku"],

181 "enforceAvailableModels": true

182}

183```

184 

185Lorsque le modèle par défaut pour le type de compte de l'utilisateur n'est pas dans la liste d'autorisation, l'option Par défaut se résout à la première entrée `availableModels` qui nomme un modèle autorisé et disponible, et la ligne Par défaut du sélecteur `/model` affiche ce modèle. Cela s'applique partout où la valeur par défaut est atteinte : démarrage de session, sélection de Par défaut dans `/model`, le mot-clé `"default"` dans les [chaînes de modèle de secours](#fallback-model-chains), et le repli utilisé lorsqu'une sélection exclue est supprimée.

186 

187`enforceAvailableModels` n'a aucun effet lorsque `availableModels` n'est pas défini ou vide : avec `availableModels: []`, le modèle Par défaut pour le type de compte reste utilisable, de sorte que le paramètre ne peut pas verrouiller les utilisateurs hors de chaque modèle. Lorsque `availableModels` est non vide mais qu'aucune entrée ne se résout à un modèle autorisé et disponible, l'application se dégrade et Par défaut revient à la valeur par défaut du type de compte, avec un avertissement visible uniquement sous `--debug`. Conservez au moins une entrée garantie disponible dans la liste pour éviter cela.

188 

189Déployez les deux clés dans la [source gérée de plus haute priorité](/fr/settings#settings-precedence) : les sources gérées déployées par l'administrateur ne fusionnent pas, de sorte qu'une paire placée dans un fichier de paramètres gérés est ignorée lorsque la console d'administration livre des paramètres.

152 190 

153<h3 id="control-the-model-users-run-on">191<h3 id="control-the-model-users-run-on">

154 Contrôler le modèle sur lequel les utilisateurs s'exécutent192 Contrôler le modèle sur lequel les utilisateurs s'exécutent

155</h3>193</h3>

156 194 

157Le paramètre `model` est une sélection initiale, pas une application. Il définit quel modèle est actif au démarrage d'une session, mais les utilisateurs peuvent toujours ouvrir `/model` et choisir Par défaut, qui se résout au système par défaut pour leur niveau indépendamment de ce que `model` est défini.195Le paramètre `model` est une sélection initiale, pas une application. Il définit quel modèle est actif au démarrage d'une session, mais les utilisateurs peuvent toujours ouvrir `/model` et choisir Par défaut, qui se résout au système par défaut pour leur niveau indépendamment de ce que `model` est défini, sauf si [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) le redirige.

158 196 

159Pour contrôler complètement l'expérience du modèle, combinez ces paramètres :197Pour contrôler complètement l'expérience du modèle, combinez ces paramètres :

160 198 


182 Comportement de fusion220 Comportement de fusion

183</h3>221</h3>

184 222 

185Lorsque `availableModels` est défini dans les paramètres utilisateur, projet et local uniquement, les tableaux sont fusionnés et dédupliqués à travers ces niveaux.223Lorsque la [source de paramètres gérés de plus haute priorité](/fr/server-managed-settings#settings-precedence) définit `availableModels`, cette liste seule s'applique : les entrées dans les paramètres utilisateur, projet ou local ne peuvent pas l'étendre, et les sources gérées déployées par l'administrateur ne fusionnent pas les unes avec les autres, de sorte qu'une liste déployée dans un fichier de paramètres gérés est ignorée lorsque les paramètres gérés par le serveur livrent des clés. Sinon, les listes des paramètres utilisateur, projet et local sont [concaténées et dédupliquées](/fr/settings#settings-precedence) comme d'autres paramètres de tableau. {/* min-version: 2.1.175 */}À partir de Claude Code v2.1.175, la liste gérée remplace les entrées de priorité inférieure ; les versions antérieures les fusionnent.

186 224 

187Lorsque `availableModels` est défini dans les paramètres gérés ou de politique, la valeur gérée ou de politique remplace entièrement le résultat fusionné : les entrées ajoutées dans les paramètres utilisateur ou projet ne peuvent pas l'élargir. Les paramètres gérés et de politique remplacent les valeurs de priorité inférieure pour `enforceAvailableModels` de la même manière. À partir de Claude Code v2.1.175, c'est la seule façon d'appliquer une liste d'autorisation stricte ; les versions antérieures fusionnent la liste gérée avec les entrées de priorité inférieure.225Dans la liste effective, une entrée nommant un modèle spécifique dans une famille, qu'il s'agisse d'un préfixe de version ou d'un ID de modèle complet, désactive l'entrée générique de cette famille : `["sonnet", "claude-sonnet-4-5"]` permet uniquement les versions Sonnet 4.5, pas tous les modèles Sonnet.

188 226 

189<h3 id="mantle-model-ids">227<h3 id="mantle-model-ids">

190 ID de modèle Mantle228 ID de modèle Mantle

191</h3>229</h3>

192 230 

193Lorsque le [point de terminaison Bedrock Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) est activé, les entrées dans `availableModels` qui commencent par `anthropic.` sont ajoutées au sélecteur `/model` en tant qu'options personnalisées et acheminées vers le point de terminaison Mantle. Le paramètre restreint toujours le sélecteur aux entrées listées, donc incluez les alias standard aux côtés de tous les ID Mantle.231Lorsque le [point de terminaison Bedrock Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) est activé, les entrées dans `availableModels` qui commencent par `anthropic.` sont ajoutées au sélecteur `/model` en tant qu'options personnalisées et acheminées vers le point de terminaison Mantle. Ceci est une exception à la correspondance d'alias décrite dans [Épingler les modèles pour les déploiements tiers](#pin-models-for-third-party-deployments). Le paramètre restreint toujours le sélecteur aux entrées listées, et un ID Mantle intègre un nom de famille, de sorte qu'il compte comme une entrée spécifique et désactive la générique de cette famille : aux côtés de tous les ID Mantle, listez les préfixes de version ou les ID complets que vous voulez garder sélectionnables. Voir [Comportement de fusion](#merge-behavior).

232 

233<h3 id="organization-model-restrictions">

234 Restrictions de modèle d'organisation

235</h3>

236 

237Utilisez le bouton bascule de la Console au lieu de `availableModels` lorsque vos membres s'authentifient via l'API Anthropic et que vous voulez un commutateur à l'échelle de l'organisation sans déployer de fichiers de paramètres. Les administrateurs d'organisation restreignent les modèles que les membres peuvent exécuter en désactivant les modèles individuels dans la Console Claude. Cette restriction est livrée avec les droits du compte lorsque Claude Code s'authentifie, séparée de toute liste `availableModels` dans les paramètres, et le serveur applique la même restriction indépendamment lorsqu'une session est créée. Nécessite Claude Code v2.1.187 ou ultérieur.

238 

239Un modèle restreint est masqué du sélecteur `/model`. Le sélectionner par nom avec `--model`, la variable d'environnement `ANTHROPIC_MODEL`, ou le paramètre `model` affiche l'avis `Model "<name>" is restricted by your organization's settings. Using <model> instead.` et la session démarre sur un modèle autorisé. Taper `/model <name>` pour un modèle restreint est rejeté avec `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` et la session conserve son modèle actuel.

240 

241Les deux mécanismes se composent : un modèle est sélectionnable uniquement lorsqu'il est autorisé par `availableModels` et non restreint par l'organisation. Les restrictions d'organisation sont livrées aux sessions sur l'API Anthropic et les déploiements de [passerelle LLM](/fr/llm-gateway). Les sessions sur Bedrock, Vertex AI, Foundry, et Claude Platform sur AWS ne les reçoivent pas, de sorte qu'utilisez `availableModels` sur ces fournisseurs à la place.

194 242 

195<h2 id="special-model-behavior">243<h2 id="special-model-behavior">

196 Comportement spécial du modèle244 Comportement spécial du modèle


209 257 

210Enterprise pay-as-you-go signifie une organisation Enterprise facturée à l'utilisation plutôt que par siège d'abonnement.258Enterprise pay-as-you-go signifie une organisation Enterprise facturée à l'utilisation plutôt que par siège d'abonnement.

211 259 

260Lorsque les paramètres gérés [appliquent la liste d'autorisation pour le modèle par défaut](#enforce-the-allowlist-for-the-default-model) et que le modèle par défaut du type de compte n'est pas dans `availableModels`, `default` se résout vers le modèle par défaut appliqué au lieu du modèle par défaut du type de compte ci-dessus.

261 

212Fable 5 n'est le modèle par défaut sur aucun type de compte. Les sessions utilisent Fable 5 uniquement après que vous l'ayez choisi, avec `/model fable`, un paramètre `model`, ou l'alias `best` où Fable 5 est disponible. Le choisir avec `/model` l'enregistre comme modèle sélectionné dans vos paramètres utilisateur, de sorte que les sessions ultérieures commencent sur Fable 5 jusqu'à ce que vous changiez de modèles.262Fable 5 n'est le modèle par défaut sur aucun type de compte. Les sessions utilisent Fable 5 uniquement après que vous l'ayez choisi, avec `/model fable`, un paramètre `model`, ou l'alias `best` où Fable 5 est disponible. Le choisir avec `/model` l'enregistre comme modèle sélectionné dans vos paramètres utilisateur, de sorte que les sessions ultérieures commencent sur Fable 5 jusqu'à ce que vous changiez de modèles.

213 263 

214<h3 id="opusplan-model-setting">264<h3 id="opusplan-model-setting">


267 317 

268La session continue ensuite sur ce modèle Opus. Pour revenir à Fable 5, exécutez `/model fable`.318La session continue ensuite sur ce modèle Opus. Pour revenir à Fable 5, exécutez `/model fable`.

269 319 

320La cible de basculement est vérifiée par rapport à [`availableModels`](#restrict-model-selection). Lorsqu'elle est bloquée, aucun basculement ne se produit. Le refus apparaît comme une erreur normale et le modèle de la session reste inchangé.

321 

270<h4 id="check-what-triggered-fallback">322<h4 id="check-what-triggered-fallback">

271 Vérifier ce qui a déclenché le basculement323 Vérifier ce qui a déclenché le basculement

272</h4>324</h4>


286* Si les deux modèles signalent la même demande, vous pouvez modifier l'invite et réessayer, ou démarrer une nouvelle session.338* Si les deux modèles signalent la même demande, vous pouvez modifier l'invite et réessayer, ou démarrer une nouvelle session.

287* Sur les sessions mobiles [Claude Code sur le web](/fr/claude-code-on-the-web), la modification et la nouvelle tentative ne sont pas prises en charge. Basculez les modèles, ou continuez la session à partir d'un navigateur de bureau ou de l'application de bureau.339* Sur les sessions mobiles [Claude Code sur le web](/fr/claude-code-on-the-web), la modification et la nouvelle tentative ne sont pas prises en charge. Basculez les modèles, ou continuez la session à partir d'un navigateur de bureau ou de l'application de bureau.

288* En [mode non interactif](/fr/cli-reference#cli-flags) et les intégrations SDK qui ne peuvent pas afficher l'invite, une demande signalée termine le tour avec un refus à la place.340* En [mode non interactif](/fr/cli-reference#cli-flags) et les intégrations SDK qui ne peuvent pas afficher l'invite, une demande signalée termine le tour avec un refus à la place.

341* Lorsque la cible de basculement est bloquée par [`availableModels`](#restrict-model-selection), l'invite n'est pas affichée. La demande signalée se termine par le refus, de la même manière que le basculement automatique lorsque la cible est bloquée.

289 342 

290<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">343<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">

291 Activer le basculement sur Bedrock, Vertex AI et Foundry344 Activer le basculement sur Bedrock, Vertex AI et Foundry


452 505 

453L'entrée personnalisée apparaît au bas du sélecteur `/model`. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` et `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` sont optionnels. S'ils sont omis, l'ID du modèle est utilisé comme nom et la description par défaut est `Custom model (<model-id>)`.506L'entrée personnalisée apparaît au bas du sélecteur `/model`. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` et `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` sont optionnels. S'ils sont omis, l'ID du modèle est utilisé comme nom et la description par défaut est `Custom model (<model-id>)`.

454 507 

455Claude Code ignore la validation pour l'ID de modèle défini dans `ANTHROPIC_CUSTOM_MODEL_OPTION`, vous pouvez donc utiliser n'importe quelle chaîne que votre point de terminaison API accepte.508Claude Code ignore la validation pour l'ID de modèle défini dans `ANTHROPIC_CUSTOM_MODEL_OPTION`, vous pouvez donc utiliser n'importe quelle chaîne que votre point de terminaison API accepte. Lorsque [`availableModels`](#restrict-model-selection) est défini, incluez également l'ID de modèle personnalisé dans la liste d'autorisation : l'entrée personnalisée est filtrée du sélecteur et une sélection `--model` de celui-ci est rejetée comme tout autre modèle exclu. Un ID personnalisé qui intègre un nom de famille, tel que `my-gateway/claude-opus-4-7`, compte comme une entrée spécifique pour cette famille et désactive son caractère générique, donc listez également les versions que vous avez l'intention de garder sélectionnables. Voir [Comportement de fusion](#merge-behavior).

456 509 

457<h2 id="environment-variables">510<h2 id="environment-variables">

458 Variables d'environnement511 Variables d'environnement


505* Le suffixe est lu par variable, et non par modèle. Sur Bedrock, Vertex et Foundry, un ID de modèle sans `[1m]` dans une variable utilise le contexte 200K même si une autre variable définit le même modèle avec le suffixe.558* Le suffixe est lu par variable, et non par modèle. Sur Bedrock, Vertex et Foundry, un ID de modèle sans `[1m]` dans une variable utilise le contexte 200K même si une autre variable définit le même modèle avec le suffixe.

506 559 

507<Note>560<Note>

508 La liste d'autorisation `settings.availableModels` s'applique toujours lors de l'utilisation de fournisseurs tiers. Le filtrage correspond à l'alias de modèle tel que `opus`, le préfixe de version tel que `claude-opus-4-8`, ou l'ID de modèle complet. Tout suffixe `[1m]` est supprimé de l'entrée de la liste d'autorisation et du modèle demandé avant la correspondance, donc une entrée de `claude-opus-4-8` permet à la fois les lignes Opus standard et 1M-contexte. Les préfixes spécifiques au fournisseur tels que `us.anthropic.` ne sont pas supprimés : listez la même forme dans `availableModels` que le sélecteur affiche, ou mappez-la via [`modelOverrides`](#override-model-ids-per-version).561 Une liste d'autorisation `availableModels` livrée via [MDM ou un fichier de paramètres gérés](/fr/settings#settings-files) s'applique toujours lors de l'utilisation de fournisseurs tiers ; les [paramètres gérés par le serveur ne sont pas livrés là](/fr/server-managed-settings#platform-availability). Le filtrage correspond à un alias de modèle tel que `opus`, un préfixe de version tel que `claude-opus-4-8`, ou l'ID de modèle complet spécifique au fournisseur. Les préfixes spécifiques au fournisseur tels que `us.anthropic.` ne sont pas supprimés, donc pour autoriser un modèle spécifique, listez le même ID spécifique au fournisseur que le sélecteur affiche, ou mappez-le via [`modelOverrides`](#override-model-ids-per-version). Tout suffixe `[1m]` est supprimé de l'entrée de la liste d'autorisation et du modèle demandé avant la correspondance.

509</Note>562</Note>

510 563 

511<h3 id="customize-pinned-model-display-and-capabilities">564<h3 id="customize-pinned-model-display-and-capabilities">


572 625 

573Les remplacements remplacent les ID de modèle intégrés qui soutiennent chaque entrée dans le sélecteur `/model`. Sur Bedrock, les remplacements prennent la priorité sur tous les profils d'inférence que Claude Code découvre automatiquement au démarrage. Les valeurs que vous fournissez directement via `ANTHROPIC_MODEL`, `--model` ou les variables d'environnement `ANTHROPIC_DEFAULT_*_MODEL` sont transmises au fournisseur telles quelles et ne sont pas transformées par `modelOverrides`.626Les remplacements remplacent les ID de modèle intégrés qui soutiennent chaque entrée dans le sélecteur `/model`. Sur Bedrock, les remplacements prennent la priorité sur tous les profils d'inférence que Claude Code découvre automatiquement au démarrage. Les valeurs que vous fournissez directement via `ANTHROPIC_MODEL`, `--model` ou les variables d'environnement `ANTHROPIC_DEFAULT_*_MODEL` sont transmises au fournisseur telles quelles et ne sont pas transformées par `modelOverrides`.

574 627 

575`modelOverrides` fonctionne aux côtés de `availableModels`. La liste d'autorisation est évaluée par rapport à l'ID de modèle Anthropic, et non à la valeur de remplacement, donc une entrée comme `"opus"` dans `availableModels` continue de correspondre même lorsque les versions d'Opus sont mappées à des ARN.628`modelOverrides` fonctionne aux côtés de `availableModels`. La liste d'autorisation est évaluée par rapport à l'ID de modèle Anthropic, et non à la valeur de remplacement, donc une entrée comme `"opus"` dans `availableModels` continue de correspondre même lorsque les versions d'Opus sont mappées à des ARN. Lorsque `enforceAvailableModels` est défini dans les paramètres gérés, la valeur par défaut appliquée se résout via `modelOverrides` à partir de la [source gérée de plus haute priorité](/fr/server-managed-settings#settings-precedence) uniquement. Le mappage d'un administrateur, tel qu'une version épinglée à un ARN de profil d'inférence, est honoré dans la valeur par défaut appliquée. Les remplacements des paramètres utilisateur ou projet ne l'affectent pas.

576 629 

577<h3 id="prompt-caching-configuration">630<h3 id="prompt-caching-configuration">

578 Configuration de la mise en cache des invites631 Configuration de la mise en cache des invites

Details

1164 1164 

1165Claude Code réessaie les demandes d'API échouées en interne et n'émet un seul événement `claude_code.api_error` qu'après avoir abandonné, donc l'événement lui-même est le signal terminal pour cette demande. Les tentatives de nouvelle tentative intermédiaires ne sont pas enregistrées comme des événements séparés.1165Claude Code réessaie les demandes d'API échouées en interne et n'émet un seul événement `claude_code.api_error` qu'après avoir abandonné, donc l'événement lui-même est le signal terminal pour cette demande. Les tentatives de nouvelle tentative intermédiaires ne sont pas enregistrées comme des événements séparés.

1166 1166 

1167L'attribut `attempt` sur l'événement enregistre le nombre total de tentatives effectuées. Une valeur supérieure à `CLAUDE_CODE_MAX_RETRIES` (par défaut `10`, plafonné à `15`) indique que la demande a épuisé toutes les tentatives sur une erreur transitoire. Une valeur inférieure indique une erreur non réessayable telle qu'une réponse `400`.1167L'attribut `attempt` sur l'événement enregistre le nombre total de tentatives effectuées. `CLAUDE_CODE_MAX_RETRIES` est par défaut `10` et plafonné à `15`. Lorsque la demande épuise toutes les tentatives sur une erreur transitoire, `attempt` est égal à un de plus que cette limite effective : 11 par défaut, et jamais plus de 16. Une valeur inférieure indique une erreur non réessayable telle qu'une réponse `400`.

1168 1168 

1169Pour distinguer une session qui s'est rétablie d'une qui s'est bloquée, groupez les événements par `session.id` et vérifiez si un événement `api_request` ultérieur existe après l'erreur.1169Pour distinguer une session qui s'est rétablie d'une qui s'est bloquée, groupez les événements par `session.id` et vérifiez si un événement `api_request` ultérieur existe après l'erreur.

1170 1170 

Details

169```169```

170 170 

171<h2 id="eliminate-prompts-with-auto-mode">171<h2 id="eliminate-prompts-with-auto-mode">

172 Éliminer les invites avec le mode auto172 Éliminer les invites de permission avec le mode auto

173</h2>173</h2>

174 174 

175<Note>175<Note>


181Le mode auto instruit également Claude à continuer à travailler sans s'arrêter pour des questions de clarification, bien que Claude pose toujours des questions quand votre invite ou une compétence s'y appuie explicitement. Pour un comportement autonome plus fort tout en conservant les invites de permission, définissez plutôt le [style de sortie proactif](/fr/output-styles).181Le mode auto instruit également Claude à continuer à travailler sans s'arrêter pour des questions de clarification, bien que Claude pose toujours des questions quand votre invite ou une compétence s'y appuie explicitement. Pour un comportement autonome plus fort tout en conservant les invites de permission, définissez plutôt le [style de sortie proactif](/fr/output-styles).

182 182 

183<Warning>183<Warning>

184 Le mode auto est un aperçu de recherche. Il réduit les invites mais ne garantit pas la sécurité. Utilisez-le pour les tâches où vous faites confiance à la direction générale, pas comme remplacement de l'examen sur les opérations sensibles.184 Le mode auto est un aperçu de recherche. Il réduit les invites de permission mais ne garantit pas la sécurité. Utilisez-le pour les tâches où vous faites confiance à la direction générale, pas comme remplacement de l'examen sur les opérations sensibles.

185</Warning>185</Warning>

186 186 

187Le mode auto n'est disponible que quand votre compte répond à toutes ces exigences :187Le mode auto n'est disponible que quand votre compte répond à toutes ces exigences :

sandboxing.md +33 −3

Details

202 202 

203Le `.` dans `allowRead` se résout à la racine du projet car cette configuration se trouve dans les paramètres du projet. Si vous aviez placé la même configuration dans `~/.claude/settings.json`, `.` se résoudrait à `~/.claude` à la place, et les fichiers du projet resteraient bloqués par la règle `denyRead`.203Le `.` dans `allowRead` se résout à la racine du projet car cette configuration se trouve dans les paramètres du projet. Si vous aviez placé la même configuration dans `~/.claude/settings.json`, `.` se résoudrait à `~/.claude` à la place, et les fichiers du projet resteraient bloqués par la règle `denyRead`.

204 204 

205<h3 id="protect-credentials">

206 Protéger les identifiants

207</h3>

208 

209Le paramètre `sandbox.credentials` déclare les fichiers d'identifiants et les variables d'environnement auxquels les commandes sandboxées ne doivent pas accéder. Les chemins de fichiers listés sont refusés pour les lectures à l'intérieur du sandbox, le même bloc que celui appliqué par `filesystem.denyRead`, et les variables d'environnement listées sont supprimées avant chaque exécution de commande sandboxée. Le bloc `credentials` dédié maintient les règles d'identifiants groupées avec la suppression de variable d'environnement et séparées des règles générales du système de fichiers. Nécessite Claude Code v2.1.187 ou ultérieur.

210 

211L'exemple ci-dessous bloque les lectures du fichier d'identifiants AWS et du répertoire SSH et supprime `GITHUB_TOKEN` et `NPM_TOKEN` de l'environnement des commandes sandboxées :

212 

213```json theme={null}

214{

215 "sandbox": {

216 "enabled": true,

217 "credentials": {

218 "files": [

219 { "path": "~/.aws/credentials", "mode": "deny" },

220 { "path": "~/.ssh", "mode": "deny" }

221 ],

222 "envVars": [

223 { "name": "GITHUB_TOKEN", "mode": "deny" },

224 { "name": "NPM_TOKEN", "mode": "deny" }

225 ]

226 }

227 }

228}

229```

230 

231Chaque entrée porte `"mode": "deny"`, qui est la seule valeur prise en charge. Le champ `mode` explicite maintient le schéma compatible avec les modes futurs. Les chemins de fichiers suivent les mêmes [règles de préfixe](/fr/settings#sandbox-path-prefixes) que les paramètres `sandbox.filesystem.*`, et les entrées de chaque [portée de paramètres](/fr/settings#settings-precedence) sont fusionnées. Comme le seul mode est `deny`, n'importe quelle portée peut ajouter des restrictions mais aucune ne peut les supprimer.

232 

233Il n'y a pas de liste de refus d'identifiants intégrée, donc seuls les fichiers et les variables que vous listez sont restreints. Le paramètre affecte uniquement les commandes Bash sandboxées. Pour supprimer les identifiants Anthropic et des fournisseurs de cloud de tous les sous-processus indépendamment du sandboxing, définissez [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/fr/env-vars).

234 

205<h2 id="how-sandboxing-works">235<h2 id="how-sandboxing-works">

206 Comment fonctionne le sandboxing236 Comment fonctionne le sandboxing

207</h2>237</h2>


213L'outil Bash en sandbox restreint l'accès au système de fichiers à des répertoires spécifiques :243L'outil Bash en sandbox restreint l'accès au système de fichiers à des répertoires spécifiques :

214 244 

215* **Comportement d'écriture par défaut** : accès en lecture et écriture au répertoire de travail actuel et à ses sous-répertoires, plus le répertoire temporaire de session vers lequel `$TMPDIR` pointe245* **Comportement d'écriture par défaut** : accès en lecture et écriture au répertoire de travail actuel et à ses sous-répertoires, plus le répertoire temporaire de session vers lequel `$TMPDIR` pointe

216* **Comportement de lecture par défaut** : accès en lecture à l'ensemble de l'ordinateur, sauf certains répertoires refusés. Notez que ce comportement par défaut permet toujours de lire les fichiers d'identifiants tels que `~/.aws/credentials` et `~/.ssh/`. Ajoutez-les à `denyRead` pour les bloquer.246* **Comportement de lecture par défaut** : accès en lecture à l'ensemble de l'ordinateur, sauf certains répertoires refusés. Notez que ce comportement par défaut permet toujours de lire les fichiers d'identifiants tels que `~/.aws/credentials` et `~/.ssh/`. Utilisez [`sandbox.credentials`](#protect-credentials) pour bloquer les lectures de ces fichiers et désactiver les variables d'environnement secrètes, ou ajoutez les chemins à `denyRead`.

217* **Accès bloqué** : impossible de modifier les fichiers en dehors du répertoire de travail actuel et du répertoire temporaire de session sans permission explicite, y compris les fichiers de configuration shell tels que `~/.bashrc` et les binaires système dans `/bin/`247* **Accès bloqué** : impossible de modifier les fichiers en dehors du répertoire de travail actuel et du répertoire temporaire de session sans permission explicite, y compris les fichiers de configuration shell tels que `~/.bashrc` et les binaires système dans `/bin/`

218* **Git worktrees** : lorsque le répertoire de travail est un [linked git worktree](/fr/worktrees), le sandbox permet également les écritures dans le répertoire `.git` partagé du référentiel principal afin que les commandes telles que `git commit` puissent mettre à jour les références et l'index. Les écritures dans `hooks/` et `config` à l'intérieur de ce répertoire restent refusées.248* **Git worktrees** : lorsque le répertoire de travail est un [linked git worktree](/fr/worktrees), le sandbox permet également les écritures dans le répertoire `.git` partagé du référentiel principal afin que les commandes telles que `git commit` puissent mettre à jour les références et l'index. Les écritures dans `hooks/` et `config` à l'intérieur de ce répertoire restent refusées.

219* **Configurable** : définissez des chemins autorisés et refusés personnalisés via les paramètres249* **Configurable** : définissez des chemins autorisés et refusés personnalisés via les paramètres


326* **`failIfUnavailable`** : une dépendance manquante telle que bubblewrap sur Linux empêche Claude Code de démarrer plutôt que d'afficher un avertissement et de revenir à une exécution non sandboxée356* **`failIfUnavailable`** : une dépendance manquante telle que bubblewrap sur Linux empêche Claude Code de démarrer plutôt que d'afficher un avertissement et de revenir à une exécution non sandboxée

327* **`allowUnsandboxedCommands: false`** : la trappe d'échappement `dangerouslyDisableSandbox` est ignorée, les commandes qui échouent sous le sandbox ne peuvent donc pas être réessayées en dehors de celui-ci357* **`allowUnsandboxedCommands: false`** : la trappe d'échappement `dangerouslyDisableSandbox` est ignorée, les commandes qui échouent sous le sandbox ne peuvent donc pas être réessayées en dehors de celui-ci

328 358 

329Deux ajouts valent la peine d'être envisagés aux côtés d'eux. Ajoutez `excludedCommands` pour tous les outils approuvés par l'organisation qui doivent s'exécuter sans isolation. Ajoutez des entrées [`denyRead`](#filesystem-isolation) pour les répertoires d'identifiants tels que `~/.aws` et `~/.ssh`, que la politique de lecture par défaut autorise toujours.359Deux ajouts valent la peine d'être envisagés aux côtés d'eux. Ajoutez `excludedCommands` pour tous les outils approuvés par l'organisation qui doivent s'exécuter sans isolation. Ajoutez des entrées [`sandbox.credentials`](#protect-credentials) pour les répertoires d'identifiants tels que `~/.aws` et `~/.ssh` et pour les variables d'environnement secrètes, car la politique de lecture par défaut les autorise toujours.

330 360 

331Le sandbox ne s'exécute pas sur Windows natif, donc si votre flotte inclut des hôtes Windows, limitez cette configuration à macOS et Linux ou demandez à ces utilisateurs d'exécuter Claude Code à l'intérieur de WSL2 ou d'un conteneur.361Le sandbox ne s'exécute pas sur Windows natif, donc si votre flotte inclut des hôtes Windows, limitez cette configuration à macOS et Linux ou demandez à ces utilisateurs d'exécuter Claude Code à l'intérieur de WSL2 ou d'un conteneur.

332 362 


417 447 

418* **Outils de fichiers intégrés** : Read, Edit et Write utilisent le système de permissions directement plutôt que de s'exécuter via le sandbox. Consultez [permissions](/fr/permissions).448* **Outils de fichiers intégrés** : Read, Edit et Write utilisent le système de permissions directement plutôt que de s'exécuter via le sandbox. Consultez [permissions](/fr/permissions).

419* **Utilisation de l'ordinateur** : lorsque Claude ouvre des applications et contrôle votre écran, il s'exécute sur votre bureau réel plutôt que dans un environnement isolé. Les invites de permission par application contrôlent chaque application. Consultez [utilisation de l'ordinateur dans la CLI](/fr/computer-use) ou [utilisation de l'ordinateur dans Desktop](/fr/desktop#let-claude-use-your-computer).449* **Utilisation de l'ordinateur** : lorsque Claude ouvre des applications et contrôle votre écran, il s'exécute sur votre bureau réel plutôt que dans un environnement isolé. Les invites de permission par application contrôlent chaque application. Consultez [utilisation de l'ordinateur dans la CLI](/fr/computer-use) ou [utilisation de l'ordinateur dans Desktop](/fr/desktop#let-claude-use-your-computer).

420* **Variables d'environnement** : les commandes Bash sandboxées héritent de l'environnement du processus parent par défaut, y compris les identifiants définis là-bas. Pour supprimer les identifiants Anthropic et du fournisseur cloud des sous-processus, définissez [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/fr/env-vars).450* **Variables d'environnement** : les commandes Bash sandboxées héritent de l'environnement du processus parent par défaut, y compris les identifiants définis là-bas. Utilisez [`sandbox.credentials`](#protect-credentials) pour supprimer les variables spécifiques pour les commandes sandboxées, ou définissez [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/fr/env-vars) pour supprimer les identifiants Anthropic et du fournisseur cloud de tous les sous-processus.

421* **Sous-agents** : les [sous-agents](/fr/sub-agents) s'exécutent dans le même processus que la session parent et utilisent la même configuration de sandbox. Les commandes Bash à l'intérieur d'un sous-agent sont sandboxées lorsque le sandboxing est activé dans la session parent.451* **Sous-agents** : les [sous-agents](/fr/sub-agents) s'exécutent dans le même processus que la session parent et utilisent la même configuration de sandbox. Les commandes Bash à l'intérieur d'un sous-agent sont sandboxées lorsque le sandboxing est activé dans la session parent.

422 452 

423<Warning>453<Warning>

Details

6 6 

7> Configurez centralement Claude Code pour votre organisation via des paramètres livrés par le serveur, sans nécessiter d'infrastructure de gestion des appareils.7> Configurez centralement Claude Code pour votre organisation via des paramètres livrés par le serveur, sans nécessiter d'infrastructure de gestion des appareils.

8 8 

9Les paramètres gérés par le serveur permettent aux administrateurs de configurer centralement Claude Code via une interface web sur Claude.ai. Les clients Claude Code reçoivent automatiquement ces paramètres lorsque les utilisateurs s'authentifient avec leurs identifiants d'organisation.9Les paramètres gérés par le serveur permettent aux administrateurs de configurer centralement Claude Code via une interface web sur Claude.ai. Les clients Claude Code reçoivent automatiquement ces paramètres lorsque les utilisateurs s'authentifient avec une connexion OAuth d'organisation ou une clé API directement configurée, sur les plateformes où la livraison gérée par le serveur est prise en charge. Voir [Disponibilité des plateformes](#platform-availability).

10 10 

11Cette approche est conçue pour les organisations qui n'ont pas d'infrastructure de gestion des appareils en place, ou qui ont besoin de gérer les paramètres pour les utilisateurs sur des appareils non gérés.11Cette approche est conçue pour les organisations qui n'ont pas d'infrastructure de gestion des appareils en place, ou qui ont besoin de gérer les paramètres pour les utilisateurs sur des appareils non gérés.

12 12 


35| **Paramètres gérés par le serveur** | Organisations sans MDM, ou utilisateurs sur des appareils non gérés | Paramètres livrés à partir des serveurs d'Anthropic au moment de l'authentification |35| **Paramètres gérés par le serveur** | Organisations sans MDM, ou utilisateurs sur des appareils non gérés | Paramètres livrés à partir des serveurs d'Anthropic au moment de l'authentification |

36| **[Paramètres gérés par le point de terminaison](/fr/settings#settings-files)** | Organisations avec MDM ou gestion des points de terminaison | Paramètres déployés sur les appareils via des profils de configuration MDM, des stratégies de registre ou des fichiers de paramètres gérés |36| **[Paramètres gérés par le point de terminaison](/fr/settings#settings-files)** | Organisations avec MDM ou gestion des points de terminaison | Paramètres déployés sur les appareils via des profils de configuration MDM, des stratégies de registre ou des fichiers de paramètres gérés |

37 37 

38Si vos appareils sont inscrits dans une solution MDM ou de gestion des points de terminaison, les paramètres gérés par le point de terminaison offrent des garanties de sécurité plus fortes car le fichier de paramètres peut être protégé contre les modifications de l'utilisateur au niveau du système d'exploitation.38Si vos appareils sont inscrits dans une solution MDM ou de gestion des points de terminaison, les paramètres gérés par le point de terminaison offrent des garanties de sécurité plus fortes car le fichier de paramètres peut être protégé contre les modifications de l'utilisateur au niveau du système d'exploitation. Les paramètres gérés par le point de terminaison n'atteignent pas les [sessions cloud](/fr/model-config#surface-coverage), donc les organisations utilisant Claude Code sur le web doivent également configurer les paramètres gérés par le serveur.

39 39 

40<h2 id="configure-server-managed-settings">40<h2 id="configure-server-managed-settings">

41 Configurer les paramètres gérés par le serveur41 Configurer les paramètres gérés par le serveur


228 Disponibilité de la plateforme228 Disponibilité de la plateforme

229</h2>229</h2>

230 230 

231Les paramètres gérés par le serveur nécessitent une connexion directe à `api.anthropic.com` et ne sont pas disponibles lors de l'utilisation de fournisseurs de modèles tiers :231Les paramètres gérés par le serveur nécessitent une connexion directe à `api.anthropic.com`, et la livraison nécessite que la session s'authentifie avec une connexion OAuth d'organisation ou une clé API directement configurée : les clés renvoyées par un script [`apiKeyHelper`](/fr/settings#available-settings) ne déclenchent pas la récupération des paramètres. Les paramètres gérés par le serveur ne sont pas disponibles lors de l'utilisation de fournisseurs de modèles tiers :

232 232 

233* Amazon Bedrock233* Amazon Bedrock

234* Google Vertex AI234* Google Vertex AI

235* Microsoft Foundry235* Microsoft Foundry

236* [Claude Platform on AWS](/fr/claude-platform-on-aws)

236* Points de terminaison API personnalisés via `ANTHROPIC_BASE_URL` ou [passerelles LLM](/fr/llm-gateway)237* Points de terminaison API personnalisés via `ANTHROPIC_BASE_URL` ou [passerelles LLM](/fr/llm-gateway)

237 238 

238<h2 id="audit-logging">239<h2 id="audit-logging">


255| L'utilisateur supprime le fichier de paramètres en cache | Le comportement du premier lancement se produit : les paramètres sont récupérés de manière asynchrone avec une brève fenêtre non appliquée |256| L'utilisateur supprime le fichier de paramètres en cache | Le comportement du premier lancement se produit : les paramètres sont récupérés de manière asynchrone avec une brève fenêtre non appliquée |

256| L'API est indisponible | Les paramètres en cache s'appliquent s'ils sont disponibles, sinon les paramètres gérés ne sont pas appliqués jusqu'à la prochaine récupération réussie. Avec `forceRemoteSettingsRefresh: true`, l'interface de ligne de commande se ferme au lieu de continuer, sauf pour les [sous-commandes `claude auth`](#enforce-fail-closed-startup) |257| L'API est indisponible | Les paramètres en cache s'appliquent s'ils sont disponibles, sinon les paramètres gérés ne sont pas appliqués jusqu'à la prochaine récupération réussie. Avec `forceRemoteSettingsRefresh: true`, l'interface de ligne de commande se ferme au lieu de continuer, sauf pour les [sous-commandes `claude auth`](#enforce-fail-closed-startup) |

257| L'utilisateur s'authentifie avec une organisation différente | Les paramètres ne sont pas livrés pour les comptes en dehors de l'organisation gérée |258| L'utilisateur s'authentifie avec une organisation différente | Les paramètres ne sont pas livrés pour les comptes en dehors de l'organisation gérée |

258| L'utilisateur configure un [fournisseur de modèle tiers](#platform-availability) | Les paramètres gérés par le serveur sont contournés. Cela inclut la définition de `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, ou un `ANTHROPIC_BASE_URL` non défini par défaut |259| L'utilisateur configure un [fournisseur de modèle tiers](#platform-availability) | Les paramètres gérés par le serveur sont contournés. Cela inclut la définition de `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS`, ou un `ANTHROPIC_BASE_URL` non défini par défaut |

259 260 

260Pour détecter les modifications de configuration au moment de l'exécution, utilisez les [hooks `ConfigChange`](/fr/hooks#configchange) pour enregistrer les modifications ou bloquer les modifications non autorisées avant qu'elles ne prennent effet.261Pour détecter les modifications de configuration au moment de l'exécution, utilisez les [hooks `ConfigChange`](/fr/hooks#configchange) pour enregistrer les modifications ou bloquer les modifications non autorisées avant qu'elles ne prennent effet.

261 262 

skills.md +2 −2

Details

245Tous les champs sont optionnels. Seul `description` est recommandé pour que Claude sache quand utiliser la skill.245Tous les champs sont optionnels. Seul `description` est recommandé pour que Claude sache quand utiliser la skill.

246 246 

247| Champ | Obligatoire | Description |247| Champ | Obligatoire | Description |

248| :------------------------- | :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |248| :------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

249| `name` | Non | Nom d'affichage montré dans les listes de skills. S'il est omis, utilise le nom du répertoire. Voir [Comment une skill obtient son nom de commande](#how-a-skill-gets-its-command-name) pour comprendre comment cela diffère du nom que vous tapez pour invoquer la skill. |249| `name` | Non | Nom d'affichage montré dans les listes de skills. S'il est omis, utilise le nom du répertoire. Voir [Comment une skill obtient son nom de commande](#how-a-skill-gets-its-command-name) pour comprendre comment cela diffère du nom que vous tapez pour invoquer la skill. |

250| `description` | Recommandé | Ce que fait la skill et quand l'utiliser. Claude utilise ceci pour décider quand appliquer la skill. S'il est omis, utilise le premier paragraphe du contenu markdown. Mettez en avant le cas d'utilisation clé : le texte combiné `description` et `when_to_use` est tronqué à 1 536 caractères dans la liste des skills pour réduire l'utilisation du contexte. |250| `description` | Recommandé | Ce que fait la skill et quand l'utiliser. Claude utilise ceci pour décider quand appliquer la skill. S'il est omis, utilise le premier paragraphe du contenu markdown. Mettez en avant le cas d'utilisation clé : le texte combiné `description` et `when_to_use` est tronqué à 1 536 caractères dans la liste des skills pour réduire l'utilisation du contexte. |

251| `when_to_use` | Non | Contexte supplémentaire pour quand Claude devrait invoquer la skill, comme les phrases déclencheurs ou les demandes d'exemple. Ajouté à `description` dans la liste des skills et compte vers le plafond de 1 536 caractères. |251| `when_to_use` | Non | Contexte supplémentaire pour quand Claude devrait invoquer la skill, comme les phrases déclencheurs ou les demandes d'exemple. Ajouté à `description` dans la liste des skills et compte vers le plafond de 1 536 caractères. |


255| `user-invocable` | Non | Définissez à `false` pour masquer du menu `/`. Utilisez pour les connaissances de base que les utilisateurs ne devraient pas invoquer directement. Par défaut : `true`. |255| `user-invocable` | Non | Définissez à `false` pour masquer du menu `/`. Utilisez pour les connaissances de base que les utilisateurs ne devraient pas invoquer directement. Par défaut : `true`. |

256| `allowed-tools` | Non | Outils que Claude peut utiliser sans demander la permission quand cette skill est active. Accepte une chaîne séparée par des espaces ou une liste YAML. |256| `allowed-tools` | Non | Outils que Claude peut utiliser sans demander la permission quand cette skill est active. Accepte une chaîne séparée par des espaces ou une liste YAML. |

257| `disallowed-tools` | Non | Outils supprimés du pool d'outils disponibles de Claude tandis que cette skill est active. Utilisez pour les skills autonomes qui ne devraient jamais appeler certains outils, comme `AskUserQuestion` pour une boucle de fond. Accepte une chaîne séparée par des espaces ou une liste YAML. La restriction s'efface quand vous envoyez votre prochain message. |257| `disallowed-tools` | Non | Outils supprimés du pool d'outils disponibles de Claude tandis que cette skill est active. Utilisez pour les skills autonomes qui ne devraient jamais appeler certains outils, comme `AskUserQuestion` pour une boucle de fond. Accepte une chaîne séparée par des espaces ou une liste YAML. La restriction s'efface quand vous envoyez votre prochain message. |

258| `model` | Non | Modèle à utiliser quand cette skill est active. Le remplacement s'applique pour le reste du tour actuel et n'est pas sauvegardé dans les paramètres ; le modèle de session reprend à votre prochain prompt. Accepte les mêmes valeurs que [`/model`](/fr/model-config), ou `inherit` pour garder le modèle actif. |258| `model` | Non | Modèle à utiliser quand cette skill est active. Le remplacement s'applique pour le reste du tour actuel et n'est pas sauvegardé dans les paramètres ; le modèle de session reprend à votre prochain prompt. Accepte les mêmes valeurs que [`/model`](/fr/model-config), ou `inherit` pour garder le modèle actif. Une valeur exclue par la liste d'autorisation [`availableModels`](/fr/model-config#restrict-model-selection) de votre organisation n'est pas utilisée et la session garde son modèle actuel. |

259| `effort` | Non | [Niveau d'effort](/fr/model-config#adjust-effort-level) quand cette skill est active. Remplace le niveau d'effort de la session. Par défaut : hérite de la session. Options : `low`, `medium`, `high`, `xhigh`, `max` ; les niveaux disponibles dépendent du modèle. |259| `effort` | Non | [Niveau d'effort](/fr/model-config#adjust-effort-level) quand cette skill est active. Remplace le niveau d'effort de la session. Par défaut : hérite de la session. Options : `low`, `medium`, `high`, `xhigh`, `max` ; les niveaux disponibles dépendent du modèle. |

260| `context` | Non | Définissez à `fork` pour exécuter dans un contexte de subagent forké. |260| `context` | Non | Définissez à `fork` pour exécuter dans un contexte de subagent forké. |

261| `agent` | Non | Quel type de subagent utiliser quand `context: fork` est défini. |261| `agent` | Non | Quel type de subagent utiliser quand `context: fork` est défini. |

sub-agents.md +4 −0

Details

3173. Le frontmatter `model` de la définition du sous-agent3173. Le frontmatter `model` de la définition du sous-agent

3184. Le modèle de la conversation principale3184. Le modèle de la conversation principale

319 319 

320Les valeurs de la variable d'environnement, du paramètre par invocation et du frontmatter sont vérifiées par rapport à la liste blanche [`availableModels`](/fr/model-config#restrict-model-selection) de votre organisation. Une valeur qui se résout en un modèle exclu n'est pas utilisée et le sous-agent s'exécute sur le modèle hérité à la place.

321 

320<h3 id="control-subagent-capabilities">322<h3 id="control-subagent-capabilities">

321 Contrôler les capacités des sous-agents323 Contrôler les capacités des sous-agents

322</h3>324</h3>


849 851 

850La profondeur est comptée comme le nombre de niveaux de sous-agent en dessous de la conversation principale, indépendamment du fait que chaque niveau s'exécute en [premier plan ou en arrière-plan](#run-subagents-in-foreground-or-background). Un sous-agent à la profondeur cinq ne reçoit pas l'outil Agent et ne peut pas générer d'autres. La limite est fixe et non configurable.852La profondeur est comptée comme le nombre de niveaux de sous-agent en dessous de la conversation principale, indépendamment du fait que chaque niveau s'exécute en [premier plan ou en arrière-plan](#run-subagents-in-foreground-or-background). Un sous-agent à la profondeur cinq ne reçoit pas l'outil Agent et ne peut pas générer d'autres. La limite est fixe et non configurable.

851 853 

854À partir de Claude Code v2.1.187, la profondeur d'un sous-agent en arrière-plan est fixée lorsqu'il est d'abord généré, et [reprendre](#resume-subagents) celui-ci ultérieurement ne change pas cette profondeur. Par exemple, si votre conversation principale génère le sous-agent A, et A génère un sous-agent en arrière-plan B à la profondeur deux, B est toujours à la profondeur deux lorsque vous le reprenez directement à partir de la conversation principale. Reprendre un sous-agent à partir d'un contexte moins profond ne lui permet pas de générer des niveaux supplémentaires que la limite de profondeur a déjà empêchés.

855 

852Pour empêcher un sous-agent spécifique de générer d'autres, omettez `Agent` de sa liste [`tools`](#available-tools) ou ajoutez-le à `disallowedTools`.856Pour empêcher un sous-agent spécifique de générer d'autres, omettez `Agent` de sa liste [`tools`](#available-tools) ou ajoutez-le à `disallowedTools`.

853 857 

854Un [fork](#fork-the-current-conversation) ne peut toujours pas générer un autre fork. Il peut générer d'autres types de sous-agents, et ceux-ci comptent vers la limite de profondeur.858Un [fork](#fork-the-current-conversation) ne peut toujours pas générer un autre fork. Il peut générer d'autres types de sous-agents, et ceux-ci comptent vers la limite de profondeur.

Details

34 34 

35```35```

36/voice36/voice

37Voice mode enabled (hold). Hold Space to record. Dictation language: en (/config to change).37Voice mode enabled (hold). Hold space to record. Dictation language: en (/config to change).

38```38```

39 39 

40`/voice` accepte un argument de mode optionnel :40`/voice` accepte un argument de mode optionnel :


57}57}

58```58```

59 59 

60Lorsque la dictée vocale est activée, le pied de page d'entrée affiche un indice `hold Space to speak` lorsque l'invite est vide. L'indice reflète votre liaison `voice:pushToTalk` actuelle et se met à jour si vous [reliez la clé de dictée](#rebind-the-dictation-key). Le texte d'indice est le même dans les deux modes, et il n'apparaît pas si vous avez une [ligne d'état personnalisée](/fr/statusline) configurée.60Lorsque la dictée vocale est activée, le pied de page d'entrée affiche un indice `hold space to speak` lorsque l'invite est vide. L'indice reflète votre liaison `voice:pushToTalk` actuelle et se met à jour si vous [reliez la clé de dictée](#rebind-the-dictation-key). Le texte d'indice est le même dans les deux modes, et il n'apparaît pas si vous avez une [ligne d'état personnalisée](/fr/statusline) configurée.

61 61 

62La transcription est optimisée pour le vocabulaire de codage dans les deux modes. Les termes de développement courants comme `regex`, `OAuth`, `JSON` et `localhost` sont reconnus correctement, et le nom de votre projet actuel et le nom de la branche git sont ajoutés automatiquement comme indices de reconnaissance.62La transcription est optimisée pour le vocabulaire de codage dans les deux modes. Les termes de développement courants comme `regex`, `OAuth`, `JSON` et `localhost` sont reconnus correctement, et le nom de votre projet actuel et le nom de la branche git sont ajoutés automatiquement comme indices de reconnaissance.

63 63