Documentation — Spybara

admin-setup.md +5 −3

Details

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

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

81 81

82Si une session WSL démarre sur un appareil doté de la liste [`allowedWorkspaceFolders`](https://claude.com/docs/third-party/claude-desktop/configuration#allowedworkspacefolders) de Claude Desktop, une entrée `~` désigne le répertoire personnel à l'intérieur de la distribution.

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

83 85

84## Décider ce qu'il faut appliquer86## Décider ce qu'il faut appliquer

127 129

128### Comptes GitHub connectés130### Comptes GitHub connectés

129 131

130Sur les plans Team et Enterprise, la section GitHub de [**Paramètres de l'organisation > Fournisseurs Git**](https://claude.ai/admin-settings/source-control) répertorie les organisations GitHub et les comptes personnels liés à votre organisation Claude via la [Claude GitHub App](https://github.com/apps/claude). Claude Code, [Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) et Claude Security partagent cette liste. Ouvrir la page nécessite un rôle d'administrateur dans votre organisation Claude.132Sur les plans Team et Enterprise, la section GitHub de [**Paramètres de l'organisation > Fournisseurs Git**](https://claude.ai/admin-settings/source-control) répertorie les organisations GitHub et les comptes personnels liés à votre organisation Claude via la [Claude GitHub App](https://github.com/apps/claude). Claude Code, [Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) et Claude Security partagent cette liste. Ouvrir la page nécessite un [rôle Owner](https://code.claude.com/docs/fr/server-managed-settings.md#access-control) dans votre organisation Claude. Le rôle Admin ne peut pas l'ouvrir.

131 133

132Un administrateur ou un membre peut lier un compte :134Quelqu'un peut lier un compte depuis la page Fournisseurs Git ou en connectant GitHub à Claude :

133 135

134* **Connexion par un administrateur** : un administrateur clique sur **Connect** dans cette section, ou sur **Add organization** une fois un compte connecté, et installe la Claude GitHub App sur une organisation GitHub. Lier une organisation de cette manière nécessite une personne qui est à la fois propriétaire de l'organisation GitHub et administrateur de votre organisation Claude.136* **Connexion par un Owner** : un Owner clique sur **Connect** dans cette section, ou sur **Add organization** une fois un compte connecté, et installe la Claude GitHub App sur une organisation GitHub. Lier une organisation de cette manière nécessite un Owner de votre organisation Claude qui est également propriétaire de l'organisation GitHub.

135* **Connexion par un membre** : lorsqu'un membre connecte son compte GitHub à Claude, par exemple lors de la [configuration des sessions cloud](https://code.claude.com/docs/fr/web-quickstart.md#connect-github), Claude lie les comptes GitHub dont ce membre est propriétaire et sur lesquels la Claude GitHub App est déjà installée. Cela peut inclure son compte personnel et les organisations GitHub dont il est propriétaire.137* **Connexion par un membre** : lorsqu'un membre connecte son compte GitHub à Claude, par exemple lors de la [configuration des sessions cloud](https://code.claude.com/docs/fr/web-quickstart.md#connect-github), Claude lie les comptes GitHub dont ce membre est propriétaire et sur lesquels la Claude GitHub App est déjà installée. Cela peut inclure son compte personnel et les organisations GitHub dont il est propriétaire.

136 138

137Une ligne marquée **Not linked** provient de votre propre connexion GitHub. Il s'agit d'un compte que vous pouvez voir sur GitHub et sur lequel la Claude GitHub App est installée.139Une ligne marquée **Not linked** provient de votre propre connexion GitHub. Il s'agit d'un compte que vous pouvez voir sur GitHub et sur lequel la Claude GitHub App est installée.

agent-sdk/agent-loop.md +1 −1

Details

222>222>

223> `effort` échange la latence et le coût des tokens pour la profondeur du raisonnement dans chaque réponse. [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) est une fonctionnalité distincte qui produit des blocs `thinking` dans la sortie, et le champ `display` sur `ThinkingConfig` pour [Python](https://code.claude.com/docs/fr/agent-sdk/python.md#thinkingconfig) ou [TypeScript](https://code.claude.com/docs/fr/agent-sdk/typescript.md#thinkingconfig) contrôle si vous recevez leur texte. Ils sont indépendants : vous pouvez définir `effort: "low"` avec extended thinking activé, ou `effort: "max"` sans lui.223> `effort` échange la latence et le coût des tokens pour la profondeur du raisonnement dans chaque réponse. [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) est une fonctionnalité distincte qui produit des blocs `thinking` dans la sortie, et le champ `display` sur `ThinkingConfig` pour [Python](https://code.claude.com/docs/fr/agent-sdk/python.md#thinkingconfig) ou [TypeScript](https://code.claude.com/docs/fr/agent-sdk/typescript.md#thinkingconfig) contrôle si vous recevez leur texte. Ils sont indépendants : vous pouvez définir `effort: "low"` avec extended thinking activé, ou `effort: "max"` sans lui.

224 224

225Utilisez un effort inférieur pour les agents effectuant des tâches simples et bien délimitées (comme lister des fichiers ou exécuter un seul grep) pour réduire le coût et la latence. Définissez `effort` dans les options de niveau supérieur `query()` pour la session entière, ou par sous-agent avec le champ `effort` sur [`AgentDefinition`](https://code.claude.com/docs/fr/agent-sdk/subagents#agentdefinition-configuration) pour remplacer le niveau de session.225Utilisez un effort inférieur pour les agents effectuant des tâches simples et bien délimitées, comme lister des fichiers ou exécuter un seul grep, pour réduire le coût et la latence. Définissez `effort` dans les options de niveau supérieur `query()` pour la [session](https://code.claude.com/docs/fr/sub-agents.md#choose-an-effort-level), ou par sous-agent avec le champ `effort` sur [`AgentDefinition`](https://code.claude.com/docs/fr/agent-sdk/subagents#agentdefinition-configuration) pour remplacer le niveau de session.

226 226

227### Mode de permission227### Mode de permission

228 228

agent-sdk/hooks.md +49 −1

Details

224| `matcher` | `string` | `undefined` | Motif mis en correspondance avec le champ de filtre de l'événement, en suivant les [règles pour les matchers dans les fichiers de paramètres](https://code.claude.com/docs/fr/hooks.md#matcher-patterns). Pour les hooks d'outils, ce champ est le nom de l'outil. Les outils intégrés incluent `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` et d'autres. Consultez [Types d'entrée d'outil](https://code.claude.com/docs/fr/agent-sdk/typescript.md#tool-input-types) pour la liste complète. Les outils MCP utilisent le motif `mcp__<server>__<action>`, où `<server>` est la clé que vous utilisez dans la configuration `mcpServers`, orthographiée comme le décrit la [convention de nommage des outils](https://code.claude.com/docs/fr/agent-sdk/mcp.md#tool-naming-convention). |224| `matcher` | `string` | `undefined` | Motif mis en correspondance avec le champ de filtre de l'événement, en suivant les [règles pour les matchers dans les fichiers de paramètres](https://code.claude.com/docs/fr/hooks.md#matcher-patterns). Pour les hooks d'outils, ce champ est le nom de l'outil. Les outils intégrés incluent `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` et d'autres. Consultez [Types d'entrée d'outil](https://code.claude.com/docs/fr/agent-sdk/typescript.md#tool-input-types) pour la liste complète. Les outils MCP utilisent le motif `mcp__<server>__<action>`, où `<server>` est la clé que vous utilisez dans la configuration `mcpServers`, orthographiée comme le décrit la [convention de nommage des outils](https://code.claude.com/docs/fr/agent-sdk/mcp.md#tool-naming-convention). |

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

227 228

228Utilisez le motif `matcher` pour cibler des outils spécifiques chaque fois que possible. Un matcher avec `'Bash'` s'exécute uniquement pour les commandes Bash, tandis que l'omission du motif exécute vos rappels pour chaque occurrence de l'événement.229Utilisez le motif `matcher` pour cibler des outils spécifiques chaque fois que possible. Un matcher avec `'Bash'` s'exécute uniquement pour les commandes Bash, tandis que l'omission du motif exécute vos rappels pour chaque occurrence de l'événement.

229 230

283>284>

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

285 286

287### Bloquer l'action lorsqu'un rappel échoue

288

289Sur la plupart des événements, si un rappel lève une exception ou retourne une sortie qui échoue à la validation, l'action se poursuit et votre application reçoit un avertissement [`SDKInformationalMessage`](https://code.claude.com/docs/fr/agent-sdk/typescript#sdkinformationalmessage) dont le `tag` est `hook_callback_failed`. Un garde-fou `PreToolUse` qui plante laisse alors l'appel d'outil atteindre le flux de permission normal. Un rappel qui ne retourne rien, comme un chemin sans `return`, compte également comme un échec. En Python, lisez `tag` depuis `SystemMessage.data`.

290

291Pour bloquer l'action à la place, définissez `onFailure: "block"` en TypeScript ou `on_failure="block"` en Python sur le matcher. Nécessite le SDK Agent TypeScript v0.3.317 ou ultérieur, ou le SDK Agent Python v0.2.177 ou ultérieur. Cet exemple bloque un appel Bash lorsque `check_policy` en Python ou `checkPolicy` en TypeScript échoue :

292

293```python Python theme={null}

294options = ClaudeAgentOptions(

295 hooks={

296 "PreToolUse": [

297 HookMatcher(matcher="Bash", hooks=[check_policy], on_failure="block")

298 ]

299 }

300)

301```

302

303```typescript TypeScript theme={null}

304import type { Options } from "@anthropic-ai/claude-agent-sdk";

305

306const options: Options = {

307 hooks: {

308 PreToolUse: [{ matcher: "Bash", hooks: [checkPolicy], onFailure: "block" }]

309 }

310};

311```

312

313Pour le tester, faites lever une erreur au rappel et demandez à Claude d'exécuter une commande Bash. Le résultat de l'outil inclut `failed; blocking because onFailure is "block"`, et Claude ne voit pas le texte de votre erreur.

314

315Retournez `{}` lorsque le rappel n'a pas d'avis. Avec `"block"` défini, un chemin sans `return` bloque l'action. Un rappel qui intercepte sa propre erreur et retourne `{}` n'est pas en échec : laissez donc l'erreur se propager depuis un garde-fou.

316

317#### Événements au comportement différent

318

319Ces événements ne bloquent pas toujours lorsque `"block"` est défini :

320

321* **`Stop`, `SubagentStop`, `TaskCompleted` et `TeammateIdle`** : ces événements ignorent l'option, donc l'action se poursuit.

322* **`PermissionRequest`** : le blocage n'est pris en compte que s'il arrive avant que votre rappel `canUseTool` ne réponde.

323* **`PostToolUse`** : l'outil s'est déjà exécuté, donc Claude reçoit l'échec comme retour.

324

325Un rappel qui dépasse son délai d'expiration suit [Délai d'expiration du hook](#hook-timeout). Avec `"block"` défini, un délai d'expiration bloque également `PreCompact`, `Elicitation` et `WorktreeCreate`.

326

327#### Erreurs de démarrage pour `onFailure`

328

329Avec `"block"` défini, la requête échoue au démarrage et n'envoie aucun prompt lorsqu'elle ne peut pas respecter l'option :

330

331* **Claude Code ne prend pas en charge l'option** : l'erreur inclut `does not honor`. Mettez à jour Claude Code ou supprimez l'option.

332* **La session était déjà en cours d'exécution et n'a pas enregistré vos hooks** : l'erreur inclut `did not register your hooks`. Démarrez une nouvelle session.

333

286## Exemples334## Exemples

287 335

288Plusieurs exemples dans cette section montrent uniquement la fonction de rappel. Pour en exécuter un, enregistrez le rappel sous l'événement correspondant dans le champ `hooks` de vos options, comme indiqué dans [Configurer les hooks](#configure-hooks).336Plusieurs exemples dans cette section montrent uniquement la fonction de rappel. Pour en exécuter un, enregistrez le rappel sous l'événement correspondant dans le champ `hooks` de vos options, comme indiqué dans [Configurer les hooks](#configure-hooks).

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

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

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

782* Autres événements, tels que `Notification`, `PreCompact` et `PostModelSwitch` : Claude Code consigne l'échec dans les logs et continue.830* Autres événements, tels que `Notification`, `PreCompact` et `PostModelSwitch` : Claude Code consigne l'échec dans les logs et continue. Avec [`onFailure: "block"`](#block-the-action-when-a-callback-fails), un délai d'expiration sur `PreCompact`, `Elicitation` ou `WorktreeCreate` bloque l'action.

783 831

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

785 833

agent-sdk/python.md +5 −0

Details

2161 None # Timeout in seconds. When omitted, the per-event default applies:2161 None # Timeout in seconds. When omitted, the per-event default applies:

2162 # 600 for most events, 30 for UserPromptSubmit2162 # 600 for most events, 30 for UserPromptSubmit

2163 )2163 )

2164 on_failure: Literal["continue", "block"] | None = (

2165 None # "block" blocks the action when a callback fails

2166 )

2164```2167```

2165 2168

2169Pour déterminer ce que couvre `on_failure`, voir [Bloquer l'action lorsqu'un callback échoue](https://code.claude.com/docs/fr/agent-sdk/hooks.md#block-the-action-when-a-callback-fails).

2170

2166### `HookInput`2171### `HookInput`

2167 2172

2168Type union de tous les types d'entrée de hook. Le type réel dépend du champ `hook_event_name`.2173Type union de tous les types d'entrée de hook. Le type réel dépend du champ `hook_event_name`.

agent-sdk/typescript.md +15 −11

Details

2184 tool_use_id?: string;2184 tool_use_id?: string;

2185 prevent_continuation?: boolean;2185 prevent_continuation?: boolean;

2186 tag?: string;

2186 uuid: UUID;2187 uuid: UUID;

2187 session_id: string;2188 session_id: string;

2188};2189};

2558 matcher?: string;2559 matcher?: string;

2559 hooks: HookCallback[];2560 hooks: HookCallback[];

2560 timeout?: number; // Délai d'expiration en secondes pour tous les hooks dans ce matcher2561 timeout?: number; // Délai d'expiration en secondes pour tous les hooks dans ce matcher

2562 onFailure?: "continue" | "block"; // « block » bloque l'action quand une fonction de rappel échoue

2561}2563}

2562```2564```

2563 2565

2566Pour déterminer ce que couvre `onFailure`, voir [Bloquer l'action quand une fonction de rappel échoue](https://code.claude.com/docs/fr/agent-sdk/hooks.md#block-the-action-when-a-callback-fails).

2567

2564### `HookInput`2568### `HookInput`

2565 2569

2566Type union de tous les types d'entrée de hook.2570Type union de tous les types d'entrée de hook.

3087 systemMessage?: string;3091 systemMessage?: string;

3088 /**3092 /**

3089 * Une séquence d'échappement de terminal (par exemple OSC 9 / OSC 777 desktop-notification)3093 * Une séquence d'échappement de terminal (par exemple OSC 9 / OSC 777 desktop-notification)

3090 * pour que Claude Code émette en votre nom. Seuls les OSCs de notification/titre3094 * que Claude Code émet en votre nom. Seuls les OSC de notification/titre

3091 * (0, 1, 2, 9, 99, 777) et BEL sont autorisés ; une valeur contenant3095 * (0, 1, 2, 9, 99, 777) et BEL sont autorisés ; une valeur contenant

3092 * autre chose est ignorée dans son ensemble. Seul l'interface CLI interactive l'émet ;3096 * autre chose est ignorée dans son ensemble. Seule la CLI interactive l'émet ;

3093 * le SDK ignore le champ.3097 * le SDK ignore le champ.

3094 */3098 */

3095 terminalSequence?: string;3099 terminalSequence?: string;

3106 hookEventName: "UserPromptSubmit";3110 hookEventName: "UserPromptSubmit";

3107 additionalContext?: string;3111 additionalContext?: string;

3108 sessionTitle?: string;3112 sessionTitle?: string;

3109 /** Quand la décision est « block », omettez l'invite originale du message de blocage. */3113 /** Quand la décision est « block », omet le prompt original du message de blocage. */

3110 suppressOriginalPrompt?: boolean;3114 suppressOriginalPrompt?: boolean;

3111 }3115 }

3112 | {3116 | {

3120 sessionTitle?: string;3124 sessionTitle?: string;

3121 watchPaths?: string[];3125 watchPaths?: string[];

3122 /**3126 /**

3123 * Rescannez les répertoires de compétences et de commandes après que les hooks SessionStart3127 * Rescanne les répertoires de skills et de commandes après que les hooks SessionStart

3124 * se terminent, afin que les compétences installées par le hook soient disponibles dans la3128 * se terminent, afin que les skills installés par le hook soient disponibles dans la

3125 * même session.3129 * même session.

3126 */3130 */

3127 reloadSkills?: boolean;3131 reloadSkills?: boolean;

3135 /**3139 /**

3136 * Même contrat que PreToolUse : « allow » procède, « deny » annule3140 * Même contrat que PreToolUse : « allow » procède, « deny » annule

3137 * le changement, « ask » demande à l'utilisateur de confirmer. Seul /model dans une3141 * le changement, « ask » demande à l'utilisateur de confirmer. Seul /model dans une

3138 * session interactive affiche cette invite ; chaque autre surface,3142 * session interactive affiche cette demande ; toute autre surface,

3139 * y compris les demandes set_model, traite « ask » comme un refus.3143 * y compris les requêtes set_model, traite « ask » comme un refus.

3140 */3144 */

3141 permissionDecision?: "allow" | "deny" | "ask";3145 permissionDecision?: "allow" | "deny" | "ask";

3142 permissionDecisionReason?: string;3146 permissionDecisionReason?: string;

3143 }3147 }

3144 | {3148 | {

3145 hookEventName: "PostModelSwitch";3149 hookEventName: "PostModelSwitch";

3146 /** Atteint le modèle avec la prochaine demande que le nouveau modèle traite. */3150 /** Atteint le modèle avec la prochaine requête que le nouveau modèle traite. */

3147 additionalContext?: string;3151 additionalContext?: string;

3148 }3152 }

3149 | {3153 | {

3154 hookEventName: "PostToolUse";3158 hookEventName: "PostToolUse";

3155 additionalContext?: string;3159 additionalContext?: string;

3156 /**3160 /**

3157 * Note courte sur le résultat de cet appel d'outil pour le classificateur de permissions3161 * Note courte sur le résultat de cet appel d'outil pour le classifieur de permissions

3158 * en mode automatique. Limité à 2000 caractères, partagé entre3162 * du mode auto. Limité à 2000 caractères, partagé entre

3159 * tous les hooks qui répondent au même appel ; honoré sur les réponses de hooks synchrones uniquement.3163 * tous les hooks qui répondent au même appel ; honoré sur les réponses de hooks synchrones uniquement.

3160 * Ne copiez pas la sortie d'outil non fiable dedans.3164 * Ne copiez pas la sortie d'outil non fiable dedans.

3161 */3165 */

3226 }3230 }

3227 | {3231 | {

3228 hookEventName: "MessageDisplay";3232 hookEventName: "MessageDisplay";

3229 /** Texte affiché à la place du delta. Omettez (ou retournez le delta inchangé) pour afficher l'original. */3233 /** Texte affiché à la place du delta. Omettez-le (ou retournez le delta inchangé) pour afficher l'original. */

3230 displayContent?: string;3234 displayContent?: string;

3231 };3235 };

3232};3236};

agent-teams.md +13 −5

Details

158* **Alias de famille tel que `opus`** : sur l'API Anthropic et Claude Platform on AWS, Claude Code exécute le coéquipier sur la version la plus récente de cette famille autorisée par la liste d'autorisation. Sur les fournisseurs utilisant des identifiants de modèle propres au fournisseur, où la [substitution ne fonctionne pas](https://code.claude.com/docs/fr/model-config.md#restrict-model-selection), un alias bloqué bascule comme toute autre valeur bloquée, selon le point suivant158* **Alias de famille tel que `opus`** : sur l'API Anthropic et Claude Platform on AWS, Claude Code exécute le coéquipier sur la version la plus récente de cette famille autorisée par la liste d'autorisation. Sur les fournisseurs utilisant des identifiants de modèle propres au fournisseur, où la [substitution ne fonctionne pas](https://code.claude.com/docs/fr/model-config.md#restrict-model-selection), un alias bloqué bascule comme toute autre valeur bloquée, selon le point suivant

159* **Toute autre valeur bloquée, y compris un alias de famille sur les fournisseurs où la substitution ne fonctionne pas, ou un alias dont la famille n'a aucune version autorisée** : Claude Code exécute plutôt le coéquipier sur le modèle du responsable. Si vous définissez `CLAUDE_CODE_SUBAGENT_MODEL`, Claude Code essaie d'abord ce modèle, selon ces mêmes règles159* **Toute autre valeur bloquée, y compris un alias de famille sur les fournisseurs où la substitution ne fonctionne pas, ou un alias dont la famille n'a aucune version autorisée** : Claude Code exécute plutôt le coéquipier sur le modèle du responsable. Si vous définissez `CLAUDE_CODE_SUBAGENT_MODEL`, Claude Code essaie d'abord ce modèle, selon ces mêmes règles

160 160

161Par défaut, les coéquipiers héritent du [niveau d'effort](https://code.claude.com/docs/fr/model-config.md#adjust-effort-level) du responsable. En mode volets divisés, cela s'applique à partir de la v2.1.186 ; les versions antérieures ne transmettaient pas le niveau d'effort de la session du responsable aux coéquipiers en volets divisés.161Par défaut, un coéquipier utilisant le modèle du responsable hérite du [niveau d'effort](https://code.claude.com/docs/fr/model-config.md#adjust-effort-level) du responsable. En mode volets divisés, cela s'applique à partir de la v2.1.186 ; les versions antérieures ne transmettaient pas le niveau d'effort de la session du responsable aux coéquipiers en volets divisés. Pour un coéquipier utilisant un autre modèle, consultez [Niveau d'effort des sous-agents et des coéquipiers](https://code.claude.com/docs/fr/model-config.md#effort-level-of-subagents-and-teammates).

162 162

163### Faire planifier les coéquipiers avant l'implémentation163### Faire planifier les coéquipiers avant l'implémentation

164 164

165Pour les tâches complexes ou risquées, vous pouvez demander aux coéquipiers de planifier avant d'implémenter. Un coéquipier que Claude lance pendant que le responsable est en [mode plan](https://code.claude.com/docs/fr/permission-modes.md#analyze-before-you-edit-with-plan-mode) travaille en mode plan en lecture seule jusqu'à ce que son plan soit prêt. Passez d'abord le responsable en mode plan, puis demandez le coéquipier :165Pour les tâches complexes ou risquées, vous pouvez demander aux coéquipiers de planifier avant d'implémenter. Un coéquipier que Claude lance pendant que le responsable est en [mode plan](https://code.claude.com/docs/fr/permission-modes.md#analyze-before-you-edit-with-plan-mode) travaille également en mode plan jusqu'à ce que son plan soit prêt. Passez d'abord le responsable en mode plan, puis demandez le coéquipier :

166 166

167```text wrap theme={null}167```text wrap theme={null}

168Spawn an architect teammate to refactor the authentication module.168Spawn an architect teammate to refactor the authentication module.

169```169```

170 170

171Lorsque ce coéquipier a terminé sa planification, il envoie une demande d'approbation du plan au responsable. Si vous n'avez pas modifié le mode de permission de ce coéquipier depuis son lancement, Claude Code approuve le plan dès l'arrivée de la demande, sans que le responsable l'examine. Les modifications et les commandes du coéquipier passent toujours par les demandes de permission décrites dans [Permissions](#permissions). Une fois le plan approuvé, le coéquipier quitte le mode plan et commence l'implémentation.171Lorsque ce coéquipier a terminé sa planification, il envoie une demande d'approbation du plan au responsable. Si vous n'avez pas modifié le mode de permission de ce coéquipier depuis son lancement, Claude Code approuve le plan dès l'arrivée de la demande, sans que le responsable l'examine. Une fois le plan approuvé, le coéquipier quitte le mode plan et commence l'implémentation. Claude Code lui transmet le [mode de permission](#permissions) actuel du responsable, ou Manual si celui-ci est le mode plan.

172 172

173Si vous placez un coéquipier in-process en cours d'exécution en mode plan en appuyant sur [`Shift+Tab`](https://code.claude.com/docs/fr/permission-modes#switch-permission-modes) pendant que vous consultez sa session, c'est le responsable qui examine le plan de cette exécution au lieu que Claude Code l'approuve. Il ne vous est pas demandé de l'approuver ; le responsable l'approuve ou le renvoie pour révision.173Si vous placez un coéquipier in-process en cours d'exécution en mode plan en appuyant sur [`Shift+Tab`](https://code.claude.com/docs/fr/permission-modes#switch-permission-modes) pendant que vous consultez sa session, c'est le responsable qui examine le plan de cette exécution au lieu que Claude Code l'approuve. Il ne vous est pas demandé de l'approuver ; le responsable l'approuve ou le renvoie pour révision.

174 174

288 288

289### Permissions289### Permissions

290 290

291Les coéquipiers commencent avec le mode de permission du chef, sauf le mode [`dontAsk`](https://code.claude.com/docs/fr/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), qu'ils n'héritent pas. Si le chef s'exécute avec `--dangerously-skip-permissions`, tous les coéquipiers le font aussi. Après la génération, vous pouvez modifier le mode de permission d'un coéquipier individuel, mais vous ne pouvez pas définir les modes de permission par coéquipier au moment de la génération.291Pour faire défiler le mode de permission d'un coéquipier en cours d'exécution, appuyez sur [`Shift+Tab`](https://code.claude.com/docs/fr/permission-modes#switch-permission-modes), bien qu'un coéquipier en processus puisse plutôt s'exécuter dans le mode du chef. Pour un coéquipier en volet divisé, appuyez sur ces touches dans son volet. Pour un coéquipier [en processus](#choose-a-display-mode), appuyez sur ces touches pendant que vous [consultez sa session](#talk-to-teammates-directly), et le coéquipier vérifie son mode lorsqu'il commence son prochain tour.

292

293> [!NOTE]

294>

295> Un coéquipier en processus qui n'est pas en [mode plan](#have-teammates-plan-before-implementing) s'exécute dans le mode du chef tant que le chef est en mode [`acceptEdits`](https://code.claude.com/docs/fr/permission-modes#auto-approve-file-edits-with-acceptedits-mode), [`auto`](https://code.claude.com/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) ou [`bypassPermissions`](https://code.claude.com/docs/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode). Passer le coéquipier en mode Manual n'y change rien, même si sa barre d'état affiche Manual.

296>

297> Pour qu'il demande avant de modifier des fichiers, appuyez sur Enter sur la ligne `main` dans le panneau des agents et passez également le chef en mode Manual. Le chef demande alors lui aussi, tout comme tout autre coéquipier en mode Manual.

298

299Vous ne pouvez pas définir les modes de permission par coéquipier au moment de la génération. Un nouveau coéquipier démarre avec le mode du chef, y compris le mode `bypassPermissions`, qu'active `--dangerously-skip-permissions`. Si le chef est en [mode `dontAsk`](https://code.claude.com/docs/fr/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), le coéquipier démarre plutôt en [mode Manual](https://code.claude.com/docs/fr/permission-modes.md#available-modes).

292 300

293Un coéquipier [en processus](#choose-a-display-mode) s'exécute sous les règles d'autorisation et de refus actives du chef, de sorte que [`--disallowedTools`](https://code.claude.com/docs/fr/cli-reference#cli-flags), `--tools` et `--allowedTools` s'appliquent tous à lui. Pour un coéquipier en volet divisé, vérifiez chaque flag :301Un coéquipier [en processus](#choose-a-display-mode) s'exécute sous les règles d'autorisation et de refus actives du chef, de sorte que [`--disallowedTools`](https://code.claude.com/docs/fr/cli-reference#cli-flags), `--tools` et `--allowedTools` s'appliquent tous à lui. Pour un coéquipier en volet divisé, vérifiez chaque flag :

294 302

488* **Pas d'équipes imbriquées** : les coéquipiers ne peuvent pas générer leurs propres coéquipiers. Seul le chef peut gérer l'équipe.496* **Pas d'équipes imbriquées** : les coéquipiers ne peuvent pas générer leurs propres coéquipiers. Seul le chef peut gérer l'équipe.

489* **Pas de sous-agents d'arrière-plan à partir de coéquipiers in-process** : les propres sous-agents d'un coéquipier in-process s'exécutent au premier plan, car le travail d'arrière-plan d'un coéquipier ne peut pas survivre au processus du chef. Claude Code retourne une erreur quand un coéquipier génère un sous-agent dont la définition définit `background: true`. Une demande `run_in_background: true` d'un coéquipier échoue également, soit avec une erreur, soit en s'exécutant silencieusement au premier plan. Les sous-agents lancés à partir de la conversation principale suivent la [valeur par défaut d'arrière-plan](https://code.claude.com/docs/fr/sub-agents.md#run-subagents-in-foreground-or-background).497* **Pas de sous-agents d'arrière-plan à partir de coéquipiers in-process** : les propres sous-agents d'un coéquipier in-process s'exécutent au premier plan, car le travail d'arrière-plan d'un coéquipier ne peut pas survivre au processus du chef. Claude Code retourne une erreur quand un coéquipier génère un sous-agent dont la définition définit `background: true`. Une demande `run_in_background: true` d'un coéquipier échoue également, soit avec une erreur, soit en s'exécutant silencieusement au premier plan. Les sous-agents lancés à partir de la conversation principale suivent la [valeur par défaut d'arrière-plan](https://code.claude.com/docs/fr/sub-agents.md#run-subagents-in-foreground-or-background).

490* **Le chef est fixe** : la session principale est le chef pour sa durée de vie. Vous ne pouvez pas promouvoir un coéquipier en chef ou transférer le leadership.498* **Le chef est fixe** : la session principale est le chef pour sa durée de vie. Vous ne pouvez pas promouvoir un coéquipier en chef ou transférer le leadership.

491* **Permissions définies au moment de la génération** : les coéquipiers commencent avec le mode de permission décrit sous [Permissions](#permissions). Vous pouvez modifier le mode de permission d'un coéquipier individuel après la génération, mais vous ne pouvez pas définir les modes de permission par coéquipier au moment de la génération.499* **Pas de modes de permission par coéquipier au moment de la génération** : les coéquipiers commencent avec le mode de permission décrit sous [Permissions](#permissions).

492* **Les volets divisés nécessitent tmux ou iTerm2** : le mode in-process par défaut fonctionne dans n'importe quel terminal. Le mode volets divisés n'est pas supporté dans le terminal intégré de VS Code, Windows Terminal ou Ghostty.500* **Les volets divisés nécessitent tmux ou iTerm2** : le mode in-process par défaut fonctionne dans n'importe quel terminal. Le mode volets divisés n'est pas supporté dans le terminal intégré de VS Code, Windows Terminal ou Ghostty.

493 501

494## Prochaines étapes502## Prochaines étapes

agent-view.md +1 −1

Details

442 442

443Exécutez `/background` ou son alias `/bg` pour déplacer la conversation actuelle dans une session en arrière-plan. Passez un prompt comme `/bg run the test suite and fix any failures` pour donner d'abord une instruction supplémentaire. Si Claude est en train de répondre lorsque vous exécutez `/bg`, la réponse se poursuit dans la session en arrière-plan.443Exécutez `/background` ou son alias `/bg` pour déplacer la conversation actuelle dans une session en arrière-plan. Passez un prompt comme `/bg run the test suite and fix any failures` pour donner d'abord une instruction supplémentaire. Si Claude est en train de répondre lorsque vous exécutez `/bg`, la réponse se poursuit dans la session en arrière-plan.

444 444

445Quitter une session dans laquelle du travail en arrière-plan est encore en cours, comme des sous-agents, des commandes shell en arrière-plan, des workflows ou des [moniteurs](https://code.claude.com/docs/fr/tools-reference.md#monitor-tool), affiche une boîte de dialogue `Background work is running` au lieu de quitter immédiatement. Choisissez `Move to background and exit` pour mettre la session en arrière-plan de la même façon que `/background` et revenir à votre shell. L'option n'est pas affichée lorsque la vue des agents est [désactivée](#turn-off-agent-view).445Si vous quittez une session alors que certains types de travail en arrière-plan sont en cours, comme des sous-agents ou des workflows, une boîte de dialogue `Background work is running` vous avertit que ce travail s'arrête. Choisissez `Move to background and exit` pour mettre la session en arrière-plan de la même façon que `/background` et revenir à votre shell. L'option n'est pas affichée lorsque la vue des agents est [désactivée](#turn-off-agent-view).

446 446

447Si une session en arrière-plan de la liste porte déjà le nom de la conversation, Claude Code numérote le nom de la nouvelle ligne, par exemple `my-session (2)`, et ne modifie pas le nom de la ligne existante. Pour renommer la nouvelle ligne, sélectionnez-la dans la vue des agents et appuyez sur `Ctrl+R`.447Si une session en arrière-plan de la liste porte déjà le nom de la conversation, Claude Code numérote le nom de la nouvelle ligne, par exemple `my-session (2)`, et ne modifie pas le nom de la ligne existante. Pour renommer la nouvelle ligne, sélectionnez-la dans la vue des agents et appuyez sur `Ctrl+R`.

448 448

amazon-bedrock.md +11 −5

Details

315* Une épingle dans le bloc `env` des [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md)315* Une épingle dans le bloc `env` des [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md)

316* Une épingle qui pointe vers un [ARN de profil d'inférence d'application](#map-each-model-version-to-an-inference-profile), car celle-ci est gérée par votre administrateur316* Une épingle qui pointe vers un [ARN de profil d'inférence d'application](#map-each-model-version-to-an-inference-profile), car celle-ci est gérée par votre administrateur

317 317

318Si la demande de mise à jour apparaît toujours pour une épingle dans les paramètres gérés, mettez à jour Claude Code vers la v2.1.314 ou une version ultérieure. Avant la v2.1.314, l'épingle gérée restait en vigueur après votre acceptation, de sorte que la demande réapparaissait au démarrage suivant.

319

318Si vous n'avez pas épinglé de modèle et que la valeur par défaut actuelle n'est pas disponible dans votre compte, Claude Code bascule pour la session actuelle et affiche un avis. Il essaie d'abord les versions antérieures du modèle par défaut et, lorsque la valeur par défaut est un modèle Opus et qu'aucune version Opus n'est disponible, bascule vers le modèle Sonnet par défaut. Le basculement n'est pas persistant. Activez le modèle plus récent dans votre compte Amazon Bedrock ou [épinglez une version](#4-pin-model-versions) pour rendre le choix permanent.320Si vous n'avez pas épinglé de modèle et que la valeur par défaut actuelle n'est pas disponible dans votre compte, Claude Code bascule pour la session actuelle et affiche un avis. Il essaie d'abord les versions antérieures du modèle par défaut et, lorsque la valeur par défaut est un modèle Opus et qu'aucune version Opus n'est disponible, bascule vers le modèle Sonnet par défaut. Le basculement n'est pas persistant. Activez le modèle plus récent dans votre compte Amazon Bedrock ou [épinglez une version](#4-pin-model-versions) pour rendre le choix permanent.

319 321

322### Démarrer une session sur un modèle spécifique

323

320Lorsque vous démarrez la session sur une version spécifique de Sonnet ou Opus, par exemple avec `--model`, `ANTHROPIC_MODEL`, ou le [paramètre `model`](https://code.claude.com/docs/fr/settings-reference#model), cette version agit comme la valeur par défaut épinglée de la session pour l'alias `sonnet` ou `opus` correspondant. Claude Code ignore la vérification de disponibilité pour la valeur par défaut intégrée que votre modèle remplace et démarre sur le modèle que vous avez configuré, sans avis de basculement.324Lorsque vous démarrez la session sur une version spécifique de Sonnet ou Opus, par exemple avec `--model`, `ANTHROPIC_MODEL`, ou le [paramètre `model`](https://code.claude.com/docs/fr/settings-reference#model), cette version agit comme la valeur par défaut épinglée de la session pour l'alias `sonnet` ou `opus` correspondant. Claude Code ignore la vérification de disponibilité pour la valeur par défaut intégrée que votre modèle remplace et démarre sur le modèle que vous avez configuré, sans avis de basculement.

321 325

322Les éléments suivants n'agissent pas comme des épingles lorsque vous démarrez une session sur eux :326Les éléments suivants n'agissent pas comme des épingles lorsque vous démarrez une session sur eux :

324* Un alias de modèle tel que `opus`328* Un alias de modèle tel que `opus`

325* Un ID de modèle que Claude Code ne reconnaît pas, comme un ARN de profil d'inférence d'application329* Un ID de modèle que Claude Code ne reconnaît pas, comme un ARN de profil d'inférence d'application

326 330

327Lorsque ces vérifications trouvent un modèle que votre compte ne peut pas invoquer, Claude Code mémorise le refus sur cette machine pendant jusqu'à un jour, et les lancements pendant ce temps ignorent le modèle mémorisé sans interroger à nouveau Amazon Bedrock. Claude Code vérifie à nouveau au lancement un refus mémorisé d'un modèle par défaut actuel une fois que dix minutes se sont écoulées depuis la dernière vérification, de sorte qu'une valeur par défaut que votre administrateur réactive revient. Pour désactiver la mémoire, définissez [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/fr/env-vars).331### Refus de modèle mémorisés

332

333Lorsque les vérifications du modèle au démarrage trouvent un modèle que votre compte ne peut pas invoquer, Claude Code peut mémoriser le refus sur cette machine pendant jusqu'à un jour. Une fois que dix minutes se sont écoulées depuis la dernière vérification, Claude Code vérifie à nouveau au lancement un refus mémorisé d'un modèle par défaut actuel. Une valeur par défaut que votre administrateur réactive revient alors. Pour désactiver la mémoire, définissez [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/fr/env-vars).

328 334

329### Lorsque votre organisation impose une liste d'autorisation de modèles335### Lorsque votre organisation impose une liste d'autorisation de modèles

330 336

457 463

458## Garde-fous AWS464## Garde-fous AWS

459 465

460[Les garde-fous Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) vous permettent de mettre en œuvre le filtrage du contenu pour Claude Code. Créez un garde-fou dans la [console Amazon Bedrock](https://console.aws.amazon.com/bedrock/), publiez une version, puis ajoutez les en-têtes du garde-fou à votre [fichier de paramètres](https://code.claude.com/docs/fr/settings.md). Activez l'inférence inter-régions sur votre garde-fou si vous utilisez des profils d'inférence inter-régions.466[Les garde-fous Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) vous permettent de mettre en œuvre le filtrage du contenu pour Claude Code. Créez un garde-fou dans la [console Amazon Bedrock](https://console.aws.amazon.com/bedrock/) et publiez une version. Activez l'inférence inter-régions sur votre garde-fou si vous utilisez des profils d'inférence inter-régions.

461 467

462Exemple de configuration :468Pour appliquer le garde-fou via une [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway), suivez [Appliquer un garde-fou Amazon Bedrock](https://code.claude.com/docs/fr/claude-apps-gateway-config.md#apply-an-amazon-bedrock-guardrail). Sans passerelle d'applications Claude, ajoutez les en-têtes du garde-fou à votre [fichier de paramètres](https://code.claude.com/docs/fr/settings.md).

469

470Exemple de configuration du fichier de paramètres :

463 471

464```json theme={null}472```json theme={null}

465{473{

469}477}

470```478```

471 479

472Si votre organisation fournit les en-têtes du garde-fou via une politique de [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway), ils comptent comme des [paramètres nécessitant une approbation](https://code.claude.com/docs/fr/server-managed-settings.md#environment-variables-and-the-approval-dialog).

~~473~~

474Lorsque le garde-fou bloque une réponse en cours de route, le texte déjà diffusé est conservé et la réponse se termine par le message configuré sur le garde-fou pour les réponses bloquées.480Lorsque le garde-fou bloque une réponse en cours de route, le texte déjà diffusé est conservé et la réponse se termine par le message configuré sur le garde-fou pour les réponses bloquées.

475 481

476## Utiliser le point de terminaison Mantle482## Utiliser le point de terminaison Mantle

authentication.md +47 −47

Details

213 213

214## Gestion des identifiants214## Gestion des identifiants

215 215

216Claude Code gère de manière sécurisée vos identifiants d'authentification :216Claude Code gère vos identifiants d'authentification de manière sécurisée :

217 217

218* **Emplacement de stockage** :218* **Emplacement de stockage** :

219 * Sur macOS, les identifiants sont stockés dans le Keychain macOS chiffré. Lorsque le Keychain rejette l'écriture, par exemple lorsqu'il est verrouillé dans une session SSH, Claude Code stocke votre connexion dans `~/.claude/.credentials.json` avec le mode fichier `0600` à la place, le même stockage qu'il utilise sur Linux. Une connexion Console qui crée une clé API échoue jusqu'à ce que le Keychain soit accessible en écriture. Pour déplacer votre connexion dans le Keychain, suivez [les étapes de récupération](https://code.claude.com/docs/fr/troubleshoot-install.md#not-logged-in-or-token-expired).219 * Sur macOS, les identifiants sont stockés dans le trousseau macOS chiffré. Lorsque le trousseau refuse l'écriture, par exemple lorsqu'il est verrouillé dans une session SSH, Claude Code stocke votre connexion dans `~/.claude/.credentials.json` avec le mode de fichier `0600`, soit le même stockage que sur Linux. Une connexion Console qui crée une clé API échoue tant que le trousseau n'est pas accessible en écriture. Pour replacer votre connexion dans le trousseau, suivez [les étapes de récupération](https://code.claude.com/docs/fr/troubleshoot-install.md#not-logged-in-or-token-expired).

220 * Sur Linux, les identifiants sont stockés dans `~/.claude/.credentials.json` avec le mode fichier `0600`.220 * Sur Linux, les identifiants sont stockés dans `~/.claude/.credentials.json` avec le mode de fichier `0600`.

221 * Sur Windows, les identifiants sont stockés dans `%USERPROFILE%\.claude\.credentials.json` et héritent des contrôles d'accès de votre répertoire de profil utilisateur, ce qui restreint le fichier à votre compte utilisateur par défaut.221 * Sur Windows, les identifiants sont stockés dans `%USERPROFILE%\.claude\.credentials.json` et héritent des contrôles d'accès de votre répertoire de profil utilisateur, qui limitent par défaut l'accès au fichier à votre compte utilisateur.

222 * Si vous avez défini la variable d'environnement `CLAUDE_CONFIG_DIR`, Claude Code conserve le fichier `.credentials.json` sous ce répertoire à la place, y compris le fichier que le fallback macOS écrit, et clé l'entrée macOS Keychain sur ce répertoire également, de sorte qu'une session avec un `CLAUDE_CONFIG_DIR` différent lit une entrée différente.222 * Si vous avez défini la variable d'environnement `CLAUDE_CONFIG_DIR`, Claude Code conserve le fichier `.credentials.json` dans ce répertoire, y compris le fichier écrit par la solution de repli macOS, et associe également l'entrée du trousseau macOS à ce répertoire : une session utilisant un `CLAUDE_CONFIG_DIR` différent lit donc une entrée différente.

223 * Claude Code gère `.credentials.json` via `/login` et `/logout`. Pour router les requêtes via un point de terminaison API personnalisé, définissez plutôt la variable d'environnement [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/fr/env-vars).223 * Claude Code gère `.credentials.json` via `/login` et `/logout`. Pour acheminer les requêtes via un endpoint d'API personnalisé, définissez plutôt la variable d'environnement [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/fr/env-vars).

224* **Types d'authentification pris en charge** : identifiants Claude.ai, identifiants API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, identifiants de profil Anthropic et [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), et jetons de session de la [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway).224* **Types d'authentification pris en charge** : identifiants claude.ai, identifiants Claude API, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, identifiants de profil Anthropic et de [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), et jetons de session de la [passerelle Claude apps](https://code.claude.com/docs/fr/claude-apps-gateway).

225* **Scripts d'identifiants personnalisés** : configurez le paramètre [`apiKeyHelper`](https://code.claude.com/docs/fr/settings-reference#apikeyhelper) pour exécuter un script shell qui retourne une clé API.225* **Scripts d'identifiants personnalisés** : configurez le paramètre [`apiKeyHelper`](https://code.claude.com/docs/fr/settings-reference#apikeyhelper) pour exécuter un script shell qui renvoie une clé API.

226* **Intervalles d'actualisation** : consultez [`apiKeyHelper`](https://code.claude.com/docs/fr/settings-reference#apikeyhelper) pour les cas dans lesquels Claude Code réexécute l'assistant.226* **Intervalles de rafraîchissement** : consultez [`apiKeyHelper`](https://code.claude.com/docs/fr/settings-reference#apikeyhelper) pour connaître les cas dans lesquels Claude Code réexécute le helper.

227* **Avis d'assistant lent** : si `apiKeyHelper` prend plus de 10 secondes pour retourner une clé, Claude Code affiche un avis d'avertissement dans la barre d'invite montrant le temps écoulé. Si vous voyez cet avis régulièrement, vérifiez si votre script d'identifiants peut être optimisé.227* **Avertissement de helper lent** : si `apiKeyHelper` met plus de 10 secondes à renvoyer une clé, Claude Code affiche un avertissement dans la barre de prompt indiquant le temps écoulé. Si cet avertissement apparaît régulièrement, vérifiez si votre script d'identifiants peut être optimisé.

228* **Échecs de l'assistant** : lorsque le script se termine avec une erreur, expire ou n'affiche rien, les requêtes échouent avec [`Your apiKeyHelper script is failing`](https://code.claude.com/docs/fr/errors#your-apikeyhelper-script-is-failing) après trois tentatives.228* **Échecs du helper** : lorsque le script se termine avec une erreur, expire ou n'affiche rien, les requêtes échouent avec [`Your apiKeyHelper script is failing`](https://code.claude.com/docs/fr/errors#your-apikeyhelper-script-is-failing) en trois tentatives au maximum.

229 229

230`apiKeyHelper`, `ANTHROPIC_API_KEY` et `ANTHROPIC_AUTH_TOKEN` s'appliquent à la CLI et aux surfaces qui l'enveloppent, y compris l'extension VS Code, le SDK Agent et GitHub Actions. Claude Desktop et les sessions cloud n'appellent pas `apiKeyHelper` ni ne lisent ces variables d'environnement : elles utilisent OAuth, sauf les sessions de bureau exécutant une [configuration d'inférence tierce](https://code.claude.com/docs/fr/llm-gateway-connect.md#desktop-app), qui s'authentifient avec les identifiants de cette configuration.230`apiKeyHelper`, `ANTHROPIC_API_KEY` et `ANTHROPIC_AUTH_TOKEN` s'appliquent au CLI et aux surfaces qui l'encapsulent, notamment l'extension VS Code, l'Agent SDK et GitHub Actions. Claude Desktop et les sessions cloud n'appellent pas `apiKeyHelper` et ne lisent pas ces variables d'environnement : ils utilisent OAuth, à l'exception des sessions Desktop qui exécutent une [configuration d'inférence tierce](https://code.claude.com/docs/fr/llm-gateway-connect.md#desktop-app), lesquelles s'authentifient avec l'identifiant de cette configuration.

231 231

232### Renouveler une connexion qui expire232### Renouveler une connexion sur le point d'expirer

233 233

234Lorsque la connexion que vous avez créée avec `/login` est à moins de trois jours de l'expiration, Claude Code affiche un avertissement au démarrage : `Your login expires in 3 days · run /login to renew`.234Lorsque la connexion que vous avez créée avec `/login` expire dans trois jours ou moins, Claude Code affiche un avertissement au démarrage : `Your login expires in 3 days · run /login to renew`.

235 235

236Exécutez `/login` pour renouveler. L'avertissement est informatif et ne bloque jamais une requête : l'authentification continue de fonctionner jusqu'à ce que la connexion expire réellement.236Exécutez `/login` pour la renouveler. L'avertissement est informatif et ne bloque jamais une requête : l'authentification continue de fonctionner jusqu'à l'expiration effective de la connexion.

237 237

238Une fois que la connexion stockée expire et ne peut pas être actualisée, chaque requête de modèle échoue avec [`Login expired · Please run /login`](https://code.claude.com/docs/fr/errors#login-expired) jusqu'à ce que vous vous reconnectiez.238Une fois que la connexion stockée a expiré et ne peut plus être rafraîchie, chaque requête au modèle échoue avec [`Login expired · Please run /login`](https://code.claude.com/docs/fr/errors#login-expired) jusqu'à ce que vous vous reconnectiez.

239 239

240Vous pouvez vérifier cet état avant qu'une requête échoue : [`/status`](https://code.claude.com/docs/fr/commands) affiche une ligne `Login` indiquant `Expired — log in again`, plus l'organisation et l'e-mail qu'il a enregistrés pour la connexion expirée. La ligne n'apparaît que lorsque la connexion claude.ai enregistrée est l'identifiant actif. La ligne nécessite Claude Code v2.1.210 ou version ultérieure.240Vous pouvez vérifier cet état avant qu'une requête n'échoue : [`/status`](https://code.claude.com/docs/fr/commands) affiche une ligne `Login` indiquant `Expired — log in again`, ainsi que l'organisation et l'adresse e-mail enregistrées pour la connexion expirée. La ligne n'apparaît que lorsque la connexion claude.ai enregistrée est l'identifiant actif. Elle nécessite Claude Code v2.1.210 ou version ultérieure.

241 241

242L'avertissement n'apparaît que lorsqu'une connexion claude.ai est l'identifiant actif, et non lorsqu'un fournisseur cloud, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` fournit l'identifiant.242L'avertissement n'apparaît que lorsqu'une connexion claude.ai est l'identifiant actif, et non lorsqu'un fournisseur cloud, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` fournit l'identifiant.

243 243

244Le renouvellement anticipé est plus important pour les sessions qui s'exécutent sans surveillance. Une [session en arrière-plan en vue agent](https://code.claude.com/docs/fr/agent-view.md) ou une session [Remote Control](https://code.claude.com/docs/fr/remote-control.md) qui dépasse la durée de vie de la connexion cesse de progresser une fois que l'identifiant expire et ne peut pas récupérer jusqu'à ce que vous vous reconnectiez.244Renouveler en avance est surtout important pour les sessions qui s'exécutent sans surveillance. Une [session en arrière-plan dans la vue agent](https://code.claude.com/docs/fr/agent-view.md) ou une session [Remote Control](https://code.claude.com/docs/fr/remote-control.md) qui dure plus longtemps que la connexion cesse de progresser dès l'expiration de l'identifiant et ne peut pas reprendre tant que vous ne vous êtes pas reconnecté.

245 245

246### Ordre de priorité de l'authentification246### Priorité d'authentification

247 247

248Lorsque plusieurs identifiants sont présents, Claude Code en choisit un dans cet ordre :248Lorsque plusieurs identifiants sont présents, Claude Code en choisit un dans l'ordre suivant :

249 249

2501. Identifiants du fournisseur cloud, lorsque `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` est défini. Consultez [intégrations tierces](https://code.claude.com/docs/fr/third-party-integrations.md) pour la configuration.2501. Les identifiants du fournisseur cloud, lorsque `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` est défini. Consultez [intégrations tierces](https://code.claude.com/docs/fr/third-party-integrations.md) pour la configuration.

2512. Variable d'environnement `ANTHROPIC_AUTH_TOKEN`. Envoyée en tant qu'en-tête `Authorization: Bearer`. Utilisez ceci lors du routage via une [passerelle LLM ou proxy](https://code.claude.com/docs/fr/llm-gateway) qui s'authentifie avec des jetons porteurs plutôt que des clés API Anthropic.2512. La variable d'environnement `ANTHROPIC_AUTH_TOKEN`. Envoyée dans l'en-tête `Authorization: Bearer`. Utilisez-la lorsque vous passez par une [passerelle LLM ou un proxy](https://code.claude.com/docs/fr/llm-gateway) qui s'authentifie avec des jetons bearer plutôt qu'avec des clés API Anthropic.

2523. Variable d'environnement `ANTHROPIC_API_KEY`. Envoyée en tant qu'en-tête `X-Api-Key`. Utilisez ceci pour l'accès direct à l'API Anthropic avec une clé de la [Claude Console](https://platform.claude.com). En mode interactif, vous êtes invité une fois à approuver ou refuser la clé, et votre choix est mémorisé. Pour le modifier ultérieurement, utilisez le bouton bascule « Use custom API key » dans `/config`. Le bouton bascule n'apparaît que lorsque `ANTHROPIC_API_KEY` est défini dans votre environnement. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente.2523. La variable d'environnement `ANTHROPIC_API_KEY`. Envoyée dans l'en-tête `X-Api-Key`. Utilisez-la pour un accès direct à l'API Anthropic avec une clé provenant de la [Claude Console](https://platform.claude.com). En mode interactif, il vous est demandé une seule fois d'approuver ou de refuser la clé, et votre choix est mémorisé. Pour le modifier ultérieurement, utilisez l'option « Use custom API key » dans `/config`. Cette option n'apparaît que tant que `ANTHROPIC_API_KEY` est défini dans votre environnement. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente.

2534. Sortie du script [`apiKeyHelper`](https://code.claude.com/docs/fr/settings-reference#apikeyhelper). Utilisez ceci pour les identifiants dynamiques ou rotatifs, tels que les jetons de courte durée récupérés à partir d'un coffre-fort.2534. La sortie du script [`apiKeyHelper`](https://code.claude.com/docs/fr/settings-reference#apikeyhelper). Utilisez-le pour des identifiants dynamiques ou renouvelés régulièrement, comme des jetons de courte durée récupérés depuis un coffre-fort.

2545. Variable d'environnement `CLAUDE_CODE_OAUTH_TOKEN`. Un jeton OAuth de longue durée généré par [`claude setup-token`](#generate-a-long-lived-token). Utilisez ceci pour les pipelines CI et les scripts où la connexion au navigateur n'est pas disponible. Si vous exécutez `/login` alors que la variable est définie, Claude Code bascule la session actuelle vers la nouvelle connexion, mais relit la variable dans chaque nouvelle session jusqu'à ce que vous la supprimiez de votre profil shell ou du bloc `env` d'un [fichier de paramètres](https://code.claude.com/docs/fr/settings.md).2545. La variable d'environnement `CLAUDE_CODE_OAUTH_TOKEN`. Un jeton OAuth de longue durée généré par [`claude setup-token`](#generate-a-long-lived-token). Utilisez-le pour les pipelines CI et les scripts où la connexion via navigateur n'est pas disponible. Si vous exécutez `/login` alors que la variable est définie, Claude Code bascule la session en cours sur la nouvelle connexion. Pour conserver cette connexion dans les nouvelles sessions, supprimez la variable de votre profil shell et des [fichiers de paramètres susceptibles de la définir](https://code.claude.com/docs/fr/settings-reference.md#variables-claude-code-ignores-in-env), comme vos paramètres utilisateur.

2556. Identifiants de profil Anthropic et de fédération, les identifiants que la CLI `ant` et Workload Identity Federation utilisent. Un profil que `ant auth login` a écrit ne se classe ici que lorsque vous le nommez dans `ANTHROPIC_PROFILE` ; sinon, il se classe en dessous de `/login`. Consultez [Profils Anthropic et identifiants de fédération](#anthropic-profiles-and-federation-credentials).2556. Les identifiants de profil Anthropic et de fédération, c'est-à-dire les identifiants utilisés par le CLI `ant` et Workload Identity Federation. Un profil écrit par `ant auth login` ne se classe à ce rang que lorsque vous le nommez dans `ANTHROPIC_PROFILE` ; sinon, il se classe en dessous de `/login`. Consultez [Profils Anthropic et identifiants de fédération](#anthropic-profiles-and-federation-credentials).

2567. Identifiants OAuth d'abonnement de `/login`. C'est la valeur par défaut pour les utilisateurs Claude Pro, Max, Ultra, Team et Enterprise.2567. Les identifiants OAuth d'abonnement issus de `/login`. C'est la méthode par défaut pour les utilisateurs de Claude Pro, Max, Ultra, Team et Enterprise.

257 257

258Une session [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway) signée se situe en dehors de cette liste : c'est une sélection de fournisseur comme Amazon Bedrock ou Google Cloud's Agent Platform, et elle les surclasse. Lorsqu'une session de passerelle existe, la CLI s'authentifie avec le jeton de passerelle même si `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` est défini, et les sources d'identifiants ci-dessus telles que le jeton porteur, la clé API, `apiKeyHelper` et les profils ne sont pas utilisés.258Une session connectée à la [passerelle Claude apps](https://code.claude.com/docs/fr/claude-apps-gateway) se situe en dehors de cette liste : il s'agit d'une sélection de fournisseur, comme Amazon Bedrock ou Agent Platform de Google Cloud, et elle a priorité sur ceux-ci. Lorsqu'une session de passerelle existe, le CLI s'authentifie avec le jeton de la passerelle même si `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` est défini, et les sources d'identifiants ci-dessus, comme le jeton bearer, la clé API, `apiKeyHelper` et les profils, ne sont pas utilisées.

259 259

260Si les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) de votre machine définissent [`forceLoginMethod`](https://code.claude.com/docs/fr/settings-reference#forceloginmethod) sur `"gateway"` ou définissent [`forceLoginGatewayUrl`](https://code.claude.com/docs/fr/settings-reference#forcelogingatewayurl), et que vous ne sélectionnez pas un fournisseur cloud via une variable telle que `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, votre session utilise uniquement la connexion de passerelle. Claude Code ignore les autres sources d'identifiants et vous demande de vous connecter avec `/login`. Consultez [Administrator policy requires a Cloud gateway sign-in](https://code.claude.com/docs/fr/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in) pour voir ce que vous voyez avec chaque identifiant restant. Nécessite Claude Code v2.1.261 ou version ultérieure, ou v2.1.265 ou version ultérieure sur une machine qui définit uniquement `forceLoginGatewayUrl`.260Si les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) de votre machine définissent [`forceLoginMethod`](https://code.claude.com/docs/fr/settings-reference#forceloginmethod) sur `"gateway"` ou définissent [`forceLoginGatewayUrl`](https://code.claude.com/docs/fr/settings-reference#forcelogingatewayurl), et que vous ne sélectionnez pas de fournisseur cloud via une variable telle que `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, votre session utilise uniquement la connexion à la passerelle. Claude Code ignore les autres sources d'identifiants et vous demande de vous connecter avec `/login`. Consultez [Administrator policy requires a Cloud gateway sign-in](https://code.claude.com/docs/fr/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in) pour savoir ce qui s'affiche avec chaque identifiant restant. Nécessite Claude Code v2.1.261 ou version ultérieure, ou v2.1.265 ou version ultérieure sur une machine qui définit uniquement `forceLoginGatewayUrl`.

261 261

262Si vous avez un abonnement Claude actif mais que vous avez également `ANTHROPIC_API_KEY` défini dans votre environnement, Claude Code utilise la clé API une fois approuvée. Cela peut causer des échecs d'authentification si la clé appartient à une organisation désactivée ou expirée.262Si vous disposez d'un abonnement Claude actif mais que `ANTHROPIC_API_KEY` est également défini dans votre environnement, Claude Code utilise la clé API une fois que vous l'avez approuvée. Cela peut provoquer des échecs d'authentification si la clé appartient à une organisation désactivée ou expirée.

263 263

264Exécutez `unset ANTHROPIC_API_KEY` pour revenir à votre abonnement, et vérifiez `/status` pour confirmer quelle méthode est active. Lorsqu'une connexion et une clé API sont toutes deux configurées, `/status` marque l'identifiant qui n'est pas en cours d'utilisation.264Exécutez `unset ANTHROPIC_API_KEY` pour basculer sur votre abonnement, et consultez `/status` pour confirmer quelle méthode est active. Lorsqu'une connexion et une clé API sont toutes deux configurées, `/status` signale l'identifiant qui n'est pas utilisé.

265 265

266[Claude Code sur le Web](https://code.claude.com/docs/fr/claude-code-on-the-web.md) utilise toujours vos identifiants d'abonnement. Si vous définissez `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN` dans l'environnement cloud, cela ne remplace pas vos identifiants d'abonnement.266Les [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md) utilisent toujours les identifiants de votre abonnement. Si vous définissez `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN` dans l'environnement cloud, cela ne remplace pas les identifiants de votre abonnement.

267 267

268#### Profils Anthropic et identifiants de fédération268#### Profils Anthropic et identifiants de fédération

269 269

270Un profil est un fichier de configuration d'identifiants nommé dans votre [répertoire de configuration Anthropic](https://platform.claude.com/docs/en/manage-claude/wif-reference#configuration-directory), par défaut `~/.config/anthropic` sur macOS et Linux ou `%APPDATA%\Anthropic` sur Windows. Le mode d'authentification d'un profil est `oidc_federation` lorsque vous le configurez pour [Workload Identity Federation (WIF)](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) ou `user_oauth` lorsque [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) l'a écrit ou que vous [vous êtes connecté à un compte Console sans clé API](#sign-in-without-an-api-key).270Un profil est un fichier de configuration d'identifiants nommé, situé dans votre [répertoire de configuration Anthropic](https://platform.claude.com/docs/en/manage-claude/wif-reference#configuration-directory), par défaut `~/.config/anthropic` sur macOS et Linux ou `%APPDATA%\Anthropic` sur Windows. Le mode d'authentification d'un profil est `oidc_federation` lorsque vous l'avez configuré pour [Workload Identity Federation (WIF)](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), ou `user_oauth` lorsque [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) l'a écrit ou que vous vous êtes [connecté à un compte Console sans clé API](#sign-in-without-an-api-key).

271 271

272Claude Code ne lit pas les profils ou les variables de fédération en [mode bare](https://code.claude.com/docs/fr/headless.md#start-faster-with-bare-mode), dans Claude Desktop ou dans les sessions cloud. Dans ces sessions, `/status` n'affiche aucune ligne `Profile`.272Claude Code ne lit pas les profils ni les variables de fédération en [mode bare](https://code.claude.com/docs/fr/headless.md#start-faster-with-bare-mode), dans Claude Desktop ou dans les sessions cloud. Dans ces sessions, `/status` n'affiche aucune ligne `Profile`.

273 273

274Claude Code vérifie trois sources dans cet ordre et s'arrête à la première qui est définie. Le tableau montre ce qui définit chaque source et où elle se classe par rapport à votre identifiant `/login`.274Claude Code vérifie trois sources dans l'ordre suivant et s'arrête à la première qui est définie. Le tableau indique ce qui définit chaque source et son rang par rapport à votre identifiant `/login`.

275 275

277| :- | :- | :- |277| :- | :- | :- |

280| Profil actif | Le fichier [`active_config`](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) dans votre répertoire de configuration, ou un profil nommé `default` | Au-dessus lorsque son mode d'authentification est `oidc_federation` ; en dessous d'un identifiant `/login` fonctionnant lorsque son mode d'authentification est `user_oauth` |280| Profil actif | Le [fichier `active_config`](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) de votre répertoire de configuration, ou un profil nommé `default` | Au-dessus lorsque son mode d'authentification est `oidc_federation` ; en dessous d'un identifiant `/login` fonctionnel lorsque son mode d'authentification est `user_oauth` |

281 281

282Pour les variables de fédération, Claude Code lit également les autres variables dans la [référence WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), telles que `ANTHROPIC_IDENTITY_TOKEN_FILE`, lorsqu'il échange votre jeton d'identité. Pour le format du fichier de profil, consultez la [référence WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).282Pour les variables de fédération, Claude Code lit également les autres variables de la [référence WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), comme `ANTHROPIC_IDENTITY_TOKEN_FILE`, lorsqu'il échange votre jeton d'identité. Pour le format du fichier de profil, consultez la [référence WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).

283 283

284Pour confirmer quelle source Claude Code a choisie, exécutez `/status`. Une ligne `Profile` nomme la source à la place de la ligne `Login method`. Lorsque le profil est l'identifiant en cours d'utilisation, les lignes `Organization` et `Email` affichent son compte.284Pour confirmer quelle source Claude Code a choisie, exécutez `/status`. Une ligne `Profile` nomme la source à la place de la ligne `Login method`. Lorsque le profil est l'identifiant utilisé, les lignes `Organization` et `Email` affichent son compte.

285 285

286Lorsque la connexion d'un profil `user_oauth` a expiré et que Claude Code ne peut pas la renouveler, les requêtes échouent avec une [erreur de connexion de profil expirée](https://code.claude.com/docs/fr/errors.md#anthropic-profile-login-expired).286Lorsque la connexion d'un profil `user_oauth` a expiré et que Claude Code ne peut pas la renouveler, les requêtes échouent avec une [erreur de connexion de profil expirée](https://code.claude.com/docs/fr/errors.md#anthropic-profile-login-expired).

287 287

288Les fonctionnalités qui nécessitent votre connexion claude.ai, telles que [les connecteurs claude.ai](https://code.claude.com/docs/fr/mcp.md#use-mcp-servers-from-claude-ai) et [`/schedule`](https://code.claude.com/docs/fr/routines), ne sont pas disponibles lorsqu'une de ces sources est sélectionnée. Pour empêcher Claude Code de sélectionner une source :288Les fonctionnalités qui nécessitent votre connexion claude.ai, comme les [connecteurs claude.ai](https://code.claude.com/docs/fr/mcp.md#use-mcp-servers-from-claude-ai) et [`/schedule`](https://code.claude.com/docs/fr/routines), ne sont pas disponibles tant que l'une de ces sources est sélectionnée. Pour empêcher Claude Code de sélectionner une source :

289 289

290* **Profil nommé ou variables de fédération** : supprimez `ANTHROPIC_PROFILE`, ou supprimez l'une des variables de fédération290* **Profil nommé ou variables de fédération** : supprimez la définition de `ANTHROPIC_PROFILE`, ou de l'une des variables de fédération

291* **Profil actif** : exécutez `/logout` pour un profil `user_oauth` dont l'identifiant actuel vous avez écrit en [vous connectant à un compte Console sans clé API](#sign-in-without-an-api-key), exécutez `ant auth logout` pour un dont l'identifiant actuel `ant auth login` a écrit, ou supprimez le fichier du profil de `configs/` dans votre répertoire de configuration pour l'un ou l'autre mode d'authentification291* **Profil actif** : exécutez `/logout` pour un profil `user_oauth` dont vous avez écrit l'identifiant actuel en vous [connectant à un compte Console sans clé API](#sign-in-without-an-api-key), exécutez `ant auth logout` pour un profil dont l'identifiant actuel a été écrit par `ant auth login`, ou supprimez le fichier du profil dans `configs/` de votre répertoire de configuration, quel que soit le mode d'authentification

292 292

293### Générer un jeton de longue durée293### Générer un jeton de longue durée

294 294

295Pour les pipelines CI, les scripts ou d'autres environnements où la connexion au navigateur interactif n'est pas disponible, générez un jeton OAuth d'un an avec `claude setup-token` :295Pour les pipelines CI, les scripts ou d'autres environnements où la connexion interactive via navigateur n'est pas disponible, générez un jeton OAuth valable un an avec `claude setup-token` :

296 296

297```bash theme={null}297```bash theme={null}

298claude setup-token298claude setup-token

299```299```

300 300

301La commande ouvre le même flux d'autorisation du navigateur que `/login`, et le jeton s'affiche dans le terminal après que vous ayez approuvé l'accès dans le navigateur. Il ne sauvegarde le jeton nulle part ; copiez-le et définissez-le en tant que variable d'environnement `CLAUDE_CODE_OAUTH_TOKEN` partout où vous souhaitez vous authentifier :301La commande ouvre le même flux d'autorisation dans le navigateur que `/login`, et le jeton s'affiche dans le terminal une fois que vous avez approuvé l'accès dans le navigateur. Elle n'enregistre le jeton nulle part ; copiez-le et définissez-le comme variable d'environnement `CLAUDE_CODE_OAUTH_TOKEN` partout où vous souhaitez vous authentifier :

302 302

303> [tab] macOS, Linux, WSL303> [tab] macOS, Linux, WSL

304>304>

318> set CLAUDE_CODE_OAUTH_TOKEN=your-token318> set CLAUDE_CODE_OAUTH_TOKEN=your-token

319> ```319> ```

320 320

321Ce jeton s'authentifie avec votre abonnement Claude et nécessite un plan Pro, Max, Ultra, Team ou Enterprise. Il ne peut faire que des requêtes de modèle, il ne peut donc pas établir de sessions [Remote Control](https://code.claude.com/docs/fr/remote-control.md) ou récupérer [les connecteurs claude.ai](https://code.claude.com/docs/fr/mcp.md#use-mcp-servers-from-claude-ai). Les serveurs MCP que vous configurez localement fonctionnent toujours.321Ce jeton s'authentifie avec votre abonnement Claude et nécessite un forfait Pro, Max, Ultra, Team ou Enterprise. Il ne peut effectuer que des requêtes au modèle : il ne peut donc pas établir de sessions [Remote Control](https://code.claude.com/docs/fr/remote-control.md) ni récupérer les [connecteurs claude.ai](https://code.claude.com/docs/fr/mcp.md#use-mcp-servers-from-claude-ai). Les serveurs MCP que vous configurez localement continuent de fonctionner.

322 322

323[Le mode bare](https://code.claude.com/docs/fr/headless.md#start-faster-with-bare-mode) ne lit pas `CLAUDE_CODE_OAUTH_TOKEN`. Si votre script passe `--bare`, authentifiez-vous avec `ANTHROPIC_API_KEY` ou un `apiKeyHelper` à la place.323Le [mode bare](https://code.claude.com/docs/fr/headless.md#start-faster-with-bare-mode) ne lit pas `CLAUDE_CODE_OAUTH_TOKEN`. Si votre script transmet `--bare`, authentifiez-vous plutôt avec `ANTHROPIC_API_KEY` ou un `apiKeyHelper`.

best-practices.md +1 −1

Details

603>603>

604> Une exécution `claude -p --worktree` est à nettoyer vous-même, puisqu'elle se termine sans rien demander. Supprimez ces worktrees avec `git worktree remove <path>`, et si git refuse parce que le worktree est verrouillé, exécutez d'abord `git worktree unlock <path>`.604> Une exécution `claude -p --worktree` est à nettoyer vous-même, puisqu'elle se termine sans rien demander. Supprimez ces worktrees avec `git worktree remove <path>`, et si git refuse parce que le worktree est verrouillé, exécutez d'abord `git worktree unlock <path>`.

605 605

606Pour une grosse modification mécanique sur de nombreux fichiers, [`/batch migrate every handler to the v2 response helpers`](https://code.claude.com/docs/fr/commands) divise le travail en 5 à 30 unités et vous montre le plan. Il exécute ensuite chaque unité dans son propre worktree et ouvre une PR pour chacune. Depuis votre shell, [`claude agents`](https://code.claude.com/docs/fr/agent-view) (encore en research preview) vous donne un seul écran pour tout ce qui s'exécute en arrière-plan sur votre machine.606Pour une grosse modification mécanique sur de nombreux fichiers, [`/batch migrate every handler to the v2 response helpers`](https://code.claude.com/docs/fr/commands) divise le travail en 5 à 30 unités et vous montre le plan. Une fois que vous l'avez approuvé, chaque unité obtient son propre worktree et ouvre une PR ou indique ce qui s'est passé. Depuis votre shell, [`claude agents`](https://code.claude.com/docs/fr/agent-view) (encore en research preview) vous donne un seul écran pour tout ce qui s'exécute en arrière-plan sur votre machine.

607 607

608Une deuxième session est aussi le relecteur indépendant le plus facile à obtenir. Une session écrit le limiteur de débit, une autre examine `@src/middleware/rateLimiter.ts` sans l'avoir vu s'écrire, et vous recollez les constatations dans la première. Même idée que `/code-review`, mais c'est vous qui transportez les messages.608Une deuxième session est aussi le relecteur indépendant le plus facile à obtenir. Une session écrit le limiteur de débit, une autre examine `@src/middleware/rateLimiter.ts` sans l'avoir vu s'écrire, et vous recollez les constatations dans la première. Même idée que `/code-review`, mais c'est vous qui transportez les messages.

609 609

cli-reference.md +1 −1

Details

85| `--desktop` | Ouvrir l'[application Claude Desktop](https://code.claude.com/docs/fr/desktop.md) sur le répertoire courant et quitter sans démarrer une session dans le terminal. Ajoutez `--continue`, ou `--resume` avec un ID de session, pour [ouvrir cette session dans Desktop](https://code.claude.com/docs/fr/desktop.md#coming-from-the-cli) à la place. `--resume` ici prend uniquement un ID de session, pas un nom ou un chemin de transcription. Ne prend aucune invite et aucun autre drapeau sauf `--verbose` et les drapeaux `--debug`, puisque l'application démarre la session elle-même. Disponible sur macOS et Windows x64 lorsque vous êtes connecté avec un abonnement Claude. Nécessite Claude Code v2.1.285 ou ultérieur | `claude --desktop` |85| `--desktop` | Ouvrir l'[application Claude Desktop](https://code.claude.com/docs/fr/desktop.md) sur le répertoire courant et quitter sans démarrer une session dans le terminal. Ajoutez `--continue`, ou `--resume` avec un ID de session, pour [ouvrir cette session dans Desktop](https://code.claude.com/docs/fr/desktop.md#coming-from-the-cli) à la place. `--resume` ici prend uniquement un ID de session, pas un nom ou un chemin de transcription. Ne prend aucune invite et aucun autre drapeau sauf `--verbose` et les drapeaux `--debug`, puisque l'application démarre la session elle-même. Disponible sur macOS et Windows x64 lorsque vous êtes connecté avec un abonnement Claude. Nécessite Claude Code v2.1.285 ou ultérieur | `claude --desktop` |

87| `--disallowedTools`, `--disallowed-tools` | Règles de refus. Un nom d'outil nu supprime les outils correspondants du contexte de Claude : `"Edit"` supprime Edit, `"*"` supprime tous les outils, et `"mcp__*"` supprime tous les outils MCP. Une règle délimitée telle que `Bash(rm *)` laisse l'outil disponible et refuse uniquement les appels correspondants [tels qu'écrits](https://code.claude.com/docs/fr/permissions.md#bash-rule-limits). Une règle nommant [`EndConversation`](https://code.claude.com/docs/fr/tools-reference#endconversation-tool-behavior) ne peut pas le supprimer tant que tout autre outil reste | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |87| `--disallowedTools`, `--disallowed-tools` | Règles de refus. Un nom d'outil nu supprime les outils correspondants du contexte de Claude : `"Edit"` supprime Edit, `"*"` supprime tous les outils, et `"mcp__*"` supprime tous les outils MCP. Une règle délimitée telle que `Bash(rm *)` laisse l'outil disponible et refuse uniquement les appels correspondants [tels qu'écrits](https://code.claude.com/docs/fr/permissions.md#bash-rule-limits). Une règle nommant [`EndConversation`](https://code.claude.com/docs/fr/tools-reference#endconversation-tool-behavior) ne peut pas le supprimer tant que tout autre outil reste | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

88| `--effort` | Définir le [niveau d'effort](https://code.claude.com/docs/fr/model-config.md#adjust-effort-level) pour la session actuelle. Options : `low`, `medium`, `high`, `xhigh`, `max`, ou `ultracode`. Les niveaux disponibles dépendent du modèle. `ultracode` demande l'effort `xhigh` avec [ultracode](https://code.claude.com/docs/fr/workflows.md#let-claude-decide-with-ultracode) activé, et nécessite Claude Code v2.1.203 ou ultérieur. Remplace les paramètres [`modelSettings`](https://code.claude.com/docs/fr/settings-reference#modelsettings) et [`effortLevel`](https://code.claude.com/docs/fr/settings-reference#effortlevel) pour cette session et ne persiste pas | `claude --effort high` |88| `--effort` | Définir le [niveau d'effort](https://code.claude.com/docs/fr/model-config.md#adjust-effort-level) pour la session actuelle. Options : `low`, `medium`, `high`, `xhigh`, `max`, ou `ultracode`. Les niveaux disponibles dépendent du modèle. `ultracode` demande l'effort `xhigh` avec [ultracode](https://code.claude.com/docs/fr/workflows.md#let-claude-decide-with-ultracode) activé, et nécessite Claude Code v2.1.203 ou ultérieur. Sur le modèle de la conversation principale, remplace les paramètres [`modelSettings`](https://code.claude.com/docs/fr/settings-reference#modelsettings) et [`effortLevel`](https://code.claude.com/docs/fr/settings-reference#effortlevel) pour cette session et ne persiste pas | `claude --effort high` |

89| `--enable-auto-mode` | Supprimé dans v2.1.111. Le mode auto est maintenant dans le cycle `Shift+Tab` par défaut ; utilisez `--permission-mode auto` pour commencer dedans | `claude --permission-mode auto` |89| `--enable-auto-mode` | Supprimé dans v2.1.111. Le mode auto est maintenant dans le cycle `Shift+Tab` par défaut ; utilisez `--permission-mode auto` pour commencer dedans | `claude --permission-mode auto` |

90| `--environment <environment-id>` | Créer une nouvelle session cloud qui s'exécute sur l'[environnement auto-hébergé](https://code.claude.com/docs/fr/self-hosted-environments) avec l'ID donné. Les ID d'environnement commencent par `ccpool_`. Voir [comportement de dispatch `--environment`](https://code.claude.com/docs/fr/self-hosted-environments-testing#environment-dispatch-behavior) pour le comportement de dispatch et les combinaisons de drapeaux qu'il rejette. Nécessite Claude Code v2.1.224 ou ultérieur | `claude -p "Fix the login bug" --environment ccpool_abc123` |90| `--environment <environment-id>` | Créer une nouvelle session cloud qui s'exécute sur l'[environnement auto-hébergé](https://code.claude.com/docs/fr/self-hosted-environments) avec l'ID donné. Les ID d'environnement commencent par `ccpool_`. Voir [comportement de dispatch `--environment`](https://code.claude.com/docs/fr/self-hosted-environments-testing#environment-dispatch-behavior) pour le comportement de dispatch et les combinaisons de drapeaux qu'il rejette. Nécessite Claude Code v2.1.224 ou ultérieur | `claude -p "Fix the login bug" --environment ccpool_abc123` |

91| `--exclude-dynamic-system-prompt-sections` | Déplacer le contexte par utilisateur, tel que l'emplacement de la mémoire automatique, hors de l'invite système et dans le premier message utilisateur. Améliore la réutilisation du cache d'invite sur différents utilisateurs et machines exécutant la même tâche. S'applique uniquement avec l'invite système par défaut ; ignoré lorsque `--system-prompt` ou `--system-prompt-file` est défini. À utiliser avec `-p` pour les charges de travail scriptées multi-utilisateurs | `claude -p --exclude-dynamic-system-prompt-sections "query"` |91| `--exclude-dynamic-system-prompt-sections` | Déplacer le contexte par utilisateur, tel que l'emplacement de la mémoire automatique, hors de l'invite système et dans le premier message utilisateur. Améliore la réutilisation du cache d'invite sur différents utilisateurs et machines exécutant la même tâche. S'applique uniquement avec l'invite système par défaut ; ignoré lorsque `--system-prompt` ou `--system-prompt-file` est défini. À utiliser avec `-p` pour les charges de travail scriptées multi-utilisateurs | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

code-review-local.md +1 −1

Details

33 33

34**2. Continuer à travailler**34**2. Continuer à travailler**

35 35

36La revue s'exécute en tant que [sous-agent](https://code.claude.com/docs/fr/sub-agents.md) en arrière-plan avec sa propre fenêtre de contexte, elle ne remplit donc pas votre conversation. Les résultats arrivent dans votre conversation lorsque la revue est terminée.36Dans une session de terminal, la revue s'exécute en tant que [sous-agent](https://code.claude.com/docs/fr/sub-agents.md) en arrière-plan avec sa propre fenêtre de contexte, elle ne remplit donc pas votre conversation. Les résultats arrivent dans votre conversation lorsque la revue est terminée.

37 37

38**3. Agir sur les résultats**38**3. Agir sur les résultats**

39 39

commands.md +1 −1

Details

59| `/autocompact [auto\|<tokens>]` | Définir la fenêtre de compaction automatique : le niveau de remplissage de la fenêtre de contexte à partir duquel Claude Code compacte automatiquement. Passez une taille comme `500k`, ou `auto` pour revenir à la fenêtre ajustée pour votre modèle. Claude Code enregistre la valeur dans les paramètres utilisateur et l'applique à la session en cours. Consultez [Définir la fenêtre de compaction automatique](https://code.claude.com/docs/fr/model-config.md#set-the-auto-compact-window) pour les valeurs acceptées et ce qui la remplace. Sans argument, ouvre une boîte de dialogue qui affiche la fenêtre actuelle. Nécessite Claude Code v2.1.221 ou ultérieure |59| `/autocompact [auto\|<tokens>]` | Définir la fenêtre de compaction automatique : le niveau de remplissage de la fenêtre de contexte à partir duquel Claude Code compacte automatiquement. Passez une taille comme `500k`, ou `auto` pour revenir à la fenêtre ajustée pour votre modèle. Claude Code enregistre la valeur dans les paramètres utilisateur et l'applique à la session en cours. Consultez [Définir la fenêtre de compaction automatique](https://code.claude.com/docs/fr/model-config.md#set-the-auto-compact-window) pour les valeurs acceptées et ce qui la remplace. Sans argument, ouvre une boîte de dialogue qui affiche la fenêtre actuelle. Nécessite Claude Code v2.1.221 ou ultérieure |

60| `/autofix-pr [prompt]` | Lancer une [session cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md#auto-fix-pull-requests) qui surveille la PR de la branche actuelle et pousse des correctifs lorsque la CI échoue ou que des relecteurs laissent des commentaires. Détecte la PR ouverte à partir de votre branche extraite avec `gh pr view` ; pour surveiller une autre PR, extrayez d'abord sa branche. Par défaut, la session cloud a pour consigne de corriger chaque échec de CI et chaque commentaire de revue ; passez un prompt pour lui donner d'autres instructions, par exemple `/autofix-pr only fix lint and type errors`. Nécessite la CLI `gh` et l'accès aux [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md) |60| `/autofix-pr [prompt]` | Lancer une [session cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md#auto-fix-pull-requests) qui surveille la PR de la branche actuelle et pousse des correctifs lorsque la CI échoue ou que des relecteurs laissent des commentaires. Détecte la PR ouverte à partir de votre branche extraite avec `gh pr view` ; pour surveiller une autre PR, extrayez d'abord sa branche. Par défaut, la session cloud a pour consigne de corriger chaque échec de CI et chaque commentaire de revue ; passez un prompt pour lui donner d'autres instructions, par exemple `/autofix-pr only fix lint and type errors`. Nécessite la CLI `gh` et l'accès aux [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md) |

61| `/background [prompt]` | Détacher la session en cours pour l'exécuter en tant qu'[agent en arrière-plan](https://code.claude.com/docs/fr/agent-view.md) et libérer ce terminal. Passez un prompt pour envoyer une dernière instruction avant le détachement. Surveillez la session avec `claude agents`. Pour copier la conversation dans une nouvelle session en arrière-plan tout en laissant celle-ci s'exécuter, utilisez `/fork`. Alias : `/bg` |61| `/background [prompt]` | Détacher la session en cours pour l'exécuter en tant qu'[agent en arrière-plan](https://code.claude.com/docs/fr/agent-view.md) et libérer ce terminal. Passez un prompt pour envoyer une dernière instruction avant le détachement. Surveillez la session avec `claude agents`. Pour copier la conversation dans une nouvelle session en arrière-plan tout en laissant celle-ci s'exécuter, utilisez `/fork`. Alias : `/bg` |

62| `/batch <instruction>` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Orchestrer en parallèle des modifications à grande échelle dans une base de code. Analyse la base de code, décompose le travail en 5 à 30 unités indépendantes et présente un plan. Une fois celui-ci approuvé, lance un [sous-agent en arrière-plan](https://code.claude.com/docs/fr/sub-agents.md#run-subagents-in-foreground-or-background) par unité dans un [worktree](https://code.claude.com/docs/fr/worktrees.md) isolé. Chaque sous-agent implémente son unité, exécute les tests et publie sa modification. Nécessite un dépôt git ou un [hook `WorktreeCreate`](https://code.claude.com/docs/fr/worktrees#non-git-version-control) qui crée les worktrees. En dehors d'un dépôt git, `/batch` nécessite Claude Code v2.1.281 ou ultérieure. Exemple : `/batch migrate src/ from JavaScript to TypeScript` |62| `/batch <instruction>` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Orchestrer en parallèle des modifications à grande échelle dans une base de code. Analyse la base de code, décompose le travail en 5 à 30 unités indépendantes et présente un plan. Une fois celui-ci approuvé, lance un [sous-agent en arrière-plan](https://code.claude.com/docs/fr/sub-agents.md#run-subagents-in-foreground-or-background) par unité dans un [worktree](https://code.claude.com/docs/fr/worktrees.md) isolé. Chaque sous-agent implémente son unité, exécute les tests, puis ouvre une PR ou rend compte de ce qui s'est passé. Nécessite un dépôt git ou un [hook `WorktreeCreate`](https://code.claude.com/docs/fr/worktrees#non-git-version-control) qui crée les worktrees. En dehors d'un dépôt git, `/batch` nécessite Claude Code v2.1.281 ou ultérieure. Exemple : `/batch migrate src/ from JavaScript to TypeScript` |

63| `/branch [name]` | Créer une branche de la conversation actuelle à ce stade, afin d'essayer une autre direction sans perdre la conversation telle qu'elle est. Vous bascule dans la branche et conserve l'originale, à laquelle vous pouvez revenir avec `/resume`. Pour exécuter une copie en tant que [session en arrière-plan](https://code.claude.com/docs/fr/agent-view.md) distincte au lieu d'y basculer, utilisez `/fork` ; pour confier une tâche annexe à un [sous-agent](https://code.claude.com/docs/fr/sub-agents.md) qui rend compte dans cette conversation, utilisez `/subtask` |63| `/branch [name]` | Créer une branche de la conversation actuelle à ce stade, afin d'essayer une autre direction sans perdre la conversation telle qu'elle est. Vous bascule dans la branche et conserve l'originale, à laquelle vous pouvez revenir avec `/resume`. Pour exécuter une copie en tant que [session en arrière-plan](https://code.claude.com/docs/fr/agent-view.md) distincte au lieu d'y basculer, utilisez `/fork` ; pour confier une tâche annexe à un [sous-agent](https://code.claude.com/docs/fr/sub-agents.md) qui rend compte dans cette conversation, utilisez `/subtask` |

64| `/btw [question]` | Poser une [question annexe](https://code.claude.com/docs/fr/interactive-mode.md#side-questions-with-%2Fbtw) sur la session en cours sans l'ajouter à la conversation. Si vous exécutez `/btw` sans question, Claude Code affiche votre question annexe la plus récente pour que vous puissiez parcourir les réponses précédentes ; si vous n'en avez pas encore posé, Claude Code affiche une ligne d'utilisation |64| `/btw [question]` | Poser une [question annexe](https://code.claude.com/docs/fr/interactive-mode.md#side-questions-with-%2Fbtw) sur la session en cours sans l'ajouter à la conversation. Si vous exécutez `/btw` sans question, Claude Code affiche votre question annexe la plus récente pour que vous puissiez parcourir les réponses précédentes ; si vous n'en avez pas encore posé, Claude Code affiche une ligne d'utilisation |

65| `/bug [report]` | Signaler un bug ou partager votre conversation. Vous choisissez la quantité d'historique de session à inclure et confirmez sur un écran de consentement avant tout envoi. Lorsque vous êtes connecté à Anthropic via une connexion first-party, le rapport est envoyé à Anthropic ; sur un fournisseur tiers, ou sans identifiants Anthropic, Claude Code écrit le rapport dans une [archive locale sous `~/.claude/feedback-bundles/`](https://code.claude.com/docs/fr/data-usage#telemetry-services) que vous transmettez vous-même. Dans l'[extension VS Code](https://code.claude.com/docs/fr/vs-code.md#use-the-prompt-box), `/bug` ouvre plutôt la boîte de dialogue de feedback propre à l'extension ; nécessite Claude Code v2.1.229 ou ultérieure. Lorsque vous l'exécutez pendant que Claude répond, Claude Code ouvre immédiatement la boîte de dialogue. Avant la v2.1.232, Claude Code mettait la commande en file d'attente jusqu'à la fin du tour. Alias : `/share`. Avant la v2.1.212, `/bug` et `/share` étaient des alias de `/feedback` |65| `/bug [report]` | Signaler un bug ou partager votre conversation. Vous choisissez la quantité d'historique de session à inclure et confirmez sur un écran de consentement avant tout envoi. Lorsque vous êtes connecté à Anthropic via une connexion first-party, le rapport est envoyé à Anthropic ; sur un fournisseur tiers, ou sans identifiants Anthropic, Claude Code écrit le rapport dans une [archive locale sous `~/.claude/feedback-bundles/`](https://code.claude.com/docs/fr/data-usage#telemetry-services) que vous transmettez vous-même. Dans l'[extension VS Code](https://code.claude.com/docs/fr/vs-code.md#use-the-prompt-box), `/bug` ouvre plutôt la boîte de dialogue de feedback propre à l'extension ; nécessite Claude Code v2.1.229 ou ultérieure. Lorsque vous l'exécutez pendant que Claude répond, Claude Code ouvre immédiatement la boîte de dialogue. Avant la v2.1.232, Claude Code mettait la commande en file d'attente jusqu'à la fin du tour. Alias : `/share`. Avant la v2.1.212, `/bug` et `/share` étaient des alias de `/feedback` |

env-vars.md +3 −3

Details

335| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Définir sur `1` pour écrire la sortie du terminal via un second descripteur de fichier non bloquant, afin qu'un terminal qui cesse de lire, comme un volet tmux en mode contrôle mis en pause ou une connexion SSH bloquée, ne puisse pas figer Claude Code en cours de session. S'applique sur macOS, Linux et WSL lorsque stdout est un terminal. Nécessite Claude Code v2.1.261 ou ultérieur |335| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Définir sur `1` pour écrire la sortie du terminal via un second descripteur de fichier non bloquant, afin qu'un terminal qui cesse de lire, comme un volet tmux en mode contrôle mis en pause ou une connexion SSH bloquée, ne puisse pas figer Claude Code en cours de session. S'applique sur macOS, Linux et WSL lorsque stdout est un terminal. Nécessite Claude Code v2.1.261 ou ultérieur |

336| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limite le nombre de fois où Claude Code renvoie une [requête sans streaming](https://code.claude.com/docs/fr/errors.md#streaming-response-ended-before-any-complete-data-was-received) qui expire. Avec `0`, la requête échoue dès la première expiration. Voir [Ajuster le comportement des nouvelles tentatives](https://code.claude.com/docs/fr/errors.md#tune-retry-behavior) pour le délai d'expiration. Nécessite Claude Code v2.1.285 ou ultérieur |336| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limite le nombre de fois où Claude Code renvoie une [requête sans streaming](https://code.claude.com/docs/fr/errors.md#streaming-response-ended-before-any-complete-data-was-received) qui expire. Avec `0`, la requête échoue dès la première expiration. Voir [Ajuster le comportement des nouvelles tentatives](https://code.claude.com/docs/fr/errors.md#tune-retry-behavior) pour le délai d'expiration. Nécessite Claude Code v2.1.285 ou ultérieur |

337| `CLAUDE_CODE_NO_FLICKER` | Définir sur `1` pour activer le [rendu plein écran](https://code.claude.com/docs/fr/fullscreen.md), une research preview qui réduit le scintillement et maintient une consommation mémoire stable dans les longues conversations. Remplace le paramètre [`tui`](https://code.claude.com/docs/fr/settings-reference#tui) ; vous pouvez également basculer avec `/tui fullscreen` |337| `CLAUDE_CODE_NO_FLICKER` | Définir sur `1` pour activer le [rendu plein écran](https://code.claude.com/docs/fr/fullscreen.md), une research preview qui réduit le scintillement et maintient une consommation mémoire stable dans les longues conversations. Remplace le paramètre [`tui`](https://code.claude.com/docs/fr/settings-reference#tui) ; vous pouvez également basculer avec `/tui fullscreen` |

338| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Jeton d'actualisation OAuth pour l'authentification Claude.ai. Lorsqu'il est défini, `claude auth login` échange directement ce jeton au lieu d'ouvrir un navigateur. Nécessite `CLAUDE_CODE_OAUTH_SCOPES`. Utile pour provisionner l'authentification dans des environnements automatisés |338| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Jeton d'actualisation OAuth pour l'authentification claude.ai. Lorsqu'il est défini, `claude auth login` échange directement ce jeton au lieu d'ouvrir un navigateur. Nécessite `CLAUDE_CODE_OAUTH_SCOPES`. Utile pour provisionner l'authentification dans des environnements automatisés. Ignoré dans les [paramètres de projet et locaux](https://code.claude.com/docs/fr/settings-reference.md#variables-claude-code-ignores-in-env) |

339| `CLAUDE_CODE_OAUTH_SCOPES` | Scopes OAuth séparés par des espaces avec lesquels le jeton d'actualisation a été émis, par exemple `"user:profile user:inference user:sessions:claude_code"`. Requise lorsque `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` est défini |339| `CLAUDE_CODE_OAUTH_SCOPES` | Scopes OAuth séparés par des espaces avec lesquels le jeton d'actualisation a été émis, comme `"user:profile user:inference user:sessions:claude_code"`. Requis lorsque `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` est défini. Ignoré dans les [paramètres de projet et locaux](https://code.claude.com/docs/fr/settings-reference.md#variables-claude-code-ignores-in-env) |

340| `CLAUDE_CODE_OAUTH_TOKEN` | Jeton d'accès OAuth pour l'authentification claude.ai. Alternative à `/login` pour le SDK et les environnements automatisés. A priorité sur les identifiants stockés dans le trousseau. Générez-en un avec [`claude setup-token`](https://code.claude.com/docs/fr/authentication#generate-a-long-lived-token). Sauf si vous exécutez [`/login`](https://code.claude.com/docs/fr/authentication#authentication-precedence), Claude Code utilise le jeton que vous avez défini pendant toute la session. Pour remplacer un jeton expiré, générez-en un nouveau et redémarrez |340| `CLAUDE_CODE_OAUTH_TOKEN` | Jeton d'accès OAuth pour l'authentification claude.ai. Alternative à `/login` pour le SDK et les environnements automatisés. Ignoré dans les [paramètres de projet et locaux](https://code.claude.com/docs/fr/settings-reference.md#variables-claude-code-ignores-in-env). A priorité sur les identifiants stockés dans le trousseau. Générez-en un avec [`claude setup-token`](https://code.claude.com/docs/fr/authentication#generate-a-long-lived-token). À moins que vous n'exécutiez [`/login`](https://code.claude.com/docs/fr/authentication#authentication-precedence), Claude Code utilise le jeton que vous définissez pendant toute la session. Pour remplacer un jeton expiré, générez-en un nouveau et redémarrez |

341| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Supprimée dans la v2.1.160 et désormais sans effet. Épinglait auparavant le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) sur Claude Opus 4.6 au lieu du modèle par défaut actuel. Opus 4.6 ne prend plus en charge le mode rapide |341| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Supprimée dans la v2.1.160 et désormais sans effet. Épinglait auparavant le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) sur Claude Opus 4.6 au lieu du modèle par défaut actuel. Opus 4.6 ne prend plus en charge le mode rapide |

342| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Longueur maximale des attributs OpenTelemetry porteurs de contenu (réponses du modèle, contenu des outils, prompts système, corps bruts de l'API), marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, soit 60 Ko). Augmentez-la uniquement si votre backend de télémétrie accepte des valeurs d'attribut supérieures à 64 Ko, ou diminuez-la pour réduire le volume de télémétrie. Nécessite Claude Code v2.1.214 ou ultérieur. Voir [Surveillance](https://code.claude.com/docs/fr/monitoring-usage.md) |342| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Longueur maximale des attributs OpenTelemetry porteurs de contenu (réponses du modèle, contenu des outils, prompts système, corps bruts de l'API), marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, soit 60 Ko). Augmentez-la uniquement si votre backend de télémétrie accepte des valeurs d'attribut supérieures à 64 Ko, ou diminuez-la pour réduire le volume de télémétrie. Nécessite Claude Code v2.1.214 ou ultérieur. Voir [Surveillance](https://code.claude.com/docs/fr/monitoring-usage.md) |

343| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Définir sur `1` pour écrire les erreurs de diagnostic de l'exportateur OpenTelemetry sur stderr. Par défaut, ces erreurs n'apparaissent qu'avec `--debug`, de sorte qu'un exportateur mal configuré, par exemple en cas de collision de port Prometheus, échoue sinon silencieusement. Nécessite Claude Code v2.1.179 ou ultérieur. Voir [Surveillance](https://code.claude.com/docs/fr/monitoring-usage.md) |343| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Définir sur `1` pour écrire les erreurs de diagnostic de l'exportateur OpenTelemetry sur stderr. Par défaut, ces erreurs n'apparaissent qu'avec `--debug`, de sorte qu'un exportateur mal configuré, par exemple en cas de collision de port Prometheus, échoue sinon silencieusement. Nécessite Claude Code v2.1.179 ou ultérieur. Voir [Surveillance](https://code.claude.com/docs/fr/monitoring-usage.md) |

errors.md +25 −6

Details

66| `This organization has been disabled` | [Authentification](#this-organization-has-been-disabled) |66| `This organization has been disabled` | [Authentification](#this-organization-has-been-disabled) |

67| `Your organization has disabled API key authentication` | [Authentification](#your-organization-has-disabled-api-key-authentication) |67| `Your organization has disabled API key authentication` | [Authentification](#your-organization-has-disabled-api-key-authentication) |

68| `Your organization has disabled Claude subscription access` | [Authentification](#your-organization-has-disabled-claude-subscription-access) |68| `Your organization has disabled Claude subscription access` | [Authentification](#your-organization-has-disabled-claude-subscription-access) |

~~69| `Routines are disabled by your organization's policy` | [Authentification](#routines-are-disabled-by-your-organizations-policy) |~~69| `Scheduled tasks are off for your organization` | [Authentification](#routines-are-disabled-by-your-organizations-policy) |

70| `Routines are off for your organization` | [Authentification](#routines-are-disabled-by-your-organizations-policy) |

70| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentification](#remote-control-requires-the-anthropic-api) |71| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentification](#remote-control-requires-the-anthropic-api) |

71| `OAuth token refresh failed — run /login to re-authenticate` | [Authentification](#remote-control-couldnt-refresh-your-login) |72| `OAuth token refresh failed — run /login to re-authenticate` | [Authentification](#remote-control-couldnt-refresh-your-login) |

72| `JWT refresh failed: no OAuth token — run /login` | [Authentification](#remote-control-couldnt-refresh-your-login) |73| `JWT refresh failed: no OAuth token — run /login` | [Authentification](#remote-control-couldnt-refresh-your-login) |

755Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.756Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

756```757```

757 758

759Certains refus ne comptent pas dans les dix, notamment [un refus dû à la modification d'un hook ou d'un mod](#hook-changed-input-after-review).

760

758Le message d'arrêt apparaît à un endroit différent dans chaque type de session :761Le message d'arrêt apparaît à un endroit différent dans chaque type de session :

759 762

760* Dans une session interactive, le message apparaît comme un avertissement dans la transcription et le tour se termine763* Dans une session interactive, le message apparaît comme un avertissement dans la transcription et le tour se termine

774 777

775Avant v2.1.302, sur une connexion directe à l'API Anthropic, Claude Code ne compactait pas une conversation devenue trop longue pour la vérification du serveur.778Avant v2.1.302, sur une connexion directe à l'API Anthropic, Claude Code ne compactait pas une conversation devenue trop longue pour la vérification du serveur.

776 779

780#### `a hook changed this call's input after auto mode reviewed it`

781

782Ce refus signifie qu'un hook ou un mod a [modifié l'entrée de l'appel](https://code.claude.com/docs/fr/hooks.md#pretooluse-updatedinput-in-auto-mode) après que le serveur l'a examinée, de sorte que l'examen ne couvre pas ce qui serait exécuté. Ce n'est pas un jugement selon lequel l'action est dangereuse.

783

784Les appels suivants dans la même réponse de Claude peuvent être refusés avec ce motif :

785

786```text theme={null}

787another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged

788```

789

790Claude peut alors émettre à nouveau chaque appel refusé afin que le serveur l'examine. Si une demande de permission s'ouvre, répondez-y. Vous n'avez rien d'autre à faire, sauf si Claude indique dans sa réponse que le mode auto n'a pas pu vérifier l'appel. Dans ce cas, arrêtez la modification ou approuvez l'appel vous-même, puis demandez à Claude de réessayer l'appel :

791

792* **Arrêter la modification** : désactivez le [hook](https://code.claude.com/docs/fr/hooks.md#disable-or-remove-hooks) ou le [mod](https://code.claude.com/docs/fr/plugins/mods/overview.md#turn-mods-on-or-off) qui a modifié l'appel ou un appel antérieur dans la même réponse de Claude, ou demandez à votre administrateur de le désactiver. Pour rechercher un hook, exécutez [`/hooks`](https://code.claude.com/docs/fr/hooks#the-%2Fhooks-menu) à l'invite de Claude Code. Dans une session de terminal, exécutez `/plugin` pour voir les mods actifs.

793* **Approuver l'appel vous-même** : [passez au mode Manual](https://code.claude.com/docs/fr/permission-modes.md#switch-permission-modes)

794

777### Was not reviewed and did not run795### Was not reviewed and did not run

778 796

779Un refus `was not reviewed and did not run` signifie que la conversation est trop longue pour que le classificateur du [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode) vérifie l'action, donc l'action ne s'est pas exécutée. Claude Code retourne ce message à Claude :797Un refus `was not reviewed and did not run` signifie que la conversation est trop longue pour que le classificateur du [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode) vérifie l'action, donc l'action ne s'est pas exécutée. Claude Code retourne ce message à Claude :

1188* Authentifiez-vous avec une clé API Console plutôt qu'avec votre abonnement. Consultez [Authentification Claude Console](https://code.claude.com/docs/fr/authentication.md#claude-console-authentication) pour la configuration.1206* Authentifiez-vous avec une clé API Console plutôt qu'avec votre abonnement. Consultez [Authentification Claude Console](https://code.claude.com/docs/fr/authentication.md#claude-console-authentication) pour la configuration.

1189* Si vous êtes l'administrateur et ne voyez pas d'option pour activer l'accès, contactez le [support Anthropic](https://support.claude.com)1207* Si vous êtes l'administrateur et ne voyez pas d'option pour activer l'accès, contactez le [support Anthropic](https://support.claude.com)

1190 1208

1191### Les routines sont désactivées par la politique de votre organisation1209### Scheduled tasks are off for your organization

1192 1210

1193Un Owner de votre organisation Team ou Enterprise a désactivé les [tâches planifiées cloud](https://code.claude.com/docs/fr/routines.md), anciennement routines, au niveau de l'organisation. L'erreur apparaît lorsque vous essayez d'en créer ou d'en exécuter une, par exemple sur [claude.ai/code/routines](https://claude.ai/code/routines). Sur Claude Code v2.1.227 ou ultérieure, le même paramètre [masque également `/schedule`](https://code.claude.com/docs/fr/routines#troubleshooting) dans la CLI.1211Les [tâches planifiées cloud](https://code.claude.com/docs/fr/routines.md) sont désactivées pour votre organisation ; vous ne pouvez donc ni en créer ni en exécuter. Le message de claude.ai les appelle tâches planifiées ou routines, et il est suivi d'une phrase concernant votre administrateur :

1194 1212

1195```text theme={null}1213```text theme={null}

1196Routines are disabled by your organization's policy.1214Scheduled tasks are off for your organization. …

1215Routines are off for your organization. …

1197```1216```

1198 1217

1199Il s'agit d'un paramètre côté serveur, qui ne peut donc pas être remplacé par des paramètres locaux, des variables d'environnement ou des flags CLI.1218Vous ne pouvez pas les activer avec des paramètres locaux, des variables d'environnement ou des flags de la CLI.

1200 1219

1201**Que faire :**1220**Que faire :**

1202 1221

1203* Demandez à un Owner de votre organisation d'activer l'option **Scheduled tasks (Was Routines)** dans [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities)1222* Demandez au propriétaire (Owner) de votre plan Team ou Enterprise s'il peut activer l'option intitulée **Scheduled tasks (Was Routines)** ou **Routines** dans [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities)

1204 1223

1205### Remote Control nécessite l'API Anthropic1224### Remote Control nécessite l'API Anthropic

1206 1225

google-vertex-ai.md +7 −3

Details

197* **Si vous acceptez** : Claude Code écrit le nouvel ID de modèle dans votre [fichier de paramètres utilisateur](https://code.claude.com/docs/fr/settings.md) et redémarre197* **Si vous acceptez** : Claude Code écrit le nouvel ID de modèle dans votre [fichier de paramètres utilisateur](https://code.claude.com/docs/fr/settings.md) et redémarre

198* **Si vous refusez** : Claude Code mémorise votre choix jusqu'au prochain changement de version par défaut198* **Si vous refusez** : Claude Code mémorise votre choix jusqu'au prochain changement de version par défaut

199 199

200Pour une épingle dans le bloc `env` des [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md), Claude Code n'exécute aucune vérification et n'affiche aucune demande.200Pour une épingle dans le bloc `env` des [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md), Claude Code n'exécute aucune vérification et n'affiche aucune demande. Si la demande de mise à jour apparaît toujours pour cette épingle, mettez à jour Claude Code vers la v2.1.314 ou ultérieure. Avant la v2.1.314, l'épingle gérée restait en vigueur après votre acceptation, de sorte que la demande réapparaissait au démarrage suivant.

201 201

202Si vous n'avez pas épinglé un modèle et que la valeur par défaut actuelle n'est pas disponible dans votre projet, Claude Code revient à la version précédente pour la session actuelle et affiche un avis. Il essaie d'abord les versions antérieures du modèle par défaut et, lorsque la valeur par défaut est un modèle Opus et qu'aucune version Opus n'est disponible, revient au modèle Sonnet par défaut. Le retour n'est pas persistant. Activez le modèle plus récent dans [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) ou [épinglez une version](#5-pin-model-versions) pour rendre le choix permanent.202Si vous n'avez pas épinglé un modèle et que la valeur par défaut actuelle n'est pas disponible dans votre projet, Claude Code revient à la version précédente pour la session actuelle et affiche un avis. Il essaie d'abord les versions antérieures du modèle par défaut et, lorsque la valeur par défaut est un modèle Opus et qu'aucune version Opus n'est disponible, revient au modèle Sonnet par défaut. Le retour n'est pas persistant. Activez le modèle plus récent dans [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) ou [épinglez une version](#5-pin-model-versions) pour rendre le choix permanent.

203 203

204### Démarrer une session sur un modèle spécifique

205

204Lorsque vous démarrez la session sur une version spécifique de Sonnet ou Opus, par exemple avec `--model`, `ANTHROPIC_MODEL`, ou le [paramètre `model`](https://code.claude.com/docs/fr/settings-reference#model), cette version agit comme la valeur par défaut épinglée de la session pour l'alias `sonnet` ou `opus` correspondant. Claude Code ignore la vérification de disponibilité pour la valeur par défaut intégrée que votre modèle remplace et démarre sur le modèle que vous avez configuré, sans avis de retour.206Lorsque vous démarrez la session sur une version spécifique de Sonnet ou Opus, par exemple avec `--model`, `ANTHROPIC_MODEL`, ou le [paramètre `model`](https://code.claude.com/docs/fr/settings-reference#model), cette version agit comme la valeur par défaut épinglée de la session pour l'alias `sonnet` ou `opus` correspondant. Claude Code ignore la vérification de disponibilité pour la valeur par défaut intégrée que votre modèle remplace et démarre sur le modèle que vous avez configuré, sans avis de retour.

205 207

206Les alias de modèle tels que `opus` n'agissent pas comme des épingles, et il en va de même pour un ID de modèle que Claude Code ne reconnaît pas.208Lorsque vous démarrez une session sur un alias de modèle tel que `opus` ou sur un ID de modèle que Claude Code ne reconnaît pas, cette valeur n'agit pas comme une épingle.

209

210### Refus de modèle mémorisés

207 211

208Lorsque ces vérifications trouvent un modèle que votre projet ne peut pas invoquer, Claude Code mémorise le refus sur cette machine pendant jusqu'à un jour, et au cours de ce laps de temps, il ignore le modèle mémorisé sans demander à Agent Platform à nouveau. Claude Code vérifie un refus mémorisé d'un modèle par défaut actuel à nouveau au lancement une fois dix minutes se sont écoulées depuis la dernière vérification, de sorte qu'une valeur par défaut que votre administrateur réactive revient. Pour désactiver la mémoire, définissez [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/fr/env-vars).212Lorsque les vérifications du modèle au démarrage trouvent un modèle que votre projet ne peut pas invoquer, Claude Code peut mémoriser le refus sur cette machine pendant un jour au maximum. Une fois que dix minutes se sont écoulées depuis la dernière vérification, Claude Code vérifie à nouveau au lancement un refus mémorisé d'un modèle par défaut actuel. Une valeur par défaut que votre administrateur réactive revient alors. Pour désactiver la mémoire, définissez [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/fr/env-vars).

209 213

210### Lorsque votre organisation impose une liste d'autorisation de modèles214### Lorsque votre organisation impose une liste d'autorisation de modèles

211 215

hooks.md +19 −2

Details

901 901

902#### Bloquer l'action lorsqu'un hook échoue902#### Bloquer l'action lorsqu'un hook échoue

903 903

904Sur la plupart des événements, lorsqu'un hook échoue ou expire, Claude Code exécute quand même l'action. Un hook de politique avec un chemin erroné ou un script qui plante laisse alors tout passer. Pour bloquer l'action à la place, définissez `"onFailure": "block"` sur un hook `command` ou `http`. Nécessite Claude Code v2.1.295 ou ultérieur.904Sur la plupart des événements, lorsqu'un hook échoue ou expire, Claude Code exécute quand même l'action. Un hook de politique avec un chemin erroné ou un script qui plante laisse alors tout passer. Pour bloquer l'action à la place, définissez `"onFailure": "block"` sur un hook `command` ou `http`. Nécessite Claude Code v2.1.295 ou ultérieur. Pour les hooks de rappel Agent SDK, consultez [Bloquer l'action lorsqu'un rappel échoue](https://code.claude.com/docs/fr/agent-sdk/hooks.md#block-the-action-when-a-callback-fails).

905 905

906> [!NOTE]906> [!NOTE]

907>907>

1960| :- | :- |1960| :- | :- |

1961| `permissionDecision` | `"allow"` ignore la demande de permission, sauf pour les [actions qu'aucun mode n'approuve automatiquement](https://code.claude.com/docs/fr/permission-modes.md#actions-no-mode-auto-approves) et les [lectures depuis des chemins réseau](https://code.claude.com/docs/fr/permissions.md#network-paths). Il n'ignore pas non plus l'approbation des appels aux [outils qu'une application Agent SDK marque `always_ask`](https://code.claude.com/docs/fr/agent-sdk/custom-tools#require-approval-for-specific-tools), sauf si le [mode de permission approuve l'appel](https://code.claude.com/docs/fr/agent-sdk/typescript.md#permission-modes-that-can-approve-an-always_ask-call). `AskUserQuestion` et `ExitPlanMode` nécessitent [`updatedInput` associé à `"allow"`](#allow-with-updatedinput). Pour le mode plan, consultez [Approbations par hook en mode plan](https://code.claude.com/docs/fr/permissions.md#hook-approvals-in-plan-mode). `"deny"` empêche l'appel d'outil. `"ask"` demande à l'utilisateur de confirmer. `"defer"` termine le tour afin que l'outil puisse être repris plus tard, et nécessite le [mode non interactif](#defer-a-tool-call-for-later) avec le flag `-p`. Les [règles de refus et de demande](https://code.claude.com/docs/fr/permissions.md#manage-permissions) sont toujours évaluées, quelle que soit la valeur renvoyée par le hook |1961| `permissionDecision` | `"allow"` ignore la demande de permission, sauf pour les [actions qu'aucun mode n'approuve automatiquement](https://code.claude.com/docs/fr/permission-modes.md#actions-no-mode-auto-approves) et les [lectures depuis des chemins réseau](https://code.claude.com/docs/fr/permissions.md#network-paths). Il n'ignore pas non plus l'approbation des appels aux [outils qu'une application Agent SDK marque `always_ask`](https://code.claude.com/docs/fr/agent-sdk/custom-tools#require-approval-for-specific-tools), sauf si le [mode de permission approuve l'appel](https://code.claude.com/docs/fr/agent-sdk/typescript.md#permission-modes-that-can-approve-an-always_ask-call). `AskUserQuestion` et `ExitPlanMode` nécessitent [`updatedInput` associé à `"allow"`](#allow-with-updatedinput). Pour le mode plan, consultez [Approbations par hook en mode plan](https://code.claude.com/docs/fr/permissions.md#hook-approvals-in-plan-mode). `"deny"` empêche l'appel d'outil. `"ask"` demande à l'utilisateur de confirmer. `"defer"` termine le tour afin que l'outil puisse être repris plus tard, et nécessite le [mode non interactif](#defer-a-tool-call-for-later) avec le flag `-p`. Les [règles de refus et de demande](https://code.claude.com/docs/fr/permissions.md#manage-permissions) sont toujours évaluées, quelle que soit la valeur renvoyée par le hook |

1962| `permissionDecisionReason` | Pour `"ask"`, affiché à l'utilisateur dans la demande de permission. Lorsque Claude Code [refuse l'appel](https://code.claude.com/docs/fr/headless.md#turn-off-permission-prompts-in-unattended-runs) lors d'une exécution `-p` où personne ne peut répondre à cette demande, Claude lit plutôt la raison dans le résultat de l'outil. Pour `"deny"`, affiché à Claude. Pour `"allow"` et `"defer"`, écrit uniquement dans le [log de débogage](#debug-hooks) |1962| `permissionDecisionReason` | Pour `"ask"`, affiché à l'utilisateur dans la demande de permission. Lorsque Claude Code [refuse l'appel](https://code.claude.com/docs/fr/headless.md#turn-off-permission-prompts-in-unattended-runs) lors d'une exécution `-p` où personne ne peut répondre à cette demande, Claude lit plutôt la raison dans le résultat de l'outil. Pour `"deny"`, affiché à Claude. Pour `"allow"` et `"defer"`, écrit uniquement dans le [log de débogage](#debug-hooks) |

1963| `updatedInput` | Modifie les paramètres d'entrée de l'outil avant l'exécution. Remplace l'intégralité de l'objet d'entrée : incluez donc les champs inchangés en plus des champs modifiés. Claude Code évalue les règles de permission et l'[éligibilité au passage automatique en arrière-plan](https://code.claude.com/docs/fr/tools-reference.md#foreground-commands-that-move-to-the-background) d'une commande Bash par rapport à l'entrée renvoyée par votre hook, et non à celle envoyée par Claude. Combinez-le avec `"allow"` pour approuver automatiquement, ou avec `"ask"` pour montrer l'entrée modifiée à l'utilisateur. Ignoré pour `"defer"` |1963| `updatedInput` | Modifie les paramètres d'entrée de l'outil avant l'exécution. Remplace l'objet d'entrée entier ; incluez donc les champs inchangés avec les champs modifiés. Claude Code évalue les règles de permission et l'[éligibilité au passage automatique en arrière-plan](https://code.claude.com/docs/fr/tools-reference.md#foreground-commands-that-move-to-the-background) d'une commande Bash par rapport à l'entrée renvoyée par votre hook, et non à celle envoyée par Claude. Combinez-le avec `"allow"` pour approuver automatiquement, ou avec `"ask"` pour montrer l'entrée modifiée à l'utilisateur. Ignoré pour `"defer"`. Sans `permissionDecision`, le [mode auto peut refuser l'appel modifié](#pretooluse-updatedinput-in-auto-mode) |

1964| `additionalContext` | Chaîne ajoutée au contexte de Claude en plus du résultat de l'outil. Ignorée lorsque `permissionDecision` vaut `"defer"`. Consultez [Ajouter du contexte pour Claude](#add-context-for-claude) |1964| `additionalContext` | Chaîne ajoutée au contexte de Claude en plus du résultat de l'outil. Ignorée lorsque `permissionDecision` vaut `"defer"`. Consultez [Ajouter du contexte pour Claude](#add-context-for-claude) |

1965 1965

1966Lorsque plusieurs hooks PreToolUse renvoient des décisions différentes, l'ordre de priorité est `deny` > `defer` > `ask` > `allow`.1966Lorsque plusieurs hooks PreToolUse renvoient des décisions différentes, l'ordre de priorité est `deny` > `defer` > `ask` > `allow`.

1987>1987>

1988> PreToolUse utilisait auparavant les champs `decision` et `reason` de premier niveau, mais ceux-ci sont dépréciés pour cet événement. Utilisez plutôt `hookSpecificOutput.permissionDecision` et `hookSpecificOutput.permissionDecisionReason`. Les valeurs dépréciées `"approve"` et `"block"` correspondent respectivement à `"allow"` et `"deny"`. D'autres événements comme PostToolUse et Stop continuent d'utiliser `decision` et `reason` de premier niveau comme format actuel.1988> PreToolUse utilisait auparavant les champs `decision` et `reason` de premier niveau, mais ceux-ci sont dépréciés pour cet événement. Utilisez plutôt `hookSpecificOutput.permissionDecision` et `hookSpecificOutput.permissionDecisionReason`. Les valeurs dépréciées `"approve"` et `"block"` correspondent respectivement à `"allow"` et `"deny"`. D'autres événements comme PostToolUse et Stop continuent d'utiliser `decision` et `reason` de premier niveau comme format actuel.

1989 1989

1990#### `updatedInput` de PreToolUse en mode auto

1991

1992Lorsque votre hook renvoie `updatedInput` sans `permissionDecision` en [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode), Claude Code peut refuser l'appel modifié. [Le serveur a examiné](https://code.claude.com/docs/fr/permission-modes.md#server-side-classifier-review) l'entrée écrite par Claude, et non celle renvoyée par votre hook. Dans les sessions de terminal interactives et les sessions VS Code connectées directement à l'API Anthropic, le refus inclut ce texte :

1993

1994```text theme={null}

1995a hook changed this call's input after auto mode reviewed it

1996```

1997

1998Après un refus comportant ce texte, Claude peut émettre à nouveau l'appel modifié afin que le serveur l'examine. Si Claude répète exactement l'entrée modifiée dans sa réponse suivante, votre hook s'exécute toujours :

1999

2000* Il peut refuser l'appel ou l'envoyer vers la demande de permission

2001* Tout `updatedInput` qu'il renvoie est ignoré ; ce qui s'exécute est donc ce que le serveur a examiné

2002

2003Vous n'avez pas besoin de modifier votre hook en raison de ce refus, sauf si [Claude vous indique dans sa réponse que le mode auto n'a pas pu vérifier l'appel](https://code.claude.com/docs/fr/errors.md#hook-changed-input-after-review).

2004

2005Dans les sessions qui affichent ce texte, un [hook `command`](#command-hook-fields) défini dans les paramètres ou dans le fichier de hooks d'un plugin peut modifier les appels Bash, PowerShell, Monitor, Edit, Write et NotebookEdit sans provoquer ce refus. Le refus peut tout de même apparaître, par exemple lorsqu'un hook a modifié un appel antérieur dans la même réponse de Claude ou lorsqu'une commande Bash demande à s'exécuter en dehors du sandbox.

2006

1990#### Décisions `ask` de PreToolUse en mode auto2007#### Décisions `ask` de PreToolUse en mode auto

1991 2008

1992En [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode), le `"ask"` d'un hook PreToolUse envoie normalement l'appel d'outil vers la demande de permission, et le [classifieur](https://code.claude.com/docs/fr/permission-modes.md#how-the-classifier-evaluates-actions) ne statue pas dessus. Certains appels suivent un chemin différent :2009En [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode), le `"ask"` d'un hook PreToolUse envoie normalement l'appel d'outil vers la demande de permission, et le [classifieur](https://code.claude.com/docs/fr/permission-modes.md#how-the-classifier-evaluates-actions) ne statue pas dessus. Certains appels suivent un chemin différent :

interactive-mode.md +4 −4

Details

287 287

288### Recherche inversée avec Ctrl+R288### Recherche inversée avec Ctrl+R

289 289

290Appuyez sur `Ctrl+R` pour effectuer une recherche interactive dans votre historique de commandes. En [rendu plein écran](https://code.claude.com/docs/fr/fullscreen.md), `Ctrl+R` ouvre plutôt une boîte de dialogue de recherche : tapez pour filtrer, appuyez sur `Up` et `Down` pour parcourir les correspondances, et appuyez sur `Ctrl+S` pour faire défiler la portée entre cette session, ce projet et tous les projets. Appuyez sur `Enter` ou `Tab` pour placer une correspondance dans la saisie du prompt, ou sur `Esc` pour annuler. Les étapes ci-dessous décrivent la recherche en ligne du moteur de rendu classique :290Appuyez sur `Ctrl+R` pour effectuer une recherche interactive dans votre historique de commandes. En [rendu plein écran](https://code.claude.com/docs/fr/fullscreen.md), `Ctrl+R` ouvre plutôt une boîte de dialogue de recherche. Tapez pour filtrer dans la boîte de dialogue, et appuyez sur `Up` et `Down` pour parcourir la liste des correspondances, un volet d'aperçu affichant le début de la correspondance en surbrillance.

291

292Dans la boîte de dialogue, appuyez sur `Ctrl+S` pour faire défiler la portée entre cette session, ce projet et tous les projets. Appuyez sur `Enter` ou `Tab` pour placer une correspondance dans la saisie du prompt, ou sur `Esc` pour annuler. Les étapes ci-dessous décrivent la recherche en ligne du moteur de rendu classique :

291 293

2921. **Démarrer la recherche** : appuyez sur `Ctrl+R` pour activer la recherche inversée dans l'historique2941. **Démarrer la recherche** : appuyez sur `Ctrl+R` pour activer la recherche inversée dans l'historique

2932. **Saisir la requête** : entrez le texte à rechercher dans les commandes précédentes. Le terme recherché est mis en surbrillance dans les résultats correspondants2952. **Saisir la requête** : entrez le texte à rechercher dans les commandes précédentes. La correspondance actuelle apparaît dans la saisie du prompt.

2943. **Parcourir les correspondances** : appuyez à nouveau sur `Ctrl+R` pour faire défiler les correspondances plus anciennes2963. **Parcourir les correspondances** : appuyez à nouveau sur `Ctrl+R` pour faire défiler les correspondances plus anciennes

2954. **Portée de la recherche** : la recherche en ligne porte toujours sur les prompts de tous les projets2974. **Portée de la recherche** : la recherche en ligne porte toujours sur les prompts de tous les projets

2965. **Accepter une correspondance** :2985. **Accepter une correspondance** :

300 * Appuyez sur `Ctrl+C` pour annuler et restaurer votre saisie d'origine302 * Appuyez sur `Ctrl+C` pour annuler et restaurer votre saisie d'origine

301 * Appuyez sur `Backspace` sur une recherche vide pour annuler303 * Appuyez sur `Backspace` sur une recherche vide pour annuler

302 304

303La recherche en ligne parcourt l'intégralité de votre historique de prompts, du plus récent au plus ancien, les doublons étant regroupés sous leur occurrence la plus récente. La boîte de dialogue plein écran recherche dans l'ensemble de votre historique de prompts dans la portée sélectionnée, du plus récent au plus ancien, les doublons étant regroupés sous leur occurrence la plus récente : les prompts les plus récents apparaissent immédiatement, et les correspondances issues de prompts plus anciens s'ajoutent à mesure que Claude Code charge le reste. Les prompts correspondants s'affichent avec le terme recherché en surbrillance, ce qui vous permet de retrouver et de réutiliser des saisies précédentes.

~~304~~

305Accepter une correspondance ou annuler la recherche prend effet immédiatement, même pendant que Claude Code charge encore l'historique.305Accepter une correspondance ou annuler la recherche prend effet immédiatement, même pendant que Claude Code charge encore l'historique.

306 306

307## Commandes Bash en arrière-plan307## Commandes Bash en arrière-plan

jetbrains.md +5 −1

Details

33 33

34**1. Installer la CLI Claude Code**34**1. Installer la CLI Claude Code**

35 35

36Suivez le [guide de démarrage rapide](https://code.claude.com/docs/fr/quickstart.md) pour installer la CLI si vous ne l'avez pas déjà fait. Le plugin affiche une notification ' Impossible de lancer Claude Code ' lorsque `claude` ne se trouve pas sur votre PATH.36Suivez le [guide de démarrage rapide](https://code.claude.com/docs/fr/quickstart.md) pour installer la CLI si vous ne l'avez pas déjà fait. Le plugin affiche une notification « Impossible de lancer Claude Code » lorsque `claude` ne se trouve pas sur votre PATH.

37 37

38**2. Installer le plugin JetBrains**38**2. Installer le plugin JetBrains**

39 39

40Installez le [plugin Claude Code](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) depuis la Marketplace JetBrains et redémarrez votre IDE.40Installez le [plugin Claude Code](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) depuis la Marketplace JetBrains et redémarrez votre IDE.

41 41

42> [!NOTE]

43>

44> La Marketplace JetBrains est un logiciel tiers qu'Anthropic n'approuve pas, ne maintient pas et n'audite pas. Anthropic soumet le plugin Claude Code pour publication sur la Marketplace JetBrains.

42Si `claude` est installé quelque part que votre IDE ne peut pas trouver, définissez le chemin complet dans les [paramètres de commande Claude](#general-settings) du plugin.46Si `claude` est installé quelque part que votre IDE ne peut pas trouver, définissez le chemin complet dans les [paramètres de commande Claude](#general-settings) du plugin.

43 47

44Claude Code fonctionne avec n'importe quel abonnement Claude payant (Pro, Max, Ultra, Team ou Enterprise) ou un compte Claude Console, et aucune clé API n'est requise. Vous serez invité à [vous connecter](https://code.claude.com/docs/fr/authentication.md#log-in-to-claude-code) la première fois que vous exécutez `claude`.48Claude Code fonctionne avec n'importe quel abonnement Claude payant (Pro, Max, Ultra, Team ou Enterprise) ou un compte Claude Console, et aucune clé API n'est requise. Vous serez invité à [vous connecter](https://code.claude.com/docs/fr/authentication.md#log-in-to-claude-code) la première fois que vous exécutez `claude`.

llm-gateway-protocol.md +1 −1

Details

278 278

279Sur v2.1.305 ou ultérieur, Claude Code renvoie une requête sans les [champs `defer_loading` et les blocs `tool_reference`](https://code.claude.com/docs/fr/mcp#tool-search-through-a-gateway) après une erreur `400` ou `422` qui nomme la recherche d'outils ou dont il ne reconnaît pas la cause. Après une nouvelle tentative réussie, les requêtes ultérieures de cette conversation les omettent également.279Sur v2.1.305 ou ultérieur, Claude Code renvoie une requête sans les [champs `defer_loading` et les blocs `tool_reference`](https://code.claude.com/docs/fr/mcp#tool-search-through-a-gateway) après une erreur `400` ou `422` qui nomme la recherche d'outils ou dont il ne reconnaît pas la cause. Après une nouvelle tentative réussie, les requêtes ultérieures de cette conversation les omettent également.

280 280

281Les requêtes du développeur continuent de fonctionner sans aucune modification de la passerelle, avec leurs outils MCP chargés dès le départ. Lorsque Claude Code essaie de nouveau la recherche d'outils, la passerelle voit une autre requête rejetée suivie de sa nouvelle tentative. Pour la recherche d'outils elle-même, Claude Code s'attend à ce que la passerelle transmette les champs `defer_loading` et les blocs `tool_reference` avec leur valeur `anthropic-beta`.281Les requêtes du développeur continuent de fonctionner sans aucune modification sur la passerelle, avec leurs outils MCP chargés dès le départ. Lorsque Claude Code tente à nouveau la recherche d'outils, la passerelle peut voir une autre requête rejetée suivie de sa nouvelle tentative. Pour la recherche d'outils elle-même, Claude Code attend de la passerelle qu'elle transmette les champs `defer_loading` et les blocs `tool_reference` avec leur valeur `anthropic-beta`.

282 282

283### Désactiver les capacités de pré-version283### Désactiver les capacités de pré-version

284 284

managed-settings.md +3 −1

Details

171* Les chemins binaires sandbox `sandbox.bwrapPath` et `sandbox.socatPath`171* Les chemins binaires sandbox `sandbox.bwrapPath` et `sandbox.socatPath`

172* Le binaire sandbox `ripgrep`, [`sandbox.ripgrep`](https://code.claude.com/docs/fr/settings-reference#sandbox-ripgrep)172* Le binaire sandbox `ripgrep`, [`sandbox.ripgrep`](https://code.claude.com/docs/fr/settings-reference#sandbox-ripgrep)

173* `sandbox.filesystem.disabled` et `sandbox.network.strictAllowlist`173* `sandbox.filesystem.disabled` et `sandbox.network.strictAllowlist`

174* [`useAutoModeDuringPlan`](https://code.claude.com/docs/fr/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](https://code.claude.com/docs/fr/settings-reference#syncclaudeaiskills), et [`syncClaudeAiPlugins`](https://code.claude.com/docs/fr/settings-reference#syncclaudeaiplugins), où un `false` de n'importe quelle source d'administration désactive le comportement. Un `false` dans les paramètres utilisateur ou local du développeur le désactive également ; chaque clé ne peut que refuser174* [`useAutoModeDuringPlan`](https://code.claude.com/docs/fr/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](https://code.claude.com/docs/fr/settings-reference#syncclaudeaiskills), et [`syncClaudeAiPlugins`](https://code.claude.com/docs/fr/settings-reference#syncclaudeaiplugins), où un `false` de n'importe quelle source d'administration désactive le comportement. Chaque clé ne peut que refuser :

175 * Un `false` dans les paramètres utilisateur ou local du développeur le désactive également

176 * Pour `useAutoModeDuringPlan`, un `false` dans un fichier utilisateur ou local que le développeur exclut avec une option telle que [`--setting-sources`](https://code.claude.com/docs/fr/cli-reference#cli-flags) ne compte pas. Ignorer un fichier exclu nécessite Claude Code v2.1.314 ou ultérieur

175* [`enableArtifact`](https://code.claude.com/docs/fr/settings-reference#enableartifact), où un `false` de n'importe quelle source d'administration désactive l'[outil Artifact](https://code.claude.com/docs/fr/artifacts.md). Un `false` dans les paramètres utilisateur, projet ou local du développeur le désactive également, et aucune source ne le réactive ; consultez [quelles valeurs de niveau inférieur comptent toujours](https://code.claude.com/docs/fr/settings.md#exceptions-to-managed-settings-precedence). Nécessite Claude Code v2.1.242 ou ultérieur177* [`enableArtifact`](https://code.claude.com/docs/fr/settings-reference#enableartifact), où un `false` de n'importe quelle source d'administration désactive l'[outil Artifact](https://code.claude.com/docs/fr/artifacts.md). Un `false` dans les paramètres utilisateur, projet ou local du développeur le désactive également, et aucune source ne le réactive ; consultez [quelles valeurs de niveau inférieur comptent toujours](https://code.claude.com/docs/fr/settings.md#exceptions-to-managed-settings-precedence). Nécessite Claude Code v2.1.242 ou ultérieur

176* [`maxEffortLevel`](https://code.claude.com/docs/fr/settings-reference#maxeffortlevel), où le plafond le plus bas dans n'importe quelle source d'administration s'applique. Si un développeur définit un plafond plus bas dans ses propres paramètres ou avec `--settings`, Claude Code applique celui-ci ; aucune source ne peut augmenter le plafond. Nécessite Claude Code v2.1.267 ou ultérieur178* [`maxEffortLevel`](https://code.claude.com/docs/fr/settings-reference#maxeffortlevel), où le plafond le plus bas dans n'importe quelle source d'administration s'applique. Si un développeur définit un plafond plus bas dans ses propres paramètres ou avec `--settings`, Claude Code applique celui-ci ; aucune source ne peut augmenter le plafond. Nécessite Claude Code v2.1.267 ou ultérieur

177* Une opt-out de commit-trailer dans `attribution`, ou dans le `includeCoAuthoredBy` déprécié, de n'importe quel niveau179* Une opt-out de commit-trailer dans `attribution`, ou dans le `includeCoAuthoredBy` déprécié, de n'importe quel niveau

model-config.md +5 −1

Details

6134. Vos paramètres : le niveau que vous avez enregistré pour le modèle ou une clé [`effortLevel`](https://code.claude.com/docs/fr/settings-reference#effortlevel), avec la priorité entre eux et entre fichiers de paramètres indiquée à [`modelSettings`](https://code.claude.com/docs/fr/settings-reference#modelsettings)6134. Vos paramètres : le niveau que vous avez enregistré pour le modèle ou une clé [`effortLevel`](https://code.claude.com/docs/fr/settings-reference#effortlevel), avec la priorité entre eux et entre fichiers de paramètres indiquée à [`modelSettings`](https://code.claude.com/docs/fr/settings-reference#modelsettings)

6145. L'effort par défaut du modèle : `high` sur tous les modèles qui prennent en charge l'effort, sauf qu'Opus 5.5, Sonnet 5.5 et Haiku 5.5 sont à `medium` par défaut et qu'Opus 4.7 est à `xhigh` par défaut. Si votre organisation définit un niveau d'effort par défaut pour son [modèle par défaut de l'organisation](#organization-default-model), ce niveau est la valeur par défaut lorsque vous exécutez ce modèle.6145. L'effort par défaut du modèle : `high` sur tous les modèles qui prennent en charge l'effort, sauf qu'Opus 5.5, Sonnet 5.5 et Haiku 5.5 sont à `medium` par défaut et qu'Opus 4.7 est à `xhigh` par défaut. Si votre organisation définit un niveau d'effort par défaut pour son [modèle par défaut de l'organisation](#organization-default-model), ce niveau est la valeur par défaut lorsque vous exécutez ce modèle.

615 615

616Après une bascule automatique de modèle, consultez [Niveau d'effort après une bascule](#effort-level-after-a-fallback) pour connaître le niveau qui s'applique.616Après une bascule automatique de modèle, consultez [Niveau d'effort après une bascule](#effort-level-after-a-fallback) pour connaître le niveau qui s'applique. Pour les sous-agents et les coéquipiers, consultez [Niveau d'effort des sous-agents et des coéquipiers](#effort-level-of-subagents-and-teammates).

617 617

618Opus 5.5 démarre à `medium` sauf si l'une des sources ci-dessus lui attribue un niveau, et une clé `effortLevel` de premier niveau dans votre fichier de paramètres utilisateur n'est pas prise en compte pour Opus 5.5. Cette clé est l'ancienne forme que `/effort` écrivait avant que Claude Code n'enregistre les niveaux par modèle : elle continue de s'appliquer là où elle s'appliquait auparavant, sur Opus 5, Fable 5.1 et les modèles antérieurs, tandis qu'Opus 5.5 et les modèles publiés après lui démarrent à leur propre valeur par défaut jusqu'à ce que vous leur choisissiez un niveau avec `/effort` ou le sélecteur `/model`. Une clé `effortLevel` de premier niveau dans les paramètres de projet, locaux ou gérés, ou transmise avec `--settings`, s'applique à tous les modèles.618Opus 5.5 démarre à `medium` sauf si l'une des sources ci-dessus lui attribue un niveau, et une clé `effortLevel` de premier niveau dans votre fichier de paramètres utilisateur n'est pas prise en compte pour Opus 5.5. Cette clé est l'ancienne forme que `/effort` écrivait avant que Claude Code n'enregistre les niveaux par modèle : elle continue de s'appliquer là où elle s'appliquait auparavant, sur Opus 5, Fable 5.1 et les modèles antérieurs, tandis qu'Opus 5.5 et les modèles publiés après lui démarrent à leur propre valeur par défaut jusqu'à ce que vous leur choisissiez un niveau avec `/effort` ou le sélecteur `/model`. Une clé `effortLevel` de premier niveau dans les paramètres de projet, locaux ou gérés, ou transmise avec `--settings`, s'applique à tous les modèles.

619 619

700 700

701Un [`maxEffortLevel`](https://code.claude.com/docs/fr/settings-reference#maxeffortlevel) ou un [plafond d'effort de l'organisation](#organization-effort-limits) limite toujours le niveau auquel le skill ou le sous-agent s'exécute. Si vous définissez `effortLevel` dans les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md), Claude Code l'applique à l'étape des paramètres de l'[ordre de résolution de l'effort](#adjust-effort-level), et les utilisateurs peuvent toujours modifier le niveau avec `/effort` ou `--effort`. Pour maintenir les utilisateurs à un niveau donné ou en dessous, définissez [`maxEffortLevel`](https://code.claude.com/docs/fr/settings-reference#maxeffortlevel).701Un [`maxEffortLevel`](https://code.claude.com/docs/fr/settings-reference#maxeffortlevel) ou un [plafond d'effort de l'organisation](#organization-effort-limits) limite toujours le niveau auquel le skill ou le sous-agent s'exécute. Si vous définissez `effortLevel` dans les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md), Claude Code l'applique à l'étape des paramètres de l'[ordre de résolution de l'effort](#adjust-effort-level), et les utilisateurs peuvent toujours modifier le niveau avec `/effort` ou `--effort`. Pour maintenir les utilisateurs à un niveau donné ou en dessous, définissez [`maxEffortLevel`](https://code.claude.com/docs/fr/settings-reference#maxeffortlevel).

702 702

703#### Niveau d'effort des sous-agents et des coéquipiers

704

705Sur le modèle de la conversation principale, un [sous-agent](https://code.claude.com/docs/fr/sub-agents.md#choose-an-effort-level) ou un [coéquipier](https://code.claude.com/docs/fr/agent-teams.md#specify-teammates-and-models) sans `effort` propre s'exécute au niveau que vous choisissez dans la session ou que vous définissez avec `--effort`. Sur un autre modèle, ce niveau ne s'applique pas. Pour choisir le niveau d'un sous-agent, définissez `effort` dans sa définition.

706

703#### Vérifier le niveau d'effort défini707#### Vérifier le niveau d'effort défini

704 708

705Le curseur d'effort apparaît dans `/model` lorsqu'un modèle compatible est sélectionné. Un niveau affiché dans l'en-tête de la session, par exemple « with low effort », provient de votre paramètre d'effort, même si Claude [travaille encore à l'ancien niveau](#when-a-new-effort-level-starts). Au démarrage et lorsque vous le modifiez, le pied de page affiche aussi brièvement le niveau défini pour votre session.709Le curseur d'effort apparaît dans `/model` lorsqu'un modèle compatible est sélectionné. Un niveau affiché dans l'en-tête de la session, par exemple « with low effort », provient de votre paramètre d'effort, même si Claude [travaille encore à l'ancien niveau](#when-a-new-effort-level-starts). Au démarrage et lorsque vous le modifiez, le pied de page affiche aussi brièvement le niveau défini pour votre session.

monitoring-usage.md +4 −0

Details

330 330

331Dans les sessions CLI interactives, le traçage bêta détaillé nécessite également que votre organisation soit sur la liste blanche pour la fonctionnalité. Les sessions SDK Agent et non interactives `-p` ne nécessitent pas de liste blanche.331Dans les sessions CLI interactives, le traçage bêta détaillé nécessite également que votre organisation soit sur la liste blanche pour la fonctionnalité. Les sessions SDK Agent et non interactives `-p` ne nécessitent pas de liste blanche.

332 332

333> [!WARNING]

334>

335> Définissez `ENABLE_BETA_TRACING_DETAILED` uniquement pour le débogage, pas en production. Le traçage bêta détaillé génère un volume d'export élevé, et ses [attributs de contenu](#new-context-gates) ne font pas partie du schéma de span stable.

336

334| - | - | - |338| - | - | - |

network-config.md +5 −1

Details

131 131

132Claude Code note chaque clé ignorée dans le journal de débogage de la session.132Claude Code note chaque clé ignorée dans le journal de débogage de la session.

133 133

134Dans les sessions [Claude Desktop](https://code.claude.com/docs/fr/desktop.md) où l'application gère la connexion du fournisseur, comme l'onglet Code sur un [fournisseur tiers](https://code.claude.com/docs/fr/third-party-integrations.md) et les sessions Cowork, Claude Code lit ces variables et les variables proxy `HTTP_PROXY`, `HTTPS_PROXY` et `NO_PROXY` uniquement à partir des [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) et `~/.claude/settings.json` : il les ignore dans les fichiers de paramètres propres d'un référentiel, donc un référentiel extrait ne peut pas rediriger le chemin TLS ou proxy d'une session dont les identifiants proviennent de l'application. Dans une session d'onglet Code local, SSH ou WSL connectée via claude.ai, l'application ne gère pas la connexion, et Claude Code lit ces variables à partir de chaque portée de paramètres, comme n'importe quelle session de terminal ; les [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md) suivent les règles de session cloud ci-dessus où que vous les démarriez. Avant la v2.1.217, Claude Code ignorait ces variables dans chaque fichier de paramètres lorsque l'application gérait la connexion.134Dans les sessions [Claude Desktop](https://code.claude.com/docs/fr/desktop.md) où l'application gère la connexion du fournisseur, comme l'onglet Code sur un [fournisseur tiers](https://code.claude.com/docs/fr/third-party-integrations.md) et les sessions Cowork, Claude Code lit ces variables, à l'exception de `CLAUDE_CODE_OAUTH_SCOPES`, ainsi que les variables proxy `HTTP_PROXY`, `HTTPS_PROXY` et `NO_PROXY`, uniquement à partir des [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) et de `~/.claude/settings.json`. Il les ignore dans les fichiers de paramètres propres d'un dépôt, de sorte qu'un dépôt extrait ne peut pas rediriger le chemin TLS ou proxy d'une session dont les identifiants proviennent de l'application. Avant la v2.1.217, Claude Code ignorait ces variables dans chaque fichier de paramètres lorsque l'application gérait la connexion.

135

136Dans une session d'onglet Code locale, SSH ou WSL connectée via claude.ai, vous pouvez définir ces variables et les variables proxy dans n'importe quel fichier de paramètres, à l'exception de `CLAUDE_CODE_OAUTH_SCOPES`. Desktop définit lui-même `CLAUDE_CODE_OAUTH_SCOPES` dans les sessions de l'onglet Code et Cowork, vous ne pouvez donc pas le définir.

137

138Lorsque l'environnement de lancement de la session définit déjà une variable, Claude Code [ignore la valeur du fichier de paramètres](https://code.claude.com/docs/fr/settings-reference.md#how-env-values-interact-with-your-shell) et nomme la variable dans le [journal de débogage](https://code.claude.com/docs/fr/debug-your-config.md). Pour utiliser votre propre valeur de proxy ou de certificat dans une session locale, [ajoutez-la à un environnement local enregistré](https://code.claude.com/docs/fr/desktop.md#set-environment-variables-for-local-sessions). Les [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md) suivent les règles de session cloud ci-dessus, où que vous les démarriez.

135 139

136## Vérifier votre configuration140## Vérifier votre configuration

137 141

permission-modes.md +3 −1

Details

383* **Le serveur n'examine pas la session** : une réponse se termine sans résultats d'examen, ou le serveur répond qu'il n'examine pas cette session. Les causes les plus courantes sont une passerelle LLM ou un proxy qui abandonne la requête d'examen ou les résultats, et une plateforme, une région ou des identifiants qui n'ont pas encore de vérifications côté serveur. Claude Code se rabat sur ses propres requêtes de classificateur. Une fois que cette solution de repli est maintenue pour le reste de la session, il affiche un [avis sur les frais de requêtes de classificateur](https://code.claude.com/docs/fr/auto-mode-classifier-billing.md) sur les comptes où ces requêtes sont facturées.383* **Le serveur n'examine pas la session** : une réponse se termine sans résultats d'examen, ou le serveur répond qu'il n'examine pas cette session. Les causes les plus courantes sont une passerelle LLM ou un proxy qui abandonne la requête d'examen ou les résultats, et une plateforme, une région ou des identifiants qui n'ont pas encore de vérifications côté serveur. Claude Code se rabat sur ses propres requêtes de classificateur. Une fois que cette solution de repli est maintenue pour le reste de la session, il affiche un [avis sur les frais de requêtes de classificateur](https://code.claude.com/docs/fr/auto-mode-classifier-billing.md) sur les comptes où ces requêtes sont facturées.

384* **Le serveur ne donne pas de verdict pour une action** : Claude Code refuse l'action plutôt que de l'exécuter sans examen. Sur n'importe quelle connexion, cela se produit quand la réponse se termine avant l'arrivée des résultats d'examen ou que les résultats arrivent sous une forme que Claude Code ne peut pas lire. Une passerelle LLM ou un proxy qui raccourcit les réponses ou réécrit les résultats peut causer l'un ou l'autre. Sur une connexion directe à l'API Anthropic, cela se produit également quand la vérification du serveur échoue pour l'action, par exemple en dépassant le délai d'attente. [Le serveur n'a pas retourné de verdict de sécurité](https://code.claude.com/docs/fr/errors.md#the-server-returned-no-safety-verdict) couvre le message de refus, ce qui se passe quand les refus se répètent, et ce qu'il faut faire.384* **Le serveur ne donne pas de verdict pour une action** : Claude Code refuse l'action plutôt que de l'exécuter sans examen. Sur n'importe quelle connexion, cela se produit quand la réponse se termine avant l'arrivée des résultats d'examen ou que les résultats arrivent sous une forme que Claude Code ne peut pas lire. Une passerelle LLM ou un proxy qui raccourcit les réponses ou réécrit les résultats peut causer l'un ou l'autre. Sur une connexion directe à l'API Anthropic, cela se produit également quand la vérification du serveur échoue pour l'action, par exemple en dépassant le délai d'attente. [Le serveur n'a pas retourné de verdict de sécurité](https://code.claude.com/docs/fr/errors.md#the-server-returned-no-safety-verdict) couvre le message de refus, ce qui se passe quand les refus se répètent, et ce qu'il faut faire.

385 385

386 Si un [hook](https://code.claude.com/docs/fr/hooks.md#pretooluse-updatedinput-in-auto-mode) ou un [mod](https://code.claude.com/docs/fr/plugins/mods/overview.md) modifie l'entrée d'une action après l'examen du serveur, Claude Code peut refuser l'action sans verdict. Dans les sessions de terminal interactif et VS Code sur une connexion directe à l'API Anthropic, le texte du refus inclut `a hook changed this call's input after auto mode reviewed it`. [Son entrée d'erreur](https://code.claude.com/docs/fr/errors.md#hook-changed-input-after-review) couvre ce qu'il faut faire.

387

386Pour ne pas interroger le serveur et toujours utiliser les propres requêtes de classificateur de Claude Code, définissez [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/fr/env-vars). Sur une connexion directe à l'API Anthropic, la variable nécessite Claude Code v2.1.281 ou ultérieur. La définir sur `1` active l'examen du serveur dans une session qui ne l'a pas encore, à moins que vous n'ayez également défini `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Si vous définissez `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` et laissez `CLAUDE_CODE_AUTO_MODE_SERVER` non défini, Claude Code cesse également d'interroger le serveur, sauf comme le décrit [Désactiver les capacités de pré-version](https://code.claude.com/docs/fr/llm-gateway-protocol.md#disable-pre-release-capabilities).388Pour ne pas interroger le serveur et toujours utiliser les propres requêtes de classificateur de Claude Code, définissez [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/fr/env-vars). Sur une connexion directe à l'API Anthropic, la variable nécessite Claude Code v2.1.281 ou ultérieur. La définir sur `1` active l'examen du serveur dans une session qui ne l'a pas encore, à moins que vous n'ayez également défini `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Si vous définissez `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` et laissez `CLAUDE_CODE_AUTO_MODE_SERVER` non défini, Claude Code cesse également d'interroger le serveur, sauf comme le décrit [Désactiver les capacités de pré-version](https://code.claude.com/docs/fr/llm-gateway-protocol.md#disable-pre-release-capabilities).

387 389

388### Modèle de classificateur par défaut390### Modèle de classificateur par défaut

557* **Une action bloquée** : Claude Code affiche une notification et répertorie l'action dans `/permissions` sous l'onglet **Recently blocked**, où vous pouvez [approuver l'action pour que Claude puisse réessayer](https://code.claude.com/docs/fr/auto-mode-config.md#review-denials).559* **Une action bloquée** : Claude Code affiche une notification et répertorie l'action dans `/permissions` sous l'onglet **Recently blocked**, où vous pouvez [approuver l'action pour que Claude puisse réessayer](https://code.claude.com/docs/fr/auto-mode-config.md#review-denials).

558* **Blocages répétés** : si le classificateur bloque une action 3 fois de suite ou 20 fois au total, le mode auto se met en pause et Claude Code recommence à vous demander la permission. Approuver l'action demandée relance le mode auto. Voir [Seuils de blocages répétés](#repeated-block-thresholds) pour savoir comment les blocages sont comptés.560* **Blocages répétés** : si le classificateur bloque une action 3 fois de suite ou 20 fois au total, le mode auto se met en pause et Claude Code recommence à vous demander la permission. Approuver l'action demandée relance le mode auto. Voir [Seuils de blocages répétés](#repeated-block-thresholds) pour savoir comment les blocages sont comptés.

559* **Aucun verdict du classificateur** : quand une vérification de sécurité distincte du mode auto refuse la propre requête du classificateur, ou que la réponse du classificateur ne peut pas être analysée, Claude Code bloque l'action sans la notification ni l'entrée **Recently blocked**. Voir [Le mode auto ne peut pas déterminer la sécurité d'une action](https://code.claude.com/docs/fr/errors.md#auto-mode-cannot-determine-the-safety-of-an-action) pour le message que chaque cas affiche et ce qu'il faut faire.561* **Aucun verdict du classificateur** : quand une vérification de sécurité distincte du mode auto refuse la propre requête du classificateur, ou que la réponse du classificateur ne peut pas être analysée, Claude Code bloque l'action sans la notification ni l'entrée **Recently blocked**. Voir [Le mode auto ne peut pas déterminer la sécurité d'une action](https://code.claude.com/docs/fr/errors.md#auto-mode-cannot-determine-the-safety-of-an-action) pour le message que chaque cas affiche et ce qu'il faut faire.

560* **Aucun verdict du serveur** : avec l'[examen du classificateur côté serveur](#server-side-classifier-review), Claude Code refuse une action pour laquelle le serveur ne donne pas de verdict, et arrête le tour après dix réponses de suite sans verdict. Voir [Le serveur n'a pas retourné de verdict de sécurité](https://code.claude.com/docs/fr/errors.md#the-server-returned-no-safety-verdict).562* **Aucun verdict du serveur** : avec l'[examen du classificateur côté serveur](#server-side-classifier-review), Claude Code refuse une action pour laquelle le serveur ne donne pas de verdict, et peut arrêter le tour après dix réponses de suite sans verdict. Voir [Le serveur n'a pas retourné de verdict de sécurité](https://code.claude.com/docs/fr/errors.md#the-server-returned-no-safety-verdict).

561* **Un changement de mode pendant une vérification** : si vous changez de mode de permission alors qu'une vérification du classificateur est en attente, Claude Code abandonne un verdict que le nouveau mode n'aurait pas demandé. Une approbation vous est demandée à la place, ou l'action est automatiquement refusée en [mode `dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).563* **Un changement de mode pendant une vérification** : si vous changez de mode de permission alors qu'une vérification du classificateur est en attente, Claude Code abandonne un verdict que le nouveau mode n'aurait pas demandé. Une approbation vous est demandée à la place, ou l'action est automatiquement refusée en [mode `dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).

562 564

563#### Seuils de blocages répétés565#### Seuils de blocages répétés

plugins/mods/troubleshoot.md +4 −0

Details

199 199

200Le message indique à Claude d'émettre l'appel une fois de plus tel qu'enregistré. Si cela est également refusé, le hook modifie l'entrée à chaque fois, donc désactivez le mod ou le hook, ou quittez le mode auto et approuvez l'appel vous-même.200Le message indique à Claude d'émettre l'appel une fois de plus tel qu'enregistré. Si cela est également refusé, le hook modifie l'entrée à chaque fois, donc désactivez le mod ou le hook, ou quittez le mode auto et approuvez l'appel vous-même.

201 201

202> [!NOTE]

203>

204> Dans [certaines sessions de terminal interactives et sessions VS Code](https://code.claude.com/docs/fr/hooks.md#pretooluse-updatedinput-in-auto-mode), le même refus donne la raison `a hook changed this call's input after auto mode reviewed it`. L'appel répété y porte la première modification du mod, et un hook `tool.call` s'exécute toujours dessus, mais toute modification supplémentaire est ignorée. Vous n'avez pas besoin de modifier votre mod, sauf si Claude vous indique dans sa réponse que [le mode auto n'a pas pu vérifier l'appel](https://code.claude.com/docs/fr/errors.md#hook-changed-input-after-review).

205

202### Un message sur les règles de refus dans vos paramètres206### Un message sur les règles de refus dans vos paramètres

203 207

204`tried to lift a deny rule in your settings` et `the deny rules in your settings could not be checked for this call, so it is refused` proviennent tous deux du garde intégré.208`tried to lift a deny rule in your settings` et `the deny rules in your settings could not be checked for this call, so it is refused` proviennent tous deux du garde intégré.

routines.md +4 −4

Details

31>31>

32> Deux autres fonctionnalités planifient du travail sur votre machine plutôt que dans le cloud : les [tâches planifiées Desktop](https://code.claude.com/docs/fr/desktop-scheduled-tasks.md) et [`/loop`](https://code.claude.com/docs/fr/scheduled-tasks). Pour choisir parmi les trois, consultez [Comparer les options de planification](https://code.claude.com/docs/fr/scheduled-tasks.md#compare-scheduling-options).32> Deux autres fonctionnalités planifient du travail sur votre machine plutôt que dans le cloud : les [tâches planifiées Desktop](https://code.claude.com/docs/fr/desktop-scheduled-tasks.md) et [`/loop`](https://code.claude.com/docs/fr/scheduled-tasks). Pour choisir parmi les trois, consultez [Comparer les options de planification](https://code.claude.com/docs/fr/scheduled-tasks.md#compare-scheduling-options).

33 33

34Les propriétaires Team et Enterprise peuvent désactiver les tâches planifiées pour tous les membres avec le bouton bascule **Scheduled tasks (Was Routines)** dans [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities). Lorsque le bouton bascule est désactivé, les tâches planifiées existantes cessent de s'exécuter et les membres ne peuvent pas en créer de nouvelles.34Les propriétaires Team et Enterprise peuvent désactiver les tâches planifiées pour tous les membres avec le bouton bascule **Scheduled tasks (Was Routines)** ou **Routines** dans [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities). Lorsque le bouton bascule est désactivé, les tâches planifiées existantes cessent de s'exécuter et les membres ne peuvent pas en créer de nouvelles.

35 35

36Si votre organisation Enterprise gère votre accès avec des [rôles personnalisés](https://support.claude.com/en/articles/13930452), vous avez également besoin d'un rôle qui inclut la permission des tâches planifiées. Un propriétaire peut l'ajouter dans la section **Remote sessions** d'un rôle dans [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).36Si votre organisation Enterprise gère votre accès avec des [rôles personnalisés](https://support.claude.com/en/articles/13930452), vous avez également besoin d'un rôle qui inclut la permission des tâches planifiées. Un propriétaire peut l'ajouter dans la section **Remote sessions** d'un rôle dans [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).

37 37

485* **Adresse web** : `claude.ai/code/routines`485* **Adresse web** : `claude.ai/code/routines`

486* **CLI** : l'alias `/routines` de `/schedule`, la description de la commande et les réponses de Claude pendant qu'il configure une tâche486* **CLI** : l'alias `/routines` de `/schedule`, la description de la commande et les réponses de Claude pendant qu'il configure une tâche

487* **API** : le chemin de l'endpoint `/fire`, son en-tête bêta, le `type` de sa réponse, la balise `<routine-fire-payload>` et la page de référence [Trigger a routine through the API](https://platform.claude.com/docs/en/api/claude-code/routines-fire)487* **API** : le chemin de l'endpoint `/fire`, son en-tête bêta, le `type` de sa réponse, la balise `<routine-fire-payload>` et la page de référence [Trigger a routine through the API](https://platform.claude.com/docs/en/api/claude-code/routines-fire)

488* **Paramètres de l'organisation** : le bouton bascule **Scheduled tasks (Was Routines)**488* **Paramètres de l'organisation** : le bouton bascule **Scheduled tasks (Was Routines)** ou **Routines**

489 489

490## Dépannage490## Dépannage

491 491

504 504

505Si la cause est votre connexion à la CLI ou le fait d'être dans une session cloud, vous pouvez tout de même créer et gérer des tâches planifiées sur [claude.ai/code/routines](https://claude.ai/code/routines). Vous y avez besoin d'un compte Pro, Max, Ultra, Team ou Enterprise. Si les tâches planifiées ou les sessions cloud sont désactivées pour votre organisation ou absentes de vos rôles, vous ne pouvez pas non plus les créer sur le web.505Si la cause est votre connexion à la CLI ou le fait d'être dans une session cloud, vous pouvez tout de même créer et gérer des tâches planifiées sur [claude.ai/code/routines](https://claude.ai/code/routines). Vous y avez besoin d'un compte Pro, Max, Ultra, Team ou Enterprise. Si les tâches planifiées ou les sessions cloud sont désactivées pour votre organisation ou absentes de vos rôles, vous ne pouvez pas non plus les créer sur le web.

506 506

507### "Routines are disabled by your organization's policy"507### Les tâches planifiées sont désactivées pour votre organisation

508 508

509Un propriétaire de votre organisation Team ou Enterprise a probablement désactivé le bouton bascule **Scheduled tasks (Was Routines)** dans [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities). Sur Claude Code v2.1.227 ou version ultérieure, ce même bouton bascule masque également `/schedule` dans la CLI. Il s'agit d'un paramètre d'organisation côté serveur, il ne peut donc pas être remplacé par votre configuration locale. Demandez à un propriétaire de réactiver les tâches planifiées pour votre organisation.509Les tâches planifiées cloud sont désactivées pour votre organisation, et vous ne pouvez pas modifier cela depuis votre configuration locale. Demandez à votre propriétaire Team ou Enterprise s'il peut activer le bouton bascule **Scheduled tasks (Was Routines)** ou **Routines** dans [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities).

510 510

511### Avertissements « The last run »511### Avertissements « The last run »

512 512

sandboxing.md +1 −0

Details

1074* **Escalade de permissions du système de fichiers** : les permissions d'écriture du système de fichiers trop larges peuvent permettre des attaques d'escalade de privilèges. Autoriser les écritures dans les répertoires contenant des exécutables dans `$PATH`, les répertoires de configuration système ou les fichiers de configuration shell utilisateur tels que `.bashrc` ou `.zshrc` peut entraîner l'exécution de code dans différents contextes de sécurité lorsque d'autres utilisateurs ou processus système accèdent à ces fichiers.1074* **Escalade de permissions du système de fichiers** : les permissions d'écriture du système de fichiers trop larges peuvent permettre des attaques d'escalade de privilèges. Autoriser les écritures dans les répertoires contenant des exécutables dans `$PATH`, les répertoires de configuration système ou les fichiers de configuration shell utilisateur tels que `.bashrc` ou `.zshrc` peut entraîner l'exécution de code dans différents contextes de sécurité lorsque d'autres utilisateurs ou processus système accèdent à ces fichiers.

1075* **Force du sandbox Linux** : l'implémentation Linux fournit une isolation forte du système de fichiers et du réseau mais inclut un mode `enableWeakerNestedSandbox` qui lui permet de fonctionner à l'intérieur des environnements Docker sans espaces de noms privilégiés. Cette option affaiblit considérablement la sécurité et ne doit être utilisée que lorsqu'une isolation supplémentaire est autrement appliquée.1075* **Force du sandbox Linux** : l'implémentation Linux fournit une isolation forte du système de fichiers et du réseau mais inclut un mode `enableWeakerNestedSandbox` qui lui permet de fonctionner à l'intérieur des environnements Docker sans espaces de noms privilégiés. Cette option affaiblit considérablement la sécurité et ne doit être utilisée que lorsqu'une isolation supplémentaire est autrement appliquée.

1076* **Apple Events sur macOS** : le sandbox macOS bloque les Apple Events par défaut. Le paramètre `allowAppleEvents` lève cette restriction afin que les outils tels que `open` et `osascript` fonctionnent, mais il supprime l'isolation de l'exécution du code : les commandes sandboxées peuvent lancer d'autres applications sans sandbox sans invite utilisateur, et peuvent envoyer des commandes AppleScript aux applications en cours d'exécution, sous réserve de l'invite de consentement à l'automatisation macOS par application (TCC). Il n'est honoré que par les paramètres utilisateur, gérés ou CLI. Les paramètres de projet ne peuvent pas l'activer.1076* **Apple Events sur macOS** : le sandbox macOS bloque les Apple Events par défaut. Le paramètre `allowAppleEvents` lève cette restriction afin que les outils tels que `open` et `osascript` fonctionnent, mais il supprime l'isolation de l'exécution du code : les commandes sandboxées peuvent lancer d'autres applications sans sandbox sans invite utilisateur, et peuvent envoyer des commandes AppleScript aux applications en cours d'exécution, sous réserve de l'invite de consentement à l'automatisation macOS par application (TCC). Il n'est honoré que par les paramètres utilisateur, gérés ou CLI. Les paramètres de projet ne peuvent pas l'activer.

1077* **Services Mach et XPC sur macOS** : les commandes sandboxées peuvent atteindre, en dehors du sandbox, chaque service que vous listez dans [`network.allowMachLookup`](https://code.claude.com/docs/fr/settings-reference#sandbox-network-allowmachlookup), et le sandbox ne restreint pas ce que ces services font pour ces commandes.

1077* **Espaces de noms utilisateur sur Linux et WSL2** : par défaut, les commandes sandboxées ne peuvent pas créer d'espaces de noms utilisateur. Si vous définissez [`allowNestedUserNamespaces`](https://code.claude.com/docs/fr/settings-reference#sandbox-allownestedusernamespaces) sur `true`, vous désactivez une limite de sécurité : le code d'une commande sandboxée peut finir par s'exécuter en dehors du sandbox. Avant d'activer ce paramètre, lisez l'avertissement dans [Chromium ou Podman rootless échoue à l'intérieur du sandbox sur Linux](#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux).1078* **Espaces de noms utilisateur sur Linux et WSL2** : par défaut, les commandes sandboxées ne peuvent pas créer d'espaces de noms utilisateur. Si vous définissez [`allowNestedUserNamespaces`](https://code.claude.com/docs/fr/settings-reference#sandbox-allownestedusernamespaces) sur `true`, vous désactivez une limite de sécurité : le code d'une commande sandboxée peut finir par s'exécuter en dehors du sandbox. Avant d'activer ce paramètre, lisez l'avertissement dans [Chromium ou Podman rootless échoue à l'intérieur du sandbox sur Linux](#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux).

1078 1079

1079### Portée1080### Portée

self-hosted-environments-configuration.md +19 −5

Details

16 16

17## Scripts wrapper17## Scripts wrapper

18 18

19Utilisez un script wrapper quand chaque session a besoin d'une configuration que le runner ne peut pas faire seul : provisionner des identifiants de courte durée limités au créateur de la session, exporter des secrets spécifiques à l'environnement, préparer des chaînes d'outils de langage ou appliquer des limites de ressources autour du processus enfant. Le runner démarre votre wrapper à la place du binaire Claude Code, une fois par session. Terminez le wrapper en `exec`-ant dans `$CLAUDE_RUNNER_CLAUDE_BIN`, le binaire du runner lui-même, afin que les signaux et les codes de sortie se propagent correctement.19Utilisez un script wrapper quand chaque session a besoin d'une configuration que le runner ne peut pas faire seul :

21* Provisionner des identifiants de courte durée limités au créateur de la session

22* Exporter des secrets spécifiques à l'environnement

23* Préparer des chaînes d'outils de langage

24* Appliquer des limites de ressources autour du processus enfant

26Le runner démarre votre wrapper à la place du binaire Claude Code chaque fois qu'il démarre une session, y compris lorsqu'une session reprend ou est remise en file d'attente. Terminez le wrapper en `exec`-ant dans `$CLAUDE_RUNNER_CLAUDE_BIN`, le binaire du runner lui-même, afin que les signaux et les codes de sortie se propagent correctement.

20 27

21Pointez `--exec-path`, ou `SELF_HOSTED_RUNNER_EXEC_PATH`, vers le wrapper quand vous démarrez le runner, en remplaçant `<writable-dir>` comme le décrit le [démarrage rapide](https://code.claude.com/docs/fr/self-hosted-environments-quickstart.md#set-up-manually) :28Pointez `--exec-path`, ou `SELF_HOSTED_RUNNER_EXEC_PATH`, vers le wrapper quand vous démarrez le runner, en remplaçant `<writable-dir>` comme le décrit le [démarrage rapide](https://code.claude.com/docs/fr/self-hosted-environments-quickstart.md#set-up-manually) :

22 29

139 146

140### checkout147### checkout

141 148

142S'exécute une fois par dépôt, à la place du clone et de la récupération intégrés du runner. Utilisez le hook pour cloner à partir d'un miroir de lecture directe accessible via HTTPS ou SSH, amorcer un arbre de travail à partir d'une archive ou appliquer une authentification git par session. Le runner définit ces variables, et peut définir d'autres variables `CLAUDE_RUNNER_` que le tableau ne répertorie pas :149S'exécute pour chaque dépôt chaque fois que le runner démarre une session, y compris lorsque la session reprend ou est remise en file d'attente, à la place du clone et de la récupération intégrés du runner. Utilisez le hook pour cloner à partir d'un miroir de lecture directe accessible via HTTPS ou SSH, amorcer un arbre de travail à partir d'une archive ou appliquer une authentification git par session.

150

151Le runner définit ces variables, et peut définir d'autres variables `CLAUDE_RUNNER_` que le tableau ne répertorie pas :

143 152

144| Variable | Description |153| Variable | Description |

145| :- | :- |154| :- | :- |

179 188

180### post-session189### post-session

181 190

182S'exécute une fois par session, après la sortie de l'enfant Claude Code et avant que le runner ne démonte l'espace de travail. Ce hook est votre seule chance de sauvegarder le travail non commis : à `--capacity` au-dessus d'un, le runner supprime les worktrees par session juste après le retour du hook, et à `--capacity 1` le [clone canonique](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout) réutilisé est réinitialisé en dur quand la session suivante démarre, donc les changements suivis non commis ne survivent sur aucun chemin. Les utilisations typiques sont l'envoi d'une branche d'instantané de changements non commis, l'archivage de journaux ou l'émission d'un événement de fin de session à vos propres systèmes.191S'exécute après la sortie de l'enfant Claude Code et avant que le runner ne démonte l'espace de travail. Ce hook est votre seule chance de sauvegarder le travail non commis, car les changements suivis non commis ne survivent sur aucun des deux chemins :

192

193* **À `--capacity` au-dessus d'un** : le runner supprime les worktrees par session juste après le retour du hook

194* **À `--capacity 1`** : le [clone canonique](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout) réutilisé est réinitialisé en dur quand la session suivante démarre

195

196Les utilisations typiques sont l'envoi d'une branche d'instantané de changements non commis, l'archivage de journaux ou l'émission d'un événement de fin de session à vos propres systèmes.

183 197

184Le hook se déclenche à chaque fin de session où un processus enfant a été généré, quelle qu'en soit la cause ; les valeurs `CLAUDE_RUNNER_EXIT_REASON` ci-dessous énumèrent les cas. Il ne peut pas se déclencher quand le runner se termine brutalement, comme une préemption de VM ou une perte de courant ; si vous avez besoin de garanties contre une terminaison brutale, prenez des instantanés périodiquement à partir de l'intérieur de la session avec un hook Claude Code `PostToolUse` à la place. Le runner définit :198Le hook se déclenche à chaque fin de session où un processus enfant a été généré, quelle qu'en soit la cause ; les valeurs `CLAUDE_RUNNER_EXIT_REASON` ci-dessous énumèrent les cas. Il ne peut pas se déclencher quand le runner se termine brutalement, comme une préemption de VM ou une perte de courant ; si vous avez besoin de garanties contre une terminaison brutale, prenez des instantanés périodiquement à partir de l'intérieur de la session avec un hook Claude Code `PostToolUse` à la place. Le runner définit :

185 199

275 289

276### command290### command

277 291

278S'exécute une fois par session après le checkout, à la place du spawn enfant intégré. Le hook reçoit le même environnement qu'un [script wrapper](#wrapper-scripts) et doit `exec` dans `"$CLAUDE_RUNNER_CLAUDE_BIN"` de la même manière. Utilisez le hook `command` pour garder toute la personnalisation dans un répertoire de hooks ; utilisez `--exec-path` quand le wrapper vit ailleurs. Si `--exec-path` est aussi défini, le flag prend la priorité et le hook `command` est ignoré.292S'exécute après le checkout chaque fois qu'une session démarre ou reprend, à la place du spawn enfant intégré. Le hook reçoit le même environnement qu'un [script wrapper](#wrapper-scripts) et doit `exec` dans `"$CLAUDE_RUNNER_CLAUDE_BIN"` de la même manière. Utilisez le hook `command` pour garder toute la personnalisation dans un répertoire de hooks ; utilisez `--exec-path` quand le wrapper vit ailleurs. Si `--exec-path` est aussi défini, le flag prend la priorité et le hook `command` est ignoré.

279 293

280Toujours `exec` le binaire du runner plutôt qu'un `claude` résolu par PATH ; sinon vous annulez l'[épinglage de version](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#pin-the-version).294Toujours `exec` le binaire du runner plutôt qu'un `claude` résolu par PATH ; sinon vous annulez l'[épinglage de version](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#pin-the-version).

281 295

523 537

524* **Endpoint de métadonnées** : si vous refusez totalement aux sessions l'accès à l'[endpoint de métadonnées cloud](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#harden-your-deployment), les identifiants qu'il fournit, comme un profil d'instance, n'atteignent pas non plus Claude Code. Une identité web basée sur un fichier, comme IAM Roles for Service Accounts (IRSA) sur Amazon EKS ou un fichier d'identifiants Workload Identity Federation, n'en dépend pas.538* **Endpoint de métadonnées** : si vous refusez totalement aux sessions l'accès à l'[endpoint de métadonnées cloud](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#harden-your-deployment), les identifiants qu'il fournit, comme un profil d'instance, n'atteignent pas non plus Claude Code. Une identité web basée sur un fichier, comme IAM Roles for Service Accounts (IRSA) sur Amazon EKS ou un fichier d'identifiants Workload Identity Federation, n'en dépend pas.

525* **Renouvellement** : une session peut survivre à ses identifiants, utilisez donc une méthode qui se renouvelle d'elle-même, comme une identité web basée sur un fichier539* **Renouvellement** : une session peut survivre à ses identifiants, utilisez donc une méthode qui se renouvelle d'elle-même, comme une identité web basée sur un fichier

526* **Script wrapper** : le runner lance votre [script wrapper](#provision-credentials-scoped-to-the-session-creator) une seule fois par session, donc les identifiants qu'il exporte ne sont pas renouvelés. Claude Code lit les identifiants AWS depuis son environnement, donc si votre wrapper exporte déjà des identifiants AWS pour d'autres tâches, Claude Code peut signer les requêtes de modèle avec eux.540* **Script wrapper** : les valeurs d'identifiants exportées par votre [script wrapper](#provision-credentials-scoped-to-the-session-creator) ne sont pas renouvelées pendant l'exécution de Claude Code ; pour une session longue, utilisez donc une méthode qui se renouvelle d'elle-même. Claude Code lit les identifiants AWS depuis son environnement, donc si votre wrapper exporte déjà des identifiants AWS pour d'autres tâches, Claude Code peut signer les requêtes de modèle avec eux.

527 541

528**3. Définir les variables d'un seul fournisseur dans l'environnement du runner**542**3. Définir les variables d'un seul fournisseur dans l'environnement du runner**

529 543

self-hosted-environments-deploy.md +1 −1

Details

827 827

828### Certaines sessions ne comptent pas comme inactives828### Certaines sessions ne comptent pas comme inactives

829 829

830Une session tenant une tâche de fond qui ne se termine jamais ne compte pas comme inactive, donc `--release-idle-session-min` ne libérera pas l'emplacement de cette session. Une session qui attend une approbation demandée de l'intérieur d'un appel d'outil en cours d'exécution ne compte pas non plus comme inactive. Définissez toujours `--kill-session-after-min` à côté comme un arrêt dur pour qu'aucune session ne puisse tenir un emplacement indéfiniment.830Une session contenant une tâche en arrière-plan qui continue de s'exécuter ne compte pas comme inactive, donc `--release-idle-session-min` ne libérera pas l'emplacement de cette session. Une session qui attend une approbation demandée de l'intérieur d'un appel d'outil en cours d'exécution ne compte pas non plus comme inactive. Définissez `--kill-session-after-min` à côté comme arrêt dur.

831 831

832`--kill-session-after-min` est un arrêt dur pour les sessions qui s'échappent. Sur un runner en v2.1.260 ou ultérieur, une session qui atteint la limite n'est pas terminée immédiatement. Le runner lui donne une fenêtre de grâce, 15 minutes par défaut, que vous pouvez modifier avec [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](https://code.claude.com/docs/fr/self-hosted-environments-reference#environment-variable-only-settings) :832`--kill-session-after-min` est un arrêt dur pour les sessions qui s'échappent. Sur un runner en v2.1.260 ou ultérieur, une session qui atteint la limite n'est pas terminée immédiatement. Le runner lui donne une fenêtre de grâce, 15 minutes par défaut, que vous pouvez modifier avec [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](https://code.claude.com/docs/fr/self-hosted-environments-reference#environment-variable-only-settings) :

833 833

self-hosted-environments-reference.md +1 −1

Details

153}153}

154```154```

155 155

156Utilisez `last_poll_age_ms` comme signal de vivacité dans les sondes personnalisées ; une valeur qui croît sans limite indique que la boucle d'interrogation est bloquée. À la fois `last_poll_at` et `last_poll_age_ms` sont `null` jusqu'à la fin de la première interrogation.156Configurez des alertes sur `last_poll_age_ms`, mais ne l'utilisez pas dans une sonde de vivacité ; conservez cette sonde sur le code de statut HTTP. La valeur correspond au temps écoulé depuis la dernière interrogation réussie, elle augmente donc aussi lorsque le runner ne peut pas joindre Anthropic. `last_poll_at` et `last_poll_age_ms` valent tous deux `null` jusqu'à ce que la première interrogation réussisse. Pour détecter les interrogations qui échouent dès le départ, configurez également des alertes sur `claude_code_self_hosted_runner_poll_errors_total`, répertorié sous [Métriques Prometheus](#prometheus-metrics).

157 157

158Le `/healthz` propre à l'orchestrateur, sur son port de santé, retourne toujours `200`. Le corps porte un champ `connected` signalant si l'interrogation la plus récente a réussi, plus les comptes de file d'attente de génération par état dans `queue_counts`. Pour savoir pourquoi `connected` vaut `false`, lisez le champ de premier niveau `last_error`, que chaque interrogation réussie réinitialise à `null`. Gater la disponibilité et les alertes sur `connected` plutôt que sur le code de statut.158Le `/healthz` propre à l'orchestrateur, sur son port de santé, retourne toujours `200`. Le corps porte un champ `connected` signalant si l'interrogation la plus récente a réussi, plus les comptes de file d'attente de génération par état dans `queue_counts`. Pour savoir pourquoi `connected` vaut `false`, lisez le champ de premier niveau `last_error`, que chaque interrogation réussie réinitialise à `null`. Gater la disponibilité et les alertes sur `connected` plutôt que sur le code de statut.

159 159

settings.md +1 −1

Details

313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/fr/settings-reference#automode-classifyallshell) | `true` depuis `~/.claude/settings.json` ou `--settings` | Respectée même lorsqu'une source gérée définit `false` |313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/fr/settings-reference#automode-classifyallshell) | `true` depuis `~/.claude/settings.json` ou `--settings` | Respectée même lorsqu'une source gérée définit `false` |

314| [`remoteControlAtStartup`](https://code.claude.com/docs/fr/settings-reference#remotecontrolatstartup) | `false` depuis `.claude/settings.json` ou `.claude/settings.local.json` | Respectée même lorsqu'une source gérée définit `true` ; un `true` de projet ou local est ignoré |314| [`remoteControlAtStartup`](https://code.claude.com/docs/fr/settings-reference#remotecontrolatstartup) | `false` depuis `.claude/settings.json` ou `.claude/settings.local.json` | Respectée même lorsqu'une source gérée définit `true` ; un `true` de projet ou local est ignoré |

315| [`crossSessionInbound`](https://code.claude.com/docs/fr/settings-reference#crosssessioninbound) | Une valeur plus stricte depuis `.claude/settings.json` ou `.claude/settings.local.json`, sur l'échelle `accept` \< `hold` \< `refuse` | Respectée par rapport aux valeurs gérées, `--settings` et utilisateur ; une valeur de projet ou locale qui n'est pas plus stricte est ignorée |315| [`crossSessionInbound`](https://code.claude.com/docs/fr/settings-reference#crosssessioninbound) | Une valeur plus stricte depuis `.claude/settings.json` ou `.claude/settings.local.json`, sur l'échelle `accept` \< `hold` \< `refuse` | Respectée par rapport aux valeurs gérées, `--settings` et utilisateur ; une valeur de projet ou locale qui n'est pas plus stricte est ignorée |

316| [`useAutoModeDuringPlan`](https://code.claude.com/docs/fr/settings-reference#useautomodeduringplan) | `false` depuis n'importe quelle source gérée, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respectée même lorsque la source gérée retenue définit `true` ; un `false` dans `.claude/settings.json` est ignoré |316| [`useAutoModeDuringPlan`](https://code.claude.com/docs/fr/settings-reference#useautomodeduringplan) | `false` depuis n'importe quelle source gérée, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respectée même lorsque la source gérée retenue définit `true` ; un `false` dans `.claude/settings.json` est ignoré. Consultez [l'entrée de la clé](https://code.claude.com/docs/fr/settings-reference.md#useautomodeduringplan) pour le cas d'un fichier que vous omettez au lancement |

317| [`syncClaudeAiSkills`](https://code.claude.com/docs/fr/settings-reference#syncclaudeaiskills) | `false` depuis n'importe quelle source gérée, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respectée même lorsque la source gérée retenue définit `true` ; un `false` dans `.claude/settings.json` est ignoré |317| [`syncClaudeAiSkills`](https://code.claude.com/docs/fr/settings-reference#syncclaudeaiskills) | `false` depuis n'importe quelle source gérée, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respectée même lorsque la source gérée retenue définit `true` ; un `false` dans `.claude/settings.json` est ignoré |

318| [`syncClaudeAiPlugins`](https://code.claude.com/docs/fr/settings-reference#syncclaudeaiplugins) | `false` depuis n'importe quelle source gérée, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respectée même lorsque la source gérée retenue définit `true` ; un `false` dans `.claude/settings.json` est ignoré |318| [`syncClaudeAiPlugins`](https://code.claude.com/docs/fr/settings-reference#syncclaudeaiplugins) | `false` depuis n'importe quelle source gérée, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respectée même lorsque la source gérée retenue définit `true` ; un `false` dans `.claude/settings.json` est ignoré |

319| [`maxEffortLevel`](https://code.claude.com/docs/fr/settings-reference#maxeffortlevel) | Un plafond inférieur depuis n'importe quelle portée, y compris `--settings` | Respecté même lorsque les paramètres gérés appliqués par Claude Code définissent un plafond plus élevé ; le plafond le plus bas s'applique. Nécessite Claude Code v2.1.267 ou une version ultérieure |319| [`maxEffortLevel`](https://code.claude.com/docs/fr/settings-reference#maxeffortlevel) | Un plafond inférieur depuis n'importe quelle portée, y compris `--settings` | Respecté même lorsque les paramètres gérés appliqués par Claude Code définissent un plafond plus élevé ; le plafond le plus bas s'applique. Nécessite Claude Code v2.1.267 ou une version ultérieure |

settings-reference.md +4 −2

Details

925Choisissez si Claude Code utilise le classificateur du mode auto pour examiner les commandes shell en mode plan. Avec la valeur par défaut `true`, le classificateur examine chaque commande pendant la planification quand le mode auto est disponible et vous ne voyez aucune invite, sauf pour [les suppressions de chemin critique](https://code.claude.com/docs/fr/permission-modes.md#critical-paths). Définissez `false` pour obtenir une invite de permission pour chaque commande en dehors de l'ensemble intégré en lecture seule. Apparaît dans `/config` comme **Use auto mode during plan**.925Choisissez si Claude Code utilise le classificateur du mode auto pour examiner les commandes shell en mode plan. Avec la valeur par défaut `true`, le classificateur examine chaque commande pendant la planification quand le mode auto est disponible et vous ne voyez aucune invite, sauf pour [les suppressions de chemin critique](https://code.claude.com/docs/fr/permission-modes.md#critical-paths). Définissez `false` pour obtenir une invite de permission pour chaque commande en dehors de l'ensemble intégré en lecture seule. Apparaît dans `/config` comme **Use auto mode during plan**.

926 926

927* **Portée** : [`User, local, or managed`](#scopes). Un dépôt ne peut pas l'éteindre pour vous.927* **Portée** : [`User, local, or managed`](#scopes). Un dépôt ne peut pas l'éteindre pour vous.

928 * Un `false` dans l'un de ces fichiers ou dans `--settings` le désactive, sauf si vous excluez ce fichier utilisateur ou local avec une option telle que [`--setting-sources`](https://code.claude.com/docs/fr/cli-reference#cli-flags). Pour qu'un fichier exclu soit ignoré, Claude Code v2.1.314 ou ultérieur est nécessaire

928* **Type** : Booléen929* **Type** : Booléen

929 * `true` : identique à non défini ; quand le mode auto est disponible, le classificateur examine chaque commande shell pendant la planification au lieu de vous l'inviter, sauf [les suppressions de chemin critique](https://code.claude.com/docs/fr/permission-modes.md#critical-paths). Un `false` dans l'un de ces fichiers l'éteint toujours930 * `true` : identique à non défini ; quand le mode auto est disponible, le classificateur examine les commandes shell pendant la planification

930 * `false` : vous obtenez une invite de permission pour chaque commande en dehors de l'ensemble intégré en lecture seule931 * `false` : vous obtenez une invite de permission pour chaque commande en dehors de l'ensemble intégré en lecture seule

931* **Défaut** : `true`932* **Défaut** : `true`

932 933

2073 2074

2074### `sandbox.network.allowMachLookup`2075### `sandbox.network.allowMachLookup`

2075 2076

2076Listez les noms de service XPC et Mach supplémentaires que le sandbox macOS peut rechercher. Les outils qui communiquent via XPC, comme le simulateur iOS ou Playwright, ont besoin de leurs services listés ici.2077Liste des noms de services XPC et Mach supplémentaires que le sandbox macOS peut rechercher. Les outils qui communiquent via XPC, comme le simulateur iOS ou Playwright, nécessitent que leurs services soient listés ici. Les commandes en sandbox peuvent atteindre, hors du sandbox, chaque service que vous listez, et le sandbox [ne limite pas ce que ces services font pour ces commandes](https://code.claude.com/docs/fr/sandboxing.md#security-limitations).

2077 2078

2078* **Scope** : [`Any file`](#scopes), avec des [limites sur les paramètres de projet et locaux](https://code.claude.com/docs/fr/sandboxing.md#repository-settings-under-an-admin-required-sandbox)2079* **Scope** : [`Any file`](#scopes), avec des [limites sur les paramètres de projet et locaux](https://code.claude.com/docs/fr/sandboxing.md#repository-settings-under-an-admin-required-sandbox)

2079* **Type** : tableau de chaînes, chacun un nom de service ; un seul `*` final correspond à un préfixe, et `"*"` seul correspond à chaque service2080* **Type** : tableau de chaînes, chacun un nom de service ; un seul `*` final correspond à un préfixe, et `"*"` seul correspond à chaque service

2422 2423

2423 L'ignorance de ce groupe dans les paramètres de projet et locaux nécessite Claude Code v2.1.282 ou une version ultérieure.2424 L'ignorance de ce groupe dans les paramètres de projet et locaux nécessite Claude Code v2.1.282 ou une version ultérieure.

2424 * Les variables qui modifient la façon dont Claude Code démarre ou se synchronise, comme `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` et `CLAUDE_CODE_PLUGIN_SEED_DIR`.2425 * Les variables qui modifient la façon dont Claude Code démarre ou se synchronise, comme `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` et `CLAUDE_CODE_PLUGIN_SEED_DIR`.

2426 * Les variables qui définissent votre connexion à claude.ai, comme [`CLAUDE_CODE_OAUTH_TOKEN`, `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` et `CLAUDE_CODE_OAUTH_SCOPES`](https://code.claude.com/docs/fr/env-vars#variables).

2425 * La variable du [mode lecteur d'écran](https://code.claude.com/docs/fr/accessibility.md) `CLAUDE_AX_SCREEN_READER` et les autres variables dont le nom commence par `CLAUDE_AX_`, comme [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/fr/env-vars#variables).2427 * La variable du [mode lecteur d'écran](https://code.claude.com/docs/fr/accessibility.md) `CLAUDE_AX_SCREEN_READER` et les autres variables dont le nom commence par `CLAUDE_AX_`, comme [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/fr/env-vars#variables).

2426 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/fr/env-vars#variables), qui définit le minuteur d'une boîte de dialogue restée sans réponse.2428 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/fr/env-vars#variables), qui définit le minuteur d'une boîte de dialogue restée sans réponse.

2427 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/fr/env-vars#variables), qui désactive le traitement des pièces jointes.2429 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/fr/env-vars#variables), qui désactive le traitement des pièces jointes.

setup.md +5 −5

Details

40>40>

41> **macOS, Linux, WSL :**41> **macOS, Linux, WSL :**

42>42>

~~43> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}~~43> ```bash theme={null}

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>

48>48>

49> **Windows PowerShell :**49> **Windows PowerShell :**

50>50>

~~51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}~~51> ```powershell theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD :**55> **Windows CMD :**

56>56>

~~57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}~~57> ```batch theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>

72 72

73> [tab] Homebrew73> [tab] Homebrew

74>74>

~~75> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}~~75> ```bash theme={null}

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>

84 84

85> [tab] WinGet85> [tab] WinGet

86>86>

~~87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}~~87> ```powershell theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>

sub-agents.md +4 −0

Details

416 416

417Lorsque vous demandez à Claude d'exécuter un sous-agent qui n'est pas un fork à un niveau d'effort spécifique, il peut également passer un paramètre `effort` pour cette invocation. Le paramètre remplace le champ `effort` et reste en vigueur lorsque le sous-agent est [repris](#resume-subagents). La variable d'environnement [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/fr/env-vars#variables) a priorité sur les deux. Le paramètre par invocation nécessite Claude Code v2.1.292 ou ultérieur.417Lorsque vous demandez à Claude d'exécuter un sous-agent qui n'est pas un fork à un niveau d'effort spécifique, il peut également passer un paramètre `effort` pour cette invocation. Le paramètre remplace le champ `effort` et reste en vigueur lorsque le sous-agent est [repris](#resume-subagents). La variable d'environnement [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/fr/env-vars#variables) a priorité sur les deux. Le paramètre par invocation nécessite Claude Code v2.1.292 ou ultérieur.

418 418

419#### Lorsqu'un sous-agent n'a ni champ ni paramètre `effort`

420

421Sur le modèle de la conversation principale, le sous-agent s'exécute au niveau que vous choisissez dans la session, par exemple avec `/effort`, ou que vous définissez avec `--effort`. Sur un autre modèle, [ce niveau ne s'applique pas](https://code.claude.com/docs/fr/model-config.md#effort-level-of-subagents-and-teammates). Pour choisir son niveau, définissez le champ `effort`.

422

419### Contrôler les capacités des sous-agents423### Contrôler les capacités des sous-agents

420 424

421Vous pouvez contrôler ce que les sous-agents peuvent faire via l'accès aux outils, les modes de permission et les règles conditionnelles.425Vous pouvez contrôler ce que les sous-agents peuvent faire via l'accès aux outils, les modes de permission et les règles conditionnelles.

web-quickstart.md +1 −1

Details

69 69

70Avec cette connexion, une session peut cloner n'importe quel référentiel public, mais ne peut travailler dans un référentiel privé que lorsque l'application Claude GitHub est installée dessus. [Installez l'application Claude GitHub](https://github.com/apps/claude/installations/new) sur chaque compte GitHub ou organisation dont vous souhaitez utiliser les référentiels privés. Sur une organisation GitHub, un propriétaire d'organisation peut avoir besoin d'approuver l'installation. L'installation de l'application active également [Correction automatique](https://code.claude.com/docs/fr/claude-code-on-the-web.md#auto-fix-pull-requests), qui permet à Claude de répondre aux défaillances CI et aux commentaires d'examen sur les demandes de tirage dans ces référentiels.70Avec cette connexion, une session peut cloner n'importe quel référentiel public, mais ne peut travailler dans un référentiel privé que lorsque l'application Claude GitHub est installée dessus. [Installez l'application Claude GitHub](https://github.com/apps/claude/installations/new) sur chaque compte GitHub ou organisation dont vous souhaitez utiliser les référentiels privés. Sur une organisation GitHub, un propriétaire d'organisation peut avoir besoin d'approuver l'installation. L'installation de l'application active également [Correction automatique](https://code.claude.com/docs/fr/claude-code-on-the-web.md#auto-fix-pull-requests), qui permet à Claude de répondre aux défaillances CI et aux commentaires d'examen sur les demandes de tirage dans ces référentiels.

71 71

72Lorsque vous vous connectez, Claude associe également les comptes GitHub dont vous êtes propriétaire à votre organisation Claude, si l'application Claude GitHub y est installée. Sur les plans Team et Enterprise, les administrateurs voient ces comptes dans la [liste des comptes GitHub connectés](https://code.claude.com/docs/fr/admin-setup.md#connected-github-accounts).72Lorsque vous vous connectez, Claude associe également les comptes GitHub dont vous êtes propriétaire à votre organisation Claude, si l'application Claude GitHub y est installée. Sur les plans Team et Enterprise, les Propriétaires de votre organisation Claude voient ces comptes dans la [liste des comptes GitHub connectés](https://code.claude.com/docs/fr/admin-setup.md#connected-github-accounts).

73 73

74Si l'intégration vous invite à installer l'application Claude GitHub à ce stade et que vous préférez le faire plus tard, cliquez sur **Ignorer**.74Si l'intégration vous invite à installer l'application Claude GitHub à ce stade et que vous préférez le faire plus tard, cliquez sur **Ignorer**.

75 75

Documentation 2026-11-02 23:57 UTC to 2026-11-03 23:58 UTC