SpyBara
Go Premium

Documentation 2026-10-03 23:57 UTC to 2026-10-04 17:00 UTC

53 files changed +1,074 −663. View all changes and history on the product overview
2026
Sun 4 18:02 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59

admin-setup.md +2 −2

Details

137 Comptes GitHub connectés137 Comptes GitHub connectés

138</h3>138</h3>

139 139 

140Sur les plans Team et Enterprise, [**Paramètres d'administration > GitHub**](https://claude.ai/admin-settings/github) 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. L'ouvrir nécessite un rôle d'administrateur dans votre organisation Claude.140Sur les plans Team et Enterprise, [**Paramètres de l'organisation > GitHub**](https://claude.ai/admin-settings/github) 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. L'ouvrir nécessite un rôle d'administrateur dans votre organisation Claude.

141 141 

142Un administrateur ou un membre peut lier un compte :142Un administrateur ou un membre peut lier un compte :

143 143 


161| Surveillance de l'utilisation | Export OpenTelemetry des sessions, outils et jetons | Tous les fournisseurs | [Surveillance de l'utilisation](/docs/fr/monitoring-usage) |161| Surveillance de l'utilisation | Export OpenTelemetry des sessions, outils et jetons | Tous les fournisseurs | [Surveillance de l'utilisation](/docs/fr/monitoring-usage) |

162| Tableau de bord analytique | Métriques d'adoption et de contribution avec un classement sur Teams / Enterprise ; métriques d'utilisation et de dépenses par utilisateur sur Console | Teams / Enterprise sur [claude.ai/analytics](https://claude.ai/analytics/claude-code), Console sur [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytique](/docs/fr/analytics) |162| Tableau de bord analytique | Métriques d'adoption et de contribution avec un classement sur Teams / Enterprise ; métriques d'utilisation et de dépenses par utilisateur sur Console | Teams / Enterprise sur [claude.ai/analytics](https://claude.ai/analytics/claude-code), Console sur [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytique](/docs/fr/analytics) |

163| Suivi programmatique | Données d'utilisation et de coût par utilisateur via une API | [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) pour Enterprise, [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) pour Console | [Coûts](/docs/fr/costs#manage-costs-for-your-organization) |163| Suivi programmatique | Données d'utilisation et de coût par utilisateur via une API | [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) pour Enterprise, [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) pour Console | [Coûts](/docs/fr/costs#manage-costs-for-your-organization) |

164| Contrôles de dépenses | Limites de dépenses et limites de débit | Paramètres d'administration pour Teams / Enterprise, limites d'espace de travail pour Console ; sur les clouds tiers, contrôles budgétaires cloud ou une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) avec [limites de dépenses](/docs/fr/claude-apps-gateway-spend-limits) par utilisateur | [Coûts](/docs/fr/costs#manage-costs-for-your-organization) |164| Contrôles de dépenses | Limites de dépenses et limites de débit | Paramètres de l'organisation pour Teams / Enterprise, limites d'espace de travail pour Console ; sur les clouds tiers, contrôles budgétaires cloud ou une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) avec [limites de dépenses](/docs/fr/claude-apps-gateway-spend-limits) par utilisateur | [Coûts](/docs/fr/costs#manage-costs-for-your-organization) |

165 165 

166Sur Teams et Enterprise, les chiffres d'utilisation et de dépenses par utilisateur proviennent du [rapport de dépenses](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) dans les paramètres d'analytique de votre organisation, et non du tableau de bord analytique. Les fournisseurs cloud exposent les dépenses via AWS Cost Explorer, GCP Billing ou Azure Cost Management. Pour planifier les budgets d'entreprise sur Claude chat, Claude Code et Cowork, consultez le [guide de consommation Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide).166Sur Teams et Enterprise, les chiffres d'utilisation et de dépenses par utilisateur proviennent du [rapport de dépenses](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) dans les paramètres d'analytique de votre organisation, et non du tableau de bord analytique. Les fournisseurs cloud exposent les dépenses via AWS Cost Explorer, GCP Billing ou Azure Cost Management. Pour planifier les budgets d'entreprise sur Claude chat, Claude Code et Cowork, consultez le [guide de consommation Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide).

167 167 

agent-sdk/mcp.md +14 −0

Details

919 ```919 ```

920</CodeGroup>920</CodeGroup>

921 921 

922<h3 id="a-tool-is-missing-from-an-sdk-mcp-server">

923 Un outil est absent d'un serveur MCP du SDK

924</h3>

925 

926Dans le SDK TypeScript, lorsque le schéma d'entrée d'un outil ne peut pas être converti en JSON Schema, le serveur que vous avez créé avec [`createSdkMcpServer()`](/docs/fr/agent-sdk/typescript#createsdkmcpserver) omet cet outil lorsqu'il liste ses outils. Le SDK émet alors un avertissement. Sous Node.js, l'avertissement est un avertissement de processus avec le code `CLAUDE_SDK_MCP_TOOL_SCHEMA_UNCONVERTIBLE`, et il commence par ce texte :

927 

928```text theme={null}

929Tool "<name>" on SDK MCP server "<server>" was left out of the server's tool list, because its input schema cannot be converted to JSON Schema

930```

931 

932Le reste de l'avertissement indique le message de l'erreur de conversion lorsqu'il y en a un, puis précise ce qu'il faut vérifier et modifier.

933 

934Avant la version v0.3.286 du TypeScript Agent SDK, un seul schéma non convertible faisait échouer toute la liste des outils du serveur sans cet avertissement, de sorte qu'aucun des outils de ce serveur n'atteignait Claude.

935 

922<h3 id="connection-timeouts">936<h3 id="connection-timeouts">

923 Délais d'expiration de la connexion937 Délais d'expiration de la connexion

924</h3>938</h3>

Details

13| Symptôme | Aller à |13| Symptôme | Aller à |

14| :- | :- |14| :- | :- |

15| Skills non trouvées, une skill non utilisée, erreur `Invalid skill name` | [Dépannage des skills](/docs/fr/agent-sdk/skills#troubleshooting) |15| Skills non trouvées, une skill non utilisée, erreur `Invalid skill name` | [Dépannage des skills](/docs/fr/agent-sdk/skills#troubleshooting) |

16| Le serveur MCP affiche le statut `failed`, les outils ne sont pas appelés, les délais d'expiration de la connexion, la sortie de l'outil qui dépasse le nombre maximum de tokens autorisés | [Dépannage MCP](/docs/fr/agent-sdk/mcp#troubleshooting) |16| Le serveur MCP affiche le statut `failed`, les outils ne sont pas appelés, un outil manquant dans un serveur MCP du SDK, les délais d'expiration de la connexion, la sortie de l'outil qui dépasse le nombre maximum de tokens autorisés | [Dépannage MCP](/docs/fr/agent-sdk/mcp#troubleshooting) |

17| Plugin ne se charge pas, les skills du plugin n'apparaissent pas | [Dépannage des plugins](/docs/fr/agent-sdk/plugins#troubleshooting) |17| Plugin ne se charge pas, les skills du plugin n'apparaissent pas | [Dépannage des plugins](/docs/fr/agent-sdk/plugins#troubleshooting) |

18| Claude ne délègue pas aux sous-agents, les agents basés sur le système de fichiers ne se chargent pas | [Dépannage des sous-agents](/docs/fr/agent-sdk/subagents#troubleshooting) |18| Claude ne délègue pas aux sous-agents, les agents basés sur le système de fichiers ne se chargent pas | [Dépannage des sous-agents](/docs/fr/agent-sdk/subagents#troubleshooting) |

19| Les options de checkpointing ne sont pas reconnues, les messages utilisateur sans UUID, `No file checkpoint found`, `File rewinding is not enabled`, `ProcessTransport is not ready for writing` | [Dépannage du checkpointing de fichiers](/docs/fr/agent-sdk/file-checkpointing#troubleshooting) |19| Les options de checkpointing ne sont pas reconnues, les messages utilisateur sans UUID, `No file checkpoint found`, `File rewinding is not enabled`, `ProcessTransport is not ready for writing` | [Dépannage du checkpointing de fichiers](/docs/fr/agent-sdk/file-checkpointing#troubleshooting) |

Details

863 fast_mode_state?: "off" | "cooldown" | "on";863 fast_mode_state?: "off" | "cooldown" | "on";

864 fast_mode_disabled_reason?: FastModeDisabledReason;864 fast_mode_disabled_reason?: FastModeDisabledReason;

865 hooks_applied?: boolean;865 hooks_applied?: boolean;

866 sdk_mcp_manifests_parked?: Record<

867 string,

868 | "parked"

869 | "already_connected"

870 | "protocol_version_mismatch"

871 | "malformed"

872 | "not_honoured"

873 >;

866};874};

867```875```

868 876 


875 883 

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

877 885 

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

887 

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

879 889 

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


1955| - | - |1965| - | - |

1956| `interrupt_receipt_v1` | [`interrupt()`](#query-object) se résout avec un reçu [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) listant les messages qui étaient en attente quand l'interruption est arrivée |1966| `interrupt_receipt_v1` | [`interrupt()`](#query-object) se résout avec un reçu [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) listant les messages qui étaient en attente quand l'interruption est arrivée |

1957| `interrupt_cancel_queued_v1` | La requête de contrôle `interrupt` honore `cancel_queued: true`, annulant les messages que le reçu listerait autrement sous `still_queued` et les listant sous `cancelled` à la place. Voir [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse). Nécessite Claude Code v2.1.219 ou ultérieur |1967| `interrupt_cancel_queued_v1` | La requête de contrôle `interrupt` honore `cancel_queued: true`, annulant les messages que le reçu listerait autrement sous `still_queued` et les listant sous `cancelled` à la place. Voir [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse). Nécessite Claude Code v2.1.219 ou ultérieur |

1968| `sdk_mcp_manifests` | La requête de contrôle `initialize` accepte `sdkMcpServerManifests`, les résultats de handshake MCP capturés à partir de vos [serveurs MCP SDK](/docs/fr/agent-sdk/custom-tools) en cours de processus. Claude Code annonce cette capacité à partir de la v2.1.286 |

1969| `sdk_mcp_tools_list_changed` | Une notification `tools/list_changed` provenant d'un [serveur MCP SDK](/docs/fr/agent-sdk/custom-tools) amène Claude Code à lister à nouveau les outils de ce serveur, si bien qu'un outil ajouté par le serveur en cours de session parvient à Claude. Claude Code annonce cette capacité à partir de la v2.1.286 |

1958 1970 

1959Le tableau `plugin_errors` liste les défaillances de chargement de plugin. Une entrée décrit soit un plugin qui n'a pas été chargé et est absent de `plugins`, soit un plugin qui a été chargé sans l'une de ses parties, comme son fichier de hooks. La clé est omise quand rien n'a échoué. `SDKSystemMessage` déclare `plugin_errors` dans Agent SDK v0.3.283 ou ultérieur.1971Le tableau `plugin_errors` liste les défaillances de chargement de plugin. Une entrée décrit soit un plugin qui n'a pas été chargé et est absent de `plugins`, soit un plugin qui a été chargé sans l'une de ses parties, comme son fichier de hooks. La clé est omise quand rien n'a échoué. `SDKSystemMessage` déclare `plugin_errors` dans Agent SDK v0.3.283 ou ultérieur.

1960 1972 

agent-view.md +5 −2

Details

347 347 

348Pour combiner des filtres, commencez par `a:`, `s:`, `n:` ou `o:` et ajoutez-en d'autres, séparés par des espaces. La liste affiche les sessions qui correspondent à tous. Par exemple, `s:blocked a:reviewer` répertorie les sessions `reviewer` qui vous attendent.348Pour combiner des filtres, commencez par `a:`, `s:`, `n:` ou `o:` et ajoutez-en d'autres, séparés par des espaces. La liste affiche les sessions qui correspondent à tous. Par exemple, `s:blocked a:reviewer` répertorie les sessions `reviewer` qui vous attendent.

349 349 

350Lorsqu'un filtre est actif, les groupes que vous avez réduits se développent pour afficher leurs correspondances et la première correspondance est sélectionnée, de sorte qu'appuyer sur `Enter` l'ouvre. Effacez l'entrée pour supprimer le filtre, et ces groupes se réduisent à nouveau.350Lorsqu'un filtre est actif, les groupes que vous avez réduits se développent pour afficher leurs correspondances et une correspondance est sélectionnée, de sorte qu'appuyer sur `Enter` l'ouvre. Effacez l'entrée pour supprimer le filtre, et ces groupes se réduisent à nouveau.

351 351 

352<h3 id="keyboard-shortcuts">352<h3 id="keyboard-shortcuts">

353 Raccourcis clavier353 Raccourcis clavier


369| `Tab` | Sur une entrée vide, parcourir tous les sous-agents. Sinon appliquer la suggestion en surbrillance |369| `Tab` | Sur une entrée vide, parcourir tous les sous-agents. Sinon appliquer la suggestion en surbrillance |

370| `Ctrl+S` | Basculer le groupement entre l'état et le répertoire |370| `Ctrl+S` | Basculer le groupement entre l'état et le répertoire |

371| `Ctrl+T` | Épingler ou dépingler la session sélectionnée |371| `Ctrl+T` | Épingler ou dépingler la session sélectionnée |

372| `Ctrl+F` | Rechercher des sessions par nom, avec le [filtre `n:`](#filter-sessions) |

373| `Alt+↑` / `Alt+↓` | Aller à l'en-tête de groupe précédent ou suivant |

372| `Ctrl+R` | Renommer la session sélectionnée |374| `Ctrl+R` | Renommer la session sélectionnée |

373| `Ctrl+G` | Ouvrir l'invite de dispatch dans votre `$VISUAL` ou `$EDITOR` |375| `Ctrl+G` | Ouvrir l'invite de dispatch dans votre `$VISUAL` ou `$EDITOR` |

374| `Ctrl+J` | Insérer une nouvelle ligne dans l'entrée de dispatch |376| `Ctrl+J` | Insérer une nouvelle ligne dans l'entrée de dispatch |


378| `Ctrl+C` | Effacer l'entrée ; appuyez deux fois pour quitter |380| `Ctrl+C` | Effacer l'entrée ; appuyez deux fois pour quitter |

379| `?` | Afficher tous les raccourcis |381| `?` | Afficher tous les raccourcis |

380 382 

381`Ctrl+S`, `Ctrl+T` et `Ctrl+G` suivent votre [`keybindings.json`](/docs/fr/keybindings). Reliez ou déliez `Ctrl+S` et `Ctrl+T` avec les actions `agents:switchView` et `agents:togglePin` dans le contexte [`Agents`](/docs/fr/keybindings#agents-actions), et `Ctrl+G` via la liaison `chat:externalEditor` du contexte `Chat`. Les autres raccourcis du tableau ne peuvent pas être reliés.383Les raccourcis qui ont une action dans le [contexte `Agents`](/docs/fr/keybindings#agents-actions) suivent votre [`keybindings.json`](/docs/fr/keybindings). C'est aussi le cas de `Ctrl+G`, via la liaison `chat:externalEditor` du contexte `Chat`.

382 384 

383<h2 id="dispatch-new-agents">385<h2 id="dispatch-new-agents">

384 Lancer de nouveaux agents386 Lancer de nouveaux agents


1087 1089 

1088| Version | Changement |1090| Version | Changement |

1089| - | - |1091| - | - |

1092| v2.1.288 | `Ctrl+F` trouve les sessions par nom, et `Alt+↑` / `Alt+↓` sautent d'un en-tête de groupe à l'autre. Ces deux raccourcis, ainsi que `Ctrl+R`, peuvent être [réassignés](/docs/fr/keybindings#agents-actions). |

1090| v2.1.287 | Le [filtre `n:<text>`](#filter-sessions) trouve les sessions par nom ou par premier prompt. Tant qu'un filtre est actif, les groupes que vous avez réduits se développent pour afficher leurs correspondances et la première correspondance est sélectionnée, de sorte que `Enter` l'ouvre. |1093| v2.1.287 | Le [filtre `n:<text>`](#filter-sessions) trouve les sessions par nom ou par premier prompt. Tant qu'un filtre est actif, les groupes que vous avez réduits se développent pour afficher leurs correspondances et la première correspondance est sélectionnée, de sorte que `Enter` l'ouvre. |

1091| v2.1.287 | Une commande envoyée comme [réponse depuis le panneau d'aperçu](#peek-and-reply) s'exécute à la fin du tour en cours de la session, y compris les commandes qui s'exécutent dès que vous les tapez dans le prompt propre à la session. Une réponse qui est exactement `/stop` arrête immédiatement la session. |1094| v2.1.287 | Une commande envoyée comme [réponse depuis le panneau d'aperçu](#peek-and-reply) s'exécute à la fin du tour en cours de la session, y compris les commandes qui s'exécutent dès que vous les tapez dans le prompt propre à la session. Une réponse qui est exactement `/stop` arrête immédiatement la session. |

1092| v2.1.281 | Une restriction [`--setting-sources`](/docs/fr/cli-reference#cli-flags) [se reporte](#what-carries-over-when-you-background) à une session que vous mettez en arrière-plan avec `←` ou `/bg` et aux sessions que vous dispatchez à partir de la vue agent. Avant cette version, la session générée chargeait chaque source de paramètres. |1095| v2.1.281 | Une restriction [`--setting-sources`](/docs/fr/cli-reference#cli-flags) [se reporte](#what-carries-over-when-you-background) à une session que vous mettez en arrière-plan avec `←` ou `/bg` et aux sessions que vous dispatchez à partir de la vue agent. Avant cette version, la session générée chargeait chaque source de paramètres. |

Details

386 386 

387Lorsque 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 demander à Amazon Bedrock à 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`](/docs/fr/env-vars).387Lorsque 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 demander à Amazon Bedrock à 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`](/docs/fr/env-vars).

388 388 

389<h3 id="when-your-organization-enforces-a-model-allowlist">

390 Lorsque votre organisation impose une liste d'autorisation de modèles

391</h3>

392 

393Si vous définissez [`enforceAvailableModels`](/docs/fr/model-config#enforce-the-allowlist-for-the-default-model) dans les paramètres gérés, les vérifications du modèle au démarrage utilisent uniquement les modèles autorisés par votre liste `availableModels`. Cela s'applique à l'API Invoke d'Amazon Bedrock et nécessite Claude Code v2.1.287 ou une version ultérieure. Une liste sans `enforceAvailableModels` ne restreint pas ces vérifications.

394 

395Les vérifications comparent chaque entrée avec l'ID de profil d'inférence qu'elles enverraient, y compris son [préfixe de région](#cross-region-inference-profile-prefixes) ; rédigez donc la liste avec ces ID. Cet exemple autorise Opus 4.8 et Sonnet 4.5 pour un déploiement dont les modèles se résolvent en profils `us.` :

396 

397```json theme={null}

398{

399 "availableModels": ["us.anthropic.claude-opus-4-8", "us.anthropic.claude-sonnet-4-5-20250929-v1:0"],

400 "enforceAvailableModels": true

401}

402```

403 

404Pour les alias, les préfixes de version et les entrées `modelOverrides`, consultez [Épingler les modèles pour les déploiements tiers](/docs/fr/model-config#pin-models-for-third-party-deployments).

405 

389<h3 id="when-a-model-is-disabled-mid-session">406<h3 id="when-a-model-is-disabled-mid-session">

390 Lorsqu'un modèle est désactivé en cours de session407 Lorsqu'un modèle est désactivé en cours de session

391</h3>408</h3>

artifacts.md +25 −23

Details

128Lorsque Claude lit l'artefact avec WebFetch, les propres [règles de demande de permission](/docs/fr/tools-reference#webfetch-tool-behavior) de WebFetch continuent de s'appliquer.128Lorsque Claude lit l'artefact avec WebFetch, les propres [règles de demande de permission](/docs/fr/tools-reference#webfetch-tool-behavior) de WebFetch continuent de s'appliquer.

129 129 

130<h2 id="collect-comments-on-an-artifact">130<h2 id="collect-comments-on-an-artifact">

131 Collecter les commentaires sur un artifact131 Recueillir des commentaires sur un artefact

132</h2>132</h2>

133 133 

134Lorsque vous partagez un artifact au sein de votre organisation, les personnes avec lesquelles vous le partagez peuvent laisser des commentaires sur la page, et vous pouvez demander à Claude de lire ces commentaires et d'y répondre. Vous avez besoin de Claude Code v2.1.221 ou version ultérieure. Claude lit les commentaires dans deux cas :134Lorsque vous partagez un artefact au sein de votre organisation, les personnes avec qui vous le partagez peuvent laisser des commentaires sur la page, et vous pouvez demander à Claude de lire ces commentaires et d'y répondre. Vous avez besoin de Claude Code v2.1.221 ou version ultérieure. Claude lit les commentaires dans deux cas :

135 135 

136* **Vous demandez à Claude de les lire** : donnez à Claude l'URL de l'artifact et demandez les commentaires. Claude énumère chaque fil de discussion et marque les commentaires envoyés par quelqu'un qui peut modifier l'artifact.136* **Vous demandez à Claude de les lire** : donnez à Claude l'URL de l'artefact et demandez-lui les commentaires. Claude liste chaque fil de discussion et signale les commentaires qu'une personne pouvant modifier l'artefact lui a envoyés.

137* **Quelqu'un qui peut modifier l'artifact envoie un commentaire à Claude** : dans un fil de discussion sur la page, il envoie un commentaire avec **Send to Claude**, ou mentionne `@claude` dans celui-ci. De l'une ou l'autre façon, il active le fil de discussion.137* **Une personne pouvant modifier l'artefact envoie un commentaire à Claude** : dans un fil de discussion sur la page, elle envoie un commentaire avec **Send to Claude**, ou mentionne `@claude` dans l'un d'eux. Dans les deux cas, elle active le fil de discussion.

138 138 

139Claude ne peut répondre à ou résoudre que les fils de discussion activés. Les autres fils restent ouverts jusqu'à ce qu'une personne les résolve sur la page. Les lecteurs voient chaque réponse attribuée à Claude, via vous.139Claude ne peut répondre qu'à un fil de discussion activé, ou le résoudre. Les autres fils de discussion restent ouverts jusqu'à ce qu'une personne les résolve sur la page. Les lecteurs voient chaque réponse attribuée à Claude, via vous.

140 140 

141Si vous partagez un artifact publiquement, les personnes dont le seul accès est le lien public ne voient pas ses commentaires et ne peuvent pas en ajouter. Les fils de commentaires existants restent sur l'artifact, et vous et ses éditeurs pouvez toujours les lire et y répondre.141Si vous partagez un artefact publiquement, les personnes dont le seul accès est le lien public ne voient pas ses commentaires et ne peuvent pas en ajouter. Les fils de discussion existants restent sur l'artefact, et vous et ses éditeurs pouvez toujours les lire et y répondre.

142 142 

143Pour demander les commentaires vous-même, donnez à Claude l'URL :143Pour demander les commentaires vous-même, donnez l'URL à Claude :

144 144 

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

146Read the comments on https://claude.ai/code/artifact/5fbea6f3-... and make the changes the commenters ask for.146Read the comments on https://claude.ai/code/artifact/5fbea6f3-... and make the changes the commenters ask for.

147```147```

148 148 

149Si Claude vous dit qu'il ne peut pas lire les commentaires, confirmez votre version, votre session et votre paramètre de drapeau de fonctionnalité :149Si Claude vous indique qu'il ne peut pas lire les commentaires, vérifiez votre version, votre session et votre paramètre de feature flags :

150 150 

151* Vous exécutez Claude Code v2.1.221 ou version ultérieure.151* Vous exécutez Claude Code v2.1.221 ou version ultérieure.

152* Vous n'êtes pas dans votre première session depuis que vous avez installé Claude Code ou mis à niveau à partir d'une version antérieure à v2.1.221. Dans cette [première session après une installation ou une mise à niveau](/docs/fr/env-vars#first-session-after-an-install-or-upgrade), Claude pourrait ne pas être en mesure de lire les commentaires ; démarrez une nouvelle session et demandez à nouveau.152* Vous n'êtes pas dans votre première session depuis l'installation de Claude Code ou la mise à niveau depuis une version antérieure à v2.1.221. Lors de cette [première session après une installation ou une mise à niveau](/docs/fr/env-vars#first-session-after-an-install-or-upgrade), Claude pourrait ne pas encore être en mesure de lire les commentaires ; démarrez une nouvelle session et redemandez.

153* Vous n'avez pas désactivé la récupération des drapeaux de fonctionnalités.153* Vous n'avez pas désactivé la récupération des feature flags.

154 154 

155<h3 id="let-claude-reply-to-comments-on-its-own">155<h3 id="let-claude-reply-to-comments-on-its-own">

156 Laisser Claude répondre aux commentaires automatiquement156 Laisser Claude répondre aux commentaires de lui-même

157</h3>157</h3>

158 158 

159Après que votre session publie un artifact, Claude Code surveille cet artifact pour les commentaires aussi longtemps que la session s'exécute. Lorsque quelqu'un qui peut modifier l'artifact envoie un commentaire à Claude, il atteint votre session immédiatement, et Claude peut lire le fil de discussion et répondre sans que vous le demandiez.159Une fois que votre session a publié un artefact, Claude Code surveille les commentaires sur cet artefact. Lorsqu'une personne pouvant modifier l'artefact envoie un commentaire à Claude, celui-ci parvient immédiatement à votre session, et Claude peut lire le fil de discussion et répondre sans que vous le demandiez.

160 160 

161Vous avez besoin de Claude Code v2.1.228 ou version ultérieure. Si vous avez désactivé la [récupération des drapeaux de fonctionnalités](/docs/fr/env-vars#features-that-need-feature-flag-fetching), Claude Code ne surveille pas les commentaires.161Vous avez besoin de Claude Code v2.1.228 ou version ultérieure. Si vous avez désactivé la [récupération des feature flags](/docs/fr/env-vars#features-that-need-feature-flag-fetching), Claude Code ne surveille pas les commentaires.

162 162 

163Votre [mode de permission](/docs/fr/permission-modes) décide ce que Claude fait lorsqu'un commentaire envoyé arrive :163Votre [mode de permission](/docs/fr/permission-modes) détermine ce que fait Claude lorsqu'un commentaire envoyé arrive :

164 164 

165* **Claude répond automatiquement** : lorsque votre mode de permission permet à Claude de publier la réponse sans vous demander, Claude lit le fil de discussion et répond, et modifie l'artifact lorsque le commentaire demande une modification. Vous voyez `Auto-replied to comment thread on Artifact: <name>` ou `Auto-edited Artifact: <name> in response to a comment thread`.165* **Claude répond de lui-même** : lorsque votre mode de permission permet à Claude de publier la réponse sans vous le demander, Claude lit le fil de discussion et répond, et modifie l'artefact lorsque le commentaire demande un changement. Vous voyez `Auto-replied to comment thread on Artifact: <name>` ou `Auto-edited Artifact: <name> in response to a comment thread`.

166* **Claude vous attend** : en dehors du plan mode, lorsque la publication de la réponse nécessiterait votre approbation, vous voyez `Comments are waiting on Artifact: <name>`. Claude vous demande alors l'approbation pour lire le fil de discussion, et à nouveau pour publier la réponse.166* **Claude vous attend** : en dehors du mode plan, lorsque la publication de la réponse nécessiterait votre approbation, vous voyez `Comments are waiting on Artifact: <name>`. Claude vous demande alors d'approuver la lecture du fil de discussion, puis à nouveau la publication de la réponse.

167* **Claude s'arrête en plan mode** : vous voyez `Comments are waiting on Artifact: <name>`, et Claude ne répond pas jusqu'à ce que vous quittiez le plan mode et lui demandiez de lire et répondre.167* **Claude se met en pause en mode plan** : vous voyez `Comments are waiting on Artifact: <name>`, et Claude ne répond pas tant que vous n'avez pas quitté le mode plan et ne lui avez pas demandé de lire et de répondre.

168 168 

169Claude arrête également de répondre automatiquement à un artifact après avoir traité 60 commentaires envoyés ou activations de fil de discussion sur cet artifact en une heure. Vous voyez `Comments are waiting on Artifact: <name>` une fois, et Claude reprend à mesure que les commentaires de cette heure vieillissent.169Claude cesse également de répondre de lui-même sur un artefact après avoir traité 60 commentaires envoyés ou activations de fils de discussion sur cet artefact en l'espace d'une heure. Vous voyez `Comments are waiting on Artifact: <name>` une seule fois, et Claude reprend à mesure que les commentaires de cette heure sortent de la fenêtre.

170 170 

171Exécutez `/tasks` pour voir chaque artifact que votre session surveille, listé comme une tâche de mises à jour en direct. Vous pouvez empêcher Claude de répondre automatiquement de l'une de ces façons :171Exécutez `/tasks` pour voir chaque artefact que votre session surveille, listé comme une tâche de mises à jour en direct. Vous pouvez empêcher Claude de répondre de lui-même de l'une des manières suivantes :

172 172 

173* **Appuyez sur Ctrl+C une fois à une invite inactive** : Claude arrête de répondre sur chaque artifact que votre session surveille. Les réponses recommencent après que vous envoyiez votre prochain message.173* **Appuyez une fois sur Ctrl+C à un prompt inactif** : Claude met en pause ses réponses sur tous les artefacts que votre session surveille. Les réponses reprennent après l'envoi de votre prochain message.

174* **Arrêtez la tâche dans `/tasks`** : Claude arrête de répondre sur cet artifact jusqu'à ce que vous lui demandiez de reprendre les réponses là-bas. La publication de l'artifact à nouveau ne redémarre pas les réponses, et l'arrêt s'applique toujours lorsque vous reprenez la session plus tard.174* **Arrêtez la tâche dans `/tasks`** : Claude cesse de répondre sur cet artefact jusqu'à ce que vous lui demandiez de reprendre les réponses à cet endroit. Republier l'artefact ne relance pas les réponses, et l'arrêt s'applique toujours lorsque vous reprenez la session ultérieurement.

175* **Appuyez sur `Ctrl+X Ctrl+K` deux fois en 3 secondes** : l'accord qui [arrête chaque sous-agent d'arrière-plan en cours d'exécution](/docs/fr/interactive-mode#general-controls) arrête également Claude de répondre sur chaque artifact pour le reste de la session. Demander à Claude de reprendre les réponses n'annule pas cet arrêt.175* **Appuyez deux fois sur `Ctrl+X Ctrl+K` en moins de 3 secondes** : la combinaison de touches qui [arrête tous les sous-agents en arrière-plan en cours d'exécution](/docs/fr/interactive-mode#general-controls) empêche également Claude de répondre sur tous les artefacts pour le reste de la session. Demander à Claude de reprendre les réponses n'annule pas cet arrêt.

176 176 

177Si le service qui livre les commentaires devient indisponible ou cesse de répondre, Claude Code continue d'essayer de se reconnecter pendant un certain temps, puis arrête de surveiller chaque artifact que votre session surveillait.177Une surveillance que Claude Code a démarrée de lui-même peut prendre fin lorsque l'artefact reste plusieurs heures sans activité. Pour relancer la surveillance, republiez l'artefact ou demandez à Claude de le surveiller.

178 

179Si le service qui transmet les commentaires devient indisponible ou cesse de répondre, Claude Code continue d'essayer de se reconnecter pendant un certain temps, puis cesse de surveiller chaque artefact que votre session surveillait.

178 180 

179<h2 id="pull-live-data-with-mcp-connectors">181<h2 id="pull-live-data-with-mcp-connectors">

180 Récupérer des données en direct avec les connecteurs MCP182 Récupérer des données en direct avec les connecteurs MCP

best-practices.md +17 −16

Details

489 Utilisez `claude -p "prompt"` dans CI, les hooks de pré-commit ou les scripts. Ajoutez `--output-format stream-json --verbose` pour la sortie JSON en streaming.489 Utilisez `claude -p "prompt"` dans CI, les hooks de pré-commit ou les scripts. Ajoutez `--output-format stream-json --verbose` pour la sortie JSON en streaming.

490</Tip>490</Tip>

491 491 

492Avec `claude -p "your prompt"`, vous pouvez exécuter Claude de manière non interactive, sans une session interactive. L'exécution crée toujours une session reprise à moins que vous ne transmettiez `--no-session-persistence`. Le [mode non interactif](/docs/fr/headless) est la façon dont vous intégrez Claude dans les pipelines CI, les hooks de pré-commit ou tout flux de travail automatisé. Les formats de sortie vous permettent d'analyser les résultats par programmation : texte brut, JSON ou JSON en streaming.492Avec `claude -p "your prompt"`, vous pouvez exécuter Claude de manière non interactive, sans prompt interactif. L'exécution crée tout de même une session pouvant être reprise, à moins que vous ne transmettiez `--no-session-persistence`. Le [mode non interactif](/docs/fr/headless) est la façon dont vous intégrez Claude dans les pipelines CI, les hooks de pré-commit ou tout workflow automatisé. Les formats de sortie vous permettent d'analyser les résultats par programmation : texte brut, JSON ou JSON en streaming.

493 493 

494```bash theme={null}494```bash theme={null}

495# One-off queries495# One-off queries


509</h3>509</h3>

510 510 

511<Tip>511<Tip>

512 Exécutez plusieurs sessions Claude en parallèle pour accélérer le développement, exécuter des expériences isolées ou démarrer des flux de travail complexes.512 Exécutez plusieurs sessions Claude en parallèle pour accélérer le développement, exécuter des expériences isolées ou démarrer des workflows complexes.

513</Tip>513</Tip>

514 514 

515Choisissez l'approche parallèle qui correspond au niveau de coordination que vous souhaitez faire vous-même, et ajoutez de la messagerie lorsque les sessions doivent se transmettre les résultats :515Choisissez l'approche parallèle qui correspond au niveau de coordination que vous souhaitez faire vous-même, et ajoutez de la messagerie lorsque les sessions doivent se transmettre les résultats :

516 516 

517* [Worktrees](/docs/fr/worktrees) : exécutez des sessions CLI séparées dans des checkouts git isolés afin que les modifications ne se heurtent pas517* [Worktrees](/docs/fr/worktrees) : exécutez des sessions CLI séparées dans des checkouts git isolés afin que les modifications ne se heurtent pas

518* [Messagerie inter-sessions](/docs/fr/cross-session-messaging) : laissez les sessions que vous exécutez vous-même se transmettre les résultats518* [Messagerie inter-sessions](/docs/fr/cross-session-messaging) : laissez les sessions que vous exécutez vous-même se transmettre les résultats

519* [Application de bureau](/docs/fr/desktop#work-in-parallel-with-sessions) : gérez visuellement plusieurs sessions locales, chacune dans son propre worktree519* [Application de bureau](/docs/fr/desktop#work-in-parallel-with-sessions) : gérez visuellement plusieurs sessions locales, éventuellement chacune dans son propre worktree

520* [Claude Code sur le web](/docs/fr/claude-code-on-the-web) : exécutez des sessions dans le cloud, sur l'infrastructure gérée par Anthropic par défaut520* [Utiliser Claude Code dans le cloud](/docs/fr/claude-code-on-the-web) : exécutez des sessions sur l'infrastructure gérée par Anthropic par défaut

521* [Vue agent](/docs/fr/agent-view) : aperçu de recherche. Exécutez `claude agents` pour dispatcher des sessions qui continuent de s'exécuter en arrière-plan et les regarder depuis un seul écran521* [Vue agent](/docs/fr/agent-view) : en research preview. Exécutez `claude agents` pour dispatcher des sessions qui continuent de s'exécuter en arrière-plan et les surveiller depuis un seul écran

522* [Équipes d'agents](/docs/fr/agent-teams) : expérimental et désactivé par défaut. Coordination automatisée de plusieurs sessions avec des tâches partagées, la messagerie et un chef d'équipe522* [Équipes d'agents](/docs/fr/agent-teams) : expérimental et désactivé par défaut. Coordination automatisée de plusieurs sessions avec des tâches partagées, la messagerie et un chef d'équipe

523 523 

524Au-delà de la parallélisation du travail, plusieurs sessions permettent des flux de travail axés sur la qualité. Un contexte frais améliore la révision de code puisque Claude ne sera pas biaisé vers le code qu'il vient d'écrire.524Au-delà de la parallélisation du travail, plusieurs sessions permettent des workflows axés sur la qualité. Un contexte frais améliore la revue de code puisque Claude ne sera pas biaisé vers le code qu'il vient d'écrire.

525 525 

526Par exemple, utilisez un modèle Writer/Reviewer :526Par exemple, utilisez un modèle Writer/Reviewer :

527 527 


538</h3>538</h3>

539 539 

540<Tip>540<Tip>

541 Bouclez à travers les tâches en appelant `claude -p` pour chacune. Utilisez `--allowedTools` pour délimiter les permissions pour les opérations par lot.541 Bouclez à travers les tâches en appelant `claude -p` pour chacune. Utilisez `--allowedTools` pour pré-approuver les outils pour les opérations par lot.

542</Tip>542</Tip>

543 543 

544Pour les migrations ou analyses à grande échelle, vous pouvez distribuer le travail sur de nombreuses invocations Claude parallèles. Exécutez [`/batch <instruction>`](/docs/fr/commands#all-commands) pour que Claude divise la modification sur 5 à 30 sous-agents. Chaque sous-agent travaille dans son propre worktree. Pour piloter le fan-out à partir de votre propre script à la place, bouclez sur `claude -p` :544Pour les migrations ou analyses à grande échelle, vous pouvez distribuer le travail sur de nombreuses invocations Claude parallèles. Exécutez [`/batch <instruction>`](/docs/fr/commands#all-commands) pour que Claude divise la modification sur 5 à 30 sous-agents. Chaque sous-agent travaille dans son propre worktree. Pour piloter le fan-out à partir de votre propre script à la place, bouclez sur `claude -p` :

545 545 

546<Steps>546<Steps>

547 <Step title="Générez une liste de tâches">547 <Step title="Générez une liste de tâches">

548 Demandez à Claude d'écrire la liste des fichiers qui doivent être migrés dans un fichier, afin que la boucle à l'étape suivante puisse la lire, avec une invite comme `list all 2,000 Python files that need migrating and save the list to files.txt`548 Demandez à Claude d'écrire la liste des fichiers qui doivent être migrés dans un fichier, afin que la boucle à l'étape suivante puisse la lire, avec un prompt comme `list all 2,000 Python files that need migrating and save the list to files.txt`

549 </Step>549 </Step>

550 550 

551 <Step title="Écrivez un script pour boucler à travers la liste">551 <Step title="Écrivez un script pour boucler à travers la liste">

552 ```bash theme={null}552 ```bash theme={null}

553 for file in $(cat files.txt); do553 for file in $(cat files.txt); do

554 claude -p "Migrate $file from Python 2 to Python 3. Return OK or FAIL." \554 claude -p "Migrate $file from Python 2 to Python 3. Return OK or FAIL." \

555 --allowedTools "Edit,Bash(git commit *)"555 --allowedTools "Edit,Bash(git commit *)" \

556 --permission-mode dontAsk

556 done557 done

557 ```558 ```

558 </Step>559 </Step>

559 560 

560 <Step title="Testez sur quelques fichiers, puis exécutez sur tous">561 <Step title="Testez sur quelques fichiers, puis exécutez sur tous">

561 Affinez votre invite en fonction de ce qui se passe mal avec les 2-3 premiers fichiers, puis exécutez sur l'ensemble complet. L'indicateur `--allowedTools` restreint ce que Claude peut faire, ce qui importe lorsque vous exécutez sans surveillance.562 Affinez votre prompt en fonction de ce qui se passe mal avec les 2-3 premiers fichiers, puis exécutez sur l'ensemble complet. Le flag `--allowedTools` pré-approuve les outils dont la migration a besoin, et [`--permission-mode dontAsk`](/docs/fr/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) refuse tout ce qui nécessiterait une approbation, ce qui importe lorsque vous exécutez sans surveillance.

562 </Step>563 </Step>

563</Steps>564</Steps>

564 565 


572 Exécutez de manière autonome avec le mode auto573 Exécutez de manière autonome avec le mode auto

573</h3>574</h3>

574 575 

575Pour une exécution ininterrompue avec des vérifications de sécurité en arrière-plan, utilisez le [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode). Un modèle classificateur examine les commandes avant qu'elles ne s'exécutent, bloquant l'escalade de portée, l'infrastructure inconnue et les actions motivées par du contenu hostile tout en laissant le travail de routine se dérouler sans invites.576Pour une exécution ininterrompue avec des vérifications de sécurité en arrière-plan, utilisez le [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode). Un modèle classifieur examine les commandes avant qu'elles ne s'exécutent, bloquant l'escalade de portée, l'infrastructure inconnue et les actions motivées par du contenu hostile tout en laissant le travail courant se dérouler sans demandes de permission.

576 577 

577```bash theme={null}578```bash theme={null}

578claude --permission-mode auto -p "fix all lint errors"579claude --permission-mode auto -p "fix all lint errors"

579```580```

580 581 

581Lorsque le classificateur bloque à plusieurs reprises les actions dans une exécution non interactive avec l'indicateur `-p`, Claude Code n'arrête pas l'exécution. Consultez [quand le mode auto se replie](/docs/fr/permission-modes#when-auto-mode-falls-back) pour ce qui se passe à la place et pour les seuils.582Lorsque le classifieur bloque à plusieurs reprises les actions dans une exécution non interactive avec le flag `-p`, Claude Code n'arrête pas l'exécution. Consultez [quand le mode auto se replie](/docs/fr/permission-modes#when-auto-mode-falls-back) pour ce qui se passe à la place et pour les seuils.

582 583 

583<h3 id="add-an-adversarial-review-step">584<h3 id="add-an-adversarial-review-step">

584 Ajoutez une étape d'examen contradictoire585 Ajoutez une étape d'examen contradictoire

585</h3>586</h3>

586 587 

587<Tip>588<Tip>

588 Avant de considérer une tâche comme terminée, demandez à un sous-agent d'examiner la diff dans un contexte frais et de signaler les lacunes.589 Avant de considérer une tâche comme terminée, demandez à un sous-agent d'examiner le diff dans un contexte frais et de signaler les lacunes.

589</Tip>590</Tip>

590 591 

591Plus Claude travaille sans surveillance, plus une vérification indépendante importe avant de compter le travail comme terminé. Un examinateur exécutant dans un contexte [sous-agent](/docs/fr/sub-agents) frais ne voit que la diff et les critères que vous lui donnez, pas le raisonnement qui a produit le changement, donc il évalue le résultat selon ses propres termes.592Plus Claude travaille sans surveillance, plus une vérification indépendante importe avant de compter le travail comme terminé. Un examinateur s'exécutant dans un contexte de [sous-agent](/docs/fr/sub-agents) frais ne voit que le diff et les critères que vous lui donnez, pas le raisonnement qui a produit le changement, donc il évalue le résultat selon ses propres termes.

592 593 

593Pour une vérification de la correction, exécutez la compétence [`/code-review`](/docs/fr/commands) fournie, qui examine la diff actuelle pour les bogues dans un sous-agent frais et retourne les résultats à la session. Pour vérifier la diff par rapport à votre plan à la place, écrivez vous-même l'invite d'examen. Nommez le travail à vérifier, le plan à vérifier et ce qui compte comme une constatation :594Pour une vérification de la correction, exécutez le [skill `/code-review`](/docs/fr/commands) fourni, qui examine le diff actuel à la recherche de bogues dans un sous-agent frais et retourne les résultats à la session. Pour vérifier le diff par rapport à votre plan à la place, écrivez vous-même le prompt d'examen. Nommez le travail à vérifier, le plan par rapport auquel le vérifier et ce qui compte comme une constatation :

594 595 

595```text wrap theme={null}596```text wrap theme={null}

596Use a subagent to review the rate limiter diff against PLAN.md. Check that597Use a subagent to review the rate limiter diff against PLAN.md. Check that


601Parce que l'examinateur s'exécute en tant que sous-agent, la session d'implémentation reçoit les lacunes directement et peut les corriger et les réexaminer sans que vous copiiez les résultats entre les fenêtres.602Parce que l'examinateur s'exécute en tant que sous-agent, la session d'implémentation reçoit les lacunes directement et peut les corriger et les réexaminer sans que vous copiiez les résultats entre les fenêtres.

602 603 

603<Callout>604<Callout>

604 Un examinateur invité à trouver des lacunes signalera généralement certaines, même lorsque le travail est solide, car c'est ce qu'on lui a demandé de faire. Poursuivre chaque constatation mène à une sur-ingénierie : couches d'abstraction supplémentaires, code défensif et tests pour des cas qui ne peuvent pas se produire. Dites à l'examinateur de signaler uniquement les lacunes qui affectent la correction ou les exigences énoncées, et traitez le reste comme optionnel.605 Un examinateur à qui l'on demande de trouver des lacunes en signalera généralement, même lorsque le travail est solide, car c'est ce qu'on lui a demandé de faire. Poursuivre chaque constatation mène à une sur-ingénierie : couches d'abstraction supplémentaires, code défensif et tests pour des cas qui ne peuvent pas se produire. Dites à l'examinateur de signaler uniquement les lacunes qui affectent la correction ou les exigences énoncées, et traitez le reste comme optionnel.

605</Callout>606</Callout>

606 607 

607***608***

channels.md +1 −1

Details

326 Activer les canaux pour votre organisation326 Activer les canaux pour votre organisation

327</h3>327</h3>

328 328 

329Activez les canaux pour votre organisation à partir de [**claude.ai → Admin settings → Claude Code → Channels**](https://claude.ai/admin-settings/claude-code), ce qui nécessite le rôle de propriétaire, ou en définissant `channelsEnabled` sur `true` dans les paramètres gérés.329Activez les canaux pour votre organisation à partir de [**Organization settings > Claude Code > Channels**](https://claude.ai/admin-settings/claude-code), ce qui nécessite le rôle de propriétaire, ou en définissant `channelsEnabled` sur `true` dans les paramètres gérés.

330 330 

331Une fois activés, les utilisateurs de votre organisation peuvent utiliser `--channels` pour opter pour les serveurs de canaux dans les sessions individuelles. Si le paramètre est désactivé ou non défini, le serveur MCP se connecte toujours et ses outils fonctionnent, mais les messages de canal n'arriveront pas. Un avertissement au démarrage indique à l'utilisateur de demander à un administrateur d'activer le paramètre.331Une fois activés, les utilisateurs de votre organisation peuvent utiliser `--channels` pour opter pour les serveurs de canaux dans les sessions individuelles. Si le paramètre est désactivé ou non défini, le serveur MCP se connecte toujours et ses outils fonctionnent, mais les messages de canal n'arriveront pas. Un avertissement au démarrage indique à l'utilisateur de demander à un administrateur d'activer le paramètre.

332 332 

Details

263 Connecter les développeurs263 Connecter les développeurs

264</h2>264</h2>

265 265 

266Les développeurs se connectent à partir de leurs propres ordinateurs portables avec une seule connexion au navigateur, en utilisant leur compte professionnel d'entreprise. Ils n'ont pas besoin d'un compte claude.ai, d'une clé API ou d'un abonnement, car les demandes au modèle passent par la passerelle en utilisant l'identifiant en amont de l'organisation. La connexion est pilotée par les [paramètres gérés côté client](/docs/fr/claude-apps-gateway-config#client-side-managed-settings) que vous poussez via MDM, il n'y a donc pas de configuration manuelle du côté du développeur ; cette section couvre ce que l'administrateur configure.266Les développeurs se connectent à partir de leurs propres ordinateurs portables avec une seule connexion au navigateur, en utilisant leur compte professionnel d'entreprise. Ils n'ont pas besoin d'un compte claude.ai, d'une clé API ou d'un abonnement, car les requêtes au modèle passent par la passerelle en utilisant l'identifiant en amont de l'organisation. La connexion est pilotée par les [paramètres gérés côté client](/docs/fr/claude-apps-gateway-config#client-side-managed-settings) que vous poussez via MDM, il n'y a donc pas de configuration manuelle du côté du développeur ; cette section couvre ce que l'administrateur configure.

267 267 

268L'interface de ligne de commande empreinte le certificat feuille TLS de la passerelle à la première connexion et l'épingle par nom d'hôte. Elle vérifie cette épingle à nouveau lors de la connexion, lors des rafraîchissements de session silencieux et lors des récupérations de paramètres gérés, tandis que les demandes d'inférence utilisent la validation TLS standard sans l'épingle. Les demandes acheminées via un proxy HTTPS ignorent la vérification de l'épingle, donc ajoutez l'hôte de la passerelle à `NO_PROXY` pour les garder directes.268L'interface de ligne de commande calcule l'empreinte du certificat feuille TLS de la passerelle à la première connexion et l'épingle par nom d'hôte. Elle vérifie cette épingle à nouveau lors de la connexion, lors des rafraîchissements de session silencieux et lors des récupérations de paramètres gérés, tandis que les requêtes d'inférence utilisent la validation TLS standard sans l'épingle. Les requêtes acheminées via un proxy HTTPS ignorent la vérification de l'épingle, donc ajoutez l'hôte de la passerelle à `NO_PROXY` pour les garder directes.

269 269 

270Publiez l'empreinte SHA-256 attendue aux côtés de l'URL de la passerelle pour que les développeurs aient quelque chose à comparer. L'invite `/login` affiche les 16 premiers caractères de l'empreinte en hexadécimal minuscule sans deux-points. Pour imprimer l'empreinte complète sous cette forme à partir du fichier de certificat, exécutez :270Publiez l'empreinte SHA-256 attendue aux côtés de l'URL de la passerelle pour que les développeurs aient quelque chose à comparer. L'invite `/login` affiche les 16 premiers caractères de l'empreinte en hexadécimal minuscule sans deux-points. Pour imprimer l'empreinte complète sous cette forme à partir du fichier de certificat, exécutez :

271 271 


273openssl x509 -noout -fingerprint -sha256 -in cert.pem | cut -d= -f2 | tr -d : | tr 'A-F' 'a-f'273openssl x509 -noout -fingerprint -sha256 -in cert.pem | cut -d= -f2 | tr -d : | tr 'A-F' 'a-f'

274```274```

275 275 

276Quand le certificat tourne, chaque développeur voit à nouveau l'invite de confiance, traitez donc les rotations comme un événement planifié et republier l'empreinte. Si votre politique de passerelle inclut [des paramètres qui nécessitent une approbation](/docs/fr/server-managed-settings#security-approval-dialogs), le développeur voit également ce dialogue d'approbation à nouveau après avoir accepté le nouveau certificat, car Claude Code associe la [mémoire d'approbation](/docs/fr/server-managed-settings#approval-memory) au certificat épinglé.276Quand le certificat tourne, chaque développeur voit à nouveau l'invite de confiance, traitez donc les rotations comme un événement planifié et republiez l'empreinte. Si votre politique de passerelle inclut [des paramètres qui nécessitent une approbation](/docs/fr/server-managed-settings#security-approval-dialogs), le développeur voit également ce dialogue d'approbation à nouveau après avoir accepté le nouveau certificat, car Claude Code associe la [mémoire d'approbation](/docs/fr/server-managed-settings#approval-memory) au certificat épinglé.

277 277 

278Une passerelle peut retourner le champ optionnel `email` dans sa réponse de jeton pour nommer le compte qu'une connexion a utilisé. Quand elle le fait, le développeur confirme le compte avant que Claude Code ne sauvegarde l'identifiant. Après une connexion confirmée, `/status` affiche le compte.278Une passerelle peut retourner le champ optionnel `email` dans sa réponse de jeton pour nommer le compte qu'une connexion a utilisé. Quand elle le fait, le développeur confirme le compte avant que Claude Code ne sauvegarde l'identifiant. Après une connexion confirmée, `/status` affiche le compte.

279 279 


287 Définir l'URL de la passerelle287 Définir l'URL de la passerelle

288</h3>288</h3>

289 289 

290Trois clés vont dans le fichier de [paramètres gérés](/docs/fr/managed-settings#delivery-mechanisms) par système d'exploitation que vous déployez via MDM ou directement sur le disque. `forceLoginMethod` et `forceLoginGatewayUrl` ouvrent `/login` directement sur l'écran **Cloud gateway** avec l'URL remplie, et `parentSettingsBehavior: "merge"` permet à Claude Desktop de livrer la liste d'autorisation de sortie de la passerelle aux sessions Claude Code qu'il lance, expliqué dans [Livrer la politique à Claude Desktop sessions](#deliver-policy-to-claude-desktop-sessions) :290Trois clés vont dans le fichier de [paramètres gérés](/docs/fr/managed-settings#delivery-mechanisms) par système d'exploitation que vous déployez via MDM ou directement sur le disque. `forceLoginMethod` et `forceLoginGatewayUrl` ouvrent `/login` directement sur l'écran **Cloud gateway** avec l'URL remplie, et `parentSettingsBehavior: "merge"` permet à Claude Desktop de livrer la liste d'autorisation de sortie de la passerelle aux sessions Claude Code qu'il lance, expliqué dans [Livrer la politique aux sessions Claude Desktop](#deliver-policy-to-claude-desktop-sessions) :

291 291 

292```json theme={null}292```json theme={null}

293{293{


299 299 

300Le développeur appuie sur Entrée pour se connecter. L'invite d'empreinte TLS de [première connexion](#connect-developers) apparaît toujours. Une fois le fichier sur une machine, un développeur qui n'a pas complété la connexion à la passerelle voit l'un des messages décrits sous [La politique d'administrateur nécessite une connexion Cloud gateway](/docs/fr/errors#administrator-policy-requires-a-cloud-gateway-sign-in). Les développeurs qui sélectionnent un fournisseur cloud via une variable d'environnement telle que `CLAUDE_CODE_USE_BEDROCK` n'ont pas besoin de la connexion à la passerelle.300Le développeur appuie sur Entrée pour se connecter. L'invite d'empreinte TLS de [première connexion](#connect-developers) apparaît toujours. Une fois le fichier sur une machine, un développeur qui n'a pas complété la connexion à la passerelle voit l'un des messages décrits sous [La politique d'administrateur nécessite une connexion Cloud gateway](/docs/fr/errors#administrator-policy-requires-a-cloud-gateway-sign-in). Les développeurs qui sélectionnent un fournisseur cloud via une variable d'environnement telle que `CLAUDE_CODE_USE_BEDROCK` n'ont pas besoin de la connexion à la passerelle.

301 301 

302Un développeur ne peut pas configurer cela manuellement. Le sélecteur de connexion n'a pas d'option de passerelle, et `forceLoginGatewayUrl` est ignoré dans les fichiers de paramètres propres d'un développeur. `forceLoginMethod` seul, sans URL, laisse le développeur à un message « Contactez votre administrateur informatique ». Les clés de connexion appartiennent au fichier que vous poussez vers les machines, pas au bloc `managed.policies[].cli` de la passerelle, qui ne atteint que les clients déjà connectés.302Un développeur ne peut pas configurer cela manuellement. Le sélecteur de connexion n'a pas d'option de passerelle, et `forceLoginGatewayUrl` est ignoré dans les fichiers de paramètres propres d'un développeur. `forceLoginMethod` seul, sans URL, laisse le développeur à un message « Contactez votre administrateur informatique ». Les clés de connexion appartiennent au fichier que vous poussez vers les machines, pas au bloc `managed.policies[].cli` de la passerelle, qui n'atteint que les clients déjà connectés.

303 303 

304<h3 id="allow-a-gateway-on-public-address-space-you-own">304<h3 id="allow-a-gateway-on-public-address-space-you-own">

305 Autoriser une passerelle sur l'espace d'adresses publiques que vous possédez305 Autoriser une passerelle sur l'espace d'adresses publiques que vous possédez


310<Warning>310<Warning>

311 `gatewayInternalNetworks` est pour les réseaux internes qui se trouvent être numérotés à partir de l'espace d'adresses public. Cela ne rend pas sûr d'exposer une passerelle à Internet : une passerelle de confiance peut pousser des paramètres qui exécutent des commandes sur les machines des développeurs.311 `gatewayInternalNetworks` est pour les réseaux internes qui se trouvent être numérotés à partir de l'espace d'adresses public. Cela ne rend pas sûr d'exposer une passerelle à Internet : une passerelle de confiance peut pousser des paramètres qui exécutent des commandes sur les machines des développeurs.

312 312 

313 Gardez la passerelle inaccessible de l'extérieur de votre réseau avec vos règles de pare-feu ou d'équilibreur de charge. Définissez le [`access_control.allow_cidrs`](/docs/fr/claude-apps-gateway-config#http-tuning) de la passerelle aux mêmes blocs que vous déclarez ici, donc la passerelle elle-même refuse les clients de n'importe où ailleurs. Derrière un équilibreur de charge ou une entrée, définissez également `listen.trusted_proxies` à ce front-end, car la passerelle sinon correspond à `allow_cidrs` par rapport à l'adresse propre du front-end plutôt qu'à celle du développeur.313 Gardez la passerelle inaccessible de l'extérieur de votre réseau avec vos règles de pare-feu ou d'équilibreur de charge. Définissez le [`access_control.allow_cidrs`](/docs/fr/claude-apps-gateway-config#http-tuning) de la passerelle aux mêmes blocs que vous déclarez ici, afin que la passerelle elle-même refuse les clients de n'importe où ailleurs. Derrière un équilibreur de charge ou une entrée, définissez également `listen.trusted_proxies` à ce front-end, car la passerelle sinon compare `allow_cidrs` à l'adresse propre du front-end plutôt qu'à celle du développeur.

314</Warning>314</Warning>

315 315 

316Ajoutez la clé à la même source de paramètres gérés que les clés de connexion : le fichier de paramètres gérés, le profil MDM, ou la politique de registre. Claude Code l'ignore dans les paramètres utilisateur, projet et gérés par serveur.316Ajoutez la clé à la même source de paramètres gérés que les clés de connexion : le fichier de paramètres gérés, le profil MDM, ou la politique de registre. Claude Code l'ignore dans les paramètres utilisateur, projet et gérés par serveur.


332 332 

333Les blocs de `managed-settings.json` et ses fichiers drop-in `managed-settings.d/` se combinent en une liste, et ces limites s'appliquent à la liste combinée. Pour réduire un bloc, remplacez son entrée plutôt que d'en ajouter une deuxième qui se chevauche dans un drop-in ; `/login` refuse le chevauchement.333Les blocs de `managed-settings.json` et ses fichiers drop-in `managed-settings.d/` se combinent en une liste, et ces limites s'appliquent à la liste combinée. Pour réduire un bloc, remplacez son entrée plutôt que d'en ajouter une deuxième qui se chevauche dans un drop-in ; `/login` refuse le chevauchement.

334 334 

335Si une entrée casse une règle, ou la valeur n'est pas une liste de chaînes, Claude Code refuse chaque nouvelle connexion à la passerelle sur cette machine et nomme le problème dans le message. La connexion à une passerelle sur une adresse privée échoue aussi, et les connexions existantes continuent de fonctionner. Essayez la valeur sur une machine avant de la déployer. Claude Code liste également une valeur mal typée parmi les [paramètres gérés invalides qu'il rapporte](/docs/fr/managed-settings#keys-that-fail-closed).335Si une entrée enfreint une règle, ou si la valeur n'est pas une liste de chaînes, Claude Code refuse chaque nouvelle connexion à la passerelle sur cette machine et nomme le problème dans le message. La connexion à une passerelle sur une adresse privée échoue aussi, et les connexions existantes continuent de fonctionner. Essayez la valeur sur une machine avant de la déployer. Claude Code liste également une valeur mal typée parmi les [paramètres gérés invalides qu'il rapporte](/docs/fr/managed-settings#keys-that-fail-closed).

336 336 

337Avec une liste valide, `/login` applique trois vérifications à une passerelle dont l'adresse est à l'intérieur d'un bloc listé :337Avec une liste valide, `/login` applique trois vérifications à une passerelle dont l'adresse est à l'intérieur d'un bloc listé :

338 338 


342 342 

343Quand les trois passent, l'[invite de confiance](#connect-developers) ajoute une ligne nommant l'adresse de la machine, l'adresse de la passerelle, et le bloc déclaré qui contient les deux.343Quand les trois passent, l'[invite de confiance](#connect-developers) ajoute une ligne nommant l'adresse de la machine, l'adresse de la passerelle, et le bloc déclaré qui contient les deux.

344 344 

345La clé ne change rien pour les autres passerelles : la connexion à une sur une adresse privée fonctionne comme avant, et la connexion à une sur une adresse publique en dehors de chaque bloc listé est refusée comme avant.345La clé ne change rien pour les autres passerelles : la connexion à une passerelle sur une adresse privée fonctionne comme avant, et la connexion à une passerelle sur une adresse publique en dehors de chaque bloc listé est refusée comme avant.

346 346 

347Un bloc déclaré restreint qui peut se connecter mais ne prouve pas où se trouve une machine, donc déclarez uniquement l'espace d'adresses que votre organisation contrôle. Un bloc partagé avec d'autres locataires, comme une plage publique d'un fournisseur cloud, laisse n'importe qui dedans passer la même vérification.347Un bloc déclaré restreint qui peut se connecter mais ne prouve pas où se trouve une machine, donc déclarez uniquement l'espace d'adresses que votre organisation contrôle. Un bloc partagé avec d'autres locataires, comme une plage publique d'un fournisseur cloud, laisse n'importe qui dedans passer la même vérification.

348 348 

349<h3 id="deliver-policy-to-claude-desktop-sessions">349<h3 id="deliver-policy-to-claude-desktop-sessions">

350 Livrer la politique à Claude Desktop sessions350 Livrer la politique aux sessions Claude Desktop

351</h3>351</h3>

352 352 

353Claude Desktop exécute ses onglets Cowork et Code, plus l'onglet Chat quand vous l'activez, sur des sessions Claude Code intégrées et envoie leurs demandes de modèle à travers la passerelle. Il transmet la politique à chacune de ces sessions, construite à partir de la configuration que la passerelle lui sert à `/user/bootstrap` : la liste d'autorisation des modèles, les outils désactivés, et la liste d'autorisation de sortie dérivée du bloc `cli` de la politique correspondante, plus la [superposition `desktop`](/docs/fr/claude-apps-gateway-config#claude-desktop-overlay).353Claude Desktop exécute ses onglets Cowork et Code, plus l'onglet Chat quand vous l'activez, sur des sessions Claude Code intégrées et envoie leurs requêtes de modèle à travers la passerelle. Il transmet la politique à chacune de ces sessions, construite à partir de la configuration que la passerelle lui sert à `/user/bootstrap` : la liste d'autorisation des modèles, les outils désactivés, et la liste d'autorisation de sortie dérivée du bloc `cli` de la politique correspondante, plus la [superposition `desktop`](/docs/fr/claude-apps-gateway-config#claude-desktop-overlay).

354 354 

355D'autres clés `cli`, telles que hooks, `env`, et les règles de permission délimitées comme `Bash(npm *)`, ne sont accessibles qu'aux clients qui se connectent via `/login`. Claude Desktop lit l'URL de la passerelle à partir de sa propre configuration gérée et se connecte avec son propre flux, séparé des clés `forceLoginMethod` et `forceLoginGatewayUrl` dans [Définir l'URL de la passerelle](#set-the-gateway-url).355D'autres clés `cli`, telles que les hooks, `env`, et les règles de permission délimitées comme `Bash(npm *)`, ne sont accessibles qu'aux clients qui se connectent via `/login`. Claude Desktop lit l'URL de la passerelle à partir de sa propre configuration gérée et se connecte avec son propre flux, séparé des clés `forceLoginMethod` et `forceLoginGatewayUrl` dans [Définir l'URL de la passerelle](#set-the-gateway-url).

356 356 

357Les paramètres transmis par un processus de lancement sont des paramètres parents. Claude Code ignore les paramètres parents sur toute machine qui a une source gérée déployée par un administrateur, sauf si la [source qui livre la politique](/docs/fr/managed-settings#which-managed-source-claude-code-uses) définit `parentSettingsBehavior: "merge"`.357Les paramètres transmis par un processus de lancement sont des paramètres parents. Claude Code ignore les paramètres parents sur toute machine qui a une source gérée déployée par un administrateur, sauf si la [source qui livre la politique](/docs/fr/managed-settings#which-managed-source-claude-code-uses) définit `parentSettingsBehavior: "merge"`.

358 358 


360 Quelles machines ont besoin de l'opt-in360 Quelles machines ont besoin de l'opt-in

361</h4>361</h4>

362 362 

363Les machines qui exécutent uniquement Claude Desktop en ont besoin. Claude Desktop applique la liste des modèles et la liste des outils désactivés aux sessions intégrées elle-même, mais la liste d'autorisation de sortie ne les atteint que comme paramètres parents, sous la forme de règles de domaine `WebFetch` et de règles de réseau sandbox. Sans l'opt-in, ces sessions s'exécutent sans la restriction de sortie, et rien ne vous avertit. La passerelle rejette toujours les demandes d'inférence pour les modèles que la politique n'accorde pas.363Les machines qui exécutent uniquement Claude Desktop en ont besoin. Claude Desktop applique lui-même la liste des modèles et la liste des outils désactivés aux sessions intégrées, mais la liste d'autorisation de sortie ne les atteint que comme paramètres parents, sous la forme de règles de domaine `WebFetch` et de règles de réseau sandbox. Sans l'opt-in, ces sessions s'exécutent sans la restriction de sortie, et rien ne vous avertit. La passerelle rejette toujours les requêtes d'inférence pour les modèles que la politique n'accorde pas.

364 364 

365Une liste d'autorisation de marché de plugins atteint également les sessions intégrées uniquement comme paramètres parents. Quand vous désactivez les marchés de plugins ajoutés par l'utilisateur dans la configuration gérée de Claude Desktop, Claude Desktop 2.16120.0 ou ultérieur masque les marchés que votre organisation n'a pas provisionné et refuse les installations à partir d'eux. Pour empêcher les sessions intégrées de charger les plugins déjà installés à partir de ces marchés, il leur envoie une liste `strictKnownMarketplaces` comme paramètres parents. Sans l'opt-in, Claude Code ignore cette liste, et ces plugins continuent de charger.365Une liste d'autorisation de marketplaces de plugins atteint également les sessions intégrées uniquement comme paramètres parents. Quand vous désactivez les marketplaces de plugins ajoutées par l'utilisateur dans la configuration gérée de Claude Desktop, Claude Desktop 2.16120.0 ou ultérieur masque les marketplaces que votre organisation n'a pas provisionnées et refuse les installations à partir d'elles. Pour empêcher les sessions intégrées de charger les plugins déjà installés à partir de ces marketplaces, il leur envoie une liste `strictKnownMarketplaces` comme paramètres parents. Sans l'opt-in, Claude Code ignore cette liste, et ces plugins continuent de se charger.

366 366 

367Les machines où les développeurs se connectent via `/login` n'en ont pas besoin ; chaque session Claude Code récupère sa politique auprès de la passerelle.367Les machines où les développeurs se connectent via `/login` n'en ont pas besoin ; chaque session Claude Code récupère sa politique auprès de la passerelle.

368 368 


372 Définir l'opt-in372 Définir l'opt-in

373</h4>373</h4>

374 374 

375Déployez l'extrait de paramètres gérés à partir de [Définir l'URL de la passerelle](#set-the-gateway-url), miroir-le vers toute source côté client qui surclasse le fichier, puis vérifiez.375Déployez l'extrait de paramètres gérés de [Définir l'URL de la passerelle](#set-the-gateway-url), reproduisez-le dans toute source côté client qui surclasse le fichier, puis vérifiez.

376 376 

377<Steps>377<Steps>

378 <Step title="Déployer l'opt-in dans le fichier de paramètres gérés">378 <Step title="Déployer l'opt-in dans le fichier de paramètres gérés">

379 L'[extrait ci-dessus](#set-the-gateway-url) inclut déjà `parentSettingsBehavior: "merge"`, donc le fichier que vous poussez vers les machines le porte.379 L'[extrait ci-dessus](#set-the-gateway-url) inclut déjà `parentSettingsBehavior: "merge"`, donc le fichier que vous poussez vers les machines le porte.

380 </Step>380 </Step>

381 381 

382 <Step title="Miroir l'extrait vers toute source qui surclasse le fichier">382 <Step title="Reproduire l'extrait dans toute source qui surclasse le fichier">

383 Claude Code lit `parentSettingsBehavior` uniquement à partir de la [source sélectionnée](/docs/fr/managed-settings#which-managed-source-claude-code-uses). Ajouter une clé de politique à une source peut faire de cette source la source sélectionnée, donc dans une source côté client, miroir l'extrait entier plutôt que `parentSettingsBehavior` seul. [Les paramètres gérés côté client](/docs/fr/claude-apps-gateway-config#client-side-managed-settings) couvrent les flottes qui livrent la politique via Group Policy ou les profils de configuration. Une plist de préférences gérées sur macOS ou une politique HKLM sur Windows surclasse le fichier `managed-settings.json`, et les paramètres gérés distants de la passerelle surclassent les deux, donc sur les machines qui se connectent à la passerelle, définissez également `parentSettingsBehavior` dans le bloc [`cli`](/docs/fr/claude-apps-gateway-config#managed) de la politique de la passerelle.383 Claude Code lit `parentSettingsBehavior` uniquement à partir de la [source sélectionnée](/docs/fr/managed-settings#which-managed-source-claude-code-uses). Ajouter une clé de politique à une source peut faire de cette source la source sélectionnée, donc dans une source côté client, reproduisez l'extrait entier plutôt que `parentSettingsBehavior` seul. [Les paramètres gérés côté client](/docs/fr/claude-apps-gateway-config#client-side-managed-settings) couvrent les flottes qui livrent la politique via Group Policy ou les profils de configuration. Une plist de préférences gérées sur macOS ou une politique HKLM sur Windows surclasse le fichier `managed-settings.json`, et les paramètres gérés distants de la passerelle surclassent les deux, donc sur les machines qui se connectent à la passerelle, définissez également `parentSettingsBehavior` dans le bloc [`cli`](/docs/fr/claude-apps-gateway-config#managed) de la politique de la passerelle.

384 </Step>384 </Step>

385 385 

386 <Step title="Vérifier quelle source est sélectionnée">386 <Step title="Vérifier quelle source est sélectionnée">


394 394 

395Une fois que vous déployez `parentSettingsBehavior: "merge"`, tout processus hôte qui lance Claude Code peut fournir des paramètres parents, non seulement Claude Desktop mais aussi une application SDK Agent ou une extension IDE.395Une fois que vous déployez `parentSettingsBehavior: "merge"`, tout processus hôte qui lance Claude Code peut fournir des paramètres parents, non seulement Claude Desktop mais aussi une application SDK Agent ou une extension IDE.

396 396 

397Claude Code filtre les paramètres parents par rapport à une liste d'autorisation de clés restrictives, mais certaines clés autorisées peuvent accorder l'accès plutôt que de le restreindre. À moins que vous définissiez les verrous `allowManaged*Only`, les règles d'autorisation de permission et les listes d'autorisation sandbox fournies par l'hôte s'appliquent toujours. Les règles de refus et de demande de votre politique restent en vigueur de toute façon ; [elles sont évaluées avant toute règle d'autorisation](/docs/fr/permissions#manage-permissions).397Claude Code filtre les paramètres parents par rapport à une liste d'autorisation de clés restrictives, mais certaines clés autorisées peuvent accorder l'accès plutôt que de le restreindre. À moins que vous ne définissiez les verrous `allowManaged*Only`, les règles d'autorisation de permission et les listes d'autorisation sandbox fournies par l'hôte s'appliquent toujours. Les règles de refus et de demande de votre politique restent en vigueur de toute façon ; [elles sont évaluées avant toute règle d'autorisation](/docs/fr/permissions#manage-permissions).

398 398 

399Claude Code transmet les entrées [`sandbox.credentials`](/docs/fr/settings-reference#sandbox-credentials) fournies par le parent sous forme dépouillée :399Claude Code transmet les entrées [`sandbox.credentials`](/docs/fr/settings-reference#sandbox-credentials) fournies par le parent sous forme dépouillée :

400 400 

401* **Entrées `deny`** : transmises avec uniquement leur `path` ou `name` et le mode.401* **Entrées `deny`** : transmises avec uniquement leur `path` ou `name` et le mode.

402* **Entrées de fichier avec [`mode: mask`](/docs/fr/sandboxing#mask-credential-files)** : transmises uniquement sentinelle, comme un masque de fichier entier dont `injectHosts` est la liste vide, donc le proxy ne substitue jamais la valeur réelle pour une entrée fournie par le parent sur aucune plateforme. Tous les champs de masquage structuré sont également supprimés, donc un modèle d'extraction fourni par le parent ne peut pas déplacer un masque plus strict qu'une autre source définit pour le même chemin.402* **Entrées de fichier avec [`mode: mask`](/docs/fr/sandboxing#mask-credential-files)** : transmises en sentinelle uniquement, comme un masque de fichier entier dont `injectHosts` est la liste vide, donc le proxy ne substitue jamais la valeur réelle pour une entrée fournie par le parent sur aucune plateforme. Tous les champs de masquage structuré sont également supprimés, donc un modèle d'extraction fourni par le parent ne peut pas supplanter un masque plus strict qu'une autre source définit pour le même chemin.

403* **Entrées `envVars` avec `mode: mask`** : non transmises. `deny` est la seule restriction que le canal parent peut exprimer via les entrées `envVars`.403* **Entrées `envVars` avec `mode: mask`** : non transmises. `deny` est la seule restriction que le canal parent peut exprimer via les entrées `envVars`.

404* **[`awsPairs` et `sigv4`](/docs/fr/sandboxing#re-sign-aws-requests)** : transmises restriction-uniquement. À partir de `sigv4`, seules les valeurs `deny` sont conservées, et un parent qui définit un bloc `sigv4` du tout épingle les trois formes de demande, `streaming`, `presigned`, et `sigv4a`, à `deny`. Une paire `awsPairs` n'est jamais transmise sous une forme qui peut re-signer ; une paire qui nomme l'une des variables AWS conventionnelles est remplacée par une entrée inerte qui maintient l'appairage automatique de `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, et `AWS_SESSION_TOKEN` supprimé.404* **[`awsPairs` et `sigv4`](/docs/fr/sandboxing#re-sign-aws-requests)** : transmises en restriction uniquement. À partir de `sigv4`, seules les valeurs `deny` sont conservées, et un parent qui définit un bloc `sigv4`, quel qu'il soit, épingle les trois formes de requête, `streaming`, `presigned`, et `sigv4a`, à `deny`. Une paire `awsPairs` n'est jamais transmise sous une forme qui peut re-signer ; une paire qui nomme l'une des variables AWS conventionnelles est remplacée par une entrée inerte qui maintient supprimé l'appairage automatique de `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, et `AWS_SESSION_TOKEN`.

405 405 

406<h4 id="deploy-the-locks">406<h4 id="deploy-the-locks">

407 Déployer les verrous407 Déployer les verrous

408</h4>408</h4>

409 409 

410Pour garder les paramètres parents aussi proches de restriction-uniquement que le filtre le supporte, ajoutez les cinq verrous `allowManaged*Only`, et les listes d'autorisation qu'ils gouvernent, aux mêmes sources que l'opt-in de fusion :410Pour garder les paramètres parents aussi proches d'une restriction pure que le filtre le permet, ajoutez les cinq verrous `allowManaged*Only`, et les listes d'autorisation qu'ils gouvernent, aux mêmes sources que l'opt-in de fusion :

411 411 

412```json theme={null}412```json theme={null}

413{413{


432}432}

433```433```

434 434 

435Une politique du système d'exploitation, telle qu'une politique de registre HKLM ou une plist de préférences gérées, surclasse ce fichier, donc livrez l'extrait entier via celui-ci au lieu du fichier. Les paramètres gérés distants de la passerelle surclassent la politique du système d'exploitation et les sources de fichiers mais ne sont accessibles qu'aux clients connectés. Miroir les verrous, les listes d'autorisation, et l'opt-in de fusion dans le bloc [`cli`](/docs/fr/claude-apps-gateway-config#managed) de la politique et gardez ce fichier déployé, car les machines qui ne se connectent jamais, y compris celles qui exécutent uniquement Claude Desktop, obtiennent leur politique du fichier seul.435Une politique du système d'exploitation, telle qu'une politique de registre HKLM ou une plist de préférences gérées, surclasse ce fichier, donc livrez l'extrait entier via celle-ci au lieu du fichier. Les paramètres gérés distants de la passerelle surclassent la politique du système d'exploitation et les sources de fichiers mais ne sont accessibles qu'aux clients connectés. Reproduisez les verrous, les listes d'autorisation, et l'opt-in de fusion dans le bloc [`cli`](/docs/fr/claude-apps-gateway-config#managed) de la politique et gardez ce fichier déployé, car les machines qui ne se connectent jamais, y compris celles qui exécutent uniquement Claude Desktop, obtiennent leur politique du fichier seul.

436 436 

437<h4 id="lock-behavior-across-sources">437<h4 id="lock-behavior-across-sources">

438 Comportement des verrous entre les sources438 Comportement des verrous entre les sources


440 440 

441Définir un verrou ne restreint pas les autres ; chaque clé est documentée dans la [référence des paramètres](/docs/fr/settings-reference#all-settings).441Définir un verrou ne restreint pas les autres ; chaque clé est documentée dans la [référence des paramètres](/docs/fr/settings-reference#all-settings).

442 442 

443À partir d'une source d'administrateur en dessous du gagnant, les deux verrous sandbox s'appliquent toujours, et `allowManagedPermissionRulesOnly` bloque toujours les règles d'autorisation fournies par le parent et `additionalDirectories`. Sur Claude Code v2.1.273 ou ultérieur, le verrou serveur MCP s'applique également à partir d'une source en dessous du gagnant, et tandis qu'il est activé, la liste gérée `allowedMcpServers` provient de la source d'administrateur de plus haute priorité qui en définit une.443À partir d'une source d'administration en dessous de la gagnante, les deux verrous sandbox s'appliquent toujours, et `allowManagedPermissionRulesOnly` bloque toujours les règles d'autorisation fournies par le parent et `additionalDirectories`. Sur Claude Code v2.1.273 ou ultérieur, le verrou des serveurs MCP s'applique également à partir d'une source en dessous de la gagnante, et tant qu'il est activé, la liste gérée `allowedMcpServers` provient de la source d'administration de plus haute priorité qui en définit une.

444 444 

445Les verrous hooks et `allowManagedPermissionRulesOnly`'s effet sur les règles propres du développeur ont besoin de la source gagnante par défaut ; sous l'opt-in de fusion `managedSourcesBehavior` dans [comment Claude Code combine les sources gérées](/docs/fr/managed-settings#how-claude-code-combines-managed-sources), Claude Code applique la valeur la plus stricte que toute source définit pour chaque verrou. Sur les flottes [`policyHelper`](/docs/fr/settings-reference#policyhelper), Claude Code lit les verrous à partir de la sortie du helper seule.445Le verrou des hooks et l'effet de `allowManagedPermissionRulesOnly` sur les règles propres du développeur nécessitent par défaut la source gagnante ; sous l'opt-in de fusion `managedSourcesBehavior` dans [comment Claude Code combine les sources gérées](/docs/fr/managed-settings#how-claude-code-combines-managed-sources), Claude Code applique la valeur la plus stricte que toute source définit pour chaque verrou. Sur les flottes [`policyHelper`](/docs/fr/settings-reference#policyhelper), Claude Code lit les verrous à partir de la sortie du helper seule.

446 446 

447Chaque verrou fait que Claude Code ignore les entrées propres du développeur pour ce paramètre, donc incluez les listes d'autorisation de votre organisation à côté des verrous :447Chaque verrou fait que Claude Code ignore les entrées propres du développeur pour ce paramètre, donc incluez les listes d'autorisation de votre organisation à côté des verrous :

448 448 

449* **Domaines réseau** : verrouiller avec une liste de domaines gérés vide bloque tout le trafic sortant en sandbox.449* **Domaines réseau** : verrouiller avec une liste de domaines gérés vide bloque tout le trafic sortant en sandbox.

450* **Serveurs MCP** : verrouiller sans `allowedMcpServers` gérés ou fournis par le parent charge chaque serveur que `deniedMcpServers` ne bloque pas.450* **Serveurs MCP** : verrouiller sans `allowedMcpServers` dans aucune source d'administration ni dans les paramètres fournis par le parent charge chaque serveur que `deniedMcpServers` ne bloque pas.

451* **Chemins de lecture** : les entrées `allowRead` ne réautorisent que les chemins à l'intérieur des régions `denyRead`, donc associez-les à un `denyRead` gérés.451* **Chemins de lecture** : les entrées `allowRead` ne réautorisent que les chemins à l'intérieur des régions `denyRead`, donc associez-les à un `denyRead` géré.

452 452 

453<h4 id="settings-the-locks-don’t-cover">453<h4 id="settings-the-locks-don’t-cover">

454 Paramètres que les verrous ne couvrent pas454 Paramètres que les verrous ne couvrent pas

455</h4>455</h4>

456 456 

457Six paramètres fournis par le parent passent le filtre même avec les cinq verrous définis. Sous le paramètre par défaut premier-gagnant, la valeur d'administrateur qui bloque celle du parent est celle dans la source d'administrateur de plus haute priorité, sauf pour `allowedMcpServers` tandis que le [verrou serveur MCP](#lock-behavior-across-sources) est activé. Sous l'opt-in de fusion `managedSourcesBehavior`, [comment Claude Code combine les sources gérées](/docs/fr/managed-settings#how-claude-code-combines-managed-sources) dit quelle valeur de source s'applique à la place.457Ces paramètres fournis par le parent passent le filtre même avec les cinq verrous définis :

458 458 

459* **`forceLoginOrgUUID`** : Claude Code honore une valeur fournie par le parent quand la source d'administrateur de plus haute priorité ne définit pas un UUID d'organisation. La connexion à la passerelle ne vérifie pas cette clé. Un UUID d'organisation dans la source d'administrateur de plus haute priorité bloque la valeur du parent et est celui que Claude Code applique.459* **`forceLoginOrgUUID`** : Claude Code honore une valeur fournie par le parent quand la source d'administration de plus haute priorité ne définit pas d'UUID d'organisation. La connexion à la passerelle ne vérifie pas cette clé. Un UUID d'organisation dans la source d'administration de plus haute priorité bloque la valeur du parent et est celui que Claude Code applique.

460* **`allowedMcpServers`** : Claude Code honore une liste d'autorisation fournie par le parent quand aucune liste d'administrateur n'est en vigueur. `allowManagedMcpServersOnly` ne la bloque pas, car le verrou applique quelle que soit la liste qui gagne comme valeur gérée, y compris une liste fournie par le parent quand aucune source d'administrateur n'en fournit une. Une liste dans la source d'administrateur de plus haute priorité bloque celle du parent et est la liste que Claude Code applique, donc définissez `allowedMcpServers` là, à côté du verrou. Avant v2.1.223, une valeur pour l'une ou l'autre clé dans toute source d'administrateur bloquait celle du parent.460* **`allowedMcpServers`** : Claude Code honore une liste d'autorisation fournie par le parent quand aucune liste d'administration n'est en vigueur. `allowManagedMcpServersOnly` ne la bloque pas, car le verrou applique la liste qui l'emporte comme valeur gérée, y compris une liste fournie par le parent quand aucune source d'administration n'en fournit une. Une liste dans la source d'administration de plus haute priorité bloque celle du parent et est la liste que Claude Code applique, donc définissez `allowedMcpServers` là, à côté du verrou. Avant v2.1.223, une valeur pour l'une ou l'autre clé dans toute source d'administration bloquait celle du parent.

461* **`availableModels`** : Claude Code honore une liste de modèles fournie par le parent quand la source gérée gagnante n'en définit pas. Si votre flotte restreint les modèles, définissez `availableModels` dans la source gagnante.461* **`availableModels`** : Claude Code honore une liste de modèles fournie par le parent quand la source gérée gagnante n'en définit pas. Si votre flotte restreint les modèles, définissez `availableModels` dans la source gagnante.

462* **`strictKnownMarketplaces`** : Claude Code honore une liste d'autorisation de marché de plugins fournie par le parent quand la source gérée gagnante n'en définit pas. Claude Desktop 2.16120.0 ou ultérieur envoie une quand sa configuration gérée désactive les marchés de plugins ajoutés par l'utilisateur. Si votre flotte restreint les marchés, définissez `strictKnownMarketplaces` dans la source gagnante. Nécessite Claude Code v2.1.282 ou ultérieur.462* **`allowedProviders`** : Claude Code honore une liste d'autorisation de fournisseurs d'API fournie par le parent quand la source gérée gagnante n'en définit pas. Si votre flotte restreint les fournisseurs d'API que les développeurs peuvent utiliser, définissez `allowedProviders` dans la source gagnante. Nécessite Claude Code v2.1.285 ou ultérieur.

463* **`blockedMarketplaces`** : une liste de blocage de marché fournie par le parent passe et s'ajoute à toute liste de blocage qu'une source gérée définit, puisqu'une liste de blocage ne peut que restreindre davantage. Nécessite Claude Code v2.1.282 ou ultérieur.463* **`strictKnownMarketplaces`** : Claude Code honore une liste d'autorisation de marketplaces de plugins fournie par le parent quand la source gérée gagnante n'en définit pas. Claude Desktop 2.16120.0 ou ultérieur en envoie une quand sa configuration gérée désactive les marketplaces de plugins ajoutées par l'utilisateur. Si votre flotte restreint les marketplaces, définissez `strictKnownMarketplaces` dans la source gagnante. Nécessite Claude Code v2.1.282 ou ultérieur.

464* **`blockedMarketplaces`** : une liste de blocage de marketplaces fournie par le parent passe et s'ajoute à toute liste de blocage qu'une source gérée définit, puisqu'une liste de blocage ne peut que restreindre davantage. Nécessite Claude Code v2.1.282 ou ultérieur.

464* **`strictPluginOnlyCustomization`** : cette clé passe le filtre indépendamment de tout verrou, et elle fait que Claude Code ignore la personnalisation propre du développeur, y compris les hooks protecteurs. Aucun verrou ne la bloque.465* **`strictPluginOnlyCustomization`** : cette clé passe le filtre indépendamment de tout verrou, et elle fait que Claude Code ignore la personnalisation propre du développeur, y compris les hooks protecteurs. Aucun verrou ne la bloque.

465 466 

467Sous le paramètre par défaut premier-gagnant, une valeur d'administration ne bloque celle du parent que lorsqu'elle se trouve dans la source d'administration de plus haute priorité, sauf pour `allowedMcpServers` tant que le [verrou des serveurs MCP](#lock-behavior-across-sources) est activé. Sous l'opt-in de fusion `managedSourcesBehavior`, [comment Claude Code combine les sources gérées](/docs/fr/managed-settings#how-claude-code-combines-managed-sources) indique quelle valeur de source s'applique à la place.

468 

466<h3 id="connect-claude-desktop">469<h3 id="connect-claude-desktop">

467 Connecter Claude Desktop470 Connecter Claude Desktop

468</h3>471</h3>

469 472 

470[Claude Desktop](/docs/fr/desktop) se connecte à la même passerelle via une clé MDM différente : définissez `bootstrapUrl` dans la [configuration gérée](https://claude.com/docs/third-party/claude-desktop/configuration) de Claude Desktop à `<listen.public_url>/user/bootstrap`, et optez la politique de l'utilisateur avec une clé `desktop`. [La superposition Claude Desktop](/docs/fr/claude-apps-gateway-config#claude-desktop-overlay) couvre les deux moitiés. Nécessite Claude Code v2.1.203 ou ultérieur sur le serveur de passerelle.473[Claude Desktop](/docs/fr/desktop) se connecte à la même passerelle via une clé MDM différente : définissez `bootstrapUrl` dans la [configuration gérée](https://claude.com/docs/third-party/claude-desktop/configuration) de Claude Desktop à `<listen.public_url>/user/bootstrap`, et faites adhérer la politique de l'utilisateur avec une clé `desktop`. [La superposition Claude Desktop](/docs/fr/claude-apps-gateway-config#claude-desktop-overlay) couvre les deux moitiés. Nécessite Claude Code v2.1.203 ou ultérieur sur le serveur de passerelle.

471 474 

472Claude Desktop connecte le développeur via le fournisseur d'identité de la passerelle avec la même étape SSO du navigateur, puis récupère sa configuration auprès de la passerelle au lieu d'Anthropic. L'accès au modèle et la politique suivent les mêmes règles par groupe que l'interface de ligne de commande. Un développeur qui utilise à la fois l'interface de ligne de commande et Claude Desktop se connecte à chacun séparément ; la session de passerelle n'est pas partagée entre eux.475Claude Desktop connecte le développeur via le fournisseur d'identité de la passerelle avec la même étape SSO du navigateur, puis récupère sa configuration auprès de la passerelle au lieu d'Anthropic. L'accès au modèle et la politique suivent les mêmes règles par groupe que l'interface de ligne de commande. Un développeur qui utilise à la fois l'interface de ligne de commande et Claude Desktop se connecte à chacun séparément ; la session de passerelle n'est pas partagée entre eux.

473 476 

474Une fois connecté, Claude Desktop envoie les demandes de modèle de chaque onglet activé via la passerelle. Il affiche les onglets Cowork et Code par défaut. Pour activer également l'onglet Chat, définissez `chatTabEnabled` à `true` dans la [configuration gérée](https://claude.com/docs/third-party/claude-desktop/configuration) de Claude Desktop, ou dans le bloc [`desktop`](/docs/fr/claude-apps-gateway-config#claude-desktop-overlay) de la politique sur une passerelle exécutant Claude Code v2.1.227 ou ultérieur.477Une fois connecté, Claude Desktop envoie les requêtes de modèle de chaque onglet activé via la passerelle. Il affiche les onglets Cowork et Code par défaut. Pour activer également l'onglet Chat, définissez `chatTabEnabled` à `true` dans la [configuration gérée](https://claude.com/docs/third-party/claude-desktop/configuration) de Claude Desktop, ou dans le bloc [`desktop`](/docs/fr/claude-apps-gateway-config#claude-desktop-overlay) de la politique sur une passerelle exécutant Claude Code v2.1.227 ou ultérieur.

475 478 

476<h3 id="ci-pipelines-and-remote-machines">479<h3 id="ci-pipelines-and-remote-machines">

477 Pipelines CI et machines distantes480 Pipelines CI et machines distantes

478</h3>481</h3>

479 482 

480Il n'y a pas de flux de jeton de service pour les pipelines sans surveillance. La connexion à la passerelle exécute toujours le flux d'appareil du navigateur, donc un travail CI sans développeur pour approuver la connexion ne peut pas s'authentifier ; configurez ceux-ci directement contre votre fournisseur.483Il n'y a pas de flux de jeton de service pour les pipelines sans surveillance. La connexion à la passerelle exécute toujours le flux d'appareil du navigateur, donc un travail CI sans développeur pour approuver la connexion ne peut pas s'authentifier ; configurez ceux-ci directement avec votre fournisseur.

481 484 

482Une fois qu'un développeur s'est connecté, chaque session Claude Code sur cette machine utilise la session de passerelle, y compris les exécutions non-interactives `claude -p` et les sessions démarrées par le SDK Agent. Claude Code applique la [politique de passerelle](/docs/fr/claude-apps-gateway-config#managed) à chacune d'elles.485Une fois qu'un développeur s'est connecté, chaque session Claude Code sur cette machine utilise la session de passerelle, y compris les exécutions non interactives `claude -p` et les sessions démarrées par le SDK Agent. Claude Code applique la [politique de passerelle](/docs/fr/claude-apps-gateway-config#managed) à chacune d'elles.

483 486 

484Le flux d'appareil sépare l'interface de ligne de commande d'interrogation du navigateur approbateur, donc une boîte de développement distante sans affichage fonctionne toujours : le développeur exécute `/login` via SSH sur la machine distante et ouvre le lien de vérification dans le navigateur sur son ordinateur portable.487Le flux d'appareil sépare l'interface de ligne de commande qui interroge du navigateur qui approuve, donc une machine de développement distante sans affichage fonctionne toujours : le développeur exécute `/login` via SSH sur la machine distante et ouvre le lien de vérification dans le navigateur sur son ordinateur portable.

485 488 

486<h3 id="whats-enforced-on-developers">489<h3 id="whats-enforced-on-developers">

487 Ce qui est appliqué aux développeurs490 Ce qui est appliqué aux développeurs

488</h3>491</h3>

489 492 

490Ces garanties s'appliquent à chaque session connectée via `/login`. Les sessions intégrées que Claude Desktop lance obtiennent leur politique comme décrit dans [Livrer la politique à Claude Desktop sessions](#deliver-policy-to-claude-desktop-sessions), et la puce de télémétrie dit où vont leurs exports.493Ces garanties s'appliquent à chaque session connectée via `/login`. Les sessions intégrées que Claude Desktop lance obtiennent leur politique comme décrit dans [Livrer la politique aux sessions Claude Desktop](#deliver-policy-to-claude-desktop-sessions), et la puce sur la télémétrie indique où vont leurs exports.

491 494 

492* **Accès au modèle** : les demandes pour les modèles que la politique n'accorde pas retournent 400, et le sélecteur `/model` est filtré à la liste d'autorisation `availableModels` de la politique. Définissez [`enforceAvailableModels: true`](/docs/fr/model-config#default-model-behavior) dans la politique pour que l'option Par défaut se résolve à un modèle à l'intérieur de `availableModels` au lieu du défaut intégré de Claude Code ; sans cela, Par défaut reste sélectionnable et est rejeté au moment de la demande si ce modèle n'est pas accordé.495* **Accès au modèle** : les requêtes pour les modèles que la politique n'accorde pas retournent 400, et le sélecteur `/model` est filtré à la liste d'autorisation `availableModels` de la politique. Cela inclut le modèle sur lequel une session démarre avant que le développeur n'en choisisse un ; voir [Démarrer les sessions sur un modèle que la politique autorise](/docs/fr/claude-apps-gateway-config#start-sessions-on-a-model-the-policy-allows).

493* **Destination de télémétrie** : dans les sessions connectées via `/login`, l'interface de ligne de commande envoie ses exports OTLP/HTTP à la passerelle plutôt qu'à un `OTEL_EXPORTER_OTLP_ENDPOINT` défini localement, sauf si une politique [nomme votre collecteur comme point de terminaison](/docs/fr/claude-apps-gateway-config#export-directly-to-your-collector). La passerelle relaie les exports qu'elle reçoit vers les destinations dans [`telemetry.forward_to`](/docs/fr/claude-apps-gateway-config#telemetry).496* **Destination de télémétrie** : dans les sessions connectées via `/login`, l'interface de ligne de commande envoie ses exports OTLP/HTTP à la passerelle plutôt qu'à un `OTEL_EXPORTER_OTLP_ENDPOINT` défini localement, sauf si une politique [désigne votre collecteur comme endpoint](/docs/fr/claude-apps-gateway-config#export-directly-to-your-collector). La passerelle relaie les exports qu'elle reçoit vers les destinations dans [`telemetry.forward_to`](/docs/fr/claude-apps-gateway-config#telemetry).

494 * Dans les sessions intégrées que [Claude Desktop lance](#connect-claude-desktop), l'interface de ligne de commande envoie ses exports au `OTEL_EXPORTER_OTLP_ENDPOINT` configuré. L'interface de ligne de commande attache le jeton de session de passerelle à ces exports uniquement quand ce point de terminaison pointe vers la passerelle elle-même.497 * Dans les sessions intégrées que [Claude Desktop lance](#connect-claude-desktop), l'interface de ligne de commande envoie ses exports au `OTEL_EXPORTER_OTLP_ENDPOINT` configuré. L'interface de ligne de commande attache le jeton de session de passerelle à ces exports uniquement quand cet endpoint pointe vers la passerelle elle-même.

495 * Sans destination configurée pour un signal, la passerelle l'accepte et le rejette.498 * Sans destination configurée pour un signal, la passerelle l'accepte et le rejette.

496 * Si vous collectez déjà la télémétrie Claude Code directement, ajoutez votre collecteur comme destination `forward_to`, ou nommez-le dans une politique pour ignorer le relais.499 * Si vous collectez déjà la télémétrie Claude Code directement, ajoutez votre collecteur comme destination `forward_to`, ou nommez-le dans une politique pour ignorer le relais.

497* **Identifiants** : le jeton de passerelle est le seul identifiant de la session. [Les profils Anthropic](/docs/fr/authentication#anthropic-profiles-and-federation-credentials) et toute connexion claude.ai antérieure sont ignorés lors de la connexion, donc les développeurs n'ont pas besoin de se déconnecter de claude.ai d'abord. Pour un identifiant `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` configuré, voir [La politique d'administrateur nécessite une connexion Cloud gateway](/docs/fr/errors#administrator-policy-requires-a-cloud-gateway-sign-in).500* **Identifiants** : le jeton de passerelle est le seul identifiant de la session. [Les profils Anthropic](/docs/fr/authentication#anthropic-profiles-and-federation-credentials) et toute connexion claude.ai antérieure sont ignorés lors de la connexion, donc les développeurs n'ont pas besoin de se déconnecter de claude.ai d'abord. Pour un identifiant `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` configuré, ou une clé API enregistrée par une connexion antérieure à la Claude Console, voir [La politique d'administrateur nécessite une connexion Cloud gateway](/docs/fr/errors#administrator-policy-requires-a-cloud-gateway-sign-in).

498* **Paramètres gérés** : les clés verrouillées ne peuvent pas être remplacées localement. L'interface de ligne de commande applique la politique au démarrage et applique les modifications à chaque sondage horaire, à part les [modifications qui s'appliquent uniquement au prochain lancement](/docs/fr/server-managed-settings#fetch-and-caching-behavior).501* **Paramètres gérés** : les clés verrouillées ne peuvent pas être remplacées localement. L'interface de ligne de commande applique la politique au démarrage et applique les modifications à chaque sondage horaire, à part les [modifications qui s'appliquent uniquement au prochain lancement](/docs/fr/server-managed-settings#fetch-and-caching-behavior).

499* **Démarrage avec la passerelle inaccessible** : les sessions connectées se terminent au démarrage avec une erreur après environ 10 secondes plutôt que de démarrer sans leurs paramètres.502* **Démarrage avec la passerelle inaccessible** : les sessions connectées se terminent au démarrage avec une erreur après environ 10 secondes plutôt que de démarrer sans leurs paramètres.

500* **Démarrage après que la passerelle termine la session** : voir [Appliquer un démarrage fail-closed](/docs/fr/server-managed-settings#enforce-fail-closed-startup) pour les lancements qui s'ouvrent déconnectés de la passerelle et ceux qui se terminent quand la passerelle répond avec un `401`.503* **Démarrage après que la passerelle a terminé la session** : voir [Appliquer un démarrage fail-closed](/docs/fr/server-managed-settings#enforce-fail-closed-startup) pour les lancements qui s'ouvrent déconnectés de la passerelle et ceux qui se terminent quand la passerelle répond avec un `401`.

501* **Déprovisionnement** : une session dont l'utilisateur est désactivé dans l'IdP expire dans `ttl_hours` quand le prochain rafraîchissement échoue.504* **Déprovisionnement** : une session dont l'utilisateur est désactivé dans l'IdP expire dans `ttl_hours` quand le prochain rafraîchissement échoue.

502* **Déconnexion** : `/logout` supprime l'identifiant de passerelle de la machine du développeur.505* **Déconnexion** : `/logout` supprime l'identifiant de passerelle de la machine du développeur.

503 * Quand le document de découverte de la passerelle annonce un `revocation_endpoint` sur le schéma, l'hôte et le port propres de l'URL de la passerelle, `/logout` envoie également les jetons stockés à ce point de terminaison pour que la passerelle puisse terminer la session de son côté. La demande est au mieux effort, donc la déconnexion se complète sur la machine du développeur que le point de terminaison réponde ou non. La révocation nécessite Claude Code v2.1.275 ou ultérieur sur la machine du développeur.506 * Quand le document de découverte de la passerelle annonce un `revocation_endpoint` sur le schéma, l'hôte et le port propres de l'URL de la passerelle, `/logout` envoie également les jetons stockés à cet endpoint pour que la passerelle puisse terminer la session de son côté. La requête est envoyée au mieux, donc la déconnexion se complète sur la machine du développeur que l'endpoint réponde ou non. La révocation nécessite Claude Code v2.1.275 ou ultérieur sur la machine du développeur.

504 * Le serveur de passerelle dans le binaire `claude` n'en annonce aucun, donc une déconnexion de celui-ci termine la session sur la machine du développeur uniquement. Pour forcer les sessions à sortir côté serveur, voir [Rotation de secret JWT](/docs/fr/claude-apps-gateway-deploy#jwt-secret-rotation).507 * Le serveur de passerelle dans le binaire `claude` n'en annonce aucun, donc une déconnexion de celui-ci termine la session sur la machine du développeur uniquement. Pour forcer la fin des sessions côté serveur, voir [Rotation de secret JWT](/docs/fr/claude-apps-gateway-deploy#jwt-secret-rotation).

505 508 

506<h3 id="what-the-organization-can-see">509<h3 id="what-the-organization-can-see">

507 Ce que l'organisation peut voir510 Ce que l'organisation peut voir

508</h3>511</h3>

509 512 

510La télémétrie d'utilisation porte l'identité du développeur, les nombres de jetons, le modèle et la latence vers le collecteur de l'organisation. La passerelle ne journalise ni ne stocke le contenu des invites ou des complétions. Que la télémétrie plus riche comme les journaux et les traces soit collectée, qui peut inclure les commandes et les chemins de fichiers, est le [choix par destination](/docs/fr/claude-apps-gateway-config#telemetry) de l'organisation.513La télémétrie d'utilisation transmet l'identité du développeur, les nombres de tokens, le modèle et la latence au collecteur de l'organisation. La passerelle ne journalise ni ne stocke le contenu des prompts ou des complétions. La collecte d'une télémétrie plus riche comme les logs et les traces, qui peut inclure les commandes et les chemins de fichiers, relève du [choix par destination](/docs/fr/claude-apps-gateway-config#telemetry) de l'organisation.

511 514 

512<h2 id="availability-and-limitations">515<h2 id="availability-and-limitations">

513 Disponibilité et limitations516 Disponibilité et limitations


515 518 

516Le tableau couvre les fonctionnalités Claude Code qui fonctionnent quand les développeurs se connectent via la passerelle, et ce que le serveur de passerelle lui-même supporte. Quand quelque chose n'est pas supporté, la colonne Notes donne l'alternative.519Le tableau couvre les fonctionnalités Claude Code qui fonctionnent quand les développeurs se connectent via la passerelle, et ce que le serveur de passerelle lui-même supporte. Quand quelque chose n'est pas supporté, la colonne Notes donne l'alternative.

517 520 

518La passerelle livre les valeurs [`anthropic-beta`](https://platform.claude.com/docs/en/api/beta-headers) que l'interface de ligne de commande envoie à chaque amont, donc les opérateurs ne maintiennent pas une liste d'autorisation bêta. Pour Amazon Bedrock, qui ignore l'en-tête, la passerelle déplace les valeurs dans le champ `anthropic_beta` du corps de la demande ; les autres ammonts reçoivent l'en-tête tel qu'envoyé.521La passerelle livre les valeurs [`anthropic-beta`](https://platform.claude.com/docs/en/api/beta-headers) que la CLI envoie à chaque amont, donc les opérateurs ne maintiennent pas une liste d'autorisation bêta. Pour Amazon Bedrock, qui ignore l'en-tête, la passerelle déplace les valeurs dans le champ `anthropic_beta` du corps de la requête ; les autres amonts reçoivent l'en-tête tel qu'envoyé.

519 522 

520| Fonctionnalité | Statut | Notes |523| Fonctionnalité | Statut | Notes |

521| - | - | - |524| - | - | - |

522| Transfert d'inférence (Amazon Bedrock, Claude Platform on AWS, Agent Platform de Google Cloud, Microsoft Foundry, Anthropic) | Disponible | Avec traduction de modèle par amont et basculement. L'amont Amazon Bedrock utilise le point de terminaison `bedrock-runtime` et la chaîne de credentials AWS par défaut ; le [point de terminaison Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) d'Amazon Bedrock n'est pas un amont supporté. L'[amont Claude Platform on AWS](/docs/fr/claude-apps-gateway-config#claude-platform-on-aws) nécessite Claude Code v2.1.198 ou ultérieur sur le serveur de passerelle. |525| Transfert d'inférence (Amazon Bedrock, Claude Platform on AWS, Agent Platform de Google Cloud, Microsoft Foundry, Anthropic) | Disponible | Avec traduction de modèle par amont et basculement. L'amont Amazon Bedrock utilise l'endpoint `bedrock-runtime` et la chaîne d'identifiants AWS par défaut. L'[amont Amazon Bedrock Mantle](/docs/fr/claude-apps-gateway-config#amazon-bedrock-mantle-endpoint) nécessite Claude Code v2.1.283 ou ultérieur sur le serveur de passerelle, et l'[amont Claude Platform on AWS](/docs/fr/claude-apps-gateway-config#claude-platform-on-aws) nécessite v2.1.198 ou ultérieur. |

523| Accès au modèle et paramètres gérés par groupe IdP | Disponible | L'accès au modèle est appliqué côté serveur ; les paramètres gérés sont livrés par groupe IdP et appliqués par l'interface de ligne de commande au [niveau des paramètres gérés](/docs/fr/settings#settings-precedence) |526| Accès au modèle et paramètres gérés par groupe IdP | Disponible | L'accès au modèle est appliqué côté serveur ; les paramètres gérés sont livrés par groupe IdP et appliqués par la CLI au [niveau des paramètres gérés](/docs/fr/settings#settings-precedence) |

524| Claude Desktop | Disponible avec opt-in | La passerelle sert la configuration de Claude Desktop à `/user/bootstrap` une fois qu'une politique [opte pour une clé `desktop`](/docs/fr/claude-apps-gateway-config#claude-desktop-overlay), et Claude Desktop envoie les demandes de modèle de ses onglets Cowork et Code, et de l'onglet Chat quand vous l'activez, via la passerelle. Pour activer l'onglet Chat, voir [Connecter Claude Desktop](#connect-claude-desktop). Nécessite Claude Code v2.1.203 ou ultérieur sur le serveur de passerelle. |527| Claude Desktop | Disponible avec opt-in | La passerelle sert la configuration de Claude Desktop à `/user/bootstrap` une fois qu'une politique [opte pour une clé `desktop`](/docs/fr/claude-apps-gateway-config#claude-desktop-overlay), et Claude Desktop envoie les requêtes de modèle de ses onglets Cowork et Code, et de l'onglet Chat quand vous l'activez, via la passerelle. Pour activer l'onglet Chat, voir [Connecter Claude Desktop](#connect-claude-desktop). Nécessite Claude Code v2.1.203 ou ultérieur sur le serveur de passerelle. |

525| Fan-out de télémétrie (OTLP/HTTP) | Disponible | Identité-estampillé par export ; encodages protobuf et JSON |528| Fan-out de télémétrie (OTLP/HTTP) | Disponible | Estampillé d'identité par export ; encodages protobuf et JSON |

526| Fournisseurs d'identité OIDC | Disponible | Tout IdP conforme à OIDC ; la passerelle exécute la découverte OIDC standard et le flux du code d'autorisation. Voir [Configuration du fournisseur d'identité](/docs/fr/claude-apps-gateway-deploy#identity-provider-setup) pour la configuration par IdP |529| Fournisseurs d'identité OIDC | Disponible | Tout IdP conforme à OIDC ; la passerelle exécute la découverte OIDC standard et le flux du code d'autorisation. Voir [Configuration du fournisseur d'identité](/docs/fr/claude-apps-gateway-deploy#identity-provider-setup) pour la configuration par IdP |

527| Limites de dépenses par utilisateur et par groupe | Disponible | Voir [Limites de dépenses](/docs/fr/claude-apps-gateway-spend-limits) |530| Limites de dépenses par utilisateur et par groupe | Disponible | Voir [Limites de dépenses](/docs/fr/claude-apps-gateway-spend-limits) |

528| Recherche web côté serveur | Non disponible | L'interface de ligne de commande ne peut pas voir quel fournisseur en amont la passerelle achemine vers, donc elle ne peut pas vérifier le support de la recherche web et désactive WebSearch sur les sessions de passerelle |531| Recherche web côté serveur | Non disponible | La CLI ne peut pas voir vers quel fournisseur en amont la passerelle achemine, donc elle ne peut pas vérifier le support de la recherche web et désactive WebSearch sur les sessions de passerelle |

529| [Contrôle à distance](/docs/fr/remote-control) | Non disponible | L'interface de ligne de commande affiche [une erreur nommant la passerelle](/docs/fr/errors#remote-control-requires-the-anthropic-api) |532| [Remote Control](/docs/fr/remote-control) | Non disponible | La CLI affiche [une erreur nommant la passerelle](/docs/fr/errors#remote-control-requires-the-anthropic-api) |

530| [`/design-sync`](/docs/fr/commands#all-commands) et `/design-login` | Non disponible | Les deux ont besoin de claude.ai, que l'interface de ligne de commande ne contacte pas sur les sessions de passerelle, donc aucune des deux commandes n'y apparaît |533| [`/design-sync`](/docs/fr/commands#all-commands) et `/design-login` | Non disponible | Les deux ont besoin de claude.ai, que la CLI ne contacte pas sur les sessions de passerelle, donc aucune des deux commandes n'y apparaît |

531| Fonctionnalités qui nécessitent la récupération de drapeaux de fonctionnalité, comme `/import` et `claude import` | Non disponible | L'interface de ligne de commande ignore la récupération de drapeau sur les sessions de passerelle. [Les fonctionnalités qui nécessitent la récupération de drapeaux de fonctionnalité](/docs/fr/env-vars#features-that-need-feature-flag-fetching) énumère ce que cela désactive |534| Fonctionnalités qui nécessitent la récupération de flags de fonctionnalité, comme `/import` et `claude import` | Non disponible | La CLI ignore la récupération de flags sur les sessions de passerelle. [Les fonctionnalités qui nécessitent la récupération de flags de fonctionnalité](/docs/fr/env-vars#features-that-need-feature-flag-fetching) énumère ce que cela désactive |

532| Mise en cache des invites standard | Disponible | La passerelle transfère les points d'arrêt `cache_control` à chaque amont. [Où le cache réside](/docs/fr/prompt-caching#where-the-cache-lives) couvre les blocs que l'interface de ligne de commande marque, y compris le contexte système qu'elle ajoute en milieu de conversation |535| Prompt caching standard | Disponible | La passerelle transfère les points d'arrêt `cache_control` à chaque amont. [Où le cache réside](/docs/fr/prompt-caching#where-the-cache-lives) couvre les blocs que la CLI marque, y compris le contexte système qu'elle ajoute en milieu de conversation |

533| TTL de cache d'1 heure | Non disponible | L'interface de ligne de commande omet la bêta extended-cache-ttl sur les sessions de passerelle, car pas tous les ammonts vers lesquels la passerelle peut acheminer supportent le TTL d'1 heure, donc la mise en cache des invites via la passerelle utilise le TTL de 5 minutes ; voir la note sur l'en-tête bêta ci-dessus |536| TTL de cache d'1 heure | Non disponible | La CLI omet la bêta extended-cache-ttl sur les sessions de passerelle, car tous les amonts vers lesquels la passerelle peut acheminer ne supportent pas le TTL d'1 heure, donc le prompt caching via la passerelle utilise le TTL de 5 minutes ; voir la note sur l'en-tête bêta ci-dessus |

534| Mode Auto | Disponible | Suit les [règles du fournisseur tiers](/docs/fr/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) : seuls les modèles éligibles sur les fournisseurs tiers peuvent l'utiliser. Avant v2.1.207, le mode auto sur les sessions de passerelle nécessitait de définir `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, livrable via le bloc `env` de la politique gérée |537| Mode auto | Disponible | Suit les [règles des fournisseurs tiers](/docs/fr/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) : seuls les modèles éligibles sur les fournisseurs tiers peuvent l'utiliser. Avant v2.1.207, le mode auto sur les sessions de passerelle nécessitait de définir `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, livrable via le bloc `env` de la politique gérée |

535| Optimisations propriétaires uniquement comme la portée du cache global et les outils efficaces en jetons | Non disponible | L'interface de ligne de commande ne les active pas sur les sessions de passerelle ; voir la note sur l'en-tête bêta ci-dessus |538| Optimisations propriétaires uniquement comme la portée du cache global et les outils efficaces en jetons | Non disponible | La CLI ne les active pas sur les sessions de passerelle ; voir la note sur l'en-tête bêta ci-dessus |

536| OTLP/gRPC | Non supporté | OTLP sur HTTP uniquement |539| OTLP/gRPC | Non supporté | OTLP sur HTTP uniquement |

537| SAML, LDAP et autres authentifications non-OIDC | Non supporté | OIDC uniquement. Frontal avec un pont OIDC si nécessaire |540| SAML, LDAP et autres authentifications non-OIDC | Non supporté | OIDC uniquement. Placez un pont OIDC en frontal si nécessaire |

538| Multi-locataire (plusieurs émetteurs OIDC) | Non supporté | Un émetteur par passerelle. Exécutez des instances séparées |541| Multi-locataire (plusieurs émetteurs OIDC) | Non supporté | Un émetteur par passerelle. Exécutez des instances séparées |

539| Serveur Windows | Non supporté | Déployez sur Linux. macOS pour le développement local uniquement |542| Serveur Windows | Non supporté | Déployez sur Linux. macOS pour le développement local uniquement |

540| Graphique Helm | Non disponible | La passerelle s'exécute comme un Deployment sans état standard ; voir le [guide de déploiement](/docs/fr/claude-apps-gateway-deploy#kubernetes) |543| Chart Helm | Non disponible | La passerelle s'exécute comme un Deployment sans état standard ; voir le [guide de déploiement](/docs/fr/claude-apps-gateway-deploy#kubernetes) |

541| Interface utilisateur d'administration | Non disponible | La configuration est le fichier YAML ; redéployez pour le modifier |544| Interface utilisateur d'administration | Non disponible | La configuration est le fichier YAML ; redéployez pour la modifier |

542 545 

543<h2 id="next-steps">546<h2 id="next-steps">

544 Prochaines étapes547 Prochaines étapes

Details

64| - | - | - |64| - | - | - |

65| `host` | Non | Adresse de liaison. Par défaut `0.0.0.0`. |65| `host` | Non | Adresse de liaison. Par défaut `0.0.0.0`. |

66| `port` | Non | Port de liaison. Par défaut `8080`. |66| `port` | Non | Port de liaison. Par défaut `8080`. |

67| `public_url` | Sauf si `host` est loopback | L'origine `https://` visible de l'extérieur, utilisée pour construire le `redirect_uri` du fournisseur d'identité et les métadonnées de découverte. Obligatoire chaque fois que `host` n'est pas une adresse loopback, que la terminaison TLS se fasse à un proxy tel qu'un ALB, Ingress, ou Cloud Run ou à la passerelle elle-même via `tls`, car la passerelle ne dérive jamais sa propre origine à partir des en-têtes `X-Forwarded-*` ; ils peuvent être usurpés par le client. Le démarrage échoue sans lui. `trusted_proxies` ci-dessous régit uniquement la résolution de l'adresse IP du client. Également obligatoire pour activer la [télémétrie](#telemetry), car la passerelle construit le point de terminaison OTLP qu'elle pousse aux clients à partir de cette URL. |67| `public_url` | Sauf si `host` est loopback | L'origine `https://` visible de l'extérieur, utilisée pour construire le `redirect_uri` du fournisseur d'identité et les métadonnées de découverte. Obligatoire chaque fois que `host` n'est pas une adresse loopback, que la terminaison TLS se fasse à un proxy tel qu'un ALB, Ingress, ou Cloud Run ou à la passerelle elle-même via `tls`, car la passerelle ne dérive jamais sa propre origine à partir des en-têtes `X-Forwarded-*` ; ils peuvent être usurpés par le client. Le démarrage échoue sans lui. `trusted_proxies` ci-dessous régit uniquement la résolution de l'adresse IP du client. Également obligatoire pour activer la [télémétrie](#telemetry), car la passerelle construit l'endpoint OTLP qu'elle pousse aux clients à partir de cette URL. |

68| `tls.cert` / `tls.key` | Non | Chemins PEM si la passerelle termine TLS elle-même |68| `tls.cert` / `tls.key` | Non | Chemins PEM si la passerelle termine TLS elle-même |

69| `trusted_proxies` | Non | CIDR ou adresses IP des équilibreurs de charge devant la passerelle. Lorsqu'il est défini, la passerelle fait confiance à `X-Forwarded-For` uniquement à partir de ces pairs et enregistre l'adresse IP réelle du client pour la limitation de débit par adresse IP et l'audit. Équivalent à `set_real_ip_from` de nginx. Les entrées `X-Forwarded-For` écrites comme `ipv4:port` ou `[ipv6]:port`, comme certains équilibreurs de charge le font, sont lues avec le port supprimé. Une adresse IPv6 avec un port ajouté et sans crochets peut être lue comme une adresse différente ou ne pas être lue du tout, donc désactivez l'option de port sur tout proxy qui écrit cette forme. |69| `trusted_proxies` | Non | CIDR ou adresses IP des équilibreurs de charge devant la passerelle. Lorsqu'il est défini, la passerelle fait confiance à `X-Forwarded-For` uniquement à partir de ces pairs et enregistre l'adresse IP réelle du client pour la limitation de débit par adresse IP et l'audit. Équivalent à `set_real_ip_from` de nginx. Les entrées `X-Forwarded-For` écrites comme `ipv4:port` ou `[ipv6]:port`, comme certains équilibreurs de charge le font, sont lues avec le port supprimé. Une adresse IPv6 avec un port ajouté et sans crochets peut être lue comme une adresse différente ou ne pas être lue du tout, donc désactivez l'option de port sur tout proxy qui écrit cette forme. |

70 70 


86| `groups_claim` | Non | Quelle revendication id\_token porte l'appartenance au groupe. Par défaut `groups`. Microsoft Entra émet les rôles d'application sous `roles`. Accepte une clé plate ou un pointeur JSON RFC 6901 tel que `/resource_access/gateway/roles` pour les revendications imbriquées. |86| `groups_claim` | Non | Quelle revendication id\_token porte l'appartenance au groupe. Par défaut `groups`. Microsoft Entra émet les rôles d'application sous `roles`. Accepte une clé plate ou un pointeur JSON RFC 6901 tel que `/resource_access/gateway/roles` pour les revendications imbriquées. |

87| `google_groups` | Non | Rechercher les groupes de l'utilisateur connecté via l'API Google Workspace Admin SDK Directory, car le id\_token de Google ne porte aucune revendication de groupes. Définissez `service_account_json_path` sur un fichier de clé de compte de service avec délégation à l'échelle du domaine sur la portée `https://www.googleapis.com/auth/admin.directory.group.readonly`, et `admin_email` sur un administrateur Workspace que le compte de service usurpe ; l'API Directory nécessite un sujet administrateur réel. Les adresses e-mail de groupe de chaque utilisateur deviennent sa revendication de groupes, donc `allowed_groups` et `managed.policies.match.groups` correspondent sur les e-mails de groupe. |87| `google_groups` | Non | Rechercher les groupes de l'utilisateur connecté via l'API Google Workspace Admin SDK Directory, car le id\_token de Google ne porte aucune revendication de groupes. Définissez `service_account_json_path` sur un fichier de clé de compte de service avec délégation à l'échelle du domaine sur la portée `https://www.googleapis.com/auth/admin.directory.group.readonly`, et `admin_email` sur un administrateur Workspace que le compte de service usurpe ; l'API Directory nécessite un sujet administrateur réel. Les adresses e-mail de groupe de chaque utilisateur deviennent sa revendication de groupes, donc `allowed_groups` et `managed.policies.match.groups` correspondent sur les e-mails de groupe. |

88| `email_claim` | Non | Quelle revendication id\_token porte l'e-mail de l'utilisateur. Par défaut `email`. Certains fournisseurs d'identité, tels que ADFS et Entra B2C, émettent `upn` ou `preferred_username` à la place. Accepte une clé plate, un pointeur JSON, ou une liste de clés de secours où la première clé présente est utilisée. |88| `email_claim` | Non | Quelle revendication id\_token porte l'e-mail de l'utilisateur. Par défaut `email`. Certains fournisseurs d'identité, tels que ADFS et Entra B2C, émettent `upn` ou `preferred_username` à la place. Accepte une clé plate, un pointeur JSON, ou une liste de clés de secours où la première clé présente est utilisée. |

89| `scopes` | Non | Remplacement complet des portées OIDC que la passerelle demande. Par défaut `[openid, profile, email, offline_access]`. Définissez lorsque votre fournisseur d'identité rejette les portées qu'il ne reconnaît pas, ou nécessite une portée personnalisée pour émettre des groupes ou un e-mail. Doit inclure `openid`. Supprimer `offline_access` désactive les jetons d'actualisation, donc les développeurs réexécutent la connexion au navigateur tous les `session.ttl_hours`. Voir [Configuration du fournisseur d'identité](/docs/fr/claude-apps-gateway-deploy#identity-provider-setup) pour les recettes de portée par fournisseur d'identité telles que le flux de jeton d'actualisation de Google. |89| `scopes` | Non | Remplacement complet des scopes OIDC que la passerelle demande. Par défaut `[openid, profile, email, offline_access]`. Définissez lorsque votre fournisseur d'identité rejette les scopes qu'il ne reconnaît pas, ou nécessite un scope personnalisé pour émettre des groupes ou un e-mail. Doit inclure `openid`. Supprimer `offline_access` désactive les jetons d'actualisation, donc les développeurs réexécutent la connexion au navigateur tous les `session.ttl_hours`. Voir [Configuration du fournisseur d'identité](/docs/fr/claude-apps-gateway-deploy#identity-provider-setup) pour les recettes de scopes par fournisseur d'identité telles que le flux de jeton d'actualisation de Google. |

90| `scope_on_refresh` | Non | Envoyer également `scope`, avec la même liste que la demande de connexion, lorsque la passerelle échange un jeton d'actualisation. Par défaut `false` : la demande d'actualisation omet `scope`. La plupart des fournisseurs d'identité retournent un id\_token à chaque actualisation et n'en ont pas besoin. Définissez `true` lorsque votre fournisseur d'identité retourne un id\_token lors de l'actualisation uniquement s'il est demandé à nouveau `openid`, ce qu'Okta documente pour sa subvention d'actualisation. Sans id\_token, chaque actualisation dépend du point de terminaison userinfo du fournisseur d'identité acceptant le jeton d'accès actualisé. Si vous limitez la connexion ou les politiques de correspondance sur les groupes et que le id\_token du fournisseur d'identité au moment de l'actualisation les omet, définissez également `userinfo_fallback: true` pour que la passerelle les remplisse à partir du point de terminaison userinfo. Un fournisseur d'identité qui a accordé moins de portées que demandé peut rejeter l'actualisation avec `invalid_scope`, y compris pour les sessions existantes si vous ajoutez des entrées à `scopes` pendant que ceci est activé. Décochez la clé si les actualisations commencent à échouer à `token_endpoint` après l'avoir définie. Nécessite Claude Code v2.1.260 ou ultérieur sur le serveur de la passerelle. |90| `scope_on_refresh` | Non | Envoyer également `scope`, avec la même liste que la demande de connexion, lorsque la passerelle échange un jeton d'actualisation. Par défaut `false` : la demande d'actualisation omet `scope`. La plupart des fournisseurs d'identité retournent un id\_token à chaque actualisation et n'en ont pas besoin. Définissez `true` lorsque votre fournisseur d'identité retourne un id\_token lors de l'actualisation uniquement s'il est demandé à nouveau `openid`, ce qu'Okta documente pour sa subvention d'actualisation. Sans id\_token, chaque actualisation dépend de l'endpoint userinfo du fournisseur d'identité acceptant le jeton d'accès actualisé. Si vous limitez la connexion ou les politiques de correspondance sur les groupes et que le id\_token du fournisseur d'identité au moment de l'actualisation les omet, définissez également `userinfo_fallback: true` pour que la passerelle les remplisse à partir de l'endpoint userinfo. Un fournisseur d'identité qui a accordé moins de scopes que demandé peut rejeter l'actualisation avec `invalid_scope`, y compris pour les sessions existantes si vous ajoutez des entrées à `scopes` pendant que ceci est activé. Supprimez la clé si les actualisations commencent à échouer à `token_endpoint` après l'avoir définie. Nécessite Claude Code v2.1.260 ou ultérieur sur le serveur de la passerelle. |

91| `extra_auth_params` | Non | Paramètres de requête supplémentaires ajoutés à la demande d'autorisation du fournisseur d'identité, textuellement. C'est le mécanisme de remplacement pour le comportement spécifique au fournisseur d'identité, tel que `access_type: offline` pour les jetons d'actualisation Google, `domain_hint` pour certains locataires Entra, ou `acr_values` pour les flux d'escalade. Ne peut pas remplacer les paramètres de protocole gérés par la passerelle : `state`, `nonce`, `redirect_uri`, PKCE, `scope`, `response_type`, `response_mode`, et `client_id`. |91| `extra_auth_params` | Non | Paramètres de requête supplémentaires ajoutés à la demande d'autorisation du fournisseur d'identité, textuellement. C'est le mécanisme de remplacement pour le comportement spécifique au fournisseur d'identité, tel que `access_type: offline` pour les jetons d'actualisation Google, `domain_hint` pour certains locataires Entra, ou `acr_values` pour les flux d'escalade. Ne peut pas remplacer les paramètres de protocole gérés par la passerelle : `state`, `nonce`, `redirect_uri`, PKCE, `scope`, `response_type`, `response_mode`, et `client_id`. |

92| `userinfo_fallback` | Non | Lorsque le id\_token omet l'e-mail ou les groupes, les récupérer à partir de `/userinfo`. Nécessaire pour les jetons d'accès légers Keycloak, le serveur org Okta, et les jetons minimaux ADFS. Le id\_token reste faisant autorité ; userinfo remplit uniquement les lacunes. Par défaut `false`. |92| `userinfo_fallback` | Non | Lorsque le id\_token omet l'e-mail ou les groupes, les récupérer à partir de `/userinfo`. Nécessaire pour les jetons d'accès légers Keycloak, le serveur org Okta, et les jetons minimaux ADFS. Le id\_token reste faisant autorité ; userinfo remplit uniquement les lacunes. Par défaut `false`. |

93| `use_pkce` | Non | Envoyer un défi PKCE (S256) sur la demande d'autorisation. Par défaut `true`. Définissez `false` uniquement si votre fournisseur d'identité rejette PKCE pour ce client confidentiel. |93| `use_pkce` | Non | Envoyer un défi PKCE (S256) sur la demande d'autorisation. Par défaut `true`. Définissez `false` uniquement si votre fournisseur d'identité rejette PKCE pour ce client confidentiel. |


97| `id_token_signed_response_alg` | Non | Algorithme de signature id\_token attendu. Par défaut `RS256`. Définissez pour les fournisseurs d'identité qui signent avec ES256, PS256, ou EdDSA. |97| `id_token_signed_response_alg` | Non | Algorithme de signature id\_token attendu. Par défaut `RS256`. Définissez pour les fournisseurs d'identité qui signent avec ES256, PS256, ou EdDSA. |

98| `additional_authorized_parties` | Non | Valeurs `azp` supplémentaires à accepter au-delà de `client_id`, pour les flux de courtier Keycloak et d'échange de jetons |98| `additional_authorized_parties` | Non | Valeurs `azp` supplémentaires à accepter au-delà de `client_id`, pour les flux de courtier Keycloak et d'échange de jetons |

99| `discovery_url` | Non | Récupérer le document de découverte à partir de cette URL au lieu de le dériver de `issuer`, pour les fournisseurs d'identité derrière un proxy qui réécrit l'hôte émetteur. Le chemin doit contenir `/.well-known/`. |99| `discovery_url` | Non | Récupérer le document de découverte à partir de cette URL au lieu de le dériver de `issuer`, pour les fournisseurs d'identité derrière un proxy qui réécrit l'hôte émetteur. Le chemin doit contenir `/.well-known/`. |

100| `use_proxy` | Non | Envoyer les propres demandes du fournisseur d'identité de la passerelle via le proxy avant dans `HTTPS_PROXY` ou `HTTP_PROXY`, en honorer `NO_PROXY`. `false` garde ces demandes directes. Nécessite v2.1.227 ou ultérieur ; voir [Demandes du fournisseur d'identité via un proxy avant](#idp-requests-through-a-forward-proxy) ci-dessous. |100| `use_proxy` | Non | Envoyer les propres demandes du fournisseur d'identité de la passerelle via le proxy avant dans `HTTPS_PROXY` ou `HTTP_PROXY`, en respectant `NO_PROXY`. `false` garde ces demandes directes. Nécessite v2.1.227 ou ultérieur ; voir [Demandes du fournisseur d'identité via un proxy avant](#idp-requests-through-a-forward-proxy) ci-dessous. |

101| `form_action_origins` | Non | Origines supplémentaires pour la directive `Content-Security-Policy: form-action` de la page `/device`. La passerelle autorise déjà `'self'` et l'origine `authorization_endpoint` découverte, mais Chrome applique `form-action` à toute la chaîne de redirection. Si votre fournisseur d'identité redirige via un deuxième hôte, tel qu'Azure AD fédéré à ADFS, Okta hub-spoke, ou un intercepteur SSO d'entreprise, listez chaque origine par laquelle la demande d'autorisation peut rediriger. |101| `form_action_origins` | Non | Origines supplémentaires pour la directive `Content-Security-Policy: form-action` de la page `/device`. La passerelle autorise déjà `'self'` et l'origine `authorization_endpoint` découverte, mais Chrome applique `form-action` à toute la chaîne de redirection. Si votre fournisseur d'identité redirige via un deuxième hôte, tel qu'Azure AD fédéré à ADFS, Okta hub-spoke, ou un intercepteur SSO d'entreprise, listez chaque origine par laquelle la demande d'autorisation peut rediriger. |

102| `ca_cert_pem` | Non | Le certificat CA codé en PEM lui-même, pas un chemin vers un fichier. Il remplace le magasin de confiance du système pour les demandes du fournisseur d'identité uniquement. Pour charger un fichier monté, écrivez `${file:/etc/gateway/idp-ca.pem}`. Utilisez pour Keycloak ou Dex derrière une PKI d'entreprise. |102| `ca_cert_pem` | Non | Le certificat CA codé en PEM lui-même, pas un chemin vers un fichier. Il remplace le magasin de confiance du système pour les demandes du fournisseur d'identité uniquement. Pour charger un fichier monté, écrivez `${file:/etc/gateway/idp-ca.pem}`. Utilisez pour Keycloak ou Dex derrière une PKI d'entreprise. |

103 103 


167 167 

168Les upstreams d'inférence honorent `HTTPS_PROXY` et `HTTP_PROXY` sur chaque version. Les propres demandes de la passerelle au fournisseur d'identité, découverte, JWKS, jeton, et userinfo, vont directes sauf si vous définissez `oidc.use_proxy: true`, ce qui nécessite v2.1.227 ou ultérieur. Lorsqu'une variable de proxy est définie, `use_proxy` n'est pas défini, et l'émetteur n'est pas couvert par `NO_PROXY`, la passerelle garde ces demandes directes et enregistre un avis au démarrage vous demandant de choisir ; `use_proxy: false` les garde directes et fait taire l'avis.168Les upstreams d'inférence honorent `HTTPS_PROXY` et `HTTP_PROXY` sur chaque version. Les propres demandes de la passerelle au fournisseur d'identité, découverte, JWKS, jeton, et userinfo, vont directes sauf si vous définissez `oidc.use_proxy: true`, ce qui nécessite v2.1.227 ou ultérieur. Lorsqu'une variable de proxy est définie, `use_proxy` n'est pas défini, et l'émetteur n'est pas couvert par `NO_PROXY`, la passerelle garde ces demandes directes et enregistre un avis au démarrage vous demandant de choisir ; `use_proxy: false` les garde directes et fait taire l'avis.

169 169 

170Avec `use_proxy: true`, le pod résout lui-même le nom d'hôte de chaque point de terminaison du fournisseur d'identité et demande au proxy de `CONNECT` à l'adresse IP résolue, donc le proxy doit accepter `CONNECT` à l'adresse IP de chaque hôte que le document de découverte nomme, pas seulement l'émetteur. Utilisez une URL de proxy `http://`. `ca_cert_pem` et la [protection SSRF](/docs/fr/claude-apps-gateway-deploy#threat-model-summary) s'appliquent également sur le chemin proxifié.170Avec `use_proxy: true`, le pod résout lui-même le nom d'hôte de chaque endpoint du fournisseur d'identité et demande au proxy de `CONNECT` à l'adresse IP résolue, donc le proxy doit accepter `CONNECT` à l'adresse IP de chaque hôte que le document de découverte nomme, pas seulement l'émetteur. Utilisez une URL de proxy `http://`. `ca_cert_pem` et la [protection SSRF](/docs/fr/claude-apps-gateway-deploy#threat-model-summary) s'appliquent également sur le chemin proxifié.

171 171 

172[Sortie proxy uniquement](#proxy-only-egress) change les deux : pendant qu'il est actif, les demandes du fournisseur d'identité suivent le proxy sauf si vous définissez `use_proxy: false`, et la passerelle remet au proxy chaque nom d'hôte du fournisseur d'identité sans le résoudre d'abord.172[Sortie proxy uniquement](#proxy-only-egress) change les deux : pendant qu'il est actif, les demandes du fournisseur d'identité suivent le proxy sauf si vous définissez `use_proxy: false`, et la passerelle remet au proxy chaque nom d'hôte du fournisseur d'identité sans le résoudre d'abord.

173 173 


205Une fois que la sortie proxy uniquement est active, autorisez chaque destination dans le proxy, y compris un collecteur interne et tout hôte configuré par adresse IP. Vous pouvez toujours garder un fournisseur d'identité interne direct avec [`oidc.use_proxy: false`](#idp-requests-through-a-forward-proxy).205Une fois que la sortie proxy uniquement est active, autorisez chaque destination dans le proxy, y compris un collecteur interne et tout hôte configuré par adresse IP. Vous pouvez toujours garder un fournisseur d'identité interne direct avec [`oidc.use_proxy: false`](#idp-requests-through-a-forward-proxy).

206 206 

207<Warning>207<Warning>

208 Activez ceci uniquement lorsque la liste d'autorisation du proxy est au moins aussi stricte que la vérification propre de la passerelle. Le proxy doit refuser les points de terminaison de métadonnées cloud tels que `169.254.169.254` et `metadata.google.internal`, les adresses link-local, et la propre boucle locale de l'hôte proxy, et il doit les refuser par l'adresse à laquelle un nom se résout, pas seulement par nom, car la passerelle ne capture plus un nom d'hôte qui se résout en l'un d'eux. Un proxy qui se connecte n'importe où on lui demande supprime la [protection SSRF](/docs/fr/claude-apps-gateway-deploy#threat-model-summary) de la passerelle pour ces demandes.208 Activez ceci uniquement lorsque la liste d'autorisation du proxy est au moins aussi stricte que la vérification propre de la passerelle. Le proxy doit refuser les endpoints de métadonnées cloud tels que `169.254.169.254` et `metadata.google.internal`, les adresses link-local, et la propre boucle locale de l'hôte proxy, et il doit les refuser par l'adresse à laquelle un nom se résout, pas seulement par nom, car la passerelle ne capture plus un nom d'hôte qui se résout en l'un d'eux. Un proxy qui se connecte n'importe où on lui demande supprime la [protection SSRF](/docs/fr/claude-apps-gateway-deploy#threat-model-summary) de la passerelle pour ces demandes.

209</Warning>209</Warning>

210 210 

211<h3 id="session">211<h3 id="session">


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

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

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

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

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

234| `connect_timeout_seconds` | Non | Secondes que la passerelle attend lorsqu'elle ouvre une connexion Postgres. Un nombre entier de `1` à `60`, par défaut `5`. Augmentez-le si les tentatives de connexion expirent lorsqu'une nouvelle instance de passerelle démarre. Nécessite Claude Code v2.1.274 ou ultérieur sur le serveur de la passerelle. Les versions antérieures refusent de démarrer lorsque la clé est définie. |234| `connect_timeout_seconds` | Non | Secondes que la passerelle attend lorsqu'elle ouvre une connexion Postgres. Un nombre entier de `1` à `60`, par défaut `5`. Augmentez-le si les tentatives de connexion expirent lorsqu'une nouvelle instance de passerelle démarre. Nécessite Claude Code v2.1.274 ou ultérieur sur le serveur de la passerelle. Les versions antérieures refusent de démarrer lorsque la clé est définie. |

235| `readiness_grace_seconds` | Non | Combien de secondes `/readyz` continue de signaler prêt après que Postgres cesse de répondre. Un nombre entier de `0` à `3600`, par défaut `0`. Voir [Comportement de panne](/docs/fr/claude-apps-gateway-deploy#outage-behavior) pour savoir comment choisir une valeur. Nécessite Claude Code v2.1.282 ou ultérieur sur le serveur de la passerelle. Les versions antérieures refusent de démarrer lorsque la clé est définie. |235| `readiness_grace_seconds` | Non | Combien de secondes `/readyz` continue de signaler prêt après que Postgres cesse de répondre. Un nombre entier de `0` à `3600`, par défaut `0`. Voir [Comportement de panne](/docs/fr/claude-apps-gateway-deploy#outage-behavior) pour savoir comment choisir une valeur. Nécessite Claude Code v2.1.282 ou ultérieur sur le serveur de la passerelle. Les versions antérieures refusent de démarrer lorsque la clé est définie. |


242 242 

243`upstreams` est une liste ordonnée. La passerelle transfère l'inférence au premier upstream qui résout le modèle demandé.243`upstreams` est une liste ordonnée. La passerelle transfère l'inférence au premier upstream qui résout le modèle demandé.

244 244 

245Sur `5xx`, `429`, `401`, `403`, `404`, ou timeout, la passerelle bascule vers l'upstream suivant ; les autres `4xx` ne le font pas, car ces erreurs sont attribuables à la demande plutôt qu'à l'upstream. Un `401` ou `403` signifie que l'identifiant que la passerelle a utilisé contre cet upstream a échoué. Un `404` signifie que cet upstream ne sert pas le modèle demandé, donc un upstream ultérieur dans la liste peut toujours le faire.245Sur `5xx`, `429`, `401`, `403`, `404`, ou timeout, la passerelle bascule vers l'upstream suivant ; les autres `4xx` ne le font pas, car ces erreurs sont attribuables à la demande plutôt qu'à l'upstream. Un `401` ou `403` signifie que l'upstream a rejeté les identifiants que la passerelle a utilisés, ou lui a refusé l'accès, par exemple au modèle demandé. Un `404` signifie que cet upstream ne sert pas le modèle demandé, donc un upstream ultérieur dans la liste peut toujours le faire.

246 246 

247Si vous définissez `forward_user_identity: true` sur un upstream, un `429` qu'il retourne à une demande qui portait l'e-mail du développeur ne bascule pas. Voir [comment un refus de limite par utilisateur atteint le développeur](#per-user-identity-headers-for-a-proxy-you-run).247Si vous définissez `forward_user_identity: true` sur un upstream, un `429` qu'il retourne à une demande qui portait l'e-mail du développeur ne bascule pas. Voir [comment un refus de limite par utilisateur atteint le développeur](#per-user-identity-headers-for-a-proxy-you-run).

248 248 


294* **`api_key`** : envoie `x-api-key`. Faites-la tourner dans la Console Claude et mettez à jour la variable d'environnement.294* **`api_key`** : envoie `x-api-key`. Faites-la tourner dans la Console Claude et mettez à jour la variable d'environnement.

295* **`oauth_token`** : envoie `Authorization: Bearer`. Utilisez la forme porteur lorsque votre organisation émet des jetons de courte durée au lieu de clés API de longue durée. Le porteur est lu une fois au démarrage, donc actualisez en remontant le secret et en redémarrant.295* **`oauth_token`** : envoie `Authorization: Bearer`. Utilisez la forme porteur lorsque votre organisation émet des jetons de courte durée au lieu de clés API de longue durée. Le porteur est lu une fois au démarrage, donc actualisez en remontant le secret et en redémarrant.

296 296 

297Au lieu d'une clé statique ou d'un porteur, vous pouvez utiliser Workload Identity Federation. Créez une règle de fédération en suivant le [guide Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), puis montez le JWT OIDC de votre charge de travail en tant que fichier, tel qu'un jeton de compte de service projeté Kubernetes ou un id-token de plateforme CI. La passerelle échange le JWT pour un porteur de courte durée et l'actualise automatiquement. Le fichier de jeton est relui à chaque échange, donc les jetons projetés en rotation sont récupérés sans redémarrage.297Au lieu d'une clé statique ou d'un porteur, vous pouvez utiliser Workload Identity Federation. Créez une règle de fédération en suivant le [guide Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), puis montez le JWT OIDC de votre charge de travail en tant que fichier, tel qu'un jeton de compte de service projeté Kubernetes ou un id-token de plateforme CI. La passerelle échange le JWT pour un porteur de courte durée et l'actualise automatiquement. Le fichier de jeton est relu à chaque échange, donc les jetons projetés en rotation sont récupérés sans redémarrage.

298 298 

299```yaml theme={null}299```yaml theme={null}

300upstreams:300upstreams:


350upstreams:350upstreams:

351 - provider: bedrock351 - provider: bedrock

352 region: us-east-1352 region: us-east-1

353 auth: {} # chaîne d'identifiants AWS par défaut préférée353 auth: {} # préféré : chaîne d'identifiants AWS par défaut

354 # OU identifiants explicites :354 # OU identifiants explicites :

355 # auth:355 # auth:

356 # aws_access_key_id: ${AWS_AKID}356 # aws_access_key_id: ${AWS_AKID}


359 # OU un jeton porteur Bedrock API :359 # OU un jeton porteur Bedrock API :

360 # auth:360 # auth:

361 # aws_bearer_token: ${AWS_BEARER_TOKEN}361 # aws_bearer_token: ${AWS_BEARER_TOKEN}

362 # Remplacez le point de terminaison bedrock-runtime pour les déploiements FIPS ou VPC-endpoint :362 # Remplacez l'endpoint bedrock-runtime pour les déploiements FIPS ou VPC-endpoint :

363 # base_url: https://bedrock-runtime-fips.us-east-1.amazonaws.com363 # base_url: https://bedrock-runtime-fips.us-east-1.amazonaws.com

364```364```

365 365 


369 369 

370| Configuration | Comment |370| Configuration | Comment |

371| - | - |371| - | - |

372| Permissions IAM | Accordez au principal de la passerelle `bedrock:InvokeModel` et `bedrock:InvokeModelWithResponseStream` sur les ARN de profil d'inférence et les ARN de modèle de fondation sous-jacents. Pour le catalogue intégré dans les régions US : `arn:aws:bedrock:<region>:<account>:inference-profile/us.anthropic.*` et `arn:aws:bedrock:*::foundation-model/anthropic.*`. Accordez également `bedrock:CountTokens` sur les ARN de modèle de fondation. La passerelle l'utilise, sans frais, pour compter les jetons d'entrée d'une demande que le client a abandonnée, donc les [limites de dépenses](#admin) restent exactes. Sans cela, la passerelle revient à une demande Bedrock d'un jeton pour ce compte. |372| Permissions IAM | Accordez au principal de la passerelle `bedrock:InvokeModel` et `bedrock:InvokeModelWithResponseStream` sur les ARN de profil d'inférence et les ARN de modèle de fondation sous-jacents. Pour le catalogue intégré dans les régions US : `arn:aws:bedrock:<region>:<account>:inference-profile/us.anthropic.*` et `arn:aws:bedrock:*::foundation-model/anthropic.*`. Accordez également `bedrock:CountTokens` sur les ARN de modèle de fondation. La passerelle l'utilise, sans frais, pour compter les tokens d'entrée d'une demande que le client a abandonnée, donc les [limites de dépenses](#admin) restent exactes. Sans cela, la passerelle se rabat sur une demande Bedrock d'un token pour ce comptage. |

373| Accès au modèle | Amazon Bedrock active l'accès au modèle par défaut dans les régions commerciales. La porte au niveau du compte restante est celle d'Anthropic : un formulaire de cas d'utilisation unique ; si personne dans votre compte AWS ne l'a soumis, ouvrez la console Amazon Bedrock, sélectionnez un modèle Anthropic dans le catalogue de modèles, et complétez le formulaire. Voir [Soumettre les détails du cas d'utilisation](/docs/fr/amazon-bedrock#1-submit-use-case-details) pour le formulaire AWS Organizations et les permissions dont le soumetteur a besoin. |373| Accès au modèle | Amazon Bedrock active l'accès au modèle par défaut dans les régions commerciales. La porte au niveau du compte restante est celle d'Anthropic : un formulaire de cas d'utilisation unique ; si personne dans votre compte AWS ne l'a soumis, ouvrez la console Amazon Bedrock, sélectionnez un modèle Anthropic dans le catalogue de modèles, et complétez le formulaire. Voir [Soumettre les détails du cas d'utilisation](/docs/fr/amazon-bedrock#1-submit-use-case-details) pour le formulaire AWS Organizations et les permissions dont le soumetteur a besoin. |

374| EKS (IRSA) | Créez un rôle IAM avec la politique ci-dessus et une politique de confiance pour le fournisseur OIDC de votre cluster limité au compte de service de la passerelle. Annotez le compte de service avec `eks.amazonaws.com/role-arn: arn:aws:iam::<acct>:role/claude-gateway`. `auth: {}` le récupère. |374| EKS (IRSA) | Créez un rôle IAM avec la politique ci-dessus et une politique de confiance pour le fournisseur OIDC de votre cluster limité au compte de service de la passerelle. Annotez le compte de service avec `eks.amazonaws.com/role-arn: arn:aws:iam::<acct>:role/claude-gateway`. `auth: {}` le récupère. |

375| ECS / EC2 | Attachez le rôle IAM à la définition de tâche ou au profil d'instance. `auth: {}` le récupère. |375| ECS / EC2 | Attachez le rôle IAM à la définition de tâche ou au profil d'instance. `auth: {}` le récupère. |

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

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

378 378 

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

380 Appliquer une protection Amazon Bedrock380 Appliquer une protection Amazon Bedrock


394```394```

395 395 

396<Warning>396<Warning>

397 La passerelle ne supporte pas les balises d'entrée de protection. Elle n'ajoute aucune balise de contenu de garde aux invites, donc un filtre de protection qu'Amazon Bedrock applique uniquement à l'entrée balisée ne s'exécute pas sur le trafic via la passerelle. Pour savoir quels filtres dépendent des balises d'entrée, voir [balises d'entrée](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-tagging.html) dans la documentation Amazon Bedrock.397 La passerelle ne supporte pas les balises d'entrée de protection. Elle n'ajoute aucune balise de contenu de garde aux prompts, donc un filtre de protection qu'Amazon Bedrock applique uniquement à l'entrée balisée ne s'exécute pas sur le trafic via la passerelle. Pour savoir quels filtres dépendent des balises d'entrée, voir [balises d'entrée](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-tagging.html) dans la documentation Amazon Bedrock.

398</Warning>398</Warning>

399 399 

400Accordez également `bedrock:ApplyGuardrail` sur la protection au principal qui signe les demandes de cet upstream : le principal AWS de la passerelle, ou avec [`assume_role`](#bedrock-in-another-aws-account) le rôle nommé dans `role_arn`.400Accordez également `bedrock:ApplyGuardrail` sur la protection au principal qui signe les demandes de cet upstream : le principal AWS de la passerelle, ou avec [`assume_role`](#bedrock-in-another-aws-account) le rôle nommé dans `role_arn`.

401 401 

402Définissez `guardrail` sur chaque upstream `bedrock` ou sur aucun. La passerelle refuse de démarrer sur un mélange, car le [basculement](#multiple-upstreams) pourrait autrement envoyer une demande à un upstream Bedrock qui n'a pas de protection.402Définissez `guardrail` sur chaque upstream `bedrock` ou sur aucun. La passerelle refuse de démarrer sur un mélange, car le [basculement](#multiple-upstreams) pourrait autrement envoyer une demande à un upstream Bedrock qui n'a pas de protection.

403 403 

404La protection couvre les upstreams Bedrock uniquement. Si vous listez un autre fournisseur dans `upstreams`, la passerelle envoie les demandes à ce fournisseur sans la protection.404La protection couvre les upstreams Bedrock uniquement. Si vous listez un autre fournisseur dans `upstreams`, la passerelle envoie les demandes à ce fournisseur sans la protection, ou refuse de démarrer si ce fournisseur est [`mantle`](#amazon-bedrock-mantle-endpoint).

405 405 

406Lorsqu'une demande `/v1/messages` dont le corps porte un champ `amazon-bedrock-*`, tel que `amazon-bedrock-guardrailConfig`, atteint un upstream Bedrock qui a `guardrail` défini, la passerelle répond 400 au lieu de la transférer.406Lorsqu'une demande `/v1/messages` dont le corps porte un champ `amazon-bedrock-*`, tel que `amazon-bedrock-guardrailConfig`, atteint un upstream Bedrock qui a `guardrail` défini, la passerelle répond 400 au lieu de la transférer.

407 407 


430 430 

431| Clé | Signification |431| Clé | Signification |

432| - | - |432| - | - |

433| `role_arn` | Le rôle IAM que la passerelle assume, comme un ARN `arn:aws:iam::` ou `arn:aws-us-gov:iam::`. Donnez-lui les [permissions Bedrock](#amazon-bedrock) que cet upstream a besoin, `bedrock:CountTokens` inclus, plus `bedrock:ApplyGuardrail` lorsque l'upstream définit `guardrail`. |433| `role_arn` | Le rôle IAM que la passerelle assume, comme un ARN `arn:aws:iam::` ou `arn:aws-us-gov:iam::`. Donnez-lui les [permissions Bedrock](#amazon-bedrock) dont cet upstream a besoin, `bedrock:CountTokens` inclus, plus `bedrock:ApplyGuardrail` lorsque l'upstream définit `guardrail`. |

434| `external_id` | Optionnel. Envoyé comme ID externe à chaque appel `sts:AssumeRole`. Définissez-le lorsque la politique de confiance du rôle en exige un, et citez-le s'il est composé uniquement de chiffres. |434| `external_id` | Optionnel. Envoyé comme ID externe à chaque appel `sts:AssumeRole`. Définissez-le lorsque la politique de confiance du rôle en exige un, et mettez-le entre guillemets s'il est composé uniquement de chiffres. |

435| `session_name` | Optionnel. `email` ou `sub` donne à chaque développeur sa propre session : voir [Attribution des coûts AWS par développeur](#per-developer-aws-cost-attribution). Non défini, chaque demande utilise une session nommée `claude-apps-gateway`. |435| `session_name` | Optionnel. `email` ou `sub` donne à chaque développeur sa propre session : voir [Attribution des coûts AWS par développeur](#per-developer-aws-cost-attribution). Non défini, chaque demande utilise une session nommée `claude-apps-gateway`. |

436 436 

437La politique de confiance du rôle nomme le principal propre de la passerelle, tel que son IRSA ou son rôle de tâche ECS. Ce principal a besoin de `sts:AssumeRole` sur le rôle et aucune permission Bedrock de sa propre. Supprimez la `Condition` si vous ne définissez pas `external_id`.437La politique de confiance du rôle nomme le principal propre de la passerelle, tel que son IRSA ou son rôle de tâche ECS. Ce principal a besoin de `sts:AssumeRole` sur le rôle et d'aucune permission Bedrock propre. Supprimez la `Condition` si vous ne définissez pas `external_id`.

438 438 

439```json theme={null}439```json theme={null}

440{440{


449```449```

450 450 

451* Si STS refuse ou est inaccessible, la passerelle n'envoie pas la demande avec les identifiants propres de l'upstream. Elle enregistre l'erreur STS avec ce qu'il faut vérifier, puis essaie l'upstream suivant que vous avez listé. [Messages d'erreur Upstream](#upstream-error-messages) couvre ce que le client reçoit lorsqu'aucun upstream ne réussit. Un upstream ultérieur sans `assume_role` servirait la demande avec ses propres identifiants, donc listez-en un uniquement si c'est ce que vous voulez.451* Si STS refuse ou est inaccessible, la passerelle n'envoie pas la demande avec les identifiants propres de l'upstream. Elle enregistre l'erreur STS avec ce qu'il faut vérifier, puis essaie l'upstream suivant que vous avez listé. [Messages d'erreur Upstream](#upstream-error-messages) couvre ce que le client reçoit lorsqu'aucun upstream ne réussit. Un upstream ultérieur sans `assume_role` servirait la demande avec ses propres identifiants, donc listez-en un uniquement si c'est ce que vous voulez.

452* La passerelle appelle le point de terminaison STS régional `sts.<region>.amazonaws.com`, que son réseau doit atteindre. Pour le point de terminaison FIPS, définissez `AWS_USE_FIPS_ENDPOINT=true` dans l'environnement de la passerelle plutôt que `use_fips_endpoint` dans un fichier de configuration AWS.452* La passerelle appelle l'endpoint STS régional `sts.<region>.amazonaws.com`, que son réseau doit atteindre. Pour l'endpoint FIPS, définissez `AWS_USE_FIPS_ENDPOINT=true` dans l'environnement de la passerelle plutôt que `use_fips_endpoint` dans un fichier de configuration AWS.

453* `assume_role` s'applique à `provider: bedrock` uniquement et a besoin d'identifiants source SigV4 : la passerelle refuse de démarrer lorsqu'il est défini à côté de `aws_bearer_token`.453* `assume_role` s'applique à `provider: bedrock` uniquement et a besoin d'identifiants source SigV4 : la passerelle refuse de démarrer lorsqu'il est défini à côté de `aws_bearer_token`.

454* Chaque développeur que la passerelle admet peut utiliser cet upstream ; [`managed`](#managed) régit quels développeurs peuvent utiliser quels modèles. Pour garder un modèle servi via le rôle d'être également servi à partir d'un autre compte, donnez-lui un id personnalisé dont la carte `upstream_model` n'a que le nom de cet upstream. Pour un tel id, la passerelle ignore chaque autre upstream, donc ni la demande ni le compte de jetons pour une demande abandonnée ne peuvent basculer vers un autre compte. Les noms de modèles intégrés sont toujours essayés sur chaque upstream dans l'ordre, celui-ci inclus, et une demande qui l'atteint est signée avec le même rôle, donc listez cet upstream en dernier sauf si son compte devrait également les servir.454* Chaque développeur que la passerelle admet peut utiliser cet upstream ; [`managed`](#managed) régit quels développeurs peuvent utiliser quels modèles. Pour empêcher un modèle servi via le rôle d'être également servi à partir d'un autre compte, donnez-lui un id personnalisé dont la carte `upstream_model` n'a que le nom de cet upstream. Pour un tel id, la passerelle ignore chaque autre upstream, donc ni la demande ni le comptage de tokens pour une demande abandonnée ne peuvent basculer vers un autre compte. Une demande pour un nom de modèle intégré peut toujours [atteindre cet upstream](#multiple-upstreams), et la passerelle la signe avec le même rôle. Listez cet upstream en dernier sauf si son compte doit également servir ces modèles.

455 455 

456Cet exemple donne à un modèle un id personnalisé que seul l'upstream isolé sert :456Cet exemple donne à un modèle un id personnalisé que seul l'upstream isolé sert :

457 457 


482 session_name: email # ou sub482 session_name: email # ou sub

483```483```

484 484 

485`session_name` sélectionne quelle revendication vérifiée devient le `RoleSessionName` AWS : `email` ou `sub`. La passerelle écrit tout caractère autre que les lettres ASCII, les chiffres, et `_+,.@-` comme `=XX` hex par octet UTF-8, et raccourcit un résultat plus long que 64 caractères à un préfixe plus un hash, donc le nom de session de chaque développeur reste valide et unique. Une demande d'un développeur dont le jeton manque la revendication n'est pas envoyée via cet upstream, et le journal de l'opérateur dit de basculer vers `sub` ou de définir [`oidc.email_claim`](#oidc).485`session_name` sélectionne quelle revendication vérifiée devient le `RoleSessionName` AWS : `email` ou `sub`. La passerelle écrit tout caractère autre que les lettres ASCII, les chiffres, et `_+,.@-` comme `=XX` hex par octet UTF-8, et raccourcit un résultat plus long que 64 caractères à un préfixe plus un hash, donc le nom de session de chaque développeur reste valide et unique. Une demande d'un développeur dont le jeton n'a pas la revendication n'est pas envoyée via cet upstream, et le journal de l'opérateur indique de passer à `sub` ou de définir [`oidc.email_claim`](#oidc).

486 486 

487Un développeur actif coûte un appel STS par heure par réplique de passerelle, et les demandes premières concurrentes partagent un appel.487Un développeur actif coûte un appel STS par heure par réplique de passerelle, et les premières demandes concurrentes partagent un appel.

488 488 

489La passerelle fait également un appel de sa propre sur ce rôle : le compte de jetons pour une demande que le client a abandonnée, donc les [limites de dépenses](/docs/fr/claude-apps-gateway-spend-limits) restent exactes. Ce compte et sa [demande de secours d'un jeton](#amazon-bedrock) sont signés par la session partagée `claude-apps-gateway`, donc AWS attribue le secours à `claude-apps-gateway` plutôt qu'au développeur.489La passerelle fait également un appel qui lui est propre sur ce rôle : le comptage de tokens pour une demande que le client a abandonnée, afin que les [limites de dépenses](/docs/fr/claude-apps-gateway-spend-limits) restent exactes. Ce comptage et sa [demande de secours d'un token](#amazon-bedrock) sont signés par la session partagée `claude-apps-gateway`, donc AWS attribue la demande de secours à `claude-apps-gateway` plutôt qu'au développeur.

490 490 

491Pour une attribution stricte par développeur, définissez `assume_role` avec `session_name` sur chaque upstream Bedrock que vous listez. Un upstream sans lui signe les demandes qu'il sert avec ses propres identifiants.491Pour une attribution stricte par développeur, définissez `assume_role` avec `session_name` sur chaque upstream Bedrock que vous listez. Un upstream sans lui signe les demandes qu'il sert avec ses propres identifiants.

492 492 

493<h4 id="amazon-bedrock-mantle-endpoint">

494 Endpoint Mantle d'Amazon Bedrock

495</h4>

496 

497Le fournisseur `mantle` envoie l'inférence vers l'[endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) d'Amazon Bedrock. Il nécessite Claude Code v2.1.283 ou ultérieur sur le serveur de la passerelle. Les versions antérieures de la passerelle le rejettent au démarrage, donc mettez à niveau chaque réplique avant de l'ajouter.

498 

499L'exemple ci-dessous place Mantle en premier, avec un upstream Amazon Bedrock derrière lui pour servir chaque modèle que le champ `models` omet :

500 

501```yaml theme={null}

502upstreams:

503 - provider: mantle

504 region: us-east-1

505 models: [claude-opus-4-7, claude-haiku-4-5] # obligatoire

506 auth: {} # chaîne d'identifiants AWS par défaut

507 - provider: bedrock

508 region: us-east-1

509 auth: {}

510```

511 

512Le tableau ci-dessous liste les champs spécifiques à un upstream `mantle`.

513 

514| Champ | Obligatoire | Description |

515| - | - | - |

516| `region` | Oui | Région AWS. La passerelle en dérive l'endpoint sous la forme `https://bedrock-mantle.<region>.api.aws/anthropic`. |

517| `models` | Oui | Les modèles auxquels votre compte AWS a accès sur Mantle, nommés tels que les clients les envoient, par exemple `claude-haiku-4-5`. Seuls ceux-ci vont vers cet upstream, et chaque autre modèle passe au suivant. |

518| `auth` | Non | Accepte les mêmes clés que le bloc `auth` de l'upstream [Amazon Bedrock](#amazon-bedrock), selon les mêmes règles. |

519| `base_url` | Non | Remplacer l'endpoint dérivé. Conservez le chemin `/anthropic` à la fin. |

520 

521Accordez à l'identité AWS de l'upstream les actions IAM propres à Mantle pour l'inférence et le comptage de tokens, que [Utiliser l'endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) liste.

522 

523Pour un ID de modèle Mantle que la passerelle ne connaît pas, ajoutez une entrée au bloc [`models:`](#models) de premier niveau dont `upstream_model` mappe le nom de cet upstream à cet ID. Placez ensuite également l'`id` de cette entrée dans le champ `models` de cet upstream.

524 

525Les paramètres `guardrail` et `assume_role` d'un upstream `bedrock` ne s'étendent pas aux requêtes que Mantle sert :

526 

527* **`guardrail`** : la passerelle n'applique aucune [protection Bedrock](#apply-an-amazon-bedrock-guardrail) aux requêtes qu'elle envoie à Mantle, donc elle refuse de démarrer lorsqu'un upstream `mantle` est listé alors qu'un upstream `bedrock` définit `guardrail`.

528* **`assume_role`** : un upstream `mantle` n'accepte pas [`assume_role`](#bedrock-in-another-aws-account). Les requêtes que Mantle sert sont envoyées avec les identifiants `auth` propres à l'upstream `mantle`, et ne sont pas [attribuées par développeur](#per-developer-aws-cost-attribution).

529 

530Pour la signification des réponses d'erreur propres à Mantle, voir [Erreurs de l'endpoint Mantle](/docs/fr/amazon-bedrock#mantle-endpoint-errors).

531 

493<h4 id="claude-platform-on-aws">532<h4 id="claude-platform-on-aws">

494 Claude Platform on AWS533 Claude Platform on AWS

495</h4>534</h4>


511 # auth:550 # auth:

512 # aws_access_key_id: ${AWS_ACCESS_KEY_ID}551 # aws_access_key_id: ${AWS_ACCESS_KEY_ID}

513 # aws_secret_access_key: ${AWS_SECRET_ACCESS_KEY}552 # aws_secret_access_key: ${AWS_SECRET_ACCESS_KEY}

514 # Remplacez le point de terminaison dérivé :553 # Remplacez l'endpoint dérivé :

515 # base_url: https://aws-external-anthropic.us-east-1.api.aws554 # base_url: https://aws-external-anthropic.us-east-1.api.aws

516```555```

517 556 

518La plateforme s'exécute dans un compte AWS séparé d'Amazon Bedrock et signe les demandes SigV4 pour son propre nom de service, `aws-external-anthropic`, donc un rôle IAM limité à Bedrock ne l'autorise pas. Une clé API dans `auth.api_key` prend précédence lorsque les identifiants SigV4 sont également définis. Un bloc `auth` vide utilise la chaîne d'identifiants par défaut du SDK AWS, la même chaîne que l'upstream [Amazon Bedrock](#amazon-bedrock) utilise.557La plateforme s'exécute dans un compte AWS séparé d'Amazon Bedrock et signe les demandes SigV4 pour son propre nom de service, `aws-external-anthropic`, donc un rôle IAM limité à Bedrock ne l'autorise pas. Une clé API dans `auth.api_key` a priorité lorsque les identifiants SigV4 sont également définis. Un bloc `auth` vide utilise la chaîne d'identifiants par défaut du SDK AWS, la même chaîne que l'upstream [Amazon Bedrock](#amazon-bedrock) utilise.

519 558 

520| Champ | Obligatoire | Description |559| Champ | Obligatoire | Description |

521| - | - | - |560| - | - | - |

522| `region` | Oui | Région AWS, lettres minuscules, chiffres, et traits d'union. La passerelle dérive le point de terminaison à partir de lui comme `https://aws-external-anthropic.<region>.api.aws`. |561| `region` | Oui | Région AWS, lettres minuscules, chiffres, et traits d'union. La passerelle en dérive l'endpoint sous la forme `https://aws-external-anthropic.<region>.api.aws`. |

523| `workspace_id` | Oui | Envoyé comme en-tête à chaque demande ; la plateforme l'exige |562| `workspace_id` | Oui | Envoyé comme en-tête à chaque demande ; la plateforme l'exige |

524| `auth.api_key` | Non | Clé API pour la plateforme, envoyée comme `x-api-key`. Pas un jeton porteur : les deux modes d'authentification sont une clé API ou SigV4. |563| `auth.api_key` | Non | Clé API pour la plateforme, envoyée comme `x-api-key`. Pas un jeton porteur : les deux modes d'authentification sont une clé API ou SigV4. |

525| `auth.aws_access_key_id` / `auth.aws_secret_access_key` | Non | Identifiants SigV4 explicites. Définir l'un sans l'autre échoue au démarrage. `auth.aws_session_token` est accepté à côté d'eux. |564| `auth.aws_access_key_id` / `auth.aws_secret_access_key` | Non | Identifiants SigV4 explicites. Définir l'un sans l'autre échoue au démarrage. `auth.aws_session_token` est accepté à côté d'eux. |

526| `base_url` | Non | Remplacez le point de terminaison dérivé |565| `base_url` | Non | Remplacer l'endpoint dérivé |

527 566 

528Parce que la plateforme résout les ID de modèle propriétaires, le catalogue intégré achemine vers elle sans bloc [`models:`](#models). Lorsque vous organisez une liste `models:`, clé l'entrée `anthropicAws:` avec l'ID propriétaire.567Parce que la plateforme résout les ID de modèle propriétaires, le catalogue intégré achemine vers elle sans bloc [`models:`](#models). Lorsque vous organisez une liste `models:`, utilisez la clé `anthropicAws:` pour l'entrée avec l'ID propriétaire.

529 568 

530<h4 id="google-cloud-agent-platform">569<h4 id="google-cloud-agent-platform">

531 Google Cloud Agent Platform570 Google Cloud Agent Platform


538 - provider: vertex577 - provider: vertex

539 region: us-east5578 region: us-east5

540 project_id: example-prod579 project_id: example-prod

541 auth: {} # identifiants par défaut d'application préférés580 auth: {} # préféré : identifiants par défaut d'application

542 # OU un fichier de clé de compte de service :581 # OU un fichier de clé de compte de service :

543 # auth: { service_account_json: /secrets/sa.json }582 # auth: { service_account_json: /secrets/sa.json }

544 # Remplacez le point de terminaison aiplatform pour Private Service Connect :583 # Remplacez l'endpoint aiplatform pour Private Service Connect :

545 # base_url: https://us-east5-aiplatform.p.googleapis.com584 # base_url: https://us-east5-aiplatform.p.googleapis.com

546```585```

547 586 

548Un bloc `auth` vide utilise les identifiants par défaut d'application : `GOOGLE_APPLICATION_CREDENTIALS`, métadonnées GCE, ou Workload Identity GKE. Les fichiers de clé JSON de compte de service sont supportés mais déconseillés ; utilisez Workload Identity ou attachez un compte de service à l'instance GCE ou Cloud Run.587Un bloc `auth` vide utilise les identifiants par défaut d'application : `GOOGLE_APPLICATION_CREDENTIALS`, métadonnées GCE, ou Workload Identity GKE. Les fichiers de clé JSON de compte de service sont supportés mais déconseillés ; utilisez Workload Identity ou attachez un compte de service à l'instance GCE ou Cloud Run.

549 588 

550Définissez `region: global` pour utiliser le [point de terminaison global pour Google Cloud's Agent Platform](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations) au lieu d'un régional. Google achemine ensuite chaque demande vers une région disponible, donc vous ne suivez pas la disponibilité du modèle par région. Définir une région spécifique épingle chaque demande à elle.589Définissez `region: global` pour utiliser l'[endpoint global pour Google Cloud's Agent Platform](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations) au lieu d'un endpoint régional. Google achemine ensuite chaque demande vers une région disponible, donc vous ne suivez pas la disponibilité du modèle par région. Définir une région spécifique épingle chaque demande à celle-ci.

551 590 

552| Configuration | Comment |591| Configuration | Comment |

553| - | - |592| - | - |

554| Permissions IAM | Accordez au compte de service de la passerelle `roles/aiplatform.user` sur le projet, ou un rôle personnalisé avec `aiplatform.endpoints.predict`. Activez l'API Google Cloud's Agent Platform (`aiplatform.googleapis.com`). |593| Permissions IAM | Accordez au compte de service de la passerelle `roles/aiplatform.user` sur le projet, ou un rôle personnalisé avec `aiplatform.endpoints.predict`. Activez l'API Google Cloud's Agent Platform (`aiplatform.googleapis.com`). |

555| Accès au modèle | Dans Model Garden, activez les modèles Claude pour votre projet. Ils publient vers des régions spécifiques ; vérifiez la fiche du modèle pour les régions supportées. |594| Accès au modèle | Dans Model Garden, activez les modèles Claude pour votre projet. Ils publient vers des régions spécifiques ; vérifiez la fiche du modèle pour les régions supportées. |

556| GKE (Workload Identity) | Liez un compte de service GCP au compte de service Kubernetes de la passerelle et annotez le KSA avec `iam.gke.io/gcp-service-account: claude-gateway@<proj>.iam.gserviceaccount.com`. `auth: {}` le récupère. |595| GKE (Workload Identity) | Liez un compte de service GCP au compte de service Kubernetes de la passerelle et annotez le KSA avec `iam.gke.io/gcp-service-account: claude-gateway@<proj>.iam.gserviceaccount.com`. `auth: {}` le récupère. |

557| Cloud Run / GCE | Définissez le compte de service du service sur un avec `roles/aiplatform.user`. `auth: {}` le récupère. |596| Cloud Run / GCE | Définissez le compte de service du service sur un compte avec `roles/aiplatform.user`. `auth: {}` le récupère. |

558| N'importe où ailleurs | `auth: { service_account_json: /secrets/sa.json }`, le chemin vers un fichier de clé JSON monté en tant que secret. Le champ prend un chemin de fichier, pas le contenu de la clé, donc aucune expansion `${file:…}` n'est impliquée. |597| N'importe où ailleurs | `auth: { service_account_json: /secrets/sa.json }`, le chemin vers un fichier de clé JSON monté en tant que secret. Le champ prend un chemin de fichier, pas le contenu de la clé, donc aucune expansion `${file:…}` n'est impliquée. |

559 598 

560<h4 id="microsoft-foundry">599<h4 id="microsoft-foundry">


573 # api_key: ${FOUNDRY_API_KEY}612 # api_key: ${FOUNDRY_API_KEY}

574```613```

575 614 

576`use_azure_ad: true` résout via `DefaultAzureCredential` : Managed Identity sur AKS, ACI, ou App Service ; l'Azure CLI ; ou les identifiants d'environnement. Les clés API fonctionnent mais sont au niveau du projet et ne tournent pas automatiquement. Le point de terminaison de Microsoft Foundry est dérivé de `resource:` ; définissez le `base_url` optionnel pour le remplacer pour les clouds souverains tels qu'Azure Government.615`use_azure_ad: true` résout via `DefaultAzureCredential` : Managed Identity sur AKS, ACI, ou App Service ; l'Azure CLI ; ou les identifiants d'environnement. Les clés API fonctionnent mais sont au niveau du projet et ne tournent pas automatiquement. L'endpoint de Microsoft Foundry est dérivé de `resource:` ; définissez le `base_url` optionnel pour le remplacer pour les clouds souverains tels qu'Azure Government.

577 616 

578| Configuration | Comment |617| Configuration | Comment |

579| - | - |618| - | - |


581| Déploiements | Microsoft Foundry utilise les noms de déploiement choisis par l'administrateur, pas les ID de modèle canoniques. Ajoutez un bloc [`models:`](#models) mappant chaque ID canonique à votre nom de déploiement. |620| Déploiements | Microsoft Foundry utilise les noms de déploiement choisis par l'administrateur, pas les ID de modèle canoniques. Ajoutez un bloc [`models:`](#models) mappant chaque ID canonique à votre nom de déploiement. |

582| AKS (workload identity) | Fédérez une identité gérée attribuée par l'utilisateur avec l'émetteur OIDC du cluster et liez-la au compte de service de la passerelle. `use_azure_ad: true` la récupère via `WorkloadIdentityCredential`. |621| AKS (workload identity) | Fédérez une identité gérée attribuée par l'utilisateur avec l'émetteur OIDC du cluster et liez-la au compte de service de la passerelle. `use_azure_ad: true` la récupère via `WorkloadIdentityCredential`. |

583| ACI / App Service | Activez l'identité gérée attribuée par le système ou l'utilisateur sur la ressource. `use_azure_ad: true` la récupère. |622| ACI / App Service | Activez l'identité gérée attribuée par le système ou l'utilisateur sur la ressource. `use_azure_ad: true` la récupère. |

584| N'importe où ailleurs | `auth: { api_key: "${FOUNDRY_API_KEY}" }`. Citez `${…}` à l'intérieur de `{ }`. |623| N'importe où ailleurs | `auth: { api_key: "${FOUNDRY_API_KEY}" }`. Mettez `${…}` entre guillemets à l'intérieur de `{ }`. |

585 624 

586<h4 id="static-headers-on-upstream-requests">625<h4 id="static-headers-on-upstream-requests">

587 En-têtes statiques sur les demandes upstream626 En-têtes statiques sur les demandes upstream


591 630 

592`headers:` nécessite Claude Code v2.1.277 ou ultérieur sur le serveur de la passerelle. Une passerelle antérieure refuse de démarrer lorsqu'elle trouve la clé. Mettez à niveau chaque réplique avant d'ajouter la clé, et supprimez la clé avant de revenir à une version antérieure.631`headers:` nécessite Claude Code v2.1.277 ou ultérieur sur le serveur de la passerelle. Une passerelle antérieure refuse de démarrer lorsqu'elle trouve la clé. Mettez à niveau chaque réplique avant d'ajouter la clé, et supprimez la clé avant de revenir à une version antérieure.

593 632 

594Les en-têtes vont au serveur que `base_url` nomme, ou au point de terminaison propre du fournisseur lorsque `base_url` n'est pas défini. Le fournisseur les reçoit également sauf si votre proxy les supprime.633Les en-têtes vont au serveur que `base_url` nomme, ou à l'endpoint propre du fournisseur lorsque `base_url` n'est pas défini. Le fournisseur les reçoit également sauf si votre proxy les supprime.

595 634 

596Cet exemple atteint un upstream `provider: vertex` via un proxy à `upstream-proxy.internal.example.com`. Il définit l'en-tête `x-source` que le proxy lit, et envoie un jeton de la variable d'environnement `PROXY_TOKEN` comme `x-proxy-token` :635Cet exemple atteint un upstream `provider: vertex` via un proxy à `upstream-proxy.internal.example.com`. Il définit l'en-tête `x-source` que le proxy lit, et envoie un jeton de la variable d'environnement `PROXY_TOKEN` comme `x-proxy-token` :

597 636 


607 x-proxy-token: ${PROXY_TOKEN}646 x-proxy-token: ${PROXY_TOKEN}

608```647```

609 648 

610Les valeurs sont du texte ASCII imprimable sans espace à chaque extrémité. Citez un nombre, `true`, ou `false` pour que YAML le lise comme texte.649Les valeurs sont du texte ASCII imprimable sans espace à chaque extrémité. Mettez entre guillemets un nombre, `true`, ou `false` pour que YAML le lise comme texte.

611 650 

612Pour garder un secret hors du fichier de configuration, utilisez l'[expansion de secret](#secret-expansion) pour charger la valeur à partir d'une variable d'environnement avec `${VAR}` ou à partir d'un fichier avec `${file:/path}`. Un `${VAR}` qui se résout en une valeur vide arrête le démarrage de la passerelle.651Pour garder un secret hors du fichier de configuration, utilisez l'[expansion de secret](#secret-expansion) pour charger la valeur à partir d'une variable d'environnement avec `${VAR}` ou à partir d'un fichier avec `${file:/path}`. Un `${VAR}` qui se résout en une valeur vide empêche la passerelle de démarrer.

613 652 

614`headers:` fonctionne sur chaque fournisseur, et chaque upstream envoie uniquement le sien.653`headers:` fonctionne sur chaque fournisseur, et chaque upstream envoie uniquement les siens.

615 654 

616Pas chaque demande que la passerelle envoie à un upstream les porte :655Les demandes que la passerelle envoie à un upstream ne les portent pas toutes :

617 656 

618| Demande que la passerelle envoie à cet upstream | Porte `headers:` |657| Demande que la passerelle envoie à cet upstream | Porte `headers:` |

619| - | - |658| - | - |


636 675 

637Le même fournisseur peut apparaître plus d'une fois avec un `name:` distinct. Cela couvre différentes régions, différents comptes via différentes chaînes d'identifiants, débit provisionné par rapport à la demande, et basculement inter-fournisseur.676Le même fournisseur peut apparaître plus d'une fois avec un `name:` distinct. Cela couvre différentes régions, différents comptes via différentes chaînes d'identifiants, débit provisionné par rapport à la demande, et basculement inter-fournisseur.

638 677 

639La passerelle essaie les upstreams dans l'ordre. `5xx`, `429`, `401`, `403`, `404`, timeouts, et point de terminaison manquant (`501`) basculer ; les autres `4xx` ne le font pas.678La passerelle essaie les upstreams dans l'ordre. `5xx`, `429`, `401`, `403`, `404`, timeouts, et endpoint manquant (`501`) basculent ; les autres `4xx` ne le font pas.

640 679 

641`429` est par capacité upstream, donc l'épuisement du débit provisionné (PT) bascule vers la demande. Si vous définissez [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) sur un upstream, un `429` à une demande qui portait l'e-mail du développeur est un refus par utilisateur à la place et ne bascule pas.680`429` est par capacité upstream, donc l'épuisement du débit provisionné (PT) bascule vers la demande. Si vous définissez [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) sur un upstream, un `429` à une demande qui portait l'e-mail du développeur est un refus par utilisateur à la place et ne bascule pas.

642 681 


648 687 

649`404` est par disponibilité du modèle upstream, donc un upstream qui n'a pas activé un modèle ne bloque pas un upstream ultérieur qui le sert. Un upstream qui ne peut pas résoudre le modèle demandé est ignoré sans un aller-retour réseau.688`404` est par disponibilité du modèle upstream, donc un upstream qui n'a pas activé un modèle ne bloque pas un upstream ultérieur qui le sert. Un upstream qui ne peut pas résoudre le modèle demandé est ignoré sans un aller-retour réseau.

650 689 

651Cet exemple achemine une allocation de débit provisionné Amazon Bedrock en premier, déborde vers la demande et un deuxième compte, et revient à l'API Anthropic en dernier :690Cet exemple achemine une allocation de débit provisionné Amazon Bedrock en premier, déborde vers la demande et un deuxième compte, et se rabat sur l'API Anthropic en dernier :

652 691 

653```yaml theme={null}692```yaml theme={null}

654upstreams:693upstreams:


657 provider: bedrock696 provider: bedrock

658 region: us-east-1697 region: us-east-1

659 auth: {}698 auth: {}

660 # Débordement : demande inter-régions.699 # Débordement : à la demande inter-régions.

661 - name: bedrock-od700 - name: bedrock-od

662 provider: bedrock701 provider: bedrock

663 region: us-west-2702 region: us-west-2


675 auth:714 auth:

676 api_key: ${ANTHROPIC_API_KEY}715 api_key: ${ANTHROPIC_API_KEY}

677 716 

678# Les ID de modèle par upstream sont clés sur le `name:` de l'upstream.717# Les ID de modèle par upstream sont indexés sur le `name:` de l'upstream.

679models:718models:

680 - id: claude-opus-4-8719 - id: claude-opus-4-8

681 label: Claude Opus 4.8720 label: Claude Opus 4.8


691| Régions différentes | Un upstream Amazon Bedrock par région, chacun avec sa propre `region:`. Avec [`auto_include_builtin_models: true`](#models), les profils d'inférence inter-régions acheminent automatiquement ; pour les déploiements épinglés à la région, utilisez un bloc `models:`. |730| Régions différentes | Un upstream Amazon Bedrock par région, chacun avec sa propre `region:`. Avec [`auto_include_builtin_models: true`](#models), les profils d'inférence inter-régions acheminent automatiquement ; pour les déploiements épinglés à la région, utilisez un bloc `models:`. |

692| Comptes différents | Un upstream Amazon Bedrock par compte. La chaîne par défaut (`auth: {}`) utilise l'identité du pod ; pour un deuxième compte, ajoutez [`assume_role`](#bedrock-in-another-aws-account) pour l'atteindre avec des identifiants de courte durée, ou définissez des identifiants explicites ou un jeton porteur dans `auth:`. |731| Comptes différents | Un upstream Amazon Bedrock par compte. La chaîne par défaut (`auth: {}`) utilise l'identité du pod ; pour un deuxième compte, ajoutez [`assume_role`](#bedrock-in-another-aws-account) pour l'atteindre avec des identifiants de courte durée, ou définissez des identifiants explicites ou un jeton porteur dans `auth:`. |

693| Débit provisionné | Mappez le modèle à l'ARN de débit provisionné dans `models:` pour le nom de cet upstream. Les autres upstreams gardent l'ID à la demande, donc la capacité PT est épuisée avant de basculer. |732| Débit provisionné | Mappez le modèle à l'ARN de débit provisionné dans `models:` pour le nom de cet upstream. Les autres upstreams gardent l'ID à la demande, donc la capacité PT est épuisée avant de basculer. |

694| Points de terminaison VPC / FIPS | Définissez `base_url:` sur l'upstream à votre URL de point de terminaison VPC ou FIPS |733| Endpoints VPC / FIPS | Définissez `base_url:` sur l'upstream à votre URL d'endpoint VPC ou FIPS |

695| Acheminement limité au modèle | Uniquement un id de modèle personnalisé, un qui n'est pas un nom de modèle Claude intégré, ignore les upstreams absents de sa carte `upstream_model:`. La passerelle essaie les modèles intégrés sur chaque upstream dans l'ordre et utilise l'ID par défaut du fournisseur où la carte n'a pas d'entrée, donc pour les modèles intégrés, la carte change quel ID un upstream reçoit plutôt que s'il est essayé ; un upstream qui rejette l'ID suit les mêmes [règles de basculement](#upstreams) que n'importe quelle autre erreur upstream. |734| Acheminement limité au modèle | Uniquement un `id` de modèle personnalisé, qui n'est pas un nom de modèle Claude intégré, ignore les upstreams absents de sa carte `upstream_model:`. Un upstream `mantle` n'est essayé que pour les modèles listés dans son [champ `models`](#amazon-bedrock-mantle-endpoint). Sur chaque autre upstream, la passerelle essaie les modèles intégrés dans l'ordre et utilise l'ID par défaut du fournisseur où la carte n'a pas d'entrée, donc pour les modèles intégrés, la carte change quel ID un upstream reçoit plutôt que s'il est essayé ; un upstream qui rejette l'ID suit les mêmes [règles de basculement](#upstreams) que n'importe quelle autre erreur upstream. |

696 735 

697Le basculement entre les fournisseurs cloud, ou vers l'API Anthropic directe, change quel accord, géographie, et autres conditions régissent la demande.736Le basculement entre les fournisseurs cloud, ou vers l'API Anthropic directe, change quel accord, géographie, et autres conditions régissent la demande.

698 737 


848 - match: {}887 - match: {}

849 cli:888 cli:

850 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]889 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

890 # Make the Default option in /model resolve inside each policy's

891 # list. The eng-contractors policy inherits enforceAvailableModels.

892 enforceAvailableModels: true

851```893```

852 894 

853Un fourre-tout `match: {}`, conventionnellement listé en dernier, est traité comme une couche de base. Chaque autre politique hérite du fourre-tout toute clé qu'elle ne définit pas, afin que les entrées par rôle n'aient besoin de lister que ce qui diffère de la valeur par défaut de l'organisation. Les règles de fusion dépendent du type de clé :895Un fourre-tout `match: {}`, conventionnellement listé en dernier, est traité comme une couche de base. Chaque autre politique hérite du fourre-tout toute clé qu'elle ne définit pas, afin que les entrées par rôle n'aient besoin de lister que ce qui diffère de la valeur par défaut de l'organisation. Les règles de fusion dépendent du type de clé :


856* **Listes de refus et tableaux de hooks** : `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces` et chaque tableau de type d'événement `hooks`. Ceux-ci prennent l'union de la base et de la politique, afin qu'un hook de refus ou d'audit à l'échelle de l'organisation ne puisse pas être accidentellement supprimé par un remplacement par rôle.898* **Listes de refus et tableaux de hooks** : `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces` et chaque tableau de type d'événement `hooks`. Ceux-ci prennent l'union de la base et de la politique, afin qu'un hook de refus ou d'audit à l'échelle de l'organisation ne puisse pas être accidentellement supprimé par un remplacement par rôle.

857* **Clés de type enregistrement** : `env`, `modelOverrides` et `skillOverrides`. Celles-ci fusionnent superficiellement, afin qu'un bloc `env` par rôle remplace les clés qu'il définit et hérite du reste de la base.899* **Clés de type enregistrement** : `env`, `modelOverrides` et `skillOverrides`. Celles-ci fusionnent superficiellement, afin qu'un bloc `env` par rôle remplace les clés qu'il définit et hérite du reste de la base.

858 900 

859`availableModels` est également appliqué côté serveur à `/v1/messages`, afin qu'un modèle refusé retourne `400` indépendamment de ce que le client envoie.901`availableModels` est également appliqué côté serveur à `/v1/messages`, afin qu'un modèle refusé retourne `400` indépendamment de ce que le client envoie. Une liste vide refuse tous les modèles. La vérification couvre également le modèle sur lequel une session démarre avant que le développeur n'en choisisse un ; [démarrez donc les sessions sur un modèle autorisé par la politique](#start-sessions-on-a-model-the-policy-allows).

860 902 

861La passerelle valide elle-même la valeur `model` avant de relayer une requête, afin qu'une valeur mal formée n'atteigne jamais un upstream. Elle rejette la requête avec un `400` dans deux cas :903La passerelle valide elle-même la valeur `model` avant de relayer une requête, afin qu'une valeur mal formée n'atteigne jamais un upstream. Elle rejette la requête avec un `400` dans deux cas :

862 904 


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

884</Note>926</Note>

885 927 

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

929 Démarrer les sessions sur un modèle autorisé par la politique

930</h4>

931 

932Si `availableModels` exclut le modèle par défaut de Claude Code, les sessions obtiennent des réponses `400` jusqu'à ce que le développeur choisisse un modèle listé, par exemple avec `/model`. Dans les sessions de passerelle, le modèle par défaut est le modèle Opus vers lequel l'alias `opus` se résout, et `availableModels` seul ne le modifie pas.

933 

934Pour corriger cela, définissez [`enforceAvailableModels: true`](/docs/fr/model-config#enforce-the-allowlist-for-the-default-model) dans le même bloc `cli`, puis vérifiez quel type d'entrée contient la liste :

935 

936* **Un alias tel que `sonnet`, ou un ID intégré tel que `claude-sonnet-4-6`** : les sessions démarrent sur l'un de ces modèles, et l'option Default de `/model` se résout vers celui-ci

937* **Aucun alias ni ID intégré dans la liste** : les sessions peuvent continuer à démarrer sur le modèle par défaut intégré, donc définissez également [`model`](/docs/fr/model-config#control-the-model-users-run-on) sur l'un des ID listés dans le bloc `cli` de cette politique

938 

939Cette politique liste un ID personnalisé défini par [`models`](#models), et démarre les sessions sur cet ID :

940 

941```yaml theme={null}

942managed:

943 policies:

944 - match: { groups: [restricted-projects] }

945 cli:

946 availableModels: [claude-opus-restricted]

947 enforceAvailableModels: true

948 model: claude-opus-restricted

949```

950 

886<h4 id="matcher-values-that-stop-the-gateway-at-boot">951<h4 id="matcher-values-that-stop-the-gateway-at-boot">

887 Valeurs de matcher qui arrêtent la passerelle au démarrage952 Valeurs de matcher qui arrêtent la passerelle au démarrage

888</h4>953</h4>


920 cli:985 cli:

921 # Model access (also enforced server-side at /v1/messages)986 # Model access (also enforced server-side at /v1/messages)

922 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]987 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

988 enforceAvailableModels: true # Default resolves inside the list

923 989 

924 # Permission policy990 # Permission policy

925 permissions:991 permissions:


1041 - match: { groups: [eng-contractors] }1107 - match: { groups: [eng-contractors] }

1042 cli:1108 cli:

1043 availableModels: [claude-sonnet-4-6]1109 availableModels: [claude-sonnet-4-6]

1110 enforceAvailableModels: true

1044 desktop:1111 desktop:

1045 isLocalDevMcpEnabled: false1112 isLocalDevMcpEnabled: false

1046 disableAutoUpdates: true1113 disableAutoUpdates: true


1435 # region: us-east-11502 # region: us-east-1

1436 # auth: {}1503 # auth: {}

1437 1504 

1505 # - provider: mantle

1506 # region: us-east-1

1507 # models: [claude-opus-4-8, claude-opus-4-7, claude-haiku-4-5]

1508 # auth: {}

1509 

1438 # - provider: anthropicAws1510 # - provider: anthropicAws

1439 # region: us-east-11511 # region: us-east-1

1440 # workspace_id: wrkspc_...1512 # workspace_id: wrkspc_...


1457 upstream_model:1529 upstream_model:

1458 anthropic: claude-opus-4-81530 anthropic: claude-opus-4-8

1459 # bedrock: us.anthropic.claude-opus-4-81531 # bedrock: us.anthropic.claude-opus-4-8

1532 # mantle: anthropic.claude-opus-4-8

1460 # anthropicAws: claude-opus-4-81533 # anthropicAws: claude-opus-4-8

1461 # vertex: claude-opus-4-81534 # vertex: claude-opus-4-8

1462 # foundry: <your-opus-deployment-name>1535 # foundry: <your-opus-deployment-name>


1474 - match: { groups: [contractors] }1547 - match: { groups: [contractors] }

1475 cli:1548 cli:

1476 availableModels: [claude-haiku-4-5]1549 availableModels: [claude-haiku-4-5]

1477 # Limitez l'option du sélecteur par défaut à availableModels au lieu de

1478 # la valeur par défaut du niveau, afin que les entrepreneurs n'obtiennent pas une erreur 400 sur la valeur par défaut.

1479 enforceAvailableModels: true

1480 # allow approuve automatiquement ces outils ; il ne bloque pas le reste.1550 # allow approuve automatiquement ces outils ; il ne bloque pas le reste.

1481 # Ajoutez des règles de refus pour restreindre les outils.1551 # Ajoutez des règles de refus pour restreindre les outils.

1482 permissions: { allow: [Read, Grep] }1552 permissions: { allow: [Read, Grep] }

1483 - match: {}1553 - match: {}

1484 cli:1554 cli:

1485 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]1555 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

1556 # Limitez l'option par défaut du sélecteur aux availableModels de chaque politique

1557 # au lieu de la valeur par défaut intégrée, afin qu'aucun rôle n'obtienne une erreur 400 sur l'option par défaut.

1558 # La politique des entrepreneurs hérite de cette clé.

1559 enforceAvailableModels: true

1486 permissions:1560 permissions:

1487 allow: [Read, Grep, Bash, Edit]1561 allow: [Read, Grep, Bash, Edit]

1488 deny: ["WebFetch"]1562 deny: ["WebFetch"]

Details

429 429 

430La passerelle répond `431` lorsque le total des en-têtes d'une requête dépasse 256 Kio, ou [`limits.max_request_header_bytes`](/docs/fr/claude-apps-gateway-config#http-tuning) si vous le définissez. Elle n'écrit aucune ligne de log ni aucun événement d'audit pour ces requêtes. Les versions de la passerelle antérieures à v2.1.284 répondent `431` au-delà de 16 Kio.430La passerelle répond `431` lorsque le total des en-têtes d'une requête dépasse 256 Kio, ou [`limits.max_request_header_bytes`](/docs/fr/claude-apps-gateway-config#http-tuning) si vous le définissez. Elle n'écrit aucune ligne de log ni aucun événement d'audit pour ces requêtes. Les versions de la passerelle antérieures à v2.1.284 répondent `431` au-delà de 16 Kio.

431 431 

432Ce qu'il faut modifier dépend de la version et de la configuration de votre passerelle :432Commencez par le premier de ces cas qui s'applique à votre passerelle :

433 433 

434* **Passerelle antérieure à v2.1.284** : mettez à niveau la passerelle434* **Passerelle antérieure à v2.1.284** : mettez à niveau la passerelle

435* **`limits.max_request_header_bytes` défini** : augmentez la valeur ou supprimez la clé435* **`limits.max_request_header_bytes` défini** : augmentez la valeur ou supprimez la clé

436* **Aucun de ces cas ne s'applique, ou le `431` persiste ensuite** : faites en sorte que votre IdP émette moins de groupes. [Configuration du fournisseur d'identité](#identity-provider-setup) explique comment Okta, Microsoft Entra ID et Google Workspace fournissent les groupes436* **Aucun de ces cas ne s'applique, ou le `431` persiste ensuite** : faites en sorte que votre IdP émette moins de groupes. [Configuration du fournisseur d'identité](#identity-provider-setup) explique comment Okta, Microsoft Entra ID et Google Workspace fournissent les groupes

437 437 

438Lorsque vous réduisez la réclamation des groupes, conservez les groupes que vous avez nommés dans ces paramètres, qui déterminent l'accès, la politique et les plafonds de dépenses d'un développeur :

439 

440* **[`oidc.allowed_groups`](/docs/fr/claude-apps-gateway-config#oidc)** : détermine qui peut se connecter

441* **[`admin.admin_groups`](/docs/fr/claude-apps-gateway-config#admin)** : détermine qui peut appeler l'API d'administration avec sa session de passerelle

442* **`match.groups` dans [`managed.policies`](/docs/fr/claude-apps-gateway-config#managed)** : détermine quelle politique s'applique à un développeur

443* **[Plafonds de dépenses](/docs/fr/claude-apps-gateway-spend-limits) `rbac_group`** : déterminent quels plafonds de groupe s'appliquent à un développeur

444 

438<h2 id="related">445<h2 id="related">

439 Connexes446 Connexes

440</h2>447</h2>

Details

12 12 

13Une session cloud est une session Claude Code qui s'exécute sur l'infrastructure cloud au lieu de sur votre machine. Par défaut, elle s'exécute sur l'infrastructure gérée par Anthropic, ou sur l'[environnement auto-hébergé](/docs/fr/self-hosted-environments) de votre organisation lorsqu'elle y est acheminée. La session continue de s'exécuter après que vous fermiez votre ordinateur portable, et vous pouvez la vérifier ou la diriger depuis n'importe quel appareil.13Une session cloud est une session Claude Code qui s'exécute sur l'infrastructure cloud au lieu de sur votre machine. Par défaut, elle s'exécute sur l'infrastructure gérée par Anthropic, ou sur l'[environnement auto-hébergé](/docs/fr/self-hosted-environments) de votre organisation lorsqu'elle y est acheminée. La session continue de s'exécuter après que vous fermiez votre ordinateur portable, et vous pouvez la vérifier ou la diriger depuis n'importe quel appareil.

14 14 

15Pour permettre aux sessions cloud de cloner votre code depuis GitHub et de pousser des branches, connectez GitHub avec l'une des [méthodes de connexion GitHub](#github-authentication-options). Si votre dépôt est hébergé sur GitLab, Bitbucket ou un autre hébergeur, consultez [Restrictions de plateforme](#limitations) pour savoir ce qui fonctionne.

16 

15Vous pouvez démarrer une session cloud à partir de l'une de ces surfaces :17Vous pouvez démarrer une session cloud à partir de l'une de ces surfaces :

16 18 

17* **Navigateur** : [claude.ai/code](https://claude.ai/code), également appelé Claude Code sur le web19* **Navigateur** : [claude.ai/code](https://claude.ai/code), également appelé Claude Code sur le web


20* **Terminal** : [`claude --cloud`](#from-terminal-to-cloud)22* **Terminal** : [`claude --cloud`](#from-terminal-to-cloud)

21* **Routines** : les [exécutions planifiées et déclenchées](/docs/fr/routines) s'exécutent chacune en tant que session cloud23* **Routines** : les [exécutions planifiées et déclenchées](/docs/fr/routines) s'exécutent chacune en tant que session cloud

22 24 

23Pour que Claude démarre et suive de nombreuses sessions cloud pour un corps de travail, utilisez un [projet](/docs/fr/claude-projects). Une session dans votre terminal, votre IDE ou l'application de bureau avec **Local** sélectionné s'exécute sur votre propre machine à la place. Pour diriger l'une de ces sessions locales depuis votre téléphone ou navigateur, utilisez [Contrôle à distance](/docs/fr/remote-control).25Une fois la configuration terminée, utilisez cette page pour déplacer le travail entre votre terminal et le cloud, gérer et partager des sessions, activer la correction automatique des pull requests et résoudre les problèmes.

24 

25<Tip>

26 Nouveau sur les sessions cloud ? Commencez par [Démarrer](/docs/fr/web-quickstart) pour connecter votre compte GitHub et soumettre votre première tâche.

27</Tip>

28 26 

29Cette page couvre :27<Note>

28 Ces cas sont traités sur d'autres pages :

30 29 

31* [Environnements cloud](#cloud-environments) : où les sessions s'exécutent et où configurer cela30 * **Démarrer votre première session cloud** : [Démarrer avec les sessions cloud](/docs/fr/web-quickstart) connecte GitHub et vous guide à travers une tâche dans le navigateur

32* [Options d'authentification GitHub](#github-authentication-options) : deux façons de connecter GitHub31 * **De nombreuses sessions cloud pour un même corps de travail** : avec un [projet](/docs/fr/claude-projects), Claude les démarre et en assure le suivi pour vous

33* [Déplacer les tâches entre le terminal et le cloud](#move-tasks-between-terminal-and-cloud) avec `--cloud` et `--teleport`32 * **Diriger une session locale depuis un autre appareil** : les sessions dans votre terminal, votre IDE ou l'application de bureau avec **Local** sélectionné s'exécutent sur votre machine, et [Remote Control](/docs/fr/remote-control) vous permet d'y accéder depuis votre téléphone ou votre navigateur

34* [Travailler avec les sessions](#work-with-sessions) : modes de permission, examen, partage, archivage, suppression33</Note>

35* [Correction automatique des demandes de tirage](#auto-fix-pull-requests) : répondre automatiquement aux défaillances CI et aux commentaires d'examen

36* [Sécurité et isolation](#security-and-isolation) : comment les sessions sont isolées

37* [Limitations](#limitations) : limites de débit et restrictions de plateforme

38 34 

39<h2 id="cloud-environments">35<h2 id="cloud-environments">

40 Environnements cloud36 Environnements cloud

41</h2>37</h2>

42 38 

43Chaque session cloud s'exécute dans un [environnement cloud](/docs/fr/cloud-environments), la configuration enregistrée qui contrôle l'accès réseau, les variables d'environnement et les scripts de configuration. Si vous n'avez pas encore d'environnement, l'intégration configure un environnement **Default** avec [accès réseau **Trusted**](/docs/fr/cloud-environments#access-levels), soit en le créant pour vous, soit en vous demandant de le créer. Consultez [L'environnement Default](/docs/fr/cloud-environments#the-default-environment) pour savoir lequel se produit sur votre plan et comment les sessions choisissent un environnement lorsque vous en avez plus d'un.39Chaque session cloud s'exécute dans un [environnement cloud](/docs/fr/cloud-environments), la configuration enregistrée qui contrôle l'accès réseau, les variables d'environnement et les scripts de configuration.

44 40 

45Les mêmes environnements s'appliquent partout où vous démarrez une session cloud : le web, le terminal, [Claude Tag](https://claude.com/docs/claude-tag/overview), [routines](/docs/fr/routines) et les applications mobile et Desktop. Les sessions de canal Claude Tag utilisent uniquement les environnements au niveau de l'organisation, soit les [environnements partagés](/docs/fr/cloud-environments#organization-shared-environments), soit les [environnements auto-hébergés](/docs/fr/self-hosted-environments).41* **Votre premier environnement** : si vous n'en avez pas encore, l'intégration configure un environnement **Default** avec [accès réseau **Trusted**](/docs/fr/cloud-environments#access-levels), soit en le créant pour vous, soit en vous demandant de le créer. Consultez [L'environnement Default](/docs/fr/cloud-environments#the-default-environment) pour savoir lequel se produit sur votre plan

46 42* **Quel environnement une session utilise** : consultez [L'environnement Default](/docs/fr/cloud-environments#the-default-environment) pour savoir comment les sessions choisissent un environnement lorsque vous en avez plus d'un

47Consultez [Configurer les environnements cloud](/docs/fr/cloud-environments) pour modifier ce qu'un environnement permet, définir des variables ou ajouter un script de configuration, et [Outils installés](/docs/fr/cloud-environments#installed-tools) pour ce que les sessions incluent sans aucune configuration.43* **Modifier ce que les sessions peuvent atteindre ou exécuter au démarrage** : consultez [Configurer les environnements cloud](/docs/fr/cloud-environments)

44* **Ce qui est installé sans aucune configuration** : consultez [Outils installés](/docs/fr/cloud-environments#installed-tools)

48 45 

49<h2 id="github-authentication-options">46<h2 id="github-authentication-options">

50 Options d'authentification GitHub47 Options d'authentification GitHub


57| **Application GitHub** | Autorisez l'application Claude GitHub lors de [l'intégration web](/docs/fr/web-quickstart) | N'importe quel référentiel public, et les référentiels privés sur lesquels l'application Claude GitHub est installée | Intégration web ; équipes qui veulent [Auto-fix](#auto-fix-pull-requests) |54| **Application GitHub** | Autorisez l'application Claude GitHub lors de [l'intégration web](/docs/fr/web-quickstart) | N'importe quel référentiel public, et les référentiels privés sur lesquels l'application Claude GitHub est installée | Intégration web ; équipes qui veulent [Auto-fix](#auto-fix-pull-requests) |

58| **`/web-setup`** | Exécutez `/web-setup` dans votre terminal pour envoyer votre jeton CLI `gh` local à votre compte Claude | N'importe quel référentiel auquel votre jeton `gh` peut accéder, que l'application soit installée ou non | Développeurs individuels qui utilisent déjà `gh` |55| **`/web-setup`** | Exécutez `/web-setup` dans votre terminal pour envoyer votre jeton CLI `gh` local à votre compte Claude | N'importe quel référentiel auquel votre jeton `gh` peut accéder, que l'application soit installée ou non | Développeurs individuels qui utilisent déjà `gh` |

59 56 

60L'installation de l'application Claude GitHub sur un référentiel active également [Auto-fix](#auto-fix-pull-requests) pour les demandes de tirage qu'il contient.57Ces fonctionnalités nécessitent que l'application Claude GitHub soit installée sur le dépôt :

61 58 

62Les threads dans un [projet](/docs/fr/claude-projects) ont besoin que l'application Claude GitHub soit installée sur chaque référentiel qu'ils clonent, quelle que soit la méthode de connexion utilisée. Consultez [Configurer l'accès GitHub](/docs/fr/claude-projects#set-up-github-access).59* **Auto-fix** : l'installation de l'application Claude GitHub sur un dépôt active également [Auto-fix](#auto-fix-pull-requests) pour les pull requests qu'il contient

60* **Projets** : les threads dans un [projet](/docs/fr/claude-projects) ont besoin que l'application Claude GitHub soit installée sur chaque dépôt qu'ils clonent, quelle que soit la méthode de connexion utilisée. Consultez [Configurer l'accès GitHub](/docs/fr/claude-projects#set-up-github-access)

63 61 

64Dans les environnements hébergés par Anthropic, vos identifiants GitHub restent chiffrés sur les serveurs d'Anthropic et n'entrent jamais dans la VM d'une session. Les opérations GitHub depuis la VM passent par le [proxy GitHub](/docs/fr/cloud-environments#github-proxy), qui attache l'identifiant côté serveur.62Dans les environnements hébergés par Anthropic, vos identifiants GitHub restent chiffrés sur les serveurs d'Anthropic et n'entrent jamais dans la VM d'une session. Les opérations GitHub depuis la VM passent par le [proxy GitHub](/docs/fr/cloud-environments#github-proxy), qui attache l'identifiant côté serveur.

65 63 

66Pour savoir comment `/schedule` vérifie l'accès au référentiel avant de créer une routine, consultez [Référentiels et permissions de branche](/docs/fr/routines#repositories-and-branch-permissions). Consultez [Connecter depuis votre terminal](/docs/fr/web-quickstart#connect-from-your-terminal) pour la procédure pas à pas de `/web-setup`, y compris ce que `/web-setup` stocke et comment le supprimer.64Consultez [Connecter depuis votre terminal](/docs/fr/web-quickstart#connect-from-your-terminal) pour la procédure pas à pas de `/web-setup`, y compris ce que `/web-setup` stocke et comment le supprimer.

67 

68La configuration web rapide est un paramètre d'organisation qui permet aux membres de connecter GitHub avec `/web-setup`, ignore l'invite d'installation de l'application Claude GitHub lors de l'intégration web, et fait que l'intégration web crée l'[environnement **Default**](/docs/fr/cloud-environments#the-default-environment) pour eux au lieu d'afficher le formulaire d'environnement. Sur les plans Team et Enterprise, elle est désactivée par défaut, ce qui masque `/web-setup`. Un [Propriétaire](/docs/fr/server-managed-settings#access-control) l'active avec le bouton bascule **Quick web setup** à [**Paramètres d'administration > Claude Code**](https://claude.ai/admin-settings/claude-code).

69 65 

70<Note>66<Note>

71 Les organisations avec [Zéro rétention de données](/docs/fr/zero-data-retention) activée ne peuvent pas utiliser `/web-setup` ou d'autres fonctionnalités de session cloud.67 Les organisations avec [Zéro rétention de données](/docs/fr/zero-data-retention) activée ne peuvent pas utiliser `/web-setup` ou d'autres fonctionnalités de session cloud.

72</Note>68</Note>

73 69 

70<h3 id="quick-setup-for-team-and-enterprise">

71 Configuration rapide pour Team et Enterprise

72</h3>

73 

74La configuration rapide est un paramètre d'organisation qui supprime des étapes de la configuration GitHub et de l'environnement des membres. Sur les plans Team et Enterprise, elle est désactivée par défaut.

75 

76Voici ce qui change pour les membres lorsqu'elle est activée :

77 

78* **`/web-setup`** : les membres peuvent connecter GitHub avec `/web-setup`. Tant que le paramètre est désactivé, la commande est masquée

79* **Invite de l'application GitHub** : l'intégration dans le navigateur ignore l'invite d'installation de l'application Claude GitHub

80* **Premier environnement** : l'intégration dans le navigateur crée l'[environnement **Default**](/docs/fr/cloud-environments#the-default-environment) pour les membres au lieu d'afficher le formulaire d'environnement

81 

82Un [Propriétaire](/docs/fr/server-managed-settings#access-control) l'active avec le bouton bascule **Quick setup** dans [**Paramètres de l'organisation > Claude Code**](https://claude.ai/admin-settings/claude-code).

83 

74<h2 id="move-tasks-between-terminal-and-cloud">84<h2 id="move-tasks-between-terminal-and-cloud">

75 Déplacer les tâches entre le terminal et le cloud85 Déplacer les tâches entre le terminal et le cloud

76</h2>86</h2>


78Ces workflows nécessitent que le [Claude Code CLI](/docs/fr/quickstart) soit connecté au même compte claude.ai. Vous pouvez démarrer de nouvelles sessions cloud depuis votre terminal, ou extraire des sessions cloud dans votre terminal pour continuer localement. Les sessions cloud persistent même si vous fermez votre ordinateur portable, et vous pouvez les surveiller de n'importe où, y compris depuis l'application mobile Claude.88Ces workflows nécessitent que le [Claude Code CLI](/docs/fr/quickstart) soit connecté au même compte claude.ai. Vous pouvez démarrer de nouvelles sessions cloud depuis votre terminal, ou extraire des sessions cloud dans votre terminal pour continuer localement. Les sessions cloud persistent même si vous fermez votre ordinateur portable, et vous pouvez les surveiller de n'importe où, y compris depuis l'application mobile Claude.

79 89 

80<Note>90<Note>

81 Depuis le CLI, le transfert de session est unidirectionnel : vous pouvez extraire des sessions cloud dans votre terminal avec `--teleport`, mais vous ne pouvez pas envoyer une session terminal existante vers le cloud. Le flag `--cloud` avec une description de tâche crée une nouvelle session cloud pour votre référentiel actuel ; avec `-p` et un ID de session ou une URL claude.ai/code, il [met plutôt en file d'attente un message dans cette session existante](/docs/fr/claude-code-on-the-web#send-follow-ups-from-the-cli). L'[application de bureau](/docs/fr/desktop#continue-in-another-surface) fournit un menu **Continuer dans** qui peut envoyer une session locale vers le cloud.91 Depuis le CLI, le transfert de session est unidirectionnel : vous pouvez extraire des sessions cloud dans votre terminal avec `--teleport`, mais vous ne pouvez pas envoyer une session terminal existante vers le cloud. Le flag `--cloud` avec une description de tâche crée une nouvelle session cloud pour votre dépôt actuel ; avec `-p` et un ID de session ou une URL claude.ai/code, il [met plutôt en file d'attente un message dans cette session existante](/docs/fr/claude-code-on-the-web#send-follow-ups-from-the-cli). L'[application de bureau](/docs/fr/desktop#continue-in-another-surface) peut envoyer vers le cloud une session locale de son onglet Code depuis son menu **Ouvrir dans**.

82</Note>92</Note>

83 93 

84<h3 id="from-terminal-to-cloud">94<h3 id="from-terminal-to-cloud">


173 Envoyer des messages de suivi depuis le CLI183 Envoyer des messages de suivi depuis le CLI

174</h3>184</h3>

175 185 

176Une fois qu'une session cloud est en cours d'exécution, où qu'elle s'exécute, envoyez-lui un message de suivi depuis le CLI `claude` sur n'importe quelle machine où vous êtes connecté avec `claude auth login`. Le CLI s'authentifie avec vos identifiants de compte Anthropic et n'envoie aucun état de session local, donc la commande n'a pas besoin de s'exécuter depuis la machine qui a démarré la session, et c'est la même dans chaque shell, y compris PowerShell.186Une fois qu'une session cloud est en cours d'exécution, où qu'elle s'exécute, envoyez-lui un message de suivi depuis le CLI `claude` sur n'importe quelle machine où vous êtes connecté avec `claude auth login`. Le CLI s'authentifie avec vos identifiants de compte Anthropic et n'envoie aucun état de session local, donc la commande n'a pas besoin de s'exécuter depuis la machine qui a démarré la session.

177 187 

178La commande publie un message et se termine :188La commande publie un message et se termine :

179 189 


189 `--cloud` nécessite un compte Anthropic. Il n'est pas disponible quand Claude Code est configuré pour Amazon Bedrock, Google Cloud's Agent Platform ou un autre fournisseur tiers. Une [passerelle LLM](/docs/fr/llm-gateway) configurée uniquement via `ANTHROPIC_BASE_URL` ne compte pas comme un fournisseur tiers pour cette vérification, mais vous devez toujours vous connecter avec `claude auth login`. La politique `allow_remote_sessions` de votre organisation doit également être activée. Un propriétaire peut l'activer dans les paramètres d'administration Claude Code sur claude.ai/admin-settings/claude-code.199 `--cloud` nécessite un compte Anthropic. Il n'est pas disponible quand Claude Code est configuré pour Amazon Bedrock, Google Cloud's Agent Platform ou un autre fournisseur tiers. Une [passerelle LLM](/docs/fr/llm-gateway) configurée uniquement via `ANTHROPIC_BASE_URL` ne compte pas comme un fournisseur tiers pour cette vérification, mais vous devez toujours vous connecter avec `claude auth login`. La politique `allow_remote_sessions` de votre organisation doit également être activée. Un propriétaire peut l'activer dans les paramètres d'administration Claude Code sur claude.ai/admin-settings/claude-code.

190</Note>200</Note>

191 201 

192<h4 id="output-and-errors">202<h4 id="output">

193 Sortie et erreurs203 Sortie

194</h4>204</h4>

195 205 

196En cas de succès, la commande imprime l'ID de session et un lien pour afficher la session :206En cas de succès, la commande imprime l'ID de session et un lien pour afficher la session :


203 213 

204Passez `--output-format json` pour un résultat lisible par machine : `{ok, session_id, url}` en cas de succès, ou `{ok: false, session_id, error}` quand l'envoi échoue, par exemple quand la session est manquante ou archivée. Les erreurs de configuration, telles qu'un fournisseur non pris en charge ou une politique organisationnelle désactivée, s'impriment sur stderr sans JSON. `--output-format stream-json` n'est pas pris en charge avec `--cloud <session-id>`.214Passez `--output-format json` pour un résultat lisible par machine : `{ok, session_id, url}` en cas de succès, ou `{ok: false, session_id, error}` quand l'envoi échoue, par exemple quand la session est manquante ou archivée. Les erreurs de configuration, telles qu'un fournisseur non pris en charge ou une politique organisationnelle désactivée, s'impriment sur stderr sans JSON. `--output-format stream-json` n'est pas pris en charge avec `--cloud <session-id>`.

205 215 

206Le CLI préfixe les erreurs avec `Error: `. Un échec de livraison est enveloppé comme `failed to send message to cloud session <id>: <reason>`.216Si l'envoi échoue, consultez [Erreurs lors de l'envoi vers une session cloud](#errors-when-sending-to-a-cloud-session).

207 

208| Message | Ce que cela signifie |

209| - | - |

210| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code est configuré pour un fournisseur tiers. Le message nomme le fournisseur avec l'étiquette que votre configuration utilise, telle que `Amazon Bedrock` ou `Google Vertex AI`. Supprimez la configuration de ce fournisseur, par exemple en désactivant `CLAUDE_CODE_USE_BEDROCK`, et connectez-vous avec un compte Anthropic (`claude auth login`). |

211| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | La politique organisationnelle `allow_remote_sessions` est désactivée. |

212| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code n'a pas pu récupérer la politique de votre organisation, il refuse donc l'envoi plutôt que d'assumer que les sessions cloud sont autorisées. Vérifiez votre connexion réseau et réessayez. |

213| `Attaching to an existing cloud session is not enabled for your account.` | Vous avez exécuté `--cloud <session-id>` sans `-p`. Envoyez le message avec `claude -p "your message" --cloud <session-id>`. |

214| `Session not found: <id>` | L'ID ou l'URL ne correspond pas à une session à laquelle vous pouvez accéder. Vérifiez-le par rapport à l'URL claude.ai/code de la session. |

215| `cloud session <id> is archived and cannot accept new messages` | La session a été archivée. Démarrez une nouvelle session à la place. |

216 217 

217<h3 id="from-cloud-to-terminal">218<h3 id="from-cloud-to-terminal">

218 Du cloud vers le terminal219 Du cloud vers le terminal


239| Exigence | Détails |240| Exigence | Détails |

240| - | - |241| - | - |

241| État git propre | Votre répertoire de travail ne doit avoir aucune modification non validée. Teleport vous invite à ranger les modifications si nécessaire. |242| État git propre | Votre répertoire de travail ne doit avoir aucune modification non validée. Teleport vous invite à ranger les modifications si nécessaire. |

242| Référentiel correct | Vous devez exécuter `--teleport` à partir d'un checkout du même référentiel, pas d'une fork. Si vous l'exécutez à partir d'un checkout d'un référentiel différent, Claude Code affiche une erreur qui nomme à la fois le référentiel de la session et le référentiel de votre checkout. Avant la v2.1.219, l'erreur ne nommait pas le référentiel de votre checkout. Si Claude Code ne peut pas analyser votre remote en un nom d'hôte, par exemple un alias d'hôte SSH comme `git@work:owner/repo.git`, il vous demande de confirmer et accepte le checkout quand le propriétaire du remote et le nom du référentiel correspondent au référentiel de la session. |243| Dépôt correct | Vous devez exécuter `--teleport` à partir d'un checkout du même dépôt, pas d'un fork. Si vous l'exécutez à partir d'un checkout d'un dépôt différent, Claude Code affiche une erreur qui nomme à la fois le dépôt de la session et celui de votre checkout. Si Claude Code ne peut pas analyser votre remote en un nom d'hôte, par exemple un alias d'hôte SSH comme `git@work:owner/repo.git`, il vous demande de confirmer et accepte le checkout quand le propriétaire du remote et le nom du dépôt correspondent au dépôt de la session. |

243| Branche disponible | La branche de la session cloud doit avoir été poussée vers le remote. Teleport la récupère et la vérifie automatiquement. |244| Branche disponible | La branche de la session cloud doit avoir été poussée vers le remote. Teleport la récupère et la vérifie automatiquement. |

244| Même compte | Vous devez être authentifié au même compte claude.ai utilisé dans la session cloud. |245| Même compte | Vous devez être authentifié au même compte claude.ai utilisé dans la session cloud. |

245 246 


249 `--teleport` n'est pas disponible250 `--teleport` n'est pas disponible

250</h4>251</h4>

251 252 

252Teleport nécessite l'authentification par abonnement claude.ai. Si vous êtes authentifié via clé API, exécutez `/login` pour vous connecter avec votre compte claude.ai à la place. Si l'erreur nomme votre fournisseur à la place, les sessions cloud ne sont pas disponibles via les fournisseurs tiers ; voir le [tableau d'erreurs](#output-and-errors). Si vous êtes déjà connecté via claude.ai et que `--teleport` n'est toujours pas disponible, votre organisation a peut-être désactivé les sessions cloud.253Teleport nécessite l'authentification par abonnement claude.ai. Trouvez le cas qui correspond au vôtre :

254 

255* **Vous êtes authentifié via clé API** : exécutez `/login` pour vous connecter avec votre compte claude.ai à la place

256* **L'erreur nomme votre fournisseur** : les sessions cloud ne sont pas disponibles via les fournisseurs tiers. Voir le [tableau d'erreurs](#errors-when-sending-to-a-cloud-session)

257* **Vous êtes déjà connecté via claude.ai** : votre organisation a peut-être désactivé les sessions cloud

253 258 

254<h2 id="work-with-sessions">259<h2 id="work-with-sessions">

255 Travailler avec les sessions260 Travailler avec les sessions


257 262 

258Les sessions apparaissent dans la barre latérale sur claude.ai/code. De là, vous pouvez examiner les modifications, partager avec vos coéquipiers, archiver le travail terminé ou supprimer définitivement les sessions.263Les sessions apparaissent dans la barre latérale sur claude.ai/code. De là, vous pouvez examiner les modifications, partager avec vos coéquipiers, archiver le travail terminé ou supprimer définitivement les sessions.

259 264 

260<h3 id="take-back-a-queued-message">265<h3 id="permission-modes-in-cloud-sessions">

261 Annuler un message en attente266 Modes de permission dans les sessions cloud

262</h3>267</h3>

263 268 

264Si vous envoyez un message alors que Claude travaille, le message est mis en attente jusqu'à ce que Claude le lise. Pour annuler un message en attente, cliquez sur le ✕ qui s'y trouve. Le texte revient à la boîte de message pour que vous puissiez le modifier ou envoyer quelque chose d'autre.269Vous choisissez le [mode de permission](/docs/fr/permission-modes) d'une session cloud à partir du [menu déroulant de mode](/docs/fr/permission-modes#switch-permission-modes), à la fois lorsque vous créez la tâche et pendant que la session s'exécute.

265 270 

266Si Claude a déjà lu le message, il reste dans la conversation.271Claude Code reprend une session dans le mode de permission dans lequel elle se trouvait lorsque vous effectuez l'une des actions suivantes :

272 

273* Rouvrir une session dont l'[environnement hébergé par Anthropic a expiré](#environment-expired)

274* Envoyer un message à une session qu'un exécuteur auto-hébergé a [libérée pendant qu'elle était inactive](/docs/fr/self-hosted-environments-reference#runner-cli-flags)

275 

276<h3 id="review-changes">

277 Examiner les modifications

278</h3>

279 

280Chaque session affiche un indicateur de diff avec les lignes ajoutées et supprimées, comme `+42 -18`. Sélectionnez-le pour ouvrir la vue diff, laisser des commentaires en ligne sur des lignes spécifiques et les envoyer à Claude avec votre prochain message.

281 

282La vue diff compare les modifications de la session par rapport à sa branche de base par défaut. Pour comparer avec n'importe quelle autre branche du dépôt, sélectionnez **Comparer avec** et choisissez-en une.

283 

284Claude Code calcule ces diffs à partir du contenu brut des blobs git, de sorte que les pilotes diff et les filtres `textconv` configurés dans le dépôt ne s'appliquent pas.

285 

286Ces étapes sont traitées ailleurs :

287 

288* **La procédure complète, incluant la création de PR** : consultez [Examiner et itérer](/docs/fr/web-quickstart#review-and-iterate)

289* **Faire en sorte que Claude surveille automatiquement la PR pour les défaillances CI et les commentaires d'examen** : consultez [Correction automatique des pull requests](#auto-fix-pull-requests)

267 290 

268<h3 id="manage-context">291<h3 id="manage-context">

269 Gérer le contexte292 Gérer le contexte


291 314 

292Les [équipes d'agents](/docs/fr/agent-teams) sont désactivées par défaut mais peuvent être activées en ajoutant `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` à vos [variables d'environnement](/docs/fr/cloud-environments#set-environment-variables).315Les [équipes d'agents](/docs/fr/agent-teams) sont désactivées par défaut mais peuvent être activées en ajoutant `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` à vos [variables d'environnement](/docs/fr/cloud-environments#set-environment-variables).

293 316 

294<h3 id="permission-modes-in-cloud-sessions">317<h3 id="take-back-a-queued-message">

295 Modes de permission dans les sessions cloud318 Annuler un message en attente

296</h3>

297 

298Vous choisissez le [mode de permission](/docs/fr/permission-modes) d'une session cloud à partir du [menu déroulant de mode](/docs/fr/permission-modes#switch-permission-modes), à la fois lorsque vous créez la tâche et pendant que la session s'exécute. Lorsque vous rouvrez une session dont l'[environnement hébergé par Anthropic a expiré](#environment-expired), ou que vous envoyez un message à une session qu'un exécuteur auto-hébergé a [libérée pendant qu'elle était inactive](/docs/fr/self-hosted-environments-reference#runner-cli-flags), Claude Code reprend la session dans le mode de permission dans lequel elle se trouvait.

299 

300<h3 id="review-changes">

301 Examiner les modifications

302</h3>319</h3>

303 320 

304Chaque session affiche un indicateur de diff avec les lignes ajoutées et supprimées, comme `+42 -18`. Sélectionnez-le pour ouvrir la vue diff, laisser des commentaires en ligne sur des lignes spécifiques et les envoyer à Claude avec votre prochain message.321Si vous envoyez un message alors que Claude travaille, le message est mis en attente jusqu'à ce que Claude le lise. Pour annuler un message en attente, cliquez sur le ✕ qui s'y trouve. Le texte revient à la boîte de message pour que vous puissiez le modifier ou envoyer quelque chose d'autre.

305 

306La vue diff compare les modifications de la session par rapport à sa branche de base par défaut. Pour comparer avec n'importe quelle autre branche du référentiel, sélectionnez **Comparer avec** et choisissez-en une.

307 

308Claude Code calcule ces diffs, y compris les diffs par fichier affichés lors des modifications de Claude, à partir du contenu brut des blobs git, de sorte que les pilotes diff et les filtres `textconv` configurés dans le référentiel ne s'appliquent pas. Pour un fichier dans un référentiel qui n'est pas l'un des checkouts de la session, comme un cloné à l'intérieur de l'espace de travail pendant la session, le diff par fichier affiche la modification de Claude elle-même plutôt qu'une comparaison git.

309 322 

310Consultez [Examiner et itérer](/docs/fr/web-quickstart#review-and-iterate) pour la procédure complète incluant la création de PR. Pour que Claude surveille automatiquement la PR pour les défaillances CI et les commentaires d'examen, consultez [Correction automatique des demandes de tirage](#auto-fix-pull-requests).323Si Claude a déjà lu le message, il reste dans la conversation.

311 324 

312<h3 id="share-sessions">325<h3 id="share-sessions">

313 Partager les sessions326 Partager les sessions


319 Partager à partir d'un compte Enterprise ou Team332 Partager à partir d'un compte Enterprise ou Team

320</h4>333</h4>

321 334 

322Pour les comptes Enterprise et Team, les deux options de visibilité sont **Privé** et **Équipe**. La visibilité Équipe rend la session visible aux autres membres de votre organisation claude.ai. Les sessions [Claude dans Slack](/docs/fr/slack) sont automatiquement partagées avec la visibilité Équipe.335Le partage fonctionne comme suit pour les comptes Enterprise et Team :

323 336 

324La vérification de l'accès au référentiel est activée par défaut, en fonction du compte GitHub connecté au compte du destinataire. Le nom d'affichage de votre compte est visible à tous les destinataires ayant accès.337* **Options de visibilité** : **Privé** et **Équipe**. La visibilité Équipe rend la session visible aux autres membres de votre organisation claude.ai

338* **Accès au dépôt** : la vérification est activée par défaut, en fonction du compte GitHub connecté au compte du destinataire

339* **Votre nom** : le nom d'affichage de votre compte est visible à tous les destinataires ayant accès

340* **Sessions Slack** : les sessions [Claude dans Slack](/docs/fr/slack) sont automatiquement partagées avec la visibilité Équipe

325 341 

326<h4 id="share-from-a-max-or-pro-account">342<h4 id="share-from-a-max-or-pro-account">

327 Partager à partir d'un compte Max ou Pro343 Partager à partir d'un compte Max ou Pro

328</h4>344</h4>

329 345 

330Pour les comptes Max et Pro, les deux options de visibilité sont **Privé** et **Public**. La visibilité Public rend la session visible à tout utilisateur connecté à claude.ai.346Le partage fonctionne comme suit pour les comptes Max et Pro :

331 347 

332Vérifiez votre session pour le contenu sensible avant de partager. Les sessions peuvent contenir du code et des identifiants provenant de référentiels GitHub privés. La vérification de l'accès au référentiel n'est pas activée par défaut.348* **Options de visibilité** : **Privé** et **Public**. La visibilité Public rend la session visible à tout utilisateur connecté à claude.ai

349* **Accès au dépôt** : la vérification n'est pas activée par défaut

350* **Contenu sensible** : vérifiez votre session avant de partager. Les sessions peuvent contenir du code et des identifiants provenant de dépôts GitHub privés

333 351 

334Pour exiger que les destinataires aient accès au référentiel, ou pour masquer votre nom des sessions partagées, accédez à [**Paramètres > Claude Code > Paramètres de partage**](https://claude.ai/settings/claude-code).352Pour exiger que les destinataires aient accès au référentiel, ou pour masquer votre nom des sessions partagées, accédez à [**Paramètres > Claude Code > Paramètres de partage**](https://claude.ai/settings/claude-code).

335 353 


421 Impossible d'obtenir l'UUID de l'organisation439 Impossible d'obtenir l'UUID de l'organisation

422</h3>440</h3>

423 441 

424`claude --cloud` et `claude --teleport` nécessitent une connexion avec un compte claude.ai. Si vous vous authentifiez avec une clé API, ou si vos détails de compte stockés sont obsolètes, ces commandes échouent avec `Unable to get organization UUID` ou un message indiquant que l'authentification par clé API n'est pas suffisante. Avec l'authentification par clé API ou les détails de compte obsolètes, l'exécution de `claude --teleport` sans ID de session affiche `Error loading Claude Code sessions` dans le sélecteur de session au lieu de l'un ou l'autre message, et le même correctif s'applique.442`claude --cloud` et `claude --teleport` nécessitent une connexion avec un compte claude.ai. Si vous vous authentifiez avec une clé API, ou si vos détails de compte stockés sont obsolètes, vous voyez l'un des messages suivants :

443 

444* `Unable to get organization UUID`

445* Un message indiquant que l'authentification par clé API n'est pas suffisante

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

425 447 

426Exécutez `/login` pour vous connecter avec votre compte claude.ai, puis réessayez la commande. Si le message nomme votre fournisseur à la place, consultez le [tableau d'erreurs](#output-and-errors) : les sessions cloud ne sont pas disponibles via les fournisseurs tiers.448Exécutez `/login` pour vous connecter avec votre compte claude.ai, puis réessayez la commande. Si l'erreur nomme votre fournisseur à la place, consultez le [tableau d'erreurs](#errors-when-sending-to-a-cloud-session) : les sessions cloud ne sont pas disponibles via les fournisseurs tiers.

427 449 

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

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


435* Confirmez que vous êtes connecté au même compte qui possède la session457* Confirmez que vous êtes connecté au même compte qui possède la session

436* Si vous voyez `Remote Control may not be available for this organization`, un Propriétaire n'a pas activé les sessions cloud pour votre organisation458* Si vous voyez `Remote Control may not be available for this organization`, un Propriétaire n'a pas activé les sessions cloud pour votre organisation

437 459 

460<h3 id="errors-when-sending-to-a-cloud-session">

461 Erreurs lors de l'envoi vers une session cloud

462</h3>

463 

464Ces erreurs proviennent de l'exécution de `claude` avec [`--cloud <session-id>`](#send-follow-ups-from-the-cli), avec ou sans `-p`. Le CLI préfixe les erreurs avec `Error: `. Un échec de livraison est encapsulé sous la forme `failed to send message to cloud session <id>: <reason>`.

465 

466| Message | Signification |

467| - | - |

468| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code est configuré pour un fournisseur tiers. Le message nomme le fournisseur avec le libellé utilisé par votre configuration, comme `Amazon Bedrock` ou `Google Vertex AI`. Supprimez la configuration de ce fournisseur, par exemple en désactivant `CLAUDE_CODE_USE_BEDROCK`, et connectez-vous avec un compte Anthropic (`claude auth login`). |

469| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | La politique d'organisation `allow_remote_sessions` est désactivée. |

470| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code n'a pas pu récupérer la politique de votre organisation ; il refuse donc l'envoi plutôt que de supposer que les sessions cloud sont autorisées. Vérifiez votre connexion réseau et réessayez. |

471| `Attaching to an existing cloud session is not enabled for your account.` | Vous avez exécuté `--cloud <session-id>` sans `-p`. Envoyez le message avec `claude -p "your message" --cloud <session-id>`. |

472| `Session not found: <id>` | L'ID ou l'URL ne correspond à aucune session à laquelle vous avez accès. Vérifiez-le par rapport à l'URL claude.ai/code de la session. |

473| `cloud session <id> is archived and cannot accept new messages` | La session a été archivée. Démarrez plutôt une nouvelle session. |

474 

438<h3 id="environment-expired">475<h3 id="environment-expired">

439 Environnement expiré476 Environnement expiré

440</h3>477</h3>

441 478 

442Les sessions cloud s'arrêtent après une période d'inactivité et la VM de la session est réclamée. Une session est considérée comme inactive pendant qu'elle attend votre approbation d'un appel d'outil [connecteur MCP](/docs/fr/cloud-environments#network-access) ou votre connexion à un serveur MCP, et elle peut expirer pendant cette attente.479Les sessions cloud s'arrêtent après une période d'inactivité et la VM de la session est réclamée. Une session est considérée comme inactive pendant qu'elle attend votre approbation d'un appel d'outil [connecteur MCP](/docs/fr/cloud-environments#network-access) ou votre connexion à un serveur MCP, et elle peut expirer pendant cette attente.

443 480 

444Rouvrez la session à partir de [claude.ai/code](https://claude.ai/code) pour mettre en service une VM fraîche avec votre historique de conversation restauré. Le travail en arrière-plan qui était toujours en cours d'exécution lorsque la VM a été réclamée, comme les sous-agents et les commandes shell, n'est pas restauré.481Rouvrez la session à partir de [claude.ai/code](https://claude.ai/code) pour mettre en service une VM fraîche :

482 

483* **Restauré** : votre historique de conversation

484* **Non restauré** : le travail en arrière-plan qui était toujours en cours d'exécution lorsque la VM a été réclamée, comme les sous-agents et les commandes shell

445 485 

446<h2 id="limitations">486<h2 id="limitations">

447 Limitations487 Limitations

Details

497 oneLiner: 'Custom keyboard shortcuts',497 oneLiner: 'Custom keyboard shortcuts',

498 when: 'Read at session start and hot-reloaded when you edit the file',498 when: 'Read at session start and hot-reloaded when you edit the file',

499 description: <>Rebind keyboard shortcuts in the interactive CLI. Run <C>/keybindings</C> to create or open this file with a schema reference. Ctrl+C, Ctrl+D, Ctrl+M, and Caps Lock are reserved and cannot be rebound.</>,499 description: <>Rebind keyboard shortcuts in the interactive CLI. Run <C>/keybindings</C> to create or open this file with a schema reference. Ctrl+C, Ctrl+D, Ctrl+M, and Caps Lock are reserved and cannot be rebound.</>,

500 exampleIntro: <>This example binds <C>Ctrl+E</C> to open your external editor and unbinds <C>Ctrl+U</C> by setting it to <C>null</C>. The <C>context</C> field scopes bindings to a specific part of the CLI, here the main chat input.</>,500 exampleIntro: <>This example binds <C>Ctrl+E</C> to open your external editor and unbinds <C>Ctrl+S</C> by setting it to <C>null</C>. The <C>context</C> field scopes bindings to a specific part of the CLI, here the main chat input.</>,

501 example: `{501 example: `{

502 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",502 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",

503 "$docs": "https://code.claude.com/docs/en/keybindings",503 "$docs": "https://code.claude.com/docs/en/keybindings",


506 "context": "Chat",506 "context": "Chat",

507 "bindings": {507 "bindings": {

508 "ctrl+e": "chat:externalEditor",508 "ctrl+e": "chat:externalEditor",

509 "ctrl+u": null509 "ctrl+s": null

510 }510 }

511 }511 }

512 ]512 ]


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

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

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

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

1459 1459 

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

1461 1461 

Details

26 26 

27* **Flux CLI tels que `/web-setup`** : créent **Default** pour vous27* **Flux CLI tels que `/web-setup`** : créent **Default** pour vous

28* **Intégration web sur Pro et Max** : crée **Default** pour vous28* **Intégration web sur Pro et Max** : crée **Default** pour vous

29* **Intégration web sur Team et Enterprise** : affiche un formulaire **Créer votre premier environnement cloud** sauf si un propriétaire a activé la [Configuration web rapide](/docs/fr/claude-code-on-the-web#github-authentication-options) ; conservez les valeurs par défaut du formulaire et cliquez sur **Créer et terminer** pour obtenir le même environnement **Default**29* **Intégration web sur Team et Enterprise** : affiche un formulaire **Créer votre premier environnement cloud** sauf si un propriétaire a activé la [Configuration rapide](/docs/fr/claude-code-on-the-web#quick-setup-for-team-and-enterprise) ; conservez les valeurs par défaut du formulaire et cliquez sur **Créer et terminer** pour obtenir le même environnement **Default**

30 30 

31**Default** n'a aucune configuration propre :31**Default** n'a aucune configuration propre :

32 32 

costs.md +2 −2

Details

111| Votre rôle | Ce que `/usage-credits` fait |111| Votre rôle | Ce que `/usage-credits` fait |

112| :- | :- |112| :- | :- |

113| Abonné Pro ou Max | Ouvre [**Settings > Usage**](https://claude.ai/settings/usage) sur claude.ai dans le navigateur. Dans sa section **Usage credits** vous pouvez activer ou désactiver les crédits d'utilisation et vérifier votre solde de crédit, les dépenses de ce mois et votre limite de dépenses mensuelles |113| Abonné Pro ou Max | Ouvre [**Settings > Usage**](https://claude.ai/settings/usage) sur claude.ai dans le navigateur. Dans sa section **Usage credits** vous pouvez activer ou désactiver les crédits d'utilisation et vérifier votre solde de crédit, les dépenses de ce mois et votre limite de dépenses mensuelles |

114| Membre Team ou Enterprise avec accès à la facturation | Ouvre les paramètres d'utilisation de votre organisation, [**Admin settings > Usage**](https://claude.ai/admin-settings/usage), dans le navigateur |114| Membre Team ou Enterprise avec accès à la facturation | Ouvre les paramètres d'utilisation de votre organisation, [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), dans le navigateur |

115| Membre Team ou Enterprise sans accès à la facturation | Vous demande de confirmer, puis envoie une demande aux administrateurs de votre organisation. Avant la v2.1.211, Claude Code envoyait la demande sans étape de confirmation |115| Membre Team ou Enterprise sans accès à la facturation | Vous demande de confirmer, puis envoie une demande aux administrateurs de votre organisation. Avant la v2.1.211, Claude Code envoyait la demande sans étape de confirmation |

116 116 

117Pour les membres Team et Enterprise sans accès à la facturation, la confirmation n'apparaît que dans les sessions interactives : en mode non interactif avec le drapeau `-p` et depuis [Remote Control](/docs/fr/remote-control), la commande n'envoie aucune demande et vous dit de l'exécuter dans une session interactive à la place.117Pour les membres Team et Enterprise sans accès à la facturation, la confirmation n'apparaît que dans les sessions interactives : en mode non interactif avec le drapeau `-p` et depuis [Remote Control](/docs/fr/remote-control), la commande n'envoie aucune demande et vous dit de l'exécuter dans une session interactive à la place.


229* **« Vous avez atteint votre limite de session » ou « Vous avez atteint votre limite hebdomadaire »** : une fenêtre d'utilisation basée sur le siège sur un plan d'abonnement, partagée sur tous les modèles, donc le développeur ne peut pas restaurer l'accès en changeant de modèles avec `/model`. Le message affiche quand la fenêtre se réinitialise. Après le message spécifique au modèle « Vous avez atteint votre limite Opus » ou « Vous avez atteint votre limite Sonnet », passer à un modèle en dehors de cette famille avec `/model` permet au développeur de continuer à travailler. Voir [erreurs de limite d'utilisation](/docs/fr/errors#youve-hit-your-session-limit). Ce que le développeur peut faire en attendant :229* **« Vous avez atteint votre limite de session » ou « Vous avez atteint votre limite hebdomadaire »** : une fenêtre d'utilisation basée sur le siège sur un plan d'abonnement, partagée sur tous les modèles, donc le développeur ne peut pas restaurer l'accès en changeant de modèles avec `/model`. Le message affiche quand la fenêtre se réinitialise. Après le message spécifique au modèle « Vous avez atteint votre limite Opus » ou « Vous avez atteint votre limite Sonnet », passer à un modèle en dehors de cette famille avec `/model` permet au développeur de continuer à travailler. Voir [erreurs de limite d'utilisation](/docs/fr/errors#youve-hit-your-session-limit). Ce que le développeur peut faire en attendant :

230 * Exécutez `/usage-credits` pour demander une utilisation au-delà de l'allocation, si vous avez activé les [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans).230 * Exécutez `/usage-credits` pour demander une utilisation au-delà de l'allocation, si vous avez activé les [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans).

231 * Sur Claude Code v2.1.234 ou ultérieur, [attendez et continuez la tâche interrompue automatiquement après la réinitialisation](/docs/fr/interactive-mode#wait-for-a-usage-limit-to-reset) ; cette section énumère quand Claude Code démarre l'attente de lui-même et quand le développeur la choisit dans `/rate-limit-options`. Pour contrôler pour votre flotte si Claude Code démarre cette attente de lui-même, définissez [`autoContinueAtUsageLimit`](/docs/fr/settings-reference#autocontinueatusagelimit) dans les [paramètres gérés](/docs/fr/settings#settings-precedence).231 * Sur Claude Code v2.1.234 ou ultérieur, [attendez et continuez la tâche interrompue automatiquement après la réinitialisation](/docs/fr/interactive-mode#wait-for-a-usage-limit-to-reset) ; cette section énumère quand Claude Code démarre l'attente de lui-même et quand le développeur la choisit dans `/rate-limit-options`. Pour contrôler pour votre flotte si Claude Code démarre cette attente de lui-même, définissez [`autoContinueAtUsageLimit`](/docs/fr/settings-reference#autocontinueatusagelimit) dans les [paramètres gérés](/docs/fr/settings#settings-precedence).

232* **« Vous avez atteint votre limite de dépenses individuelle », « limite de dépenses mensuelle de l'organisation » ou « budget partagé de l'équipe »** : la demande du développeur serait facturée aux crédits d'utilisation, et ces crédits ont atteint une limite de dépenses que vous avez définie. Pour permettre au développeur de continuer, allez à [**Paramètres d'administration > Utilisation**](https://claude.ai/admin-settings/usage) et augmentez la limite que le message nomme. Lorsque le message nomme également une heure de réinitialisation du plan, le développeur peut plutôt attendre jusqu'à ce moment. Voir [la référence d'erreur](/docs/fr/errors#youve-hit-your-monthly-spend-limit) pour chaque variante.232* **« Vous avez atteint votre limite de dépenses individuelle », « limite de dépenses mensuelle de l'organisation » ou « budget partagé de l'équipe »** : la requête du développeur serait facturée aux crédits d'utilisation, et ces crédits ont atteint une limite de dépenses que vous avez définie. Pour permettre au développeur de continuer, allez à [**Paramètres de l'organisation > Utilisation**](https://claude.ai/admin-settings/usage) et augmentez la limite que le message nomme. Lorsque le message nomme également une heure de réinitialisation du plan, le développeur peut plutôt attendre jusqu'à ce moment. Voir [la référence d'erreur](/docs/fr/errors#youve-hit-your-monthly-spend-limit) pour chaque variante.

233* **Un message de limite de dépenses d'une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway)** : le développeur a dépassé un plafond de dépenses que vous avez défini sur votre passerelle auto-hébergée, et la passerelle bloque ses demandes jusqu'à ce que la période se réinitialise ou que vous augmentiez le plafond. Voir [limites de dépenses de la passerelle](/docs/fr/claude-apps-gateway-spend-limits) pour les plafonds, les calendriers de réinitialisation et le message que le développeur voit.233* **Un message de limite de dépenses d'une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway)** : le développeur a dépassé un plafond de dépenses que vous avez défini sur votre passerelle auto-hébergée, et la passerelle bloque ses demandes jusqu'à ce que la période se réinitialise ou que vous augmentiez le plafond. Voir [limites de dépenses de la passerelle](/docs/fr/claude-apps-gateway-spend-limits) pour les plafonds, les calendriers de réinitialisation et le message que le développeur voit.

234* **Un avertissement de contexte ou d'auto-compactage** : pas une limite d'utilisation. La conversation s'est rapprochée de la [fenêtre d'auto-compactage](/docs/fr/model-config#set-the-auto-compact-window) de la session, le seuil où Claude Code résume l'historique plus ancien pour libérer de l'espace. Pointez le développeur vers [réduire l'utilisation des tokens](#reduce-token-usage).234* **Un avertissement de contexte ou d'auto-compactage** : pas une limite d'utilisation. La conversation s'est rapprochée de la [fenêtre d'auto-compactage](/docs/fr/model-config#set-the-auto-compact-window) de la session, le seuil où Claude Code résume l'historique plus ancien pour libérer de l'espace. Pointez le développeur vers [réduire l'utilisation des tokens](#reduce-token-usage).

235* **Des dépenses inhabituellement élevées sur un plan API ou fournisseur cloud** : généralement tracées jusqu'à des sessions longues qui n'ont jamais été effacées ou à Opus laissé comme modèle par défaut. Les habitudes à impact le plus élevé à partager sont l'effacement entre les tâches non liées et l'adaptation du modèle au travail, tous deux couverts dans [réduire l'utilisation des tokens](#reduce-token-usage).235* **Des dépenses inhabituellement élevées sur un plan API ou fournisseur cloud** : généralement tracées jusqu'à des sessions longues qui n'ont jamais été effacées ou à Opus laissé comme modèle par défaut. Les habitudes à impact le plus élevé à partager sont l'effacement entre les tâches non liées et l'adaptation du modèle au travail, tous deux couverts dans [réduire l'utilisation des tokens](#reduce-token-usage).

Details

192L'un de ceux-ci affiche le texte complet :192L'un de ceux-ci affiche le texte complet :

193 193 

194* Appuyez sur `Ctrl+O` pour ouvrir la [visionneuse de transcription](/docs/fr/interactive-mode#transcript-viewer) et lire le texte complet sous le nom de session de l'expéditeur.194* Appuyez sur `Ctrl+O` pour ouvrir la [visionneuse de transcription](/docs/fr/interactive-mode#transcript-viewer) et lire le texte complet sous le nom de session de l'expéditeur.

195* En [rendu plein écran](/docs/fr/fullscreen#use-the-mouse), cliquez sur une ligne d'aperçu qui omet une partie du message pour l'agrandir sur place.

195* Dans une session démarrée avec [`--verbose`](/docs/fr/cli-reference#cli-flags), Claude Code affiche le texte complet au lieu de l'aperçu.196* Dans une session démarrée avec [`--verbose`](/docs/fr/cli-reference#cli-flags), Claude Code affiche le texte complet au lieu de l'aperçu.

196 197 

197L'aperçu raccourcit seulement ce que vous voyez. Que vous l'agrandissiez ou non, Claude lit le message complet.198L'aperçu raccourcit seulement ce que vous voyez. Que vous l'agrandissiez ou non, Claude lit le message complet.

desktop.md +12 −12

Details

244 Changer les modes d'affichage244 Changer les modes d'affichage

245</h3>245</h3>

246 246 

247Les modes d'affichage contrôlent le niveau de détail qui apparaît dans la transcription du chat. Changez les modes à partir de la liste déroulante **Vue de la transcription** à côté du bouton d'envoi, ou appuyez sur **Ctrl+O** sur macOS ou Windows pour les parcourir. Le mode Thinking apparaît dans la liste déroulante uniquement après que Claude a produit du thinking dans la session que vous consultez.247Les modes d'affichage contrôlent le niveau de détail qui apparaît dans la transcription du chat. Pour changer de mode d'affichage, ouvrez le menu de la session à partir du chevron à côté du titre de la session et sélectionnez **Vue de la transcription**, ou appuyez sur **Ctrl+O** sur macOS ou Windows pour les parcourir. Le mode réflexion apparaît dans le menu uniquement après que Claude a produit de la réflexion dans la session que vous consultez.

248 248 

249| Mode | Ce qu'il affiche |249| Mode | Ce qu'il affiche |

250| - | - |250| - | - |


378 Travailler en parallèle avec les sessions378 Travailler en parallèle avec les sessions

379</h3>379</h3>

380 380 

381Cliquez sur **+ Nouvelle session** dans la barre latérale, ou appuyez sur **Cmd+N** sur macOS ou **Ctrl+N** sur Windows, pour travailler sur plusieurs tâches en parallèle. Appuyez sur **Ctrl+Tab** et **Ctrl+Shift+Tab** pour parcourir les sessions dans la barre latérale. Pour les référentiels Git, sélectionnez l'option **worktree** à côté du nom de la branche pour donner à la session sa propre copie isolée de votre projet en utilisant [Git worktrees](/docs/fr/worktrees), donc les modifications dans une session n'affectent pas les autres sessions jusqu'à ce que vous les validiez.381Cliquez sur **+ Nouvelle session** dans la barre latérale, ou appuyez sur **Cmd+N** sur macOS ou **Ctrl+N** sur Windows, pour travailler sur plusieurs tâches en parallèle. Appuyez sur **Ctrl+Tab** et **Ctrl+Shift+Tab** pour parcourir les sessions dans la barre latérale. Pour les dépôts Git, sélectionnez l'option **worktree** à côté du nom de la branche pour donner à la session sa propre copie isolée de votre projet en utilisant [Git worktrees](/docs/fr/worktrees), donc les modifications dans une session n'affectent pas les autres sessions jusqu'à ce que vous les commitiez.

382 382 

383Pour afficher deux sessions à la fois, maintenez **Cmd** sur macOS ou **Ctrl** sur Windows et cliquez sur une session dans la barre latérale. La session s'ouvre dans un deuxième volet à côté de celui que vous avez déjà ouvert. Pendant que la division est active, cliquer sur une autre session de la barre latérale remplace le volet qui a le focus. Appuyez sur **Cmd+\\** sur macOS ou **Ctrl+\\** sur Windows pour fermer le volet actif et revenir à une seule session.383Pour afficher deux sessions à la fois, maintenez **Cmd** sur macOS ou **Ctrl** sur Windows et cliquez sur une session dans la barre latérale. La session s'ouvre dans un deuxième volet à côté de celui que vous avez déjà ouvert. Pendant que la division est active, cliquer sur une autre session de la barre latérale remplace le volet qui a le focus. Appuyez sur **Cmd+\\** sur macOS ou **Ctrl+\\** sur Windows pour fermer le volet actif et revenir à une seule session.

384 384 

385Les worktrees sont stockés dans `<project-root>/.claude/worktrees/` par défaut. Vous pouvez modifier ceci en un répertoire personnalisé dans Paramètres → Claude Code sous « Emplacement du worktree ». Vous pouvez également définir un préfixe de branche qui est ajouté au début de chaque nom de branche worktree, ce qui est utile pour garder les branches créées par Claude organisées. Pour supprimer un worktree quand vous avez terminé, survolez la session dans la barre latérale et cliquez sur l'icône d'archive. Pour avoir les sessions s'archiver elles-mêmes quand leur demande de tirage fusionne ou se ferme, activez **Auto-archive après fusion ou fermeture de PR** dans Paramètres → Claude Code. L'auto-archive s'applique uniquement aux sessions locales qui ont terminé l'exécution.385Les worktrees sont stockés dans `<project-root>/.claude/worktrees/` par défaut. Vous pouvez modifier ceci en un répertoire personnalisé dans Paramètres → Claude Code sous « Emplacement du worktree ». Vous pouvez également définir un préfixe de branche qui est ajouté au début de chaque nom de branche worktree, ce qui est utile pour garder les branches créées par Claude organisées. Pour supprimer un worktree quand vous avez terminé, survolez la session dans la barre latérale et cliquez sur l'icône d'archive. Pour que les sessions s'archivent elles-mêmes quand leur pull request est fusionnée ou fermée, activez **Auto-archive après fusion ou fermeture de PR** dans Paramètres → Claude Code. L'auto-archive s'applique uniquement aux sessions locales qui ont terminé l'exécution.

386 386 

387Pour inclure les fichiers ignorés par git comme `.env` dans les nouveaux worktrees, créez un [fichier `.worktreeinclude`](/docs/fr/worktrees#copy-gitignored-files-into-worktrees) à la racine de votre projet.387Pour inclure les fichiers ignorés par git comme `.env` dans les nouveaux worktrees, créez un [fichier `.worktreeinclude`](/docs/fr/worktrees#copy-gitignored-files-into-worktrees) à la racine de votre projet.

388 388 


410 Regarder les tâches en arrière-plan410 Regarder les tâches en arrière-plan

411</h3>411</h3>

412 412 

413Le volet des tâches affiche le travail en arrière-plan s'exécutant dans la session actuelle : sous-agents, commandes shell en arrière-plan et [flux de travail dynamiques](/docs/fr/workflows). Ouvrez-le à partir du menu **Vues** ou glissez-le dans votre disposition.413Le volet des tâches affiche le travail en arrière-plan s'exécutant dans la session actuelle : sous-agents, commandes shell en arrière-plan et [workflows dynamiques](/docs/fr/workflows). Ouvrez-le à partir du menu **Vues** ou glissez-le dans votre disposition.

414 414 

415Cliquez sur n'importe quelle entrée pour voir sa sortie dans le volet du sous-agent ou l'arrêter. Pour voir ce que font les autres sessions, utilisez la [barre latérale](#work-in-parallel-with-sessions), ou demandez à Claude de [vérifier pour vous](#work-across-sessions).415Cliquez sur n'importe quelle entrée pour voir sa sortie dans le volet du sous-agent ou l'arrêter. Pour voir ce que font les autres sessions, utilisez la [barre latérale](#work-in-parallel-with-sessions), ou demandez à Claude de [vérifier pour vous](#work-across-sessions).

416 416 


420 420 

421Claude peut lister vos autres sessions de l'onglet Code, lire ce que chacune a fait, et envoyer des messages entre elles. Demandez en langage naturel : « quelle session a touché à la refonte d'authentification ? », « à quelle conclusion la session API est-elle arrivée ? », ou « dites à la session des paiements que le schéma a changé ». Vous pouvez également demander à Claude de renommer ou d'archiver une session. Claude archive une session de la même manière que l'icône d'archive de la barre latérale, donc demandez-lui de nettoyer les sessions dont les PR ont fusionné.421Claude peut lister vos autres sessions de l'onglet Code, lire ce que chacune a fait, et envoyer des messages entre elles. Demandez en langage naturel : « quelle session a touché à la refonte d'authentification ? », « à quelle conclusion la session API est-elle arrivée ? », ou « dites à la session des paiements que le schéma a changé ». Vous pouvez également demander à Claude de renommer ou d'archiver une session. Claude archive une session de la même manière que l'icône d'archive de la barre latérale, donc demandez-lui de nettoyer les sessions dont les PR ont fusionné.

422 422 

423À travers cette surface, Claude ne voit que les sessions que l'application de bureau exécute elle-même : locales, [SSH](#ssh-sessions) et [WSL](/docs/fr/desktop-wsl) sessions dans l'onglet Code. Claude ne voit pas les sessions cloud, ou les sessions que vous avez démarrées à partir du CLI du terminal ou de l'extension VS Code, même dans les worktrees du même projet, donc avec neuf worktrees de terminal ouverts et deux sessions de bureau, Claude répondant dans l'une d'elles signale l'une des autres sessions de bureau. Claude ne liste jamais la session à partir de laquelle vous posez la question. Par défaut, il voit les 20 sessions les plus récemment actives et ignore les sessions archivées sauf si vous les demandez. [La messagerie entre sessions](/docs/fr/cross-session-messaging) permet séparément à Claude de envoyer des messages à [vos autres sessions Claude Code](/docs/fr/cross-session-messaging#see-which-sessions-claude-can-reach), y compris les sessions de terminal.423À travers cette surface, Claude ne voit que les sessions que l'application de bureau exécute elle-même : locales, [SSH](#ssh-sessions) et [WSL](/docs/fr/desktop-wsl) sessions dans l'onglet Code. Claude ne voit pas les sessions cloud, ou les sessions que vous avez démarrées à partir du CLI du terminal ou de l'extension VS Code, même dans les worktrees du même projet, donc avec neuf worktrees de terminal ouverts et deux sessions de bureau, Claude répondant dans l'une d'elles signale l'autre session de bureau. Claude ne liste jamais la session à partir de laquelle vous posez la question. Par défaut, il voit les 20 sessions les plus récemment actives et ignore les sessions archivées sauf si vous les demandez. [La messagerie entre sessions](/docs/fr/cross-session-messaging) permet séparément à Claude d'envoyer des messages à [vos autres sessions Claude Code](/docs/fr/cross-session-messaging#see-which-sessions-claude-can-reach), y compris les sessions de terminal.

424 424 

425Quand Claude envoie un message à une autre session à travers cette surface, Claude Code l'affiche là comme une carte étiquetée avec le titre de la session d'envoi et un lien de retour, donc vous pouvez toujours dire d'où vient un message. Si la session réceptrice est en cours de tâche, Claude Code retient le message et Claude le lit une fois le travail actuel terminé. Le Claude récepteur peut répondre, et Claude Code livre la réponse en retour à travers cette surface. Claude ne peut pas livrer à une session archivée, et vous dit quand un message ne passe pas.425Quand Claude envoie un message à une autre session à travers cette surface, Claude Code l'affiche là comme une carte étiquetée avec le titre de la session d'envoi et un lien de retour, donc vous pouvez toujours dire d'où vient un message. Si la session réceptrice est en cours de tâche, Claude Code retient le message et Claude le lit une fois le travail actuel terminé. Le Claude récepteur peut répondre, et Claude Code livre la réponse en retour à travers cette surface. Claude ne peut pas livrer à une session archivée, et vous dit quand un message ne passe pas.

426 426 


439 439 

440Pour les refactorisations importantes, les suites de tests, les migrations ou autres tâches longues, sélectionnez **Cloud** au lieu de **Local** au démarrage d'une session. Les sessions cloud s'exécutent sur l'infrastructure gérée par Anthropic par défaut et continuent même si vous fermez l'application ou arrêtez votre ordinateur. Revenez à tout moment pour voir la progression ou orienter Claude dans une direction différente. Vous pouvez également surveiller les sessions cloud à partir de [claude.ai/code](https://claude.ai/code) ou de l'[application Claude mobile](/docs/fr/mobile).440Pour les refactorisations importantes, les suites de tests, les migrations ou autres tâches longues, sélectionnez **Cloud** au lieu de **Local** au démarrage d'une session. Les sessions cloud s'exécutent sur l'infrastructure gérée par Anthropic par défaut et continuent même si vous fermez l'application ou arrêtez votre ordinateur. Revenez à tout moment pour voir la progression ou orienter Claude dans une direction différente. Vous pouvez également surveiller les sessions cloud à partir de [claude.ai/code](https://claude.ai/code) ou de l'[application Claude mobile](/docs/fr/mobile).

441 441 

442Les sessions cloud supportent également plusieurs référentiels. Après avoir sélectionné un environnement cloud, cliquez sur le bouton **+** à côté du référentiel sélectionné pour ajouter des référentiels supplémentaires à la session. Chaque référentiel obtient son propre sélecteur de branche. Ceci est utile pour les tâches qui s'étendent sur plusieurs bases de code, comme la mise à jour d'une bibliothèque partagée et ses consommateurs.442Les sessions cloud supportent également plusieurs dépôts. Après avoir sélectionné un environnement cloud, cliquez sur le bouton **+** à côté du dépôt sélectionné pour ajouter des dépôts supplémentaires à la session. Chaque dépôt obtient son propre sélecteur de branche. Ceci est utile pour les tâches qui s'étendent sur plusieurs bases de code, comme la mise à jour d'une bibliothèque partagée et ses consommateurs.

443 443 

444Voir [Utiliser Claude Code dans le cloud](/docs/fr/claude-code-on-the-web) pour plus d'informations sur le fonctionnement des sessions cloud. Quand un corps de travail nécessite de nombreuses sessions cloud, sélectionnez **Projets** dans la barre latérale pour créer un [projet](/docs/fr/claude-projects), où Claude démarre et suit les sessions pour vous à partir d'une conversation.444Voir [Utiliser Claude Code dans le cloud](/docs/fr/claude-code-on-the-web) pour plus d'informations sur le fonctionnement des sessions cloud. Quand un corps de travail nécessite de nombreuses sessions cloud, sélectionnez **Projets** dans la barre latérale pour créer un [projet](/docs/fr/claude-projects), où Claude démarre et suit les sessions pour vous à partir d'une conversation.

445 445 


447 Continuer sur une autre surface447 Continuer sur une autre surface

448</h3>448</h3>

449 449 

450Le menu **Continuer dans**, accessible à partir de l'icône VS Code en bas à droite de la barre d'outils de la session, vous permet de déplacer votre session vers une autre surface :450Pour continuer une session ailleurs, ouvrez le menu de la session à partir du chevron à côté du titre de la session ou à partir de la ligne de la session dans la barre latérale, puis sélectionnez **Ouvrir dans** :

451 451 

452* **Claude Code sur le Web** : envoie votre session locale pour continuer à s'exécuter dans le cloud. Desktop pousse votre branche, génère un résumé de la conversation et crée une nouvelle session cloud avec le contexte complet. Vous pouvez ensuite choisir d'archiver la session locale ou de la conserver. Ceci nécessite un arbre de travail propre et n'est pas disponible pour les sessions SSH.452* Sélectionnez **Cloud** pour continuer la session en tant que [session cloud](/docs/fr/claude-code-on-the-web), votre conversation étant reprise sous forme de résumé. Avant que vous ne confirmiez, la boîte de dialogue indique si vos fichiers sont également déplacés et si cette session est archivée une fois la session cloud prête. Vous ne pouvez pas déplacer ainsi une session qui s'exécute via [SSH](#ssh-sessions) ou dans [WSL](/docs/fr/desktop-wsl).

453* **Votre IDE** : ouvre votre projet dans un IDE supporté au répertoire de travail actuel.453* Sélectionnez un éditeur installé ou votre gestionnaire de fichiers pour y ouvrir le dossier de la session sur le disque.

454 454 

455<h3 id="sessions-from-dispatch">455<h3 id="sessions-from-dispatch">

456 Sessions depuis Dispatch456 Sessions depuis Dispatch


458 458 

459[Dispatch](https://support.claude.com/en/articles/13947068) est une conversation persistante avec Claude qui vit dans l'onglet [Cowork](https://claude.com/product/cowork). Vous envoyez un message à Dispatch avec une tâche, et il décide comment la gérer.459[Dispatch](https://support.claude.com/en/articles/13947068) est une conversation persistante avec Claude qui vit dans l'onglet [Cowork](https://claude.com/product/cowork). Vous envoyez un message à Dispatch avec une tâche, et il décide comment la gérer.

460 460 

461Une tâche peut devenir une session Code de deux façons : vous en demandez une directement, comme « ouvrir une session Claude Code et corriger le bug de connexion », ou Dispatch décide que la tâche est du travail de développement et en génère une automatiquement. Les tâches qui routent généralement vers Code incluent la correction de bugs, la mise à jour des dépendances, l'exécution de tests ou l'ouverture de demandes de tirage. La recherche, l'édition de documents et le travail sur feuille de calcul restent dans Cowork.461Une tâche peut devenir une session Code de deux façons : vous en demandez une directement, comme « ouvrir une session Claude Code et corriger le bug de connexion », ou Dispatch décide que la tâche est du travail de développement et en génère une automatiquement. Les tâches qui routent généralement vers Code incluent la correction de bugs, la mise à jour des dépendances, l'exécution de tests ou l'ouverture de pull requests. La recherche, l'édition de documents et le travail sur feuille de calcul restent dans Cowork.

462 462 

463De toute façon, la session Code apparaît dans la barre latérale de l'onglet Code avec un badge **Dispatch**. Vous recevez une notification push sur votre téléphone quand elle se termine ou a besoin de votre approbation.463De toute façon, la session Code apparaît dans la barre latérale de l'onglet Code avec un badge **Dispatch**. Vous recevez une notification push sur votre téléphone quand elle se termine ou a besoin de votre approbation.

464 464 


739 739 

740[La réflexion étendue](/docs/fr/model-config#extended-thinking) est activée par défaut, ce qui améliore les performances sur les tâches de raisonnement complexe mais utilise des tokens supplémentaires. Sur l'API Anthropic, définissez `MAX_THINKING_TOKENS` à `0` dans l'éditeur d'environnement local pour désactiver la réflexion ; cela n'a aucun effet sur Opus 5.5, Sonnet 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue. Avec la réflexion désactivée sur l'API Anthropic, Claude Code envoie l'effort `high` au lieu d'un niveau supérieur aux modèles qu'il sait [ne pas accepter cette combinaison](/docs/fr/errors#effort-isnt-available-with-thinking-turned-off), comme Opus 5.740[La réflexion étendue](/docs/fr/model-config#extended-thinking) est activée par défaut, ce qui améliore les performances sur les tâches de raisonnement complexe mais utilise des tokens supplémentaires. Sur l'API Anthropic, définissez `MAX_THINKING_TOKENS` à `0` dans l'éditeur d'environnement local pour désactiver la réflexion ; cela n'a aucun effet sur Opus 5.5, Sonnet 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue. Avec la réflexion désactivée sur l'API Anthropic, Claude Code envoie l'effort `high` au lieu d'un niveau supérieur aux modèles qu'il sait [ne pas accepter cette combinaison](/docs/fr/errors#effort-isnt-available-with-thinking-turned-off), comme Opus 5.

741 741 

742Sur les modèles avec [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level), les valeurs `MAX_THINKING_TOKENS` autres que `0` sont ignorées car le raisonnement adaptatif contrôle la profondeur de la réflexion à la place. Sur Opus 4.6 et Sonnet 4.6, définissez `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` à `1` pour utiliser un budget de réflexion fixe ; les modèles Fable, Sonnet 5 et versions ultérieures, et Opus 4.7 et versions ultérieures utilisent toujours le raisonnement adaptatif et n'ont pas de mode de budget fixe.742Sur les modèles avec [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level), Claude Code ignore le nombre lui-même dans une valeur `MAX_THINKING_TOKENS` positive, car le raisonnement adaptatif contrôle la profondeur de la réflexion à la place. Sur Opus 4.6 et Sonnet 4.6, définissez `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` à `1` pour utiliser un budget de réflexion fixe ; les modèles Fable, Sonnet 5 et versions ultérieures, et Opus 4.7 et versions ultérieures utilisent toujours le raisonnement adaptatif et n'ont pas de mode de budget fixe.

743 743 

744<h4 id="local-sessions-on-managed-devices">744<h4 id="local-sessions-on-managed-devices">

745 Sessions locales sur les appareils gérés745 Sessions locales sur les appareils gérés


1005| `--dangerously-skip-permissions` | Contourner les permissions. Sur les plans Pro et Max, activez-le dans Paramètres → Claude Code → « Autoriser le mode de contournement des permissions » ; sur les plans Team et Enterprise, la politique organisationnelle le contrôle |1005| `--dangerously-skip-permissions` | Contourner les permissions. Sur les plans Pro et Max, activez-le dans Paramètres → Claude Code → « Autoriser le mode de contournement des permissions » ; sur les plans Team et Enterprise, la politique organisationnelle le contrôle |

1006| `--add-dir` | Ajouter plusieurs référentiels avec le bouton **+** dans les sessions cloud |1006| `--add-dir` | Ajouter plusieurs référentiels avec le bouton **+** dans les sessions cloud |

1007| `--allowedTools`, `--disallowedTools` | Aucun équivalent par session. Les règles de permission dans les [fichiers de paramètres](/docs/fr/settings) s'appliquent toujours. |1007| `--allowedTools`, `--disallowedTools` | Aucun équivalent par session. Les règles de permission dans les [fichiers de paramètres](/docs/fr/settings) s'appliquent toujours. |

1008| `--verbose` | Mode d'affichage [Verbose](#switch-view-modes) dans la liste déroulante Vue de la transcription |1008| `--verbose` | [Mode d'affichage Verbose](#switch-view-modes) |

1009| `--print`, `--output-format` | Non disponible. Desktop est interactif uniquement. |1009| `--print`, `--output-format` | Non disponible. Desktop est interactif uniquement. |

1010| Variable d'environnement `ANTHROPIC_MODEL` | Liste déroulante de modèle à côté du bouton d'envoi |1010| Variable d'environnement `ANTHROPIC_MODEL` | Liste déroulante de modèle à côté du bouton d'envoi |

1011| Variable d'environnement `MAX_THINKING_TOKENS` | Définissez dans l'éditeur d'environnement local. Voir [configuration de l'environnement](#environment-configuration). |1011| Variable d'environnement `MAX_THINKING_TOKENS` | Définissez dans l'éditeur d'environnement local. Voir [configuration de l'environnement](#environment-configuration). |

Details

92* Enregistrer une capture d'écran avec **Cmd+S** ou un enregistrement d'écran avec **Cmd+R**, en utilisant les boutons de capture du volet ou les raccourcis ; les fichiers sont enregistrés sur votre Bureau92* Enregistrer une capture d'écran avec **Cmd+S** ou un enregistrement d'écran avec **Cmd+R**, en utilisant les boutons de capture du volet ou les raccourcis ; les fichiers sont enregistrés sur votre Bureau

93* Arrêter la diffusion en continu d'un appareil sans l'arrêter en cliquant sur **Detach simulator**, ce qui ramène le volet à son état **Attach simulator**93* Arrêter la diffusion en continu d'un appareil sans l'arrêter en cliquant sur **Detach simulator**, ce qui ramène le volet à son état **Attach simulator**

94 94 

95La ligne sous le nom de l'appareil règle le flux vidéo du simulateur. Réduisez la **Frame rate** ou la **Resolution** si le volet surcharge votre Mac, basculez **Encoding** entre H.264 et JPEG, ou cochez **FPS** pour afficher la fréquence d'images que le volet reçoit. Ces paramètres modifient la façon dont le volet affiche l'appareil, pas la façon dont l'application s'exécute.95Pour régler le flux vidéo du simulateur, ouvrez le menu **Display** du volet. Réduisez la **Frame rate** ou la **Resolution** si le volet surcharge votre Mac. Ces deux paramètres modifient la façon dont le volet affiche l'appareil, pas la façon dont l'application s'exécute.

96 96 

97Vous et Claude pilotez le même appareil, donc vos appuis modifient l'état de l'application que Claude voit. Pour que Claude vérifie un écran spécifique, accédez-y en appuyant, puis demandez. Pendant que Claude pilote l'appareil, le volet affiche un badge **Claude is using this device** au-dessus de l'écran ; attendez avant d'appuyer jusqu'à ce que le badge disparaisse, afin que le résultat reflète l'application plutôt que votre entrée.97Vous et Claude pilotez le même appareil, donc vos appuis modifient l'état de l'application que Claude voit. Pour que Claude vérifie un écran spécifique, accédez-y en appuyant, puis demandez. Pendant que Claude pilote l'appareil, le volet affiche un badge **Claude is using this device** au-dessus de l'écran ; attendez avant d'appuyer jusqu'à ce que le badge disparaisse, afin que le résultat reflète l'application plutôt que votre entrée.

98 98 

Details

135 135 

136**Mettre Claude sur un calendrier.** Configurez des [tâches planifiées](/docs/fr/desktop-scheduled-tasks) pour exécuter Claude automatiquement de manière récurrente : un examen de code quotidien chaque matin, un audit de dépendances hebdomadaire, ou un briefing qui extrait de vos outils connectés.136**Mettre Claude sur un calendrier.** Configurez des [tâches planifiées](/docs/fr/desktop-scheduled-tasks) pour exécuter Claude automatiquement de manière récurrente : un examen de code quotidien chaque matin, un audit de dépendances hebdomadaire, ou un briefing qui extrait de vos outils connectés.

137 137 

138**Augmenter l'échelle quand vous êtes prêt.** Ouvrez des [sessions parallèles](/docs/fr/desktop#work-in-parallel-with-sessions) à partir de la barre latérale pour travailler sur plusieurs tâches à la fois, chacune, si vous le souhaitez, dans son propre Git worktree, et ouvrez le [volet des tâches](/docs/fr/desktop#watch-background-tasks) pour surveiller les sous-agents et les commandes en arrière-plan qu'une session exécute. Ouvrez un [side chat](/docs/fr/desktop#ask-a-side-question-without-derailing-the-session) pour poser une question sans dérailler le fil principal. Envoyez des [travaux de longue durée vers le cloud](/docs/fr/desktop#run-long-running-tasks-in-the-cloud) pour qu'ils continuent même si vous fermez l'application, ou [continuez une session sur le web ou dans votre IDE](/docs/fr/desktop#continue-in-another-surface) si une tâche prend plus de temps que prévu. [Connectez des outils externes](/docs/fr/desktop#extend-claude-code) comme GitHub, Slack et Linear pour réunir votre flux de travail.138**Augmenter l'échelle quand vous êtes prêt.** Ouvrez des [sessions parallèles](/docs/fr/desktop#work-in-parallel-with-sessions) à partir de la barre latérale pour travailler sur plusieurs tâches à la fois, chacune, si vous le souhaitez, dans son propre Git worktree, et ouvrez le [volet des tâches](/docs/fr/desktop#watch-background-tasks) pour surveiller les sous-agents et les commandes en arrière-plan qu'une session exécute. Ouvrez un [side chat](/docs/fr/desktop#ask-a-side-question-without-derailing-the-session) pour poser une question sans dérailler le fil principal. Envoyez des [travaux de longue durée vers le cloud](/docs/fr/desktop#run-long-running-tasks-in-the-cloud) pour qu'ils continuent même si vous fermez l'application, ou [transférez vers le cloud une session que vous avez déjà commencée](/docs/fr/desktop#continue-in-another-surface) si une tâche prend plus de temps que prévu. [Connectez des outils externes](/docs/fr/desktop#extend-claude-code) comme GitHub, Slack et Linear pour réunir votre workflow.

139 139 

140<h2 id="what’s-next">140<h2 id="what’s-next">

141 Étapes suivantes141 Étapes suivantes

env-vars.md +359 −320

Details

124 Variables124 Variables

125</h2>125</h2>

126 126 

127Les variables numériques telles que les délais d'expiration, les budgets de tokens et les nombres de nouvelles tentatives acceptent la notation scientifique et les séparateurs de chiffres en plus des chiffres simples, sauf lorsque la ligne d'une variable indique qu'elle n'accepte que des chiffres simples. Par exemple, Claude Code lit `2e3` comme 2000 et `64_000` comme 64000. Avant la v2.1.211, ces écritures pouvaient définir silencieusement une valeur beaucoup plus petite, par exemple `1e6` fixant un délai d'expiration à 1.127Les variables numériques telles que les délais d'expiration, les budgets de tokens et les nombres de nouvelles tentatives acceptent la notation scientifique et les séparateurs de chiffres en plus des chiffres simples, sauf lorsque la ligne d'une variable indique qu'elle n'accepte que des chiffres simples. Par exemple, Claude Code lit `2e3` comme 2 000 et `64_000` comme 64 000. Avant la v2.1.211, ces écritures pouvaient définir silencieusement une valeur beaucoup plus petite, comme `1e6` qui définissait un délai d'expiration à 1.

128 128 

129<Note>129<Note>

130 Pour les variables qui activent ou désactivent un comportement, définissez `1`, `true`, `yes` ou `on` pour l'activer et `0`, `false`, `no` ou `off` pour le désactiver, quelle que soit la casse.130 Pour les variables qui activent ou désactivent un comportement, définissez `1`, `true`, `yes` ou `on` pour l'activer et `0`, `false`, `no` ou `off` pour le désactiver, quelle que soit la casse.

131 131 

132 Certaines variables vérifient uniquement si vous les avez définies : toute valeur non vide, y compris `0`, active donc le comportement, et vous le désactivez en supprimant la variable ou en lui attribuant une valeur vide. Ces variables fonctionnent ainsi :132 Certaines variables vérifient uniquement si vous les avez définies ou non : toute valeur non vide, y compris `0`, active alors le comportement, et vous le désactivez en supprimant la variable ou en lui attribuant une valeur vide. Ces variables fonctionnent ainsi :

133 133 

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`135 * `DISABLE_TELEMETRY`


143 143 

144| Variable | Objectif |144| Variable | Objectif |

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

146| `ANTHROPIC_API_KEY` | Clé API envoyée dans l'en-tête `X-Api-Key`. Lorsqu'elle est définie, cette clé est utilisée à la place de votre abonnement Claude Pro, Max, Team ou Enterprise, même si vous êtes connecté. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente. En mode interactif, il vous est demandé d'approuver la clé une fois avant qu'elle ne remplace votre abonnement. Pour utiliser plutôt votre abonnement, exécutez `unset ANTHROPIC_API_KEY` |146| `ANTHROPIC_API_KEY` | Clé API envoyée dans l'en-tête `X-Api-Key`. Lorsqu'elle est définie, cette clé est utilisée à la place de votre abonnement Claude Pro, Max, Team ou Enterprise, même si vous êtes connecté. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente. En mode interactif, il vous est demandé d'approuver la clé une fois avant qu'elle ne remplace votre abonnement. Pour utiliser votre abonnement à la place, exécutez `unset ANTHROPIC_API_KEY` |

147| `ANTHROPIC_AUTH_TOKEN` | Valeur personnalisée pour l'en-tête `Authorization` (la valeur définie ici sera préfixée par `Bearer `) |147| `ANTHROPIC_AUTH_TOKEN` | Valeur personnalisée pour l'en-tête `Authorization` (la valeur que vous définissez ici sera préfixée par `Bearer `) |

148| `ANTHROPIC_AWS_API_KEY` | Clé API d'espace de travail pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), générée dans la console AWS. Envoyée en tant que `x-api-key` et prioritaire sur AWS SigV4 |148| `ANTHROPIC_AWS_API_KEY` | Clé API d'espace de travail pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), générée dans l'AWS Console. Envoyée en tant que `x-api-key` et prioritaire sur AWS SigV4 |

149| `ANTHROPIC_AWS_BASE_URL` | Remplace l'URL de l'endpoint [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). À utiliser pour des régions personnalisées ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Par défaut `https://aws-external-anthropic.{region}.api.aws`. Claude Code résout la région selon la [même priorité que sur Amazon Bedrock](/docs/fr/amazon-bedrock#3-configure-claude-code) |149| `ANTHROPIC_AWS_BASE_URL` | Remplace l'URL de l'endpoint de [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). À utiliser pour des régions personnalisées ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Valeur par défaut : `https://aws-external-anthropic.{region}.api.aws`. Claude Code détermine la région avec la [même priorité que sur Amazon Bedrock](/docs/fr/amazon-bedrock#3-configure-claude-code) |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | Requis pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). Envoyé avec chaque requête dans l'en-tête `anthropic-workspace-id` |150| `ANTHROPIC_AWS_WORKSPACE_ID` | Requise pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). Envoyée avec chaque requête dans l'en-tête `anthropic-workspace-id` |

151| `ANTHROPIC_BASE_URL` | Remplace l'endpoint de l'API pour router les requêtes via un proxy ou une passerelle. Lorsqu'il pointe vers un hôte non first-party, [la recherche d'outils MCP](/docs/fr/mcp#scale-with-mcp-tool-search) est désactivée par défaut. Définissez `ENABLE_TOOL_SEARCH=true` si votre proxy transmet les blocs `tool_reference`. Depuis la v2.1.196, [Remote Control](/docs/fr/remote-control#requirements) est désactivé lorsque cette variable pointe vers un hôte autre que `api.anthropic.com`, comme c'est le cas sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry |151| `ANTHROPIC_BASE_URL` | Remplace l'endpoint de l'API pour acheminer les requêtes via un proxy ou une passerelle. Lorsqu'elle pointe vers un hôte non first-party, [MCP Tool Search](/docs/fr/mcp#scale-with-mcp-tool-search) est désactivé par défaut. Définissez `ENABLE_TOOL_SEARCH=true` si votre proxy transmet les blocs `tool_reference`. Depuis la v2.1.196, [Remote Control](/docs/fr/remote-control#requirements) est désactivé lorsque cette variable pointe vers un hôte autre que `api.anthropic.com`, comme c'est le cas sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Remplace l'URL de l'endpoint Amazon Bedrock. À utiliser pour des endpoints Amazon Bedrock personnalisés ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Voir [Amazon Bedrock](/docs/fr/amazon-bedrock) |152| `ANTHROPIC_BEDROCK_BASE_URL` | Remplace l'URL de l'endpoint Amazon Bedrock. À utiliser pour des endpoints Amazon Bedrock personnalisés ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Voir [Amazon Bedrock](/docs/fr/amazon-bedrock) |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Remplace l'URL de l'endpoint Amazon Bedrock Mantle. Voir [Endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Remplace l'URL de l'endpoint Amazon Bedrock Mantle. Voir [Endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Préfixe de profil d'inférence interrégional (`us`, `eu`, `apac`, `jp`, `au` ou `global`) que Claude Code essaie en premier au lieu de celui dérivé de la région AWS. Ignoré dans les régions AWS GovCloud. Nécessite Claude Code v2.1.224 ou ultérieur. Voir [Amazon Bedrock](/docs/fr/amazon-bedrock#cross-region-inference-profile-prefixes) |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Préfixe de profil d'inférence interrégional (`us`, `eu`, `apac`, `jp`, `au` ou `global`) que Claude Code essaie en premier au lieu de celui dérivé de la région AWS. Ignorée dans les régions AWS GovCloud. Nécessite Claude Code v2.1.224 ou version ultérieure. Voir [Amazon Bedrock](/docs/fr/amazon-bedrock#cross-region-inference-profile-prefixes) |

155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Niveau de service](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) Amazon Bedrock (`default`, `flex` ou `priority`). Envoyé dans l'en-tête `X-Amzn-Bedrock-Service-Tier`. Voir [Amazon Bedrock](/docs/fr/amazon-bedrock#service-tiers) |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Niveau de service](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) Amazon Bedrock (`default`, `flex` ou `priority`). Envoyé dans l'en-tête `X-Amzn-Bedrock-Service-Tier`. Voir [Amazon Bedrock](/docs/fr/amazon-bedrock#service-tiers) |

156| `ANTHROPIC_BETAS` | Liste, séparée par des virgules, de valeurs d'en-tête `anthropic-beta` supplémentaires à inclure dans les requêtes API. Claude Code envoie déjà les en-têtes bêta dont il a besoin ; utilisez cette variable pour activer une [bêta de l'API Anthropic](https://platform.claude.com/docs/en/api/beta-headers) avant que Claude Code n'en ajoute la prise en charge native. Contrairement au [flag `--betas`](/docs/fr/cli-reference#cli-flags), qui nécessite une authentification par clé API, cette variable fonctionne avec toutes les méthodes d'authentification, y compris l'abonnement Claude.ai |156| `ANTHROPIC_BETAS` | Liste séparée par des virgules de valeurs d'en-tête `anthropic-beta` supplémentaires à inclure dans les requêtes API. Claude Code envoie déjà les en-têtes bêta dont il a besoin ; utilisez cette variable pour activer une [bêta de l'API Anthropic](https://platform.claude.com/docs/en/api/beta-headers) avant que Claude Code n'en ajoute la prise en charge native. Contrairement au [flag `--betas`](/docs/fr/cli-reference#cli-flags), qui nécessite une authentification par clé API, cette variable fonctionne avec toutes les méthodes d'authentification, y compris l'abonnement Claude.ai |

157| `ANTHROPIC_CUSTOM_HEADERS` | En-têtes personnalisés à ajouter aux requêtes (format `Name: Value`, séparés par des retours à la ligne pour plusieurs en-têtes). Si un nom ou une valeur contient un caractère qu'un en-tête HTTP ne peut pas transporter, comme un guillemet typographique ou un espace de largeur nulle, la requête échoue avec une erreur qui identifie la paire par sa position. Nécessite Claude Code v2.1.227 ou ultérieur. [Invalid request header value](/docs/fr/errors#invalid-request-header-value) indique le jeu de caractères exact et l'endroit où la vérification s'effectue. Une valeur qui définit un en-tête d'identifiants, d'organisation ou de tenant, de routage ou de comportement de l'API, comme `Authorization` ou `Host`, compte comme un [paramètre nécessitant une approbation](/docs/fr/server-managed-settings#environment-variables-and-the-approval-dialog) lorsque des paramètres gérés par le serveur la fournissent. Depuis les paramètres de projet ou locaux, une telle valeur suit les [règles déterminant quand les valeurs `env` s'appliquent](/docs/fr/settings-reference#when-claude-code-applies-env-values) |157| `ANTHROPIC_CUSTOM_HEADERS` | En-têtes personnalisés à ajouter aux requêtes (format `Name: Value`, séparés par des retours à la ligne pour plusieurs en-têtes). Si un nom ou une valeur contient un caractère qu'un en-tête HTTP ne peut pas transporter, comme un guillemet courbe ou un espace de largeur nulle, la requête échoue avec une erreur qui identifie la paire par sa position. Nécessite Claude Code v2.1.227 ou version ultérieure. [Invalid request header value](/docs/fr/errors#invalid-request-header-value) indique le jeu de caractères exact et l'endroit où la vérification s'exécute. Une valeur qui définit un en-tête d'identifiants, d'organisation ou de tenant, de routage ou de comportement de l'API, comme `Authorization` ou `Host`, compte comme un [paramètre nécessitant une approbation](/docs/fr/server-managed-settings#environment-variables-and-the-approval-dialog) lorsque des paramètres gérés par le serveur la fournissent. Depuis les paramètres de projet ou locaux, une telle valeur suit les [règles d'application des valeurs `env`](/docs/fr/settings-reference#when-claude-code-applies-env-values) |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID de modèle à ajouter comme entrée personnalisée dans le sélecteur `/model`. Utilisez-la pour rendre sélectionnable un modèle non standard ou propre à une passerelle sans remplacer les alias intégrés. Voir [Configuration du modèle](/docs/fr/model-config#add-a-custom-model-option) |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID de modèle à ajouter comme entrée personnalisée dans le sélecteur `/model`. Utilisez cette variable pour rendre sélectionnable un modèle non standard ou propre à une passerelle sans remplacer les alias intégrés. Voir [Configuration du modèle](/docs/fr/model-config#add-a-custom-model-option) |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Description affichée pour l'entrée de modèle personnalisé dans le sélecteur `/model`. Par défaut `Custom model (<model-id>)` lorsqu'elle n'est pas définie |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Description affichée pour l'entrée de modèle personnalisé dans le sélecteur `/model`. Valeur par défaut si elle n'est pas définie : `Custom model (<model-id>)` |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nom affiché pour l'entrée de modèle personnalisé dans le sélecteur `/model`. Lorsqu'il n'est pas défini, l'entrée affiche le nom du modèle si Claude Code [reconnaît l'ID](/docs/fr/model-config#customize-pinned-model-display-and-capabilities), et l'ID du modèle sinon |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nom affiché pour l'entrée de modèle personnalisé dans le sélecteur `/model`. Si elle n'est pas définie, l'entrée affiche le nom du modèle si Claude Code [reconnaît l'ID](/docs/fr/model-config#customize-pinned-model-display-and-capabilities), et l'ID du modèle dans le cas contraire |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Liste, séparée par des virgules, des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle personnalisé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Liste séparée par des virgules des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle personnalisé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID de modèle vers lequel l'alias `fable` est résolu, et ID que Claude Code reconnaît comme un modèle Fable pour le [basculement automatique de modèle](/docs/fr/model-config#automatic-model-fallback) chez les fournisseurs tiers. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID de modèle vers lequel l'alias `fable` est résolu, et ID que Claude Code reconnaît comme un modèle Fable pour le [basculement automatique de modèle](/docs/fr/model-config#automatic-model-fallback) chez les fournisseurs tiers. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Description affichée pour le modèle Fable épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par `Custom Fable model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Description affichée pour le modèle Fable épinglé dans le sélecteur `/model`. Si elle n'est pas définie, la ligne affiche une description par défaut qui commence par `Custom Fable model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nom affiché pour le modèle Fable épinglé dans le sélecteur `/model`. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nom affiché pour le modèle Fable épinglé dans le sélecteur `/model`. Si elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé dans le cas contraire. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Liste, séparée par des virgules, des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Fable épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Liste séparée par des virgules des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Fable épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID de modèle vers lequel l'alias `haiku` est résolu, également utilisé pour les [fonctionnalités en arrière-plan](/docs/fr/costs#background-token-usage). Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID de modèle vers lequel l'alias `haiku` est résolu, également utilisé pour les [fonctionnalités en arrière-plan](/docs/fr/costs#background-token-usage). Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Description affichée pour le modèle Haiku épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par `Custom Haiku model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Description affichée pour le modèle Haiku épinglé dans le sélecteur `/model`. Si elle n'est pas définie, la ligne affiche une description par défaut qui commence par `Custom Haiku model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nom affiché pour le modèle Haiku épinglé dans le sélecteur `/model`. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nom affiché pour le modèle Haiku épinglé dans le sélecteur `/model`. Si elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé dans le cas contraire. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Liste, séparée par des virgules, des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Haiku épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Liste séparée par des virgules des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Haiku épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

170| `ANTHROPIC_DEFAULT_MODEL` | Modèle sur lequel les nouvelles sessions démarrent par défaut. Nécessite Claude Code v2.1.236 ou ultérieur. Voir [Définir un modèle par défaut pour les nouvelles sessions](/docs/fr/model-config#set-a-default-model-for-new-sessions) |170| `ANTHROPIC_DEFAULT_MODEL` | Modèle sur lequel les nouvelles sessions démarrent par défaut. Nécessite Claude Code v2.1.236 ou version ultérieure. Voir [Définir un modèle par défaut pour les nouvelles sessions](/docs/fr/model-config#set-a-default-model-for-new-sessions) |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID de modèle vers lequel l'alias `opus` est résolu, et que `opusplan` utilise lorsque le mode plan est actif. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID de modèle vers lequel l'alias `opus` est résolu, et que `opusplan` utilise lorsque le mode plan est actif. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Description affichée pour le modèle Opus épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par `Custom Opus model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Description affichée pour le modèle Opus épinglé dans le sélecteur `/model`. Si elle n'est pas définie, la ligne affiche une description par défaut qui commence par `Custom Opus model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nom affiché pour le modèle Opus épinglé dans le sélecteur `/model`. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nom affiché pour le modèle Opus épinglé dans le sélecteur `/model`. Si elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé dans le cas contraire. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Liste, séparée par des virgules, des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Opus épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Liste séparée par des virgules des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Opus épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID de modèle vers lequel l'alias `sonnet` est résolu, et que `opusplan` utilise lorsque le mode plan n'est pas actif. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID de modèle vers lequel l'alias `sonnet` est résolu, et que `opusplan` utilise lorsque le mode plan n'est pas actif. Voir [Configuration du modèle](/docs/fr/model-config#environment-variables) |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Description affichée pour le modèle Sonnet épinglé dans le sélecteur `/model`. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par `Custom Sonnet model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Description affichée pour le modèle Sonnet épinglé dans le sélecteur `/model`. Si elle n'est pas définie, la ligne affiche une description par défaut qui commence par `Custom Sonnet model`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nom affiché pour le modèle Sonnet épinglé dans le sélecteur `/model`. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nom affiché pour le modèle Sonnet épinglé dans le sélecteur `/model`. Si elle n'est pas définie, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé dans le cas contraire. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Liste, séparée par des virgules, des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Sonnet épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Liste séparée par des virgules des [capacités](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) prises en charge par le modèle Sonnet épinglé, par exemple `effort,thinking`. Voir [Configuration du modèle](/docs/fr/model-config#customize-pinned-model-display-and-capabilities) |

179| `ANTHROPIC_FEDERATION_RULE_ID` | ID de règle de fédération pour [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Lorsque vous la définissez avec `ANTHROPIC_ORGANIZATION_ID`, Claude Code sélectionne les identifiants de fédération, qui ont priorité sur vos identifiants `/login`. Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |179| `ANTHROPIC_FEDERATION_RULE_ID` | ID de règle de fédération pour [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Lorsque vous la définissez avec `ANTHROPIC_ORGANIZATION_ID`, Claude Code sélectionne les identifiants de fédération, qui ont priorité sur vos identifiants `/login`. Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |

180| `ANTHROPIC_FOUNDRY_API_KEY` | Clé API pour l'authentification Microsoft Foundry (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |180| `ANTHROPIC_FOUNDRY_API_KEY` | Clé API pour l'authentification Microsoft Foundry (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |

181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Jeton Bearer pour l'authentification Microsoft Foundry, tel qu'un jeton d'accès Microsoft Entra. Claude Code l'envoie dans l'en-tête `Authorization: Bearer`. Prioritaire sur `ANTHROPIC_FOUNDRY_API_KEY` et sur la chaîne d'identifiants Azure par défaut. Voir [Microsoft Foundry](/docs/fr/microsoft-foundry). Nécessite Claude Code v2.1.203 ou ultérieur |181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Jeton Bearer pour l'authentification Microsoft Foundry, comme un jeton d'accès Microsoft Entra. Claude Code l'envoie dans l'en-tête `Authorization: Bearer`. Prioritaire sur `ANTHROPIC_FOUNDRY_API_KEY` et sur la chaîne d'identifiants par défaut d'Azure. Voir [Microsoft Foundry](/docs/fr/microsoft-foundry). Nécessite Claude Code v2.1.203 ou version ultérieure |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | URL de base complète de la ressource Microsoft Foundry (par exemple, `https://my-resource.services.ai.azure.com/anthropic`). Alternative à `ANTHROPIC_FOUNDRY_RESOURCE` (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |182| `ANTHROPIC_FOUNDRY_BASE_URL` | URL de base complète de la ressource Microsoft Foundry (par exemple, `https://my-resource.services.ai.azure.com/anthropic`). Alternative à `ANTHROPIC_FOUNDRY_RESOURCE` (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Nom de la ressource Microsoft Foundry (par exemple, `my-resource`). Claude Code [refuse une URL ou un nom d'hôte](/docs/fr/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Requis si `ANTHROPIC_FOUNDRY_BASE_URL` n'est pas défini (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Nom de la ressource Microsoft Foundry (par exemple, `my-resource`). Claude Code [refuse une URL ou un nom d'hôte](/docs/fr/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Requise si `ANTHROPIC_FOUNDRY_BASE_URL` n'est pas définie (voir [Microsoft Foundry](/docs/fr/microsoft-foundry)) |

184| `ANTHROPIC_MODEL` | Nom du paramètre de modèle à utiliser (voir [Configuration du modèle](/docs/fr/model-config#environment-variables)) |184| `ANTHROPIC_MODEL` | Nom du paramètre de modèle à utiliser (voir [Configuration du modèle](/docs/fr/model-config#environment-variables)) |

185| `ANTHROPIC_ORGANIZATION_ID` | ID d'organisation pour [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Définissez-le avec `ANTHROPIC_FEDERATION_RULE_ID`. Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |185| `ANTHROPIC_ORGANIZATION_ID` | ID d'organisation pour [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Définissez-la avec `ANTHROPIC_FEDERATION_RULE_ID`. Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |

186| `ANTHROPIC_PROFILE` | Nom du profil Anthropic avec lequel s'authentifier, comme un profil créé par [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) ou par une [connexion à un compte Console sans clé API](/docs/fr/authentication#sign-in-without-an-api-key). Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |186| `ANTHROPIC_PROFILE` | Nom du profil Anthropic avec lequel s'authentifier, comme un profil créé par [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) ou en [vous connectant à un compte Console sans clé API](/docs/fr/authentication#sign-in-without-an-api-key). Voir [priorité d'authentification](/docs/fr/authentication#authentication-precedence) |

187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DÉPRÉCIÉ] Nom du [modèle de classe Haiku pour les tâches en arrière-plan](/docs/fr/costs) |187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DÉPRÉCIÉE] Nom du [modèle de classe Haiku pour les tâches en arrière-plan](/docs/fr/costs) |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Remplace la région AWS pour le modèle de classe Haiku lors de l'utilisation d'Amazon Bedrock ou d'Amazon Bedrock Mantle. Sur Amazon Bedrock, cela ne prend effet que si `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou la variable dépréciée `ANTHROPIC_SMALL_FAST_MODEL` est également définie, car sinon Amazon Bedrock exécute les tâches en arrière-plan sur le [modèle Sonnet par défaut ou le modèle principal](/docs/fr/amazon-bedrock#4-pin-model-versions) dans la région de la session |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Remplace la région AWS pour le modèle de classe Haiku lors de l'utilisation d'Amazon Bedrock ou d'Amazon Bedrock Mantle. Sur Amazon Bedrock, elle ne prend effet que si `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou la variable dépréciée `ANTHROPIC_SMALL_FAST_MODEL` est également définie, car sinon Amazon Bedrock exécute les tâches en arrière-plan sur le [modèle Sonnet par défaut ou le modèle principal](/docs/fr/amazon-bedrock#4-pin-model-versions) dans la région de la session |

189| `ANTHROPIC_VERTEX_BASE_URL` | Remplace l'URL de l'endpoint de Google Cloud's Agent Platform. À utiliser pour des endpoints Google Cloud's Agent Platform personnalisés ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Voir [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) |189| `ANTHROPIC_VERTEX_BASE_URL` | Remplace l'URL de l'endpoint de Google Cloud's Agent Platform. À utiliser pour des endpoints Google Cloud's Agent Platform personnalisés ou lors du routage via une [passerelle LLM](/docs/fr/llm-gateway). Voir [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID du projet GCP auquel les requêtes Google Cloud's Agent Platform sont adressées. Voir [Configurer les identifiants GCP](/docs/fr/google-vertex-ai#3-configure-gcp-credentials) |190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID du projet GCP auquel les requêtes Google Cloud's Agent Platform sont adressées. Voir [Configurer les identifiants GCP](/docs/fr/google-vertex-ai#3-configure-gcp-credentials) |

191| `ANTHROPIC_WORKSPACE_ID` | ID d'espace de travail pour la [fédération d'identité de charge de travail](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Définissez-le lorsque votre règle de fédération couvre plusieurs espaces de travail, afin que l'échange de jetons sache quel espace de travail cibler |191| `ANTHROPIC_WORKSPACE_ID` | ID d'espace de travail pour la [fédération d'identité de charge de travail](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Définissez-la lorsque votre règle de fédération couvre plusieurs espaces de travail, afin que l'échange de jetons sache quel espace de travail cibler |

192| `API_FORCE_IDLE_TIMEOUT` | Remplace le délai d'inactivité de 5 minutes sur le corps de la réponse, qui interrompt une réponse de modèle en streaming lorsqu'aucun octet n'arrive. Définissez `0` pour désactiver ce délai, par exemple lorsqu'une [passerelle](/docs/fr/llm-gateway) lente ou un modèle local marque une pause de plus de 5 minutes entre deux fragments, ou `1` pour le maintenir actif pour tous les fournisseurs. Lorsque la variable n'est pas définie, le délai est actif chez les fournisseurs autres que l'API Anthropic directe, [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et Amazon Bedrock avec `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` défini. Les [watchdogs de flux](/docs/fr/network-config#streaming-idle-watchdogs) fonctionnent indépendamment de celui-ci et interrompent une longue pause silencieuse même si vous définissez `0` ici |192| `API_FORCE_IDLE_TIMEOUT` | Remplace le délai d'inactivité de 5 minutes sur le corps de la réponse, qui interrompt une réponse de modèle en streaming lorsqu'aucun octet n'arrive. Définissez `0` pour désactiver ce délai, par exemple lorsqu'une [passerelle](/docs/fr/llm-gateway) lente ou un modèle local fait des pauses de plus de 5 minutes entre les blocs, ou `1` pour le maintenir actif pour tous les fournisseurs. Lorsque la variable n'est pas définie, le délai est actif pour les fournisseurs autres que l'API Anthropic directe, [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et Amazon Bedrock avec `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` défini. Les [watchdogs de streaming](/docs/fr/network-config#streaming-idle-watchdogs) fonctionnent indépendamment et interrompent une longue pause silencieuse même si vous définissez `0` ici |

193| `API_TIMEOUT_MS` | Délai d'expiration des requêtes API en millisecondes (par défaut : 600000, soit 10 minutes ; maximum : 2147483647). Augmentez-le lorsque les requêtes expirent sur des réseaux lents ou lors du routage via un proxy. Les valeurs supérieures au maximum font déborder le minuteur sous-jacent et provoquent l'échec immédiat des requêtes |193| `API_TIMEOUT_MS` | Délai d'expiration des requêtes API en millisecondes (par défaut : 600000, soit 10 minutes ; maximum : 2147483647). Augmentez cette valeur lorsque les requêtes expirent sur des réseaux lents ou lors du routage via un proxy. Les valeurs supérieures au maximum font déborder le minuteur sous-jacent et provoquent l'échec immédiat des requêtes |

194| `AWS_BEARER_TOKEN_BEDROCK` | Clé API Amazon Bedrock pour l'authentification (voir [Clés API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |194| `AWS_BEARER_TOKEN_BEDROCK` | Clé API Amazon Bedrock pour l'authentification (voir [Clés API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

195| `BASH_DEFAULT_TIMEOUT_MS` | Délai d'expiration par défaut d'une commande de l'outil Bash ou PowerShell au premier plan, en millisecondes (par défaut : 120000, soit 2 minutes). Une valeur par défaut supérieure à 30 minutes devient également la [limite de temps par défaut des commandes en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands) dans les sessions sans surveillance. La limite de temps en arrière-plan nécessite Claude Code v2.1.285 ou ultérieur |195| `BASH_DEFAULT_TIMEOUT_MS` | Délai d'expiration par défaut d'une commande de l'outil Bash ou PowerShell au premier plan, en millisecondes (par défaut : 120000, soit 2 minutes). Une valeur par défaut supérieure à 30 minutes devient également la [limite de temps par défaut des commandes en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands) dans les sessions sans surveillance. La limite de temps en arrière-plan nécessite Claude Code v2.1.285 ou version ultérieure |

196| `BASH_MAX_OUTPUT_LENGTH` | Nombre maximal de caractères de la sortie bash que Claude Code relit dans le résultat d'une commande (par défaut : 30000 ; maximum : 150000). Si vous définissez le paramètre [`bashOutputMaxChars`](/docs/fr/settings-reference#bashoutputmaxchars), Claude Code ignore cette variable. Voir [Limites de sortie](/docs/fr/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Nombre maximal de caractères de la sortie bash que Claude Code réintègre dans le résultat d'une commande (par défaut : 30000 ; maximum : 150000). Si vous définissez le paramètre [`bashOutputMaxChars`](/docs/fr/settings-reference#bashoutputmaxchars), Claude Code ignore cette variable. Voir [Limites de sortie](/docs/fr/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | Délai d'expiration maximal que le modèle peut définir pour une commande de l'outil Bash ou PowerShell au premier plan, en millisecondes (par défaut : 600000, soit 10 minutes). Le plafond effectif est la plus grande valeur entre celle-ci et `BASH_DEFAULT_TIMEOUT_MS`. Un plafond effectif supérieur à 2 heures devient également la [limite de temps maximale des commandes en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands) dans les sessions sans surveillance. La limite de temps en arrière-plan nécessite Claude Code v2.1.285 ou ultérieur |197| `BASH_MAX_TIMEOUT_MS` | Délai d'expiration maximal que le modèle peut définir pour une commande de l'outil Bash ou PowerShell au premier plan, en millisecondes (par défaut : 600000, soit 10 minutes). Le plafond effectif est la plus grande valeur entre celle-ci et `BASH_DEFAULT_TIMEOUT_MS`. Un plafond effectif supérieur à 2 heures devient également la [limite de temps maximale des commandes en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands) dans les sessions sans surveillance. La limite de temps en arrière-plan nécessite Claude Code v2.1.285 ou version ultérieure |

198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP pour le [traçage bêta détaillé](/docs/fr/monitoring-usage#traces-beta) : avec `ENABLE_BETA_TRACING_DETAILED=1`, les logs et les traces y sont envoyés au lieu des exportateurs configurés. Définissez-le dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignoré dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP pour le [traçage bêta détaillé](/docs/fr/monitoring-usage#traces-beta) : avec `ENABLE_BETA_TRACING_DETAILED=1`, les logs et les traces y sont envoyés au lieu des exportateurs configurés. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |

199| `CCR_FORCE_BUNDLE` | Définissez `1` pour forcer [`claude --cloud`](/docs/fr/claude-code-on-the-web#send-local-repositories-without-github) à empaqueter et téléverser votre dépôt local au lieu de le cloner depuis son remote |199| `CCR_FORCE_BUNDLE` | Définissez sur `1` pour forcer [`claude --cloud`](/docs/fr/claude-code-on-the-web#send-local-repositories-without-github) à empaqueter et téléverser votre dépôt local au lieu de le cloner depuis son remote |

200| `CLAUDECODE` | Défini à `1` dans les sous-processus lancés par Claude Code (outils Bash et PowerShell, sessions tmux, commandes de [hook](/docs/fr/hooks), commandes de [barre de statut](/docs/fr/statusline), sous-processus de [serveur MCP](/docs/fr/mcp) stdio). Les extensions IDE le définissent également dans leurs terminaux intégrés. Utilisez-la pour détecter si un script s'exécute dans un sous-processus lancé par Claude Code. Pour vérifier si le processus actuel a été lancé directement par un appel d'outil ou un hook, plutôt qu'au sein d'un serveur MCP stdio démarré par Claude Code, utilisez plutôt `CLAUDE_CODE_CHILD_SESSION` |200| `CLAUDECODE` | Définie sur `1` dans les sous-processus lancés par Claude Code (outils Bash et PowerShell, sessions tmux, commandes de [hook](/docs/fr/hooks), commandes de [barre de statut](/docs/fr/statusline), sous-processus de [serveur MCP](/docs/fr/mcp) stdio). Les extensions IDE la définissent également dans leurs terminaux intégrés. À utiliser pour détecter qu'un script s'exécute dans un sous-processus lancé par Claude Code. Pour vérifier si le processus actuel a été lancé directement par un appel d'outil ou un hook, plutôt qu'à l'intérieur d'un serveur MCP stdio démarré par Claude Code, utilisez plutôt `CLAUDE_CODE_CHILD_SESSION` |

201| `CLAUDE_AFK_COUNTDOWN_MS` | Nombre de millisecondes avant la poursuite automatique auquel le compte à rebours apparaît à l'écran sur une boîte de dialogue [`AskUserQuestion`](/docs/fr/tools-reference) sans réponse. Par défaut `20000` (20 secondes), plafonné au délai de poursuite automatique. Sans effet si la poursuite automatique n'est pas activée ; voir le paramètre [`askUserQuestionTimeout`](/docs/fr/settings-reference#askuserquestiontimeout) et `CLAUDE_AFK_TIMEOUT_MS`. Nécessite Claude Code v2.1.198 ou ultérieur |201| `CLAUDE_AFK_COUNTDOWN_MS` | Nombre de millisecondes avant la poursuite automatique à partir duquel le compte à rebours apparaît à l'écran sur une boîte de dialogue [`AskUserQuestion`](/docs/fr/tools-reference) sans réponse. Par défaut `20000` (20 secondes), plafonné au délai de poursuite automatique. Sans effet si la poursuite automatique n'est pas activée ; voir le paramètre [`askUserQuestionTimeout`](/docs/fr/settings-reference#askuserquestiontimeout) et `CLAUDE_AFK_TIMEOUT_MS`. Nécessite Claude Code v2.1.198 ou version ultérieure |

202| `CLAUDE_AFK_TIMEOUT_MS` | Nombre de millisecondes d'inactivité avant qu'une boîte de dialogue [`AskUserQuestion`](/docs/fr/tools-reference) sans réponse ne se poursuive automatiquement sans vous. La poursuite automatique est désactivée par défaut ; activez-la avec le paramètre [`askUserQuestionTimeout`](/docs/fr/settings-reference#askuserquestiontimeout). Cette variable est un remplacement destiné aux démos et aux tests automatisés : lorsqu'elle est définie, elle a priorité sur ce paramètre et active la poursuite automatique même si le paramètre n'est pas défini ou vaut `never`. Définir `0` ne désactive pas le délai ; cela ferme immédiatement la boîte de dialogue. Dans les v2.1.198 et v2.1.199, la poursuite automatique était activée par défaut avec un délai de `60000` (60 secondes). Nécessite Claude Code v2.1.198 ou ultérieur |202| `CLAUDE_AFK_TIMEOUT_MS` | Nombre de millisecondes d'inactivité avant qu'une boîte de dialogue [`AskUserQuestion`](/docs/fr/tools-reference) sans réponse ne se poursuive automatiquement sans vous. La poursuite automatique est désactivée par défaut ; activez-la avec le paramètre [`askUserQuestionTimeout`](/docs/fr/settings-reference#askuserquestiontimeout). Cette variable est une surcharge destinée aux démos et aux tests automatisés : lorsqu'elle est définie, elle a priorité sur ce paramètre et active la poursuite automatique même si le paramètre n'est pas défini ou vaut `never`. Définir `0` ne désactive pas le délai ; cela ferme immédiatement la boîte de dialogue. Dans les v2.1.198 et v2.1.199, la poursuite automatique était activée par défaut avec un délai de `60000` (60 secondes). Nécessite Claude Code v2.1.198 ou version ultérieure |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Définissez `1` pour désactiver tous les types de [sous-agents](/docs/fr/sub-agents) intégrés tels qu'Explore et Plan. S'applique uniquement en mode non interactif (le flag `-p`). Utile pour les utilisateurs du SDK qui veulent partir de zéro. Cela supprime également `general-purpose`, le sous-agent que Claude Code exécute lorsqu'un appel de l'outil Agent omet `subagent_type`. Un tel appel échoue alors avec [`subagent_type is required`](/docs/fr/errors#subagent-type-is-required) |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Définissez sur `1` pour désactiver tous les types de [sous-agents](/docs/fr/sub-agents) intégrés comme Explore et Plan. S'applique uniquement en mode non interactif (le flag `-p`). Utile pour les utilisateurs du SDK qui veulent partir d'une page blanche. Cela supprime également `general-purpose`, le sous-agent que Claude Code exécute lorsqu'un appel de l'outil Agent omet `subagent_type`. Un tel appel échoue alors avec [`subagent_type is required`](/docs/fr/errors#subagent-type-is-required) |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Définissez `1` pour omettre le préfixe `mcp__<server>__` des noms d'outils provenant de serveurs MCP créés par le SDK. Les outils utilisent leurs noms d'origine. Usage SDK uniquement |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Définissez sur `1` pour omettre le préfixe `mcp__<server>__` sur les noms d'outils des serveurs MCP créés par le SDK. Les outils utilisent leurs noms d'origine. Utilisation avec le SDK uniquement |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Délai de blocage en millisecondes pour les sous-agents. Par défaut `600000` (10 minutes) ; si vous augmentez `CLAUDE_STREAM_IDLE_TIMEOUT_MS` alors que le watchdog de flux est actif, la valeur par défaut augmente avec lui, comme le décrit [Gérer les réponses API lentes ou bloquées](/docs/fr/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Le minuteur est réinitialisé à chaque événement de progression du streaming ; si aucune progression n'arrive dans l'intervalle, Claude Code interrompt le sous-agent et signale le blocage au parent |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Délai de blocage en millisecondes pour les sous-agents. Par défaut `600000` (10 minutes) ; si vous augmentez `CLAUDE_STREAM_IDLE_TIMEOUT_MS` alors que le watchdog du flux est actif, la valeur par défaut augmente avec elle, comme le décrit [Gérer les réponses API lentes ou bloquées](/docs/fr/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Le minuteur se réinitialise à chaque événement de progression du streaming ; si aucune progression n'arrive dans la fenêtre, Claude Code interrompt le sous-agent et signale le blocage au parent |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Définit le pourcentage (1-100) de la fenêtre de compaction automatique auquel la compaction automatique se déclenche. Utilisez des valeurs plus basses comme `50` pour compacter plus tôt ; la variable ne peut pas relever le seuil, les valeurs supérieures au pourcentage par défaut sont donc ignorées. Elle s'applique uniquement aux sessions qui [compactent avant la limite de contexte du modèle](/docs/fr/model-config#context-window-and-auto-compaction). S'applique aux conversations principales comme aux sous-agents |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Définit le pourcentage (1-100) de la fenêtre de compaction automatique auquel la compaction automatique se déclenche. Utilisez des valeurs plus basses comme `50` pour compacter plus tôt ; la variable ne peut pas relever le seuil, donc les valeurs supérieures au pourcentage par défaut sont ignorées. Elle s'applique uniquement dans les sessions qui [compactent avant la limite de contexte du modèle](/docs/fr/model-config#context-window-and-auto-compaction). S'applique à la fois aux conversations principales et aux sous-agents |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Définissez `1` pour forcer l'activation de la mise en arrière-plan automatique des tâches d'agent de longue durée. Lorsqu'elle est activée, les sous-agents passent en arrière-plan après environ deux minutes d'exécution. Active également la [mise en arrière-plan automatique des longs appels d'outils MCP](/docs/fr/mcp#automatic-backgrounding-of-long-tool-calls) en mode non interactif sur Claude Code v2.1.212 ou ultérieur |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Définissez sur `1` pour forcer l'activation de la mise en arrière-plan automatique des tâches d'agent de longue durée. Lorsqu'elle est activée, les sous-agents passent en arrière-plan après environ deux minutes d'exécution. Active également la [mise en arrière-plan automatique des longs appels d'outils MCP](/docs/fr/mcp#automatic-backgrounding-of-long-tool-calls) en mode non interactif sur Claude Code v2.1.212 ou version ultérieure |

208| `CLAUDE_AX_PREPARK_MS` | En [mode lecteur d'écran](/docs/fr/accessibility), nombre de millisecondes que Claude Code attend avant d'écrire une ligne nouvelle ou modifiée. Par défaut `0`, Claude Code n'attend donc pas. Avant la v2.1.287, la valeur par défaut était `50`. Claude Code plafonne l'attente à `5000`. Nécessite Claude Code v2.1.233 ou ultérieur |208| `CLAUDE_AX_PREPARK_MS` | En [mode lecteur d'écran](/docs/fr/accessibility), nombre de millisecondes que Claude Code attend avant d'écrire une ligne nouvelle ou modifiée. Par défaut `0`, donc Claude Code n'attend pas. Avant la v2.1.287, la valeur par défaut était `50`. Claude Code plafonne l'attente à `5000`. Nécessite Claude Code v2.1.233 ou version ultérieure |

209| `CLAUDE_AX_SCREEN_READER` | Définissez `1` pour produire une sortie adaptée aux lecteurs d'écran : texte brut sans bordures décoratives ni animations. Définissez `0` pour forcer la désactivation du mode lecteur d'écran même lorsque [`axScreenReader`](/docs/fr/settings-reference#axscreenreader) vaut `true`. Le flag [`--ax-screen-reader`](/docs/fr/cli-reference#cli-flags) est prioritaire. Nécessite Claude Code v2.1.181 ou ultérieur |209| `CLAUDE_AX_SCREEN_READER` | Définissez sur `1` pour produire une sortie adaptée aux lecteurs d'écran : texte brut sans bordures décoratives ni animations. Définissez sur `0` pour forcer la désactivation du mode lecteur d'écran même lorsque [`axScreenReader`](/docs/fr/settings-reference#axscreenreader) vaut `true`. Le flag [`--ax-screen-reader`](/docs/fr/cli-reference#cli-flags) est prioritaire. Nécessite Claude Code v2.1.181 ou version ultérieure |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | En [mode lecteur d'écran](/docs/fr/accessibility), nombre de millisecondes pendant lesquelles Claude Code retient le premier rendu de l'interface après la ligne de confirmation de démarrage, afin que votre lecteur d'écran puisse lire la ligne en entier avant qu'une nouvelle sortie ne l'interrompe. Par défaut `3000`. Définissez `0` pour un rendu immédiat. Claude Code plafonne cette attente à `600000` (10 minutes). Votre première frappe met fin à l'attente plus tôt. Nécessite Claude Code v2.1.217 ou ultérieur |210| `CLAUDE_AX_STARTUP_QUIET_MS` | En [mode lecteur d'écran](/docs/fr/accessibility), nombre de millisecondes pendant lesquelles Claude Code retient le premier rendu de l'interface après la ligne de confirmation du démarrage, afin que votre lecteur d'écran puisse prononcer la ligne en entier avant qu'une nouvelle sortie ne l'interrompe. Par défaut `3000`. Définissez `0` pour un rendu immédiat. Claude Code plafonne cette attente à `600000` (10 minutes). Votre première frappe au clavier met fin à l'attente plus tôt. Nécessite Claude Code v2.1.217 ou version ultérieure |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Revenir au répertoire de travail d'origine après chaque commande Bash ou PowerShell dans la session principale |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Revient au répertoire de travail d'origine après chaque commande Bash ou PowerShell dans la session principale |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration en millisecondes du watchdog d'inactivité du streaming au niveau des octets ; lorsqu'il est défini, il a priorité sur `CLAUDE_STREAM_IDLE_TIMEOUT_MS` pour ce watchdog et laisse inchangé le watchdog au niveau des événements. Claude Code limite cette variable à une valeur comprise entre 10 secondes et 30 minutes. Nécessite Claude Code v2.1.210 ou ultérieur |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration en millisecondes du watchdog d'inactivité du streaming au niveau des octets ; lorsqu'elle est définie, elle a priorité sur `CLAUDE_STREAM_IDLE_TIMEOUT_MS` pour ce watchdog et laisse inchangé le watchdog au niveau des événements. Claude Code limite cette variable à une valeur comprise entre 10 secondes et 30 minutes. Nécessite Claude Code v2.1.210 ou version ultérieure |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | Chemin vers un fichier qu'un outil externe, comme un écouteur de verrouillage d'écran, crée lorsque vous déverrouillez votre écran et supprime lorsque vous le verrouillez. Tant que le fichier existe, Claude Code ignore les [notifications push mobiles de Remote Control](/docs/fr/remote-control#mobile-push-notifications), afin que vous ne receviez plus de notifications push pendant que vous utilisez activement l'ordinateur. Lorsque le fichier est absent ou illisible, les notifications sont envoyées normalement. Claude Code vérifie le fichier une fois par événement déclenchant une notification push plutôt que de l'interroger en continu. Nécessite Claude Code v2.1.181 ou ultérieur |213| `CLAUDE_CLIENT_PRESENCE_FILE` | Chemin vers un fichier qu'un outil externe, comme un écouteur de verrouillage d'écran, crée lorsque vous déverrouillez votre écran et supprime lorsque vous le verrouillez. Tant que le fichier existe, Claude Code n'envoie pas les [notifications push mobiles de Remote Control](/docs/fr/remote-control#mobile-push-notifications), de sorte que vous ne recevez plus de notifications pendant que vous utilisez activement l'ordinateur. Lorsque le fichier est absent ou illisible, les notifications sont envoyées normalement. Claude Code vérifie le fichier une fois par événement déclenchant une notification plutôt que de l'interroger en continu. Nécessite Claude Code v2.1.181 ou version ultérieure |

214| `CLAUDE_CODE_ACCESSIBILITY` | Définissez `1` pour garder le curseur natif du terminal visible et désactiver l'indicateur de curseur en texte inversé. Permet aux loupes d'écran comme le Zoom de macOS de suivre la position du curseur |214| `CLAUDE_CODE_ACCESSIBILITY` | Définissez sur `1` pour garder visible le curseur natif du terminal et désactiver l'indicateur de curseur en texte inversé. Permet aux loupes d'écran comme macOS Zoom de suivre la position du curseur |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Définissez `1` pour charger les fichiers mémoire depuis les répertoires spécifiés avec `--add-dir`. Charge `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` et `CLAUDE.local.md`. Par défaut, les répertoires supplémentaires ne chargent pas de fichiers mémoire |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Définissez sur `1` pour charger les fichiers de mémoire depuis les répertoires spécifiés avec `--add-dir`. Charge `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` et `CLAUDE.local.md`. Par défaut, les répertoires supplémentaires ne chargent pas de fichiers de mémoire |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Définissez `1` pour redessiner l'écran entier à chaque image en [rendu plein écran](/docs/fr/fullscreen) au lieu d'envoyer des mises à jour incrémentielles. Utilisez-la si le mode plein écran affiche des fragments de texte obsolètes ou mal placés. Claude Code l'active automatiquement pour les sessions en arrière-plan et la [vue des agents](/docs/fr/agent-view) sous Windows |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Définissez sur `1` pour redessiner l'écran entier à chaque image en [rendu plein écran](/docs/fr/fullscreen) au lieu d'envoyer des mises à jour incrémentielles. Utilisez-la si le mode plein écran affiche des fragments de texte obsolètes ou mal placés. Claude Code l'active automatiquement pour les sessions en arrière-plan et la [vue des agents](/docs/fr/agent-view) sous Windows |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Définissez `1` pour envoyer le paramètre [effort](/docs/fr/model-config#adjust-effort-level) avec chaque requête, même lorsque Claude Code ne reconnaît pas l'ID du modèle comme compatible avec l'effort. Utilisez-la lors du routage via une [passerelle LLM](/docs/fr/llm-gateway) ou un fournisseur tiers qui sert des modèles sous des identifiants personnalisés. Les modèles qui rejettent le paramètre effort au niveau de l'API, y compris les modèles Claude 3, Sonnet 4.0 et 4.5, Opus 4.0 et 4.1, et Haiku 4.5, restent exclus afin que les requêtes n'échouent pas |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Définissez sur `1` pour envoyer le paramètre [effort](/docs/fr/model-config#adjust-effort-level) avec chaque requête, même lorsque Claude Code ne reconnaît pas l'ID du modèle comme compatible avec l'effort. Utilisez-la lors du routage via une [passerelle LLM](/docs/fr/llm-gateway) ou un fournisseur tiers qui sert des modèles sous des identifiants personnalisés. Les modèles qui rejettent le paramètre effort au niveau de l'API, notamment les modèles Claude 3, Sonnet 4.0 et 4.5, Opus 4.0 et 4.1, et Haiku 4.5, restent exclus afin que les requêtes n'échouent pas |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalle en millisecondes auquel les identifiants doivent être actualisés (lors de l'utilisation de [`apiKeyHelper`](/docs/fr/settings-reference#apikeyhelper)) |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalle en millisecondes auquel les identifiants doivent être actualisés (lors de l'utilisation de [`apiKeyHelper`](/docs/fr/settings-reference#apikeyhelper)) |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Définissez `0` pour empêcher Claude Code d'ouvrir automatiquement le navigateur lorsqu'un nouvel [artefact](/docs/fr/artifacts#create-an-artifact) est publié |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Définissez sur `0` pour empêcher Claude Code d'ouvrir automatiquement le navigateur lorsqu'un nouvel [artefact](/docs/fr/artifacts#create-an-artifact) est publié |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Définissez `0` pour empêcher Claude de lire les [commentaires sur un artefact](/docs/fr/artifacts#collect-comments-on-an-artifact) et d'y répondre. Sans effet lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` a [désactivé les artefacts](/docs/fr/artifacts#availability). Nécessite Claude Code v2.1.221 ou ultérieur |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Définissez sur `0` pour empêcher Claude de lire les [commentaires sur un artefact](/docs/fr/artifacts#collect-comments-on-an-artifact) et d'y répondre. Sans effet lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` a [désactivé les artefacts](/docs/fr/artifacts#availability). Nécessite Claude Code v2.1.221 ou version ultérieure |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Définissez `0` pour empêcher Claude de [répondre de lui-même aux commentaires qui lui sont envoyés](/docs/fr/artifacts#let-claude-reply-to-comments-on-its-own). Nécessite Claude Code v2.1.228 ou ultérieur |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Définissez sur `0` pour empêcher Claude de [répondre de lui-même aux commentaires qui lui sont envoyés](/docs/fr/artifacts#let-claude-reply-to-comments-on-its-own). Nécessite Claude Code v2.1.228 ou version ultérieure |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Définissez `0` pour omettre le [bloc d'attribution](/docs/fr/llm-gateway-protocol#system-prompt-attribution-block), qui contient la version du client et une empreinte du prompt, au début du prompt système. La mise en cache sur une connexion directe à l'API Anthropic n'est pas affectée dans un cas comme dans l'autre. Dans certaines configurations à connexion directe, Claude Code conserve le bloc sur les requêtes du classifieur du [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) même si vous définissez `0`. Dans [Bloc d'attribution du prompt système](/docs/fr/llm-gateway-protocol#system-prompt-attribution-block), vérifiez quelles connexions et quels identifiants sont concernés. Avant la v2.1.181, le bloc incluait un jeton par requête sur les URL de base personnalisées et les connexions Microsoft Foundry ; sur ces versions, définissez-le donc à `0` lorsque votre passerelle LLM met en cache sur le corps de la requête ou transmet les requêtes à un fournisseur tiers, ou lorsque vous vous connectez directement à Microsoft Foundry |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Définissez sur `0` pour omettre du début du prompt système le [bloc d'attribution](/docs/fr/llm-gateway-protocol#system-prompt-attribution-block), qui contient la version du client et une empreinte du prompt. La mise en cache sur une connexion directe à l'API Anthropic n'est pas affectée dans un cas comme dans l'autre. Dans certaines configurations de connexion directe, Claude Code conserve le bloc sur les requêtes du classifieur du [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) même si vous définissez `0`. Dans [Bloc d'attribution du prompt système](/docs/fr/llm-gateway-protocol#system-prompt-attribution-block), vérifiez quelles connexions et quels identifiants sont concernés. Avant la v2.1.181, le bloc incluait un jeton propre à chaque requête sur les URL de base personnalisées et les connexions Microsoft Foundry ; sur ces versions, définissez-la donc sur `0` lorsque votre passerelle LLM met en cache en fonction du corps de la requête ou transmet les requêtes à un fournisseur tiers, ou lorsque vous vous connectez directement à Microsoft Foundry |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Lorsque `CLAUDE_AUTO_BACKGROUND_TASKS` est activé, nombre de secondes entre les rappels invitant Claude à vérifier les [sous-agents en arrière-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) encore en cours d'exécution. Accepte uniquement un entier simple de `1` à `86400` ; toute autre valeur ou écriture est traitée comme non définie. Lorsqu'elle n'est pas définie, il n'y a pas de rappels. Nécessite Claude Code v2.1.248 ou ultérieur |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Supprimée dans la v2.1.283. Utilisez plutôt `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Définit la [fenêtre de compaction automatique](/docs/fr/model-config#set-the-auto-compact-window) en tokens, de `100000` à `1000000`. Accepte uniquement un entier simple tel que `500000` : une valeur comme `500k` est lue comme `500` et ramenée au minimum de 100K. La fenêtre effective est également plafonnée à la fenêtre de contexte du modèle. Prioritaire sur la commande `/autocompact`, le flag `--autocompact` et le paramètre `autoCompactWindow`. Le `used_percentage` de la barre de statut se mesure toujours par rapport à la fenêtre de contexte complète du modèle ; une fois cette variable définie, ce pourcentage n'indique donc plus quand la compaction aura lieu |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Définit la [fenêtre de compaction automatique](/docs/fr/model-config#set-the-auto-compact-window) en tokens, de `100000` à `1000000`. Accepte uniquement un entier simple comme `500000` : une valeur comme `500k` est lue comme `500` et ramenée au minimum de 100K. La fenêtre effective est également plafonnée à la fenêtre de contexte du modèle. Prioritaire sur la commande `/autocompact`, le flag `--autocompact` et le paramètre `autoCompactWindow`. Le `used_percentage` de la barre de statut se mesure toujours par rapport à la fenêtre de contexte complète du modèle ; une fois cette variable définie, ce pourcentage n'indique donc plus quand la compaction aura lieu |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Remplace la [connexion IDE](/docs/fr/vs-code) automatique. Par défaut, Claude Code se connecte automatiquement lorsqu'il est lancé dans le terminal intégré d'un IDE pris en charge. Définissez `false` pour l'en empêcher. Définissez `true` pour forcer une tentative de connexion lorsque la détection automatique échoue, par exemple lorsque tmux masque le terminal parent. Prioritaire sur le paramètre de configuration globale [`autoConnectIde`](/docs/fr/settings-reference#autoconnectide) |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Remplace la [connexion IDE](/docs/fr/vs-code) automatique. Par défaut, Claude Code se connecte automatiquement lorsqu'il est lancé dans le terminal intégré d'un IDE pris en charge. Définissez sur `false` pour l'empêcher. Définissez sur `true` pour forcer une tentative de connexion lorsque la détection automatique échoue, par exemple lorsque tmux masque le terminal parent. Prioritaire sur le paramètre de configuration globale [`autoConnectIde`](/docs/fr/settings-reference#autoconnectide) |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Contrôle si Claude Code demande au serveur d'[examiner les actions du mode auto](/docs/fr/permission-modes#server-side-classifier-review). Définissez `0` pour utiliser à la place les requêtes de classifieur propres à Claude Code. Sur une connexion directe à l'API Anthropic, nécessite la v2.1.281 ou ultérieure. La section liée indique quelles sessions interrogent le serveur lorsque la variable n'est pas définie, et à partir de quelle version. Nécessite Claude Code v2.1.271 ou ultérieur |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Contrôle si Claude Code demande au serveur d'[examiner les actions du mode auto](/docs/fr/permission-modes#server-side-classifier-review). Définissez sur `0` pour utiliser à la place les propres requêtes de classifieur de Claude Code. Sur une connexion directe à l'API Anthropic, nécessite la v2.1.281 ou version ultérieure. La section liée indique quelles sessions interrogent le serveur lorsque la variable n'est pas définie, et à partir de quelle version. Nécessite Claude Code v2.1.271 ou version ultérieure |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Temps en millisecondes pendant lequel Claude Code attend que la chaîne de fournisseurs d'identifiants AWS par défaut produise des identifiants avant que la requête échoue avec [`AWS default-chain credential resolve timed out`](/docs/fr/errors#aws-default-chain-credential-resolve-timed-out) (par défaut : `60000`). Augmentez-le lorsqu'une étape de votre chaîne a légitimement besoin de plus de temps, comme une connexion SSO via navigateur avec MFA à travers un wrapper tel que `aws-vault`. S'applique partout où Claude Code signe avec la chaîne par défaut : [Amazon Bedrock](/docs/fr/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et l'[endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint). Nécessite Claude Code v2.1.207 ou ultérieur |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Temps en millisecondes pendant lequel Claude Code attend que la chaîne de fournisseurs d'identifiants AWS par défaut produise des identifiants avant que la requête n'échoue avec [`AWS default-chain credential resolve timed out`](/docs/fr/errors#aws-default-chain-credential-resolve-timed-out) (par défaut : `60000`). Augmentez-le lorsqu'une étape de votre chaîne a légitimement besoin de plus de temps, comme une connexion SSO via navigateur avec MFA au travers d'un wrapper comme `aws-vault`. S'applique partout où Claude Code signe avec la chaîne par défaut : [Amazon Bedrock](/docs/fr/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et l'[endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint). Nécessite Claude Code v2.1.207 ou version ultérieure |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Définissez `0` pour désactiver le [diff des fichiers modifiés pendant l'exécution d'une commande Bash](/docs/fr/hooks#bash), ou `1` pour l'enregistrer dans tous les modes de permission. Prioritaire sur le paramètre [`bashEditDiffEnabled`](/docs/fr/settings-reference#basheditdiffenabled). Nécessite Claude Code v2.1.269 ou ultérieur |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Définissez sur `0` pour désactiver le [diff des fichiers modifiés pendant l'exécution d'une commande Bash](/docs/fr/hooks#bash), ou sur `1` pour l'enregistrer dans tous les modes de permission. Prioritaire sur le paramètre [`bashEditDiffEnabled`](/docs/fr/settings-reference#basheditdiffenabled). Nécessite Claude Code v2.1.269 ou version ultérieure |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Définissez `0` pour qu'une session non interactive signale un statut inactif à son hôte à chaque fin de tour, même lorsque du travail en arrière-plan est encore en cours. Par défaut, la session continue de signaler un statut en cours d'exécution après la fin du tour tant qu'un travail en arrière-plan, tel qu'un agent en arrière-plan ou une exécution de [workflow](/docs/fr/workflows), est encore actif. Cela évite qu'un hôte qui surveille le statut, comme une liste de sessions à distance, annonce que Claude attend votre saisie en plein travail. Les commandes shell en arrière-plan, comme un serveur de développement, ne maintiennent pas le statut en cours d'exécution. Le statut en cours d'exécution par défaut et la désactivation via `0` nécessitent Claude Code v2.1.269 ou ultérieur ; sur les versions antérieures, définissez `1` pour maintenir le statut en cours d'exécution |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Définissez sur `0` pour qu'une session non interactive signale un statut inactif à son hôte à chaque fin de tour, même lorsque du travail en arrière-plan est encore en cours. Par défaut, la session continue de signaler un statut en cours d'exécution après la fin du tour tant que du travail en arrière-plan, comme un agent en arrière-plan ou l'exécution d'un [workflow](/docs/fr/workflows), est encore actif. Cela évite qu'un hôte qui surveille le statut, comme une liste de sessions distantes, n'annonce que Claude attend votre saisie alors qu'il est en plein travail. Les commandes shell en arrière-plan, comme un serveur de développement, ne maintiennent pas le statut en cours d'exécution. Le statut en cours d'exécution par défaut et la désactivation via `0` nécessitent Claude Code v2.1.269 ou version ultérieure ; sur les versions antérieures, définissez `1` pour maintenir le statut en cours d'exécution |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Défini automatiquement dans les sous-processus de l'outil Bash et des [commandes de hook](/docs/fr/hooks) tant que la session dispose d'une connexion [Remote Control](/docs/fr/remote-control) active, et supprimé à la fin de la connexion. La valeur est l'identifiant de la session au format `session_`, le même identifiant que celui qui apparaît dans l'URL `claude.ai/code` de la session, afin qu'un script puisse renvoyer vers la session qui l'a exécuté. Nécessite Claude Code v2.1.199 ou ultérieur. Dans les [sessions cloud](/docs/fr/claude-code-on-the-web), lisez plutôt `CLAUDE_CODE_REMOTE_SESSION_ID` |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Définie automatiquement dans les sous-processus de l'outil Bash et des [commandes de hook](/docs/fr/hooks) tant que la session dispose d'une connexion [Remote Control](/docs/fr/remote-control) active, et supprimée à la fin de la connexion. La valeur est l'ID de la session au format `session_`, le même identifiant que celui qui apparaît dans l'URL `claude.ai/code` de la session, afin qu'un script puisse renvoyer vers la session qui l'a exécuté. Nécessite Claude Code v2.1.199 ou version ultérieure. Dans les [sessions cloud](/docs/fr/claude-code-on-the-web), lisez plutôt `CLAUDE_CODE_REMOTE_SESSION_ID` |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Définissez `0` pour que Claude Code lise l'octet `0x08`, également noté `^H`, comme un simple Backspace, ou `1` pour le lire comme Ctrl+Backspace. L'une ou l'autre valeur remplace le comportement par défaut de la plateforme. Par défaut, Claude Code le lit comme Ctrl+Backspace sous Windows, sauf lorsque `TERM_PROGRAM` vaut `mintty` ou `TERM` vaut `cygwin`, et comme un simple Backspace sous macOS et Linux. Définissez `0` dans un terminal Windows où [Backspace supprime un mot entier](/docs/fr/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Définissez sur `0` pour que Claude Code lise l'octet `0x08`, également écrit `^H`, comme un simple Backspace, ou sur `1` pour le lire comme Ctrl+Backspace. L'une ou l'autre valeur remplace le comportement par défaut de la plateforme. Par défaut, Claude Code le lit comme Ctrl+Backspace sous Windows, sauf lorsque `TERM_PROGRAM` vaut `mintty` ou que `TERM` vaut `cygwin`, et comme un simple Backspace sous macOS et Linux. Définissez `0` dans un terminal Windows où [Backspace supprime un mot entier](/docs/fr/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

232| `CLAUDE_CODE_CERT_STORE` | Liste, séparée par des virgules, des sources de certificats CA pour les connexions TLS. `bundled` est l'ensemble de CA Mozilla fourni avec Claude Code. `system` est le magasin de certificats de confiance du système d'exploitation, lu uniquement sur les runtimes disposant de `tls.getCACertificates` : le binaire natif, ou Node 22.15 ou ultérieur pour les installations npm. Voir [Magasin de certificats CA](/docs/fr/network-config#ca-certificate-store). Par défaut `bundled,system` |232| `CLAUDE_CODE_CERT_STORE` | Liste séparée par des virgules des sources de certificats CA pour les connexions TLS. `bundled` est l'ensemble de CA Mozilla fourni avec Claude Code. `system` est le magasin de confiance du système d'exploitation, lu uniquement sur les runtimes disposant de `tls.getCACertificates` : le binaire natif, ou Node 22.15 ou version ultérieure pour les installations npm. Voir [Magasin de certificats CA](/docs/fr/network-config#ca-certificate-store). Par défaut : `bundled,system` |

233| `CLAUDE_CODE_CHILD_SESSION` | Défini à `1` dans les sous-processus que Claude Code lance via les outils Bash, PowerShell et Monitor, les commandes de [hook](/docs/fr/hooks) et les commandes de [barre de statut](/docs/fr/statusline). Non défini pour les sous-processus de [serveur MCP](/docs/fr/mcp) stdio, qui sont de longue durée et survivent à la session qui les a lancés. Contrairement à `CLAUDECODE`, cette variable n'est définie que par Claude Code lui-même lorsqu'il lance un sous-processus, et non par les extensions IDE ; elle distingue donc de manière fiable une session imbriquée d'un `claude` de premier niveau lancé dans un terminal intégré à un IDE. Un TUI `claude` interactif imbriqué démarré de cette façon est automatiquement exclu de `--resume`, `--continue`, de l'historique de la flèche haut et de la liste `claude agents`. Les sessions `claude -p` non interactives restent persistées. Définissez `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` pour annuler cette exclusion. Nécessite Claude Code v2.1.172 ou ultérieur |233| `CLAUDE_CODE_CHILD_SESSION` | Définie sur `1` dans les sous-processus que Claude Code lance via les outils Bash, PowerShell et Monitor, les commandes de [hook](/docs/fr/hooks) et les commandes de [barre de statut](/docs/fr/statusline). Non définie pour les sous-processus de [serveur MCP](/docs/fr/mcp) stdio, qui ont une longue durée de vie et survivent à la session qui les a lancés. Contrairement à `CLAUDECODE`, elle n'est définie que par Claude Code lui-même lorsqu'il lance un sous-processus, et non par les extensions IDE ; elle permet donc de distinguer de manière fiable une session imbriquée d'un `claude` de premier niveau lancé dans un terminal intégré à un IDE. Une TUI `claude` interactive imbriquée démarrée de cette façon est automatiquement exclue de `--resume`, `--continue`, de l'historique accessible par la flèche haut et de la liste `claude agents`. Les sessions non interactives `claude -p` sont toujours conservées. Définissez `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` pour annuler cette exclusion. Nécessite Claude Code v2.1.172 ou version ultérieure |

234| `CLAUDE_CODE_CLIENT_CERT` | Chemin vers le fichier de certificat client pour l'authentification mTLS |234| `CLAUDE_CODE_CLIENT_CERT` | Chemin vers le fichier de certificat client pour l'authentification mTLS |

235| `CLAUDE_CODE_CLIENT_KEY` | Chemin vers le fichier de clé privée client pour l'authentification mTLS |235| `CLAUDE_CODE_CLIENT_KEY` | Chemin vers le fichier de clé privée client pour l'authentification mTLS |

236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Phrase secrète pour la CLAUDE\_CODE\_CLIENT\_KEY chiffrée (facultatif) |236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Phrase secrète de la CLAUDE\_CODE\_CLIENT\_KEY chiffrée (facultatif) |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Supprimée dans la v2.1.186 et désormais sans effet. Définissait auparavant un délai d'expiration distinct pour la phase de connexion, TLS et en-têtes de réponse d'une requête API en streaming. Utilisez `API_TIMEOUT_MS` pour le délai d'expiration par requête. Pour la phase d'en-têtes de réponse d'une requête en streaming, voir `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Supprimée dans la v2.1.186 et désormais sans effet. Définissait auparavant un délai d'expiration distinct pour la phase de connexion, de TLS et d'en-têtes de réponse d'une requête API en streaming. Utilisez `API_TIMEOUT_MS` pour le délai d'expiration par requête. Pour la phase d'en-têtes de réponse d'une requête en streaming, voir `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Remplace le chemin du fichier de log de débogage. Malgré son nom, il s'agit d'un chemin de fichier, et non d'un répertoire. Nécessite que le mode débogage soit activé séparément via `--debug`, `/debug` ou la variable d'environnement `DEBUG` : définir cette variable seule n'active pas la journalisation. Le flag [`--debug-file`](/docs/fr/cli-reference#cli-flags) fait les deux à la fois. Par défaut `~/.claude/debug/<session-id>.txt` |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Remplace le chemin du fichier de log de débogage. Malgré son nom, il s'agit d'un chemin de fichier, pas d'un répertoire. Nécessite que le mode débogage soit activé séparément via `--debug`, `/debug` ou la variable d'environnement `DEBUG` : définir cette variable seule n'active pas la journalisation. Le flag [`--debug-file`](/docs/fr/cli-reference#cli-flags) fait les deux à la fois. Par défaut : `~/.claude/debug/<session-id>.txt` |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Niveau de log minimal écrit dans le fichier de log de débogage. Valeurs : `verbose`, `debug` (par défaut), `info`, `warn`, `error`. Définissez `verbose` pour inclure des diagnostics volumineux comme la sortie complète de la commande de barre de statut, ou montez à `error` pour réduire le bruit |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Niveau de log minimal écrit dans le fichier de log de débogage. Valeurs : `verbose`, `debug` (par défaut), `info`, `warn`, `error`. Définissez sur `verbose` pour inclure des diagnostics volumineux comme la sortie complète de la commande de la barre de statut, ou relevez-le à `error` pour réduire le bruit |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Définissez `1` pour désactiver la prise en charge de la [fenêtre de contexte de 1M](/docs/fr/model-config#extended-context). Lorsqu'elle est définie, les variantes de modèles 1M ne sont pas disponibles dans le sélecteur de modèle, et Claude Code limite à une fenêtre de 200K les sessions sur des modèles dotés d'une fenêtre native de 1M, comme [Sonnet 5.5](/docs/fr/model-config#sonnet-5-5-and-sonnet-5-context-window) et les modèles Fable ; voir [Contexte étendu](/docs/fr/model-config#extended-context) pour savoir comment cette limite est appliquée. Utile pour les environnements d'entreprise soumis à des exigences de conformité. Pour son rôle dans la correction de la fenêtre d'un ID de modèle `[1m]` non reconnu, voir [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Définissez sur `1` pour désactiver la prise en charge de la [fenêtre de contexte de 1M](/docs/fr/model-config#extended-context). Lorsqu'elle est définie, les variantes de modèles 1M ne sont pas disponibles dans le sélecteur de modèle, et Claude Code limite les sessions sur les modèles dotés d'une fenêtre native de 1M, comme [Sonnet 5.5](/docs/fr/model-config#sonnet-5-5-and-sonnet-5-context-window) et les modèles Fable, à une fenêtre de 200K ; voir [Contexte étendu](/docs/fr/model-config#extended-context) pour savoir comment cette limite est appliquée. Utile pour les environnements d'entreprise soumis à des exigences de conformité. Pour son rôle dans la correction de la fenêtre d'un ID de modèle `[1m]` non reconnu, voir [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Définissez `1` pour désactiver le [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level) sur Opus 4.6 et Sonnet 4.6 et revenir au budget de réflexion fixe contrôlé par `MAX_THINKING_TOKENS`. Sans effet sur les [modèles Fable](/docs/fr/model-config#extended-thinking), Sonnet 5 et ultérieurs, ou Opus 4.7 et ultérieurs, qui utilisent toujours le raisonnement adaptatif |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Définissez sur `1` pour désactiver le [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level) sur Opus 4.6 et Sonnet 4.6 et revenir au budget de réflexion fixe contrôlé par `MAX_THINKING_TOKENS`. Sans effet sur les [modèles Fable](/docs/fr/model-config#extended-thinking), Sonnet 5 et versions ultérieures, ou Opus 4.7 et versions ultérieures, qui utilisent toujours le raisonnement adaptatif |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Définissez `1` pour empêcher Claude Code de fusionner clé par clé les blocs `env` des [paramètres gérés](/docs/fr/managed-settings#precedence-within-the-managed-tier) entre les sources d'administration, de sorte que seul le bloc `env` complet de la source la plus prioritaire s'applique, comme avant la v2.1.223. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.223 ou ultérieur |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Définissez sur `1` pour empêcher Claude Code de fusionner clé par clé les blocs `env` des [paramètres gérés](/docs/fr/managed-settings#precedence-within-the-managed-tier) provenant des différentes sources d'administration, de sorte que seul le bloc `env` complet de la source la plus prioritaire s'applique, comme avant la v2.1.223. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.223 ou version ultérieure |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Définissez `1` pour désactiver l'[outil advisor](/docs/fr/advisor). La commande `/advisor` devient indisponible, tout `advisorModel` configuré est ignoré, et le flag `--advisor` est accepté mais sans effet, de sorte que les scripts existants qui le transmettent continuent de fonctionner sans erreur |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Définissez sur `1` pour désactiver l'[outil advisor](/docs/fr/advisor). La commande `/advisor` devient indisponible, tout `advisorModel` configuré est ignoré, et le flag `--advisor` est accepté mais sans effet, de sorte que les scripts existants qui le transmettent continuent de fonctionner sans erreur |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Définissez `1` pour désactiver les [agents en arrière-plan et la vue des agents](/docs/fr/agent-view) : `claude agents`, `--bg`, `/background` et le superviseur à la demande. Équivalent au paramètre [`disableAgentView`](/docs/fr/settings-reference#disableagentview) |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Définissez sur `1` pour désactiver les [agents en arrière-plan et la vue des agents](/docs/fr/agent-view) : `claude agents`, `--bg`, `/background` et le superviseur à la demande. Équivalent au paramètre [`disableAgentView`](/docs/fr/settings-reference#disableagentview) |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Définissez `1` pour désactiver le [rendu plein écran](/docs/fr/fullscreen) et utiliser le moteur de rendu classique sur l'écran principal. La conversation reste dans l'historique de défilement natif de votre terminal, de sorte que `Cmd+f` et le mode copie de tmux fonctionnent normalement. Prioritaire sur `CLAUDE_CODE_NO_FLICKER` et le paramètre [`tui`](/docs/fr/settings-reference#tui). Vous pouvez également basculer avec `/tui default`. Ne s'applique pas aux sessions en arrière-plan ouvertes depuis la [vue des agents](/docs/fr/agent-view), qui utilisent toujours le rendu plein écran |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Définissez sur `1` pour désactiver le [rendu plein écran](/docs/fr/fullscreen) et utiliser le moteur de rendu classique sur l'écran principal. La conversation reste dans l'historique de défilement natif de votre terminal, afin que `Cmd+f` et le mode copie de tmux fonctionnent normalement. Prioritaire sur `CLAUDE_CODE_NO_FLICKER` et le paramètre [`tui`](/docs/fr/settings-reference#tui). Vous pouvez aussi basculer avec `/tui default`. Ne s'applique pas aux sessions en arrière-plan ouvertes depuis la [vue des agents](/docs/fr/agent-view), qui utilisent toujours le rendu plein écran |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Définissez `1` pour désactiver l'outil [Artifact](/docs/fr/artifacts), qui publie la sortie de la session sous forme de page web privée sur claude.ai. Une fois la variable définie, aucun fichier de paramètres ne peut réactiver l'outil. Pour désactiver plutôt l'outil depuis un fichier de paramètres, définissez [`enableArtifact`](/docs/fr/settings-reference#enableartifact) sur `false` ; la clé dépréciée [`disableArtifact`](/docs/fr/settings-reference#disableartifact) le désactive également |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Définissez sur `1` pour désactiver l'outil d'[artefacts](/docs/fr/artifacts), qui publie la sortie de la session sous forme de page web privée sur claude.ai. Une fois la variable définie, aucun fichier de paramètres ne peut réactiver l'outil. Pour désactiver plutôt l'outil depuis un fichier de paramètres, définissez [`enableArtifact`](/docs/fr/settings-reference#enableartifact) sur `false` ; la clé dépréciée [`disableArtifact`](/docs/fr/settings-reference#disableartifact) le désactive également |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Définissez `1` pour désactiver le traitement des pièces jointes. Les mentions de fichiers avec la syntaxe `@` sont envoyées en texte brut au lieu d'être développées en contenu de fichier |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Définissez sur `1` pour désactiver le traitement des pièces jointes. Les mentions de fichiers avec la syntaxe `@` sont envoyées en texte brut au lieu d'être développées en contenu de fichier |

248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Définissez `1` pour qu'un processus Claude Code exécute lui-même sa commande [`gcpAuthRefresh`](/docs/fr/settings-reference#gcpauthrefresh) ou [`awsAuthRefresh`](/docs/fr/settings-reference#awsauthrefresh) au lieu d'attendre qu'un autre processus l'exécute. Nécessite Claude Code v2.1.286 ou ultérieur |248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Définissez sur `1` pour qu'un processus Claude Code exécute lui-même sa commande [`gcpAuthRefresh`](/docs/fr/settings-reference#gcpauthrefresh) ou [`awsAuthRefresh`](/docs/fr/settings-reference#awsauthrefresh) au lieu d'attendre qu'un autre processus l'exécute. Nécessite Claude Code v2.1.286 ou version ultérieure |

249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Définissez `1` pour désactiver la [mémoire automatique](/docs/fr/memory#auto-memory). Définissez `0` pour forcer l'activation de la mémoire automatique même lorsque le mode `--bare` ou [`autoMemoryEnabled: false`](/docs/fr/settings-reference#automemoryenabled) la désactiverait autrement. Lorsqu'elle est désactivée, Claude ne crée ni ne charge de fichiers de mémoire automatique |249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Définissez sur `1` pour désactiver la [mémoire automatique](/docs/fr/memory#auto-memory). Définissez sur `0` pour forcer l'activation de la mémoire automatique même lorsque le mode `--bare` ou [`autoMemoryEnabled: false`](/docs/fr/settings-reference#automemoryenabled) la désactiverait autrement. Lorsqu'elle est désactivée, Claude ne crée ni ne charge de fichiers de mémoire automatique |

250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Définissez `1` pour désactiver toutes les fonctionnalités de tâches en arrière-plan, y compris le paramètre `run_in_background` des outils Bash et de sous-agent, la mise en arrière-plan automatique et le raccourci Ctrl+B |250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Définissez sur `1` pour désactiver toutes les fonctionnalités de tâches en arrière-plan, y compris le paramètre `run_in_background` des outils Bash et de sous-agent, la mise en arrière-plan automatique et le raccourci Ctrl+B |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Définissez `1` pour empêcher Claude Code de traiter une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) dont l'en-tête `Content-Type` est absent ou vide comme le flux d'événements binaire d'Amazon Bedrock. Par défaut, Claude Code suppose qu'une passerelle a supprimé l'en-tête d'une réponse par ailleurs non modifiée ; il décode donc le corps et le streaming continue de fonctionner. Ne la définissez que pour une passerelle qui réémet également le flux sous forme de server-sent events ; Claude Code lit alors le corps sans en-tête comme des server-sent events. Nécessite Claude Code v2.1.239 ou ultérieur |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Définissez sur `1` pour empêcher Claude Code de traiter une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) dont l'en-tête `Content-Type` est absent ou vide comme le flux d'événements binaire d'Amazon Bedrock. Par défaut, Claude Code suppose qu'une passerelle a supprimé l'en-tête d'une réponse par ailleurs non modifiée ; il décode donc le corps et le streaming continue de fonctionner. Ne définissez cette variable que pour une passerelle qui réémet également le flux sous forme de server-sent events ; Claude Code lit alors le corps sans en-tête comme des server-sent events. Nécessite Claude Code v2.1.239 ou version ultérieure |

252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Définissez `1` pour ignorer la vérification selon laquelle une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) porte le content-type `application/vnd.amazon.eventstream`. Sans cette variable, lorsqu'une réponse porte un autre content-type, Claude Code fait échouer la requête avec une erreur nommant ce type, ce qui signifie qu'une [passerelle ou un proxy transforme la réponse](/docs/fr/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configurez la passerelle pour qu'elle transmette l'en-tête `Content-Type` et le corps sans modification plutôt que de définir cette variable. Nécessite Claude Code v2.1.208 ou ultérieur |252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Définissez sur `1` pour ignorer la vérification selon laquelle une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) porte le content-type `application/vnd.amazon.eventstream`. Sans cette variable, lorsqu'une réponse porte un autre content-type, Claude Code fait échouer la requête avec une erreur indiquant ce type, ce qui signifie qu'une [passerelle ou un proxy transforme la réponse](/docs/fr/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configurez la passerelle pour qu'elle transmette l'en-tête `Content-Type` et le corps sans modification plutôt que de définir cette variable. Nécessite Claude Code v2.1.208 ou version ultérieure |

253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Définissez `1` pour arrêter les commandes shell en arrière-plan et les workflows dynamiques en cours d'une [session en arrière-plan](/docs/fr/agent-view), ainsi que, depuis la v2.1.198, ses sous-agents en arrière-plan, lorsque le [superviseur](/docs/fr/agent-view#the-supervisor-process) arrête, redémarre ou met à jour le processus de cette session, au lieu de les transmettre au processus suivant de la session. N'affecte que ce transfert : mettre une session en arrière-plan avec `←` ou [`/background`](/docs/fr/agent-view#from-inside-a-session) transfère toujours le travail en cours, et `CLAUDE_DISABLE_ADOPT` désactive les deux. Nécessite Claude Code v2.1.196 ou ultérieur |253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Définissez sur `1` pour arrêter les commandes shell en arrière-plan, les workflows dynamiques et, depuis la v2.1.198, les sous-agents en arrière-plan en cours d'exécution d'une [session en arrière-plan](/docs/fr/agent-view) lorsque le [superviseur](/docs/fr/agent-view#the-supervisor-process) arrête, redémarre ou met à jour le processus de cette session, au lieu de les transmettre au processus suivant de la session. N'affecte que cette transmission : mettre une session en arrière-plan avec `←` ou [`/background`](/docs/fr/agent-view#from-inside-a-session) transfère toujours le travail en cours, et `CLAUDE_DISABLE_ADOPT` désactive les deux. Nécessite Claude Code v2.1.196 ou version ultérieure |

254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Définissez `1` pour empêcher Claude Code de terminer les [commandes shell en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) en cas de pression mémoire. Par défaut, sous macOS et Linux, Claude Code termine les shells en arrière-plan lorsque le système d'exploitation signale une pression mémoire critique et que la session est inactive depuis 30 minutes sans tour ni sous-agent en cours. Windows n'a pas de signal de pression mémoire, cette variable n'y a donc aucun effet. Nécessite Claude Code v2.1.193 ou ultérieur |254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Définissez sur `1` pour empêcher Claude Code de terminer les [commandes shell en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) en cas de pression mémoire. Par défaut, sous macOS et Linux, Claude Code termine les shells en arrière-plan lorsque le système d'exploitation signale une pression mémoire critique et que la session est inactive depuis 30 minutes, sans tour ni sous-agent en cours. Windows ne dispose pas de signal de pression mémoire, cette variable n'y a donc aucun effet. Nécessite Claude Code v2.1.193 ou version ultérieure |

255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Définissez `1` pour désactiver les [skills](/docs/fr/skills) et workflows inclus avec Claude Code : les skills et workflows fournis sont entièrement supprimés, tandis que les commandes intégrées comme `/init` restent saisissables mais sont masquées pour le modèle. `/doctor` reste saisissable comme les commandes intégrées ; masquez-la plutôt avec `DISABLE_DOCTOR_COMMAND`. Les skills provenant des plugins, de `.claude/skills/` et de `.claude/commands/` ne sont pas affectés. Équivalent au paramètre [`disableBundledSkills`](/docs/fr/settings-reference#disablebundledskills) |255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Définissez sur `1` pour désactiver les [skills](/docs/fr/skills) et workflows inclus avec Claude Code : les skills et workflows fournis sont entièrement supprimés, tandis que les commandes intégrées comme `/init` restent saisissables mais sont masquées au modèle. `/doctor` reste saisissable comme les commandes intégrées ; masquez-la plutôt avec `DISABLE_DOCTOR_COMMAND`. Les skills provenant des plugins, de `.claude/skills/` et de `.claude/commands/` ne sont pas affectés. Équivalent au paramètre [`disableBundledSkills`](/docs/fr/settings-reference#disablebundledskills) |

256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Définissez `1` pour conserver les outils de navigateur [Claude in Chrome](/docs/fr/chrome) tout en omettant la section Chrome du prompt système et le [skill fourni](/docs/fr/skills#bundled-skills) `/claude-in-chrome`. Destiné aux hôtes qui intègrent Claude Code et fournissent leurs propres instructions de navigation. Nécessite Claude Code v2.1.257 ou ultérieur |256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Définissez sur `1` pour conserver les outils de navigateur [Claude in Chrome](/docs/fr/chrome) disponibles tout en omettant la section Chrome du prompt système et le [skill fourni](/docs/fr/skills#bundled-skills) `/claude-in-chrome`. Destinée aux hôtes qui intègrent Claude Code et fournissent leurs propres instructions de navigation. Nécessite Claude Code v2.1.257 ou version ultérieure |

257| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Définissez `1` pour empêcher le chargement de tout fichier mémoire CLAUDE.md dans le contexte, y compris les fichiers de mémoire utilisateur, de projet et de mémoire automatique |257| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Définissez sur `1` pour empêcher le chargement de tout fichier de mémoire CLAUDE.md dans le contexte, y compris les fichiers de mémoire utilisateur, de projet et de mémoire automatique |

258| `CLAUDE_CODE_DISABLE_CRON` | Définissez `1` pour désactiver les [tâches planifiées](/docs/fr/scheduled-tasks). Le skill `/loop` et les outils cron deviennent indisponibles et toutes les tâches déjà planifiées cessent de se déclencher, y compris celles déjà en cours d'exécution en cours de session |258| `CLAUDE_CODE_DISABLE_CRON` | Définissez sur `1` pour désactiver les [tâches planifiées](/docs/fr/scheduled-tasks). Le skill `/loop` et les outils cron deviennent indisponibles et toutes les tâches déjà planifiées cessent de se déclencher, y compris celles déjà en cours d'exécution en cours de session |

259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Définissez `1` pour désactiver la limite de temps sur les demandes de permission de [suppression de chemins critiques](/docs/fr/permission-modes#critical-paths). En mode `auto`, Claude Code envoie alors ces suppressions au classifieur, et en mode `bypassPermissions`, la demande attend votre réponse. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.281 ou ultérieur |259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Définissez sur `1` pour désactiver la limite de temps des demandes de permission de [suppression de chemins critiques](/docs/fr/permission-modes#critical-paths). En mode `auto`, Claude Code envoie alors ces suppressions au classifieur, et en mode `bypassPermissions`, la demande attend votre réponse. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.281 ou version ultérieure |

260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Définissez `1` pour retirer des requêtes API les en-têtes de requête `anthropic-beta` de préversion, les champs de corps qui les accompagnent, et les champs bêta de schéma d'outil tels que `defer_loading` et `eager_input_streaming`. Utilisez-la lorsqu'une passerelle proxy rejette les requêtes avec une erreur `Unexpected value(s)` pour l'en-tête `anthropic-beta` ou une erreur `Extra inputs are not permitted`. [Désactiver les capacités de préversion](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) liste ce que la variable supprime, y compris [la recherche d'outils MCP](/docs/fr/mcp#scale-with-mcp-tool-search), et ce que Claude Code continue d'envoyer |260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Définissez sur `1` pour retirer des requêtes API les en-têtes de requête `anthropic-beta` en préversion, les champs de corps qui leur sont associés et les champs bêta de schéma d'outil comme `defer_loading` et `eager_input_streaming`. Utilisez-la lorsqu'une passerelle proxy rejette les requêtes avec une erreur `Unexpected value(s)` pour l'en-tête `anthropic-beta` ou une erreur `Extra inputs are not permitted`. [Désactiver les capacités en préversion](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) indique ce que la variable supprime, y compris [MCP Tool Search](/docs/fr/mcp#scale-with-mcp-tool-search), et ce que Claude Code continue d'envoyer |

261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Définissez `1` pour désactiver les [sous-agents Explore et Plan](/docs/fr/sub-agents#built-in-subagents) intégrés. Claude explore alors avec ses outils de recherche ou le sous-agent general-purpose, et le [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) lit les fichiers directement au lieu de lancer les agents Explore et Plan. Les sous-agents personnalisés nommés `Explore` ou `Plan` ne sont pas affectés. Pour supprimer tous les types de sous-agents intégrés dans l'Agent SDK ou en mode non interactif, utilisez plutôt `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Nécessite Claude Code v2.1.198 ou ultérieur |261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Définissez sur `1` pour désactiver les [sous-agents Explore et Plan](/docs/fr/sub-agents#built-in-subagents) intégrés. Claude explore alors avec ses outils de recherche ou le sous-agent general-purpose, et le [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) lit les fichiers directement plutôt que de lancer les agents Explore et Plan. Les sous-agents personnalisés nommés `Explore` ou `Plan` ne sont pas affectés. Pour supprimer tous les types de sous-agents intégrés dans l'Agent SDK ou en mode non interactif, utilisez plutôt `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Nécessite Claude Code v2.1.198 ou version ultérieure |

262| `CLAUDE_CODE_DISABLE_FAST_MODE` | Définissez `1` pour désactiver le [mode rapide](/docs/fr/fast-mode) |262| `CLAUDE_CODE_DISABLE_FAST_MODE` | Définissez sur `1` pour désactiver le [mode rapide](/docs/fr/fast-mode) |

263| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Définissez `1` pour désactiver les enquêtes de qualité de session « How is Claude doing? ». Les enquêtes sont également désactivées lorsque `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est défini, sauf si `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` les réactive. Pour définir un taux d'échantillonnage au lieu de les désactiver complètement, utilisez le paramètre [`feedbackSurveyRate`](/docs/fr/settings-reference#feedbacksurveyrate). Voir [Enquêtes de qualité de session](/docs/fr/data-usage#session-quality-surveys) |263| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Définissez sur `1` pour désactiver les enquêtes de qualité de session « How is Claude doing? ». Les enquêtes sont également désactivées lorsque `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est définie, sauf si `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` les réactive. Pour définir un taux d'échantillonnage plutôt que de les désactiver complètement, utilisez le paramètre [`feedbackSurveyRate`](/docs/fr/settings-reference#feedbacksurveyrate). Voir [Enquêtes de qualité de session](/docs/fr/data-usage#session-quality-surveys) |

264| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Définissez `1` pour désactiver le [checkpointing](/docs/fr/checkpointing) des fichiers. La commande `/rewind` ne pourra pas restaurer les modifications de code. Remplace le paramètre [`fileCheckpointingEnabled`](/docs/fr/settings-reference#filecheckpointingenabled) |264| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Définissez sur `1` pour désactiver le [checkpointing](/docs/fr/checkpointing) des fichiers. La commande `/rewind` ne pourra pas restaurer les modifications de code. Remplace le paramètre [`fileCheckpointingEnabled`](/docs/fr/settings-reference#filecheckpointingenabled) |

265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Définissez `1` pour retirer du contexte de Claude les instructions intégrées de workflow de commit et de PR ainsi que l'instantané du statut git. Utile lorsque vous utilisez vos propres skills de workflow git. Lorsqu'elle est définie, elle est prioritaire sur le paramètre [`includeGitInstructions`](/docs/fr/settings-reference#includegitinstructions) |265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Définissez sur `1` pour retirer du contexte de Claude les instructions intégrées de workflow de commit et de PR ainsi que l'instantané du statut git. Utile lorsque vous utilisez vos propres skills de workflow git. Prioritaire sur le paramètre [`includeGitInstructions`](/docs/fr/settings-reference#includegitinstructions) lorsqu'elle est définie |

266| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Définissez `1` pour empêcher le remappage automatique d'Opus 4.0 et 4.1 vers la version actuelle d'Opus sur l'API Anthropic. À utiliser lorsque vous souhaitez délibérément épingler un ancien modèle. Le remappage ne s'exécute pas sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry |266| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | Définissez sur `1` pour empêcher Claude Code d'analyser les scripts passés à un shell avec `-c`, comme `bash -c 'rm -rf ~'`, à la recherche de suppressions de [chemins critiques](/docs/fr/permission-modes#removals-inside-nested-commands-and-inline-scripts). Claude Code vérifie toujours les cibles sous forme de variables shell et de paramètres positionnels dans ces scripts, et les autres vérifications de chemins critiques continuent de s'exécuter. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.288 ou version ultérieure |

267| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Définissez `1` pour empêcher Claude Code, sur [Amazon Bedrock](/docs/fr/amazon-bedrock#when-a-model-is-disabled-mid-session) et [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai#when-a-model-is-disabled-mid-session), de basculer vers un modèle plus ancien lorsque votre compte perd l'accès au modèle d'une session en cours de session ; la requête refusée échoue alors immédiatement. Une [chaîne de modèles de secours](/docs/fr/model-config#fallback-model-chains) que vous configurez bascule toujours lors de ce refus, et les [vérifications de modèle au démarrage](/docs/fr/amazon-bedrock#startup-model-checks) se rabattent toujours sur un autre modèle au lancement. Nécessite Claude Code v2.1.285 ou ultérieur |267| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Définissez sur `1` pour empêcher le remappage automatique d'Opus 4.0 et 4.1 vers la version actuelle d'Opus sur l'API Anthropic. À utiliser lorsque vous souhaitez volontairement épingler un modèle plus ancien. Le remappage ne s'exécute pas sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry |

268| `CLAUDE_CODE_DISABLE_MOUSE` | Définissez `1` pour désactiver le suivi de la souris en [rendu plein écran](/docs/fr/fullscreen). Le défilement au clavier avec `PgUp` et `PgDn` fonctionne toujours. Utilisez-la pour conserver le comportement natif de copie à la sélection de votre terminal |268| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Définissez sur `1` pour empêcher Claude Code, sur [Amazon Bedrock](/docs/fr/amazon-bedrock#when-a-model-is-disabled-mid-session) et [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai#when-a-model-is-disabled-mid-session), de basculer vers un modèle plus ancien lorsque votre compte perd l'accès au modèle d'une session en cours de session ; la requête refusée échoue alors immédiatement. Une [chaîne de modèles de secours](/docs/fr/model-config#fallback-model-chains) que vous configurez bascule toujours lors de ce refus, et les [vérifications de modèle au démarrage](/docs/fr/amazon-bedrock#startup-model-checks) se rabattent toujours sur un autre modèle au lancement. Nécessite Claude Code v2.1.285 ou version ultérieure |

269| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Définissez `1` pour désactiver la gestion des clics, du glisser et du survol en [rendu plein écran](/docs/fr/fullscreen) tout en conservant le défilement à la molette. Utilisez-la lorsque vous souhaitez que le défilement à la molette fonctionne dans Claude Code sans que les clics positionnent le curseur, développent la sortie des outils ou ouvrent des liens. `CLAUDE_CODE_DISABLE_MOUSE` est prioritaire lorsque les deux sont définies. Nécessite Claude Code v2.1.195 ou ultérieur |269| `CLAUDE_CODE_DISABLE_MOUSE` | Définissez sur `1` pour désactiver le suivi de la souris en [rendu plein écran](/docs/fr/fullscreen). Le défilement au clavier avec `PgUp` et `PgDn` fonctionne toujours. Utilisez-la pour conserver le comportement natif de copie à la sélection de votre terminal |

270| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Définissez `1` pour empêcher Claude Code de relire le [certificat et la clé client mTLS](/docs/fr/network-config#mtls-authentication) lorsqu'une requête API échoue avec une erreur au niveau de la connexion, comme une réinitialisation de connexion ou une erreur de handshake TLS. Avec le rechargement désactivé, Claude Code ne charge les fichiers renouvelés que la prochaine fois qu'il applique les paramètres ou au prochain démarrage. Nécessite Claude Code v2.1.232 ou ultérieur |270| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Définissez sur `1` pour désactiver la gestion des clics, du glisser et du survol en [rendu plein écran](/docs/fr/fullscreen) tout en conservant le défilement à la molette. Utilisez-la lorsque vous voulez que le défilement à la molette fonctionne dans Claude Code sans que les clics positionnent le curseur, développent la sortie des outils ou ouvrent des liens. `CLAUDE_CODE_DISABLE_MOUSE` est prioritaire lorsque les deux sont définies. Nécessite Claude Code v2.1.195 ou version ultérieure |

271| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Définissez une valeur non vide quelconque, comme `1`, pour désactiver le trafic réseau non essentiel : mises à jour automatiques, télémétrie, rapports d'erreurs, la commande `/feedback`, les [retours rédigés par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior), les notes de version, les vérifications du [badge de statut des PR et MR](/docs/fr/interactive-mode#pr-review-status) et les vérifications de disponibilité telles que celle du [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Elle arrête également les [exécutions en arrière-plan des sources `command` de plugins](/docs/fr/plugins/loading#when-a-command-source-re-runs), qui sont des commandes locales plutôt que du trafic réseau, car elles peuvent déclencher des installations de dépendances. **La définir à `0` ou `false` désactive tout de même ce trafic**, contrairement à la plupart des variables d'activation ; supprimez la variable pour l'autoriser à nouveau. Désactive également la récupération des feature flags, ce qui rend indisponibles [Remote Control](/docs/fr/remote-control#requirements) et les autres [fonctionnalités nécessitant la récupération des feature flags](#features-that-need-feature-flag-fetching). L'installation automatique de la marketplace de plugins officielle n'est pas concernée ; désactivez-la avec `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. N'affecte pas la [découverte des modèles de passerelle](/docs/fr/llm-gateway-connect#add-gateway-models-to-the-model-picker), qui dispose de sa propre activation |271| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Définissez sur `1` pour empêcher Claude Code de relire le [certificat client et la clé mTLS](/docs/fr/network-config#mtls-authentication) lorsqu'une requête API échoue avec une erreur au niveau de la connexion, comme une réinitialisation de connexion ou une erreur de handshake TLS. Lorsque le rechargement est désactivé, Claude Code ne charge les fichiers renouvelés que lors de la prochaine application des paramètres ou au prochain démarrage. Nécessite Claude Code v2.1.232 ou version ultérieure |

272| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Définissez `1` pour désactiver la solution de repli sans streaming lorsqu'une requête en streaming échoue en cours de flux. Les erreurs de streaming sont alors transmises à la couche de nouvelles tentatives. Utile lorsqu'un proxy ou une passerelle amène la solution de repli à exécuter des outils en double |272| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour désactiver le trafic réseau non essentiel : mises à jour automatiques, télémétrie, rapports d'erreurs, la commande `/feedback`, les [retours rédigés par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior), les notes de version, les vérifications du [badge de statut des PR et MR](/docs/fr/interactive-mode#pr-review-status) et les vérifications de disponibilité comme celle du [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Elle arrête également les [exécutions en arrière-plan des sources `command` des plugins](/docs/fr/plugins/loading#when-a-command-source-re-runs), qui sont des commandes locales plutôt que du trafic réseau, car elles peuvent déclencher des installations de dépendances. **La définir sur `0` ou `false` désactive tout de même ce trafic**, contrairement à la plupart des variables d'activation ; supprimez la variable pour l'autoriser à nouveau. Désactive également la récupération des feature flags, ce qui rend indisponibles [Remote Control](/docs/fr/remote-control#requirements) et les autres [fonctionnalités nécessitant la récupération des feature flags](#features-that-need-feature-flag-fetching). L'installation automatique de la marketplace de plugins officielle n'est pas concernée ; désactivez-la avec `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. N'affecte pas la [découverte des modèles de la passerelle](/docs/fr/llm-gateway-connect#add-gateway-models-to-the-model-picker), qui dispose de sa propre activation |

273| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Définissez `1` pour envoyer la notification de bureau de l'outil `PushNotification` même lorsque vous tapez dans le terminal ou que celui-ci a le focus. Par défaut, l'outil ignore à la fois la notification de bureau et la [notification push mobile](/docs/fr/remote-control#mobile-push-notifications) lorsqu'il détecte une activité récente du clavier ou le focus du terminal. Cette variable désactive uniquement cette vérification locale ; le serveur peut donc toujours supprimer la notification push mobile lorsqu'il détecte que vous êtes actif. Nécessite Claude Code v2.1.193 ou ultérieur |273| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Définissez sur `1` pour désactiver la solution de repli sans streaming lorsqu'une requête en streaming échoue en cours de flux. Les erreurs de streaming sont alors propagées à la couche de nouvelles tentatives. Utile lorsqu'un proxy ou une passerelle amène la solution de repli à exécuter des outils en double |

274| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Définissez `1` pour désactiver l'enregistrement automatique de la marketplace de plugins officielle. Claude Code lit la variable au moment d'enregistrer la marketplace, généralement lors du premier lancement interactif sur une machine. Si la variable est définie à ce moment-là, Claude Code ignore définitivement l'enregistrement. Supprimer la variable ultérieurement n'annule pas cet abandon. Exécutez `claude plugin marketplace add anthropics/claude-plugins-official` pour enregistrer la marketplace à tout moment |274| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Définissez sur `1` pour envoyer la notification de bureau de l'outil `PushNotification` même lorsque vous tapez dans le terminal ou que celui-ci a le focus. Par défaut, l'outil n'envoie ni la notification de bureau ni la [notification push mobile](/docs/fr/remote-control#mobile-push-notifications) lorsqu'il détecte une activité clavier récente ou le focus du terminal. Cette variable désactive uniquement cette vérification locale ; le serveur peut donc toujours supprimer la notification push mobile lorsqu'il détecte que vous êtes actif. Nécessite Claude Code v2.1.193 ou version ultérieure |

275| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Définissez `1` pour empêcher Claude Code d'exécuter vos [hooks `Notification` pour les demandes de permission sans réponse](/docs/fr/hooks#notification) dans les sessions où Claude Code les envoie au callback `canUseTool` de l'Agent SDK, ce qui correspond à la façon dont Claude Desktop et l'extension VS Code hébergent Claude Code. Sans effet dans les sessions de terminal. Nécessite Claude Code v2.1.233 ou ultérieur |275| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Définissez sur `1` pour désactiver l'enregistrement automatique de la marketplace de plugins officielle. Claude Code lit la variable au moment d'enregistrer la marketplace, généralement lors du premier lancement interactif sur une machine. Si la variable est définie à ce moment-là, Claude Code ignore définitivement l'enregistrement. Supprimer la variable par la suite n'annule pas cet abandon. Exécutez `claude plugin marketplace add anthropics/claude-plugins-official` pour enregistrer la marketplace à tout moment |

276| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Définissez `1` pour ne pas charger les skills du répertoire de skills gérés à l'échelle du système. Utile pour les sessions en conteneur ou en CI qui ne doivent pas charger les skills provisionnés par l'opérateur |276| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Définissez sur `1` pour empêcher Claude Code d'exécuter vos [hooks `Notification` pour les demandes de permission sans réponse](/docs/fr/hooks#notification) dans les sessions où Claude Code envoie ces demandes au callback `canUseTool` de l'Agent SDK, ce qui correspond à la manière dont Claude Desktop et l'extension VS Code hébergent Claude Code. Sans effet dans les sessions de terminal. Nécessite Claude Code v2.1.233 ou version ultérieure |

277| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Définissez `1` pour désactiver la vérification de l'[outil PowerShell](/docs/fr/tools-reference#powershell-tool) qui refuse les commandes intégrées `cmd` `rd`, `rmdir`, `del` et `erase` sur un [chemin système](/docs/fr/permission-modes#remove-item-in-powershell), comme la racine d'un lecteur ou votre répertoire personnel. Claude Code ignore cette variable dans le bloc `env` d'un fichier de paramètres. Nécessite Claude Code v2.1.283 ou ultérieur |277| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Définissez sur `1` pour ne pas charger les skills depuis le répertoire de skills gérés à l'échelle du système. Utile pour les sessions en conteneur ou en CI qui ne doivent pas charger les skills provisionnés par l'opérateur |

278| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Définissez `1` pour empêcher Claude Code d'envoyer le champ de sortie structurée `output_config.format` et la valeur `anthropic-beta` associée, pour une [passerelle LLM](/docs/fr/llm-gateway-protocol#feature-pass-through) dont l'amont les rejette. Cela laisse activées les autres capacités de préversion que [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) désactive. Nécessite Claude Code v2.1.288 ou ultérieur |278| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Définissez sur `1` pour désactiver la vérification de l'[outil PowerShell](/docs/fr/tools-reference#powershell-tool) qui refuse les commandes intégrées `cmd` `rd`, `rmdir`, `del` et `erase` sur un [chemin système](/docs/fr/permission-modes#remove-item-in-powershell), comme la racine d'un lecteur ou votre répertoire personnel. Claude Code ignore cette variable dans le bloc `env` d'un fichier de paramètres. Nécessite Claude Code v2.1.283 ou version ultérieure |

279| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Définissez `1` pour désactiver la vérification de [chemin critique](/docs/fr/permission-modes#critical-paths) pour un `rm` récursif dont la cible est entièrement la sortie d'une substitution de commande, comme `rm -rf "$(pwd)"`. Les autres vérifications de chemins critiques continuent de s'exécuter. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.281 ou ultérieur |279| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | Définissez sur `1` pour désactiver le [changement automatique de modèle lorsqu'un classifieur de sécurité signale une requête](/docs/fr/model-config#automatic-model-fallback), comportement contrôlé par le paramètre [`switchModelsOnFlag`](/docs/fr/settings-reference#switchmodelsonflag) |

280| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Définissez `1` pour désactiver les mises à jour automatiques du titre du terminal basées sur le contexte de la conversation. Cela ignore également la requête en arrière-plan au modèle small/fast qui [génère un titre de session](/docs/fr/sessions#name-your-sessions) |280| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Définissez sur `1` pour empêcher Claude Code d'envoyer le champ de sortie structurée `output_config.format` et la valeur `anthropic-beta` qui lui est associée, pour une [passerelle LLM](/docs/fr/llm-gateway-protocol#feature-pass-through) dont le service en amont les rejette. Cela laisse actives les autres capacités en préversion que [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) désactive. Nécessite Claude Code v2.1.288 ou version ultérieure |

281| `CLAUDE_CODE_DISABLE_THINKING` | Définissez `1` pour omettre entièrement le paramètre `thinking` des requêtes API. Il s'agit d'une option de compatibilité pour les proxys et passerelles qui rejettent ce paramètre. Sur les modèles qui réfléchissent par défaut, omettre le paramètre signifie que le modèle peut toujours réfléchir. Pour désactiver explicitement la [réflexion étendue](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sur l'API Anthropic, utilisez plutôt `MAX_THINKING_TOKENS=0`. Aucune des deux variables ne désactive la réflexion sur Opus 5.5, Sonnet 5.5 ou les modèles Fable, sur lesquels la réflexion ne peut pas être désactivée. Chez les [fournisseurs tiers](/docs/fr/third-party-integrations), `MAX_THINKING_TOKENS=0` omet également le paramètre, de sorte que les deux variables s'y comportent de la même manière |281| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Définissez sur `1` pour désactiver la vérification de [chemin critique](/docs/fr/permission-modes#critical-paths) pour un `rm` récursif dont la cible est entièrement la sortie d'une substitution de commande, comme `rm -rf "$(pwd)"`. Les autres vérifications de chemins critiques continuent de s'exécuter. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc `env` de paramètres. Nécessite Claude Code v2.1.281 ou version ultérieure |

282| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Définissez `1` pour ignorer la [compaction automatique](/docs/fr/costs#reduce-token-usage) proactive lorsque Claude Code ne reconnaît pas l'ID du modèle, comme un alias de [passerelle LLM](/docs/fr/llm-gateway). Sans cette variable, Claude Code compacte selon la fenêtre de contexte qu'il suppose pour l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` peut plutôt corriger la fenêtre supposée ; voir [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id) pour savoir quand chaque variable s'applique. Nécessite Claude Code v2.1.223 ou ultérieur |282| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Définissez sur `1` pour désactiver la mise à jour automatique du titre du terminal en fonction du contexte de la conversation. Cela supprime également la requête en arrière-plan au modèle small/fast qui [génère un titre de session](/docs/fr/sessions#name-your-sessions) |

283| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Définissez `1` pour désactiver le défilement virtuel en [rendu plein écran](/docs/fr/fullscreen) et afficher chaque message de la transcription. Utilisez-la si le défilement en mode plein écran affiche des zones vides là où des messages devraient apparaître |283| `CLAUDE_CODE_DISABLE_THINKING` | Définissez sur `1` pour omettre entièrement le paramètre `thinking` des requêtes API. Il s'agit d'une option de compatibilité pour les proxys et passerelles qui rejettent ce paramètre. Sur les modèles qui réfléchissent par défaut, omettre le paramètre signifie que le modèle peut tout de même réfléchir. Pour désactiver explicitement la [réflexion étendue](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sur l'API Anthropic, utilisez plutôt `MAX_THINKING_TOKENS=0`. Aucune des deux variables ne désactive la réflexion sur Opus 5.5, Sonnet 5.5 ou les modèles Fable, sur lesquels la réflexion ne peut pas être désactivée. Chez les [fournisseurs tiers](/docs/fr/third-party-integrations), `MAX_THINKING_TOKENS=0` omet également le paramètre, de sorte que les deux variables s'y comportent de la même manière |

284| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Définissez `1` pour désactiver l'outil [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior). L'outil [WebSearch](/docs/fr/tools-reference#websearch-tool-behavior) reste disponible. Nécessite Claude Code v2.1.285 ou ultérieur |284| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Définissez sur `1` pour désactiver la [compaction automatique](/docs/fr/costs#reduce-token-usage) proactive lorsque Claude Code ne reconnaît pas l'ID du modèle, comme un alias de [passerelle LLM](/docs/fr/llm-gateway). Sans cette variable, Claude Code compacte selon la fenêtre de contexte qu'il suppose pour cet ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` peut plutôt corriger la fenêtre supposée ; voir [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id) pour savoir quand chaque variable s'applique. Nécessite Claude Code v2.1.223 ou version ultérieure |

285| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Définissez `1` pour démarrer directement les commandes de l'[outil PowerShell](/docs/fr/tools-reference#powershell-tool) sous Windows au lieu de passer par le lanceur `cmd.exe`. Par défaut, le lanceur permet à une commande PowerShell [exécutée en arrière-plan](/docs/fr/tools-reference#background-commands) d'être [transférée au processus suivant de la session](/docs/fr/agent-view#the-supervisor-process), par exemple lorsque vous [mettez la session en arrière-plan](/docs/fr/agent-view#from-inside-a-session). Si vous définissez la variable, une commande PowerShell en arrière-plan s'arrête lorsque le processus de la session se termine. Les commandes Bash ne sont pas affectées. Nécessite Claude Code v2.1.269 ou ultérieur |285| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Définissez sur `1` pour désactiver le défilement virtuel en [rendu plein écran](/docs/fr/fullscreen) et afficher chaque message de la transcription. Utilisez-la si le défilement en mode plein écran affiche des zones vides là où des messages devraient apparaître |

286| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Définissez `1` pour désactiver les [workflows](/docs/fr/workflows#turn-workflows-off). Équivalent au paramètre [`disableWorkflows`](/docs/fr/settings-reference#disableworkflows) |286| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Définissez sur `1` pour désactiver l'outil [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior). L'outil [WebSearch](/docs/fr/tools-reference#websearch-tool-behavior) reste disponible. Nécessite Claude Code v2.1.285 ou version ultérieure |

287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Définissez sur `1` pour démarrer directement les commandes de l'[outil PowerShell](/docs/fr/tools-reference#powershell-tool) sous Windows plutôt que via le lanceur `cmd.exe`. Par défaut, le lanceur permet à une commande PowerShell [exécutée en arrière-plan](/docs/fr/tools-reference#background-commands) d'[être transférée au processus suivant de la session](/docs/fr/agent-view#the-supervisor-process), par exemple lorsque vous [mettez la session en arrière-plan](/docs/fr/agent-view#from-inside-a-session). Si vous définissez la variable, une commande PowerShell en arrière-plan s'arrête lorsque le processus de la session se termine. Les commandes Bash ne sont pas affectées. Nécessite Claude Code v2.1.269 ou version ultérieure |

288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Définissez sur `1` pour désactiver les [workflows](/docs/fr/workflows#turn-workflows-off). Équivalent au paramètre [`disableWorkflows`](/docs/fr/settings-reference#disableworkflows) |

287| `CLAUDE_CODE_EFFORT_LEVEL` | Définit le niveau d'effort pour les modèles pris en charge. Valeurs : `low`, `medium`, `high`, `xhigh`, `max`, ou `auto` pour utiliser la valeur par défaut du modèle. Les niveaux disponibles dépendent du modèle. Prioritaire sur `--effort`, `/effort` et les paramètres `modelSettings` et `effortLevel`. Un plafond [`maxEffortLevel`](/docs/fr/settings-reference#maxeffortlevel) s'applique toujours. Voir [Ajuster le niveau d'effort](/docs/fr/model-config#adjust-effort-level) |289| `CLAUDE_CODE_EFFORT_LEVEL` | Définit le niveau d'effort pour les modèles pris en charge. Valeurs : `low`, `medium`, `high`, `xhigh`, `max`, ou `auto` pour utiliser la valeur par défaut du modèle. Les niveaux disponibles dépendent du modèle. Prioritaire sur `--effort`, `/effort` et les paramètres `modelSettings` et `effortLevel`. Un plafond [`maxEffortLevel`](/docs/fr/settings-reference#maxeffortlevel) s'applique toujours. Voir [Ajuster le niveau d'effort](/docs/fr/model-config#adjust-effort-level) |

288| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Acceptée pour la compatibilité avec les versions antérieures et sans effet. Le mode auto est disponible par défaut chez tous les fournisseurs, y compris Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions [Claude apps gateway](/docs/fr/claude-apps-gateway) connectées. De la v2.1.158 à la v2.1.206, définir cette variable à `1` était nécessaire pour rendre le [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) disponible chez ces fournisseurs |290| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Acceptée pour des raisons de compatibilité avec les versions antérieures, sans effet. Le mode auto est disponible par défaut sur tous les fournisseurs, y compris Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions connectées de la [passerelle des applications Claude](/docs/fr/claude-apps-gateway). Des versions v2.1.158 à v2.1.206, il fallait définir cette variable sur `1` pour rendre le [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) disponible sur ces fournisseurs |

289| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Remplace la disponibilité du [récapitulatif de session](/docs/fr/interactive-mode#session-recap). Définissez `0` pour forcer la désactivation des récapitulatifs quel que soit le réglage `/config`. Définissez `1` pour forcer leur activation lorsque [`awaySummaryEnabled`](/docs/fr/settings-reference#awaysummaryenabled) vaut `false`. Prioritaire sur le paramètre et le réglage `/config` |291| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Remplace la disponibilité du [récapitulatif de session](/docs/fr/interactive-mode#session-recap). Définissez sur `0` pour forcer la désactivation des récapitulatifs, quel que soit le bouton bascule de `/config`. Définissez sur `1` pour forcer leur activation lorsque [`awaySummaryEnabled`](/docs/fr/settings-reference#awaysummaryenabled) vaut `false`. A priorité sur le paramètre et sur le bouton bascule de `/config` |

290| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Définir sur `1` pour actualiser l'état des plugins aux limites de tour en [mode non interactif](/docs/fr/headless) après la fin d'une installation en arrière-plan. Désactivé par défaut, car l'actualisation modifie le prompt système en cours de session, ce qui invalide le [prompt caching](/docs/fr/prompt-caching) pour ce tour |292| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Définissez sur `1` pour actualiser l'état des plugins entre les tours en [mode non interactif](/docs/fr/headless) après la fin d'une installation en arrière-plan. Désactivée par défaut, car l'actualisation modifie le prompt système en cours de session, ce qui invalide le [prompt caching](/docs/fr/prompt-caching) pour ce tour |

291| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Définir sur `1` pour acheminer l'enquête de qualité de session « How is Claude doing? » vers votre propre [collecteur OpenTelemetry](/docs/fr/monitoring-usage) lorsque le trafic non essentiel destiné à Anthropic est bloqué. Les évaluations de l'enquête sont émises uniquement sous forme d'événements OTEL vers votre collecteur configuré. Aucune donnée d'enquête n'est envoyée à Anthropic dans ce mode. S'applique lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, et n'a aucun effet sinon. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` et la politique de feedback produit de l'organisation ont priorité |293| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Définissez sur `1` pour acheminer l'enquête de qualité de session « How is Claude doing? » vers votre propre [collecteur OpenTelemetry](/docs/fr/monitoring-usage) lorsque le trafic non essentiel destiné à Anthropic est bloqué. Les évaluations de l'enquête sont émises uniquement sous forme d'événements OTEL vers votre collecteur configuré. Aucune donnée d'enquête n'est envoyée à Anthropic dans ce mode. S'applique lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, et n'a aucun effet sinon. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` et la politique de feedback produit de l'organisation ont priorité |

292| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Contrôle si les entrées des appels d'outils sont diffusées en streaming depuis l'API au fur et à mesure que Claude les génère. Lorsque cette option est désactivée, une entrée d'outil volumineuse, comme l'écriture d'un long fichier, n'arrive qu'une fois que Claude a fini de la générer, ce qui peut donner l'impression d'un blocage. Activé par défaut sur l'API Anthropic. Sur Amazon Bedrock et Google Cloud's Agent Platform, activé par modèle lorsque le conteneur déployé le prend en charge. Définir sur `0` pour le désactiver. Définir sur `1` pour forcer l'activation lors du routage via un proxy avec `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Désactivé par défaut sur Microsoft Foundry et les connexions via une [passerelle](/docs/fr/llm-gateway) |294| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Détermine si les entrées des appels d'outils sont diffusées en streaming depuis l'API à mesure que Claude les génère. Lorsque cette option est désactivée, une entrée d'outil volumineuse, comme l'écriture d'un long fichier, n'arrive qu'une fois que Claude a fini de la générer, ce qui peut donner l'impression d'un blocage. Activée par défaut sur l'API Anthropic. Sur Amazon Bedrock et Google Cloud's Agent Platform, activée par modèle lorsque le conteneur déployé la prend en charge. Définissez sur `0` pour la désactiver. Définissez sur `1` pour forcer son activation lors du routage via un proxy avec `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Désactivée par défaut sur Microsoft Foundry et pour les connexions via une [passerelle](/docs/fr/llm-gateway) |

293| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Définir sur `1` pour alimenter le sélecteur `/model` à partir de l'endpoint `/v1/models` de votre passerelle lorsque `ANTHROPIC_BASE_URL` pointe vers une passerelle compatible Anthropic telle que LiteLLM, Kong ou un proxy interne. Désactivé par défaut, car les passerelles reposant sur une clé API partagée montreraient sinon à chaque utilisateur tous les modèles auxquels la clé peut accéder. Les modèles découverts restent filtrés par une liste d'autorisation [`availableModels`](/docs/fr/settings-reference#availablemodels) reçue par la session ; distribuez la liste via [MDM ou un fichier de paramètres gérés](/docs/fr/managed-settings#delivery-mechanisms), car [la distribution gérée par le serveur n'est pas disponible sur les configurations de passerelle](/docs/fr/server-managed-settings#platform-availability) |295| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Définissez sur `1` pour remplir le sélecteur `/model` à partir de l'endpoint `/v1/models` de votre passerelle lorsque `ANTHROPIC_BASE_URL` pointe vers une passerelle compatible Anthropic telle que LiteLLM, Kong ou un proxy interne. Désactivée par défaut, car les passerelles reposant sur une clé API partagée afficheraient sinon à chaque utilisateur tous les modèles auxquels la clé donne accès. Les modèles découverts restent filtrés par une liste d'autorisation [`availableModels`](/docs/fr/settings-reference#availablemodels) reçue par la session ; fournissez cette liste via [MDM ou un fichier de paramètres gérés](/docs/fr/managed-settings#delivery-mechanisms), car [la distribution gérée par le serveur n'est pas disponible sur les configurations de passerelle](/docs/fr/server-managed-settings#platform-availability) |

294| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Supprimée dans la v2.1.142, lorsque le [mode rapide](/docs/fr/fast-mode) par défaut est passé d'Opus 4.6 à Opus 4.7 |296| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Supprimée dans la v2.1.142, lorsque le modèle par défaut du [mode rapide](/docs/fr/fast-mode) est passé d'Opus 4.6 à Opus 4.7 |

295| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Définir sur `false` pour désactiver les suggestions de prompt, les prédictions grisées qui apparaissent dans votre zone de saisie. A priorité sur le paramètre [`promptSuggestionEnabled`](/docs/fr/settings-reference#promptsuggestionenabled), qui est celui qu'écrit le bouton **Prompt suggestions** dans `/config`. Claude Code [met également les suggestions en pause lorsque votre compte est proche de sa limite d'utilisation ou l'a atteinte](/docs/fr/interactive-mode#when-claude-code-skips-suggestions). Définir sur `true` pour les conserver jusqu'à ce que vous atteigniez la limite. Nécessite Claude Code v2.1.238 ou ultérieur. Voir [Suggestions de prompt](/docs/fr/interactive-mode#prompt-suggestions) |297| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Définissez sur `false` pour désactiver les suggestions de prompt, les prédictions grisées qui apparaissent dans votre zone de saisie. A priorité sur le paramètre [`promptSuggestionEnabled`](/docs/fr/settings-reference#promptsuggestionenabled), qui est celui qu'écrit le bouton bascule **Prompt suggestions** dans `/config`. Claude Code [met également en pause les suggestions lorsque votre compte approche de sa limite d'utilisation ou l'a atteinte](/docs/fr/interactive-mode#when-claude-code-skips-suggestions). Définissez sur `true` pour les conserver jusqu'à ce que vous atteigniez la limite. Nécessite Claude Code v2.1.238 ou version ultérieure. Consultez [Suggestions de prompt](/docs/fr/interactive-mode#prompt-suggestions) |

296| `CLAUDE_CODE_ENABLE_TASKS` | Sélectionne les outils de suivi des tâches que Claude Code fournit dans [les sessions qui en disposent](/docs/fr/tools-reference#task-tool-availability). Par défaut, Claude Code fournit les outils Task `TaskCreate`, `TaskUpdate`, `TaskGet` et `TaskList`. Définir sur `0` pour obtenir à la place l'ancien outil `TodoWrite`. Voir [Liste des tâches](/docs/fr/interactive-mode#task-list) |298| `CLAUDE_CODE_ENABLE_TASKS` | Sélectionne les outils de suivi des tâches que Claude Code fournit dans les [sessions qui en disposent](/docs/fr/tools-reference#task-tool-availability). Par défaut, Claude Code fournit les outils Task `TaskCreate`, `TaskUpdate`, `TaskGet` et `TaskList`. Définissez sur `0` pour obtenir à la place l'ancien outil `TodoWrite`. Consultez [Liste des tâches](/docs/fr/interactive-mode#task-list) |

297| `CLAUDE_CODE_ENABLE_TELEMETRY` | Définir sur `1` pour activer la collecte de données OpenTelemetry pour les métriques et les logs. Requis avant de configurer les exportateurs OTel. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Voir [Surveillance](/docs/fr/monitoring-usage) |299| `CLAUDE_CODE_ENABLE_TELEMETRY` | Définissez sur `1` pour activer la collecte de données OpenTelemetry pour les métriques et la journalisation. Requise avant de configurer les exportateurs OTel. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Consultez [Surveillance](/docs/fr/monitoring-usage) |

298| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Définir sur `1` pour obtenir les outils de suivi des tâches sur tous les modèles. Sans cela, Claude Code ne les fournit par défaut que sur les modèles listés sous [Disponibilité de l'outil Task](/docs/fr/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` sélectionne toujours les outils Task ou `TodoWrite`. Nécessite Claude Code v2.1.233 ou ultérieur |300| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Définissez sur `1` pour obtenir les outils de suivi des tâches sur tous les modèles. Sans elle, Claude Code ne les fournit par défaut que sur les modèles listés sous [Disponibilité de l'outil Task](/docs/fr/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` sélectionne toujours les outils Task ou `TodoWrite`. Nécessite Claude Code v2.1.233 ou version ultérieure |

299| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Durée en millisecondes à attendre après que la boucle de requêtes devient inactive avant de quitter automatiquement. Utile pour les workflows automatisés et les scripts utilisant le mode SDK |301| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Durée en millisecondes à attendre après que la boucle de requêtes est devenue inactive avant de quitter automatiquement. Utile pour les workflows automatisés et les scripts utilisant le mode SDK |

300| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Définir sur `1` pour activer les [équipes d'agents](/docs/fr/agent-teams). Les équipes d'agents sont expérimentales et désactivées par défaut |302| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Définissez sur `1` pour activer les [équipes d'agents](/docs/fr/agent-teams). Les équipes d'agents sont expérimentales et désactivées par défaut |

301| `CLAUDE_CODE_EXTRA_BODY` | Objet JSON à fusionner au niveau supérieur de chaque corps de requête API. Utile pour transmettre des paramètres propres à un fournisseur que Claude Code n'expose pas directement. Une valeur exportée dans votre shell s'applique également aux [sessions en arrière-plan](/docs/fr/agent-view) que vous lancez avec `claude agents` ou `--bg`. Avant la v2.1.206, les sessions en arrière-plan ignoraient une valeur exportée depuis le shell et utilisaient la copie héritée par le processus superviseur en arrière-plan |303| `CLAUDE_CODE_EXTRA_BODY` | Objet JSON à fusionner au niveau supérieur du corps de chaque requête API. Utile pour transmettre des paramètres propres au fournisseur que Claude Code n'expose pas directement. Une valeur exportée dans votre shell s'applique aussi aux [sessions en arrière-plan](/docs/fr/agent-view) que vous lancez avec `claude agents` ou `--bg`. Avant la v2.1.206, les sessions en arrière-plan ignoraient une valeur exportée par le shell et utilisaient la copie dont avait hérité le processus superviseur en arrière-plan |

302| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Remplace la limite de tokens par défaut pour la lecture de fichiers. Utile lorsque vous devez lire intégralement des fichiers plus volumineux |304| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Remplace la limite de tokens par défaut pour les lectures de fichiers. Utile lorsque vous devez lire intégralement des fichiers plus volumineux |

303| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Définir sur `1` pour forcer la persistance de la transcription, l'historique des prompts et l'enregistrement dans `claude agents`, même lorsque ce `claude` a été lancé depuis une autre session Claude Code. À utiliser lorsqu'une valeur `CLAUDE_CODE_CHILD_SESSION` héritée, par exemple d'une session `screen` ou d'un lanceur en arrière-plan démarré à l'origine par l'outil Bash de Claude Code, fait qu'une véritable session de premier niveau est classée à tort comme imbriquée. Depuis la v2.1.178, Claude Code détecte automatiquement le cas de tmux et ignore le marqueur hérité, de sorte que tmux n'a plus besoin de cette variable. Également prise en compte dans la v2.1.169 et antérieures ; sans effet dans les v2.1.170 et v2.1.171, où la détection des sessions imbriquées qu'elle remplace avait été supprimée |305| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Définissez sur `1` pour forcer la persistance des transcriptions, l'historique des prompts et l'enregistrement dans `claude agents` même lorsque ce `claude` a été lancé depuis une autre session Claude Code. À utiliser lorsqu'une valeur `CLAUDE_CODE_CHILD_SESSION` héritée, par exemple d'une session `screen` ou d'un lanceur en arrière-plan démarré initialement par l'outil Bash de Claude Code, fait qu'une véritable session de premier niveau est classée à tort comme imbriquée. Depuis la v2.1.178, Claude Code détecte automatiquement le cas de tmux et ignore le marqueur hérité, si bien que tmux n'a plus besoin de cette variable. Également prise en compte dans la v2.1.169 et les versions antérieures ; sans effet dans les v2.1.170 et v2.1.171, où la détection des sessions imbriquées qu'elle remplace avait été supprimée |

304| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Définir sur `1` pour forcer le rendu barré de `~~text~~` dans les réponses de Claude lorsque votre terminal le prend en charge mais n'est pas détecté automatiquement, par exemple via SSH sans transmission de `TERM_PROGRAM`. Sans cela, les terminaux non détectés affichent les marqueurs `~~` littéraux au lieu de rendre le texte barré. Nécessite Claude Code v2.1.186 ou ultérieur |306| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Définissez sur `1` pour forcer le rendu barré de `~~text~~` dans les réponses de Claude lorsque votre terminal le prend en charge mais n'est pas détecté automatiquement, par exemple via SSH sans transmission de `TERM_PROGRAM`. Sans cela, les terminaux non détectés affichent les marqueurs `~~` littéraux au lieu de rendre le texte barré. Nécessite Claude Code v2.1.186 ou version ultérieure |

305| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Définir sur `1` pour forcer l'activation de la [sortie synchronisée](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) du mode privé DEC 2026 lorsque votre terminal la prend en charge mais n'est pas détecté automatiquement. Utile pour les émulateurs tels qu'Emacs `eat` qui implémentent BSU/ESU mais ne répondent pas à la sonde de capacités. Sans effet sous tmux. Contrairement à `CLAUDE_CODE_NO_FLICKER`, qui bascule vers le [rendu plein écran](/docs/fr/fullscreen), cette variable ne change pas le moteur de rendu |307| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Définissez sur `1` pour forcer l'activation de la [sortie synchronisée](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) du mode privé DEC 2026 lorsque votre terminal la prend en charge mais n'est pas détecté automatiquement. Utile pour des émulateurs comme `eat` d'Emacs, qui implémentent BSU/ESU mais ne répondent pas à la sonde de capacités. Sans effet sous tmux. Contrairement à `CLAUDE_CODE_NO_FLICKER`, qui bascule vers le [rendu plein écran](/docs/fr/fullscreen), cette variable ne change pas le moteur de rendu |

306| `CLAUDE_CODE_FORK_SUBAGENT` | Contrôle le [mode fork](/docs/fr/sub-agents#turn-fork-mode-on-or-off), qui permet à Claude de lancer lui-même des [sous-agents forkés](/docs/fr/sub-agents#fork-the-current-conversation) et qui est activé par défaut uniquement dans les sessions interactives. Définir sur `1` pour l'activer également dans `claude -p` et l'Agent SDK, ou sur `0` pour le désactiver dans tous les types de sessions. Vous pouvez exécuter `/subtask` que le mode fork soit activé ou non. L'activation par défaut en mode interactif nécessite Claude Code v2.1.232 ou ultérieur ; dans les versions antérieures, définissez la variable sur `1` pour activer le mode fork |308| `CLAUDE_CODE_FORK_SUBAGENT` | Contrôle le [mode fork](/docs/fr/sub-agents#turn-fork-mode-on-or-off), qui permet à Claude de lancer lui-même des [sous-agents forkés](/docs/fr/sub-agents#fork-the-current-conversation) et qui est activé par défaut uniquement dans les sessions interactives. Définissez sur `1` pour l'activer également dans `claude -p` et l'Agent SDK, ou sur `0` pour le désactiver dans tous les types de sessions. Vous pouvez exécuter `/subtask` que le mode fork soit activé ou non. L'activation par défaut en mode interactif nécessite Claude Code v2.1.232 ou version ultérieure ; dans les versions antérieures, définissez la variable sur `1` pour activer le mode fork |

307| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Définir sur `1` pour émettre le texte et les blocs de réflexion des [sous-agents](/docs/fr/sub-agents) dans la sortie de `claude -p --output-format stream-json`, avec le même comportement que le flag [`--forward-subagent-text`](/docs/fr/cli-reference#cli-flags). Utilisez la variable lorsqu'un harnais invoque `claude` et ne peut pas transmettre le flag lui-même. Contrairement au flag, qui se termine avec une erreur en dehors du mode non interactif avec une sortie stream-json, la variable y est ignorée afin que les invocations imbriquées continuent de fonctionner lorsqu'elle est définie pour tout le processus. Nécessite Claude Code v2.1.211 ou ultérieur |309| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Définissez sur `1` pour émettre le texte et les blocs de réflexion des [sous-agents](/docs/fr/sub-agents) dans la sortie de `claude -p --output-format stream-json`, soit le même comportement que le flag [`--forward-subagent-text`](/docs/fr/cli-reference#cli-flags). Utilisez la variable lorsqu'un harnais invoque `claude` et ne peut pas transmettre lui-même le flag. Contrairement au flag, qui se termine avec une erreur hors du mode non interactif avec sortie stream-json, la variable y est ignorée, afin que les invocations imbriquées continuent de fonctionner lorsqu'elle est définie pour l'ensemble du processus. Nécessite Claude Code v2.1.211 ou version ultérieure |

308| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Définir sur `1` pour envoyer les [en-têtes d'indication de passerelle](/docs/fr/llm-gateway-protocol#gateway-hint-headers), tels que `x-claude-code-request-class` et `x-claude-code-compaction`, vers un proxy personnalisé ou un fournisseur tiers tel qu'Amazon Bedrock ou Claude Platform on AWS. Définir sur `0` pour cesser de les envoyer sur toutes les connexions, y compris une connexion directe à l'API Anthropic, où Claude Code les envoie par défaut. Nécessite Claude Code v2.1.273 ou ultérieur |310| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Définissez sur `1` pour envoyer les [en-têtes d'indication de passerelle](/docs/fr/llm-gateway-protocol#gateway-hint-headers), tels que `x-claude-code-request-class` et `x-claude-code-compaction`, vers un proxy personnalisé ou un fournisseur tiers comme Amazon Bedrock ou Claude Platform on AWS. Définissez sur `0` pour cesser de les envoyer sur toutes les connexions, y compris une connexion directe à l'API Anthropic, où Claude Code les envoie par défaut. Nécessite Claude Code v2.1.273 ou version ultérieure |

309| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Délai d'expiration en millisecondes pour la requête de [découverte des modèles de la passerelle](/docs/fr/llm-gateway-protocol#model-discovery) qu'active `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (par défaut : `3000`). Augmentez-le lorsque votre passerelle a besoin de plus de trois secondes pour répondre à `/v1/models` au démarrage. N'accepte que des chiffres simples ; `0`, les valeurs négatives et les autres écritures conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou ultérieur |311| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Délai d'expiration en millisecondes de la requête de [découverte des modèles de la passerelle](/docs/fr/llm-gateway-protocol#model-discovery) qu'active `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (par défaut : `3000`). Augmentez-le lorsque votre passerelle a besoin de plus de trois secondes pour répondre à `/v1/models` au démarrage. N'accepte que des chiffres simples ; `0`, les valeurs négatives et les autres écritures conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou version ultérieure |

310| `CLAUDE_CODE_GIT_BASH_PATH` | Windows uniquement : chemin vers l'exécutable Git Bash (`bash.exe`). À utiliser lorsque Git Bash est installé mais ne figure pas dans votre PATH. Si le chemin n'existe pas ou si le fichier ne s'appelle pas `bash.exe`, `sh.exe`, `bash` ou `sh`, Claude Code ignore la variable et détecte automatiquement Git Bash comme si elle n'était pas définie, en consignant un avertissement visible avec `--debug`. Avant la v2.1.219, Claude Code se fermait au démarrage lorsque le chemin n'existait pas, et utilisait n'importe quel fichier existant comme shell sans vérifier qu'il s'agissait de bash ou sh. Voir [Configuration sous Windows](/docs/fr/setup#set-up-on-windows) |312| `CLAUDE_CODE_GIT_BASH_PATH` | Windows uniquement : chemin vers l'exécutable Git Bash (`bash.exe`). À utiliser lorsque Git Bash est installé mais absent de votre PATH. Si le chemin n'existe pas ou si le fichier ne s'appelle pas `bash.exe`, `sh.exe`, `bash` ou `sh`, Claude Code ignore la variable et détecte automatiquement Git Bash comme si elle n'était pas définie, en journalisant un avertissement visible avec `--debug`. Avant la v2.1.219, Claude Code se fermait au démarrage lorsque le chemin n'existait pas, et utilisait n'importe quel fichier existant comme shell sans vérifier qu'il s'agissait de bash ou de sh. Consultez [Configuration sous Windows](/docs/fr/setup#set-up-on-windows) |

311| `CLAUDE_CODE_GLOB_HIDDEN` | Définir sur `false` pour exclure les fichiers cachés (dotfiles) des résultats lorsque Claude invoque l'[outil Glob](/docs/fr/tools-reference#glob-tool-behavior). Inclus par défaut. N'affecte pas l'autocomplétion de fichiers `@`, `ls`, Grep ni Read |313| `CLAUDE_CODE_GLOB_HIDDEN` | Définissez sur `false` pour exclure les dotfiles des résultats lorsque Claude invoque l'[outil Glob](/docs/fr/tools-reference#glob-tool-behavior). Inclus par défaut. N'affecte pas l'autocomplétion de fichiers `@`, `ls`, Grep ni Read |

312| `CLAUDE_CODE_GLOB_NO_IGNORE` | Définir sur `false` pour que l'[outil Glob](/docs/fr/tools-reference#glob-tool-behavior) respecte les motifs `.gitignore`. Par défaut, Glob renvoie tous les fichiers correspondants, y compris ceux ignorés par Git. N'affecte pas l'autocomplétion de fichiers `@`, qui dispose de son propre [paramètre `respectGitignore`](/docs/fr/settings-reference#respectgitignore) |314| `CLAUDE_CODE_GLOB_NO_IGNORE` | Définissez sur `false` pour que l'[outil Glob](/docs/fr/tools-reference#glob-tool-behavior) respecte les motifs `.gitignore`. Par défaut, Glob renvoie tous les fichiers correspondants, y compris ceux ignorés par git. N'affecte pas l'autocomplétion de fichiers `@`, qui dispose de son propre [paramètre `respectGitignore`](/docs/fr/settings-reference#respectgitignore) |

313| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Délai d'expiration en secondes pour la découverte de fichiers par l'outil Glob. 20 secondes par défaut sur la plupart des plateformes et 60 secondes sur WSL |315| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Délai d'expiration en secondes pour la découverte de fichiers de l'outil Glob. 20 secondes par défaut sur la plupart des plateformes et 60 secondes sur WSL |

314| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Nombre de minutes pendant lesquelles un travail en arrière-plan peut maintenir un objectif actif en attente avant que Claude Code [demande à Claude de le vérifier](/docs/fr/goal#background-work-defers-evaluation). Valeur par défaut : `30`. Définir sur `0` pour désactiver les vérifications. Indiquez des minutes entières en chiffres simples, au maximum `10080`, soit une semaine. Claude Code traite toute autre valeur comme non définie et utilise la valeur par défaut. Nécessite Claude Code v2.1.234 ou ultérieur |316| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Nombre de minutes pendant lesquelles le travail en arrière-plan peut faire attendre un objectif actif avant que Claude Code [demande à Claude de le vérifier](/docs/fr/goal#background-work-defers-evaluation). Par défaut `30`. Définissez `0` pour désactiver les vérifications. Indiquez des minutes entières en chiffres simples, au maximum `10080`, soit une semaine. Claude Code traite toute autre valeur comme non définie et utilise la valeur par défaut. Nécessite Claude Code v2.1.234 ou version ultérieure |

315| `CLAUDE_CODE_HIDE_CWD` | Définir sur `1` pour masquer le répertoire de travail dans le logo de démarrage. Utile pour les partages d'écran ou les enregistrements où le chemin révèle votre nom d'utilisateur système |317| `CLAUDE_CODE_HIDE_CWD` | Définissez sur `1` pour masquer le répertoire de travail dans le logo de démarrage. Utile pour les partages d'écran ou les enregistrements où le chemin révèle votre nom d'utilisateur du système d'exploitation |

316| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Remplace l'adresse de l'hôte utilisée pour se connecter à l'extension IDE. Par défaut, Claude Code détecte automatiquement l'adresse correcte, y compris le routage de WSL vers Windows |318| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Remplace l'adresse de l'hôte utilisée pour se connecter à l'extension IDE. Par défaut, Claude Code détecte automatiquement l'adresse correcte, y compris le routage de WSL vers Windows |

317| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Définir sur `1` pour ignorer l'installation automatique des extensions IDE. Équivaut à définir [`autoInstallIdeExtension`](/docs/fr/settings-reference#autoinstallideextension) sur `false` |319| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Définissez sur `1` pour ignorer l'installation automatique des extensions IDE. Équivaut à définir [`autoInstallIdeExtension`](/docs/fr/settings-reference#autoinstallideextension) sur `false` |

318| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Définir sur `1` pour ignorer la validation des entrées du fichier de verrouillage de l'IDE lors de la connexion. À utiliser lorsque la connexion automatique ne trouve pas votre IDE alors qu'il est en cours d'exécution |320| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Définissez sur `1` pour ignorer la validation des entrées du fichier de verrouillage de l'IDE lors de la connexion. À utiliser lorsque la connexion automatique ne trouve pas votre IDE alors qu'il est en cours d'exécution |

319| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Nombre de [sous-agents](/docs/fr/sub-agents#concurrent-subagent-limit) pouvant s'exécuter dans une session avant que l'outil Agent refuse d'en lancer un autre (par défaut : 20). Accepte un nombre entier positif en chiffres simples ; toute autre valeur est ignorée, de sorte que la variable peut ajuster le plafond mais pas le désactiver. Nécessite Claude Code v2.1.217 ou ultérieur |321| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Nombre de [sous-agents](/docs/fr/sub-agents#concurrent-subagent-limit) pouvant s'exécuter dans une session avant que l'outil Agent refuse d'en lancer un autre (par défaut : 20). Accepte un nombre entier positif en chiffres simples ; toute autre valeur est ignorée, de sorte que la variable peut ajuster le plafond mais pas le désactiver. Nécessite Claude Code v2.1.217 ou version ultérieure |

320| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Remplace la taille de la fenêtre de contexte que Claude Code suppose pour le modèle actif. Depuis la v2.1.193, la manière dont elle s'applique dépend de la façon dont Claude Code résout l'ID du modèle ; voir [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id). À utiliser lors du routage vers un modèle via `ANTHROPIC_BASE_URL` dont la fenêtre de contexte ne correspond pas à la taille intégrée associée à son nom |322| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Remplace la taille de la fenêtre de contexte que Claude Code suppose pour le modèle actif. Depuis la v2.1.193, la façon dont elle s'applique dépend de la manière dont Claude Code résout l'ID du modèle ; consultez [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](/docs/fr/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Utilisez-la lors du routage via `ANTHROPIC_BASE_URL` vers un modèle dont la fenêtre de contexte ne correspond pas à la taille intégrée associée à son nom |

321| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Longueur maximale en caractères de chaque description d'outil MCP et des instructions de chaque serveur MCP que Claude Code envoie au modèle (par défaut : 2048). Claude Code [tronque les textes plus longs](/docs/fr/mcp#for-mcp-server-authors). Accepte un nombre entier positif en chiffres simples. Toute autre valeur est ignorée et la valeur par défaut s'applique. Nécessite Claude Code v2.1.280 ou ultérieur |323| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Longueur maximale en caractères de chaque description d'outil MCP et des instructions de chaque serveur MCP que Claude Code envoie au modèle (par défaut : 2048). Claude Code [tronque les textes plus longs](/docs/fr/mcp#for-mcp-server-authors). Accepte un nombre entier positif en chiffres simples. Toute autre valeur est ignorée et la valeur par défaut s'applique. Nécessite Claude Code v2.1.280 ou version ultérieure |

322| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Définit le nombre maximal de tokens de sortie pour la plupart des requêtes. Les valeurs par défaut et les plafonds varient selon le modèle ; voir [tokens de sortie maximum](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code ramène au plafond toute valeur qui dépasse le plafond d'un modèle. Pour un ID de modèle que Claude Code ne peut pas associer à un modèle connu, la valeur par défaut est 32000 et le plafond est 128000. Augmenter cette valeur réduit la fenêtre de contexte effective disponible avant le déclenchement de la [compaction automatique](/docs/fr/costs#reduce-token-usage) |324| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Définit le nombre maximal de tokens de sortie pour la plupart des requêtes. Les valeurs par défaut et les plafonds varient selon le modèle ; consultez [nombre maximal de tokens de sortie](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code ramène au plafond toute valeur supérieure au plafond d'un modèle. Pour un ID de modèle que Claude Code ne peut pas associer à un modèle connu, la valeur par défaut est 32000 et le plafond est 128000. Augmenter cette valeur réduit la fenêtre de contexte effective disponible avant le déclenchement de la [compaction automatique](/docs/fr/costs#reduce-token-usage) |

323| `CLAUDE_CODE_MAX_RETRIES` | Remplace le nombre de nouvelles tentatives pour les requêtes API ayant échoué (par défaut : 10). Plafonné à 15 depuis la v2.1.186 ; depuis la v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` augmente la valeur par défaut et supprime le plafond. Pour les sessions sans surveillance qui doivent patienter pendant des pannes plus longues, définissez plutôt `CLAUDE_CODE_RETRY_WATCHDOG` |325| `CLAUDE_CODE_MAX_RETRIES` | Remplace le nombre de nouvelles tentatives pour les requêtes API ayant échoué (par défaut : 10). Plafonné à 15 depuis la v2.1.186 ; depuis la v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` augmente la valeur par défaut et supprime le plafond. Pour les sessions sans surveillance qui doivent patienter pendant des pannes plus longues, définissez plutôt `CLAUDE_CODE_RETRY_WATCHDOG` |

324| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Supprimée dans la v2.1.224 et désormais sans effet. Plafonnait auparavant le nombre total de [sous-agents](/docs/fr/sub-agents) que Claude pouvait lancer avec l'outil Agent dans une session (par défaut : 200) ; tout lancement au-delà du plafond échouait avec `Subagent spawn limit reached`. La [limite de sous-agents simultanés](/docs/fr/sub-agents#concurrent-subagent-limit) et la [limite de profondeur](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents) s'appliquent toujours |326| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Supprimée dans la v2.1.224 et désormais sans effet. Plafonnait auparavant le nombre total de [sous-agents](/docs/fr/sub-agents) que Claude pouvait lancer avec l'outil Agent dans une session (par défaut : 200) ; tout lancement au-delà du plafond échouait avec `Subagent spawn limit reached`. La [limite de sous-agents simultanés](/docs/fr/sub-agents#concurrent-subagent-limit) et la [limite de profondeur](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents) s'appliquent toujours |

325| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Nombre de [niveaux de sous-agents](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents) autorisés sous la conversation principale (par défaut : 3). Avec la valeur par défaut, les sous-agents peuvent lancer leurs propres sous-agents, et un sous-agent au troisième niveau ne peut pas en lancer d'autres ; définir sur `1` pour désactiver l'imbrication. Dans les v2.1.217 à v2.1.218, la valeur par défaut était 1, de sorte qu'un sous-agent ne pouvait pas lancer les siens à moins que vous n'augmentiez la limite ; la v2.1.219 a porté la valeur par défaut à 3. Accepte un nombre entier positif en chiffres simples ; toute autre valeur est ignorée, de sorte que la limite peut être ajustée mais pas supprimée. Nécessite Claude Code v2.1.217 ou ultérieur |327| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Nombre de [couches de sous-agents](/docs/fr/sub-agents#let-subagents-spawn-their-own-subagents) autorisées sous la conversation principale (par défaut : 3). Avec la valeur par défaut, les sous-agents peuvent lancer leurs propres sous-agents, et un sous-agent de la troisième couche ne peut pas en lancer d'autres ; définissez `1` pour désactiver l'imbrication. Des versions v2.1.217 à v2.1.218, la valeur par défaut était 1, de sorte qu'un sous-agent ne pouvait pas lancer ses propres sous-agents à moins que vous n'augmentiez la limite ; la v2.1.219 a porté la valeur par défaut à 3. Accepte un nombre entier positif en chiffres simples ; toute autre valeur est ignorée, de sorte que la limite peut être ajustée mais pas supprimée. Nécessite Claude Code v2.1.217 ou version ultérieure |

326| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Nombre maximal d'outils en lecture seule et de sous-agents pouvant s'exécuter en parallèle (par défaut : 10). Des valeurs plus élevées augmentent le parallélisme mais consomment davantage de ressources |328| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Nombre maximal d'outils en lecture seule et de sous-agents pouvant s'exécuter en parallèle (par défaut : 10). Des valeurs plus élevées augmentent le parallélisme mais consomment davantage de ressources |

327| `CLAUDE_CODE_MAX_TURNS` | Plafonne le nombre de tours agentiques lorsqu'aucune limite explicite n'est transmise. Équivaut à transmettre [`--max-turns`](/docs/fr/cli-reference#cli-flags), qui a priorité lorsque les deux sont définis. Une valeur qui n'est pas un entier positif est rejetée au démarrage avec une erreur au lieu d'être traitée comme une absence de plafond |329| `CLAUDE_CODE_MAX_TURNS` | Plafonne le nombre de tours agentiques lorsqu'aucune limite explicite n'est transmise. Équivaut à passer [`--max-turns`](/docs/fr/cli-reference#cli-flags), qui a priorité lorsque les deux sont définis. Une valeur qui n'est pas un entier positif est rejetée au démarrage avec une erreur au lieu d'être traitée comme une absence de plafond |

328| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Plafond du nombre total d'appels [WebSearch](/docs/fr/tools-reference#websearch-tool-behavior) qu'une session peut effectuer (par défaut : 200). Lorsque Claude atteint le plafond, les appels WebSearch suivants renvoient un avis lui indiquant de continuer avec les informations déjà recueillies. Accepte un nombre entier positif sans limite supérieure. Toute autre valeur est ignorée et la valeur par défaut s'applique, de sorte que le plafond peut être relevé mais pas désactivé. Nécessite Claude Code v2.1.212 ou ultérieur |330| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Plafond du nombre total d'appels [WebSearch](/docs/fr/tools-reference#websearch-tool-behavior) qu'une session peut effectuer (par défaut : 200). Lorsque Claude atteint le plafond, les appels WebSearch suivants renvoient un avis lui indiquant de poursuivre avec les informations déjà recueillies. Accepte un nombre entier positif sans limite supérieure. Toute autre valeur est ignorée et la valeur par défaut s'applique, de sorte que le plafond peut être relevé mais pas désactivé. Nécessite Claude Code v2.1.212 ou version ultérieure |

329| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Définir sur `1` pour lancer les serveurs MCP stdio avec uniquement un environnement de base sûr plus l'`env` configuré du serveur, au lieu d'hériter de l'environnement de votre shell |331| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Définissez sur `1` pour lancer les serveurs MCP stdio avec uniquement un environnement de base sûr, complété par l'`env` configuré du serveur, au lieu d'hériter de l'environnement de votre shell |

330| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Temps écoulé en millisecondes avant qu'un appel d'outil MCP encore en cours [passe en tâche en arrière-plan](/docs/fr/mcp#automatic-backgrounding-of-long-tool-calls) (par défaut : 120000, soit 2 minutes). Définir sur `0` pour désactiver le passage automatique en arrière-plan. Nécessite Claude Code v2.1.212 ou ultérieur |332| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Temps écoulé en millisecondes avant qu'un appel d'outil MCP toujours en cours [passe en tâche en arrière-plan](/docs/fr/mcp#automatic-backgrounding-of-long-tool-calls) (par défaut : 120000, soit 2 minutes). Définissez sur `0` pour désactiver le passage automatique en arrière-plan. Nécessite Claude Code v2.1.212 ou version ultérieure |

331| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Durée en millisecondes pendant laquelle le premier tour d'une session [non interactive](/docs/fr/headless) attend les serveurs MCP encore en cours de connexion, à la place de l'[attente du premier tour](/docs/fr/agent-sdk/mcp#connection-timing) par défaut. Lorsqu'elle est définie, l'attente couvre tous les serveurs en attente. Définir sur `0` pour ignorer l'attente. Un serveur [`--permission-prompt-tool`](/docs/fr/cli-reference#cli-flags) conserve sa propre attente `MCP_TIMEOUT` quelle que soit la valeur. Nécessite Claude Code v2.1.274 ou ultérieur |333| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Durée en millisecondes pendant laquelle le premier tour d'une session [non interactive](/docs/fr/headless) attend les serveurs MCP encore en cours de connexion, à la place de l'[attente du premier tour](/docs/fr/agent-sdk/mcp#connection-timing) par défaut. Lorsqu'elle est définie, l'attente couvre tous les serveurs en attente. Définissez sur `0` pour ignorer l'attente. Un serveur [`--permission-prompt-tool`](/docs/fr/cli-reference#cli-flags) conserve sa propre attente `MCP_TIMEOUT`, quelle que soit la valeur. Nécessite Claude Code v2.1.274 ou version ultérieure |

332| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Délai d'inactivité en millisecondes pour les appels d'outils MCP. Lorsqu'un serveur MCP stdio, HTTP, SSE, WebSocket ou [connecteur claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai) n'envoie ni réponse ni notification de progression pendant cette durée, l'appel d'outil s'interrompt avec une erreur au lieu d'attendre le `MCP_TOOL_TIMEOUT` global. Remplace les valeurs par défaut par transport de 300000 (5 minutes) pour les serveurs réseau et de 1800000 (30 minutes) pour les serveurs stdio. Définir sur `0` pour désactiver la vérification d'inactivité. Les valeurs inférieures à 1000 sont portées à une seconde, et la valeur est plafonnée au `MCP_TOOL_TIMEOUT` effectif. Un `timeout` par serveur d'au moins 1000 dans `.mcp.json` porte la fenêtre d'inactivité de ce serveur à au moins la valeur de `timeout`. Ne s'applique pas aux serveurs IDE ni aux serveurs SDK in-process. Nécessite Claude Code v2.1.187 ou ultérieur. Avant la v2.1.203, les serveurs stdio étaient exemptés du délai d'inactivité |334| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Délai d'inactivité en millisecondes pour les appels d'outils MCP. Lorsqu'un serveur MCP stdio, HTTP, SSE, WebSocket ou [connecteur claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai) n'envoie aucune réponse ni aucune notification de progression pendant cette durée, l'appel d'outil est interrompu avec une erreur au lieu d'attendre le `MCP_TOOL_TIMEOUT` global. Remplace les valeurs par défaut par transport de 300000 (5 minutes) pour les serveurs réseau et de 1800000 (30 minutes) pour les serveurs stdio. Définissez sur `0` pour désactiver la vérification d'inactivité. Les valeurs inférieures à 1000 sont portées à une seconde, et la valeur est plafonnée au `MCP_TOOL_TIMEOUT` effectif. Un `timeout` par serveur d'au moins 1000 dans `.mcp.json` porte la fenêtre d'inactivité de ce serveur à au moins la valeur de `timeout`. Ne s'applique pas aux serveurs IDE ni aux serveurs SDK in-process. Nécessite Claude Code v2.1.187 ou version ultérieure. Avant la v2.1.203, les serveurs stdio étaient exemptés du délai d'inactivité |

333| `CLAUDE_CODE_MESSAGING_SOCKET` | Définie par Claude Code, pas par vous : dans les sessions qui lient un [socket de boîte de réception](/docs/fr/cross-session-messaging#the-sessions-inbox-socket), Claude Code exporte le chemin de ce socket vers les hooks et les commandes Bash lorsqu'il lie le socket. Dans une session qui démarre avec la messagerie activée, Claude Code lie le socket avant l'exécution de tout hook. Les autres sessions de la machine délivrent des messages vers ce chemin. Chaque session exporte son propre socket plutôt qu'un socket hérité d'un parent, et les messages qui y arrivent passent par les [contrôles entrants](/docs/fr/cross-session-messaging#control-inbound-messages) de la session. Les blocs `env` des paramètres ne peuvent pas la définir. Nécessite Claude Code v2.1.224 ou ultérieur |335| `CLAUDE_CODE_MESSAGING_SOCKET` | Définie par Claude Code, et non par vous : dans les sessions qui lient un [socket de boîte de réception](/docs/fr/cross-session-messaging#the-sessions-inbox-socket), Claude Code exporte le chemin de ce socket vers les hooks et les commandes Bash lorsqu'il lie le socket. Dans une session qui démarre avec la messagerie activée, Claude Code lie le socket avant l'exécution de tout hook. Les autres sessions de la machine livrent leurs messages à ce chemin. Chaque session exporte son propre socket plutôt qu'un socket hérité d'un parent, et les messages qui y arrivent passent par les [contrôles entrants](/docs/fr/cross-session-messaging#control-inbound-messages) de la session. Les blocs `env` des paramètres ne peuvent pas la définir. Nécessite Claude Code v2.1.224 ou version ultérieure |

334| `CLAUDE_CODE_MESSAGING_TOKEN` | Définie par Claude Code, pas par vous : dans les sessions qui lient un [socket de boîte de réception](/docs/fr/cross-session-messaging#the-sessions-inbox-socket), Claude Code exporte ce jeton propre à la session vers les hooks et les commandes Bash, en même temps que `CLAUDE_CODE_MESSAGING_SOCKET`. Un script qui écrit sur le socket peut envoyer `{"type":"auth","token":"<token>"}` comme première ligne pour prouver qu'il appartient à la session. Sous Windows natif, Claude Code exige cette ligne et ferme toute connexion qui ne s'ouvre pas avec une ligne valide. Les [règles des processus enfants propres](/docs/fr/cross-session-messaging#the-sessions-inbox-socket) indiquent quand Claude Code consulte le jeton. Chaque session exporte son propre jeton, jamais un jeton hérité d'une session parente. Les blocs `env` des paramètres ne peuvent pas la définir. Nécessite Claude Code v2.1.228 ou ultérieur |336| `CLAUDE_CODE_MESSAGING_TOKEN` | Définie par Claude Code, et non par vous : dans les sessions qui lient un [socket de boîte de réception](/docs/fr/cross-session-messaging#the-sessions-inbox-socket), Claude Code exporte ce jeton propre à la session vers les hooks et les commandes Bash, en plus de `CLAUDE_CODE_MESSAGING_SOCKET`. Un script qui publie sur le socket peut envoyer `{"type":"auth","token":"<token>"}` comme première ligne pour prouver qu'il appartient à la session. Sous Windows natif, Claude Code exige cette ligne et ferme toute connexion qui ne commence pas par une ligne valide. Les [règles relatives aux processus enfants propres](/docs/fr/cross-session-messaging#the-sessions-inbox-socket) indiquent quand Claude Code consulte le jeton. Chaque session exporte son propre jeton, jamais un jeton hérité d'une session parente. Les blocs `env` des paramètres ne peuvent pas la définir. Nécessite Claude Code v2.1.228 ou version ultérieure |

335| `CLAUDE_CODE_NATIVE_CURSOR` | Définir sur `1` pour afficher le curseur propre au terminal au point d'insertion au lieu d'un bloc dessiné. Le curseur respecte les paramètres de clignotement, de forme et de focus du terminal |337| `CLAUDE_CODE_NATIVE_CURSOR` | Définissez sur `1` pour afficher le curseur propre du terminal au point d'insertion au lieu d'un bloc dessiné. Le curseur respecte les paramètres de clignotement, de forme et de focus du terminal |

336| `CLAUDE_CODE_NEW_INIT` | Définir sur `1` pour que `/init` exécute un flux de configuration interactif. Le flux demande quels fichiers générer, notamment CLAUDE.md, les skills et les hooks, avant d'explorer la base de code et de les écrire. Sans cette variable, `/init` génère automatiquement un CLAUDE.md sans rien demander |338| `CLAUDE_CODE_NEW_INIT` | Définissez sur `1` pour que `/init` exécute un processus de configuration interactif. Celui-ci demande quels fichiers générer, notamment CLAUDE.md, des skills et des hooks, avant d'explorer la base de code et de les écrire. Sans cette variable, `/init` génère automatiquement un CLAUDE.md sans rien demander |

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

338| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limite le nombre de fois où Claude Code renvoie une [requête non streaming](/docs/fr/errors#streaming-response-ended-before-any-complete-data-was-received) qui expire. Avec `0`, la requête échoue dès le premier délai d'expiration. Non définie par défaut, de sorte que `CLAUDE_CODE_MAX_RETRIES` limite ces renvois. Voir [Ajuster le comportement des nouvelles tentatives](/docs/fr/errors#tune-retry-behavior) pour le délai d'expiration. Nécessite Claude Code v2.1.285 ou ultérieur |340| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limite le nombre de fois où Claude Code renvoie une [requête non streaming](/docs/fr/errors#streaming-response-ended-before-any-complete-data-was-received) qui expire. Avec `0`, la requête échoue dès la première expiration. Non définie par défaut, de sorte que `CLAUDE_CODE_MAX_RETRIES` limite ces renvois. Consultez [Ajuster le comportement des nouvelles tentatives](/docs/fr/errors#tune-retry-behavior) pour le délai d'expiration. Nécessite Claude Code v2.1.285 ou version ultérieure |

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

340| `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 |342| `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 les environnements automatisés |

341| `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"`. Requis lorsque `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` est défini |343| `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 |

342| `CLAUDE_CODE_OAUTH_TOKEN` | Jeton d'accès OAuth pour l'authentification claude.ai. Alternative à `/login` pour le SDK et les environnements automatisés. A priorité sur les identifiants stockés dans le trousseau. Générez-en un avec [`claude setup-token`](/docs/fr/authentication#generate-a-long-lived-token). Sauf si vous exécutez [`/login`](/docs/fr/authentication#authentication-precedence), Claude Code utilise le jeton que vous avez défini pendant toute la session. Pour remplacer un jeton expiré, générez-en un nouveau et redémarrez |344| `CLAUDE_CODE_OAUTH_TOKEN` | Jeton d'accès OAuth pour l'authentification claude.ai. Alternative à `/login` pour le SDK et les environnements automatisés. A priorité sur les identifiants stockés dans le trousseau. Générez-en un avec [`claude setup-token`](/docs/fr/authentication#generate-a-long-lived-token). À moins que vous n'exécutiez [`/login`](/docs/fr/authentication#authentication-precedence), Claude Code utilise le jeton que vous avez défini pendant toute la session. Pour remplacer un jeton expiré, générez-en un nouveau et redémarrez |

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

344| `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 réduisez-la pour diminuer le volume de télémétrie. Nécessite Claude Code v2.1.214 ou ultérieur. Voir [Surveillance](/docs/fr/monitoring-usage) |346| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Longueur maximale des attributs OpenTelemetry porteurs de contenu (réponses du modèle, contenu des outils, prompts système, corps bruts des requêtes API), marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, soit 60 Ko). Augmentez-la uniquement si votre backend de télémétrie accepte des valeurs d'attribut supérieures à 64 Ko, ou réduisez-la pour diminuer le volume de télémétrie. Nécessite Claude Code v2.1.214 ou version ultérieure. Consultez [Surveillance](/docs/fr/monitoring-usage) |

345| `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 conflit de port Prometheus, échoue sinon silencieusement. Nécessite Claude Code v2.1.179 ou ultérieur. Voir [Surveillance](/docs/fr/monitoring-usage) |347| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Définissez sur `1` pour écrire les erreurs de diagnostic de l'exportateur OpenTelemetry sur stderr. Par défaut, ces erreurs n'apparaissent qu'avec `--debug`, de sorte qu'un exportateur mal configuré, par exemple en cas de conflit de port Prometheus, échoue sinon silencieusement. Nécessite Claude Code v2.1.179 ou version ultérieure. Consultez [Surveillance](/docs/fr/monitoring-usage) |

346| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Délai d'expiration en millisecondes pour le vidage des spans OpenTelemetry en attente (par défaut : 5000). Voir [Surveillance](/docs/fr/monitoring-usage) |348| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Délai d'expiration en millisecondes pour le vidage des spans OpenTelemetry en attente (par défaut : 5000). Consultez [Surveillance](/docs/fr/monitoring-usage) |

347| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalle d'actualisation des en-têtes OpenTelemetry dynamiques en millisecondes (par défaut : 1740000 / 29 minutes). Voir [En-têtes dynamiques](/docs/fr/monitoring-usage#dynamic-headers) |349| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalle d'actualisation des en-têtes OpenTelemetry dynamiques, en millisecondes (par défaut : 1740000 / 29 minutes). Consultez [En-têtes dynamiques](/docs/fr/monitoring-usage#dynamic-headers) |

348| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Délai d'expiration en millisecondes accordé à l'exportateur OpenTelemetry pour terminer lors de l'arrêt (par défaut : 2000). Augmentez-le si des métriques sont perdues à la sortie. Voir [Surveillance](/docs/fr/monitoring-usage) |350| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Délai d'expiration en millisecondes accordé à l'exportateur OpenTelemetry pour terminer lors de l'arrêt (par défaut : 2000). Augmentez-le si des métriques sont perdues à la sortie. Consultez [Surveillance](/docs/fr/monitoring-usage) |

349| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Définir sur `1` pour permettre à Claude Code d'exécuter en arrière-plan la commande de mise à niveau de votre gestionnaire de paquets lorsqu'une nouvelle version est disponible. S'applique aux installations Homebrew et WinGet. Les autres gestionnaires de paquets continuent d'afficher la commande de mise à niveau sans l'exécuter. Voir [Mises à jour automatiques](/docs/fr/setup#auto-updates) |351| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Définissez sur `1` pour permettre à Claude Code d'exécuter en arrière-plan la commande de mise à niveau de votre gestionnaire de paquets lorsqu'une nouvelle version est disponible. S'applique aux installations Homebrew et WinGet. Les autres gestionnaires de paquets continuent d'afficher la commande de mise à niveau sans l'exécuter. Consultez [Mises à jour automatiques](/docs/fr/setup#auto-updates) |

350| `CLAUDE_CODE_PERFORCE_MODE` | Définir sur `1` pour activer la protection en écriture compatible avec Perforce. Lorsqu'elle est définie, Edit, Write et NotebookEdit échouent avec une indication `p4 edit <file>` si le fichier cible ne possède pas le bit d'écriture du propriétaire, que Perforce retire sur les fichiers synchronisés jusqu'à ce que `p4 edit` les ouvre. Cela empêche Claude Code de contourner le suivi des modifications de Perforce |352| `CLAUDE_CODE_PERFORCE_MODE` | Définissez sur `1` pour activer une protection en écriture compatible avec Perforce. Lorsqu'elle est définie, Edit, Write et NotebookEdit échouent avec une indication `p4 edit <file>` si le fichier cible n'a pas le bit d'écriture du propriétaire, que Perforce retire des fichiers synchronisés jusqu'à ce que `p4 edit` les ouvre. Cela empêche Claude Code de contourner le suivi des modifications de Perforce |

351| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Remplace le répertoire racine des plugins. Malgré son nom, cette variable définit le répertoire parent, pas le cache lui-même : les marketplaces et le cache des plugins se trouvent dans des sous-répertoires de ce chemin. Par défaut : `~/.claude/plugins` |353| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Remplace le répertoire racine des plugins. Malgré son nom, cette variable définit le répertoire parent, et non le cache lui-même : les marketplaces et le cache des plugins se trouvent dans des sous-répertoires de ce chemin. Par défaut `~/.claude/plugins` |

352| `CLAUDE_CODE_PLUGIN_DIRS` | Répertoires de plugins à charger pour la session, chacun chargé de la même manière qu'avec un flag [`--plugin-dir`](/docs/fr/plugins/cli-reference#flags-that-load-a-plugin-for-one-session). Séparez plusieurs chemins par `:` sous Unix ou `;` sous Windows. Indiquez chaque chemin sous forme de chemin absolu ou commencez-le par `~`, car Claude Code ignore les chemins relatifs. Nécessite Claude Code v2.1.280 ou ultérieur. Voir [Charger un plugin pour une session](/docs/fr/plugins/create#load-a-directory-or-archive-for-one-session) |354| `CLAUDE_CODE_PLUGIN_DIRS` | Répertoires de plugins à charger pour la session, chacun étant chargé comme le ferait un flag [`--plugin-dir`](/docs/fr/plugins/cli-reference#flags-that-load-a-plugin-for-one-session). Séparez plusieurs chemins par `:` sous Unix ou par `;` sous Windows. Indiquez chaque chemin sous forme de chemin absolu ou commencez-le par `~`, car Claude Code ignore les chemins relatifs. Nécessite Claude Code v2.1.280 ou version ultérieure. Consultez [Charger un plugin pour une session](/docs/fr/plugins/create#load-a-directory-or-archive-for-one-session) |

353| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Délai d'expiration en millisecondes pour le clonage ou l'actualisation d'une marketplace de plugins (par défaut : 120000). Augmentez cette valeur pour les dépôts volumineux ou les connexions réseau lentes. Voir [Git clone timed out](/docs/fr/plugins/troubleshooting#git-clone-timed-out-after-120s) |355| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Délai d'expiration en millisecondes pour le clonage ou l'actualisation d'une marketplace de plugins (par défaut : 120000). Augmentez cette valeur pour les dépôts volumineux ou les connexions réseau lentes. Consultez [Git clone timed out](/docs/fr/plugins/troubleshooting#git-clone-timed-out-after-120s) |

354| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Définir sur `1` pour ignorer la tentative de reclonage et continuer à utiliser le checkout existant de la marketplace lorsqu'une actualisation de marketplace ne parvient pas à joindre le dépôt distant ou à s'y authentifier. Utile dans les environnements hors ligne ou isolés (airgapped) où un reclonage échouerait de la même manière. Voir [Les mises à jour de marketplace échouent dans les environnements hors ligne](/docs/fr/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |356| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Définissez sur `1` pour ignorer la tentative de nouveau clonage et continuer à utiliser le checkout existant de la marketplace lorsqu'une actualisation de marketplace ne parvient pas à joindre le dépôt distant ou à s'y authentifier. Utile dans les environnements hors ligne ou isolés (airgapped), où un nouveau clonage échouerait de la même manière. Consultez [Les mises à jour de marketplace échouent dans les environnements hors ligne](/docs/fr/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |

355| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Définir sur `1` pour cloner les sources GitHub au format abrégé `owner/repo` via HTTPS plutôt que SSH. S'applique à l'installation et à la mise à jour des plugins, ainsi qu'à `/plugin marketplace add` et `update`. Utile sur les runners CI, dans les conteneurs ou dans tout environnement sans clé SSH configurée pour `github.com` |357| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Définissez sur `1` pour cloner les sources GitHub au format abrégé `owner/repo` via HTTPS au lieu de SSH. S'applique à l'installation et à la mise à jour des plugins, ainsi qu'à `/plugin marketplace add` et `update`. Utile dans les runners CI, les conteneurs ou tout environnement sans clé SSH configurée pour `github.com` |

356| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Chemin vers un ou plusieurs répertoires d'amorçage de plugins en lecture seule, séparés par `:` sous Unix ou `;` sous Windows. Utilisez-la pour intégrer un répertoire de plugins préremplis dans une image de conteneur. Claude Code enregistre les marketplaces de ces répertoires au démarrage et utilise les plugins déjà mis en cache sans les recloner. Voir [Préremplir les plugins pour les conteneurs](/docs/fr/plugins/org#seed-containers-and-ci) |358| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Chemin vers un ou plusieurs répertoires d'amorçage de plugins en lecture seule, séparés par `:` sous Unix ou par `;` sous Windows. Utilisez-la pour intégrer un répertoire de plugins pré-rempli dans une image de conteneur. Claude Code enregistre les marketplaces de ces répertoires au démarrage et utilise les plugins déjà mis en cache sans nouveau clonage. Consultez [Pré-remplir les plugins pour les conteneurs](/docs/fr/plugins/org#seed-containers-and-ci) |

357| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Définir sur `1` pour empêcher Claude Code de transmettre `-ExecutionPolicy Bypass` lorsqu'il lance PowerShell pour les appels d'outils, les hooks et les commandes de la barre de statut, et respecter à la place la stratégie d'exécution effective de la machine. Par défaut, Claude Code contourne la stratégie d'exécution au niveau du processus afin que les scripts `.ps1` et les importations de modules fonctionnent sur les installations Windows configurées par défaut en mode Restricted. Le contournement au niveau du processus ne remplace jamais les stratégies de groupe `MachinePolicy` ou `UserPolicy`, quel que soit ce paramètre |359| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Définissez sur `1` pour empêcher Claude Code de passer `-ExecutionPolicy Bypass` lorsqu'il lance PowerShell pour les appels d'outils, les hooks et les commandes de barre de statut, et respecter à la place la stratégie d'exécution effective de la machine. Par défaut, Claude Code contourne la stratégie d'exécution au niveau du processus afin que les scripts `.ps1` et les importations de modules fonctionnent sur les installations Windows configurées par défaut en Restricted. Le contournement au niveau du processus ne remplace jamais les stratégies de groupe `MachinePolicy` ou `UserPolicy`, quel que soit ce paramètre |

358| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Plafond en millisecondes de l'attente inactive des sous-agents et workflows en arrière-plan après le dernier tour en [mode non interactif](/docs/fr/headless#background-tasks-at-exit) avec le flag `-p`. L'attente inactive redémarre chaque fois que Claude effectue un tour pour traiter un résultat en arrière-plan. Par défaut : `600000`, soit 10 minutes. Lorsque l'attente inactive atteint le plafond, Claude Code cesse d'attendre les tâches en arrière-plan restantes et se ferme. Définir sur `0` pour attendre indéfiniment. Ce plafond est distinct du délai de grâce de cinq secondes qui s'applique aux shells en arrière-plan simples. Nécessite Claude Code v2.1.182 ou ultérieur |360| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Plafond en millisecondes de l'attente inactive des sous-agents et workflows en arrière-plan après le dernier tour en [mode non interactif](/docs/fr/headless#background-tasks-at-exit) avec le flag `-p`. L'attente inactive repart de zéro chaque fois que Claude effectue un tour pour traiter un résultat en arrière-plan. Par défaut : `600000`, soit 10 minutes. Lorsque l'attente inactive atteint le plafond, Claude Code cesse d'attendre les tâches en arrière-plan restantes et se termine. Définissez sur `0` pour attendre indéfiniment. Ce plafond est distinct du délai de grâce de cinq secondes qui s'applique aux simples shells en arrière-plan. Nécessite Claude Code v2.1.182 ou version ultérieure |

359| `CLAUDE_CODE_PROCESS_WRAPPER` | Lance les processus que Claude Code démarre à partir de son propre binaire, comme le service en arrière-plan qui héberge les sessions de la [vue agents](/docs/fr/agent-view), via un lanceur d'entreprise indiqué sous forme de préfixe argv tel que `/opt/corp/launcher`. Définissez-la dans le bloc `env` des paramètres utilisateur ou des [paramètres gérés](/docs/fr/managed-settings), et non sous forme d'export shell, afin que le service en arrière-plan détaché en hérite ; les paramètres de projet et locaux ne peuvent pas la définir. Équivaut au [paramètre `processWrapper`](/docs/fr/settings-reference#processwrapper), qui nécessite Claude Code v2.1.210 ou ultérieur ; cette variable a priorité lorsque les deux sont définis. L'extension VS Code configure son propre lanceur séparément via son paramètre `claudeProcessWrapper`. Ignorée sous Windows. Voir [Exécuter Claude Code derrière un lanceur d'entreprise](/docs/fr/corporate-launcher) pour le format de la valeur, ce que couvre le lanceur et le contrat que le lanceur doit respecter. Nécessite Claude Code v2.1.208 ou ultérieur |361| `CLAUDE_CODE_PROCESS_WRAPPER` | Lance les processus que Claude Code démarre à partir de son propre binaire, comme le service en arrière-plan qui héberge les sessions de la [vue des agents](/docs/fr/agent-view), via un lanceur d'entreprise indiqué sous forme de préfixe argv, comme `/opt/corp/launcher`. Définissez-la dans le bloc `env` des paramètres utilisateur ou des [paramètres gérés](/docs/fr/managed-settings), et non comme un export de shell, afin que le service en arrière-plan détaché en hérite ; les paramètres de projet et locaux ne peuvent pas la définir. Équivaut au [paramètre `processWrapper`](/docs/fr/settings-reference#processwrapper), qui nécessite Claude Code v2.1.210 ou version ultérieure ; cette variable a priorité lorsque les deux sont définis. L'extension VS Code configure son propre lanceur séparément via son paramètre `claudeProcessWrapper`. Ignorée sous Windows. Consultez [Exécuter Claude Code derrière un lanceur d'entreprise](/docs/fr/corporate-launcher) pour le format de la valeur, ce que couvre le lanceur et le contrat que le lanceur doit respecter. Nécessite Claude Code v2.1.208 ou version ultérieure |

360| `CLAUDE_CODE_PROJECT_DIR_NAME` | À définir avec `CLAUDE_CONFIG_DIR` pour choisir le nom du répertoire `projects/` sous lequel Claude Code stocke les transcriptions et la mémoire automatique de cette session, à la place d'un nom dérivé du chemin du répertoire de travail. Par exemple, démarrer Claude Code avec `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` les stocke sous `/srv/tenant-a/projects/work/`. Claude Code ignore cette variable lorsque `CLAUDE_CONFIG_DIR` n'est pas définie, et ne la lit que depuis l'environnement à partir duquel vous lancez `claude`, jamais depuis un [bloc `env` d'un fichier de paramètres](#in-settings-files). Voir [Nommer vous-même le répertoire du projet](/docs/fr/sessions#name-the-project-directory-yourself). Nécessite Claude Code v2.1.234 ou ultérieur |362| `CLAUDE_CODE_PROJECT_DIR_NAME` | À définir avec `CLAUDE_CONFIG_DIR` pour choisir le nom du répertoire `projects/` sous lequel Claude Code stocke les transcriptions et la mémoire automatique de cette session, à la place d'un nom dérivé du chemin du répertoire de travail. Par exemple, démarrer Claude Code avec `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` les stocke sous `/srv/tenant-a/projects/work/`. Claude Code ignore cette variable lorsque `CLAUDE_CONFIG_DIR` n'est pas définie, et ne la lit que depuis l'environnement à partir duquel vous démarrez `claude`, jamais depuis le [bloc `env` d'un fichier de paramètres](#in-settings-files). Consultez [Nommer vous-même le répertoire du projet](/docs/fr/sessions#name-the-project-directory-yourself). Nécessite Claude Code v2.1.234 ou version ultérieure |

361| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Définir sur `5m` ou `1h`, les seules valeurs acceptées par Claude Code, pour choisir le [TTL du cache de prompts](/docs/fr/prompt-caching#cache-lifetime) de la conversation principale : vos tours interactifs, `-p` et SDK, ainsi que les assistants qui s'exécutent en ligne avec eux. A priorité sur le paramètre `promptCacheTtl` et sur `ENABLE_PROMPT_CACHING_1H`, et `FORCE_PROMPT_CACHING_5M` la remplace. L'API facture les écritures en cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur |363| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Définissez `5m` ou `1h`, les seules valeurs acceptées par Claude Code, pour choisir le [TTL du cache de prompts](/docs/fr/prompt-caching#cache-lifetime) de la conversation principale : vos tours interactifs, `-p` et SDK, ainsi que les assistants qui s'exécutent en ligne avec eux. A priorité sur le paramètre `promptCacheTtl` et sur `ENABLE_PROMPT_CACHING_1H`, et `FORCE_PROMPT_CACHING_5M` la remplace. L'API facture les écritures de cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou version ultérieure |

362| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Définir sur `1` pour propager le contexte de trace W3C lorsque `ANTHROPIC_BASE_URL` pointe vers un proxy personnalisé. La propagation couvre l'en-tête `traceparent` des requêtes vers le modèle et vers les serveurs MCP HTTP, ainsi que la variable d'environnement `TRACEPARENT` pour les sous-processus Bash, PowerShell et des hooks. Par défaut, la propagation n'est activée qu'en cas de connexion directe à l'API Anthropic. Ajoutée dans la v2.1.152. Voir [Traces (bêta)](/docs/fr/monitoring-usage#traces-beta) |364| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Définissez sur `1` pour propager le contexte de trace W3C lorsque `ANTHROPIC_BASE_URL` pointe vers un proxy personnalisé. La propagation couvre l'en-tête `traceparent` des requêtes au modèle et des requêtes MCP HTTP, ainsi que la variable d'environnement `TRACEPARENT` pour les sous-processus Bash, PowerShell et de hooks. Par défaut, la propagation n'est activée qu'en cas de connexion directe à l'API Anthropic. Ajoutée dans la v2.1.152. Consultez [Traces (bêta)](/docs/fr/monitoring-usage#traces-beta) |

363| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Définie par les plateformes hôtes qui intègrent Claude Code et gèrent le routage vers le fournisseur de modèles en son nom. Lorsqu'elle est définie, Claude Code ignore les variables de sélection du fournisseur, d'endpoint et d'authentification telles que `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY` dans les fichiers de paramètres, de sorte que les paramètres utilisateur ne peuvent pas remplacer le routage de l'hôte. Claude Code ignore également les clés de sélection de modèle telles que `model`, `fallbackModel` et `modelOverrides` dans les [paramètres gérés](/docs/fr/managed-settings), quelle que soit la source gérée qui les fournit, de sorte que la configuration de modèle de l'hôte a priorité sur un épinglage de modèle géré obsolète. Claude Code ignore aussi les variables de sélection de modèle telles que `ANTHROPIC_MODEL` et la famille `ANTHROPIC_DEFAULT_*_MODEL` dans un bloc `env` géré ; une liste d'autorisation [`availableModels`](/docs/fr/model-config#restrict-model-selection) dans les paramètres gérés s'applique toujours, sauf si l'hôte fournit la sienne. Claude Code ignore également la désactivation automatique de la télémétrie qu'il applique sinon sur les fournisseurs tiers tels qu'Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform et Microsoft Foundry, de sorte que la télémétrie suit la désactivation standard `DISABLE_TELEMETRY`. Voir [Comportements par défaut selon le fournisseur d'API](/docs/fr/data-usage#default-behaviors-by-api-provider) |365| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Définie par les plateformes hôtes qui intègrent Claude Code et gèrent le routage des fournisseurs de modèles en son nom. Lorsqu'elle est définie, Claude Code ignore les variables de sélection du fournisseur, d'endpoint et d'authentification telles que `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY` dans les fichiers de paramètres, afin que les paramètres utilisateur ne puissent pas remplacer le routage de l'hôte. Claude Code ignore également les clés de sélection de modèle telles que `model`, `fallbackModel` et `modelOverrides` dans les [paramètres gérés](/docs/fr/managed-settings), quelle que soit la source gérée qui les fournit, afin que la configuration de modèle de l'hôte ait priorité sur un épinglage de modèle géré obsolète. Claude Code ignore aussi les variables de sélection de modèle telles que `ANTHROPIC_MODEL` et la famille `ANTHROPIC_DEFAULT_*_MODEL` dans un bloc `env` géré ; une liste d'autorisation [`availableModels`](/docs/fr/model-config#restrict-model-selection) dans les paramètres gérés s'applique toujours, sauf si l'hôte fournit la sienne. Claude Code ignore en outre la désactivation automatique de la télémétrie qu'il applique sinon sur les fournisseurs tiers tels qu'Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform et Microsoft Foundry, de sorte que la télémétrie suit la désactivation standard via `DISABLE_TELEMETRY`. Consultez [Comportements par défaut selon le fournisseur d'API](/docs/fr/data-usage#default-behaviors-by-api-provider) |

364| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Définir sur `1` pour permettre au proxy d'effectuer la résolution DNS à la place de l'appelant. Option à activer pour les environnements où le proxy doit gérer la résolution des noms d'hôte |366| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Définissez sur `1` pour permettre au proxy d'effectuer la résolution DNS à la place de l'appelant. Option à activer explicitement dans les environnements où le proxy doit gérer la résolution des noms d'hôte |

365| `CLAUDE_CODE_REMOTE` | Définie automatiquement sur `true` lorsque Claude Code s'exécute en tant que [session cloud](/docs/fr/claude-code-on-the-web). Lisez-la depuis un hook ou un script de configuration pour détecter si vous êtes dans une session cloud |367| `CLAUDE_CODE_REMOTE` | Définie automatiquement sur `true` lorsque Claude Code s'exécute en tant que [session cloud](/docs/fr/claude-code-on-the-web). Lisez-la depuis un hook ou un script de configuration pour détecter si vous êtes dans une session cloud |

366| `CLAUDE_CODE_REMOTE_SESSION_ID` | Définie automatiquement dans les [sessions cloud](/docs/fr/claude-code-on-the-web) sur l'ID de la session en cours. Lisez-la pour construire un lien vers la transcription de la session. Voir [Relier la sortie à la session](/docs/fr/cloud-environments#link-output-back-to-the-session) |368| `CLAUDE_CODE_REMOTE_SESSION_ID` | Définie automatiquement dans les [sessions cloud](/docs/fr/claude-code-on-the-web) sur l'ID de la session en cours. Lisez-la pour construire un lien vers la transcription de la session. Consultez [Lier la sortie à la session](/docs/fr/cloud-environments#link-output-back-to-the-session) |

367| `CLAUDE_CODE_RESTRICTED` | Définir sur `1` pour démarrer la session en mode restreint, comme en transmettant [`--restricted`](/docs/fr/cli-reference#cli-flags). Claude Code ignore cette variable dans le bloc `env` d'un fichier de paramètres. Nécessite Claude Code v2.1.248 ou ultérieur |369| `CLAUDE_CODE_RESTRICTED` | Définissez sur `1` pour démarrer la session en mode restreint, comme en passant [`--restricted`](/docs/fr/cli-reference#cli-flags). Claude Code ignore cette variable dans le bloc `env` d'un fichier de paramètres. Nécessite Claude Code v2.1.248 ou version ultérieure |

368| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Définir sur `1` pour reprendre automatiquement si la session précédente s'est terminée en cours de tour. Utilisée en mode SDK pour que le modèle continue sans que le SDK ait à renvoyer le prompt. Pour la désactiver, supprimez la variable ou définissez-la sur `0`. Pour le panneau de chat VS Code, voir [Poursuivre les conversations après un rechargement](/docs/fr/vs-code#continue-conversations-after-a-reload) |370| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Définissez sur `1` pour reprendre automatiquement si la session précédente s'est terminée en cours de tour. Utilisée en mode SDK afin que le modèle poursuive sans que le SDK ait à renvoyer le prompt. Pour désactiver ce comportement, supprimez la variable ou définissez-la sur `0`. Pour le panneau de chat VS Code, consultez [Poursuivre les conversations après un rechargement](/docs/fr/vs-code#continue-conversations-after-a-reload) |

369| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Âge maximal en millisecondes du dernier message de la transcription pour qu'une session terminée en cours de tour continue automatiquement à la reprise. Lorsque le dernier message est plus ancien que cette limite, Claude Code ignore la reprise automatique `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` et son message de continuation `CLAUDE_CODE_RESUME_PROMPT`, et la session démarre inactive afin que vous continuiez explicitement. Non définie ou `0` signifie aucune limite, sauf qu'un tour dont la dernière requête a échoué avec une erreur API ne reprend que si cette erreur date de moins de six heures. Une valeur positive limite chaque tour, y compris ceux-ci ; une valeur négative ou non numérique applique une limite d'une heure. Les scripts de lancement d'agents de longue durée peuvent la définir afin qu'un redémarrage sur une ancienne transcription ne réexécute pas un prompt obsolète. Claude Code définit lui-même une limite d'une heure lorsqu'il redémarre une session de la [vue agents](/docs/fr/agent-view) ayant planté qui a hérité sa conversation d'une session interactive. Nécessite Claude Code v2.1.211 ou ultérieur |371| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Âge maximal en millisecondes du dernier message de la transcription pour qu'une session terminée en cours de tour se poursuive automatiquement à la reprise. Lorsque le dernier message est plus ancien que cette limite, Claude Code ignore la reprise automatique de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` et son message de continuation `CLAUDE_CODE_RESUME_PROMPT`, et la session démarre inactive afin que vous poursuiviez explicitement. Non définie ou `0` signifie aucune limite, sauf qu'un tour dont la dernière requête a échoué avec une erreur d'API ne reprend que tant que cette erreur date de moins de six heures. Une valeur positive limite tous les tours, y compris ceux-là ; une valeur négative ou non numérique applique une limite d'une heure. Les scripts de lancement d'agents de longue durée peuvent la définir afin qu'un redémarrage sur une ancienne transcription ne réexécute pas un prompt obsolète. Claude Code définit lui-même une limite d'une heure lorsqu'il redémarre une session de la [vue des agents](/docs/fr/agent-view) qui a planté et qui avait hérité sa conversation d'une session interactive. Nécessite Claude Code v2.1.211 ou version ultérieure |

370| `CLAUDE_CODE_RESUME_PROMPT` | Remplace le message de continuation que Claude Code envoie à Claude lorsque `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` poursuit un tour interrompu au lieu de renvoyer son prompt, ou lorsque vous reprenez un [appel d'outil différé](/docs/fr/hooks#defer-a-tool-call-for-later) avec `-p`. Par défaut : `Continue from where you left off.`. Une chaîne vide utilise la valeur par défaut |372| `CLAUDE_CODE_RESUME_PROMPT` | Remplace le message de continuation que Claude Code envoie à Claude lorsque `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` poursuit un tour interrompu au lieu de renvoyer son prompt, ou lorsque vous reprenez un [appel d'outil différé](/docs/fr/hooks#defer-a-tool-call-for-later) avec `-p`. Par défaut `Continue from where you left off.`. Une chaîne vide utilise la valeur par défaut |

371| `CLAUDE_CODE_RETRY_WATCHDOG` | Définir sur `1` pour les sessions sans surveillance telles que les harnais d'évaluation, les jobs CI ou les workers distants. Réessaie indéfiniment les erreurs de capacité `429` et `529` au lieu d'échouer après `CLAUDE_CODE_MAX_RETRIES` tentatives. Claude Code échoue immédiatement lorsqu'une requête à vitesse standard reçoit une erreur `429` signalant une limite de dépenses ou des crédits d'utilisation épuisés, même si elle provient d'un [plafond de dépenses de passerelle](/docs/fr/errors#spend-limit-reached) qui se réinitialise selon un calendrier. Avant la v2.1.239, le watchdog réessayait ces requêtes indéfiniment. Pour les requêtes en mode rapide, voir [Gérer les limites de débit](/docs/fr/fast-mode#handle-rate-limits). Le watchdog espace les tentatives jusqu'à 5 minutes, ou jusqu'à la réinitialisation de la limite lorsque la réponse contient une heure de réinitialisation de la limite de débit, de sorte qu'une session qui atteint une limite d'utilisation attend la fin de la fenêtre restante. Dans la v2.1.199 ou ultérieure, il porte également à 300 le nombre de nouvelles tentatives par défaut pour les autres erreurs transitoires, telles que les erreurs serveur, les délais d'expiration et les connexions interrompues, soit environ trois heures d'attente progressive, et supprime le plafond de 15 sur `CLAUDE_CODE_MAX_RETRIES` si vous définissez explicitement cette variable. Nécessite Claude Code v2.1.186 ou ultérieur |373| `CLAUDE_CODE_RETRY_WATCHDOG` | Définissez sur `1` pour les sessions sans surveillance telles que les harnais d'évaluation, les jobs CI ou les workers distants. Réessaie indéfiniment en cas d'erreurs de capacité `429` et `529` au lieu d'échouer après `CLAUDE_CODE_MAX_RETRIES` tentatives. Claude Code échoue immédiatement lorsqu'une requête à vitesse standard reçoit une erreur `429` signalant une limite de dépenses ou des crédits d'utilisation épuisés, même si elle provient d'un [plafond de dépenses de passerelle](/docs/fr/errors#spend-limit-reached) qui se réinitialise selon un calendrier. Avant la v2.1.239, le watchdog réessayait indéfiniment dans ces cas. Pour les requêtes en mode rapide, consultez [Gérer les limites de débit](/docs/fr/fast-mode#handle-rate-limits). Le watchdog espace ses tentatives jusqu'à 5 minutes, ou jusqu'à la réinitialisation de la limite lorsque la réponse indique une heure de réinitialisation de la limite de débit, de sorte qu'une session qui atteint une limite d'utilisation attend la fin de la fenêtre restante. À partir de la v2.1.199, il porte également à 300 le nombre de nouvelles tentatives par défaut pour les autres erreurs transitoires, telles que les erreurs serveur, les expirations et les connexions interrompues, soit environ trois heures de backoff, et supprime le plafond de 15 sur `CLAUDE_CODE_MAX_RETRIES` si vous définissez explicitement cette variable. Nécessite Claude Code v2.1.186 ou version ultérieure |

372| `CLAUDE_CODE_SAFE_MODE` | Définir sur `1` pour démarrer en mode sans échec : CLAUDE.md, les skills, les plugins, les hooks, les serveurs MCP, les commandes et agents personnalisés, les styles de sortie, les workflows, les thèmes personnalisés, les raccourcis clavier personnalisés, les commandes de barre de statut et de suggestion de fichiers, les serveurs LSP et la mémoire automatique ne sont pas chargés, afin de dépanner une configuration défaillante. La politique des paramètres gérés s'applique toujours, y compris les hooks, la barre de statut et les commandes de suggestion de fichiers configurés par la politique ; ce n'est pas le cas des plugins gérés, des skills gérés, du CLAUDE.md géré et des serveurs MCP configurés par la politique. Équivaut à transmettre [`--safe-mode`](/docs/fr/cli-reference#cli-flags). Les processus enfants lancés directement héritent de la variable |374| `CLAUDE_CODE_SAFE_MODE` | Définissez sur `1` pour démarrer en mode sans échec : CLAUDE.md, les skills, les plugins, les hooks, les serveurs MCP, les commandes et agents personnalisés, les styles de sortie, les workflows, les thèmes personnalisés, les raccourcis clavier personnalisés, les commandes de barre de statut et de suggestion de fichiers, les serveurs LSP et la mémoire automatique ne sont pas chargés, afin de dépanner une configuration défectueuse. La politique des paramètres gérés s'applique toujours, y compris les hooks, la barre de statut et les commandes de suggestion de fichiers configurés par politique ; ce n'est pas le cas des plugins gérés, des skills gérés, du CLAUDE.md géré ni des serveurs MCP configurés par politique. Équivaut à passer [`--safe-mode`](/docs/fr/cli-reference#cli-flags). Les processus enfants lancés directement héritent de la variable |

373| `CLAUDE_CODE_SCRIPT_CAPS` | Objet JSON limitant le nombre de fois où des scripts spécifiques peuvent être invoqués par session lorsque `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` est défini. Les clés sont des sous-chaînes comparées au texte de la commande ; les valeurs sont des limites d'appels entières. Par exemple, `{"deploy.sh": 2}` permet d'appeler `deploy.sh` au maximum deux fois. La correspondance repose sur des sous-chaînes, de sorte que les astuces d'expansion du shell comme `./scripts/deploy.sh $(evil)` sont tout de même comptabilisées dans le plafond. La démultiplication à l'exécution via `xargs` ou `find -exec` n'est pas détectée ; il s'agit d'un contrôle de défense en profondeur |375| `CLAUDE_CODE_SCRIPT_CAPS` | Objet JSON limitant le nombre de fois où des scripts spécifiques peuvent être invoqués par session lorsque `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` est défini. Les clés sont des sous-chaînes comparées au texte de la commande ; les valeurs sont des limites d'appels entières. Par exemple, `{"deploy.sh": 2}` permet d'appeler `deploy.sh` au plus deux fois. La correspondance repose sur les sous-chaînes, de sorte que les astuces d'expansion du shell comme `./scripts/deploy.sh $(evil)` sont toujours comptabilisées dans le plafond. La démultiplication à l'exécution via `xargs` ou `find -exec` n'est pas détectée ; il s'agit d'un contrôle de défense en profondeur |

374| `CLAUDE_CODE_SCROLL_SPEED` | Définit le multiplicateur de défilement de la molette de la souris en [rendu plein écran](/docs/fr/fullscreen#mouse-wheel-scrolling). Accepte toute valeur positive jusqu'à 20, y compris des valeurs fractionnaires inférieures à 1 comme `0.5` pour ralentir le défilement accéléré du trackpad et de la molette dans les terminaux qui amplifient déjà les événements de molette. Définir sur `3` pour correspondre à `vim` si votre terminal envoie un événement de molette par cran sans amplification. Ignorée dans le terminal des IDE JetBrains, où Claude Code utilise sa propre gestion du défilement |376| `CLAUDE_CODE_SCROLL_SPEED` | Définit le multiplicateur de défilement de la molette de la souris en [rendu plein écran](/docs/fr/fullscreen#mouse-wheel-scrolling). Accepte toute valeur positive jusqu'à 20, y compris des valeurs fractionnaires inférieures à 1 comme `0.5` pour ralentir le défilement accéléré du trackpad et de la molette dans les terminaux qui amplifient déjà les événements de molette. Définissez sur `3` pour reproduire le comportement de `vim` si votre terminal envoie un événement de molette par cran sans amplification. Ignorée dans le terminal des IDE JetBrains, où Claude Code utilise sa propre gestion du défilement |

375| `CLAUDE_CODE_SEND_FEEDBACK` | Définir sur `0` pour désactiver le [feedback rédigé par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior) pour une session. Définir sur `1` pour l'activer lorsque votre compte y a déjà accès ; la variable ne peut pas accorder l'accès elle-même, et les autres options qui désactivent le feedback, telles que `DISABLE_FEEDBACK_COMMAND` et la valeur `off` du paramètre [`feedbackDrafts`](/docs/fr/settings-reference#feedbackdrafts), s'appliquent toujours |377| `CLAUDE_CODE_SEND_FEEDBACK` | Définissez sur `0` pour désactiver le [feedback rédigé par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior) pour une session. Définissez sur `1` pour l'activer lorsque votre compte y a déjà accès ; la variable ne peut pas accorder l'accès elle-même, et les autres options qui désactivent le feedback, comme `DISABLE_FEEDBACK_COMMAND` et la valeur `off` du paramètre [`feedbackDrafts`](/docs/fr/settings-reference#feedbackdrafts), s'appliquent toujours |

376| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Remplace le budget de temps en millisecondes des hooks [SessionEnd](/docs/fr/hooks#sessionend). La valeur sert également de délai d'expiration pour chaque hook qui ne définit pas son propre `timeout`. S'applique à la sortie de session, à `/clear` et au changement de session via `/resume` en mode interactif. Par défaut, le budget est de 1,5 seconde, automatiquement porté au `timeout` par hook le plus élevé configuré dans les fichiers de paramètres, jusqu'à 60 secondes. Les délais d'expiration des hooks fournis par des plugins n'augmentent pas le budget |378| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Remplace le budget de temps en millisecondes des hooks [SessionEnd](/docs/fr/hooks#sessionend). La valeur sert aussi de délai d'expiration pour chaque hook qui ne définit pas son propre `timeout`. S'applique à la sortie de session, à `/clear` et au changement de session via `/resume` en mode interactif. Par défaut, le budget est de 1,5 seconde, automatiquement porté au `timeout` par hook le plus élevé configuré dans les fichiers de paramètres, dans la limite de 60 secondes. Les délais d'expiration des hooks fournis par des plugins n'augmentent pas le budget |

377| `CLAUDE_CODE_SESSION_ID` | Définie automatiquement sur l'ID de la session en cours dans les sous-processus des outils Bash et PowerShell, les sous-processus des [commandes de hook](/docs/fr/hooks) et les sous-processus des [serveurs MCP](/docs/fr/mcp) stdio. Pour Bash, PowerShell et les hooks, elle correspond au champ `session_id` de l'entrée JSON du hook et est mise à jour lors de `/clear`. Un sous-processus de serveur MCP conserve l'ID avec lequel il a été lancé. Avec `--resume <session-id>`, il reçoit l'ID de la session reprise, comme les hooks et Bash. Avec `--continue` ou `--resume` sans ID explicite, il peut recevoir à la place l'ID initial du démarrage. À utiliser pour corréler les scripts et les outils externes avec la session Claude Code qui les a lancés |379| `CLAUDE_CODE_SESSION_ID` | Définie automatiquement sur l'ID de la session en cours dans les sous-processus des outils Bash et PowerShell, les sous-processus des [commandes de hook](/docs/fr/hooks) et les sous-processus des [serveurs MCP](/docs/fr/mcp) stdio. Pour Bash, PowerShell et les hooks, elle correspond au champ `session_id` de l'entrée JSON du hook et est mise à jour lors de `/clear`. Un sous-processus de serveur MCP conserve l'ID avec lequel il a été lancé. Avec `--resume <session-id>`, il reçoit l'ID repris, comme les hooks et Bash. Avec `--continue` ou `--resume` sans ID explicite, il peut recevoir à la place l'ID du démarrage initial. À utiliser pour corréler les scripts et outils externes avec la session Claude Code qui les a lancés |

378| `CLAUDE_CODE_SHELL` | Définit le shell que Claude Code utilise pour exécuter les commandes de l'outil Bash. Accepte un chemin vers un binaire `bash` ou `zsh`, par exemple `/opt/homebrew/bin/bash`. Les autres shells tels que `fish` ne sont pas pris en charge. Si la valeur n'est pas un chemin `bash` ou `zsh` fonctionnel, Claude Code l'ignore et revient à la détection automatique. La détection automatique utilise votre `$SHELL` lorsqu'il pointe vers `bash` ou `zsh`, sinon elle choisit le premier `zsh` puis `bash` fonctionnel trouvé dans votre `PATH` et les emplacements d'installation standard |380| `CLAUDE_CODE_SHELL` | Définit le shell que Claude Code utilise pour exécuter les commandes de l'outil Bash. Accepte un chemin vers un binaire `bash` ou `zsh`, par exemple `/opt/homebrew/bin/bash`. Les autres shells comme `fish` ne sont pas pris en charge. Si la valeur n'est pas un chemin `bash` ou `zsh` fonctionnel, Claude Code l'ignore et se rabat sur la détection automatique. La détection automatique utilise votre `$SHELL` lorsqu'il pointe vers `bash` ou `zsh` ; sinon, elle choisit le premier `zsh`, puis `bash`, fonctionnel trouvé dans votre `PATH` et les emplacements d'installation standard |

379| `CLAUDE_CODE_SHELL_PREFIX` | Préfixe de commande qui encapsule les commandes shell que Claude Code lance : les appels de l'outil Bash, les commandes de [hook](/docs/fr/hooks), les commandes de [barre de statut](/docs/fr/statusline) et les commandes de démarrage des [serveurs MCP](/docs/fr/mcp) stdio. Les hooks PowerShell et les hooks au format exec s'exécutent sans le préfixe. Utile pour la journalisation ou l'audit. Définir un simple chemin d'exécutable tel que `/path/to/logger.sh` exécute chaque commande sous la forme `/path/to/logger.sh '<command>'`. Le wrapper reçoit la ligne de commande sous la forme d'un seul argument entre guillemets shell dans `$1`, il doit donc réévaluer `$1` avec un shell, par exemple `exec bash -c "$1"`. Traiter `$1` comme un simple chemin d'exécutable casse les serveurs MCP stdio qui transmettent des arguments tels que `npx -y <package>`. Pour les appels de l'outil Bash, `$1` contient l'invocation shell complète assemblée par Claude Code, y compris la configuration de l'environnement, et pas seulement la commande exécutée par Claude |381| `CLAUDE_CODE_SHELL_PREFIX` | Préfixe de commande qui encapsule les commandes shell lancées par Claude Code : les appels de l'outil Bash, les commandes de [hook](/docs/fr/hooks), les commandes de [barre de statut](/docs/fr/statusline) et les commandes de démarrage des [serveurs MCP](/docs/fr/mcp) stdio. Les hooks PowerShell et les hooks au format exec s'exécutent sans le préfixe. Utile pour la journalisation ou l'audit. Définir un simple chemin d'exécutable comme `/path/to/logger.sh` exécute chaque commande sous la forme `/path/to/logger.sh '<command>'`. Le wrapper reçoit la ligne de commande sous la forme d'un seul argument échappé pour le shell dans `$1` ; il doit donc réévaluer `$1` avec un shell, par exemple `exec bash -c "$1"`. Traiter `$1` comme un simple chemin d'exécutable casse les serveurs MCP stdio qui passent des arguments comme `npx -y <package>`. Pour les appels de l'outil Bash, `$1` contient l'invocation shell complète assemblée par Claude Code, y compris la configuration de l'environnement, et pas seulement la commande exécutée par Claude |

380| `CLAUDE_CODE_SIMPLE` | Définir sur `1` pour s'exécuter avec un prompt système minimal et uniquement les outils Bash, de lecture de fichiers et de modification de fichiers. Les outils MCP provenant de `--mcp-config` restent disponibles. Désactive la découverte automatique des hooks, des skills, des commandes personnalisées, des sous-agents, des plugins installés, des serveurs MCP, de la mémoire automatique et de CLAUDE.md. Les skills d'un répertoire que vous transmettez avec `--add-dir` sont toujours chargés. Les jetons OAuth et les identifiants du trousseau ne sont pas lus, l'authentification Anthropic doit donc provenir de `ANTHROPIC_API_KEY` ou d'un `apiKeyHelper` dans `--settings`. Équivaut à transmettre [`--bare`](/docs/fr/headless#start-faster-with-bare-mode) |382| `CLAUDE_CODE_SIMPLE` | Définissez sur `1` pour exécuter avec un prompt système minimal et uniquement les outils Bash, de lecture de fichiers et de modification de fichiers. Les outils MCP provenant de `--mcp-config` restent disponibles. Désactive la découverte automatique des hooks, des skills, des commandes personnalisées, des sous-agents, des plugins installés, des serveurs MCP, de la mémoire automatique et de CLAUDE.md. Les skills d'un répertoire que vous passez avec `--add-dir` sont toujours chargés. Les jetons OAuth et les identifiants du trousseau ne sont pas lus ; l'authentification Anthropic doit donc provenir de `ANTHROPIC_API_KEY` ou d'un `apiKeyHelper` dans `--settings`. Équivaut à passer [`--bare`](/docs/fr/headless#start-faster-with-bare-mode) |

381| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Définir sur `1` pour utiliser un prompt système plus court et des descriptions d'outils abrégées sur n'importe quel modèle. Définir sur `0`, `false`, `no` ou `off` pour le désactiver, même sur les modèles où l'expérimentation ou la configuration du serveur l'activeraient sinon. L'ensemble complet des outils, les hooks, les serveurs MCP et la découverte de CLAUDE.md restent activés |383| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Définissez sur `1` pour utiliser un prompt système plus court et des descriptions d'outils abrégées sur n'importe quel modèle. Définissez sur `0`, `false`, `no` ou `off` pour le désactiver, même sur les modèles où l'expérimentation ou la configuration du serveur l'activerait sinon. L'ensemble complet des outils, les hooks, les serveurs MCP et la découverte de CLAUDE.md restent activés |

382| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Ignore l'authentification côté client pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), pour les passerelles qui signent elles-mêmes les requêtes |384| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Ignore l'authentification côté client pour [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), pour les passerelles qui signent elles-mêmes les requêtes |

383| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Définir sur `1` pour désactiver le cache en mémoire du processus des identifiants résolus depuis la chaîne de fournisseurs d'identifiants AWS par défaut, afin que Claude Code résolve la chaîne à chaque requête API. Lorsque le cache est désactivé, un profil reposant sur SSO demande des identifiants à IAM Identity Center à chaque requête. Voir [mise en cache des identifiants et délai d'expiration de la résolution](/docs/fr/amazon-bedrock#credential-caching-and-resolution-timeout). Nécessite Claude Code v2.1.207 ou ultérieur |385| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Définissez sur `1` pour désactiver le cache en mémoire du processus contenant les identifiants résolus à partir de la chaîne de fournisseurs d'identifiants AWS par défaut, afin que Claude Code résolve la chaîne à chaque requête API. Avec le cache désactivé, un profil reposant sur SSO demande des identifiants à IAM Identity Center à chaque requête. Consultez [mise en cache des identifiants et délai d'expiration de la résolution](/docs/fr/amazon-bedrock#credential-caching-and-resolution-timeout). Nécessite Claude Code v2.1.207 ou version ultérieure |

384| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Ignore l'authentification AWS pour Amazon Bedrock (par exemple, lors de l'utilisation d'une passerelle LLM) |386| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Ignore l'authentification AWS pour Amazon Bedrock (par exemple, lors de l'utilisation d'une passerelle LLM) |

385| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Définir sur `1` pour traiter un échec de la vérification de disponibilité du [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) comme une disponibilité, pour les réseaux qui bloquent la requête directe de la vérification vers `api.anthropic.com`. Claude Code respecte toujours une réponse « disabled by your organization » |387| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Définissez sur `1` pour considérer comme disponible le [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) lorsque sa vérification de disponibilité échoue, pour les réseaux qui bloquent la requête directe de cette vérification vers `api.anthropic.com`. Claude Code respecte toujours une réponse « disabled by your organization » |

386| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Définir sur `1` pour ignorer la vérification côté client de la disponibilité du [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways), pour les proxys qui interceptent la requête de vérification au lieu de la refuser. L'API rejette toujours les requêtes en mode rapide lorsque votre organisation a désactivé le mode rapide |388| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Définissez sur `1` pour ignorer la vérification côté client de la disponibilité du [mode rapide](/docs/fr/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways), pour les proxys qui interceptent la requête de cette vérification au lieu de la refuser. L'API rejette toujours les requêtes en mode rapide lorsque le mode rapide est désactivé pour votre organisation |

387| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Ignore l'authentification Azure pour Microsoft Foundry, pour un proxy ou une passerelle qui injecte son propre en-tête `Authorization`. Claude Code envoie les requêtes sans identifiant Azure et conserve l'en-tête `Authorization` que vous fournissez, par exemple via `ANTHROPIC_CUSTOM_HEADERS`. Ignorée lorsque `ANTHROPIC_FOUNDRY_API_KEY` ou `ANTHROPIC_FOUNDRY_AUTH_TOKEN` est défini. Avant la v2.1.203, cette variable empêchait le client Microsoft Foundry d'envoyer des requêtes sauf si une clé API était également définie |389| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Ignore l'authentification Azure pour Microsoft Foundry, pour un proxy ou une passerelle qui injecte son propre en-tête `Authorization`. Claude Code envoie les requêtes sans identifiants Azure et conserve l'en-tête `Authorization` que vous fournissez, par exemple via `ANTHROPIC_CUSTOM_HEADERS`. Ignorée lorsque `ANTHROPIC_FOUNDRY_API_KEY` ou `ANTHROPIC_FOUNDRY_AUTH_TOKEN` est défini. Avant la v2.1.203, cette variable empêchait le client Microsoft Foundry d'envoyer des requêtes, à moins qu'une clé API ne soit également définie |

388| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Ignore l'authentification AWS pour Amazon Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM) |390| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Ignore l'authentification AWS pour Amazon Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM) |

389| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | Les [vérifications de modèles au démarrage](/docs/fr/amazon-bedrock#startup-model-checks) sur [Amazon Bedrock](/docs/fr/amazon-bedrock) et [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) mémorisent sur cette machine, pendant au maximum une journée, les modèles que votre compte ne peut pas invoquer. Définir sur `1` pour désactiver cette mémorisation. Nécessite Claude Code v2.1.285 ou ultérieur |391| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | Les [vérifications de modèles au démarrage](/docs/fr/amazon-bedrock#startup-model-checks) sur [Amazon Bedrock](/docs/fr/amazon-bedrock) et [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) mémorisent sur cette machine, pendant un jour au maximum, les modèles que votre compte ne peut pas invoquer. Définissez sur `1` pour désactiver cette mémorisation. Nécessite Claude Code v2.1.285 ou version ultérieure |

390| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Définir sur `1` pour ne pas écrire l'historique des prompts et les transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n'apparaissent pas dans `--resume`, `--continue` ni dans l'historique accessible avec la flèche haut. Utile pour les sessions scriptées éphémères |392| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Définissez sur `1` pour ne pas écrire l'historique des prompts ni les transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n'apparaissent ni dans `--resume`, ni dans `--continue`, ni dans l'historique accessible avec la flèche haut. Utile pour les sessions scriptées éphémères |

391| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Ignore l'authentification Google pour Google Cloud's Agent Platform (par exemple, lors de l'utilisation d'une passerelle LLM) |393| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Ignore l'authentification Google pour Google Cloud's Agent Platform (par exemple, lors de l'utilisation d'une passerelle LLM) |

392| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Définir sur `1` pour qu'une session démarrée avec `--output-format stream-json` écrive un [message de résultat indiquant pourquoi Claude Code a refusé de démarrer](/docs/fr/agent-sdk/typescript#startup_failure_reason) pour les échecs de démarrage qui se terminent sinon uniquement par stderr. Nécessite Claude Code v2.1.274 ou ultérieur |394| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Définissez sur `1` pour qu'une session démarrée avec `--output-format stream-json` écrive un [message de résultat indiquant pourquoi Claude Code a refusé de démarrer](/docs/fr/agent-sdk/typescript#startup_failure_reason) pour les échecs de démarrage qui, sinon, se terminent uniquement par une sortie sur stderr. Nécessite Claude Code v2.1.274 ou version ultérieure |

393| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Nombre maximal de fois consécutives où un hook [Stop](/docs/fr/hooks#stop) ou [SubagentStop](/docs/fr/hooks#subagentstop) peut empêcher la fin du tour avant que Claude Code ne passe outre et termine tout de même le tour (par défaut : 8). Définir sur `0` pour désactiver le plafond. Augmentez-le si votre hook a légitimement besoin de plus d'itérations pour aboutir |395| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Nombre maximal de fois consécutives où un hook [Stop](/docs/fr/hooks#stop) ou [SubagentStop](/docs/fr/hooks#subagentstop) peut empêcher la fin du tour avant que Claude Code passe outre et termine quand même le tour (par défaut : 8). Définissez sur `0` pour désactiver le plafond. Augmentez cette valeur si votre hook a légitimement besoin de plus d'itérations pour aboutir |

394| `CLAUDE_CODE_SUBAGENT_MODEL` | Le modèle par défaut des [sous-agents](/docs/fr/sub-agents#choose-a-model), des coéquipiers d'une [équipe d'agents](/docs/fr/agent-teams#specify-teammates-and-models) et des agents de [workflow](/docs/fr/workflows) auxquels aucun modèle n'est attribué d'une autre manière. Accepte un alias tel que `haiku` ou un nom de modèle complet. Deux sources ont priorité sur elle : un modèle que Claude transmet lorsqu'il lance l'agent, et un champ `model` dans la définition de l'agent, y compris `inherit`. Pour changer cela, définissez [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/fr/sub-agents#run-every-subagent-on-one-model). Voir [Choisir un modèle](/docs/fr/sub-agents#choose-a-model) pour l'ordre complet. La définir sur `inherit` revient à la laisser non définie. Avant la v2.1.251, cette variable remplaçait à la fois le modèle par invocation et le champ `model` de la définition |396| `CLAUDE_CODE_SUBAGENT_MODEL` | Le modèle par défaut des [sous-agents](/docs/fr/sub-agents#choose-a-model), des coéquipiers d'une [équipe d'agents](/docs/fr/agent-teams#specify-teammates-and-models) et des agents de [workflow](/docs/fr/workflows) auxquels aucun modèle n'est attribué d'une autre manière. Accepte un alias comme `haiku` ou un nom de modèle complet. Deux sources ont priorité sur elle : un modèle que Claude transmet lorsqu'il lance l'agent, et un champ `model` dans la définition de l'agent, y compris `inherit`. Pour changer cela, définissez [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/fr/sub-agents#run-every-subagent-on-one-model). Consultez [Choisir un modèle](/docs/fr/sub-agents#choose-a-model) pour l'ordre complet. La définir sur `inherit` revient à la laisser non définie. Avant la v2.1.251, cette variable remplaçait à la fois le modèle propre à chaque invocation et le champ `model` de la définition |

395| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Définir sur `1` pour imposer un même modèle aux sous-agents, aux coéquipiers et aux agents de workflow. [Exécuter tous les sous-agents sur un même modèle](/docs/fr/sub-agents#run-every-subagent-on-one-model) indique de quel modèle il s'agit. Nécessite Claude Code v2.1.257 ou ultérieur |397| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Définissez sur `1` pour imposer un seul modèle aux sous-agents, aux coéquipiers et aux agents de workflow. [Exécuter tous les sous-agents sur un seul modèle](/docs/fr/sub-agents#run-every-subagent-on-one-model) indique de quel modèle il s'agit. Nécessite Claude Code v2.1.257 ou version ultérieure |

396| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Définir sur `5m` ou `1h`, les seules valeurs acceptées par Claude Code, pour choisir le [TTL du cache de prompts](/docs/fr/prompt-caching#cache-lifetime) des requêtes en dehors de la conversation principale, telles que les [sous-agents](/docs/fr/sub-agents), les workflows et le travail en arrière-plan. A priorité sur le paramètre `subagentPromptCacheTtl` et sur `ENABLE_PROMPT_CACHING_1H`, et `FORCE_PROMPT_CACHING_5M` la remplace. L'API facture les écritures en cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur |398| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Définissez `5m` ou `1h`, les seules valeurs acceptées par Claude Code, pour choisir le [TTL du cache de prompts](/docs/fr/prompt-caching#cache-lifetime) des requêtes hors de la conversation principale, comme les [sous-agents](/docs/fr/sub-agents), les workflows et le travail en arrière-plan. A priorité sur le paramètre `subagentPromptCacheTtl` et sur `ENABLE_PROMPT_CACHING_1H`, et `FORCE_PROMPT_CACHING_5M` la remplace. L'API facture les écritures de cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou version ultérieure |

397| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Définir sur `1` pour retirer les identifiants des environnements des sous-processus (outil Bash, hooks, serveurs MCP stdio) : les identifiants Anthropic et des fournisseurs cloud, toute autre variable que Claude Code reconnaît comme un identifiant, et les identifiants intégrés dans les URL de registres de paquets. Le processus Claude parent conserve ces identifiants pour les appels API, mais les processus enfants ne peuvent pas les lire, ce qui réduit l'exposition aux attaques par injection de prompt qui tentent d'exfiltrer des secrets via l'expansion du shell. Dans la v2.1.251 ou ultérieure, le nettoyage supprime également les variables pointant vers le stockage de configuration de Claude Code (comme `CLAUDE_CONFIG_DIR`), de sorte qu'un processus enfant ne peut pas localiser un répertoire de configuration déplacé. Laissez le nettoyage non défini si un sous-processus a besoin de ces variables. Sous Linux, cela exécute également les sous-processus Bash dans un espace de noms PID isolé afin qu'ils ne puissent pas lire les environnements des processus hôtes via `/proc` ; par effet secondaire, `ps`, `pgrep` et `kill` ne peuvent ni voir ni signaler les processus hôtes. `claude-code-action` la définit automatiquement lorsque `allowed_non_write_users` est configuré |399| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Définissez sur `1` pour retirer les identifiants des environnements des sous-processus que Claude Code démarre, comme les commandes Bash, les hooks et les serveurs MCP stdio. Le nettoyage reconnaît les identifiants au nom de leur variable ou à leur valeur, et conserve les jetons GitHub et les paramètres de proxy. Consultez [Ce que supprime le nettoyage de l'environnement des sous-processus](#what-the-subprocess-environment-scrub-removes). `claude-code-action` la définit automatiquement lorsque `allowed_non_write_users` est configuré |

398| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Définir sur `1` en mode non interactif (le flag `-p`) pour attendre la fin de l'installation des plugins avant la première requête. Sans cela, les plugins s'installent en arrière-plan et peuvent ne pas être disponibles au premier tour. À combiner avec `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` pour limiter l'attente |400| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Définissez sur `1` en mode non interactif (le flag `-p`) pour attendre la fin de l'installation des plugins avant la première requête. Sans cela, les plugins s'installent en arrière-plan et peuvent ne pas être disponibles au premier tour. Combinez-la avec `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` pour limiter l'attente |

399| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Délai d'expiration en millisecondes pour l'installation synchrone des plugins. Lorsqu'il est dépassé, Claude Code continue sans les plugins et consigne une erreur. Aucune valeur par défaut : sans cette variable, l'installation synchrone attend jusqu'à son achèvement |401| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Délai d'expiration en millisecondes pour l'installation synchrone des plugins. Lorsqu'il est dépassé, Claude Code continue sans les plugins et journalise une erreur. Aucune valeur par défaut : sans cette variable, l'installation synchrone attend jusqu'à son achèvement |

400| `CLAUDE_CODE_SYNC_SKILLS` | Définir sur `1` en mode non interactif avec le flag `-p` pour que Claude Code télécharge les skills activés pour votre compte claude.ai lors de cette exécution et attende leur liste, jusqu'à `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, avant d'exécuter la première requête. Les téléchargements eux-mêmes se terminent en arrière-plan, et Claude attend le téléchargement d'un skill lorsqu'il invoque ce skill. Nécessite l'authentification claude.ai. Les sessions de terminal dans lesquelles vous vous connectez avec votre compte claude.ai [téléchargent ces skills](/docs/fr/skills#where-synced-skills-load) dans `~/.claude/skills/synced/` et les resynchronisent environ toutes les 10 minutes sans cette variable ; définissez-la donc uniquement lorsqu'une exécution `-p` a besoin de vos skills actuels dès sa première requête. Avant la v2.1.273, les sessions de terminal ne les téléchargeaient que lors d'une exécution `-p` avec cette variable définie. Le nom de dossier `synced` est [réservé à ce téléchargement](/docs/fr/skills#where-skills-live). Avant la v2.1.227, les skills étaient téléchargés directement dans `~/.claude/skills/`. Claude Code applique des [règles supplémentaires aux skills téléchargés](/docs/fr/skills#how-synced-skills-behave), comme ne pas exécuter leurs commandes `!` sur votre machine |402| `CLAUDE_CODE_SYNC_SKILLS` | Définissez sur `1` en mode non interactif avec le flag `-p` pour que Claude Code télécharge, lors de cette exécution, les skills activés pour votre compte claude.ai et attende leur liste, jusqu'à `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, avant d'exécuter la première requête. Les téléchargements eux-mêmes se terminent en arrière-plan, et Claude attend le téléchargement d'un skill lorsqu'il invoque ce skill. Nécessite l'authentification claude.ai. Les sessions de terminal dans lesquelles vous vous connectez avec votre compte claude.ai [téléchargent ces skills](/docs/fr/skills#where-synced-skills-load) dans `~/.claude/skills/synced/` et les resynchronisent environ toutes les 10 minutes sans cette variable ; ne la définissez donc que lorsqu'une exécution `-p` a besoin de vos skills actuels dès sa première requête. Avant la v2.1.273, les sessions de terminal ne les téléchargeaient que lors d'une exécution `-p` avec cette variable définie. Le nom de dossier `synced` est [réservé à ce téléchargement](/docs/fr/skills#where-skills-live). Avant la v2.1.227, les skills étaient téléchargés directement dans `~/.claude/skills/`. Claude Code applique des [règles supplémentaires aux skills téléchargés](/docs/fr/skills#how-synced-skills-behave), comme le fait de ne pas exécuter leurs commandes `!` sur votre machine |

401| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Délai d'expiration en millisecondes pour la resynchronisation des skills qui s'exécute en cours de session lorsqu'une application construite sur l'[Agent SDK](/docs/fr/agent-sdk/typescript#query-object) recharge les skills (par défaut : 30000). Lorsqu'il est dépassé, le rechargement se poursuit avec les skills déjà arrivés, et les téléchargements restants se terminent en arrière-plan |403| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Délai d'expiration en millisecondes pour la resynchronisation des skills qui s'exécute en cours de session lorsqu'une application construite sur l'[Agent SDK](/docs/fr/agent-sdk/typescript#query-object) recharge les skills (par défaut : 30000). Lorsqu'il est dépassé, le rechargement se poursuit avec les skills déjà arrivés, et les téléchargements restants se terminent en arrière-plan |

402| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Délai d'expiration en millisecondes pendant lequel la première requête attend la liste initiale des skills lorsque `CLAUDE_CODE_SYNC_SKILLS` est défini (par défaut : 5000). Lorsqu'il est dépassé, la première requête s'exécute avec les skills déjà arrivés. Les téléchargements se terminent en arrière-plan dans tous les cas, et Claude attend le téléchargement d'un skill lorsqu'il invoque ce skill |404| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Délai d'expiration en millisecondes pendant lequel la première requête attend la liste initiale des skills lorsque `CLAUDE_CODE_SYNC_SKILLS` est définie (par défaut : 5000). Lorsqu'il est dépassé, la première requête s'exécute avec les skills déjà arrivés. Les téléchargements se terminent en arrière-plan dans tous les cas, et Claude attend le téléchargement d'un skill lorsqu'il invoque ce skill |

403| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Définir sur `false` pour désactiver la coloration syntaxique dans la sortie des diffs. Utile lorsque les couleurs interfèrent avec la configuration de votre terminal. Pour désactiver également la coloration dans les blocs de code et les aperçus de fichiers, utilisez le paramètre [`syntaxHighlightingDisabled`](/docs/fr/settings-reference#syntaxhighlightingdisabled) |405| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Définissez sur `false` pour désactiver la coloration syntaxique dans la sortie des diffs. Utile lorsque les couleurs perturbent la configuration de votre terminal. Pour désactiver également la coloration dans les blocs de code et les aperçus de fichiers, utilisez le paramètre [`syntaxHighlightingDisabled`](/docs/fr/settings-reference#syntaxhighlightingdisabled) |

404| `CLAUDE_CODE_TASK_LIST_ID` | Partage une liste de tâches entre les sessions. Définissez le même ID dans plusieurs instances de Claude Code pour vous coordonner sur une liste de tâches partagée, dans [les sessions qui disposent des outils Task](/docs/fr/tools-reference#task-tool-availability). Voir [Liste des tâches](/docs/fr/interactive-mode#task-list) |406| `CLAUDE_CODE_TASK_LIST_ID` | Partage une liste de tâches entre les sessions. Définissez le même ID dans plusieurs instances de Claude Code pour vous coordonner sur une liste de tâches partagée, dans les [sessions qui disposent des outils Task](/docs/fr/tools-reference#task-tool-availability). Consultez [Liste des tâches](/docs/fr/interactive-mode#task-list) |

405| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Remplace, en millisecondes, la durée pendant laquelle une session non interactive attend à la sortie que son [équipe d'agents](/docs/fr/agent-teams) ait fini de se démanteler. Accepte de 1000 à 60000 ; une valeur hors plage est ignorée et la valeur par défaut de 10000 s'applique. Nécessite Claude Code v2.1.206 ou ultérieur |407| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Remplace, en millisecondes, la durée pendant laquelle une session non interactive attend, à la sortie, que son [équipe d'agents](/docs/fr/agent-teams) ait fini de se démanteler. Accepte une valeur de 1000 à 60000 ; une valeur hors plage est ignorée et la valeur par défaut de 10000 s'applique. Nécessite Claude Code v2.1.206 ou version ultérieure |

406| `CLAUDE_CODE_TMPDIR` | Remplace le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute `/claude-{uid}/` à ce chemin sous Unix, ou `/claude/` sous Windows. Par défaut : `/tmp` sur macOS, `os.tmpdir()` sous Linux et Windows. Sur macOS et Linux, les sous-processus Bash [en sandbox](/docs/fr/sandboxing) reçoivent un `$TMPDIR` de secours court sous le répertoire système par défaut lorsque votre remplacement est un chemin long, car certains outils échouent lorsque les chemins temporaires deviennent trop longs. Les commandes Bash hors sandbox héritent du `$TMPDIR` de votre shell lorsqu'il est défini. Sous Windows natif, lorsque votre shell ne définit pas `$TMPDIR`, une commande Bash qui référence `$TMPDIR` reçoit votre remplacement, ou `%TEMP%` si vous n'en avez pas défini. Les fichiers temporaires propres à Claude Code utilisent toujours votre remplacement. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |408| `CLAUDE_CODE_TMPDIR` | Remplace le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute `/claude-{uid}/` à ce chemin sous Unix, ou `/claude/` sous Windows. Par défaut : `/tmp` sur macOS, `os.tmpdir()` sur Linux et Windows. Sur macOS et Linux, les sous-processus Bash [en sandbox](/docs/fr/sandboxing) reçoivent un `$TMPDIR` de secours court sous le répertoire par défaut du système lorsque votre remplacement est un chemin long, car certains outils échouent lorsque les chemins temporaires deviennent trop longs. Les commandes Bash hors sandbox héritent du `$TMPDIR` de votre shell lorsqu'il est défini. Sous Windows natif, lorsque votre shell ne définit pas `$TMPDIR`, une commande Bash qui fait référence à `$TMPDIR` reçoit votre remplacement, ou `%TEMP%` si vous n'en avez pas défini. Les fichiers temporaires propres à Claude Code utilisent toujours votre remplacement. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |

407| `CLAUDE_CODE_TMUX_TRUECOLOR` | Définir sur n'importe quelle valeur non vide, par exemple `1`, pour autoriser la sortie truecolor 24 bits dans tmux. **La définir sur `0` ou `false` autorise tout de même le truecolor**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour rétablir la limitation à 256 couleurs. Par défaut, Claude Code se limite à 256 couleurs lorsque `$TMUX` est défini, car tmux ne transmet pas les séquences d'échappement truecolor sauf s'il est configuré pour le faire. Définissez-la après avoir ajouté `set -ga terminal-overrides ',*:Tc'` à votre `~/.tmux.conf`. Voir [Configuration du terminal](/docs/fr/terminal-config) pour les autres paramètres tmux |409| `CLAUDE_CODE_TMUX_TRUECOLOR` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour autoriser la sortie truecolor 24 bits dans tmux. **La définir sur `0` ou `false` autorise toujours le truecolor**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour rétablir la limitation à 256 couleurs. Par défaut, Claude Code se limite à 256 couleurs lorsque `$TMUX` est défini, car tmux ne transmet pas les séquences d'échappement truecolor à moins d'être configuré pour le faire. Définissez-la après avoir ajouté `set -ga terminal-overrides ',*:Tc'` à votre `~/.tmux.conf`. Consultez [Configuration du terminal](/docs/fr/terminal-config) pour les autres paramètres tmux |

408| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Sous Linux et WSL, définir sur une liste séparée par des virgules des types de processus que Claude Code [exclut du plafond de mémoire des outils](/docs/fr/tools-reference#memory-limit-on-linux-and-wsl), comme `mcp` ou `lsp`. Définir sur `none` pour plafonner tous les types, ou sur `all-new` pour ne plafonner que les commandes des outils Bash, PowerShell et Monitor. Claude Code maintient les commandes des outils Bash, PowerShell et Monitor sous le plafond, quoi que vous listiez. Nécessite Claude Code v2.1.246 ou ultérieur |410| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Sous Linux et WSL, définissez-la sur une liste, séparée par des virgules, des types de processus que Claude Code [exclut du plafond de mémoire des outils](/docs/fr/tools-reference#memory-limit-on-linux-and-wsl), comme `mcp` ou `lsp`. Définissez `none` pour plafonner tous les types, ou `all-new` pour ne plafonner que les commandes des outils Bash, PowerShell et Monitor. Claude Code maintient les commandes des outils Bash, PowerShell et Monitor sous le plafond, quelle que soit votre liste. Nécessite Claude Code v2.1.246 ou version ultérieure |

409| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Sous Linux et WSL, définir sur une taille telle que `4G` pour [plafonner la mémoire que peuvent utiliser les commandes des outils Bash et PowerShell](/docs/fr/tools-reference#memory-limit-on-linux-and-wsl), ainsi que les commandes de l'outil Monitor dans la v2.1.246 ou ultérieure. Écrivez la taille en chiffres simples, seuls pour un nombre d'octets ou avec un suffixe `K`, `M`, `G` ou `T`. Définir sur `0` ou `off` pour désactiver le plafond. Une fois que le premier processus lancé par Claude Code a activé ou désactivé le plafond, une valeur modifiée prend effet au prochain lancement de `claude`. Nécessite Claude Code v2.1.233 ou ultérieur |411| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Sous Linux et WSL, définissez-la sur une taille comme `4G` pour [plafonner la mémoire que peuvent utiliser les commandes des outils Bash et PowerShell](/docs/fr/tools-reference#memory-limit-on-linux-and-wsl), ainsi que celles de l'outil Monitor à partir de la v2.1.246. Écrivez la taille en chiffres simples, seuls pour un nombre d'octets ou suivis d'un suffixe `K`, `M`, `G` ou `T`. Définissez `0` ou `off` pour désactiver le plafond. Une fois que le premier processus démarré par Claude Code a activé ou désactivé le plafond, une valeur modifiée prend effet au prochain lancement de `claude`. Nécessite Claude Code v2.1.233 ou version ultérieure |

410| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Délai en millisecondes avant que Claude Code annule une boîte de dialogue qu'il transmet à un client distant tel qu'un hôte [Remote Control](/docs/fr/remote-control) ou SDK, ou la boîte de dialogue d'approbation d'un [message inter-sessions retenu](/docs/fr/cross-session-messaging#control-inbound-messages) ; les demandes de permission et les questions `AskUserQuestion` utilisent leurs propres flux et ne sont pas régies par cette variable. Dans Claude Code v2.1.236 ou ultérieur, elle limite également la [demande de consentement aux crédits d'utilisation Fable](/docs/fr/model-config#fable-and-usage-credits) en cours de session dans une session susceptible de s'exécuter sans surveillance. [Contrôler les messages entrants](/docs/fr/cross-session-messaging#control-inbound-messages) et [Sessions non interactives](/docs/fr/cross-session-messaging#non-interactive-sessions) détaillent l'ensemble des règles d'expiration des messages retenus, y compris les cas où le délai ne s'applique pas. Remplace le paramètre [`dialogExpiry`](/docs/fr/settings-reference#dialogexpiry). `0` ou une valeur négative désactive le délai |412| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Définissez sur `1` pour limiter la taille que peut atteindre le [fichier de transcription](/docs/fr/sessions#where-transcripts-are-stored) d'une longue session `-p` ou Agent SDK. Après chaque compaction, une fois que le fichier dépasse 5 Mo, Claude Code supprime l'historique antérieur à cette compaction. La reprise de la session restaure la même conversation, que le fichier ait été réduit ou non. Définissez-la dans l'environnement à partir duquel vous démarrez Claude Code, car un bloc `env` des paramètres ne peut pas l'activer. Nécessite Claude Code v2.1.287 ou version ultérieure |

411| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Utiliser [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) |413| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Délai en millisecondes avant que Claude Code annule une boîte de dialogue qu'il transmet à un client distant, tel qu'un hôte [Remote Control](/docs/fr/remote-control) ou SDK, ou la boîte de dialogue d'approbation d'un [message intersession retenu](/docs/fr/cross-session-messaging#control-inbound-messages) ; les demandes de permission et les questions `AskUserQuestion` utilisent leurs propres flux et ne sont pas régies par cette variable. À partir de Claude Code v2.1.236, elle limite également la [demande de consentement aux crédits d'utilisation Fable](/docs/fr/model-config#fable-and-usage-credits) affichée en cours de session, dans une session susceptible de s'exécuter sans surveillance. [Contrôler les messages entrants](/docs/fr/cross-session-messaging#control-inbound-messages) et [Sessions non interactives](/docs/fr/cross-session-messaging#non-interactive-sessions) décrivent l'ensemble des règles d'expiration des messages retenus, y compris les cas où le délai ne s'applique pas. Remplace le paramètre [`dialogExpiry`](/docs/fr/settings-reference#dialogexpiry). `0` ou une valeur négative désactive le délai |

412| `CLAUDE_CODE_USE_BEDROCK` | Utiliser [Amazon Bedrock](/docs/fr/amazon-bedrock) |414| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Utilise [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) |

413| `CLAUDE_CODE_USE_FOUNDRY` | Utiliser [Microsoft Foundry](/docs/fr/microsoft-foundry) |415| `CLAUDE_CODE_USE_BEDROCK` | Utilise [Amazon Bedrock](/docs/fr/amazon-bedrock) |

414| `CLAUDE_CODE_USE_MANTLE` | Utiliser l'[endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) d'Amazon Bedrock |416| `CLAUDE_CODE_USE_FOUNDRY` | Utilise [Microsoft Foundry](/docs/fr/microsoft-foundry) |

415| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Définir sur `1` pour découvrir les commandes personnalisées, les sous-agents et les styles de sortie à l'aide des API de fichiers de Node.js au lieu de ripgrep. Définissez-la si le binaire ripgrep fourni est indisponible ou bloqué dans votre environnement. N'affecte pas Grep ni les outils de recherche de fichiers |417| `CLAUDE_CODE_USE_MANTLE` | Utilise l'[endpoint Mantle](/docs/fr/amazon-bedrock#use-the-mantle-endpoint) d'Amazon Bedrock |

416| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Contrôle l'outil PowerShell. Sous Windows sans Git Bash, l'outil est activé automatiquement ; définir sur `0` pour le désactiver. Sous Windows avec Git Bash installé, l'outil est activé par défaut pour les comptes claude.ai et Console ; définir sur `1` pour l'activer dans les sessions Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, ou sur `0` pour le désactiver. Sous Linux, macOS et WSL, définir sur `1` pour l'activer, ce qui nécessite `pwsh` dans votre `PATH`. Lorsqu'il est activé sous Windows, Claude peut exécuter des commandes PowerShell nativement au lieu de passer par Git Bash. Voir [Outil PowerShell](/docs/fr/tools-reference#powershell-tool) |418| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Définissez sur `1` pour découvrir les commandes personnalisées, les sous-agents et les styles de sortie à l'aide des API de fichiers de Node.js au lieu de ripgrep. Définissez-la si le binaire ripgrep fourni n'est pas disponible ou est bloqué dans votre environnement. N'affecte ni l'outil Grep ni les outils de recherche de fichiers |

417| `CLAUDE_CODE_USE_VERTEX` | Utiliser [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) |419| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Contrôle l'outil PowerShell. Sous Windows sans Git Bash, l'outil est activé automatiquement ; définissez sur `0` pour le désactiver. Sous Windows avec Git Bash installé, l'outil est activé par défaut pour les comptes claude.ai et Console ; définissez sur `1` pour l'activer dans les sessions Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, ou sur `0` pour le désactiver. Sous Linux, macOS et WSL, définissez sur `1` pour l'activer, ce qui nécessite `pwsh` dans votre `PATH`. Lorsqu'il est activé sous Windows, Claude peut exécuter des commandes PowerShell nativement au lieu de passer par Git Bash. Consultez [Outil PowerShell](/docs/fr/tools-reference#powershell-tool) |

418| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Définir sur le nombre de millisecondes pendant lesquelles [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior) conserve en cache la réponse de chaque URL récupérée. La valeur par défaut est `900000`, soit 15 minutes. N'accepte que des chiffres simples ; `0`, un nombre décimal ou toute autre écriture conserve la valeur par défaut. Claude Code lit la valeur une fois par lancement, de sorte qu'une modification dans un bloc `env` des paramètres s'applique au prochain lancement de `claude`. Nécessite Claude Code v2.1.233 ou ultérieur |420| `CLAUDE_CODE_USE_VERTEX` | Utilise [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) |

419| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite supérieure en millisecondes de la durée pendant laquelle [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior) attend le téléchargement d'une page, y compris les redirections qu'il suit. Un téléchargement qui n'est pas terminé à ce moment-là échoue avec une erreur de délai. La valeur par défaut est `300000`, soit cinq minutes. Définir sur `0` pour supprimer la limite. N'accepte que des chiffres simples ; un nombre décimal ou toute autre écriture conserve la valeur par défaut. Nécessite Claude Code v2.1.268 ou ultérieur |421| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Définissez le nombre de millisecondes pendant lesquelles [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior) conserve en cache la réponse de chaque URL récupérée. La valeur par défaut est `900000`, soit 15 minutes. N'accepte que des chiffres simples ; `0`, un nombre décimal ou toute autre écriture conserve la valeur par défaut. Claude Code lit la valeur une fois par lancement, donc une modification dans un bloc `env` des paramètres s'applique au prochain lancement de `claude`. Nécessite Claude Code v2.1.233 ou version ultérieure |

420| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Nombre d'agents qu'une seule exécution de [workflow](/docs/fr/workflows) exécute simultanément, de `1` à `256`. Par défaut, une exécution lance jusqu'à 16 agents simultanément, moins lorsque Claude Code dispose de moins de CPU ; les appels `agent()` en file d'attente attendent qu'un emplacement se libère. La transcription de chaque agent en cours d'exécution reste dans la mémoire de Claude Code, de sorte que des valeurs plus élevées augmentent l'utilisation de la mémoire. N'accepte que des chiffres simples ; les valeurs hors plage et les autres écritures conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou ultérieur |422| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite supérieure, en millisecondes, du temps pendant lequel [WebFetch](/docs/fr/tools-reference#webfetch-tool-behavior) attend le téléchargement d'une page, y compris les redirections qu'il suit. Un téléchargement qui n'est pas terminé à ce moment-là échoue avec une erreur d'échéance. La valeur par défaut est `300000`, soit cinq minutes. Définissez `0` pour supprimer la limite. N'accepte que des chiffres simples ; un nombre décimal ou toute autre écriture conserve la valeur par défaut. Nécessite Claude Code v2.1.268 ou version ultérieure |

421| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite supérieure, en millisecondes, du temps pendant lequel un agent de [workflow](/docs/fr/workflows) attend que la première réponse d'un agent frère partageant le même préfixe commence avant d'envoyer sa propre première requête. Lorsqu'un fan-out démarre plusieurs agents qui partagent un [préfixe de cache de prompt](/docs/fr/workflows#prompt-caching-in-a-fan-out), Claude Code retient tous les agents sauf le premier pendant au plus cette durée, afin que les autres lisent le préfixe mis en cache au lieu de le traiter chacun sans cache. Valeur par défaut `5000`. Définissez sur `0` pour désactiver l'attente. Lorsque `DISABLE_PROMPT_CACHING` est défini, les agents n'attendent jamais. Nécessite Claude Code v2.1.229 ou ultérieur |423| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Lorsque `CLAUDE_AUTO_BACKGROUND_TASKS` est défini sur `1`, durée pendant laquelle Claude Code attend avant chaque rappel invitant Claude à vérifier les [sous-agents en arrière-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) encore en cours d'exécution. Accepte une ou plusieurs attentes séparées par des virgules, en secondes entières de `1` à `86400`, comme `600` ou `600,1800,3600`. Chaque valeur correspond à l'attente avant le rappel suivant, et la dernière valeur se répète. N'accepte que des chiffres simples ; toute autre valeur ou écriture est considérée comme non définie. Lorsque la variable n'est pas définie, il n'y a aucun rappel. Nécessite Claude Code v2.1.283 ou version ultérieure |

424| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Nombre d'agents qu'une seule exécution de [workflow](/docs/fr/workflows) exécute simultanément, de `1` à `256`. Par défaut, une exécution lance jusqu'à 16 agents simultanément, moins lorsque Claude Code dispose de moins de processeurs ; les appels `agent()` en file d'attente attendent qu'un emplacement se libère. La transcription de chaque agent en cours d'exécution reste dans la mémoire de Claude Code, donc des valeurs plus élevées augmentent l'utilisation de la mémoire. N'accepte que des chiffres simples ; les valeurs hors plage et les autres écritures conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou version ultérieure |

425| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite supérieure, en millisecondes, du temps pendant lequel un agent de [workflow](/docs/fr/workflows) attend que la première réponse d'un agent frère partageant le même préfixe commence avant d'envoyer sa propre première requête. Lorsqu'un fan-out démarre plusieurs agents qui partagent un [préfixe de cache de prompt](/docs/fr/workflows#prompt-caching-in-a-fan-out), Claude Code retient tous les agents sauf le premier pendant cette durée au maximum, afin que les autres lisent le préfixe mis en cache au lieu que chacun le traite sans cache. Valeur par défaut `5000`. Définissez `0` pour désactiver l'attente. Lorsque `DISABLE_PROMPT_CACHING` est défini, les agents n'attendent jamais. Nécessite Claude Code v2.1.229 ou version ultérieure |

422| `CLAUDE_CONFIG_DIR` | Remplace le répertoire de configuration (par défaut : `~/.claude`). Tous les paramètres, l'historique des sessions et les plugins sont stockés sous ce chemin. Pour les identifiants, consultez [où Claude Code stocke les identifiants](/docs/fr/authentication#credential-management). Utile pour exécuter plusieurs comptes côte à côte : par exemple, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |426| `CLAUDE_CONFIG_DIR` | Remplace le répertoire de configuration (par défaut : `~/.claude`). Tous les paramètres, l'historique des sessions et les plugins sont stockés sous ce chemin. Pour les identifiants, consultez [où Claude Code stocke les identifiants](/docs/fr/authentication#credential-management). Utile pour exécuter plusieurs comptes côte à côte : par exemple, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |

423| `CLAUDE_DISABLE_ADOPT` | Définissez sur `1` pour arrêter le travail en arrière-plan en cours au lieu de le reporter lorsque vous mettez une session en arrière-plan en appuyant sur `←` ou avec [`/background`](/docs/fr/agent-view#from-inside-a-session). Claude Code vous demande de confirmer avant la mise en arrière-plan, puis arrête les tâches qui auraient sinon été reportées. Nécessite Claude Code v2.1.195 ou ultérieur |427| `CLAUDE_DISABLE_ADOPT` | Définissez sur `1` pour arrêter le travail en arrière-plan en cours au lieu de le transférer lorsque vous mettez une session en arrière-plan en appuyant sur `←` ou avec [`/background`](/docs/fr/agent-view#from-inside-a-session). Claude Code vous demande de confirmer avant la mise en arrière-plan, puis arrête les tâches qui seraient sinon transférées. Nécessite Claude Code v2.1.195 ou version ultérieure |

424| `CLAUDE_EFFORT` | Définie automatiquement dans les sous-processus de l'outil Bash et les commandes de hook sur le [niveau d'effort](/docs/fr/model-config#adjust-effort-level) en vigueur au démarrage du sous-processus : `low`, `medium`, `high`, `xhigh` ou `max`. Correspond au champ `effort.level` transmis aux [hooks](/docs/fr/hooks). Définie uniquement lorsque le modèle actuel prend en charge le paramètre d'effort |428| `CLAUDE_EFFORT` | Défini automatiquement dans les sous-processus de l'outil Bash et les commandes de hook sur le [niveau d'effort](/docs/fr/model-config#adjust-effort-level) en vigueur au démarrage du sous-processus : `low`, `medium`, `high`, `xhigh` ou `max`. Correspond au champ `effort.level` transmis aux [hooks](/docs/fr/hooks). Défini uniquement lorsque le modèle actuel prend en charge le paramètre d'effort |

425| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Définissez sur `1` pour forcer l'activation du watchdog d'inactivité du streaming au niveau des octets, ou sur `0` pour forcer sa désactivation. `0` désactive également le [délai du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) sur les connexions où ce délai s'applique. Lorsque la variable n'est pas définie, le watchdog est activé par défaut pour les connexions directes à l'API Anthropic et à [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), ainsi que pour les réponses en streaming sur les connexions de [passerelle](/docs/fr/gateways) atteintes via `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL` ; avant la v2.1.222, il ne s'exécutait pas sur ces connexions de passerelle, de sorte que le watchdog au niveau des événements pouvait y signaler un blocage même lorsque des pings keep-alive arrivaient. Pour les délais d'expiration et la façon dont les minuteurs interagissent, consultez [Watchdogs d'inactivité du streaming](/docs/fr/network-config#streaming-idle-watchdogs) |429| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Définissez sur `1` pour forcer l'activation du watchdog d'inactivité de streaming au niveau des octets, ou sur `0` pour forcer sa désactivation. `0` désactive également l'[échéance du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) sur les connexions où cette échéance s'applique. Lorsque la variable n'est pas définie, le watchdog est activé par défaut pour les connexions directes à l'API Anthropic et à [Claude Platform on AWS](/docs/fr/claude-platform-on-aws), ainsi que pour les réponses en streaming sur les connexions de [passerelle](/docs/fr/gateways) atteintes via `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL` ; avant la v2.1.222, il ne s'exécutait pas sur ces connexions de passerelle, de sorte que le watchdog au niveau des événements pouvait y signaler un blocage même pendant la réception de pings keep-alive. Pour les délais d'expiration et l'interaction entre les minuteurs, consultez [Watchdogs d'inactivité de streaming](/docs/fr/network-config#streaming-idle-watchdogs) |

426| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Définissez sur `1` pour activer le watchdog d'inactivité du streaming au niveau des octets sur les réponses Amazon Bedrock `vnd.amazon.eventstream`, ce qui active également le [délai du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) sur les requêtes de streaming Bedrock. Désactivé par défaut. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |430| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Définissez sur `1` pour activer le watchdog d'inactivité de streaming au niveau des octets sur les réponses `vnd.amazon.eventstream` d'Amazon Bedrock, ce qui active également l'[échéance du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) sur les requêtes de streaming Bedrock. Désactivé par défaut. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

427| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Définissez sur `0` pour forcer la désactivation du watchdog d'inactivité du streaming au niveau des événements, ou sur `1` pour forcer son activation. Lorsque la variable n'est pas définie, le watchdog est activé par défaut pour tous les fournisseurs. Avant la v2.1.196, la valeur par défaut en l'absence de définition était contrôlée par le serveur sur l'API Anthropic directe et désactivée sur les autres fournisseurs. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` ; pour les autres minuteurs de blocage qui s'exécutent en parallèle de celui-ci, consultez [Watchdogs d'inactivité du streaming](/docs/fr/network-config#streaming-idle-watchdogs) |431| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Définissez sur `0` pour forcer la désactivation du watchdog d'inactivité de streaming au niveau des événements, ou sur `1` pour forcer son activation. Lorsque la variable n'est pas définie, le watchdog est activé par défaut pour tous les fournisseurs. Avant la v2.1.196, la valeur par défaut en l'absence de définition était contrôlée par le serveur sur l'API Anthropic directe et désactivée sur les autres fournisseurs. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` ; pour les autres minuteurs de blocage qui s'exécutent en parallèle de celui-ci, consultez [Watchdogs d'inactivité de streaming](/docs/fr/network-config#streaming-idle-watchdogs) |

428| `CLAUDE_ENV_FILE` | Chemin vers un script shell dont Claude Code exécute le contenu avant chaque commande Bash dans le même processus shell, de sorte que les exports du fichier sont visibles par la commande. Utilisez-la pour conserver l'activation de virtualenv ou de conda d'une commande à l'autre. Également renseignée dynamiquement par les hooks [SessionStart](/docs/fr/hooks#persist-environment-variables), [Setup](/docs/fr/hooks#setup), [CwdChanged](/docs/fr/hooks#cwdchanged) et [FileChanged](/docs/fr/hooks#filechanged) |432| `CLAUDE_ENV_FILE` | Chemin vers un script shell dont Claude Code exécute le contenu avant chaque commande Bash dans le même processus shell, de sorte que les exports du fichier sont visibles par la commande. Utilisez-le pour conserver l'activation d'un virtualenv ou de conda d'une commande à l'autre. Également renseigné dynamiquement par les hooks [SessionStart](/docs/fr/hooks#persist-environment-variables), [Setup](/docs/fr/hooks#setup), [CwdChanged](/docs/fr/hooks#cwdchanged) et [FileChanged](/docs/fr/hooks#filechanged) |

429| `CLAUDE_JOB_DIR` | Définie par Claude Code dans chaque [session en arrière-plan](/docs/fr/agent-view) sur le répertoire `~/.claude/jobs/<id>` de cette session. Les commandes shell exécutées par la session en héritent. Écrivez les fichiers temporaires dans [`$CLAUDE_JOB_DIR/tmp`](/docs/fr/agent-view#where-state-is-stored). Les appels `Write` et `Edit` de Claude à cet emplacement ne demandent pas de permission, et le répertoire est supprimé lorsque la session est supprimée |433| `CLAUDE_JOB_DIR` | Défini par Claude Code dans chaque [session en arrière-plan](/docs/fr/agent-view) sur le répertoire `~/.claude/jobs/<id>` de cette session. Les commandes shell exécutées par la session en héritent. Écrivez les fichiers temporaires dans [`$CLAUDE_JOB_DIR/tmp`](/docs/fr/agent-view#where-state-is-stored). Les appels `Write` et `Edit` de Claude à cet emplacement ne demandent pas de permission, et le répertoire est supprimé lorsque la session est supprimée |

430| `CLAUDE_PID` | Claude Code la définit sur son propre ID de processus dans les sous-processus qu'il lance : les commandes des outils Bash et PowerShell et les commandes de hook. Sous Linux, l'intégration shell de l'outil Bash l'utilise pour refuser un motif `pkill` qui correspondrait au processus Claude Code lui-même ; consultez [la référence des erreurs](/docs/fr/errors#pkill-pattern-matches-the-claude-code-process). Lisez-la depuis vos propres scripts pour identifier ou signaler délibérément le processus Claude Code parent. Nécessite Claude Code v2.1.214 ou ultérieur |434| `CLAUDE_PID` | Claude Code définit cette variable sur son propre identifiant de processus dans les sous-processus qu'il lance : les commandes des outils Bash et PowerShell et les commandes de hook. Sous Linux, l'intégration shell de l'outil Bash l'utilise pour refuser un motif `pkill` qui correspondrait au processus Claude Code lui-même ; consultez [la référence des erreurs](/docs/fr/errors#pkill-pattern-matches-the-claude-code-process). Lisez-la depuis vos propres scripts pour identifier ou signaler délibérément le processus Claude Code parent. Nécessite Claude Code v2.1.214 ou version ultérieure |

431| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Préfixe des noms de session [Remote Control](/docs/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est fourni. Par défaut, le nom d'hôte de votre machine, ce qui produit des noms comme `myhost-graceful-unicorn`. Le flag CLI `--remote-control-session-name-prefix` définit la même valeur pour une seule invocation |435| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Préfixe des noms de session [Remote Control](/docs/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est fourni. Par défaut, il s'agit du nom d'hôte de votre machine, ce qui produit des noms comme `myhost-graceful-unicorn`. Le flag CLI `--remote-control-session-name-prefix` définit la même valeur pour une seule invocation |

432| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Délai en millisecondes pour le premier octet de réponse d'une requête de streaming, sur les connexions où le [délai du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) s'applique. Pour savoir comment Claude Code le borne, le temps supplémentaire qu'il ajoute pour les corps de requête volumineux et comment il choisit le délai lorsque vous ne définissez pas cette variable, consultez [No response from API](/docs/fr/errors#no-response-from-api). Nécessite Claude Code v2.1.242 ou ultérieur |436| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Échéance, en millisecondes, pour le premier octet de réponse d'une requête en streaming, sur les connexions où l'[échéance du premier octet](/docs/fr/network-config#streaming-idle-watchdogs) s'applique. Pour savoir comment Claude Code la borne, le temps supplémentaire qu'il ajoute pour les corps de requête volumineux et comment il choisit l'échéance lorsque vous ne définissez pas cette variable, consultez [No response from API](/docs/fr/errors#no-response-from-api). Nécessite Claude Code v2.1.242 ou version ultérieure |

433| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration en millisecondes avant que les watchdogs d'inactivité du streaming au niveau des événements et des octets ne ferment une connexion bloquée. Lorsque vous définissez explicitement cette variable, le minimum est `300000` (5 minutes) ; les valeurs inférieures sont silencieusement relevées pour absorber les longues pauses de réflexion étendue et la mise en mémoire tampon du proxy, et le watchdog au niveau des octets plafonne la valeur à 30 minutes. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` a priorité sur cette variable pour le watchdog au niveau des octets. Pour les valeurs par défaut de chaque watchdog en l'absence de définition, consultez [Watchdogs d'inactivité du streaming](/docs/fr/network-config#streaming-idle-watchdogs) |437| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration, en millisecondes, avant que les watchdogs d'inactivité de streaming au niveau des événements et des octets ferment une connexion bloquée. Lorsque vous définissez explicitement cette variable, le minimum est `300000` (5 minutes) ; les valeurs inférieures sont silencieusement ramenées à ce minimum pour absorber les pauses de réflexion étendue et la mise en mémoire tampon des proxys, et le watchdog au niveau des octets plafonne la valeur à 30 minutes. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` a priorité sur cette variable pour le watchdog au niveau des octets. Pour les valeurs par défaut de chaque watchdog en l'absence de définition, consultez [Watchdogs d'inactivité de streaming](/docs/fr/network-config#streaming-idle-watchdogs) |

434| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Supprimée dans la v2.1.260 et désormais sans effet. Limitait auparavant la durée d'exécution, en millisecondes, d'une [commande shell en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) lancée par un [sous-agent](/docs/fr/sub-agents), avec une valeur par défaut de 60 minutes. Consultez [les règles de durée de vie des commandes en arrière-plan](/docs/fr/tools-reference#background-commands) |438| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Supprimée dans la v2.1.260 et désormais sans effet. Limitait auparavant la durée d'exécution, en millisecondes, d'une [commande shell en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) lancée par un [sous-agent](/docs/fr/sub-agents), avec une valeur par défaut de 60 minutes. Consultez [les règles de durée de vie des commandes en arrière-plan](/docs/fr/tools-reference#background-commands) |

435| `DEBUG` | Définissez sur `1` pour activer le mode débogage, équivalent à un lancement avec [`--debug`](/docs/fr/cli-reference#cli-flags). Les logs de débogage sont écrits dans `~/.claude/debug/<session-id>.txt`, ou dans le chemin défini par `CLAUDE_CODE_DEBUG_LOGS_DIR`. Seules les valeurs vraies `1`, `true`, `yes` et `on` activent le mode débogage, de sorte que les motifs d'espace de noms comme `DEBUG=express:*` définis pour d'autres outils ne le déclenchent pas |439| `DEBUG` | Définissez sur `1` pour activer le mode débogage, ce qui équivaut à un lancement avec [`--debug`](/docs/fr/cli-reference#cli-flags). Les logs de débogage sont écrits dans `~/.claude/debug/<session-id>.txt`, ou dans le chemin défini par `CLAUDE_CODE_DEBUG_LOGS_DIR`. Seules les valeurs vraies `1`, `true`, `yes` et `on` activent le mode débogage, donc les motifs d'espace de noms comme `DEBUG=express:*` définis pour d'autres outils ne le déclenchent pas |

436| `DISABLE_AUTOUPDATER` | Définissez sur `1` pour désactiver les mises à jour automatiques en arrière-plan. La commande manuelle `claude update` fonctionne toujours. Utilisez `DISABLE_UPDATES` pour bloquer les deux |440| `DISABLE_AUTOUPDATER` | Définissez sur `1` pour désactiver les mises à jour automatiques en arrière-plan. La commande manuelle `claude update` fonctionne toujours. Utilisez `DISABLE_UPDATES` pour bloquer les deux |

437| `DISABLE_AUTO_COMPACT` | Définissez sur `1` pour désactiver la compaction automatique à l'approche de la limite de contexte. La commande manuelle `/compact` reste disponible. Utilisez-la lorsque vous souhaitez contrôler explicitement le moment où la compaction a lieu. Remplace le paramètre [`autoCompactEnabled`](/docs/fr/settings-reference#autocompactenabled) |441| `DISABLE_AUTO_COMPACT` | Définissez sur `1` pour désactiver la compaction automatique à l'approche de la limite de contexte. La commande manuelle `/compact` reste disponible. Utilisez-la lorsque vous souhaitez contrôler explicitement le moment de la compaction. Remplace le paramètre [`autoCompactEnabled`](/docs/fr/settings-reference#autocompactenabled) |

438| `DISABLE_COMPACT` | Définissez sur `1` pour désactiver toute compaction : à la fois la compaction automatique et la commande manuelle `/compact` |442| `DISABLE_COMPACT` | Définissez sur `1` pour désactiver toute compaction : à la fois la compaction automatique et la commande manuelle `/compact` |

439| `DISABLE_COST_WARNINGS` | Définissez sur `1` pour désactiver les messages d'avertissement de coût |443| `DISABLE_COST_WARNINGS` | Définissez sur `1` pour désactiver les messages d'avertissement de coût |

440| `DISABLE_DOCTOR_COMMAND` | Définissez sur `1` pour masquer le skill de vérification de la configuration [`/doctor`](/docs/fr/commands#all-commands) et son alias `/checkup`. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter de diagnostics de configuration depuis une session. N'affecte pas la commande de terminal `claude doctor`. Avant la v2.1.205, cette variable masquait la commande d'écran de diagnostic `/doctor` |444| `DISABLE_DOCTOR_COMMAND` | Définissez sur `1` pour masquer le skill de vérification de configuration [`/doctor`](/docs/fr/commands#all-commands) et son alias `/checkup`. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter de diagnostics de configuration depuis une session. N'affecte pas la commande de terminal `claude doctor`. Avant la v2.1.205, cette variable masquait la commande de l'écran de diagnostic `/doctor` |

441| `DISABLE_ERROR_REPORTING` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour désactiver le signalement des erreurs. **La définir sur `0` ou `false` le désactive quand même**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour réactiver le signalement des erreurs |445| `DISABLE_ERROR_REPORTING` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour désactiver le signalement des erreurs. **La définir sur `0` ou `false` le désactive quand même**, contrairement à la plupart des variables activé/désactivé ; supprimez la variable pour réactiver le signalement des erreurs |

442| `DISABLE_EXTRA_USAGE_COMMAND` | Définissez sur `1` pour masquer la commande `/usage-credits` qui permet aux utilisateurs d'acheter une utilisation supplémentaire au-delà des limites de débit |446| `DISABLE_EXTRA_USAGE_COMMAND` | Définissez sur `1` pour masquer la commande `/usage-credits` qui permet aux utilisateurs d'acheter une utilisation supplémentaire au-delà des limites de débit |

443| `DISABLE_FEEDBACK_COMMAND` | Définissez sur `1` pour désactiver la commande `/feedback` et les [commentaires rédigés par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior). Désactive également `/bug` et `/share`, qui effectuent leurs signalements par le même chemin ; avant la v2.1.212, il s'agissait d'alias de `/feedback`, de sorte que la commande était désactivée sous tous ses noms. L'ancien nom `DISABLE_BUG_COMMAND` est également accepté |447| `DISABLE_FEEDBACK_COMMAND` | Définissez sur `1` pour désactiver la commande `/feedback` et les [commentaires rédigés par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior). Désactive également `/bug` et `/share`, qui transmettent leurs signalements par le même chemin ; avant la v2.1.212, il s'agissait d'alias de `/feedback`, la commande était donc désactivée sous tous ses noms. L'ancien nom `DISABLE_BUG_COMMAND` est également accepté |

444| `DISABLE_GROWTHBOOK` | Définissez sur `1` ou `true` pour désactiver la récupération des feature flags GrowthBook et utiliser les valeurs par défaut du code pour chaque flag. Cela rend indisponibles [Remote Control](/docs/fr/remote-control#requirements) et les autres [fonctionnalités qui nécessitent la récupération des feature flags](#features-that-need-feature-flag-fetching). La définir sur `0` ou `false` laisse la récupération activée. La journalisation des événements de télémétrie reste activée, sauf si `DISABLE_TELEMETRY` est également défini |448| `DISABLE_GROWTHBOOK` | Définissez sur `1` ou `true` pour désactiver la récupération des feature flags GrowthBook et utiliser les valeurs par défaut du code pour chaque flag. Cela rend [Remote Control](/docs/fr/remote-control#requirements) et les autres [fonctionnalités qui nécessitent la récupération des feature flags](#features-that-need-feature-flag-fetching) indisponibles. La définir sur `0` ou `false` laisse la récupération activée. La journalisation des événements de télémétrie reste activée sauf si `DISABLE_TELEMETRY` est également défini |

445| `DISABLE_INSTALLATION_CHECKS` | Définissez sur `1` pour désactiver les avertissements d'installation. À utiliser uniquement lorsque vous gérez manuellement l'emplacement d'installation, car cela peut masquer des problèmes avec les installations standard |449| `DISABLE_INSTALLATION_CHECKS` | Définissez sur `1` pour désactiver les avertissements d'installation. À utiliser uniquement lorsque vous gérez manuellement l'emplacement d'installation, car cela peut masquer des problèmes avec les installations standard |

446| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Définissez sur `1` pour masquer la commande `/install-github-app`. Déjà masquée lors de l'utilisation de fournisseurs tiers (Amazon Bedrock, l'Agent Platform de Google Cloud ou Microsoft Foundry) |450| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Définissez sur `1` pour masquer la commande `/install-github-app`. Déjà masquée lors de l'utilisation de fournisseurs tiers (Amazon Bedrock, Agent Platform de Google Cloud ou Microsoft Foundry) |

447| `DISABLE_INTERLEAVED_THINKING` | Définissez sur `1` pour empêcher l'envoi de l'en-tête bêta interleaved-thinking. Utile lorsque votre passerelle LLM ou votre fournisseur ne prend pas en charge la [réflexion entrelacée](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |451| `DISABLE_INTERLEAVED_THINKING` | Définissez sur `1` pour empêcher l'envoi de l'en-tête bêta interleaved-thinking. Utile lorsque votre passerelle LLM ou votre fournisseur ne prend pas en charge la [réflexion entrelacée](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

448| `DISABLE_LOGIN_COMMAND` | Définissez sur `1` pour masquer la commande `/login`. Utile lorsque l'authentification est gérée en externe via des clés API ou `apiKeyHelper` |452| `DISABLE_LOGIN_COMMAND` | Définissez sur `1` pour masquer la commande `/login`. Utile lorsque l'authentification est gérée en externe via des clés API ou `apiKeyHelper` |

449| `DISABLE_LOGOUT_COMMAND` | Définissez sur `1` pour masquer la commande `/logout` |453| `DISABLE_LOGOUT_COMMAND` | Définissez sur `1` pour masquer la commande `/logout` |

450| `DISABLE_PROMPT_CACHING` | Définissez sur `1` pour désactiver le [prompt caching](/docs/fr/prompt-caching#disable-prompt-caching) pour tous les modèles (a priorité sur les paramètres par modèle) |454| `DISABLE_PROMPT_CACHING` | Définissez sur `1` pour désactiver le [prompt caching](/docs/fr/prompt-caching#disable-prompt-caching) pour tous les modèles (a priorité sur les paramètres par modèle) |

451| `DISABLE_PROMPT_CACHING_FABLE` | Définissez sur `1` pour désactiver le prompt caching pour les modèles Fable |455| `DISABLE_PROMPT_CACHING_FABLE` | Définissez sur `1` pour désactiver le prompt caching pour les modèles Fable |

452| `DISABLE_PROMPT_CACHING_HAIKU` | Définissez sur `1` pour désactiver le prompt caching pour le [modèle Haiku par défaut](/docs/fr/prompt-caching#disable-prompt-caching), où qu'il s'exécute |456| `DISABLE_PROMPT_CACHING_HAIKU` | Définissez sur `1` pour désactiver le prompt caching pour le [modèle Haiku par défaut](/docs/fr/prompt-caching#disable-prompt-caching), quel que soit l'endroit où il s'exécute |

453| `DISABLE_PROMPT_CACHING_OPUS` | Définissez sur `1` pour désactiver le prompt caching pour le [modèle Opus par défaut](/docs/fr/prompt-caching#disable-prompt-caching) |457| `DISABLE_PROMPT_CACHING_OPUS` | Définissez sur `1` pour désactiver le prompt caching pour le [modèle Opus par défaut](/docs/fr/prompt-caching#disable-prompt-caching) |

454| `DISABLE_PROMPT_CACHING_SONNET` | Définissez sur `1` pour désactiver le prompt caching pour le [modèle Sonnet par défaut](/docs/fr/prompt-caching#disable-prompt-caching) |458| `DISABLE_PROMPT_CACHING_SONNET` | Définissez sur `1` pour désactiver le prompt caching pour le [modèle Sonnet par défaut](/docs/fr/prompt-caching#disable-prompt-caching) |

455| `DISABLE_TELEMETRY` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour désactiver la télémétrie. **La définir sur `0` ou `false` la désactive quand même**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour réactiver la télémétrie. Les événements de télémétrie n'incluent pas de données utilisateur comme le code, les chemins de fichiers ou les commandes Bash. Désactive également la [récupération des feature flags](#features-that-need-feature-flag-fetching). Consultez [Désactiver la télémétrie pour votre organisation](/docs/fr/managed-settings#turn-telemetry-off-for-your-organization) |459| `DISABLE_TELEMETRY` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour désactiver la télémétrie. **La définir sur `0` ou `false` la désactive quand même**, contrairement à la plupart des variables activé/désactivé ; supprimez la variable pour réactiver la télémétrie. Les événements de télémétrie n'incluent pas de données utilisateur comme le code, les chemins de fichiers ou les commandes Bash. Désactive également la [récupération des feature flags](#features-that-need-feature-flag-fetching). Consultez [Désactiver la télémétrie pour votre organisation](/docs/fr/managed-settings#turn-telemetry-off-for-your-organization) |

456| `DISABLE_UPDATES` | Définissez sur `1` pour bloquer toutes les mises à jour, y compris les commandes manuelles `claude update` et `claude install`. Plus strict que `DISABLE_AUTOUPDATER`. À utiliser lorsque vous distribuez Claude Code via vos propres canaux et que les utilisateurs ne doivent pas effectuer eux-mêmes les mises à jour |460| `DISABLE_UPDATES` | Définissez sur `1` pour bloquer toutes les mises à jour, y compris les commandes manuelles `claude update` et `claude install`. Plus strict que `DISABLE_AUTOUPDATER`. À utiliser lorsque vous distribuez Claude Code via vos propres canaux et que les utilisateurs ne doivent pas se mettre à jour eux-mêmes |

457| `DISABLE_UPGRADE_COMMAND` | Définissez sur `1` pour masquer la commande `/upgrade` |461| `DISABLE_UPGRADE_COMMAND` | Définissez sur `1` pour masquer la commande `/upgrade` |

458| `DO_NOT_TRACK` | Définissez sur `1` pour désactiver la télémétrie, avec le même effet que `DISABLE_TELEMETRY`, y compris sur la [récupération des feature flags](#features-that-need-feature-flag-fetching). Claude Code lit cette variable comme un booléen standard, donc `0` laisse la télémétrie activée, et la respecte en tant que convention inter-outils reconnue par de nombreuses CLI de développement |462| `DO_NOT_TRACK` | Définissez sur `1` pour désactiver la télémétrie, avec le même effet que `DISABLE_TELEMETRY`, y compris sur la [récupération des feature flags](#features-that-need-feature-flag-fetching). Claude Code lit cette variable comme un booléen standard, donc `0` laisse la télémétrie activée, et la respecte en tant que convention inter-outils reconnue par de nombreuses CLI de développement |

459| `ENABLE_BETA_TRACING_DETAILED` | Définissez sur `1`, avec `BETA_TRACING_ENDPOINT`, pour activer le [traçage bêta détaillé](/docs/fr/monitoring-usage#traces-beta), qui ajoute des attributs de span porteurs de contenu et le span `claude_code.hook`. Les sessions CLI interactives nécessitent également que votre organisation figure sur la liste d'autorisation de la bêta. Les deux variables sont ignorées dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |463| `ENABLE_BETA_TRACING_DETAILED` | Définissez sur `1`, avec `BETA_TRACING_ENDPOINT`, pour activer le [traçage bêta détaillé](/docs/fr/monitoring-usage#traces-beta), qui ajoute des attributs de span contenant du contenu et le span `claude_code.hook`. Les sessions CLI interactives nécessitent également que votre organisation figure sur la liste d'autorisation de la bêta. Les deux variables sont ignorées dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env) |

460| `ENABLE_CLAUDEAI_MCP_SERVERS` | Définissez sur `false` pour empêcher Claude Code de récupérer les [serveurs MCP claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai). Activé par défaut pour les utilisateurs connectés. Pour désactiver par projet ou par organisation, définissez plutôt [`disableClaudeAiConnectors`](/docs/fr/settings-reference#disableclaudeaiconnectors) dans les paramètres |464| `ENABLE_CLAUDEAI_MCP_SERVERS` | Définissez sur `false` pour empêcher Claude Code de récupérer les [serveurs MCP claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai). Activé par défaut pour les utilisateurs connectés. Pour désactiver par projet ou par organisation, définissez plutôt [`disableClaudeAiConnectors`](/docs/fr/settings-reference#disableclaudeaiconnectors) dans les paramètres |

461| `ENABLE_PROMPT_CACHING_1H` | Définissez sur `1` pour demander un [TTL de cache de prompt](/docs/fr/prompt-caching#cache-lifetime) d'1 heure au lieu des 5 minutes par défaut. Destiné aux utilisateurs de clé API, d'[Amazon Bedrock](/docs/fr/amazon-bedrock), de l'[Agent Platform de Google Cloud](/docs/fr/google-vertex-ai), de [Microsoft Foundry](/docs/fr/microsoft-foundry) et de [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). Les utilisateurs d'un abonnement dans les limites de l'utilisation incluse bénéficient automatiquement du TTL d'1 heure sur la [conversation principale](/docs/fr/prompt-caching#which-ttl-each-request-gets). Les utilisateurs d'un abonnement qui puisent dans leurs [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) peuvent la définir pour conserver le TTL d'1 heure. Les écritures de cache d'1 heure sont facturées à un tarif plus élevé. Pour choisir plutôt le TTL par catégorie de requêtes, utilisez `CLAUDE_CODE_PROMPT_CACHE_TTL` et `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, qui ont priorité sur cette variable |465| `ENABLE_PROMPT_CACHING_1H` | Définissez sur `1` pour demander une [durée de vie (TTL) du cache de prompt](/docs/fr/prompt-caching#cache-lifetime) d'une heure au lieu des 5 minutes par défaut. Destiné aux utilisateurs de clé API, d'[Amazon Bedrock](/docs/fr/amazon-bedrock), de l'[Agent Platform de Google Cloud](/docs/fr/google-vertex-ai), de [Microsoft Foundry](/docs/fr/microsoft-foundry) et de [Claude Platform on AWS](/docs/fr/claude-platform-on-aws). Les utilisateurs d'un abonnement dans les limites de l'utilisation incluse reçoivent automatiquement le TTL d'une heure sur la [conversation principale](/docs/fr/prompt-caching#which-ttl-each-request-gets). Les utilisateurs d'un abonnement qui puisent dans leurs [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) peuvent la définir pour conserver le TTL d'une heure. Les écritures en cache d'une heure sont facturées à un tarif plus élevé. Pour choisir plutôt le TTL par catégorie de requêtes, utilisez `CLAUDE_CODE_PROMPT_CACHE_TTL` et `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, qui ont priorité sur cette variable |

462| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Dépréciée. Utilisez plutôt `ENABLE_PROMPT_CACHING_1H` |466| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Dépréciée. Utilisez plutôt `ENABLE_PROMPT_CACHING_1H` |

463| `ENABLE_TOOL_SEARCH` | Contrôle [MCP Tool Search](/docs/fr/mcp#scale-with-mcp-tool-search). Lorsque la variable n'est pas définie, Claude Code diffère par défaut tous les outils MCP. Il les charge néanmoins dès le départ sur les modèles de l'Agent Platform de Google Cloud antérieurs à la génération Claude 4.5, sur un déploiement Microsoft Foundry hébergé sur Azure, et lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte non first-party. `true` diffère toujours et envoie l'en-tête bêta, sauf sur ces mêmes modèles Agent Platform et déploiements Microsoft Foundry ; les requêtes échouent sur les proxys qui ne prennent pas en charge `tool_reference`. `auto` charge dès le départ lorsque les définitions d'outils tiennent dans 10 % du contexte. `auto:N` définit un seuil personnalisé, comme `auto:5` pour 5 %. `false` charge tous les outils dès le départ. Une valeur que vous définissez vous-même est ignorée lorsque `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` est défini. Avant la v2.1.221, Claude Code désactivait la recherche d'outils pour tous les modèles sur l'Agent Platform de Google Cloud, sauf si vous définissiez cette variable sur `true` |467| `ENABLE_TOOL_SEARCH` | Contrôle [MCP Tool Search](/docs/fr/mcp#scale-with-mcp-tool-search). Lorsqu'elle n'est pas définie, Claude Code diffère par défaut le chargement de tous les outils MCP. Il les charge néanmoins dès le départ sur les modèles de l'Agent Platform de Google Cloud antérieurs à la génération Claude 4.5, sur un déploiement Microsoft Foundry hébergé sur Azure, et lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte non first-party. `true` diffère toujours le chargement et envoie l'en-tête bêta, sauf sur ces mêmes modèles Agent Platform et déploiements Microsoft Foundry ; les requêtes échouent sur les proxys qui ne prennent pas en charge `tool_reference`. `auto` charge dès le départ lorsque les définitions d'outils tiennent dans 10 % du contexte. `auto:N` définit un seuil personnalisé, comme `auto:5` pour 5 %. `false` charge tous les outils dès le départ. Une valeur que vous définissez vous-même est ignorée lorsque `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` est défini. Avant la v2.1.221, Claude Code désactivait la recherche d'outils pour tous les modèles sur l'Agent Platform de Google Cloud, sauf si vous définissiez cette variable sur `true` |

464| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour que Claude Code cesse de réessayer en cas d'erreurs de surcharge répétées pour tous les modèles lorsqu'aucun modèle de secours n'est configuré. **La définir sur `0` ou `false` l'active quand même**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour rétablir le comportement par défaut des nouvelles tentatives. Sans elle, Claude Code cesse de réessayer de cette façon sur les modèles qu'il reconnaît comme des modèles Opus, Fable ou Mythos lorsque vous vous authentifiez avec une clé API ou un [fournisseur tiers](/docs/fr/third-party-integrations) plutôt qu'avec un abonnement Claude. Sur Claude Code v2.1.160 ou ultérieur, Claude Code bascule sur votre [chaîne de modèles de secours](/docs/fr/model-config#fallback-model-chains) configurée en cas d'erreurs de surcharge répétées pour tout modèle principal, de sorte que cette variable n'affecte pas le basculement vers un modèle de secours |468| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour que Claude Code cesse de réessayer en cas d'erreurs de surcharge répétées pour tous les modèles lorsqu'aucun modèle de secours n'est configuré. **La définir sur `0` ou `false` active quand même ce comportement**, contrairement à la plupart des variables activé/désactivé ; supprimez la variable pour restaurer le comportement de nouvelle tentative par défaut. Sans elle, Claude Code cesse de réessayer de cette façon sur les modèles qu'il reconnaît comme des modèles Opus, Fable ou Mythos lorsque vous vous authentifiez avec une clé API ou un [fournisseur tiers](/docs/fr/third-party-integrations) plutôt qu'avec un abonnement Claude. Sur Claude Code v2.1.160 ou version ultérieure, Claude Code bascule sur votre [chaîne de modèles de secours](/docs/fr/model-config#fallback-model-chains) configurée en cas d'erreurs de surcharge répétées pour n'importe quel modèle principal, donc cette variable n'affecte pas le basculement vers un modèle de secours |

465| `FORCE_AUTOUPDATE_PLUGINS` | Définissez sur `1` pour forcer les mises à jour automatiques des plugins même lorsque le programme de mise à jour automatique principal est désactivé via `DISABLE_AUTOUPDATER` |469| `FORCE_AUTOUPDATE_PLUGINS` | Définissez sur `1` pour forcer les mises à jour automatiques des plugins même lorsque le programme de mise à jour automatique principal est désactivé via `DISABLE_AUTOUPDATER` |

466| `FORCE_HYPERLINK` | Définissez sur `1` pour activer les hyperliens OSC 8 cliquables lorsque votre terminal les prend en charge mais n'est pas détecté automatiquement, ou sur `0` pour les désactiver. Lorsque la variable n'est pas définie, Claude Code n'active les hyperliens que lorsqu'il détecte leur prise en charge par le terminal. Claude Code analyse cette valeur comme un nombre et non comme un booléen, de sorte qu'une valeur comme `false`, `no` ou `off` active les hyperliens au lieu de les désactiver. Le [badge de PR ou de merge request](/docs/fr/interactive-mode#pr-review-status) du pied de page s'affiche sous forme d'hyperlien même lorsque Claude Code ne peut pas détecter la prise en charge par le terminal, par exemple via SSH. Définissez `0` pour afficher le badge en texte brut |470| `FORCE_HYPERLINK` | Définissez sur `1` pour activer les hyperliens OSC 8 cliquables lorsque votre terminal les prend en charge mais n'est pas détecté automatiquement, ou sur `0` pour les désactiver. Lorsque la variable n'est pas définie, Claude Code n'active les hyperliens que s'il détecte leur prise en charge par le terminal. Claude Code analyse cette valeur comme un nombre, et non comme un booléen, donc une valeur comme `false`, `no` ou `off` active les hyperliens au lieu de les désactiver. Le [badge de PR ou de merge request](/docs/fr/interactive-mode#pr-review-status) du pied de page s'affiche sous forme d'hyperlien même lorsque Claude Code ne peut pas détecter la prise en charge par le terminal, par exemple via SSH. Définissez `0` pour afficher le badge en texte brut |

467| `FORCE_PROMPT_CACHING_5M` | Définissez sur `1` pour forcer le TTL de cache de prompt de 5 minutes même lorsque le TTL d'1 heure s'appliquerait autrement. Remplace `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` et les paramètres `promptCacheTtl` et `subagentPromptCacheTtl` |471| `FORCE_PROMPT_CACHING_5M` | Définissez sur `1` pour forcer le TTL de 5 minutes du cache de prompt même lorsque le TTL d'une heure s'appliquerait autrement. Remplace `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H`, ainsi que les paramètres `promptCacheTtl` et `subagentPromptCacheTtl` |

468| `HTTP_PROXY` | Spécifie le serveur proxy HTTP pour les connexions réseau |472| `HTTP_PROXY` | Spécifie le serveur proxy HTTP pour les connexions réseau |

469| `HTTPS_PROXY` | Spécifie le serveur proxy HTTPS pour les connexions réseau |473| `HTTPS_PROXY` | Spécifie le serveur proxy HTTPS pour les connexions réseau |

470| `IS_DEMO` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour activer le mode démo : masque votre e-mail et le nom de votre organisation dans l'en-tête et dans la sortie de `/status`, et ignore l'onboarding. **La définir sur `0` ou `false` active quand même le mode démo**, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour le désactiver. Utile lors de la diffusion en streaming ou de l'enregistrement d'une session |474| `IS_DEMO` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour activer le mode démo : masque votre adresse e-mail et le nom de votre organisation dans l'en-tête et la sortie de `/status`, et ignore l'onboarding. **La définir sur `0` ou `false` active quand même le mode démo**, contrairement à la plupart des variables activé/désactivé ; supprimez la variable pour le désactiver. Utile lors de la diffusion en streaming ou de l'enregistrement d'une session |

471| `MAX_MCP_OUTPUT_TOKENS` | Nombre maximal de tokens autorisés dans les réponses des outils MCP. Claude Code affiche un avertissement lorsque la sortie dépasse 10 000 tokens. Les outils qui déclarent [`anthropic/maxResultSizeChars`](/docs/fr/mcp#raise-the-limit-for-a-specific-tool) utilisent plutôt cette limite de caractères pour le contenu textuel, mais le contenu image de ces outils reste soumis à cette variable (par défaut : 25000) |475| `MAX_MCP_OUTPUT_TOKENS` | Nombre maximal de tokens autorisés dans les réponses des outils MCP. Claude Code affiche un avertissement lorsque la sortie dépasse 10 000 tokens. Les outils qui déclarent [`anthropic/maxResultSizeChars`](/docs/fr/mcp#raise-the-limit-for-a-specific-tool) utilisent plutôt cette limite de caractères pour le contenu textuel, mais le contenu image de ces outils reste soumis à cette variable (par défaut : 25000) |

472| `MAX_STRUCTURED_OUTPUT_RETRIES` | Nombre de tentatives que Claude Code autorise lorsque la réponse du modèle échoue à la validation par rapport au [`--json-schema`](/docs/fr/cli-reference#cli-flags) en mode non interactif avec le flag `-p` ; après ce nombre de tentatives infructueuses sans sortie valide, l'exécution échoue. La même limite s'applique lorsque la sortie structurée d'un sous-agent de [workflow](/docs/fr/workflows) échoue à la validation. Par défaut 5, soit une première tentative plus quatre nouvelles tentatives |476| `MAX_STRUCTURED_OUTPUT_RETRIES` | Nombre de tentatives que Claude Code autorise lorsque la réponse du modèle échoue à la validation par rapport au [`--json-schema`](/docs/fr/cli-reference#cli-flags) en mode non interactif avec le flag `-p` ; après ce nombre de tentatives infructueuses sans sortie valide, l'exécution échoue. La même limite s'applique lorsque la sortie structurée d'un sous-agent de [workflow](/docs/fr/workflows) échoue à la validation. La valeur par défaut est 5, soit une première tentative plus quatre nouvelles tentatives |

473| `MAX_THINKING_TOKENS` | Budget de tokens fixe pour la [réflexion étendue](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code le plafonne à un token en dessous du nombre maximal de tokens de sortie de la requête, et jamais en dessous de 1 024. Consultez `CLAUDE_CODE_MAX_OUTPUT_TOKENS` pour savoir comment cette limite est définie. Lorsque la variable n'est pas définie et que la réflexion est activée, les modèles dotés du [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level) choisissent eux-mêmes leur profondeur de réflexion, et les autres modèles utilisent le plafond. Définissez sur `0` pour désactiver la réflexion sur l'API Anthropic, sauf sur Opus 5.5, Sonnet 5.5 et les modèles Fable, dont la réflexion ne peut pas être désactivée. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations), `0` omet plutôt le paramètre `thinking`. Lorsque la réflexion est désactivée sur l'API Anthropic, Claude Code envoie l'effort `high` au lieu d'un niveau supérieur aux modèles dont il sait qu'ils [n'acceptent pas cette combinaison](/docs/fr/errors#effort-isnt-available-with-thinking-turned-off), comme Opus 5. Claude Code ignore les valeurs non nulles sur les modèles à raisonnement adaptatif, sauf sur les modèles où `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` désactive le raisonnement adaptatif |477| `MAX_THINKING_TOKENS` | Budget fixe de tokens pour la [réflexion étendue](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code le plafonne à un token de moins que le nombre maximal de tokens de sortie de la requête, et jamais en dessous de 1 024. Consultez `CLAUDE_CODE_MAX_OUTPUT_TOKENS` pour savoir comment cette limite est définie. Lorsque la variable n'est pas définie et que la réflexion est activée, les modèles dotés du [raisonnement adaptatif](/docs/fr/model-config#adjust-effort-level) choisissent leur propre profondeur de réflexion, et les autres modèles utilisent le plafond. Définissez `0` pour désactiver la réflexion sur l'API Anthropic, sauf sur Opus 5.5, Sonnet 5.5 et les modèles Fable, dont la réflexion ne peut pas être désactivée. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations), `0` omet plutôt le paramètre `thinking`. Lorsque la réflexion est désactivée sur l'API Anthropic, Claude Code envoie l'effort `high` au lieu d'un niveau supérieur aux modèles dont il sait qu'ils [n'acceptent pas cette combinaison](/docs/fr/errors#effort-isnt-available-with-thinking-turned-off), comme Opus 5. Pour une valeur positive, Claude Code ignore le nombre lui-même sur les modèles à raisonnement adaptatif, sauf lorsque `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` désactive le raisonnement adaptatif |

474| `MCP_CLIENT_SECRET` | Secret client OAuth pour les serveurs MCP qui nécessitent des [identifiants préconfigurés](/docs/fr/mcp#use-pre-configured-oauth-credentials). Évite la demande interactive lors de l'ajout d'un serveur avec `--client-secret` |478| `MCP_CLIENT_SECRET` | Secret client OAuth pour les serveurs MCP qui nécessitent des [identifiants préconfigurés](/docs/fr/mcp#use-pre-configured-oauth-credentials). Évite l'invite interactive lors de l'ajout d'un serveur avec `--client-secret` |

475| `MCP_CONNECTION_NONBLOCKING` | Contrôle si le démarrage attend que les serveurs MCP se connectent avant la première requête. Le démarrage MCP est non bloquant par défaut : les serveurs se connectent en arrière-plan et leurs outils deviennent disponibles à mesure qu'ils terminent. Définissez sur `0` pour que Claude Code attende la connexion des serveurs avant la première requête. Les serveurs configurés avec [`alwaysLoad: true`](/docs/fr/mcp#exempt-a-server-from-deferral) font toujours attendre le démarrage malgré tout, sauf lorsqu'ils sont servis depuis le [cache de découverte](/docs/fr/mcp#server-status-detail), car leurs outils doivent être présents lors de la construction du premier prompt. En mode non interactif (`-p`) sans `--input-format stream-json`, Claude Code attend également les serveurs encore en attente avant le premier tour, quelle que soit cette variable. Lorsque vous passez explicitement [`--mcp-config`](/docs/fr/cli-reference#cli-flags), l'attente a une échéance plus longue ; consultez l'entrée de ce flag pour l'exception concernant les serveurs en cache |479| `MCP_CONNECTION_NONBLOCKING` | Contrôle si le démarrage attend la connexion des serveurs MCP avant la première requête. Le démarrage MCP est non bloquant par défaut : les serveurs se connectent en arrière-plan et leurs outils deviennent disponibles au fur et à mesure. Définissez `0` pour que Claude Code attende la connexion des serveurs avant la première requête. Les serveurs configurés avec [`alwaysLoad: true`](/docs/fr/mcp#exempt-a-server-from-deferral) font quand même attendre le démarrage, sauf lorsqu'ils sont servis depuis le [cache de découverte](/docs/fr/mcp#server-status-detail), car leurs outils doivent être présents lors de la construction du premier prompt. En mode non interactif (`-p`) sans `--input-format stream-json`, Claude Code attend également les serveurs encore en attente avant le premier tour, indépendamment de cette variable. Lorsque vous passez explicitement [`--mcp-config`](/docs/fr/cli-reference#cli-flags), l'attente a une échéance plus longue ; consultez l'entrée de ce flag pour l'exception des serveurs en cache |

476| `MCP_CONNECT_TIMEOUT_MS` | Durée, en millisecondes, pendant laquelle le démarrage MCP bloquant attend le lot de connexions avant de capturer la liste des outils (par défaut : 5000). S'applique lorsque `MCP_CONNECTION_NONBLOCKING=0` ou pour les serveurs marqués [`alwaysLoad: true`](/docs/fr/mcp#exempt-a-server-from-deferral). Les serveurs encore en attente à l'échéance continuent de se connecter en arrière-plan. Distinct de `MCP_TIMEOUT`, qui limite la tentative de connexion d'un serveur individuel |480| `MCP_CONNECT_TIMEOUT_MS` | Durée, en millisecondes, pendant laquelle le démarrage MCP bloquant attend le lot de connexions avant de prendre un instantané de la liste des outils (par défaut : 5000). S'applique lorsque `MCP_CONNECTION_NONBLOCKING=0` ou pour les serveurs marqués [`alwaysLoad: true`](/docs/fr/mcp#exempt-a-server-from-deferral). Les serveurs encore en attente à l'échéance continuent de se connecter en arrière-plan. Distinct de `MCP_TIMEOUT`, qui limite la tentative de connexion d'un serveur individuel |

477| `MCP_DISCOVERY_CACHE` | Active ou désactive le [cache de découverte MCP](/docs/fr/mcp#server-status-detail). Lorsque le cache est activé, un serveur HTTP ou SSE distant que vous avez déjà utilisé peut afficher le [statut `cached`](/docs/fr/mcp#server-status-detail), et Claude Code le connecte lors de son premier appel d'outil au lieu du démarrage. Le cache est désactivé par défaut, sauf si un déploiement progressif l'a activé pour votre compte. Définissez sur `1` pour l'activer, ou sur `0` pour le maintenir désactivé même lorsque le déploiement progressif l'a activé. Avant la v2.1.238, le cache était activé par défaut. Le statut `cached` nécessite Claude Code v2.1.221 ou ultérieur |481| `MCP_DISCOVERY_CACHE` | Active ou désactive le [cache de découverte MCP](/docs/fr/mcp#server-status-detail). Lorsque le cache est activé, un serveur HTTP ou SSE distant que vous avez déjà utilisé peut afficher le [statut `cached`](/docs/fr/mcp#server-status-detail), et Claude Code le connecte lors de son premier appel d'outil plutôt qu'au démarrage. Le cache est désactivé par défaut, sauf si un déploiement progressif l'a activé pour votre compte. Définissez `1` pour l'activer, ou `0` pour le garder désactivé même si le déploiement progressif l'a activé. Avant la v2.1.238, le cache était activé par défaut. Le statut `cached` nécessite Claude Code v2.1.221 ou version ultérieure |

478| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Âge maximal, en secondes, d'une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) (par défaut : 14400, soit 4 heures). Lors d'un démarrage où l'entrée est plus ancienne, Claude Code la supprime et connecte le serveur au démarrage, comme lorsque le cache est désactivé. Claude Code plafonne la valeur à 7 jours. Avant la v2.1.238, la valeur par défaut était 86400, soit 24 heures, et Claude Code ne plafonnait pas la valeur |482| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Âge maximal, en secondes, d'une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) (par défaut : 14400, soit 4 heures). Lors d'un démarrage où l'entrée est plus ancienne, Claude Code la supprime et connecte le serveur au démarrage, comme lorsque le cache est désactivé. Claude Code plafonne la valeur à 7 jours. Avant la v2.1.238, la valeur par défaut était 86400, soit 24 heures, et Claude Code ne plafonnait pas la valeur |

479| `MCP_DISCOVERY_CACHE_STRIKES` | Lors d'un démarrage où une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) est plus ancienne que `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code l'actualise en arrière-plan. Cette variable définit combien d'actualisations consécutives peuvent échouer avant que Claude Code ne supprime l'entrée et connecte plutôt le serveur au démarrage suivant (par défaut : 1). Augmentez-la si votre connexion réseau est parfois interrompue, afin qu'une seule actualisation échouée ne supprime pas l'entrée. Nécessite Claude Code v2.1.238 ou ultérieur |483| `MCP_DISCOVERY_CACHE_STRIKES` | Lors d'un démarrage où une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) est plus ancienne que `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code l'actualise en arrière-plan. Cette variable définit le nombre d'actualisations consécutives pouvant échouer avant que Claude Code supprime l'entrée et connecte plutôt le serveur au démarrage suivant (par défaut : 1). Augmentez-la si votre connexion réseau se coupe occasionnellement, afin qu'une seule actualisation échouée ne supprime pas l'entrée. Nécessite Claude Code v2.1.238 ou version ultérieure |

480| `MCP_DISCOVERY_CACHE_TTL_S` | Nombre de secondes pendant lesquelles Claude Code utilise une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) sans l'actualiser (par défaut : 900). Lors d'un démarrage où l'entrée est plus ancienne, Claude Code l'utilise quand même mais l'actualise en arrière-plan. Une fois l'entrée plus ancienne que `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code la supprime à la place. Claude Code plafonne la valeur à `MCP_DISCOVERY_CACHE_MAX_STALE_S`, soit 4 heures par défaut. Avant la v2.1.238, Claude Code ne plafonnait pas la valeur |484| `MCP_DISCOVERY_CACHE_TTL_S` | Nombre de secondes pendant lesquelles Claude Code utilise une entrée du [cache de découverte](/docs/fr/mcp#server-status-detail) sans l'actualiser (par défaut : 900). Lors d'un démarrage où l'entrée est plus ancienne, Claude Code l'utilise quand même mais l'actualise en arrière-plan. Une fois l'entrée plus ancienne que `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code la supprime à la place. Claude Code plafonne la valeur à `MCP_DISCOVERY_CACHE_MAX_STALE_S`, soit 4 heures par défaut. Avant la v2.1.238, Claude Code ne plafonnait pas la valeur |

481| `MCP_OAUTH_CALLBACK_PORT` | Port fixe pour le callback de redirection OAuth, comme alternative à `--callback-port` lors de l'ajout d'un serveur MCP avec des [identifiants préconfigurés](/docs/fr/mcp#use-pre-configured-oauth-credentials) |485| `MCP_OAUTH_CALLBACK_PORT` | Port fixe pour le callback de redirection OAuth, comme alternative à `--callback-port` lors de l'ajout d'un serveur MCP avec des [identifiants préconfigurés](/docs/fr/mcp#use-pre-configured-oauth-credentials) |

482| `MCP_PROTOCOL_NEGOTIATION` | Sur le [runtime client MCP v2](/docs/fr/mcp#mcp-client-runtimes) uniquement, détermine si Claude Code sonde les serveurs pour la révision 2026-07-28 du protocole MCP. Définissez `auto` pour sonder les serveurs HTTP, de connecteur claude.ai et stdio, ou `legacy` pour n'en sonder aucun. Lorsque la variable n'est pas définie, Claude Code sonde les serveurs décrits dans [Runtimes client MCP](/docs/fr/mcp#mcp-client-runtimes). Toute autre valeur est ignorée avec un avertissement dans le log de débogage. Nécessite Claude Code v2.1.221 ou ultérieur |486| `MCP_PROTOCOL_NEGOTIATION` | Uniquement sur le [runtime client MCP v2](/docs/fr/mcp#mcp-client-runtimes), indique si Claude Code sonde les serveurs pour la révision 2026-07-28 du protocole MCP. Définissez `auto` pour sonder les serveurs HTTP, les connecteurs claude.ai et les serveurs stdio, ou `legacy` pour n'en sonder aucun. Lorsque la variable n'est pas définie, Claude Code sonde les serveurs décrits dans [Runtimes client MCP](/docs/fr/mcp#mcp-client-runtimes). Toute autre valeur est ignorée avec un avertissement dans le log de débogage. Nécessite Claude Code v2.1.221 ou version ultérieure |

483| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP distants (HTTP/SSE) à connecter en parallèle au démarrage (par défaut : 20) |487| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP distants (HTTP/SSE) à connecter en parallèle au démarrage (par défaut : 20) |

484| `MCP_SDK_GENERATION` | Fixe le [runtime client MCP](/docs/fr/mcp#mcp-client-runtimes) avec lequel ce processus se connecte aux serveurs MCP : `v1`, basé sur le SDK TypeScript MCP 1.x, ou `v2`, basé sur le [SDK TypeScript MCP 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Sans la variable, Claude Code utilise v2, à partir des versions indiquées dans cette section. Sur Claude Code v2.1.221 ou ultérieur, le runtime v2 vérifie l'émetteur qu'un serveur OAuth MCP renvoie dans sa réponse d'autorisation et fait échouer la connexion avec une erreur commençant par `Issuer mismatch in authorization response` lorsqu'il ne correspond pas. Le runtime v1 n'effectue pas cette vérification. Si vous définissez une valeur non reconnue, Claude Code l'ignore et écrit un avertissement dans le log de débogage. Claude Code lit la valeur une fois par processus. Nécessite Claude Code v2.1.218 ou ultérieur |488| `MCP_SDK_GENERATION` | Fixe le [runtime client MCP](/docs/fr/mcp#mcp-client-runtimes) avec lequel ce processus se connecte aux serveurs MCP : `v1`, basé sur le SDK TypeScript MCP 1.x, ou `v2`, basé sur le [SDK TypeScript MCP 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Sans la variable, Claude Code utilise v2, à partir des versions indiquées dans cette section. Sur Claude Code v2.1.221 ou version ultérieure, le runtime v2 vérifie l'émetteur renvoyé par un serveur OAuth MCP dans sa réponse d'autorisation et fait échouer la connexion avec une erreur commençant par `Issuer mismatch in authorization response` lorsqu'il ne correspond pas. Le runtime v1 n'effectue pas cette vérification. Si vous définissez une valeur non reconnue, Claude Code l'ignore et écrit un avertissement dans le log de débogage. Claude Code lit la valeur une fois par processus. Nécessite Claude Code v2.1.218 ou version ultérieure |

485| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP locaux (stdio) à connecter en parallèle au démarrage (par défaut : 3) |489| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP locaux (stdio) à connecter en parallèle au démarrage (par défaut : 3) |

486| `MCP_TIMEOUT` | Délai d'expiration en millisecondes pour le démarrage du serveur MCP (par défaut : 30000, soit 30 secondes) |490| `MCP_TIMEOUT` | Délai d'expiration en millisecondes pour le démarrage du serveur MCP (par défaut : 30000, soit 30 secondes) |

487| `MCP_TOOL_TIMEOUT` | Délai d'expiration en millisecondes pour l'exécution des outils MCP (par défaut : 100000000, environ 28 heures). Pour un serveur HTTP, SSE ou de connecteur claude.ai, chaque requête expire également après 60 secondes par défaut ; définissez cette variable, ou le `timeout` par serveur, au-dessus de 60000 pour relever cette limite par requête. Une valeur inférieure raccourcit toujours le délai d'expiration global de l'exécution de l'outil, mais laisse la limite par requête à 60 secondes. Les serveurs stdio et WebSocket n'ont pas de minuteur par requête. Un champ `timeout` par serveur dans `.mcp.json` remplace cette valeur pour ce serveur. Un `timeout` par serveur d'au moins 1000 définit également la fenêtre d'inactivité minimale pour les appels d'outils de ce serveur, de sorte que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` ne les interrompt jamais plus tôt ; ce plancher nécessite Claude Code v2.1.203 ou ultérieur. Pour la variable d'environnement, les valeurs inférieures à 1000 sont relevées à une seconde ; pour le champ par serveur, les valeurs inférieures à 1000 sont ignorées |491| `MCP_TOOL_TIMEOUT` | Délai d'expiration en millisecondes pour l'exécution des outils MCP (par défaut : 100000000, soit environ 28 heures). Pour un serveur HTTP, SSE ou connecteur claude.ai, chaque requête expire également après 60 secondes par défaut ; définissez cette variable, ou le `timeout` par serveur, au-dessus de 60000 pour augmenter cette limite par requête. Une valeur inférieure raccourcit quand même le délai d'expiration global d'exécution de l'outil, mais laisse la limite par requête à 60 secondes. Les serveurs stdio et WebSocket n'ont pas de minuteur par requête. Un champ `timeout` par serveur dans `.mcp.json` remplace cette valeur pour ce serveur. Un `timeout` par serveur d'au moins 1000 définit également la fenêtre d'inactivité minimale pour les appels d'outils de ce serveur, de sorte que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` ne les interrompt jamais plus tôt ; ce plancher nécessite Claude Code v2.1.203 ou version ultérieure. Pour la variable d'environnement, les valeurs inférieures à 1000 sont ramenées à une seconde ; pour le champ par serveur, les valeurs inférieures à 1000 sont ignorées |

488| `NO_PROXY` | Liste des domaines et adresses IP vers lesquels les requêtes seront émises directement, en contournant le proxy |492| `NO_PROXY` | Liste des domaines et adresses IP vers lesquels les requêtes sont envoyées directement, en contournant le proxy |

489| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard du SDK OpenTelemetry sur la longueur des valeurs d'attributs. Claude Code plafonne les attributs de télémétrie porteurs de contenu à la plus petite valeur entre celle-ci et `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, afin que le marqueur de troncature reste dans la limite du SDK. Claude Code lit les variantes `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` et `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` de la même façon, et la plus petite valeur définie s'applique à tous les signaux. Nécessite Claude Code v2.1.214 ou ultérieur. Consultez [Surveillance](/docs/fr/monitoring-usage#common-configuration-variables) |493| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard du SDK OpenTelemetry sur la longueur des valeurs d'attribut. Claude Code plafonne les attributs de télémétrie contenant du contenu à la plus petite valeur entre celle-ci et `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, afin que le marqueur de troncature reste dans la limite du SDK. Claude Code lit les variantes `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` et `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` de la même façon, et la plus petite valeur définie s'applique à tous les signaux. Nécessite Claude Code v2.1.214 ou version ultérieure. Consultez [Surveillance](/docs/fr/monitoring-usage#common-configuration-variables) |

490| `OTEL_LOG_ASSISTANT_RESPONSES` | Définissez sur `1` pour inclure le texte de réponse du modèle dans les événements de log OpenTelemetry `assistant_response`. Lorsque la variable n'est pas définie, Claude Code utilise plutôt la valeur de `OTEL_LOG_USER_PROMPTS`. Définissez sur `0` pour garder les réponses masquées même lorsque `OTEL_LOG_USER_PROMPTS` est défini. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Nécessite Claude Code v2.1.193 ou ultérieur. Consultez [Surveillance](/docs/fr/monitoring-usage#assistant-response-event) |494| `OTEL_LOG_ASSISTANT_RESPONSES` | Définissez sur `1` pour inclure le texte de réponse du modèle dans les événements de log OpenTelemetry `assistant_response`. Lorsque la variable n'est pas définie, Claude Code utilise à la place la valeur de `OTEL_LOG_USER_PROMPTS`. Définissez `0` pour garder les réponses masquées même lorsque `OTEL_LOG_USER_PROMPTS` est défini. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Nécessite Claude Code v2.1.193 ou version ultérieure. Consultez [Surveillance](/docs/fr/monitoring-usage#assistant-response-event) |

491| `OTEL_LOG_MANAGED_SETTINGS` | Définissez sur `1` pour ajouter les paramètres gérés masqués, ainsi qu'un condensé SHA-256 des paramètres avant masquage, aux événements de log OpenTelemetry `managed_settings_resolved`. Désactivé par défaut. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés ; une valeur dans les paramètres de projet ou locaux ne l'active pas. Nécessite Claude Code v2.1.274 ou ultérieur. Consultez [Surveillance](/docs/fr/monitoring-usage#managed-settings-resolved-event) |495| `OTEL_LOG_MANAGED_SETTINGS` | Définissez sur `1` pour ajouter les paramètres gérés masqués, ainsi qu'un condensé SHA-256 des paramètres avant masquage, aux événements de log OpenTelemetry `managed_settings_resolved`. Désactivé par défaut. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés ; une valeur dans les paramètres de projet ou locaux ne l'active pas. Nécessite Claude Code v2.1.274 ou version ultérieure. Consultez [Surveillance](/docs/fr/monitoring-usage#managed-settings-resolved-event) |

492| `OTEL_LOG_RAW_API_BODIES` | Émet le JSON des requêtes et réponses de l'API Messages d'Anthropic sous forme d'événements de log `api_request_body` / `api_response_body`. Définissez sur `1` pour des corps intégrés tronqués à la limite de contenu, ou sur `file:<dir>` pour écrire les corps non tronqués sur le disque et émettre plutôt un chemin `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configure la limite de contenu, 60 Ko par défaut. Désactivé par défaut ; les corps incluent l'intégralité de l'historique de conversation. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Consultez [Surveillance](/docs/fr/monitoring-usage#api-request-body-event) |496| `OTEL_LOG_RAW_API_BODIES` | Émet le JSON des requêtes et réponses de l'API Messages d'Anthropic sous forme d'événements de log `api_request_body` / `api_response_body`. Définissez `1` pour des corps inline tronqués à la limite de contenu, ou `file:<dir>` pour écrire les corps non tronqués sur le disque et émettre à la place un chemin `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configure la limite de contenu, 60 Ko par défaut. Désactivé par défaut ; les corps incluent l'intégralité de l'historique de conversation. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Consultez [Surveillance](/docs/fr/monitoring-usage#api-request-body-event) |

493| `OTEL_LOG_TOOL_CONTENT` | Définissez sur `1` pour inclure le contenu des outils dans l'événement de span OpenTelemetry `tool.output`. Les attributs de span transportent le contenu des outils selon [leurs propres conditions](/docs/fr/monitoring-usage#new-context-gates). Nécessite le [traçage](/docs/fr/monitoring-usage#traces-beta). Désactivé par défaut pour protéger les données sensibles. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Consultez [Surveillance](/docs/fr/monitoring-usage#tool-output-span-event) |497| `OTEL_LOG_TOOL_CONTENT` | Définissez sur `1` pour inclure le contenu des outils dans l'événement de span OpenTelemetry `tool.output`. Les attributs de span transportent le contenu des outils selon [leurs propres conditions](/docs/fr/monitoring-usage#new-context-gates). Nécessite le [traçage](/docs/fr/monitoring-usage#traces-beta). Désactivé par défaut pour protéger les données sensibles. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Consultez [Surveillance](/docs/fr/monitoring-usage#tool-output-span-event) |

494| `OTEL_LOG_TOOL_DETAILS` | Définissez sur `1` pour inclure les arguments d'entrée des outils ; les noms des serveurs MCP ; les noms des workflows créés par l'utilisateur ; les chaînes d'erreur brutes en cas d'échec d'un outil ; la `category` de refus sur les événements `api_refusal` ; les vrais noms des agents, skills, plugins et serveurs MCP sur les [métriques de coût et de tokens](/docs/fr/monitoring-usage#cost-counter) ; et d'autres détails des outils dans les métriques, traces et logs OpenTelemetry. Désactivé par défaut pour protéger les données personnelles. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Consultez [Surveillance](/docs/fr/monitoring-usage) |498| `OTEL_LOG_TOOL_DETAILS` | Définissez sur `1` pour inclure les arguments d'entrée des outils ; les noms des serveurs MCP ; les noms des workflows créés par l'utilisateur ; les chaînes d'erreur brutes en cas d'échec d'un outil ; la `category` de refus sur les événements `api_refusal` ; les noms réels des agents, skills, plugins et serveurs MCP sur les [métriques de coût et de tokens](/docs/fr/monitoring-usage#cost-counter) ; et d'autres détails sur les outils dans les métriques, traces et logs OpenTelemetry. Désactivé par défaut pour protéger les données personnelles. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Consultez [Surveillance](/docs/fr/monitoring-usage) |

495| `OTEL_LOG_USER_PROMPTS` | Définissez sur `1` pour inclure le texte des prompts utilisateur dans les traces et logs OpenTelemetry. Désactivé par défaut (les prompts sont masqués). Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Consultez [Surveillance](/docs/fr/monitoring-usage) |499| `OTEL_LOG_USER_PROMPTS` | Définissez sur `1` pour inclure le texte des prompts utilisateur dans les traces et logs OpenTelemetry. Désactivé par défaut (les prompts sont masqués). Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. Consultez [Surveillance](/docs/fr/monitoring-usage) |

496| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Définissez sur `false` pour exclure l'UUID du compte des attributs de métriques (par défaut : inclus). Consultez [Surveillance](/docs/fr/monitoring-usage) |500| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Définissez sur `false` pour exclure l'UUID du compte des attributs de métriques (par défaut : inclus). Consultez [Surveillance](/docs/fr/monitoring-usage) |

497| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Définissez sur `true` pour inclure le point d'entrée de la session dans les attributs de métriques (par défaut : exclu). Ajoutée dans la v2.1.152. Consultez [Surveillance](/docs/fr/monitoring-usage) |501| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Définissez sur `true` pour inclure le point d'entrée de la session dans les attributs de métriques (par défaut : exclu). Ajoutée dans la v2.1.152. Consultez [Surveillance](/docs/fr/monitoring-usage) |

498| `OTEL_METRICS_INCLUDE_REPOSITORY` | Définissez sur `true` pour marquer les métriques et événements OpenTelemetry avec des attributs `vcs.*` identifiant le dépôt de la session (par défaut : exclus). Nécessite Claude Code v2.1.269 ou ultérieur. Consultez [Attributs de dépôt](/docs/fr/monitoring-usage#repository-attributes) |502| `OTEL_METRICS_INCLUDE_REPOSITORY` | Définissez sur `true` pour marquer les métriques et événements OpenTelemetry avec des attributs `vcs.*` identifiant le dépôt de la session (par défaut : exclus). Nécessite Claude Code v2.1.269 ou version ultérieure. Consultez [Attributs de dépôt](/docs/fr/monitoring-usage#repository-attributes) |

499| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Depuis la v2.1.161, Claude Code associe les clés de `OTEL_RESOURCE_ATTRIBUTES` aux libellés des points de données des métriques. Définissez sur `false` pour les exclure (par défaut : incluses). Consultez [Surveillance](/docs/fr/monitoring-usage#multi-team-organization-support) |503| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Depuis la v2.1.161, Claude Code associe les clés `OTEL_RESOURCE_ATTRIBUTES` aux libellés des points de données de métriques. Définissez sur `false` pour les exclure (par défaut : incluses). Consultez [Surveillance](/docs/fr/monitoring-usage#multi-team-organization-support) |

500| `OTEL_METRICS_INCLUDE_SESSION_ID` | Définissez sur `false` pour exclure l'ID de session des attributs de métriques (par défaut : inclus). Consultez [Surveillance](/docs/fr/monitoring-usage) |504| `OTEL_METRICS_INCLUDE_SESSION_ID` | Définissez sur `false` pour exclure l'identifiant de session des attributs de métriques (par défaut : inclus). Consultez [Surveillance](/docs/fr/monitoring-usage) |

501| `OTEL_METRICS_INCLUDE_VERSION` | Définissez sur `true` pour inclure la version de Claude Code dans les attributs de métriques (par défaut : exclue). Consultez [Surveillance](/docs/fr/monitoring-usage) |505| `OTEL_METRICS_INCLUDE_VERSION` | Définissez sur `true` pour inclure la version de Claude Code dans les attributs de métriques (par défaut : exclue). Consultez [Surveillance](/docs/fr/monitoring-usage) |

502| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Remplace le budget de caractères pour les métadonnées des skills présentées à l'[outil Skill](/docs/fr/skills#control-who-invokes-a-skill). Le budget s'ajuste dynamiquement à 1 % de la fenêtre de contexte, avec une valeur de secours de 8 000 caractères. Ancien nom conservé pour la rétrocompatibilité |506| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Remplace le budget de caractères des métadonnées de skills présentées à l'[outil Skill](/docs/fr/skills#control-who-invokes-a-skill). Le budget s'ajuste dynamiquement à 1 % de la fenêtre de contexte, avec une valeur de secours de 8 000 caractères. Ancien nom conservé pour la rétrocompatibilité |

503| `TASK_MAX_OUTPUT_LENGTH` | Supprimée dans la v2.1.277 et désormais sans effet, de même que l'outil `TaskOutput` dont elle définissait la taille. Définissait auparavant le nombre maximal de caractères de la sortie d'une [tâche en arrière-plan](/docs/fr/tools-reference#background-commands) que l'outil `TaskOutput` conservait. Claude lit désormais le fichier de sortie d'une tâche en arrière-plan avec `Read` |507| `TASK_MAX_OUTPUT_LENGTH` | Supprimée dans la v2.1.277 et désormais sans effet, tout comme l'outil `TaskOutput` dont elle définissait la taille. Définissait auparavant le nombre maximal de caractères de la sortie d'une [tâche en arrière-plan](/docs/fr/tools-reference#background-commands) que l'outil `TaskOutput` conservait. Claude lit désormais le fichier de sortie d'une tâche en arrière-plan avec `Read` à la place |

504| `USE_BUILTIN_RIPGREP` | Définissez sur `0` pour utiliser le `rg` installé sur le système au lieu du `rg` inclus avec Claude Code |508| `USE_BUILTIN_RIPGREP` | Définissez sur `0` pour utiliser le `rg` installé sur le système au lieu du `rg` inclus avec Claude Code |

505| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Remplace la région pour Claude 3.5 Haiku lors de l'utilisation de l'Agent Platform de Google Cloud |509| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Remplace la région pour Claude 3.5 Haiku lors de l'utilisation de l'Agent Platform de Google Cloud |

506| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Remplace la région pour Claude 3.5 Sonnet lors de l'utilisation de l'Agent Platform de Google Cloud |510| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Remplace la région pour Claude 3.5 Sonnet lors de l'utilisation de l'Agent Platform de Google Cloud |


522| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Remplace la région pour Claude Fable 5.1 lors de l'utilisation de l'Agent Platform de Google Cloud. Ajoutée dans la v2.1.257 |526| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Remplace la région pour Claude Fable 5.1 lors de l'utilisation de l'Agent Platform de Google Cloud. Ajoutée dans la v2.1.257 |

523| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Remplace la région pour Claude Haiku 4.5 lors de l'utilisation de l'Agent Platform de Google Cloud |527| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Remplace la région pour Claude Haiku 4.5 lors de l'utilisation de l'Agent Platform de Google Cloud |

524 528 

525Les variables standard d'exportateur OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` et les variantes propres à chaque signal) sont également prises en charge. Consultez [Surveillance](/docs/fr/monitoring-usage) pour les détails de configuration.529Les variables standard des exportateurs OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` et les variantes propres à chaque signal) sont également prises en charge. Consultez [Surveillance](/docs/fr/monitoring-usage) pour les détails de configuration.

526 530 

527Définissez `CLAUDE_CODE_ENABLE_TELEMETRY` et les variables OpenTelemetry qui activent l'export, choisissent sa destination ou capturent du contenu dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Claude Code [les ignore dans les paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. `OTEL_RESOURCE_ATTRIBUTES` et les variables d'intervalle, de délai d'expiration et de compression de l'export, comme `OTEL_METRIC_EXPORT_INTERVAL`, s'appliquent toujours depuis les paramètres de projet et locaux.531Définissez `CLAUDE_CODE_ENABLE_TELEMETRY` et les variables OpenTelemetry qui activent l'exportation, choisissent sa destination ou capturent du contenu dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Claude Code [les ignore dans les paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env), à l'exception des valeurs de désactivation décrites dans cette section. `OTEL_RESOURCE_ATTRIBUTES` et les variables d'intervalle, de délai d'expiration et de compression de l'exportation, comme `OTEL_METRIC_EXPORT_INTERVAL`, s'appliquent toujours depuis les paramètres de projet et locaux.

532 

533<h2 id="what-the-subprocess-environment-scrub-removes">

534 Ce que supprime le nettoyage de l'environnement des sous-processus

535</h2>

536 

537Lorsque vous définissez [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](#variables) sur `1`, Claude Code supprime les identifiants des environnements des sous-processus qu'il lance, tels que les commandes Bash, les hooks et les serveurs MCP stdio. Cela réduit ce qu'une attaque par injection de prompt peut lire via l'expansion du shell. Le processus Claude Code conserve les identifiants pour ses propres appels API.

538 

539Le nettoyage reconnaît un identifiant à partir du nom de sa variable ou de la forme de sa valeur : utilisez-le donc comme une couche de protection parmi d'autres, aux côtés de [règles de permission](/docs/fr/permissions) restrictives, plutôt que comme seul contrôle.

540 

541Le tableau indique ce que fait le nettoyage sur des exemples de variables :

542 

543| Exemple de variable | Ce que fait le nettoyage |

544| :- | :- |

545| `ANTHROPIC_API_KEY`, `AWS_SECRET_ACCESS_KEY` | La supprime |

546| `NPM_TOKEN`, `DB_PASSWORD` | La supprime, car le nom ressemble à un identifiant |

547| `DATABASE_URL` contenant un mot de passe | La supprime, car la valeur ressemble à un identifiant |

548| `PIP_INDEX_URL` ou `NPM_CONFIG_REGISTRY` contenant un mot de passe | Conserve l'URL et en retire le nom d'utilisateur et le mot de passe |

549| `CLAUDE_CONFIG_DIR` | La supprime. Nécessite Claude Code v2.1.251 ou une version ultérieure |

550| `GITHUB_TOKEN`, `GH_TOKEN`, `GH_ENTERPRISE_TOKEN`, `GITHUB_ENTERPRISE_TOKEN` | La laisse en place, afin que `gh` et les scripts qui appellent l'API GitHub continuent de fonctionner |

551| `HTTP_PROXY`, `HTTPS_PROXY` | La laisse en place, y compris un [nom d'utilisateur et un mot de passe dans l'URL](/docs/fr/network-config#basic-authentication). Le [sandbox](/docs/fr/sandboxing#network-isolation) peut définir lui-même ces variables pour les commandes exécutées en sandbox |

552| `GIT_CONFIG_COUNT`, `GIT_CONFIG_KEY_<n>`, `GIT_CONFIG_VALUE_<n>` | La laisse en place, quel que soit son contenu |

553| Un secret dont le nom de variable et la valeur ne ressemblent pas à un identifiant | Le laisse en place |

554 

555Comme le nettoyage laisse `GITHUB_TOKEN` en place, accordez à un job GitHub Actions les `permissions` les plus restreintes dont il a besoin. Pour retirer un jeton GitHub des commandes Bash exécutées en sandbox, ajoutez une entrée `deny` sous [`sandbox.credentials`](/docs/fr/sandboxing#protect-credentials).

556 

557Ne définissez pas le nettoyage si un sous-processus a besoin de l'une des variables supprimées.

558 

559Sous Linux, le nettoyage exécute également les sous-processus Bash dans un espace de noms PID isolé, afin qu'ils ne puissent pas lire les environnements des processus de l'hôte via `/proc`. En conséquence, `ps`, `pgrep` et `kill` ne peuvent ni voir les processus de l'hôte ni leur envoyer de signaux.

528 560 

529<h2 id="features-that-need-feature-flag-fetching">561<h2 id="features-that-need-feature-flag-fetching">

530 Fonctionnalités nécessitant la récupération de feature flags562 Fonctionnalités nécessitant la récupération des feature flags

531</h2>563</h2>

532 564 

533Claude Code active certaines fonctionnalités via des feature flags qu'il récupère auprès d'Anthropic. Claude Code ignore cette récupération dans ces sessions :565Claude Code active certaines fonctionnalités au moyen de feature flags qu'il récupère auprès d'Anthropic. Claude Code ignore cette récupération dans les sessions suivantes :

534 566 

535* Une session où vous définissez `DISABLE_GROWTHBOOK`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ; la ligne de chaque variable dans le [tableau des variables](#variables) indique quelles valeurs désactivent la récupération567* Une session dans laquelle vous définissez `DISABLE_GROWTHBOOK`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ; la ligne de chaque variable dans le [tableau des variables](#variables) indique quelles valeurs désactivent la récupération

536* Une session sur un [fournisseur tiers](/docs/fr/third-party-integrations), tel qu'Amazon Bedrock, Claude Platform sur AWS, Agent Platform de Google Cloud, ou Microsoft Foundry, sauf si une plateforme hôte qui intègre Claude Code définit `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`568* Une session sur un [fournisseur tiers](/docs/fr/third-party-integrations), tel qu'Amazon Bedrock, Claude Platform on AWS, Agent Platform de Google Cloud ou Microsoft Foundry, sauf si une plateforme hôte qui intègre Claude Code définit `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`

537* Une session de [passerelle d'applications Claude](/docs/fr/claude-apps-gateway)569* Une session de [passerelle des applications Claude](/docs/fr/claude-apps-gateway)

538 570 

539Avec la récupération désactivée, vous ne pouvez pas :571Lorsque la récupération est désactivée, vous ne pouvez pas :

540 572 

541* Exécuter [`/auto-mode-setup`](/docs/fr/auto-mode-config#generate-environment-entries) pour rédiger les entrées `autoMode.environment`573* Exécuter [`/auto-mode-setup`](/docs/fr/auto-mode-config#generate-environment-entries) pour rédiger des entrées `autoMode.environment`

542* Utiliser [Remote Control](/docs/fr/remote-control) avec `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK` défini. Pour `DISABLE_TELEMETRY` et `DO_NOT_TRACK`, consultez les [exigences de Remote Control](/docs/fr/remote-control#requirements)574* Utiliser [Remote Control](/docs/fr/remote-control) lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK` est défini. Pour `DISABLE_TELEMETRY` et `DO_NOT_TRACK`, consultez les [prérequis de Remote Control](/docs/fr/remote-control#requirements)

543* [Envoyer des messages aux sessions au-delà de cette machine](/docs/fr/cross-session-messaging#message-sessions-on-other-machines) quand [Remote Control](/docs/fr/remote-control#requirements) n'est pas disponible. La messagerie entre les sessions sur cette machine fonctionne avec la récupération désactivée575* [Envoyer des messages à des sessions au-delà de cette machine](/docs/fr/cross-session-messaging#message-sessions-on-other-machines) lorsque [Remote Control](/docs/fr/remote-control#requirements) n'est pas disponible. La messagerie entre sessions sur cette machine fonctionne lorsque la récupération est désactivée

544* Exécuter [`claude import` ou la commande `/import`](/docs/fr/cli-reference#cli-commands)576* Exécuter [`claude import` ou la commande `/import`](/docs/fr/cli-reference#cli-commands)

545* Exécuter [`/skill-doctor`](/docs/fr/skills#find-unused-skills) ou ouvrir son rapport dans l'onglet **Stats** de `/plugin`577* Exécuter [`/skill-doctor`](/docs/fr/skills#find-unused-skills) ou ouvrir son rapport dans l'onglet **Stats** de `/plugin`

546* Synchroniser les [compétences](/docs/fr/skills#where-synced-skills-load) et les [plugins](/docs/fr/plugins/loading#synced-plugins) activés pour votre compte claude.ai dans vos sessions de terminal578* Synchroniser les [skills](/docs/fr/skills#where-synced-skills-load) et les [plugins](/docs/fr/plugins/loading#synced-plugins) activés pour votre compte claude.ai dans vos sessions de terminal

547* Utiliser [l'outil advisor](/docs/fr/advisor#requirements)579* Utiliser [l'outil advisor](/docs/fr/advisor#requirements)

548* Lire ou répondre aux [commentaires sur un artifact](/docs/fr/artifacts#collect-comments-on-an-artifact)580* Lire les [commentaires sur un artefact](/docs/fr/artifacts#collect-comments-on-an-artifact) ou y répondre

549* Faire en sorte que Claude lise [l'artefact public d'une autre organisation](/docs/fr/artifacts#read-an-artifact-shared-with-you)581* Demander à Claude de lire [l'artefact public d'une autre organisation](/docs/fr/artifacts#read-an-artifact-shared-with-you)

550* Faire en sorte que Claude Code sonde les serveurs connecteurs claude.ai ou les serveurs stdio pour [la révision du protocole MCP 2026-07-28](/docs/fr/mcp#mcp-client-runtimes) sauf si vous définissez `MCP_PROTOCOL_NEGOTIATION=auto`582* Demander à Claude Code de sonder les serveurs de connecteurs claude.ai ou les serveurs stdio pour la [révision 2026-07-28 du protocole MCP](/docs/fr/mcp#mcp-client-runtimes), sauf si vous définissez `MCP_PROTOCOL_NEGOTIATION=auto`

551* Obtenir l'[outil PowerShell](/docs/fr/tools-reference#powershell-tool) par défaut pour les comptes claude.ai et Console sur Windows avec Git Bash installé ; Claude Code achemine les commandes shell via Git Bash sauf si vous définissez `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Sur Windows sans Git Bash, l'outil reste activé583* Obtenir l'[outil PowerShell](/docs/fr/tools-reference#powershell-tool) par défaut pour les comptes claude.ai et Console sous Windows avec Git Bash installé ; Claude Code fait passer les commandes shell par Git Bash, sauf si vous définissez `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Sous Windows sans Git Bash, l'outil reste activé

552* Obtenir les [retours rédigés par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior), que Claude Code active via un flag récupéré584* Obtenir des [commentaires rédigés par Claude](/docs/fr/tools-reference#sendfeedback-tool-behavior), que Claude Code active au moyen d'un flag récupéré

553* Faire en sorte que Claude [traite les grands collages comme du texte collé plutôt que du texte saisi](/docs/fr/terminal-config#how-claude-treats-pasted-text) ; le contenu derrière un espace réservé `[Pasted text #N]` atteint Claude sans marquage585* Demander à Claude de [traiter les collages volumineux comme du texte collé plutôt que saisi](/docs/fr/terminal-config#how-claude-treats-pasted-text) ; le contenu derrière un espace réservé `[Pasted text #N]` parvient à Claude sans marquage

554* Faire en sorte que Claude Code [exclue les outils MCP dont le schéma d'entrée serait rejeté par l'API](/docs/fr/mcp#tools-with-invalid-input-schemas) ; il envoie le schéma de toute façon, et une requête qui l'inclut échoue avec [une erreur 400 nommant l'outil par sa position](/docs/fr/errors#tool-input-schema-is-invalid)586* Demander à Claude Code d'[exclure les outils MCP dont l'API rejetterait le schéma d'entrée](/docs/fr/mcp#tools-with-invalid-input-schemas) ; il envoie le schéma malgré tout, et une requête qui l'inclut échoue avec [une erreur 400 désignant l'outil par sa position](/docs/fr/errors#tool-input-schema-is-invalid)

555 587 

556<h3 id="first-session-after-an-install-or-upgrade">588<h3 id="first-session-after-an-install-or-upgrade">

557 Première session après une installation ou une mise à jour589 Première session après une installation ou une mise à niveau

558</h3>590</h3>

559 591 

560Lors de votre première session après l'installation de Claude Code, ou la mise à jour vers une version qui ajoute une fonctionnalité, une [fonctionnalité contrôlée par flag](#features-that-need-feature-flag-fetching) peut être manquante. Cette session peut également démarrer dans un [mode de permission](/docs/fr/permission-modes#which-mode-a-session-starts-in) différent de celui de vos sessions ultérieures. Claude Code récupère les flags lors de cette session, donc votre session suivante dispose de la fonctionnalité et du mode de permission de démarrage habituel.592Lors de votre première session après l'installation de Claude Code, ou après une mise à niveau vers une version qui ajoute une fonctionnalité, une [fonctionnalité soumise à un flag](#features-that-need-feature-flag-fetching) peut être absente. Cette session peut également démarrer dans un [mode de permission](/docs/fr/permission-modes#which-mode-a-session-starts-in) différent de celui de vos sessions ultérieures. Lorsque Claude Code récupère les flags pendant cette session, il les enregistre sur la machine, de sorte que votre session suivante sur cette machine dispose de la fonctionnalité et du mode de permission de démarrage habituel.

593 

594Après une nouvelle installation, dans une session non interactive telle que `claude -p`, l'Agent SDK ou l'extension VS Code, Claude Code peut récupérer les flags avant de [choisir le mode de permission de démarrage](/docs/fr/permission-modes#which-mode-a-session-starts-in), mais il ne les attend pas toujours.

595 

596Dans des configurations comme celles-ci, les sessions suivant la première démarrent également sans flags fraîchement récupérés :

597 

598* **Un environnement vierge à chaque exécution** : si chaque exécution démarre dans un conteneur CI, ou dans tout autre environnement dépourvu des flags enregistrés par une session antérieure, chaque exécution est une première session

599* **Un token de passerelle sans clé API** : si vous vous authentifiez avec `ANTHROPIC_AUTH_TOKEN` sans clé API, et que `ANTHROPIC_BASE_URL` pointe vers un hôte autre que celui d'Anthropic, comme une [passerelle LLM](/docs/fr/llm-gateway), Claude Code ne dispose d'aucun identifiant pour récupérer les flags

561 600 

562Après une installation propre, dans une session non-interactive telle que `claude -p`, le SDK Agent, ou l'extension VS Code, Claude Code peut toujours récupérer les flags avant de [choisir le mode de permission de démarrage](/docs/fr/permission-modes#which-mode-a-session-starts-in).601Pour choisir le mode de permission dans lequel démarrent les sessions de ces configurations, consultez [Démarrer dans un mode de permission différent](/docs/fr/permission-modes#start-in-a-different-mode).

563 602 

564<h2 id="see-also">603<h2 id="see-also">

565 Voir aussi604 Voir aussi

errors.md +19 −1

Details

366| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Avertissements de configuration](#malformed-tool-content-rule) |366| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Avertissements de configuration](#malformed-tool-content-rule) |

367| `... is not matched by file permission checks` | [Avertissements de configuration](#is-not-matched-by-file-permission-checks) |367| `... is not matched by file permission checks` | [Avertissements de configuration](#is-not-matched-by-file-permission-checks) |

368| `... has a wildcard before the rest of the command` | [Avertissements de configuration](#has-a-wildcard-before-the-rest-of-the-command) |368| `... has a wildcard before the rest of the command` | [Avertissements de configuration](#has-a-wildcard-before-the-rest-of-the-command) |

369| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Avertissements de configuration](#denying-bash-also-turns-off-the-powershell-tool) |

369| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Avertissements de configuration](#the-200k-limit-isnt-enforced) |370| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Avertissements de configuration](#the-200k-limit-isnt-enforced) |

370| `[claude-code:unrecognized_model]` | [Avertissements de configuration](#unrecognized-model-id-on-a-request) |371| `[claude-code:unrecognized_model]` | [Avertissements de configuration](#unrecognized-model-id-on-a-request) |

371| `Stale sandbox mask files left by a killed session` | [Avertissements de configuration](#stale-sandbox-mask-files-left-by-a-killed-session) |372| `Stale sandbox mask files left by a killed session` | [Avertissements de configuration](#stale-sandbox-mask-files-left-by-a-killed-session) |


846**Ce qu'il faut faire :**847**Ce qu'il faut faire :**

847 848 

848* Sur Pro et Max, augmentez votre limite de dépenses mensuelles dans [**Settings > Usage**](https://claude.ai/settings/usage) sur claude.ai, ou exécutez `/usage-credits`849* Sur Pro et Max, augmentez votre limite de dépenses mensuelles dans [**Settings > Usage**](https://claude.ai/settings/usage) sur claude.ai, ou exécutez `/usage-credits`

849* Sur Team et Enterprise, augmentez la limite dans [**Admin settings > Usage**](https://claude.ai/admin-settings/usage) si vous gérez la facturation, ou demandez à un administrateur de le faire. `/usage-credits` envoie cette demande à votre administrateur pour vous850* Sur Team et Enterprise, augmentez la limite dans [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) si vous gérez la facturation, ou demandez à un administrateur de le faire. `/usage-credits` envoie cette demande à votre administrateur pour vous

850* Pour la limite d'un canal, demandez à un propriétaire d'organisation ou au gestionnaire du canal de l'augmenter sur claude.ai. Consultez [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) dans la documentation Claude Tag851* Pour la limite d'un canal, demandez à un propriétaire d'organisation ou au gestionnaire du canal de l'augmenter sur claude.ai. Consultez [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) dans la documentation Claude Tag

851* Si le message nomme une heure de réinitialisation pour la fenêtre de votre plan, vous pouvez l'attendre à la place852* Si le message nomme une heure de réinitialisation pour la fenêtre de votre plan, vous pouvez l'attendre à la place

852* Exécutez `/usage` pour voir les fenêtres de votre plan et quand chacune se réinitialise853* Exécutez `/usage` pour voir les fenêtres de votre plan et quand chacune se réinitialise


5636 5637 

5637Dans une [session en arrière-plan](/docs/fr/agent-view) ou avec `--output-format json` ou `stream-json`, Claude Code écrit l'avertissement au journal de débogage au lieu de stderr, donc la sortie lue par machine reste propre. Exécutez avec `--debug` pour la capturer à `~/.claude/debug/<session-id>.txt`. Avant la v2.1.246, Claude Code acceptait ces règles sans avertissement.5638Dans une [session en arrière-plan](/docs/fr/agent-view) ou avec `--output-format json` ou `stream-json`, Claude Code écrit l'avertissement au journal de débogage au lieu de stderr, donc la sortie lue par machine reste propre. Exécutez avec `--debug` pour la capturer à `~/.claude/debug/<session-id>.txt`. Avant la v2.1.246, Claude Code acceptait ces règles sans avertissement.

5638 5639 

5640<h3 id="denying-bash-also-turns-off-the-powershell-tool">

5641 Refuser Bash désactive aussi l'outil PowerShell

5642</h3>

5643 

5644Vous avez supprimé l'outil Bash entier, par exemple avec `--disallowedTools Bash` ou avec une [règle de refus](/docs/fr/permissions#match-all-uses-of-a-tool) `Bash` ou `Bash(*)` seule dans l'un de vos fichiers de paramètres. Sur Windows avec Git Bash installé, [refuser Bash désactive aussi l'outil PowerShell](/docs/fr/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool), donc la session démarre sans aucun outil shell. Claude Code imprime cet avertissement au démarrage :

5645 

5646```text theme={null}

5647Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.

5648```

5649 

5650**À faire :**

5651 

5652* Pour que Claude utilise PowerShell, définissez [`CLAUDE_CODE_USE_POWERSHELL_TOOL`](/docs/fr/env-vars) à `1` dans votre environnement ou dans le bloc `env` d'un fichier de paramètres, comme le montre [Activer l'outil PowerShell](/docs/fr/tools-reference#enable-the-powershell-tool). L'outil PowerShell reste alors activé à côté de votre règle de refus Bash.

5653* Pour bloquer des commandes particulières plutôt que l'outil entier, remplacez l'entrée `Bash` seule par des règles ciblées telles que `Bash(git push *)` dans le même fichier de paramètres ou le même flag. Claude conserve l'outil Bash, et l'outil PowerShell reste désactivé jusqu'à ce que vous définissiez aussi la variable ou ajoutiez une [règle de permission `PowerShell`](/docs/fr/permissions#powershell) ciblée.

5654 

5655Dans une [session en arrière-plan](/docs/fr/agent-view) ou avec `--output-format json` ou `stream-json`, Claude Code écrit l'avertissement au journal de débogage au lieu de stderr. Exécutez avec `--debug` pour le capturer à `~/.claude/debug/<session-id>.txt`. Avant la v2.1.287, Claude Code désactivait l'outil PowerShell de la même façon sans imprimer d'avertissement.

5656 

5639<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">5657<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">

5640 crossSessionInbound doit être l'un de accept, hold, refuse5658 crossSessionInbound doit être l'un de accept, hold, refuse

5641</h3>5659</h3>

fast-mode.md +1 −1

Details

165* **Console** (clients API) : un administrateur l'active dans les [préférences Claude Code](https://platform.claude.com/claude-code/preferences). Le mode rapide est en [aperçu de recherche](#research-preview), donc votre organisation doit également avoir l'accès au mode rapide provisionné avant que les demandes de mode rapide réussissent. Pour obtenir l'accès, contactez votre gestionnaire de compte ou rejoignez la liste d'attente, comme décrit dans [le mode rapide sur l'API Claude](https://platform.claude.com/docs/en/build-with-claude/fast-mode).165* **Console** (clients API) : un administrateur l'active dans les [préférences Claude Code](https://platform.claude.com/claude-code/preferences). Le mode rapide est en [aperçu de recherche](#research-preview), donc votre organisation doit également avoir l'accès au mode rapide provisionné avant que les demandes de mode rapide réussissent. Pour obtenir l'accès, contactez votre gestionnaire de compte ou rejoignez la liste d'attente, comme décrit dans [le mode rapide sur l'API Claude](https://platform.claude.com/docs/en/build-with-claude/fast-mode).

166 166 

167 Sans accès provisionné, l'API rejette chaque demande de mode rapide avec un 429, et Claude Code traite chaque rejet comme une [limite de débit du mode rapide](#handle-rate-limits). Contrairement au délai d'attente d'une limite de débit, les rejets continuent jusqu'à ce que l'accès soit provisionné.167 Sans accès provisionné, l'API rejette chaque demande de mode rapide avec un 429, et Claude Code traite chaque rejet comme une [limite de débit du mode rapide](#handle-rate-limits). Contrairement au délai d'attente d'une limite de débit, les rejets continuent jusqu'à ce que l'accès soit provisionné.

168* **Claude AI** (Team et Enterprise) : un propriétaire l'active dans [Paramètres d'administration > Claude Code](https://claude.ai/admin-settings/claude-code)168* **Claude AI** (Team et Enterprise) : un propriétaire l'active dans [**Paramètres d'administration > Claude Code**](https://claude.ai/admin-settings/claude-code)

169 169 

170Une autre option pour désactiver complètement le mode rapide est de définir `CLAUDE_CODE_DISABLE_FAST_MODE=1`. Consultez [Variables d'environnement](/docs/fr/env-vars).170Une autre option pour désactiver complètement le mode rapide est de définir `CLAUDE_CODE_DISABLE_FAST_MODE=1`. Consultez [Variables d'environnement](/docs/fr/env-vars).

171 171 

Details

248| **Subagents** | Quand généré | Contexte frais avec les skills spécifiées, ou la conversation parent pour un [fork](/docs/fr/sub-agents#fork-the-current-conversation) | Isolé de la session principale |248| **Subagents** | Quand généré | Contexte frais avec les skills spécifiées, ou la conversation parent pour un [fork](/docs/fr/sub-agents#fork-the-current-conversation) | Isolé de la session principale |

249| **Hooks** | Au déclenchement | Rien (s'exécute en externe) | Zéro, sauf si le hook retourne du contexte supplémentaire |249| **Hooks** | Au déclenchement | Rien (s'exécute en externe) | Zéro, sauf si le hook retourne du contexte supplémentaire |

250 250 

251\*Par défaut, les descriptions de skills se chargent au début de la session afin que Claude puisse décider quand les utiliser. Définissez `disable-model-invocation: true` dans le frontmatter d'une skill pour la masquer complètement à Claude jusqu'à ce que vous l'invoquiez manuellement. Pour une skill que vous n'avez pas écrite, définissez [`skillOverrides`](/docs/fr/skills#override-skill-visibility-from-settings) dans les paramètres pour faire la même chose sans modifier son fichier.251\*Définissez [`disable-model-invocation: true`](/docs/fr/skills#control-who-invokes-a-skill) dans le frontmatter d'un skill pour garder sa description hors du contexte de Claude. Pour un skill que vous n'avez pas écrit, définissez [`skillOverrides`](/docs/fr/skills#override-skill-visibility-from-settings) dans les paramètres pour faire la même chose sans modifier son fichier.

252 252 

253<h3 id="understand-how-features-load">253<h3 id="understand-how-features-load">

254 Comprendre comment les fonctionnalités se chargent254 Comprendre comment les fonctionnalités se chargent


278 278 

279 **Ce qui se charge :** Pour les skills invocables par modèle, Claude voit les noms et descriptions dans chaque requête. Quand vous invoquez une skill avec `/<name>` ou que Claude la charge automatiquement, le contenu complet se charge dans votre conversation.279 **Ce qui se charge :** Pour les skills invocables par modèle, Claude voit les noms et descriptions dans chaque requête. Quand vous invoquez une skill avec `/<name>` ou que Claude la charge automatiquement, le contenu complet se charge dans votre conversation.

280 280 

281 **Comment Claude choisit les skills :** Claude associe votre tâche aux descriptions de skills pour décider lesquelles sont pertinentes. Si les descriptions sont vagues ou se chevauchent, Claude peut charger la mauvaise skill ou en manquer une qui aiderait. Pour dire à Claude d'utiliser une skill spécifique, invoquez-la avec `/<name>`. Les skills avec `disable-model-invocation: true` sont invisibles à Claude jusqu'à ce que vous les invoquiez.281 **Comment Claude choisit les skills :** Claude associe votre tâche aux descriptions de skills pour décider lesquels sont pertinents. Si les descriptions sont vagues ou se chevauchent, Claude peut charger le mauvais skill ou en manquer un qui aiderait. Pour dire à Claude d'utiliser un skill spécifique, invoquez-le avec `/<name>`.

282 282 

283 **Coût du contexte :** Faible jusqu'à utilisation. Les skills utilisateur uniquement ont un coût zéro jusqu'à invocation.283 **Coût du contexte :** Faible jusqu'à utilisation. Les skills utilisateur uniquement ont un coût zéro jusqu'à invocation.

284 284 

285 **Dans les subagents :** Les skills fonctionnent différemment dans les subagents. Au lieu du chargement à la demande, les skills listées dans le champ `skills` du subagent sont entièrement préchargées dans son contexte au lancement. Les subagents peuvent toujours découvrir et invoquer les skills de projet, utilisateur et plugin non listées via l'outil Skill.285 **Dans les subagents :** Les skills fonctionnent différemment dans les subagents. Au lieu du chargement à la demande, les skills listées dans le champ `skills` du subagent sont entièrement préchargées dans son contexte au lancement. Les subagents peuvent toujours découvrir et invoquer les skills de projet, utilisateur et plugin non listées via l'outil Skill.

286 286 

287 <Tip>Utilisez `disable-model-invocation: true` pour les skills avec des effets secondaires. Cela économise du contexte et garantit que seul vous les déclenchez.</Tip>287 <Tip>Utilisez `disable-model-invocation: true` pour les skills avec des effets secondaires. Cela économise du contexte et garantit qu'ils ne s'exécutent que lorsque vous les nommez.</Tip>

288 </Tab>288 </Tab>

289 289 

290 <Tab title="Serveurs MCP">290 <Tab title="Serveurs MCP">

fullscreen.md +1 −1

Details

109* **Cliquez sur la ligne `↑ N more` ou `↓ N more` au bord d'une liste** pour sauter à cette extrémité de la liste sans choisir d'option. Nécessite Claude Code v2.1.286 ou version ultérieure.109* **Cliquez sur la ligne `↑ N more` ou `↓ N more` au bord d'une liste** pour sauter à cette extrémité de la liste sans choisir d'option. Nécessite Claude Code v2.1.286 ou version ultérieure.

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

111 * Cliquer développe également la sortie d'une commande shell `!`, qu'il s'agisse d'un résultat tronqué plus ancien ou de la ligne de progression en direct pendant l'exécution de la commande. Nécessite Claude Code v2.1.257 ou version ultérieure.111 * Cliquer développe également la sortie d'une commande shell `!`, qu'il s'agisse d'un résultat tronqué plus ancien ou de la ligne de progression en direct pendant l'exécution de la commande. Nécessite Claude Code v2.1.257 ou version ultérieure.

112 * Cliquer développe également une ligne `Message from @<sender>` atténuée lorsque l'expéditeur est un [coéquipier](/docs/fr/agent-teams) ou un autre agent s'exécutant dans votre session. La ligne d'un message provenant de [l'une de vos autres sessions](/docs/fr/cross-session-messaging#what-a-message-looks-like) affiche également la première ligne du message et n'est pas cliquable, donc appuyez sur `Ctrl+o` pour lire celle-ci.112 * Cliquer développe également une ligne `Message from @<sender>` atténuée lorsque l'expéditeur est un [coéquipier](/docs/fr/agent-teams) ou un autre agent s'exécutant dans votre session.

113* **Maintenez `Cmd` sur macOS, ou `Ctrl` sur Linux et Windows, et cliquez sur une URL ou un chemin de fichier** pour l'ouvrir. Les URLs simples `http://` et `https://` s'ouvrent dans votre navigateur, et les chemins de fichiers dans la sortie d'outil, comme ceux imprimés après une opération Edit ou Write, s'ouvrent dans votre application par défaut. Un simple clic sans le modificateur n'ouvre pas les liens, ce qui correspond au comportement du terminal natif.113* **Maintenez `Cmd` sur macOS, ou `Ctrl` sur Linux et Windows, et cliquez sur une URL ou un chemin de fichier** pour l'ouvrir. Les URLs simples `http://` et `https://` s'ouvrent dans votre navigateur, et les chemins de fichiers dans la sortie d'outil, comme ceux imprimés après une opération Edit ou Write, s'ouvrent dans votre application par défaut. Un simple clic sans le modificateur n'ouvre pas les liens, ce qui correspond au comportement du terminal natif.

114 * Claude Code affiche un chemin réseau (UNC), tel que `\\server\share\file.ts`, en tant que texte brut sans lien, car l'ouverture d'un chemin réseau peut envoyer vos identifiants Windows à l'hôte qu'il désigne.114 * Claude Code affiche un chemin réseau (UNC), tel que `\\server\share\file.ts`, en tant que texte brut sans lien, car l'ouverture d'un chemin réseau peut envoyer vos identifiants Windows à l'hôte qu'il désigne.

115 * Certains terminaux macOS transmettent `Cmd`+clic à l'application en cours d'exécution au lieu d'ouvrir le lien eux-mêmes, et le protocole de souris du terminal n'a aucun moyen d'encoder la clé `Cmd`, donc Claude Code reçoit un simple clic. Dans Ghostty, et dans Warp sur macOS, Claude Code détecte cela et permet à un simple clic sur un lien de l'ouvrir, et maintenir `Cmd` fonctionne toujours.115 * Certains terminaux macOS transmettent `Cmd`+clic à l'application en cours d'exécution au lieu d'ouvrir le lien eux-mêmes, et le protocole de souris du terminal n'a aucun moyen d'encoder la clé `Cmd`, donc Claude Code reçoit un simple clic. Dans Ghostty, et dans Warp sur macOS, Claude Code détecte cela et permet à un simple clic sur un lien de l'ouvrir, et maintenir `Cmd` fonctionne toujours.

Details

295 295 

296Lorsque 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`](/docs/fr/env-vars).296Lorsque 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`](/docs/fr/env-vars).

297 297 

298<h3 id="when-your-organization-enforces-a-model-allowlist">

299 Lorsque votre organisation impose une liste d'autorisation de modèles

300</h3>

301 

302Si vous définissez [`enforceAvailableModels`](/docs/fr/model-config#enforce-the-allowlist-for-the-default-model) dans les paramètres gérés, les vérifications du modèle au démarrage n'utilisent que les modèles autorisés par votre liste `availableModels`. Cela nécessite Claude Code v2.1.287 ou ultérieur. Une liste sans `enforceAvailableModels` ne restreint pas ces vérifications.

303 

304Les vérifications comparent chaque entrée à l'ID de modèle qu'elles enverraient à Agent Platform ; rédigez donc la liste avec ces ID. Cet exemple autorise Opus 4.8 et Sonnet 4.5 :

305 

306```json theme={null}

307{

308 "availableModels": ["claude-opus-4-8", "claude-sonnet-4-5@20250929"],

309 "enforceAvailableModels": true

310}

311```

312 

313Pour les alias, les préfixes de version et les entrées `modelOverrides`, consultez [Épingler les modèles pour les déploiements tiers](/docs/fr/model-config#pin-models-for-third-party-deployments).

314 

298<h3 id="when-a-model-is-disabled-mid-session">315<h3 id="when-a-model-is-disabled-mid-session">

299 Lorsqu'un modèle est désactivé en cours de session316 Lorsqu'un modèle est désactivé en cours de session

300</h3>317</h3>

headless.md +1 −1

Details

59| Ajouts de prompt système | `--append-system-prompt`, `--append-system-prompt-file` |59| Ajouts de prompt système | `--append-system-prompt`, `--append-system-prompt-file` |

60| Paramètres | `--settings <file-or-json>` |60| Paramètres | `--settings <file-or-json>` |

61| Serveurs MCP | `--mcp-config <file-or-json>` |61| Serveurs MCP | `--mcp-config <file-or-json>` |

62| Agents personnalisés | `--agents <json>` |62| [Agents personnalisés](/docs/fr/sub-agents#choose-the-subagent-scope) | `--agents <file-or-json>` |

63| Un plugin | `--plugin-dir <path>`, `--plugin-url <url>` |63| Un plugin | `--plugin-dir <path>`, `--plugin-url <url>` |

64 64 

65Le mode bare limite également ce qui se passe pendant l'exécution de la session :65Le mode bare limite également ce qui se passe pendant l'exécution de la session :

hooks.md +46 −10

Details

438| Champ | Requis | Description |438| Champ | Requis | Description |

439| :- | :- | :- |439| :- | :- | :- |

440| `type` | oui | `"command"`, `"http"`, `"mcp_tool"`, `"prompt"` ou `"agent"` |440| `type` | oui | `"command"`, `"http"`, `"mcp_tool"`, `"prompt"` ou `"agent"` |

441| `if` | non | Syntaxe de règle de permission pour filtrer quand ce hook s'exécute, comme `"Bash(git *)"` ou `"Edit(*.ts)"`. Le hook de commande ne s'exécute que si l'appel d'outil correspond au modèle. Consultez le [tableau de correspondance Bash](#bash-if-matching) ci-dessous pour voir comment les modèles Bash s'évaluent par rapport aux sous-commandes, `$()` et aux backticks. Évalué uniquement sur les événements d'outil : `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest` et `PermissionDenied`. Sur les autres événements, un hook avec `if` défini ne s'exécute jamais. Utilise la même syntaxe que les [règles de permission](/docs/fr/permissions) |441| `if` | non | [Syntaxe de règle de permission](/docs/fr/permissions#permission-rule-syntax) pour filtrer quand ce hook s'exécute, comme `"Bash(git *)"` ou `"Edit(*.ts)"`. Le hook de commande ne s'exécute que si l'appel d'outil correspond au modèle. Consultez le [tableau de correspondance Bash](#bash-if-matching) pour voir comment les modèles Bash s'évaluent par rapport aux sous-commandes, `$()` et aux backticks. Évalué uniquement sur les événements d'outil : `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest` et `PermissionDenied`. Sur les autres événements, un hook avec `if` défini ne s'exécute jamais |

442| `timeout` | non | Secondes avant annulation. Claude Code ne l'applique pas sur un hook de commande que vous exécutez avec [`async: true`](#run-hooks-in-the-background). Valeurs par défaut : 600 pour `command`, `http` et `mcp_tool` ; 30 pour `prompt` ; 60 pour `agent`. Claude Code abaisse la valeur par défaut de `command`, `http` et `mcp_tool` à 30 sur [`UserPromptSubmit`](#userpromptsubmit), [`PreModelSwitch`](#premodelswitch) et [`PostModelSwitch`](#postmodelswitch), et à 10 sur [`MessageDisplay`](#messagedisplay). Les hooks [`SessionEnd`](#sessionend) partagent un budget de 1,5 seconde ; si vos paramètres définissent un `timeout` par hook plus long, Claude Code augmente le budget pour correspondre, jusqu'à 60 secondes |442| `timeout` | non | Secondes avant annulation. Claude Code ne l'applique pas sur un hook de commande que vous exécutez avec [`async: true`](#run-hooks-in-the-background). Valeurs par défaut : 600 pour `command`, `http` et `mcp_tool` ; 30 pour `prompt` ; 60 pour `agent`. Claude Code abaisse la valeur par défaut de `command`, `http` et `mcp_tool` à 30 sur [`UserPromptSubmit`](#userpromptsubmit), [`PreModelSwitch`](#premodelswitch) et [`PostModelSwitch`](#postmodelswitch), et à 10 sur [`MessageDisplay`](#messagedisplay). Les hooks [`SessionEnd`](#sessionend) partagent un budget de 1,5 seconde ; si vos paramètres définissent un `timeout` par hook plus long, Claude Code augmente le budget pour correspondre, jusqu'à 60 secondes |

443| `statusMessage` | non | Message de spinner personnalisé affiché pendant l'exécution du hook |443| `statusMessage` | non | Message de spinner personnalisé affiché pendant l'exécution du hook |

444| `once` | non | Si `true`, Claude Code supprime le hook après sa première exécution réussie. Une exécution qui échoue, bloque avec le code de sortie 2 ou expire laisse le hook en place, donc il s'exécute à nouveau au prochain événement correspondant. Honoré uniquement pour les hooks déclarés dans le [frontmatter des skills](#hooks-in-skills-and-agents) ; ignoré dans les fichiers de paramètres et le frontmatter des agents |444| `once` | non | Si `true`, Claude Code supprime le hook après sa première exécution réussie. Une exécution qui échoue, bloque avec le code de sortie 2 ou expire laisse le hook en place, donc il s'exécute à nouveau au prochain événement correspondant. Honoré uniquement pour les hooks déclarés dans le [frontmatter des skills](#hooks-in-skills-and-agents) ; ignoré dans les fichiers de paramètres et le frontmatter des agents |


447 447 

448Dans une condition `if` pour un outil de fichier, un modèle de répertoire à un seul segment comme `"Edit(src/**)"` correspond uniquement au répertoire `src` dans le répertoire de travail et aux fichiers sous celui-ci. Pour correspondre à un répertoire nommé `src` à n'importe quelle profondeur, écrivez `"Edit(**/src/**)"`. Avant v2.1.214, `"Edit(src/**)"` correspondait à un répertoire nommé `src` à n'importe quelle profondeur sous le répertoire de travail.448Dans une condition `if` pour un outil de fichier, un modèle de répertoire à un seul segment comme `"Edit(src/**)"` correspond uniquement au répertoire `src` dans le répertoire de travail et aux fichiers sous celui-ci. Pour correspondre à un répertoire nommé `src` à n'importe quelle profondeur, écrivez `"Edit(**/src/**)"`. Avant v2.1.214, `"Edit(src/**)"` correspondait à un répertoire nommé `src` à n'importe quelle profondeur sous le répertoire de travail.

449 449 

450<span id="bash-if-matching" />Pour les modèles Bash, le fait que votre commande de hook s'exécute dépend de la forme du modèle et de la commande Bash que Claude invoque. Les affectations `VAR=value` en début sont supprimées avant la correspondance.450<h4 id="bash-if-matching">

451 Comment les modèles `if` correspondent aux commandes Bash

452</h4>

453 

454Pour les modèles Bash dans le [champ `if`](#common-fields), le fait que votre commande de hook s'exécute dépend de la forme du modèle et de la commande Bash que Claude invoque. Les affectations `VAR=value` en début sont supprimées avant la correspondance.

451 455 

452| Modèle `if` | Commande Bash | Le hook s'exécute-t-il ? | Pourquoi |456| Modèle `if` | Commande Bash | Le hook s'exécute-t-il ? | Pourquoi |

453| :- | :- | :- | :- |457| :- | :- | :- | :- |


1913 1917 

1914| Champ | Type | Exemple | Description |1918| Champ | Type | Exemple | Description |

1915| :- | :- | :- | :- |1919| :- | :- | :- | :- |

1916| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React"}], "multiSelect": false}]` | Questions à présenter, chacune avec une chaîne `question`, un `header` court, un tableau `options` et un flag `multiSelect` facultatif |1920| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}], "multiSelect": false}]` | Questions à présenter, chacune avec une chaîne `question`, un `header` court, un tableau `options` et un flag `multiSelect` facultatif |

1917| `answers` | object | `{"Which framework?": "React"}` | Facultatif. Associe le texte de la question au libellé de l'option sélectionnée. Les réponses à sélection multiple joignent les libellés par des virgules. Claude ne définit pas ce champ ; fournissez-le via `updatedInput` pour répondre par programmation |1921| `answers` | object | `{"Which framework?": "React"}` | Facultatif. Associe le texte de la question au libellé de l'option sélectionnée. Les réponses à sélection multiple joignent les libellés par des virgules. Claude ne définit pas ce champ ; fournissez-le via `updatedInput` pour répondre par programmation |

1918 1922 

1919<h5 id="exitplanmode">1923<h5 id="exitplanmode">


1965}1969}

1966```1970```

1967 1971 

1968<span id="allow-with-updatedinput" />1972<Note>

1973 PreToolUse utilisait auparavant des 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.

1974</Note>

1969 1975 

1970En [mode non interactif](/docs/fr/headless) avec le flag `-p`, Claude Code ne propose `AskUserQuestion` et `ExitPlanMode` que lorsque l'exécution dispose d'un [hôte de permissions](/docs/fr/headless#turn-off-permission-prompts-in-unattended-runs) pour recevoir la demande, comme un callback `canUseTool` de l'Agent SDK. Ces outils nécessitent une interaction de l'utilisateur. Renvoyer `permissionDecision: "allow"` avec `updatedInput` satisfait cette exigence : le hook lit l'entrée de l'outil depuis stdin, recueille la réponse via votre propre interface et la renvoie dans `updatedInput` afin que l'outil s'exécute sans demande. Renvoyer `"allow"` seul ne suffit pas pour ces outils. Pour `AskUserQuestion`, renvoyez le tableau `questions` d'origine et ajoutez un objet [`answers`](#askuserquestion) associant le texte de chaque question à la réponse choisie.1976<h4 id="allow-with-updatedinput">

1977 Outils nécessitant une interaction de l'utilisateur

1978</h4>

1971 1979 

1972Un outil MCP que son serveur marque avec [`_meta["anthropic/requiresUserInteraction"]`](/docs/fr/mcp#require-approval-for-a-specific-tool) est plus strict : un hook ne peut pas ignorer sa demande d'approbation avec `"allow"`, avec ou sans `updatedInput`, car Claude Code ne peut pas confirmer que le hook a recueilli l'interaction dont l'outil a besoin.1980`AskUserQuestion` et `ExitPlanMode` nécessitent une interaction de l'utilisateur. En [mode non interactif](/docs/fr/headless) avec le flag `-p`, Claude Code ne les propose que lorsque l'exécution dispose d'un [hôte de permissions](/docs/fr/headless#turn-off-permission-prompts-in-unattended-runs) pour recevoir la demande, comme un callback `canUseTool` de l'Agent SDK.

1973 1981 

1974<Note>1982Un hook `PreToolUse` satisfait cette exigence lorsqu'il effectue les opérations suivantes :

1975 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.1983 

1976</Note>19841. Lit l'entrée de l'outil depuis stdin

19852. Recueille la réponse via votre propre interface utilisateur

19863. Renvoie `permissionDecision: "allow"` accompagné d'un `updatedInput` contenant la réponse, afin que l'outil s'exécute sans demande

1987 

1988Renvoyer `"allow"` seul ne suffit pas pour ces outils.

1989 

1990Pour `AskUserQuestion`, renvoyez le tableau `questions` d'origine et ajoutez un objet [`answers`](#askuserquestion) associant le texte de chaque question à la réponse choisie. Cette sortie répond à une question avec `React` :

1991 

1992```json theme={null}

1993{

1994 "hookSpecificOutput": {

1995 "hookEventName": "PreToolUse",

1996 "permissionDecision": "allow",

1997 "updatedInput": {

1998 "questions": [

1999 {

2000 "question": "Which framework?",

2001 "header": "Framework",

2002 "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}],

2003 "multiSelect": false

2004 }

2005 ],

2006 "answers": {"Which framework?": "React"}

2007 }

2008 }

2009}

2010```

2011 

2012Un outil MCP que son serveur marque avec [`_meta["anthropic/requiresUserInteraction"]`](/docs/fr/mcp#require-approval-for-a-specific-tool) est plus strict : un hook ne peut pas ignorer sa demande d'approbation avec `"allow"`, avec ou sans `updatedInput`, car Claude Code ne peut pas confirmer que le hook a recueilli l'interaction dont l'outil a besoin.

1977 2013 

1978<h4 id="defer-a-tool-call-for-later">2014<h4 id="defer-a-tool-call-for-later">

1979 Différer un appel d'outil2015 Différer un appel d'outil


2000 "deferred_tool_use": {2036 "deferred_tool_use": {

2001 "id": "toolu_01abc",2037 "id": "toolu_01abc",

2002 "name": "AskUserQuestion",2038 "name": "AskUserQuestion",

2003 "input": { "questions": [{ "question": "Which framework?", "header": "Framework", "options": [{"label": "React"}, {"label": "Vue"}], "multiSelect": false }] }2039 "input": { "questions": [{ "question": "Which framework?", "header": "Framework", "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}], "multiSelect": false }] }

2004 }2040 }

2005}2041}

2006```2042```

Details

470* Votre compte est proche ou à sa limite d'utilisation. Pour maintenir les suggestions activées jusqu'à ce que vous atteigniez la limite, définissez [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/fr/env-vars) sur `true`. Avant la v2.1.238, Claude Code les ignorait près de la limite même avec la variable définie sur `true`470* Votre compte est proche ou à sa limite d'utilisation. Pour maintenir les suggestions activées jusqu'à ce que vous atteigniez la limite, définissez [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/fr/env-vars) sur `true`. Avant la v2.1.238, Claude Code les ignorait près de la limite même avec la variable définie sur `true`

471* Dans une [équipe d'agents](/docs/fr/agent-teams), dans les sessions des coéquipiers par défaut. La session du responsable affiche les suggestions471* Dans une [équipe d'agents](/docs/fr/agent-teams), dans les sessions des coéquipiers par défaut. La session du responsable affiche les suggestions

472 472 

473Le message `Showing fewer prompt suggestions · use one to bring them back` signifie que Claude Code affiche les suggestions moins souvent parce que vous en avez laissé beaucoup d'affilée sans les utiliser. Pour revenir à la fréquence habituelle, utilisez une suggestion ou définissez [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/fr/env-vars) sur `true`.

474 

473En mode impression, Claude Code ne génère pas de suggestions par défaut. Passez [`--prompt-suggestions`](/docs/fr/cli-reference#cli-flags) avec `-p "<prompt>" --output-format stream-json --verbose` pour que Claude Code émette un message `prompt_suggestion` après chaque tour qui en génère un. Le générateur ignore également les conversations très courtes et les caches de prompt froids ici, donc une seule requête `-p` courte peut n'en émettre aucune.475En mode impression, Claude Code ne génère pas de suggestions par défaut. Passez [`--prompt-suggestions`](/docs/fr/cli-reference#cli-flags) avec `-p "<prompt>" --output-format stream-json --verbose` pour que Claude Code émette un message `prompt_suggestion` après chaque tour qui en génère un. Le générateur ignore également les conversations très courtes et les caches de prompt froids ici, donc une seule requête `-p` courte peut n'en émettre aucune.

474 476 

475<h3 id="turn-prompt-suggestions-off">477<h3 id="turn-prompt-suggestions-off">

keybindings.md +4 −0

Details

464| :- | :- | :- |464| :- | :- | :- |

465| `agents:switchView` | Ctrl+S | Basculer le [regroupement de session](/docs/fr/agent-view#organize-the-list) entre l'état et le répertoire |465| `agents:switchView` | Ctrl+S | Basculer le [regroupement de session](/docs/fr/agent-view#organize-the-list) entre l'état et le répertoire |

466| `agents:togglePin` | Ctrl+T | [Épingler ou dépingler](/docs/fr/agent-view#organize-the-list) la session sélectionnée |466| `agents:togglePin` | Ctrl+T | [Épingler ou dépingler](/docs/fr/agent-view#organize-the-list) la session sélectionnée |

467| `agents:find` | Ctrl+F | Rechercher des sessions par nom, avec le [filtre `n:`](/docs/fr/agent-view#filter-sessions). Nécessite v2.1.288 ou ultérieur |

468| `agents:rename` | Ctrl+R | [Renommer](/docs/fr/agent-view#organize-the-list) la session sélectionnée. Nécessite v2.1.288 ou ultérieur |

469| `agents:previousGroup` | Ctrl+Haut, Meta+Haut | Sauter à l'[en-tête de groupe](/docs/fr/agent-view#organize-the-list) précédent. Nécessite v2.1.288 ou ultérieur |

470| `agents:nextGroup` | Ctrl+Bas, Meta+Bas | Sauter à l'en-tête de groupe suivant. Nécessite v2.1.288 ou ultérieur |

467 471 

468Quand la vue agent est ouverte, Claude Code utilise la liaison `Agents` pour toute touche que le contexte `Agents` lie, et il ignore une liaison `Chat` ou `Global` sur la même touche. Par exemple, appuyer sur Ctrl+S dans la vue agent bascule le regroupement de session plutôt que de déclencher le `chat:stash` par défaut.472Quand la vue agent est ouverte, Claude Code utilise la liaison `Agents` pour toute touche que le contexte `Agents` lie, et il ignore une liaison `Chat` ou `Global` sur la même touche. Par exemple, appuyer sur Ctrl+S dans la vue agent bascule le regroupement de session plutôt que de déclencher le `chat:stash` par défaut.

469 473 

managed-mcp.md +61 −29

Details

282 282 

283Les listes blanches et les listes noires filtrent les serveurs configurés autorisés à se charger. Ce ne sont pas un registre : un serveur doit toujours être ajouté par un utilisateur, un plugin ou votre organisation avant que l'une ou l'autre liste ne s'applique à lui.283Les listes blanches et les listes noires filtrent les serveurs configurés autorisés à se charger. Ce ne sont pas un registre : un serveur doit toujours être ajouté par un utilisateur, un plugin ou votre organisation avant que l'une ou l'autre liste ne s'applique à lui.

284 284 

285Les serveurs que votre organisation fournit via `managedMcpServers` se chargent sans entrée de liste blanche, et [Comment un serveur est évalué](#how-a-server-is-evaluated) couvre les serveurs `managed-mcp.json`. La liste noire s'applique à tous les serveurs, peu importe d'où ils proviennent, sauf pour les entrées `type: "sdk"` en processus.285Les serveurs que votre organisation fournit via `managedMcpServers` se chargent sans entrée de liste d'autorisation, et [Serveurs qui ignorent la vérification de la liste d'autorisation](#servers-that-skip-the-allowlist-check) couvre les serveurs `managed-mcp.json`. La liste de refus s'applique à tous les serveurs, peu importe d'où ils proviennent, sauf pour les entrées `type: "sdk"` en processus.

286 286 

287Pour déployer des serveurs aux utilisateurs, utilisez [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json) ou [`managedMcpServers`](#provide-servers-through-managed-settings). Les deux listes filtrent également les serveurs transmis avec l'indicateur CLI [`--mcp-config`](/docs/fr/cli-reference#cli-flags), sauf pour les entrées `type: "sdk"` en processus ; `--strict-mcp-config` limite les fichiers de configuration qui se chargent et ne contourne aucune des deux listes.287Pour déployer des serveurs aux utilisateurs, utilisez [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json) ou [`managedMcpServers`](#provide-servers-through-managed-settings). Les deux listes filtrent également les serveurs transmis avec l'indicateur CLI [`--mcp-config`](/docs/fr/cli-reference#cli-flags), sauf pour les entrées `type: "sdk"` en processus ; `--strict-mcp-config` limite les fichiers de configuration qui se chargent et ne contourne aucune des deux listes.

288 288 


308| :- | :- | :- |308| :- | :- | :- |

309| `serverUrl` | Une URL de serveur distant, exacte ou avec des caractères génériques `*` | Serveurs HTTP et SSE |309| `serverUrl` | Une URL de serveur distant, exacte ou avec des caractères génériques `*` | Serveurs HTTP et SSE |

310| `serverCommand` | La commande exacte et les arguments qui démarrent un serveur stdio | Serveurs stdio |310| `serverCommand` | La commande exacte et les arguments qui démarrent un serveur stdio | Serveurs stdio |

311| `serverName` | L'étiquette assignée par l'utilisateur. Correspondance exacte uniquement ; les caractères génériques ne sont pas développés | L'un ou l'autre type, mais voir l'Avertissement ci-dessous |311| `serverName` | L'étiquette assignée par l'utilisateur. Correspondance exacte uniquement ; les caractères génériques ne sont pas développés | L'un ou l'autre type, mais voir [Comment les entrées `serverName` correspondent](#how-servername-entries-match) |

312 312 

313Laisser `allowedMcpServers` non défini est différent de le définir sur un tableau vide :313Laisser `allowedMcpServers` non défini est différent de le définir sur un tableau vide :

314 314 

315| Paramètre | Non défini (par défaut) | Tableau vide `[]` | Rempli |315| Paramètre | Non défini (par défaut) | Tableau vide `[]` | Rempli |

316| :- | :- | :- | :- |316| :- | :- | :- | :- |

317| `allowedMcpServers` | Tous les serveurs autorisés | Aucun serveur autorisé, à part [ceux qui ignorent la vérification de la liste blanche](#how-a-server-is-evaluated) | Seuls les serveurs correspondants autorisés, à part [ceux qui ignorent la vérification de la liste blanche](#how-a-server-is-evaluated) |317| `allowedMcpServers` | Tous les serveurs autorisés | Aucun serveur autorisé, à part [ceux qui ignorent la vérification de la liste d'autorisation](#servers-that-skip-the-allowlist-check) | Seuls les serveurs correspondants autorisés, à part [ceux qui ignorent la vérification de la liste d'autorisation](#servers-that-skip-the-allowlist-check) |

318| `deniedMcpServers` | Aucun serveur bloqué | Aucun serveur bloqué | Serveurs correspondants bloqués |318| `deniedMcpServers` | Aucun serveur bloqué | Aucun serveur bloqué | Serveurs correspondants bloqués |

319 319 

320Voir [Entrées invalides dans les paramètres gérés](/docs/fr/managed-settings#invalid-entries-in-managed-settings) pour savoir ce qui se passe quand une entrée échoue la validation du schéma.320Voir [Entrées invalides dans les paramètres gérés](/docs/fr/managed-settings#invalid-entries-in-managed-settings) pour savoir ce qui se passe quand une entrée échoue la validation du schéma.

321 321 

322<h4 id="how-servername-entries-match">

323 Comment les entrées `serverName` correspondent

324</h4>

325 

326Une entrée `serverName` correspond exactement à l'étiquette assignée par l'utilisateur, sans caractères génériques.

327 

322<Warning>328<Warning>

323 Une entrée `serverName`, dans l'une ou l'autre liste, n'est pas un contrôle de sécurité. Le nom est l'étiquette qu'un utilisateur assigne lors de l'exécution de `claude mcp add` ou de la modification d'un fichier de configuration, pas le serveur sous-jacent, donc un utilisateur peut appeler n'importe quel serveur `github`. Pour les connecteurs claude.ai, le nom est le nom d'affichage renvoyé par claude.ai, qui peut changer. Pour appliquer les serveurs qui s'exécutent réellement, ajoutez des entrées `serverCommand` ou `serverUrl`.329 Une entrée `serverName`, dans l'une ou l'autre liste, n'est pas un contrôle de sécurité. Le nom est l'étiquette qu'un utilisateur assigne lors de l'exécution de `claude mcp add` ou de la modification d'un fichier de configuration, pas le serveur sous-jacent, donc un utilisateur peut appeler n'importe quel serveur `github`. Pour les connecteurs claude.ai, le nom est le nom d'affichage renvoyé par claude.ai, qui peut changer. Pour appliquer les serveurs qui s'exécutent réellement, ajoutez des entrées `serverCommand` ou `serverUrl`.

324</Warning>330</Warning>


330 336 

331Pour désactiver tous les connecteurs claude.ai que Claude Code récupère lui-même, voir [`disableClaudeAiConnectors`](/docs/fr/mcp#disable-claude-ai-connectors).337Pour désactiver tous les connecteurs claude.ai que Claude Code récupère lui-même, voir [`disableClaudeAiConnectors`](/docs/fr/mcp#disable-claude-ai-connectors).

332 338 

333<h3 id="how-a-server-is-evaluated">339<h4 id="how-servercommand-entries-match">

334 Comment un serveur est évalué340 Comment les entrées `serverCommand` correspondent

335</h3>341</h4>

336 

337Avant de charger un serveur, y compris un serveur de `managed-mcp.json`, Claude Code exécute les trois vérifications ci-dessous dans l'ordre. Il les exécute à nouveau quand un utilisateur reconnecte un serveur ou réactive un serveur désactivé dans `/mcp`. Les serveurs `type: "sdk"` en processus, que [l'application qui a démarré la session enregistre](/docs/fr/mcp#how-connectors-reach-claude-code), ignorent les trois.

338 

3391. **Fusionner les listes.** Les entrées de liste blanche et de liste noire de chaque portée de paramètres se combinent en une liste blanche et une liste noire. Quand `allowManagedMcpServersOnly` est `true`, seule la liste blanche gérée est conservée ; la liste noire fusionne toujours de chaque portée. Quand plus d'une source gérée est présente, [Les clés lues à partir de chaque source d'administrateur](/docs/fr/managed-settings#keys-read-from-every-admin-source) indique lesquelles d'entre elles fournissent les listes de la portée gérée.

3402. **Vérifier la liste noire.** Un serveur qui correspond à n'importe quelle entrée de liste noire, par URL, commande ou nom, est bloqué. Rien ne remplace une correspondance de liste noire.

3413. **Vérifier la liste blanche.** Si `allowedMcpServers` n'est défini nulle part, tous les serveurs qui ont réussi la liste noire se chargent. S'il est défini, ce que le serveur doit correspondre dépend de son type, montré dans le tableau ci-dessous.

342 

343 Trois groupes de serveurs ignorent cette vérification :

344 342 

345 * Les serveurs de l'organisation : chaque entrée `managedMcpServers`, et toute entrée `managed-mcp.json` dont les valeurs n'utilisent pas d'expansion `${VAR}`.343Une entrée `serverCommand` contient la commande et ses arguments sous forme d'un seul tableau, comme dans `{ "serverCommand": ["npx", "-y", "server"] }`. Claude Code compare ce tableau avec la commande et les arguments de la configuration du serveur :

346 * Les serveurs intégrés, comme Claude dans Chrome, le serveur `ide` auquel Claude Code se connecte dans un IDE VS Code ou JetBrains en cours d'exécution, et les serveurs que l'interface CLI elle-même configure.

347 * Les outils Slack d'une session [Claude Tag](/docs/fr/claude-tag) : les serveurs qu'elle utilise pour lire le fil et publier ses réponses se chargent sans entrée de liste blanche.

348 344 

349 Un serveur `managed-mcp.json` qui utilise l'expansion `${VAR}` dans sa commande, ses arguments, `env`, son URL ou ses en-têtes est toujours vérifié. Il en va de même pour tous les serveurs qu'un utilisateur, un plugin, ou claude.ai ajoute, et tous les serveurs qu'un utilisateur transmet avec `--mcp-config`.345* **Les commandes correspondent exactement.** Chaque argument, dans l'ordre. `["npx", "-y", "server"]` ne correspond pas à `["npx", "server"]` ou `["npx", "-y", "server", "--flag"]`.

346* **Le bloc `env` n'est pas comparé.** `["node", "server.js"]` correspond à un serveur qui exécute cette commande avec n'importe quelles valeurs `env`. Certaines variables d'environnement changent ce que `node` charge au démarrage. Pour définir vous-même les valeurs `env`, définissez le serveur dans [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json).

350 347 

351| Type de serveur | Autorisé quand il correspond |348<h4 id="how-serverurl-entries-match">

352| :- | :- |349 Comment les entrées `serverUrl` correspondent

353| Distant (HTTP ou SSE) | Une entrée `serverUrl`. Une correspondance `serverName` compte uniquement quand la liste blanche ne contient pas d'entrées `serverUrl` |350</h4>

354| Stdio | Une entrée `serverCommand`. Une correspondance `serverName` compte uniquement quand la liste blanche ne contient pas d'entrées `serverCommand` |

355 351 

356Trois règles de correspondance s'appliquent dans ces vérifications :352Les URL supportent les caractères génériques `*` n'importe où dans le motif, y compris le schéma. La correspondance du nom d'hôte est insensible à la casse et ignore un point FQDN final, donc `https://Mcp.Example.com/*` correspond à `https://mcp.example.com/api`. Les chemins restent sensibles à la casse.

357 353 

358* **Les commandes correspondent exactement.** Chaque argument, dans l'ordre. `["npx", "-y", "server"]` ne correspond pas à `["npx", "server"]` ou `["npx", "-y", "server", "--flag"]`.354Le tableau montre ce que les motifs courants autorisent :

359* **Les valeurs `serverCommand` et `serverUrl` se développent avant la correspondance.** L'entrée de politique et la valeur configurée du serveur passent toutes les deux par l'expansion [`${VAR}` et `${VAR:-default}`](/docs/fr/mcp#environment-variable-expansion-in-mcp-json), donc une entrée écrite comme `["${HOME}/bin/server"]` correspond à une configuration de serveur qui utilise soit la même référence, soit le chemin développé. Sous Windows, référencez une variable d'environnement qui y est définie, comme `${USERPROFILE}` au lieu de `${HOME}`. Les valeurs `serverName` correspondent littéralement et ne se développent jamais. Les deux côtés lisent des environnements différents ; [Comment les entrées de politique se développent](#how-policy-entries-expand) couvre lesquels, et comment les entrées de liste blanche et de liste noire diffèrent.

360* **Les URL supportent les caractères génériques `*`** n'importe où dans le motif, y compris le schéma. La correspondance du nom d'hôte est insensible à la casse et ignore un point FQDN final, donc `https://Mcp.Example.com/*` correspond à `https://mcp.example.com/api`. Les chemins restent sensibles à la casse.

361 355 

362| Motif | Autorise |356| Motif | Autorise |

363| :- | :- |357| :- | :- |


368| `*://mcp.example.com/*` | N'importe quel schéma vers un domaine spécifique |362| `*://mcp.example.com/*` | N'importe quel schéma vers un domaine spécifique |

369 363 

370<h4 id="how-policy-entries-expand">364<h4 id="how-policy-entries-expand">

371 Comment les entrées de politique se développent365 Variables d'environnement dans les entrées `serverCommand` et `serverUrl`

372</h4>366</h4>

373 367 

374La valeur configurée du serveur se développe à partir de l'environnement de processus en direct, comme le reste de `.mcp.json`. Une entrée de politique se développe à partir d'un environnement épinglé à la place, donc une variable définie par un projet ou un fichier de paramètres utilisateur ne peut pas changer ce qu'une entrée de liste blanche signifie. Parce qu'une entrée de politique dépend toujours de la valeur du shell de lancement pour toute variable qu'elle référence, utilisez des URL et des commandes littérales pour les entrées sur lesquelles vous comptez pour l'application.368Les valeurs `serverCommand` et `serverUrl` se développent avant la correspondance. L'entrée de politique et la valeur configurée du serveur passent toutes les deux par l'[expansion `${VAR}` et `${VAR:-default}`](/docs/fr/mcp#environment-variable-expansion-in-mcp-json), donc une entrée écrite comme `["${HOME}/bin/server"]` correspond à une configuration de serveur qui utilise soit la même référence, soit le chemin développé. Les valeurs `serverName` correspondent littéralement et ne se développent jamais.

369 

370Les deux côtés lisent des environnements différents :

371 

372* **La valeur configurée du serveur** : se développe à partir de l'environnement de processus en direct, comme le reste de `.mcp.json`

373* **Une entrée de politique** : se développe à partir d'un environnement épinglé, donc une variable définie par un projet ou un fichier de paramètres utilisateur ne peut pas changer ce qu'une entrée de liste d'autorisation signifie

374 

375Parce qu'une entrée de politique dépend toujours de la valeur du shell de lancement pour toute variable qu'elle référence, utilisez des URL et des commandes littérales pour les entrées sur lesquelles vous comptez pour l'application.

376 

377Sous Windows, référencez une variable d'environnement qui y est définie, comme `${USERPROFILE}` au lieu de `${HOME}`.

378 

379Les deux listes se développent différemment :

375 380 

376| Liste d'entrées | Se développe à partir de | Expansion qui changerait le schéma, l'hôte ou la portée du chemin d'une entrée URL |381| Liste d'entrées | Se développe à partir de | Expansion qui changerait le schéma, l'hôte ou la portée du chemin d'une entrée URL |

377| - | - | - |382| - | - | - |

378| `allowedMcpServers` | L'environnement avec lequel Claude Code a démarré, plus les valeurs `env` des paramètres gérés | Claude Code ignore l'entrée |383| `allowedMcpServers` | L'environnement avec lequel Claude Code a démarré, plus les valeurs `env` des paramètres gérés | Claude Code ignore l'entrée |

379| `deniedMcpServers` | Le même, et une variable sans valeur de démarrage et sans `:-default` se remplit à partir des fichiers de paramètres en dehors du référentiel, comme les paramètres utilisateur ou gérés, qui élargissent uniquement ce que l'entrée correspond | L'entrée correspond toujours |384| `deniedMcpServers` | Le même, et une variable sans valeur de démarrage et sans `:-default` se remplit à partir des fichiers de paramètres en dehors du référentiel, comme les paramètres utilisateur ou gérés, qui élargissent uniquement ce que l'entrée correspond | L'entrée correspond toujours |

380 385 

381Nécessite Claude Code v2.1.219 ou ultérieur.386L'environnement épinglé et les règles de ce tableau nécessitent Claude Code v2.1.219 ou ultérieur.

387 

388<h3 id="how-a-server-is-evaluated">

389 Comment un serveur est évalué

390</h3>

391 

392Avant de charger un serveur, y compris un serveur de `managed-mcp.json`, Claude Code exécute les trois vérifications ci-dessous dans l'ordre. Il les exécute à nouveau quand un utilisateur reconnecte un serveur ou réactive un serveur désactivé dans `/mcp`. Les serveurs `type: "sdk"` en processus, que [l'application qui a démarré la session enregistre](/docs/fr/mcp#how-connectors-reach-claude-code), ignorent les trois.

393 

3941. **Fusionner les listes.** Les entrées de liste d'autorisation et de liste de refus de chaque portée de paramètres se combinent en une liste d'autorisation et une liste de refus. Quand `allowManagedMcpServersOnly` est `true`, seule la liste d'autorisation gérée est conservée ; la liste de refus fusionne toujours de chaque portée. Quand plus d'une source gérée est présente, [Les clés lues à partir de chaque source d'administration](/docs/fr/managed-settings#keys-read-from-every-admin-source) indique lesquelles d'entre elles fournissent les listes de la portée gérée.

3952. **Vérifier la liste de refus.** Un serveur qui correspond à n'importe quelle entrée de liste de refus, par URL, commande ou nom, est bloqué. Rien ne remplace une correspondance de liste de refus.

3963. **Vérifier la liste d'autorisation.** [Certains serveurs ignorent cette vérification](#servers-that-skip-the-allowlist-check). Si `allowedMcpServers` n'est défini nulle part, tous les serveurs qui ont réussi la liste de refus se chargent. S'il est défini, ce à quoi le serveur doit correspondre dépend de son type, montré dans le tableau ci-dessous.

397 

398| Type de serveur | Autorisé quand il correspond |

399| :- | :- |

400| Distant (HTTP ou SSE) | Une entrée `serverUrl`. Une correspondance `serverName` compte uniquement quand la liste d'autorisation ne contient pas d'entrées `serverUrl` |

401| Stdio | Une entrée `serverCommand`. Une correspondance `serverName` compte uniquement quand la liste d'autorisation ne contient pas d'entrées `serverCommand` |

402 

403<h4 id="servers-that-skip-the-allowlist-check">

404 Serveurs qui ignorent la vérification de la liste d'autorisation

405</h4>

406 

407Trois groupes de serveurs ignorent la vérification de la liste d'autorisation, en plus des serveurs `type: "sdk"` en processus qui ignorent [les trois vérifications](#how-a-server-is-evaluated) :

408 

409* Les serveurs de l'organisation : chaque entrée `managedMcpServers`, et toute entrée `managed-mcp.json` dont les valeurs n'utilisent pas d'expansion `${VAR}`.

410* Les serveurs intégrés, comme Claude dans Chrome, le serveur `ide` auquel Claude Code se connecte dans un IDE VS Code ou JetBrains en cours d'exécution, et les serveurs que la CLI elle-même configure.

411* Les outils Slack d'une session [Claude Tag](/docs/fr/claude-tag) : les serveurs qu'elle utilise pour lire le fil et publier ses réponses se chargent sans entrée de liste d'autorisation.

412 

413Un serveur `managed-mcp.json` qui utilise l'expansion `${VAR}` dans sa commande, ses arguments, `env`, son URL ou ses en-têtes est toujours vérifié. Claude Code vérifie également tous les serveurs qu'un utilisateur, un plugin ou claude.ai ajoute, et tous les serveurs qu'un utilisateur transmet avec `--mcp-config`.

382 414 

383<h3 id="example-configuration">415<h3 id="example-configuration">

384 Exemple de configuration416 Exemple de configuration

Details

266Claude Code applique également ces vérifications aux valeurs fournies par le parent d'elles-mêmes :266Claude Code applique également ces vérifications aux valeurs fournies par le parent d'elles-mêmes :

267 267 

268* Quand n'importe quelle source d'administration définit `allowManagedPermissionRulesOnly`, Claude Code supprime les [règles d'autorisation de permission fournies par le parent](/docs/fr/claude-apps-gateway#restrict-parent-settings) et `additionalDirectories` au fur et à mesure qu'il les lit, même quand une source de priorité plus élevée laisse la clé non définie. L'effet de la clé sur vos propres règles de permission provient des paramètres gérés que Claude Code applique, ou des paramètres parent que vous avez choisi de fusionner268* Quand n'importe quelle source d'administration définit `allowManagedPermissionRulesOnly`, Claude Code supprime les [règles d'autorisation de permission fournies par le parent](/docs/fr/claude-apps-gateway#restrict-parent-settings) et `additionalDirectories` au fur et à mesure qu'il les lit, même quand une source de priorité plus élevée laisse la clé non définie. L'effet de la clé sur vos propres règles de permission provient des paramètres gérés que Claude Code applique, ou des paramètres parent que vous avez choisi de fusionner

269* Claude Code applique la valeur `forceLoginOrgUUID` ou `allowedMcpServers` dans les paramètres gérés qu'il applique et bloque une valeur fournie par le parent. Une valeur dans une source d'administration inférieure que Claude Code n'applique pas ne s'applique ni ne bloque celle du parent.269* Claude Code applique la valeur `forceLoginOrgUUID` ou `allowedMcpServers` dans les paramètres gérés qu'il applique et bloque une valeur fournie par le parent. En dehors du verrou de liste d'autorisation MCP, une valeur dans une source d'administration inférieure que Claude Code n'applique pas ne s'applique ni ne bloque celle du parent.

270 270 

271 Sur Claude Code v2.1.273 ou ultérieur, pendant que `allowManagedMcpServersOnly` est actif, la liste `allowedMcpServers` de la source d'administration la mieux classée qui en définit une s'applique et bloque celle du parent, comme une [clé inter-source](#keys-read-from-every-admin-source). La liste du parent s'applique uniquement quand aucune source d'administration n'en définit une. L'entrée [`managedSourcesBehavior`](/docs/fr/settings-reference#managedsourcesbehavior) dit quelle source fournit chaque clé sous `"merge"`. Avant v2.1.223, une valeur dans n'importe quelle source d'administration bloquait celle du parent271 Sur Claude Code v2.1.273 ou ultérieur, pendant que `allowManagedMcpServersOnly` est actif, la liste `allowedMcpServers` de la source d'administration la mieux classée qui en définit une s'applique et bloque celle du parent, comme une [clé inter-source](#keys-read-from-every-admin-source). La liste du parent s'applique uniquement quand aucune source d'administration n'en définit une. L'entrée [`managedSourcesBehavior`](/docs/fr/settings-reference#managedsourcesbehavior) dit quelle source fournit chaque clé sous `"merge"`. Avant v2.1.223, une valeur dans n'importe quelle source d'administration bloquait celle du parent

272* Pour `availableModels`, Claude Code applique la valeur dans les paramètres gérés qu'il applique et bloque une liste fournie par le parent272* Pour `availableModels`, Claude Code applique la valeur dans les paramètres gérés qu'il applique et bloque une liste fournie par le parent

273* Pour `strictKnownMarketplaces`, Claude Code applique de la même manière la liste dans les paramètres gérés qu'il applique et bloque une liste fournie par le parent. La liste du parent s'applique uniquement quand aucune source gérée appliquée ne la définit. Nécessite Claude Code v2.1.282 ou ultérieur273* Pour `strictKnownMarketplaces`, Claude Code applique de la même manière la liste dans les paramètres gérés qu'il applique et bloque une liste fournie par le parent. La liste du parent s'applique uniquement quand aucune source gérée appliquée ne la définit. Nécessite Claude Code v2.1.282 ou ultérieur

274* Pour `allowedProviders`, une liste dans la [source gérée sélectionnée](#which-managed-source-claude-code-uses) bloque une liste fournie par le parent, et avec l'activation de `"merge"` de [`managedSourcesBehavior`](/docs/fr/settings-reference#managedsourcesbehavior), une liste dans n'importe quelle source d'administration la bloque. Nécessite Claude Code v2.1.285 ou ultérieur

274* Un `blockedMarketplaces` fourni par le parent s'applique en plus de toute liste de blocage qu'une source gérée définit. Nécessite Claude Code v2.1.282 ou ultérieur275* Un `blockedMarketplaces` fourni par le parent s'applique en plus de toute liste de blocage qu'une source gérée définit. Nécessite Claude Code v2.1.282 ou ultérieur

275 276 

276<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">277<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">


301Les fichiers de paramètres propres d'un développeur, les valeurs `--settings`, et les fichiers de projet ne remplacent jamais une valeur gérée ; les [exceptions](/docs/fr/settings#exceptions-to-managed-settings-precedence) permettent uniquement à une valeur plus stricte de niveau inférieur de compter. Ces cas se situent en dehors de cette règle :302Les fichiers de paramètres propres d'un développeur, les valeurs `--settings`, et les fichiers de projet ne remplacent jamais une valeur gérée ; les [exceptions](/docs/fr/settings#exceptions-to-managed-settings-precedence) permettent uniquement à une valeur plus stricte de niveau inférieur de compter. Ces cas se situent en dehors de cette règle :

302 303 

303* **Le modèle pour une session** : un `model` géré est une valeur par défaut, pas un verrou. `--model` et `ANTHROPIC_MODEL` choisissent toujours le modèle pour cette session, donc déployez [`availableModels`](/docs/fr/settings-reference#availablemodels) pour restreindre le choix.304* **Le modèle pour une session** : un `model` géré est une valeur par défaut, pas un verrou. `--model` et `ANTHROPIC_MODEL` choisissent toujours le modèle pour cette session, donc déployez [`availableModels`](/docs/fr/settings-reference#availablemodels) pour restreindre le choix.

305* **La fenêtre de compaction automatique pour une session** : un [`autoCompactWindow`](/docs/fr/settings-reference#autocompactwindow) géré est également une valeur par défaut. Le flag `--autocompact` et la variable `CLAUDE_CODE_AUTO_COMPACT_WINDOW` définissent toujours la [fenêtre de compaction automatique](/docs/fr/model-config#set-the-auto-compact-window) pour cette session.

304* **Droits d'administrateur local** : un développeur qui est administrateur sur la machine peut modifier la source gérée elle-même, c'est pourquoi les outils MDM peuvent redéployer le profil ou le fichier selon un calendrier et pourquoi le registre HKLM et le domaine des préférences gérées macOS existent.306* **Droits d'administrateur local** : un développeur qui est administrateur sur la machine peut modifier la source gérée elle-même, c'est pourquoi les outils MDM peuvent redéployer le profil ou le fichier selon un calendrier et pourquoi le registre HKLM et le domaine des préférences gérées macOS existent.

305* **Le cache géré par le serveur** : les paramètres gérés par le serveur proviennent des serveurs d'Anthropic, et une modification du cache local [dure uniquement jusqu'à la prochaine récupération réussie](/docs/fr/server-managed-settings#security-considerations).307* **Le cache géré par le serveur** : les paramètres gérés par le serveur proviennent des serveurs d'Anthropic, et une modification du cache local [dure uniquement jusqu'à la prochaine récupération réussie](/docs/fr/server-managed-settings#security-considerations).

306* **Autres outils** : les paramètres gérés lient uniquement Claude Code. Un développeur qui appelle l'API à partir d'un autre outil n'est pas sous eux.308* **Autres outils** : les paramètres gérés lient uniquement Claude Code. Un développeur qui appelle l'API à partir d'un autre outil n'est pas sous eux.


325* `(plist)` ou `(HKLM)` : une politique MDM ou au niveau du système d'exploitation327* `(plist)` ou `(HKLM)` : une politique MDM ou au niveau du système d'exploitation

326* `(file)`, `(drop-ins)`, ou `(file + drop-ins)` : `managed-settings.json`, le répertoire drop-in, ou les deux328* `(file)`, `(drop-ins)`, ou `(file + drop-ins)` : `managed-settings.json`, le répertoire drop-in, ou les deux

327* `(remote + file, merged)`, ou une autre liste se terminant par `, merged` : votre organisation [compose chaque source gérée](#compose-every-managed-source), et Claude Code a fusionné les sources énumérées dans la politique. Une source inférieure peut toujours fournir des variables `env` sans apparaître dans la liste. Nécessite Claude Code v2.1.242 ou ultérieur329* `(remote + file, merged)`, ou une autre liste se terminant par `, merged` : votre organisation [compose chaque source gérée](#compose-every-managed-source), et Claude Code a fusionné les sources énumérées dans la politique. Une source inférieure peut toujours fournir des variables `env` sans apparaître dans la liste. Nécessite Claude Code v2.1.242 ou ultérieur

328* `(HKCU)` : le registre modifiable par l'utilisateur fallback330* `(HKCU)` : le registre de secours modifiable par l'utilisateur

329* `(parent process)` : un [hôte d'intégration](#let-an-embedding-host-add-policy) a fourni des paramètres restrictifs331* `(parent process)` : un [hôte d'intégration](#let-an-embedding-host-add-policy) a fourni des paramètres restrictifs

330* `(helper)` : un [`policyHelper`](/docs/fr/settings-reference#policyhelper) configuré par la source MDM ou fichier sélectionnée332* `(helper)` : un [`policyHelper`](/docs/fr/settings-reference#policyhelper) configuré par la source MDM ou fichier sélectionnée

331 333 


379 381 

380Quand une source gérée définit une clé de niveau supérieur qui a une seule valeur restrictive, comme `allowManagedPermissionRulesOnly`, `disableAutoMode`, ou `skipDangerousModePermissionPrompt`, à quelque chose que Claude Code ne peut pas lire, la clé se lit comme cette valeur jusqu'à ce que vous la corrigiez. Le rapport dit que la clé `was present but invalid` et nomme la valeur que Claude Code la traite comme. Pour une clé à l'intérieur de `sandbox`, consultez [Valeurs invalides à l'intérieur de `sandbox`](#invalid-values-inside-sandbox).382Quand une source gérée définit une clé de niveau supérieur qui a une seule valeur restrictive, comme `allowManagedPermissionRulesOnly`, `disableAutoMode`, ou `skipDangerousModePermissionPrompt`, à quelque chose que Claude Code ne peut pas lire, la clé se lit comme cette valeur jusqu'à ce que vous la corrigiez. Le rapport dit que la clé `was present but invalid` et nomme la valeur que Claude Code la traite comme. Pour une clé à l'intérieur de `sandbox`, consultez [Valeurs invalides à l'intérieur de `sandbox`](#invalid-values-inside-sandbox).

381 383 

382Ces cas ne échouent pas fermés :384Ces cas n'échouent pas fermés :

383 385 

384* Un `null` supprime la clé.386* Un `null` supprime la clé.

385* Un `disableAllHooks` invalide, même un booléen entre guillemets, est supprimé avec un avertissement, car appliquer `true` déchargerait également les hooks que vos propres paramètres gérés déploient.387* Un `disableAllHooks` invalide, même un booléen entre guillemets, est supprimé avec un avertissement, car appliquer `true` déchargerait également les hooks que vos propres paramètres gérés déploient.


394 396 

395La règle d'échec fermé pour les clés avec une seule valeur restrictive et les réparations par champ nécessitent Claude Code v2.1.282 ou ultérieur.397La règle d'échec fermé pour les clés avec une seule valeur restrictive et les réparations par champ nécessitent Claude Code v2.1.282 ou ultérieur.

396 398 

397Ces clés ont leur propre fallback :399Ces clés ont leur propre solution de repli :

398 400 

399| Champ | Comportement quand présent mais invalide |401| Champ | Comportement quand présent mais invalide |

400| :- | :- |402| :- | :- |

401| `allowedMcpServers` | Appliquée comme une liste d'autorisation vide jusqu'à ce que la valeur soit corrigée, donc aucun serveur MCP que les utilisateurs ajoutent n'est admis. Les serveurs que votre organisation livre via [`managedMcpServers`](/docs/fr/settings-reference#managedmcpservers) se chargent toujours, et les serveurs `managed-mcp.json` se chargent selon [Comment un serveur est évalué](/docs/fr/managed-mcp#how-a-server-is-evaluated). Une entrée invalide individuelle est supprimée et le sous-ensemble valide est appliqué. |403| `allowedMcpServers` | Appliquée comme une liste d'autorisation vide jusqu'à ce que la valeur soit corrigée, donc aucun serveur MCP que les utilisateurs ajoutent n'est admis. Les serveurs que votre organisation livre via [`managedMcpServers`](/docs/fr/settings-reference#managedmcpservers) se chargent toujours, et les serveurs `managed-mcp.json` se chargent selon [Serveurs qui contournent la vérification de la liste d'autorisation](/docs/fr/managed-mcp#servers-that-skip-the-allowlist-check). Une entrée invalide individuelle est supprimée et le sous-ensemble valide est appliqué. |

402| [`allowedProviders`](/docs/fr/settings-reference#allowedproviders) | Appliquée comme une liste d'autorisation vide jusqu'à ce que la valeur soit corrigée, donc chaque fournisseur d'API est refusé et Claude Code ne démarre pas sur la machine. Si seule une entrée individuelle n'est pas un nom de fournisseur connu, Claude Code supprime et signale cette entrée et applique le reste. |404| [`allowedProviders`](/docs/fr/settings-reference#allowedproviders) | Appliquée comme une liste d'autorisation vide jusqu'à ce que la valeur soit corrigée, donc chaque fournisseur d'API est refusé et Claude Code ne démarre pas sur la machine. Si seule une entrée individuelle n'est pas un nom de fournisseur connu, Claude Code supprime et signale cette entrée et applique le reste. |

403| `allowedHttpHookUrls` | Claude Code applique une [liste d'autorisation](/docs/fr/settings-reference#allowedhttphookurls) gérée vide jusqu'à ce que vous corrigiez la valeur, donc un hook HTTP s'exécute uniquement si un autre fichier de paramètres énumère son URL. Si seule une entrée individuelle est invalide, Claude Code supprime cette entrée et applique le reste. |405| `allowedHttpHookUrls` | Claude Code applique une [liste d'autorisation](/docs/fr/settings-reference#allowedhttphookurls) gérée vide jusqu'à ce que vous corrigiez la valeur, donc un hook HTTP s'exécute uniquement si un autre fichier de paramètres énumère son URL. Si seule une entrée individuelle est invalide, Claude Code supprime cette entrée et applique le reste. |

404| `httpHookAllowedEnvVars` | Claude Code applique une [liste d'autorisation](/docs/fr/settings-reference#httphookallowedenvvars) gérée vide jusqu'à ce que vous corrigiez la valeur, donc une variable d'en-tête est interpolée uniquement si un autre fichier de paramètres la nomme. Si seule une entrée individuelle est invalide, Claude Code supprime cette entrée et applique le reste. |406| `httpHookAllowedEnvVars` | Claude Code applique une [liste d'autorisation](/docs/fr/settings-reference#httphookallowedenvvars) gérée vide jusqu'à ce que vous corrigiez la valeur, donc une variable d'en-tête est interpolée uniquement si un autre fichier de paramètres la nomme. Si seule une entrée individuelle est invalide, Claude Code supprime cette entrée et applique le reste. |


413| [`deniedModels`](/docs/fr/settings-reference#deniedmodels) | Une entrée non-chaîne est supprimée et le reste de la liste est appliqué. Une valeur entièrement invalide est supprimée avec un avertissement et ne bloque aucun modèle jusqu'à ce qu'elle soit corrigée. |415| [`deniedModels`](/docs/fr/settings-reference#deniedmodels) | Une entrée non-chaîne est supprimée et le reste de la liste est appliqué. Une valeur entièrement invalide est supprimée avec un avertissement et ne bloque aucun modèle jusqu'à ce qu'elle soit corrigée. |

414| `blockedMarketplaces` | Une entrée invalide individuelle est supprimée et le sous-ensemble valide est appliqué. Une entrée qui analyse mais ne peut jamais correspondre, comme une regex `hostPattern` qui ne compile pas, est conservée avec un avertissement. Elle ne bloque rien jusqu'à correction, mais les [restrictions de marketplace](/docs/fr/plugins/org#restrict-what-users-can-install) restent actives. Une valeur entièrement invalide est supprimée avec un avertissement, car bloquer chaque marketplace bloquerait les sources que la politique n'a jamais nommées. |416| `blockedMarketplaces` | Une entrée invalide individuelle est supprimée et le sous-ensemble valide est appliqué. Une entrée qui analyse mais ne peut jamais correspondre, comme une regex `hostPattern` qui ne compile pas, est conservée avec un avertissement. Elle ne bloque rien jusqu'à correction, mais les [restrictions de marketplace](/docs/fr/plugins/org#restrict-what-users-can-install) restent actives. Une valeur entièrement invalide est supprimée avec un avertissement, car bloquer chaque marketplace bloquerait les sources que la politique n'a jamais nommées. |

415| `sandbox` | Quand une valeur à l'intérieur du bloc est invalide, Claude Code ne supprime pas le bloc entier. Pour ce qui arrive à chaque type de champ invalide, consultez [Valeurs invalides à l'intérieur de `sandbox`](#invalid-values-inside-sandbox). |417| `sandbox` | Quand une valeur à l'intérieur du bloc est invalide, Claude Code ne supprime pas le bloc entier. Pour ce qui arrive à chaque type de champ invalide, consultez [Valeurs invalides à l'intérieur de `sandbox`](#invalid-values-inside-sandbox). |

416| `sandbox.credentials` | Une entrée invalide récupérable est dégradée à `mode: "deny"` avec un avertissement ; une irrécupérable est supprimée ; les entrées valides restent appliquées. Consultez [entrées de credential invalides](/docs/fr/settings-reference#invalid-credential-entries-in-managed-settings). |418| `sandbox.credentials` | Une entrée invalide récupérable est dégradée à `mode: "deny"` avec un avertissement ; une irrécupérable est supprimée ; les entrées valides restent appliquées. Consultez [entrées d'identifiants invalides](/docs/fr/settings-reference#invalid-credential-entries-in-managed-settings). |

417| `strictPluginOnlyCustomization` | Traitée comme `true`, verrouillant les quatre surfaces, quand la valeur n'est ni un booléen ni un tableau. Une entrée de tableau que cette version ne reconnaît pas comme une surface ne verrouille rien ; une note de statut compte ces entrées pour que vous puissiez les vérifier pour les fautes de frappe. |419| `strictPluginOnlyCustomization` | Traitée comme `true`, verrouillant les quatre surfaces, quand la valeur n'est ni un booléen ni un tableau. Une entrée de tableau que cette version ne reconnaît pas comme une surface ne verrouille rien ; une note de statut compte ces entrées pour que vous puissiez les vérifier pour les fautes de frappe. |

418| `enabledPlugins` | Une entrée invalide est supprimée avec un avertissement et les autres entrées restent appliquées. Une valeur qui n'est pas une carte d'ID de plugin, ou dont chaque entrée est invalide, est supprimée entièrement avec un avertissement. |420| `enabledPlugins` | Une entrée invalide est supprimée avec un avertissement et les autres entrées restent appliquées. Une valeur qui n'est pas une carte d'ID de plugin, ou dont chaque entrée est invalide, est supprimée entièrement avec un avertissement. |

419 421 

420`allowedHttpHookUrls` et `httpHookAllowedEnvVars` fusionnent entre les fichiers de paramètres, donc les entrées dans vos paramètres utilisateur, projet ou local s'appliquent toujours tandis que la liste gérée est vide.422`allowedHttpHookUrls` et `httpHookAllowedEnvVars` fusionnent entre les fichiers de paramètres, donc les entrées dans vos paramètres utilisateur, projet ou local s'appliquent toujours tandis que la liste gérée est vide.

421 423 

422Les fallbacks pour ces deux clés et pour `allowedChannelPlugins` nécessitent Claude Code v2.1.267 ou ultérieur ; les versions antérieures suppriment la clé entière quand sa valeur ou une entrée est invalide. Les fallbacks pour `strictKnownMarketplaces` et `blockedMarketplaces` nécessitent Claude Code v2.1.277 ou ultérieur ; les versions antérieures suppriment la clé entière quand sa valeur ou une entrée est invalide. Les fallbacks pour `strictPluginOnlyCustomization` et `enabledPlugins` nécessitent Claude Code v2.1.282 ou ultérieur.424Les solutions de repli pour ces deux clés et pour `allowedChannelPlugins` nécessitent Claude Code v2.1.267 ou ultérieur ; les versions antérieures suppriment la clé entière quand sa valeur ou une entrée est invalide. Les solutions de repli pour `strictKnownMarketplaces` et `blockedMarketplaces` nécessitent Claude Code v2.1.277 ou ultérieur ; les versions antérieures suppriment la clé entière quand sa valeur ou une entrée est invalide. Les solutions de repli pour `strictPluginOnlyCustomization` et `enabledPlugins` nécessitent Claude Code v2.1.282 ou ultérieur.

423 425 

424`requiredMinimumVersion` et `requiredMaximumVersion` échouent ouvertes par conception : une valeur invalide est supprimée plutôt qu'appliquée.426`requiredMinimumVersion` et `requiredMaximumVersion` échouent ouvertes par conception : une valeur invalide est supprimée plutôt qu'appliquée.

425 427 

model-config.md +2 −1

Details

285* **[Secours de modèle automatique](#automatic-model-fallback)** : un secours dont la cible est exclue ne s'exécute pas, donc la demande signalée se termine par un refus à la place285* **[Secours de modèle automatique](#automatic-model-fallback)** : un secours dont la cible est exclue ne s'exécute pas, donc la demande signalée se termine par un refus à la place

286* **[Classifieur du mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode)** : la valeur par défaut Claude Sonnet 5 du classifieur s'applique uniquement lorsque la liste d'autorisation permet Sonnet 5. Lorsqu'il est exclu, le classifieur s'exécute sur le modèle de la session, que la liste d'autorisation gouverne déjà, ou sur un modèle Opus lorsque la session s'exécute sur un [modèle Fable](#work-with-fable). Sur les fournisseurs autres que l'API Anthropic, ce secours Opus s'exécute sur le modèle que vous définissez dans `ANTHROPIC_DEFAULT_OPUS_MODEL` ou, à défaut, sur Opus 5, sans consulter la liste d'autorisation. Nécessite Claude Code v2.1.210 ou ultérieur286* **[Classifieur du mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode)** : la valeur par défaut Claude Sonnet 5 du classifieur s'applique uniquement lorsque la liste d'autorisation permet Sonnet 5. Lorsqu'il est exclu, le classifieur s'exécute sur le modèle de la session, que la liste d'autorisation gouverne déjà, ou sur un modèle Opus lorsque la session s'exécute sur un [modèle Fable](#work-with-fable). Sur les fournisseurs autres que l'API Anthropic, ce secours Opus s'exécute sur le modèle que vous définissez dans `ANTHROPIC_DEFAULT_OPUS_MODEL` ou, à défaut, sur Opus 5, sans consulter la liste d'autorisation. Nécessite Claude Code v2.1.210 ou ultérieur

287* **[Mode rapide](/docs/fr/fast-mode)** : l'activation du mode rapide est refusée lorsque le modèle sur lequel la session s'exécuterait ensuite est en dehors de la liste d'autorisation287* **[Mode rapide](/docs/fr/fast-mode)** : l'activation du mode rapide est refusée lorsque le modèle sur lequel la session s'exécuterait ensuite est en dehors de la liste d'autorisation

288* **Secours de disponibilité sur Amazon Bedrock et Agent Platform de Google Cloud** : lorsque votre compte perd l'accès à un modèle en cours de session, le basculement vers un autre modèle ignore les modèles exclus. Les vérifications de modèle au démarrage sur [Amazon Bedrock](/docs/fr/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) et [Agent Platform de Google Cloud](/docs/fr/google-vertex-ai#when-your-organization-enforces-a-model-allowlist) n'ignorent les modèles exclus que lorsque les paramètres gérés définissent également [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model)

288 289 

289```json theme={null}290```json theme={null}

290{291{


766| :- | :- |767| :- | :- |

767| Basculer pour la session actuelle | Appuyez sur `Option+T` sur macOS ou `Alt+T` sur Windows et Linux |768| Basculer pour la session actuelle | Appuyez sur `Option+T` sur macOS ou `Alt+T` sur Windows et Linux |

768| Définir le défaut global | Exécutez `/config` et basculez le mode de réflexion. Enregistré comme `alwaysThinkingEnabled` dans `~/.claude/settings.json` |769| Définir le défaut global | Exécutez `/config` et basculez le mode de réflexion. Enregistré comme `alwaysThinkingEnabled` dans `~/.claude/settings.json` |

769| Désactiver via une variable d'environnement | Définissez [`MAX_THINKING_TOKENS=0`](/docs/fr/env-vars), qui désactive la réflexion sur l'API Anthropic sauf sur Opus 5.5, Sonnet 5.5 et les modèles Fable. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations), Claude Code omet le paramètre `thinking` à la place, et les modèles de raisonnement adaptatif peuvent toujours penser. D'autres valeurs s'appliquent uniquement avec un [budget de réflexion fixe](#adaptive-reasoning-and-fixed-thinking-budgets) |770| Désactiver via une variable d'environnement | Définissez [`MAX_THINKING_TOKENS=0`](/docs/fr/env-vars), qui désactive la réflexion sur l'API Anthropic sauf sur Opus 5.5, Sonnet 5.5 et les modèles Fable. Sur les [fournisseurs tiers](/docs/fr/third-party-integrations), Claude Code omet le paramètre `thinking` à la place, et les modèles à raisonnement adaptatif peuvent toujours réfléchir |

770 771 

771Vous ne pouvez pas désactiver la réflexion sur Opus 5.5, Sonnet 5.5 ou les modèles Fable. Le basculement de session et le `/config` affichent `Thinking can't be turned off` pour ces modèles à la place d'offrir le basculement, et une `alwaysThinkingEnabled: false` enregistrée ou `MAX_THINKING_TOKENS=0` n'a aucun effet là. Sur ces modèles, le modèle décide à chaque étape combien penser en fonction du niveau d'effort. Le paramètre enregistré s'applique à nouveau quand vous basculez vers un modèle qui l'accepte.772Vous ne pouvez pas désactiver la réflexion sur Opus 5.5, Sonnet 5.5 ou les modèles Fable. Le basculement de session et le `/config` affichent `Thinking can't be turned off` pour ces modèles à la place d'offrir le basculement, et une `alwaysThinkingEnabled: false` enregistrée ou `MAX_THINKING_TOKENS=0` n'a aucun effet là. Sur ces modèles, le modèle décide à chaque étape combien penser en fonction du niveau d'effort. Le paramètre enregistré s'applique à nouveau quand vous basculez vers un modèle qui l'accepte.

772 773 

Details

358 358 

359<span id="new-context-gates" />359<span id="new-context-gates" />

360 360 

361**Attributs de contenu sous le traçage bêta détaillé**

362 

361<Note>363<Note>

362 Les attributs supplémentaires porteurs de contenu tels que `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input` et `response.model_output` ne sont émis que lorsque le traçage bêta détaillé est actif. Ils ne font pas partie du schéma de span stable.364 Les attributs supplémentaires porteurs de contenu tels que `new_context`, `system_reminders`, `system_prompt_preview`, `user_system_prompt`, `tool_input` et `response.model_output` ne sont émis que lorsque le traçage bêta détaillé est actif. Ils ne font pas partie du schéma de span stable.

365</Note>

363 366 

364 La porte sur `new_context` dépend du span qui le porte, et chaque copie est tronquée à la limite de contenu (60 Ko par défaut). Sur le span `claude_code.tool`, il porte le résultat de cet appel d'outil, quel que soit l'outil, et nécessite `OTEL_LOG_TOOL_CONTENT=1`. Sur le span `claude_code.interaction`, il porte l'invite utilisateur, et sur le span `claude_code.llm_request`, les nouveaux messages utilisateur et résultats d'outils de cette demande. Les deux nécessitent `OTEL_LOG_USER_PROMPTS=1`.367Ces attributs apparaissent sur les spans ci-dessous, et `Contrôlé par` nomme la variable dont un attribut a besoin en plus du traçage bêta détaillé. Les valeurs plus longues que la limite de contenu (60 Ko par défaut) sont tronquées.

365 368 

366 `user_system_prompt` nécessite en outre `OTEL_LOG_USER_PROMPTS=1`. Il porte uniquement le texte d'invite système que vous fournissez via l'option SDK `systemPrompt` ou les drapeaux `--system-prompt` et `--append-system-prompt`, tronqué à la limite de contenu (60 Ko par défaut), et est émis une fois par session plutôt que par demande.369| Attribut | Span | Description | Contrôlé par |

367</Note>370| - | - | - | - |

371| `new_context` | `claude_code.interaction` | Le prompt utilisateur | `OTEL_LOG_USER_PROMPTS` |

372| `new_context` | `claude_code.llm_request` | Les nouveaux messages utilisateur et résultats d'outils envoyés avec la requête | `OTEL_LOG_USER_PROMPTS` |

373| `system_reminders` | `claude_code.llm_request` | Le texte des [rappels système](/docs/fr/glossary#system-reminder) parmi les nouveaux messages de la requête | `OTEL_LOG_USER_PROMPTS` |

374| `system_prompt_preview` | `claude_code.llm_request` | Les 500 premiers caractères du prompt système complet envoyé avec la requête | `OTEL_LOG_USER_PROMPTS` |

375| `user_system_prompt` | `claude_code.llm_request` | Uniquement le texte du prompt système que vous fournissez via l'option SDK `systemPrompt` ou les flags `--system-prompt` et `--append-system-prompt`. Émis une fois par session plutôt que par requête | `OTEL_LOG_USER_PROMPTS` |

376| `response.model_output` | `claude_code.llm_request` | Texte de la réponse du modèle à la requête | `OTEL_LOG_USER_PROMPTS` |

377| `new_context` | `claude_code.tool` | Le résultat de l'appel d'outil, quel que soit l'outil | `OTEL_LOG_TOOL_CONTENT` |

378| `tool_input` | `claude_code.tool` | L'entrée sérialisée de l'appel d'outil | `OTEL_LOG_TOOL_DETAILS` |

379 

380Sous le traçage bêta détaillé avec `OTEL_LOG_USER_PROMPTS=1`, Claude Code émet également un événement `claude_code.system_prompt` qui porte le prompt système complet, tronqué à la limite de contenu. Il arrive la première fois qu'une session envoie chaque prompt système distinct, puis de nouveau après une compaction.

368 381 

369<h3 id="dynamic-headers">382<h3 id="dynamic-headers">

370 En-têtes dynamiques383 En-têtes dynamiques


797* `event.sequence` : compteur par processus pour ordonner les événements, décrit dans [Attributs de corrélation des événements](#event-correlation-attributes)810* `event.sequence` : compteur par processus pour ordonner les événements, décrit dans [Attributs de corrélation des événements](#event-correlation-attributes)

798* `prompt_length` : longueur du prompt811* `prompt_length` : longueur du prompt

799* `prompt` : contenu du prompt. Masqué par défaut. Définissez `OTEL_LOG_USER_PROMPTS=1` pour l'inclure812* `prompt` : contenu du prompt. Masqué par défaut. Définissez `OTEL_LOG_USER_PROMPTS=1` pour l'inclure

813* `prompt_text` : Même valeur que `prompt`, masquée selon la même condition. Un backend qui stocke les noms d'attributs avec des points sous forme d'objets imbriqués lit `prompt.id` comme `id` à l'intérieur d'un objet nommé `prompt` et peut perdre la chaîne du prompt. Lisez plutôt `prompt_text` dans ce cas. Nécessite Claude Code v2.1.287 ou ultérieur

800* `message.uuid` : UUID du message utilisateur résultant, correspondant à l'entrée de transcription conservée. Absent pour les envois de commandes, qui peuvent produire zéro ou plusieurs messages. Nécessite Claude Code v2.1.214 ou ultérieur814* `message.uuid` : UUID du message utilisateur résultant, correspondant à l'entrée de transcription conservée. Absent pour les envois de commandes, qui peuvent produire zéro ou plusieurs messages. Nécessite Claude Code v2.1.214 ou ultérieur

801* `command_name` : nom de la commande lorsque le prompt en invoque une. Les noms des commandes intégrées et fournies, comme `compact` ou `debug`, sont émis tels quels ; les alias comme `reset` sont émis tels que saisis plutôt que sous leur nom canonique. Les noms des commandes personnalisées, de plugins et MCP sont ramenés à `custom` ou `mcp`, sauf si `OTEL_LOG_TOOL_DETAILS=1` est défini815* `command_name` : nom de la commande lorsque le prompt en invoque une. Les noms des commandes intégrées et fournies, comme `compact` ou `debug`, sont émis tels quels ; les alias comme `reset` sont émis tels que saisis plutôt que sous leur nom canonique. Les noms des commandes personnalisées, de plugins et MCP sont ramenés à `custom` ou `mcp`, sauf si `OTEL_LOG_TOOL_DETAILS=1` est défini

802* `command_source` : origine de la commande lorsqu'elle est présente : `builtin`, `custom` ou `mcp`. Les commandes fournies par des plugins sont signalées comme `custom`816* `command_source` : origine de la commande lorsqu'elle est présente : `builtin`, `custom` ou `mcp`. Les commandes fournies par des plugins sont signalées comme `custom`


1694* L'export OpenTelemetry vers votre backend est opt-in et nécessite une configuration explicite. Pour la télémétrie opérationnelle distincte d'Anthropic et comment la désactiver, consultez [Utilisation des données](/docs/fr/data-usage#telemetry-services)1708* L'export OpenTelemetry vers votre backend est opt-in et nécessite une configuration explicite. Pour la télémétrie opérationnelle distincte d'Anthropic et comment la désactiver, consultez [Utilisation des données](/docs/fr/data-usage#telemetry-services)

1695* Les contenus de fichiers bruts et les extraits de code ne sont pas inclus dans les métriques ou les événements. Les intervalles de trace constituent un chemin de données distinct : voir la puce `OTEL_LOG_TOOL_CONTENT` ci-dessous1709* Les contenus de fichiers bruts et les extraits de code ne sont pas inclus dans les métriques ou les événements. Les intervalles de trace constituent un chemin de données distinct : voir la puce `OTEL_LOG_TOOL_CONTENT` ci-dessous

1696* Lorsqu'authentifié via OAuth, `user.email` est inclus dans les attributs de télémétrie, envoyé uniquement au point de terminaison OTel que vous configurez, jamais à Anthropic. Si cela pose un problème pour votre organisation, travaillez avec votre backend de télémétrie pour filtrer ou masquer ce champ1710* Lorsqu'authentifié via OAuth, `user.email` est inclus dans les attributs de télémétrie, envoyé uniquement au point de terminaison OTel que vous configurez, jamais à Anthropic. Si cela pose un problème pour votre organisation, travaillez avec votre backend de télémétrie pour filtrer ou masquer ce champ

1697* Le contenu des invites utilisateur n'est pas collecté par défaut. Seule la longueur de l'invite est enregistrée. Pour inclure le contenu de l'invite, définissez `OTEL_LOG_USER_PROMPTS=1`. Sous le traçage bêta détaillé, cette variable s'étend au-delà du texte d'invite : elle contrôle également l'[attribut d'intervalle `new_context`](#new-context-gates), qui porte les résultats d'outil sur l'intervalle `claude_code.llm_request`1711* Le contenu des prompts utilisateur n'est pas collecté par défaut. Seule la longueur du prompt est enregistrée. Pour inclure le contenu du prompt, définissez `OTEL_LOG_USER_PROMPTS=1`. Lorsque cette option est activée :

1698* Le texte de réponse de l'assistant n'est pas collecté par défaut. Seule la longueur de la réponse est enregistrée. Pour inclure le texte de réponse, définissez `OTEL_LOG_ASSISTANT_RESPONSES=1`. Comme toutes les données OpenTelemetry de Claude Code, le texte de réponse est envoyé uniquement au point de terminaison OTel que vous configurez, jamais à Anthropic. Lorsque cette variable n'est pas définie, `OTEL_LOG_USER_PROMPTS` est utilisé comme solution de secours, donc définissez `OTEL_LOG_ASSISTANT_RESPONSES=0` si vous souhaitez le contenu de l'invite sans contenu de réponse1712 * Les événements `user_prompt` portent le texte du prompt dans deux attributs, `prompt` et [`prompt_text`](#user-prompt-event). Si vous supprimez ou masquez le texte du prompt de l'événement par nom d'attribut dans votre collecteur, nommez les deux attributs dans la règle

1699* Les arguments d'entrée d'outil et les paramètres ne sont pas enregistrés par défaut. Pour les inclure, définissez `OTEL_LOG_TOOL_DETAILS=1`. Pour les serveurs intégrés de Claude Desktop, dans les sessions que Claude Desktop possède, `tool_decision` et `tool_result` portent la paire `mcp_server_name`/`mcp_tool_name`, des noms créés par l'hôte plutôt que du contenu d'argument, même avec le drapeau désactivé. L'exception nécessite Claude Code v2.1.214 ou version ultérieure. Ces données sont envoyées uniquement au point de terminaison OTEL que vous configurez, jamais à Anthropic. Les arguments peuvent toujours contenir des valeurs sensibles, donc configurez votre backend de télémétrie pour filtrer ou masquer ces attributs selon les besoins. Lorsqu'activé :1713 

1700 * Les événements `tool_result` et `tool_decision` incluent un attribut `tool_parameters` avec les commandes Bash, les noms de serveur MCP et d'outil, et les noms de compétences. Les champs tels que `full_command` sont émis sans troncature1714 Ce processeur `attributes` de l'OpenTelemetry Collector supprime les deux attributs dans les pipelines qui le référencent :

1715 

1716 ```yaml theme={null}

1717 processors:

1718 attributes/drop-prompt-text:

1719 actions:

1720 - key: prompt

1721 action: delete

1722 - key: prompt_text

1723 action: delete

1724 ```

1725 

1726 * Avec le [traçage](#traces-beta) activé, l'intervalle `claude_code.interaction` porte le texte du prompt dans son attribut `user_prompt`

1727 

1728 * Sous le traçage bêta détaillé, les intervalles portent également les nouveaux messages utilisateur, les résultats d'outils et les rappels système envoyés avec chaque requête, le texte du prompt système et la sortie du modèle. [Attributs de contenu sous le traçage bêta détaillé](#new-context-gates) répertorie chaque attribut. L'événement `claude_code.system_prompt` porte le prompt système complet

1729* Le texte de réponse de l'assistant n'est pas collecté par défaut. Seule la longueur de la réponse est enregistrée. Pour inclure le texte de réponse, définissez `OTEL_LOG_ASSISTANT_RESPONSES=1`. Comme toutes les données OpenTelemetry de Claude Code, le texte de réponse est envoyé uniquement à l'endpoint OTel que vous configurez, jamais à Anthropic. Lorsque cette variable n'est pas définie, `OTEL_LOG_USER_PROMPTS` est utilisé comme solution de repli, donc définissez `OTEL_LOG_ASSISTANT_RESPONSES=0` si vous souhaitez le contenu du prompt sans contenu de réponse dans les événements. Sous le traçage bêta détaillé, l'intervalle `claude_code.llm_request` porte toujours la sortie du modèle dans [`response.model_output`](#new-context-gates), qui suit `OTEL_LOG_USER_PROMPTS` plutôt que cette variable

1730* Les arguments d'entrée d'outil et les paramètres ne sont pas journalisés par défaut. Pour les inclure, définissez `OTEL_LOG_TOOL_DETAILS=1`. Pour les serveurs intégrés de Claude Desktop, dans les sessions que Claude Desktop possède, `tool_decision` et `tool_result` portent la paire `mcp_server_name`/`mcp_tool_name`, des noms créés par l'hôte plutôt que du contenu d'argument, même avec le flag désactivé. L'exception nécessite Claude Code v2.1.214 ou version ultérieure. Ces données sont envoyées uniquement à l'endpoint OTEL que vous configurez, jamais à Anthropic. Les arguments peuvent toujours contenir des valeurs sensibles, donc configurez votre backend de télémétrie pour filtrer ou masquer ces attributs selon les besoins. Lorsqu'activé :

1731 * Les événements `tool_result` et `tool_decision` incluent un attribut `tool_parameters` avec les commandes Bash, les noms de serveur MCP et d'outil, et les noms de skills. Les champs tels que `full_command` sont émis sans troncature

1701 * Les événements `tool_result` incluent également un attribut `tool_input` avec les chemins de fichiers, les URL, les modèles de recherche et d'autres arguments. Les valeurs individuelles dépassant 512 caractères sont tronquées et le total est limité à environ 4 K caractères1732 * Les événements `tool_result` incluent également un attribut `tool_input` avec les chemins de fichiers, les URL, les modèles de recherche et d'autres arguments. Les valeurs individuelles dépassant 512 caractères sont tronquées et le total est limité à environ 4 K caractères

1702 * Les événements `user_prompt` incluent le `command_name` verbatim pour les commandes personnalisées, de plugin et MCP1733 * Les événements `user_prompt` incluent le `command_name` verbatim pour les commandes personnalisées, de plugin et MCP

1703 * Les [compteurs de coût et de jeton](#cost-counter) et les événements `api_request`, `api_error` et `api_refusal` portent les noms réels d'agent, de compétence, de plugin et de serveur MCP et d'outil dans leurs attributs d'attribution1734 * Les [compteurs de coût et de tokens](#cost-counter) et les événements `api_request`, `api_error` et `api_refusal` portent les noms réels d'agent, de skill, de plugin et de serveur MCP et d'outil dans leurs attributs d'attribution

1704 * Les intervalles de trace incluent le même attribut `tool_input` et les attributs dérivés de l'entrée tels que `file_path`, avec la même troncature que `tool_input`1735 * L'intervalle `claude_code.tool` porte des attributs dérivés de l'entrée tels que `file_path`. Sous le traçage bêta détaillé, il porte également un attribut [`tool_input`](#new-context-gates)

1705* Le contenu d'outil n'est pas enregistré dans les intervalles de trace par défaut. Pour l'inclure, définissez `OTEL_LOG_TOOL_CONTENT=1`. L'intervalle `claude_code.tool` porte alors un [événement d'intervalle `tool.output`](#tool-output-span-event) avec les contenus de fichiers bruts, la sortie de commande Bash, et ce que les outils MCP, WebFetch et WebSearch retournent, tronqués à la limite de contenu (60 Ko par défaut) par attribut. Les résultats des outils MCP, WebFetch et WebSearch nécessitent Claude Code v2.1.283 ou version ultérieure. Le contenu d'outil atteint également les intervalles via [`new_context`, dont la porte diffère par intervalle](#new-context-gates). Configurez votre backend de télémétrie pour filtrer ou masquer ces attributs selon les besoins1736* Le contenu d'outil n'est pas enregistré dans les intervalles de trace par défaut. Pour l'inclure, définissez `OTEL_LOG_TOOL_CONTENT=1`. L'intervalle `claude_code.tool` porte alors un [événement d'intervalle `tool.output`](#tool-output-span-event) avec les contenus de fichiers bruts, la sortie de commande Bash, et ce que les outils MCP, WebFetch et WebSearch retournent, tronqués à la limite de contenu (60 Ko par défaut) par attribut. Les résultats des outils MCP, WebFetch et WebSearch nécessitent Claude Code v2.1.283 ou version ultérieure. Le contenu d'outil atteint également les intervalles via [`new_context`, dont la porte diffère par intervalle](#new-context-gates). Configurez votre backend de télémétrie pour filtrer ou masquer ces attributs selon les besoins

1706* Les corps bruts de la demande et de la réponse de l'API Messages d'Anthropic ne sont pas enregistrés par défaut. Pour les inclure, définissez `OTEL_LOG_RAW_API_BODIES` dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Il est ignoré dans [les paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Les corps contiennent l'historique complet de la conversation, y compris l'invite système, chaque tour d'utilisateur et d'assistant antérieur, et les résultats d'outils, donc l'activation de cette option implique le consentement à tout ce que les autres drapeaux de contenu `OTEL_LOG_*` révèleraient. Claude Code masque toujours le contenu de réflexion étendue de Claude de ces corps, indépendamment des autres paramètres. La valeur que vous définissez détermine comment Claude Code livre les corps :1737* Les corps bruts de la demande et de la réponse de l'API Messages d'Anthropic ne sont pas enregistrés par défaut. Pour les inclure, définissez `OTEL_LOG_RAW_API_BODIES` dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Il est ignoré dans [les paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). Les corps contiennent l'historique complet de la conversation, y compris l'invite système, chaque tour d'utilisateur et d'assistant antérieur, et les résultats d'outils, donc l'activation de cette option implique le consentement à tout ce que les autres drapeaux de contenu `OTEL_LOG_*` révèleraient. Claude Code masque toujours le contenu de réflexion étendue de Claude de ces corps, indépendamment des autres paramètres. La valeur que vous définissez détermine comment Claude Code livre les corps :

1707 * Avec `=1`, Claude Code émet des événements de journaux `api_request_body` et `api_response_body` pour chaque appel d'API. L'attribut `body` des événements porte la charge utile sérialisée en JSON, tronquée à la limite de contenu (60 Ko par défaut)1738 * Avec `=1`, Claude Code émet des événements de journaux `api_request_body` et `api_response_body` pour chaque appel d'API. L'attribut `body` des événements porte la charge utile sérialisée en JSON, tronquée à la limite de contenu (60 Ko par défaut)

Details

69 69 

70Quand vous démarrez une nouvelle session dans un terminal, Claude Code prend le mode de permission du premier de ces éléments qui s'applique :70Quand vous démarrez une nouvelle session dans un terminal, Claude Code prend le mode de permission du premier de ces éléments qui s'applique :

71 71 

721. Le drapeau `--permission-mode`, ou `--dangerously-skip-permissions`721. Le flag `--permission-mode`, ou `--dangerously-skip-permissions`

73 73 

742. `permissions.defaultMode` dans un [fichier de paramètres](/docs/fr/settings#where-settings-live)742. `permissions.defaultMode` dans un [fichier de paramètres](/docs/fr/settings#where-settings-live)

75 75 


86| Comment vous exécutez Claude Code | Mode de permission de démarrage intégré |86| Comment vous exécutez Claude Code | Mode de permission de démarrage intégré |

87| :- | :- |87| :- | :- |

88| Un fichier de paramètres définit `disableAutoMode` sur `"disable"` | `default` |88| Un fichier de paramètres définit `disableAutoMode` sur `"disable"` | `default` |

89| `claude -p` ou le [SDK Agent](/docs/fr/agent-sdk/permissions#permission-modes) | `default` dans les sessions qui [récupèrent les drapeaux de fonctionnalité](/docs/fr/env-vars#features-that-need-feature-flag-fetching). Dans les sessions qui ne le font pas, comme sur un fournisseur tiers ou avec la télémétrie désactivée, `auto` avec Claude Code v2.1.285 ou version ultérieure et `default` sur les versions antérieures. Une session dans une organisation dont la politique refuse la valeur par défaut `auto` démarre dans `default` à la place |89| `claude -p` ou le [SDK Agent](/docs/fr/agent-sdk/permissions#permission-modes) | `default` dans les sessions qui [récupèrent les flags de fonctionnalité](/docs/fr/env-vars#features-that-need-feature-flag-fetching). Dans les sessions qui ne le font pas, comme sur un fournisseur tiers ou avec la télémétrie désactivée, `auto` avec Claude Code v2.1.285 ou version ultérieure et `default` sur les versions antérieures. Une session dans une organisation dont la politique refuse la valeur par défaut `auto` démarre dans `default` à la place |

90| Dans un terminal ou via l'[extension VS Code](/docs/fr/vs-code) | `auto` avec Claude Code v2.1.283 ou version ultérieure ; sur les versions antérieures, `auto` sur les plans Pro, Max ou Team dans les sessions qui [récupèrent les drapeaux de fonctionnalité](/docs/fr/env-vars#features-that-need-feature-flag-fetching), et `default` sinon |90| Dans un terminal ou via l'[extension VS Code](/docs/fr/vs-code) | `auto` avec Claude Code v2.1.283 ou version ultérieure ; sur les versions antérieures, `auto` sur les plans Pro, Max ou Team dans les sessions qui [récupèrent les flags de fonctionnalité](/docs/fr/env-vars#features-that-need-feature-flag-fetching), et `default` sinon |

91 91 

92Dans votre [première session après une installation ou une mise à niveau](/docs/fr/env-vars#first-session-after-an-install-or-upgrade), Claude Code peut choisir le mode de permission de démarrage avant l'arrivée de ses drapeaux de fonctionnalité. Cette session peut démarrer dans un mode de permission différent de celui que le tableau indique, et votre session suivante correspond au tableau.92Dans votre [première session après une installation ou une mise à niveau](/docs/fr/env-vars#first-session-after-an-install-or-upgrade), Claude Code peut choisir le mode de permission de démarrage avant l'arrivée de ses flags de fonctionnalité. Cette session peut démarrer dans un mode de permission différent de celui que le tableau indique.

93 93 

94Quand le drapeau, un fichier de paramètres ou la valeur par défaut intégrée sélectionne `auto` mais que le mode auto n'est pas disponible pour la session, Claude Code démarre la session en mode Manuel à la place. Le mode auto est indisponible quand la session ne répond pas aux [exigences de disponibilité](#eliminate-prompts-with-auto-mode), comme un fichier de paramètres le désactivant ou un modèle qui ne le supporte pas, ou quand Anthropic l'a temporairement désactivé côté serveur.94Quand le flag, un fichier de paramètres ou la valeur par défaut intégrée sélectionne `auto` mais que le mode auto n'est pas disponible pour la session, Claude Code démarre la session en mode Manuel à la place. Le mode auto est indisponible quand la session ne répond pas aux [exigences de disponibilité](#eliminate-prompts-with-auto-mode), comme un fichier de paramètres le désactivant ou un modèle qui ne le supporte pas, ou quand Anthropic l'a temporairement désactivé côté serveur.

95 95 

96La première fois que la valeur par défaut intégrée démarre l'une de vos sessions en mode auto, Claude Code affiche un avis qui renvoie à cette page :96La première fois que la valeur par défaut intégrée démarre l'une de vos sessions en mode auto, Claude Code affiche un avis qui renvoie à cette page :

97 97 

98* Dans un terminal, une fois, en haut de la session98* Dans un terminal, une fois, en haut de la session

99* Dans l'extension VS Code, sous forme de carte sur l'écran de nouvelle conversation qui reste jusqu'à ce que vous la fermiez99* Dans l'extension VS Code, sous forme de carte sur l'écran de nouvelle conversation qui reste jusqu'à ce que vous la fermiez

100 100 

101Si votre `~/.claude/settings.json` définit un `defaultMode` autre que `auto` et qu'aucun autre fichier de paramètres n'en définit un, vos sessions continuent à démarrer dans ce mode. Sur les plans Pro, Max et Team, et dans les sessions qui [ne récupèrent pas les drapeaux de fonctionnalité](/docs/fr/env-vars#features-that-need-feature-flag-fetching), Claude Code demande une fois, dans le terminal ou dans l'extension VS Code, si vous souhaitez modifier le paramètre en mode auto. Si vous refusez, votre paramètre reste tel quel.101Si votre `~/.claude/settings.json` définit un `defaultMode` autre que `auto` et qu'aucun autre fichier de paramètres n'en définit un, vos sessions continuent à démarrer dans ce mode. Sur les plans Pro, Max et Team, et dans les sessions qui [ne récupèrent pas les flags de fonctionnalité](/docs/fr/env-vars#features-that-need-feature-flag-fetching), Claude Code demande une fois, dans le terminal ou dans l'extension VS Code, si vous souhaitez modifier le paramètre en mode auto. Si vous refusez, votre paramètre reste tel quel.

102 102 

103<h3 id="start-in-a-different-mode">103<h3 id="start-in-a-different-mode">

104 Démarrer dans un mode de permission différent104 Démarrer dans un mode de permission différent

105</h3>105</h3>

106 106 

107Vous pouvez définir le mode de permission de démarrage pour une session, ou comme valeur par défaut pour chaque session sur une machine, dans un projet ou dans une organisation. Quand plus d'un fichier de paramètres définit `permissions.defaultMode`, la [précédence des paramètres](/docs/fr/settings#settings-precedence) décide, donc une valeur de projet ou gérée surclasse `~/.claude/settings.json`. Pour modifier le mode de permission d'une session déjà en cours, voir [Basculer les modes de permission](#switch-permission-modes).107Vous pouvez définir le mode de permission de démarrage pour une session, ou comme valeur par défaut pour chaque session sur une machine, dans un projet ou dans une organisation. Quand plus d'un fichier de paramètres définit `permissions.defaultMode`, la [priorité des paramètres](/docs/fr/settings#settings-precedence) décide, donc une valeur de projet ou gérée l'emporte sur `~/.claude/settings.json`. Pour modifier le mode de permission d'une session déjà en cours, voir [Basculer les modes de permission](#switch-permission-modes).

108 108 

109| Pour définir le mode de permission de démarrage pour | Faites ceci |109| Pour définir le mode de permission de démarrage pour | Faites ceci |

110| :- | :- |110| :- | :- |

111| Une session que vous êtes sur le point de démarrer | Passez le mode de permission en tant que drapeau, par exemple `claude --permission-mode default` |111| Une session que vous êtes sur le point de démarrer | Passez le mode de permission en tant que flag, par exemple `claude --permission-mode default` |

112| Chaque session de terminal que vous démarrez sur cette machine | Définissez `permissions.defaultMode` dans `~/.claude/settings.json`. Pour ce que l'extension VS Code lit, voir [Basculer les modes de permission](#switch-permission-modes) |112| Chaque session de terminal que vous démarrez sur cette machine | Définissez `permissions.defaultMode` dans `~/.claude/settings.json`. Pour ce que l'extension VS Code lit, voir [Basculer les modes de permission](#switch-permission-modes) |

113| Chaque session de terminal que vous démarrez dans un projet | Définissez `permissions.defaultMode` dans le `.claude/settings.json` du projet. Les sessions que vous démarrez dans un terminal honorent chaque valeur sauf `auto` et `bypassPermissions` ; les sessions que l'extension VS Code démarre ne lisent pas les paramètres du projet pour le mode de permission de démarrage |113| Chaque session de terminal que vous démarrez dans un projet | Définissez `permissions.defaultMode` dans le `.claude/settings.json` du projet. Les sessions que vous démarrez dans un terminal honorent chaque valeur sauf `auto` et `bypassPermissions` ; les sessions que l'extension VS Code démarre ne lisent pas les paramètres du projet pour le mode de permission de démarrage |

114| Chaque session de terminal dans votre organisation | Définissez `permissions.defaultMode` dans les [paramètres gérés](/docs/fr/managed-settings). Les sessions de terminal démarrent dans ce mode et les gens peuvent toujours basculer vers le mode auto ; pour ce que l'extension VS Code lit, voir [Basculer les modes de permission](#switch-permission-modes). Pour supprimer le mode auto afin que personne ne puisse le sélectionner, définissez `permissions.disableAutoMode` sur `"disable"` à la place |114| Chaque session de terminal dans votre organisation | Définissez `permissions.defaultMode` dans les [paramètres gérés](/docs/fr/managed-settings). Les sessions de terminal démarrent dans ce mode et les gens peuvent toujours basculer vers le mode auto ; pour ce que l'extension VS Code lit, voir [Basculer les modes de permission](#switch-permission-modes). Pour supprimer le mode auto afin que personne ne puisse le sélectionner, définissez `permissions.disableAutoMode` sur `"disable"` à la place |


676* `.devcontainer`676* `.devcontainer`

677* `.yarn`677* `.yarn`

678* `.mvn`678* `.mvn`

679* `.claude`, sauf pour `.claude/worktrees` où Claude stocke ses propres git worktrees679* `.claude`, sauf pour `.claude/worktrees` où Claude stocke ses propres git worktrees, et sauf pour les fichiers markdown du répertoire de [mémoire automatique](/docs/fr/memory#storage-location) propre à Claude dans une session démarrée sans `--restricted`

680* Un répertoire que vous avez chargé avec [`--plugin-dir`](/docs/fr/plugins/mods/create#change-a-mod-with-claude), car Claude Code recharge et exécute le code d'un mod à partir de celui-ci quand un fichier change680* Un répertoire que vous avez chargé avec [`--plugin-dir`](/docs/fr/plugins/mods/create#change-a-mod-with-claude), car Claude Code recharge et exécute le code d'un mod à partir de celui-ci quand un fichier change

681 681 

682Fichiers protégés :682Fichiers protégés :


739Claude Code regarde également à l'intérieur de ces constructions :739Claude Code regarde également à l'intérieur de ces constructions :

740 740 

741* **Commandes imbriquées** : une sous-coquille avec `(...)`, un groupe d'accolades avec `{ ...; }`, une substitution de commande avec `$(...)` ou des backticks, ou une substitution de processus avec `<(...)`. Claude Code trouve une suppression de chemin critique qu'elle se trouve à l'intérieur de la forme imbriquée, comme dans `(rm -rf ~)` ou `echo "$(rm -rf ~)"`, ou ailleurs dans la même commande.741* **Commandes imbriquées** : une sous-coquille avec `(...)`, un groupe d'accolades avec `{ ...; }`, une substitution de commande avec `$(...)` ou des backticks, ou une substitution de processus avec `<(...)`. Claude Code trouve une suppression de chemin critique qu'elle se trouve à l'intérieur de la forme imbriquée, comme dans `(rm -rf ~)` ou `echo "$(rm -rf ~)"`, ou ailleurs dans la même commande.

742* **Scripts en ligne** : Claude Code vérifie un script passé à un shell comme `sh -c` ou `bash -c` pour les [cibles](#other-targets-that-count-as-critical-paths) de variable shell et de paramètre positionnel.742* **Scripts en ligne** : un script passé à `sh`, `bash`, `zsh` ou un shell POSIX similaire avec `-c`, comme dans `bash -c 'rm -rf ~'`.

743 * Quand le script est entre guillemets doubles, le shell d'invocation développe ses variables avant que le shell interne ne reçoive le script. Dans `find . -name '*.tmp' -exec sh -c "rm -rf \"$1\"/*" _ {} \;`, la commande se développe en une suppression de la racine du système de fichiers une fois par correspondance, et Claude Code la traite comme une suppression de chemin critique.743 * Quand le script est entre guillemets doubles, le shell d'invocation développe ses variables avant que le shell interne ne reçoive le script. Dans `find . -name '*.tmp' -exec sh -c "rm -rf \"$1\"/*" _ {} \;`, la commande se développe en une suppression de la racine du système de fichiers une fois par correspondance, et Claude Code la traite comme une suppression de chemin critique.

744 * Un script entre guillemets simples qui lie `$1` à une valeur réelle, comme `sh -c 'rm -rf "$1"/*' _ {}` le fait, n'est pas signalé.744 * Un script entre guillemets simples qui lie `$1` à une valeur réelle, comme `sh -c 'rm -rf "$1"/*' _ {}` le fait, n'est pas signalé.

745 745 

746Pour désactiver la vérification sur un chemin critique saisi directement dans un script `-c`, comme `~`, définissez [`CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT=1`](/docs/fr/env-vars#variables) dans l'environnement qui lance Claude Code.

747 

746<h3 id="rewrite-a-flagged-command">748<h3 id="rewrite-a-flagged-command">

747 Réécrire une commande signalée749 Réécrire une commande signalée

748</h3>750</h3>

Details

336| `version` | string | Pour une installation de marketplace, la [version que Claude Code a calculée](/docs/fr/plugins/loading#versions-and-updates) à l'installation. Pour un plugin de session seulement, du répertoire de skills, ou synchronisé, la `version` du manifeste, ou `unknown` quand il n'en déclare aucune |336| `version` | string | Pour une installation de marketplace, la [version que Claude Code a calculée](/docs/fr/plugins/loading#versions-and-updates) à l'installation. Pour un plugin de session seulement, du répertoire de skills, ou synchronisé, la `version` du manifeste, ou `unknown` quand il n'en déclare aucune |

337| `scope` | string | `user`, `project`, `local`, ou `managed` pour les installations ; `user` ou `project` pour les plugins du répertoire de skills ; `session` pour les plugins de session seulement ; `synced` pour les plugins synchronisés depuis claude.ai |337| `scope` | string | `user`, `project`, `local`, ou `managed` pour les installations ; `user` ou `project` pour les plugins du répertoire de skills ; `session` pour les plugins de session seulement ; `synced` pour les plugins synchronisés depuis claude.ai |

338| `enabled` | boolean | Si le plugin est activé dans vos paramètres fusionnés |338| `enabled` | boolean | Si le plugin est activé dans vos paramètres fusionnés |

339| `installPath` | string | Répertoire d'où le plugin se charge |339| `installPath` | string | Répertoire d'où le plugin se charge, sauf pour un plugin que les sessions [chargent sur place](/docs/fr/plugins/loading#in-place-and-copied-plugins) depuis le dossier de sa marketplace |

340| `readFromFolder` | string | Pour un plugin que les sessions [chargent sur place](/docs/fr/plugins/loading#in-place-and-copied-plugins) depuis le dossier de sa marketplace, le répertoire source du plugin dans ce dossier. Nécessite Claude Code v2.1.289 ou ultérieur |

341| `folderVersion` | string | Avec `readFromFolder`, la `version` du plugin telle que Claude Code l'a chargée depuis ce dossier, qui peut différer du champ `version` ci-dessus. Absent quand le plugin ne s'est pas chargé ou ne déclare aucune version. Nécessite Claude Code v2.1.289 ou ultérieur |

340| `installedAt` | string | Timestamp ISO de l'installation. Installations de marketplace seulement |342| `installedAt` | string | Timestamp ISO de l'installation. Installations de marketplace seulement |

341| `lastUpdated` | string | Timestamp ISO de la dernière mise à jour. Installations de marketplace seulement |343| `lastUpdated` | string | Timestamp ISO de la dernière mise à jour. Installations de marketplace seulement |

342| `projectPath` | string | Projet auquel l'installation appartient. Portée `project` et `local` seulement |344| `projectPath` | string | Projet auquel l'installation appartient. Portée `project` et `local` seulement |


637 * Un répertoire nommé `.claude` : les répertoires `skills`, `agents`, et `commands` à l'intérieur639 * Un répertoire nommé `.claude` : les répertoires `skills`, `agents`, et `commands` à l'intérieur

638 * N'importe quel autre répertoire : ces trois répertoires sous son `.claude`640 * N'importe quel autre répertoire : ces trois répertoires sous son `.claude`

639 641 

642Quand le répertoire contient à la fois un `.claude-plugin/marketplace.json` et un `.claude-plugin/plugin.json`, Claude Code valide la marketplace ainsi que le manifeste et les fichiers de composant du plugin. Cela nécessite Claude Code v2.1.289 ou ultérieur.

643 

640Claude Code ne suit pas les liens symboliques à l'intérieur du répertoire que vous nommez. Ce qu'il fait dépend de l'endroit où le lien est :644Claude Code ne suit pas les liens symboliques à l'intérieur du répertoire que vous nommez. Ce qu'il fait dépend de l'endroit où le lien est :

641 645 

642* **Un répertoire `skills`, `agents`, ou `commands` lié sous la racine du plugin ou `.claude`** : Claude Code avertit que rien dedans n'a été lu.646* **Un répertoire `skills`, `agents`, ou `commands` lié sous la racine du plugin ou `.claude`** : Claude Code avertit que rien dedans n'a été lu.


647 651 

648* **Un `SKILL.md` à la racine du plugin** : quand vous exécutez `claude plugin validate` contre un répertoire de plugin, Claude Code ne vérifie pas un `SKILL.md` à la racine du plugin652* **Un `SKILL.md` à la racine du plugin** : quand vous exécutez `claude plugin validate` contre un répertoire de plugin, Claude Code ne vérifie pas un `SKILL.md` à la racine du plugin

649* **Un `CLAUDE.md` à la racine du plugin** : dans une exécution de plugin, Claude Code avertit aussi d'un `CLAUDE.md` à la racine du plugin653* **Un `CLAUDE.md` à la racine du plugin** : dans une exécution de plugin, Claude Code avertit aussi d'un `CLAUDE.md` à la racine du plugin

650* **Fichiers de plugin dans une exécution de marketplace** : depuis un répertoire de marketplace, Claude Code n'ouvre pas les fichiers de skill, agent, commande ou hook des plugins. Pour trouver des erreurs dans ces fichiers, validez chaque répertoire de plugin654* **Fichiers de plugin dans une exécution de marketplace** : depuis un répertoire de marketplace, Claude Code n'ouvre pas les fichiers de skill, agent, commande ou hook des plugins que la marketplace liste dans d'autres répertoires, ni les fichiers de serveur MCP qu'ils embarquent. Pour trouver des erreurs dans ces fichiers, validez chaque répertoire de plugin

651 655 

652<h4 id="output-and-exit-codes">656<h4 id="output-and-exit-codes">

653 Sortie et codes de sortie657 Sortie et codes de sortie

Details

100 Greet the user warmly and ask how you can help them today.100 Greet the user warmly and ask how you can help them today.

101 ```101 ```

102 102 

103 La ligne `disable-model-invocation: true` signifie que Claude n'exécute pas le skill de lui-même, donc seul vous le déclenchez. Supprimez cette ligne d'un skill que vous voulez que Claude exécute de lui-même. La commande du skill combine le nom du plugin et le nom du skill, donc vous exécutez celui-ci comme `/my-first-plugin:hello`. Pour les autres champs du frontmatter, voir la [référence du frontmatter du skill](/docs/fr/skills#frontmatter-reference).103 La ligne `disable-model-invocation: true` signifie que Claude n'exécute pas le skill de lui-même. Supprimez cette ligne d'un skill que vous voulez que Claude exécute de lui-même. La commande du skill combine le nom du plugin et le nom du skill, donc vous exécutez celui-ci comme `/my-first-plugin:hello`. Pour les autres champs du frontmatter, voir la [référence du frontmatter du skill](/docs/fr/skills#frontmatter-reference).

104 </Step>104 </Step>

105 105 

106 <Step title="Valider le plugin">106 <Step title="Valider le plugin">

Details

215 215 

216Pour publier une nouvelle version aux utilisateurs, modifiez le `version` du plugin. Les utilisateurs obtiennent une nouvelle copie uniquement quand la version calculée du plugin diffère de celle qu'ils ont. Cette version provient de `plugin.json` d'abord, puis de l'entrée de marketplace, selon [Versions et mises à jour](/docs/fr/plugins/loading#versions-and-updates).216Pour publier une nouvelle version aux utilisateurs, modifiez le `version` du plugin. Les utilisateurs obtiennent une nouvelle copie uniquement quand la version calculée du plugin diffère de celle qu'ils ont. Cette version provient de `plugin.json` d'abord, puis de l'entrée de marketplace, selon [Versions et mises à jour](/docs/fr/plugins/loading#versions-and-updates).

217 217 

218Un plugin que les utilisateurs [chargent sur place](/docs/fr/plugins/loading#find-plugins-on-disk) à partir d'une marketplace qu'ils ont ajoutée en tant que répertoire local n'est pas contrôlé par `version`. Il charge vos fichiers actuels à chaque démarrage de session, peu importe ce que sa chaîne de version dit.218Un plugin que les utilisateurs [chargent sur place](/docs/fr/plugins/loading#find-plugins-on-disk) à partir d'une marketplace qu'ils ont ajoutée depuis un chemin local n'est pas contrôlé par `version`. Il charge vos fichiers actuels à chaque démarrage de session, peu importe ce que sa chaîne de version dit.

219 219 

220Pour chaque installation autre qu'un chargement sur place ou un à partir d'une source `command`, soit augmentez `version` à chaque version, soit omettez-la :220Pour chaque installation autre qu'un chargement sur place ou un à partir d'une source `command`, soit augmentez `version` à chaque version, soit omettez-la :

221 221 

Details

208Claude Code charge certains plugins en place d'où vous les gardez et copie le reste dans le cache, selon leur origine :208Claude Code charge certains plugins en place d'où vous les gardez et copie le reste dans le cache, selon leur origine :

209 209 

210* **Plugins `--plugin-dir` et de répertoire de compétences** : le répertoire se charge en place et n'est jamais copié. Une archive `--plugin-url` ou un `.zip` `--plugin-dir` est d'abord extrait dans un répertoire temporaire de session210* **Plugins `--plugin-dir` et de répertoire de compétences** : le répertoire se charge en place et n'est jamais copié. Une archive `--plugin-url` ou un `.zip` `--plugin-dir` est d'abord extrait dans un répertoire temporaire de session

211* **Plugins de chemin relatif dans un marché que vous avez ajouté à partir d'un répertoire local** : le plugin se charge en place à partir de son chemin à l'intérieur du dossier du marché. Vos modifications du répertoire source prennent effet au prochain démarrage de session ou `/reload-plugins`, et vous n'avez pas besoin d'augmenter la version. Les processus de hook du plugin et les serveurs MCP et LSP reçoivent un `CLAUDE_PLUGIN_ROOT` qui pointe vers le répertoire source. Pour ses dépendances de package Node.js, voir [Quand l'installation de dépendance s'exécute](#when-the-dependency-install-runs)211* **Plugins de chemin relatif dans une marketplace que vous avez ajoutée à partir d'un chemin local** : le plugin se charge en place à partir de son chemin à l'intérieur du dossier de la marketplace. Vos modifications du répertoire source prennent effet au prochain démarrage de session ou `/reload-plugins`, et vous n'avez pas besoin d'augmenter la version. Les processus de hook du plugin et les serveurs MCP et LSP reçoivent un `CLAUDE_PLUGIN_ROOT` qui pointe vers le répertoire source. Pour ses dépendances de package Node.js, voir [Quand l'installation de dépendance s'exécute](#when-the-dependency-install-runs)

212* **Plugins de source `command` en [mode lien](/docs/fr/plugins/marketplace-reference#command-plugin-source)** : le répertoire que la commande a imprimé se charge en place, via des liens dans l'entrée de cache212* **Plugins de source `command` en [mode lien](/docs/fr/plugins/marketplace-reference#command-plugin-source)** : le répertoire que la commande a imprimé se charge en place, via des liens dans l'entrée de cache

213* **Tous les autres plugins de marché** : Claude Code copie le plugin dans `cache/<marketplace>/<plugin>/<version>/` à l'installation et charge cette copie. Les fichiers en dehors du répertoire du plugin ne sont pas copiés, donc quand un script à l'intérieur d'un plugin copié lit un chemin au-dessus de la racine du plugin, comme `../shared`, il ne les trouve pas213* **Tous les autres plugins de marché** : Claude Code copie le plugin dans `cache/<marketplace>/<plugin>/<version>/` à l'installation et charge cette copie. Les fichiers en dehors du répertoire du plugin ne sont pas copiés, donc quand un script à l'intérieur d'un plugin copié lit un chemin au-dessus de la racine du plugin, comme `../shared`, il ne les trouve pas

214 214 


250* Quand Claude Code met à jour un plugin vers une nouvelle version250* Quand Claude Code met à jour un plugin vers une nouvelle version

251* Au démarrage de la session quand un plugin activé n'est pas en cache, comme sur une nouvelle machine251* Au démarrage de la session quand un plugin activé n'est pas en cache, comme sur une nouvelle machine

252 252 

253Pour un plugin de chemin relatif [chargé en place](#in-place-and-copied-plugins) à partir d'un marché de répertoire local, Claude Code n'installe pas les dépendances dans le répertoire source. Installez-les là vous-même, ou à partir d'un hook dans [`${CLAUDE_PLUGIN_DATA}`](/docs/fr/plugins/components#path-variables-and-persistent-data).253Pour un plugin de chemin relatif [chargé en place](#in-place-and-copied-plugins) à partir d'une marketplace que vous avez ajoutée à partir d'un chemin local, Claude Code n'installe pas les dépendances dans le répertoire source. Installez-les là vous-même, ou à partir d'un hook dans [`${CLAUDE_PLUGIN_DATA}`](/docs/fr/plugins/components#path-variables-and-persistent-data).

254 254 

255L'installation s'exécute uniquement quand le répertoire racine du plugin contient à la fois un `package.json` et un fichier de verrouillage pris en charge.255L'installation s'exécute uniquement quand le répertoire racine du plugin contient à la fois un `package.json` et un fichier de verrouillage pris en charge.

256 256 


315 315 

316Un manifeste qui épingle `"version"` est une façon que la version calculée reste la même à travers les commits. Voir [Comment Claude Code calcule la version](#how-claude-code-computes-the-version) pour l'ordre de résolution.316Un manifeste qui épingle `"version"` est une façon que la version calculée reste la même à travers les commits. Voir [Comment Claude Code calcule la version](#how-claude-code-computes-the-version) pour l'ordre de résolution.

317 317 

318Un plugin [chargé en place](#in-place-and-copied-plugins) à partir d'un marché de répertoire local charge ses fichiers source actuels à chaque démarrage de session, quoi que sa chaîne de version dise. Pour un plugin à partir d'un [marché hébergé sur claude.ai](/docs/fr/plugins/install#add-from-claude-ai), la version que claude.ai enregistre pour le plugin est sa version, et le `version` du manifeste n'est pas lu.318Un plugin [chargé en place](#in-place-and-copied-plugins) depuis une marketplace que vous avez ajoutée à partir d'un chemin local charge ses fichiers source actuels à chaque démarrage de session, quoi que sa chaîne de version indique. Pour un plugin provenant d'une [marketplace hébergée sur claude.ai](/docs/fr/plugins/install#add-from-claude-ai), la version que claude.ai enregistre pour le plugin est sa version, et le `version` du manifeste n'est pas lu.

319 319 

320<h3 id="how-claude-code-computes-the-version">320<h3 id="how-claude-code-computes-the-version">

321 Comment Claude Code calcule la version321 Comment Claude Code calcule la version

Details

199 `version`199 `version`

200</h3>200</h3>

201 201 

202Une chaîne de version, non vérifiée par rapport à semver. La définir épingle le plugin à cette version jusqu'à ce que vous la changiez ; voir [Versions et mises à jour](/docs/fr/plugins/loading#versions-and-updates). Un plugin avec une [`command` source](/docs/fr/plugins/marketplace-reference), un plugin d'un [marketplace hébergé sur claude.ai](/docs/fr/plugins/install#add-from-claude-ai), et un plugin [chargé sur place](/docs/fr/plugins/loading#find-plugins-on-disk) à partir d'un marketplace ajouté en tant que répertoire local ne sont pas épinglés par ce champ.202Une chaîne de version, non vérifiée par rapport à semver. La définir épingle le plugin à cette version jusqu'à ce que vous la changiez ; voir [Versions et mises à jour](/docs/fr/plugins/loading#versions-and-updates). Un plugin avec une [`command` source](/docs/fr/plugins/marketplace-reference), un plugin d'une [marketplace hébergée sur claude.ai](/docs/fr/plugins/install#add-from-claude-ai), et un plugin [chargé sur place](/docs/fr/plugins/loading#find-plugins-on-disk) à partir d'une marketplace ajoutée depuis un chemin local ne sont pas épinglés par ce champ.

203 203 

204<h3 id="metadata">204<h3 id="metadata">

205 `metadata`205 `metadata`

Details

434| `Link`, `Code`, `Markdown` | Un lien avec `href` et une `label` optionnelle, un bloc de code, et du texte formaté comme les réponses de Claude. `Markdown` prend son contenu dans une prop `text`, pas dans `children`, et a besoin d'une `key` quand vous passez `onLinkPress`. | Partout |434| `Link`, `Code`, `Markdown` | Un lien avec `href` et une `label` optionnelle, un bloc de code, et du texte formaté comme les réponses de Claude. `Markdown` prend son contenu dans une prop `text`, pas dans `children`, et a besoin d'une `key` quand vous passez `onLinkPress`. | Partout |

435| `Input`, `Select` | Un champ de texte et un sélecteur | Terminal, Desktop |435| `Input`, `Select` | Un champ de texte et un sélecteur | Terminal, Desktop |

436| `Svg` | Un document SVG | Desktop |436| `Svg` | Un document SVG | Desktop |

437| `Client` | Une région dessinée par un deuxième fichier du vôtre, pour l'animation et l'entrée au pointeur. Ce fichier n'obtient pas l'API des mods. Il atteint vos hooks seulement en postant des données, qui arrivent comme un événement `ui.message`. | Terminal, Desktop |437| `Client` | Une région dessinée par un deuxième fichier du vôtre, pour l'animation et l'entrée au pointeur. Ce fichier n'obtient pas l'API des mods. Il atteint vos hooks en postant des données, qui arrivent comme un événement `ui.message`. S'il ne parvient pas à se charger, à dessiner ou à s'exécuter, vos hooks reçoivent un événement [`ui.fault`](/docs/fr/plugins/mods/reference#interface). | Terminal, Desktop |

438| `Raster`, `Image` | Une [grille de cellules colorées](#draw-a-grid-of-colored-cells), et une image | Terminal |438| `Raster`, `Image` | Une [grille de cellules colorées](#draw-a-grid-of-colored-cells), et une image | Terminal |

439 439 

440Si votre module est un fichier `.tsx` ou `.jsx`, vous pouvez écrire l'arbre en JSX. Déstructurez les éléments de `$.ui.resolve(e)` d'abord.440Si votre module est un fichier `.tsx` ou `.jsx`, vous pouvez écrire l'arbre en JSX. Déstructurez les éléments de `$.ui.resolve(e)` d'abord.


664 Quand Claude Code redessine sans être demandé664 Quand Claude Code redessine sans être demandé

665</h3>665</h3>

666 666 

667Claude Code exécute votre hook `ui.render` à nouveau quand les props du site changent ou la largeur du terminal change. Il n'exécute pas le hook sur une minuterie, et il ne peut pas dire quand une variable dans votre module change.667Claude Code exécute votre hook `ui.render` à nouveau quand les props du site changent ou la largeur du terminal change. Quand un `Client` du site échoue et que votre mod gère [`ui.fault`](/docs/fr/plugins/mods/reference#interface), Claude Code exécute le hook une fois de plus après le retour de vos hooks `ui.fault`, afin que votre hook `ui.render` puisse omettre le `Client`. Il n'exécute pas le hook sur une minuterie, et il ne peut pas dire quand une variable dans votre module change.

668 668 

669<h3 id="redraw-when-your-data-changes">669<h3 id="redraw-when-your-data-changes">

670 Redessiner quand vos données changent670 Redessiner quand vos données changent

Details

6 6 

7> Référence complète des mods Claude Code : structure du module de hooks, événements, méthodes de l'API des mods, points de rendu, éléments par surface, limites et paramètres.7> Référence complète des mods Claude Code : structure du module de hooks, événements, méthodes de l'API des mods, points de rendu, éléments par surface, limites et paramètres.

8 8 

9Consultez tout événement qu'un [mod](/docs/fr/plugins/mods/overview) peut gérer, toute méthode de l'API des mods qu'il peut appeler, ou tout point de rendu dans lequel il peut dessiner, pour la CLI Claude Code et l'application Desktop à partir de la v2.1.287. Chaque entrée donne le nom et une description d'une ligne, avec un lien vers la section du guide qui l'explique lorsqu'elle existe.9Consultez tout événement qu'un [mod](/docs/fr/plugins/mods/overview) peut gérer, toute méthode de l'API des mods qu'il peut appeler, ou tout point de rendu dans lequel il peut dessiner, pour la CLI Claude Code et l'application Desktop à partir de la v2.1.289. Chaque entrée donne le nom et une description d'une ligne, avec un lien vers la section du guide qui l'explique lorsqu'elle existe.

10 10 

11<Note>11<Note>

12 La référence complète est constituée des [déclarations TypeScript pour les mods](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts) de Claude Code, qui décrivent chaque événement, méthode et élément, avec des exemples. La copie sur GitHub peut être plus ancienne que la version de Claude Code que vous avez installée. En cas de divergence, fiez-vous à [la copie que Claude Code écrit pour votre version](/docs/fr/plugins/mods/create#get-the-types-for-your-build).12 La référence complète est constituée des [déclarations TypeScript pour les mods](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts) de Claude Code, qui décrivent chaque événement, méthode et élément, avec des exemples. La copie sur GitHub peut être plus ancienne que la version de Claude Code que vous avez installée. En cas de divergence, fiez-vous à [la copie que Claude Code écrit pour votre version](/docs/fr/plugins/mods/create#get-the-types-for-your-build).


128 Sous-agents128 Sous-agents

129</h3>129</h3>

130 130 

131Les événements de sous-agent se déclenchent lorsqu'un type de sous-agent est proposé à Claude et lorsqu'un sous-agent est sur le point de démarrer :131Les événements de sous-agent se déclenchent lorsqu'un type de sous-agent est proposé à Claude et lorsqu'un sous-agent ou un coéquipier d'une équipe d'agents est sur le point de démarrer :

132 132 

133| Événement | Se déclenche lorsque | Un hook peut renvoyer |133| Événement | Se déclenche lorsque | Un hook peut renvoyer |

134| :- | :- | :- |134| :- | :- | :- |

135| `agent.offer` | Un type de sous-agent est proposé à Claude | `{ isOffered: false }` pour le retenir |135| `agent.offer` | Un type de sous-agent est proposé à Claude | `{ isOffered: false }` pour le retenir |

136| `agent.spawn` | Un sous-agent est sur le point de démarrer | `{ model }` ou `{ deny: reason }` |136| `agent.spawn` | Un sous-agent ou un coéquipier d'une [équipe d'agents](/docs/fr/agent-teams) est sur le point de démarrer. Pour un coéquipier, `e.isTeammate` vaut `true`. | `next({ ...e, model })` pour choisir son modèle, ou `{ deny: reason }` |

137 137 

138<h3 id="interface">138<h3 id="interface">

139 Interface139 Interface


149| `ui.focus`, `ui.scroll` | Le contrôle ayant le focus ou la position de défilement d'un volet ou du bandeau est sur le point de changer |149| `ui.focus`, `ui.scroll` | Le contrôle ayant le focus ou la position de défilement d'un volet ou du bandeau est sur le point de changer |

150| `ui.close` | Un volet est sur le point de se fermer. `e.id` est le volet et `e.origin.kind` vaut `plugin`, `person` ou `unload`. |150| `ui.close` | Un volet est sur le point de se fermer. `e.id` est le volet et `e.origin.kind` vaut `plugin`, `person` ou `unload`. |

151| [`ui.message`](/docs/fr/plugins/mods/interface#build-a-tree-from-elements) | Un élément `Client` envoie des données à son mod |151| [`ui.message`](/docs/fr/plugins/mods/interface#build-a-tree-from-elements) | Un élément `Client` envoie des données à son mod |

152| [`ui.fault`](/docs/fr/plugins/mods/interface#redraw-when-something-changes) | Un élément `Client` dessiné par votre mod n'a pas pu se charger, se dessiner ou s'exécuter. `e.phase` vaut `load`, `render` ou `run`, et `e.reason` est le message d'erreur. Nécessite Claude Code v2.1.289 ou une version ultérieure. |

152 153 

153<h3 id="other-mods">154<h3 id="other-mods">

154 Autres mods155 Autres mods


192| Namespace | Méthodes |193| Namespace | Méthodes |

193| :- | :- |194| :- | :- |

194| `$.plugin` | `name`, `root` : le nom et le répertoire de ce plugin |195| `$.plugin` | `name`, `root` : le nom et le répertoire de ce plugin |

195| [`$.ui`](/docs/fr/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `status`, `log`, `notice`, `ask`, `copy`, `blit` |196| [`$.ui`](/docs/fr/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit` |

196| [`$.command`](/docs/fr/plugins/mods/api#add-a-command) | `register`, `run`, `list` |197| [`$.command`](/docs/fr/plugins/mods/api#add-a-command) | `register`, `run`, `list` |

197| [`$.tool`](/docs/fr/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |198| [`$.tool`](/docs/fr/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |

198| `$.agent` | `register`, `spawn`, `list` |199| `$.agent` | `register`, `spawn`, `list` |


276 277 

277| Limite | Valeur |278| Limite | Valeur |

278| :- | :- |279| :- | :- |

279| Le temps d'exécution propre d'un hook pour un événement, sans compter le temps passé dans `next` ou dans un appel à l'API des mods autre que `$.clock.sleep` | 10 secondes |280| Le temps d'exécution propre d'un hook pour un événement, sans compter le temps passé dans `next` ou dans un appel à l'API des mods autre que `$.clock.sleep` | 10 secondes, ou 50 millisecondes pour un hook `prompt.edit` |

280| Le temps d'exécution d'un gestionnaire `.catch` | 1 seconde |281| Le temps d'exécution d'un gestionnaire `.catch` | 1 seconde |

281| L'ensemble des hooks `session.end` | 1,5 seconde |282| L'ensemble des hooks `session.end` | Aussi longtemps que le [budget du hook SessionEnd](/docs/fr/hooks#sessionend-input), soit 1,5 seconde sauf si vous le modifiez, compté à partir du moment où les hooks `SessionEnd` de vos paramètres se terminent |

282| Délai d'expiration de `$.process.run` | 30 secondes par défaut, 10 minutes au maximum |283| Délai d'expiration de `$.process.run` | 30 secondes par défaut, 10 minutes au maximum |

283| `maxTokens` de `$.model.complete` | 1024 par défaut, jusqu'à 64 000 ou la limite de sortie du modèle |284| `maxTokens` de `$.model.complete` | 1024 par défaut, jusqu'à 64 000 ou la limite de sortie du modèle |

284| `$.fs.read` et `$.fs.write` | 4 Mio pour un fichier |285| `$.fs.read` et `$.fs.write` | 4 Mio pour un fichier |

Details

1016 1016 

1017Vérifiez ces causes dans l'ordre :1017Vérifiez ces causes dans l'ordre :

1018 1018 

1019* **Le skill définit `disable-model-invocation: true`** : avec ce champ défini, seul vous pouvez invoquer le skill. Le modèle de skill dans [Créez votre premier plugin](/docs/fr/plugins/create#create-your-first-plugin) le définit. Supprimez la ligne d'un skill que vous voulez que Claude invoque de lui-même. [Contrôlez qui invoque un skill](/docs/fr/skills#control-who-invokes-a-skill) couvre le champ1019* **Le skill définit `disable-model-invocation: true`** : le modèle de skill dans [Créez votre premier plugin](/docs/fr/plugins/create#create-your-first-plugin) le définit. Supprimez la ligne d'un skill que vous voulez que Claude invoque de lui-même. [Contrôlez qui invoque un skill](/docs/fr/skills#control-who-invokes-a-skill) couvre le champ

1020* **La description ne correspond pas à la façon dont les gens demandent** : travaillez à travers les vérifications dans [Le skill ne se déclenche pas](/docs/fr/skills#skill-not-triggering)1020* **La description ne correspond pas à la façon dont les gens demandent** : travaillez à travers les vérifications dans [Le skill ne se déclenche pas](/docs/fr/skills#skill-not-triggering)

1021* **La description est tronquée** : lorsque de nombreux skills sont installés, Claude Code raccourcit les descriptions pour s'adapter au budget de caractères de la liste, ce qui peut supprimer les mots-clés dont Claude a besoin pour correspondre à une demande. Consultez [Les descriptions de skill sont coupées court](/docs/fr/skills#skill-descriptions-are-cut-short)1021* **La description est tronquée** : lorsque de nombreux skills sont installés, Claude Code raccourcit les descriptions pour s'adapter au budget de caractères de la liste, ce qui peut supprimer les mots-clés dont Claude a besoin pour correspondre à une demande. Consultez [Les descriptions de skill sont coupées court](/docs/fr/skills#skill-descriptions-are-cut-short)

1022 1022 

sandboxing.md +1 −1

Details

463 463 

464Le masquage nécessite les éléments suivants :464Le masquage nécessite les éléments suivants :

465 465 

466* **La terminaison TLS** : le proxy substitue la valeur réelle dans le contenu des requêtes, il doit donc pouvoir le voir. Définissez [`network.tlsTerminate`](/docs/fr/settings-reference#sandbox-network-tlsterminate) pour que le proxy termine lui-même le TLS. Sans cela, le masquage échoue sans rien exposer : la commande ne voit toujours que la sentinelle, mais celle-ci atteint le serveur sans modification et l'authentification échoue. Claude Code signale cette erreur de configuration au démarrage.466* **La terminaison TLS** : le proxy substitue la valeur réelle dans le contenu des requêtes, il doit donc pouvoir le voir. Définissez [`network.tlsTerminate`](/docs/fr/settings-reference#sandbox-network-tlsterminate) pour que le proxy termine lui-même le TLS. Sans cela, le masquage échoue sans rien exposer : la commande ne voit toujours que la sentinelle, mais celle-ci atteint le serveur sans modification et l'authentification échoue. Pour détecter cette erreur de configuration, exécutez `claude doctor` dans votre terminal et recherchez l'avertissement `TLS termination is unavailable`.

467* **Une destination autorisée** : chaque entrée `mask` peut lister des `injectHosts`, les hôtes que la valeur réelle est autorisée à atteindre. Le proxy n'injecte que sur les connexions admises par la [liste d'autorisation de domaines](#network-isolation), de sorte que chaque hôte `injectHosts` doit également être accessible via `network.allowedDomains`. Pour une entrée `mask` sans `injectHosts`, le proxy substitue la valeur réelle dans les requêtes vers tous les hôtes de `network.allowedDomains`.467* **Une destination autorisée** : chaque entrée `mask` peut lister des `injectHosts`, les hôtes que la valeur réelle est autorisée à atteindre. Le proxy n'injecte que sur les connexions admises par la [liste d'autorisation de domaines](#network-isolation), de sorte que chaque hôte `injectHosts` doit également être accessible via `network.allowedDomains`. Pour une entrée `mask` sans `injectHosts`, le proxy substitue la valeur réelle dans les requêtes vers tous les hôtes de `network.allowedDomains`.

468* **Une portée de paramètres de confiance** : le masquage autorise le proxy à envoyer votre identifiant réel quelque part ; Claude Code ne prend donc en compte les entrées `mask`, `network.tlsTerminate`, [`credentials.allowPlaintextInject`](/docs/fr/settings-reference#sandbox-credentials-allowplaintextinject), `awsPairs` et `sigv4` qu'à partir des paramètres utilisateur, des paramètres gérés et du flag `--settings`. Il les ignore dans le fichier `.claude/settings.json` ou `.claude/settings.local.json` d'un dépôt. Lorsque votre administrateur fournit des entrées `mask`, `network.tlsTerminate` ou `credentials.allowPlaintextInject` via des paramètres gérés par le serveur, ceux-ci comptent parmi les [paramètres nécessitant une approbation](/docs/fr/server-managed-settings#security-approval-dialogs).468* **Une portée de paramètres de confiance** : le masquage autorise le proxy à envoyer votre identifiant réel quelque part ; Claude Code ne prend donc en compte les entrées `mask`, `network.tlsTerminate`, [`credentials.allowPlaintextInject`](/docs/fr/settings-reference#sandbox-credentials-allowplaintextinject), `awsPairs` et `sigv4` qu'à partir des paramètres utilisateur, des paramètres gérés et du flag `--settings`. Il les ignore dans le fichier `.claude/settings.json` ou `.claude/settings.local.json` d'un dépôt. Lorsque votre administrateur fournit des entrées `mask`, `network.tlsTerminate` ou `credentials.allowPlaintextInject` via des paramètres gérés par le serveur, ceux-ci comptent parmi les [paramètres nécessitant une approbation](/docs/fr/server-managed-settings#security-approval-dialogs).

469 469 

Details

195 195 

196Le runner signale également l'adhésion à Anthropic quand il s'enregistre, affichant `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` au démarrage. Signaler l'adhésion nécessite Claude Code v2.1.267 ou plus récent, et les versions antérieures acceptent le drapeau sans le signaler ou afficher cette ligne. Chaque session sur un runner ayant adhéré utilise ensuite soit git géré par Anthropic, soit l'URL du proxy par session. Quand une session utilise l'URL du proxy par session, le runner enregistre une ligne `[runner:warn]` indiquant cela.196Le runner signale également l'adhésion à Anthropic quand il s'enregistre, affichant `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` au démarrage. Signaler l'adhésion nécessite Claude Code v2.1.267 ou plus récent, et les versions antérieures acceptent le drapeau sans le signaler ou afficher cette ligne. Chaque session sur un runner ayant adhéré utilise ensuite soit git géré par Anthropic, soit l'URL du proxy par session. Quand une session utilise l'URL du proxy par session, le runner enregistre une ligne `[runner:warn]` indiquant cela.

197 197 

198<h4 id="github-api-access-without-the-github-cli">

199 Accès à l'API GitHub sans la GitHub CLI

200</h4>

201 

202Si l'image de votre runner n'inclut pas la GitHub CLI, Claude Code peut fournir un `gh` intégré, afin que Claude puisse toujours ouvrir des pull requests, commenter et lire les résultats de CI. Le `gh` intégré est destiné aux runners qui utilisent git géré par Anthropic. Il prend en charge une seule commande, `gh api`, qui appelle l'API REST de GitHub. Nécessite Claude Code v2.1.287 ou plus récent dans l'image du runner.

203 

204Cette commande ouvre une pull request à la place de `gh pr create`. Le `gh` intégré renseigne `{owner}` et `{repo}` pour le dépôt actuel :

205 

206```bash theme={null}

207gh api repos/{owner}/{repo}/pulls -f title='Fix' -f head='my-branch' -f base='main'

208```

209 

210* **Identifiants** : le `gh` intégré envoie ses requêtes REST via git géré par Anthropic, qui fournit l'identifiant GitHub du côté d'Anthropic, donc l'image n'a besoin d'aucun jeton GitHub pour celui-ci

211* **Quelles sessions en bénéficient** : Anthropic décide pour chaque session si git géré par Anthropic sert le `gh` de la session. Lorsque c'est le cas, la ligne `[runner:session] governed git ACTIVE` que le runner journalise pour la session affiche `gh_path_shim=true`. Sinon, la session n'a pas de `gh`

212* **`jq`** : installez `jq` dans l'image si vous voulez que `--jq` fonctionne

213* **[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/fr/env-vars)** : si l'environnement de la session la définit, Claude Code ne fournit pas le `gh` intégré, et la session n'a pas de `gh`

214 

215Lorsque l'image inclut la GitHub CLI, les sessions l'utilisent.

216 

198<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">217<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">

199 Faire confiance à une autorité de certification privée avec git géré par Anthropic218 Faire confiance à une autorité de certification privée avec git géré par Anthropic

200</h4>219</h4>

Details

117claude -p "your message" --cloud <session-id>117claude -p "your message" --cloud <session-id>

118```118```

119 119 

120Pour `<session-id>`, passez l'ID nu `session_...` ou `cse_...` ou l'URL claude.ai/code de la session. Un envoi réussi imprime `Sent to cloud session.` avec l'ID de session et un lien de visualisation. Les formes d'ID acceptées, la sortie JSON, les exigences de compte et de politique, et la référence d'erreur sont sur [Envoyer des suivis à partir de la CLI](/docs/fr/claude-code-on-the-web#send-follow-ups-from-the-cli), car la commande fonctionne de la même manière contre les sessions hébergées par Anthropic.120Pour `<session-id>`, passez l'ID nu `session_...` ou `cse_...` ou l'URL claude.ai/code de la session. Un envoi réussi imprime `Sent to cloud session.` avec l'ID de session et un lien de visualisation. Les formes d'ID acceptées, la sortie JSON, ainsi que les exigences de compte et de politique sont sur [Envoyer des suivis à partir de la CLI](/docs/fr/claude-code-on-the-web#send-follow-ups-from-the-cli), car la commande fonctionne de la même manière contre les sessions hébergées par Anthropic.

121 121 

122<h2 id="what’s-next">122<h2 id="what’s-next">

123 Étapes suivantes123 Étapes suivantes

Details

6 6 

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

8 8 

9Les paramètres gérés par le serveur permettent aux propriétaires d'organisation de configurer centralement Claude Code à partir de [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) dans la console claude.ai. Les clients Claude Code récupèrent automatiquement ces paramètres lorsque les utilisateurs s'authentifient avec une connexion éligible sur une plateforme où la livraison gérée par le serveur est prise en charge. Voir [Disponibilité des plateformes](#platform-availability) pour les connexions et les plateformes qui se qualifient.9Les paramètres gérés par le serveur permettent aux propriétaires d'organisation de configurer centralement Claude Code à partir de [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) dans la console claude.ai. Les clients Claude Code récupèrent automatiquement ces paramètres lorsque les utilisateurs s'authentifient avec des identifiants éligibles sur une plateforme où la livraison gérée par le serveur est prise en charge. Voir [Disponibilité des plateformes](#platform-availability) pour les identifiants et les plateformes qui se qualifient.

10 10 

11<Note>11<Note>

12 Les paramètres gérés par le serveur sont disponibles pour les clients [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_teams#team-&-enterprise) et [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_enterprise).12 Les paramètres gérés par le serveur sont disponibles pour les clients [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_teams#team-&-enterprise) et [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_enterprise).


41 41 

42<Steps>42<Steps>

43 <Step title="Ouvrir la console d'administration">43 <Step title="Ouvrir la console d'administration">

44 Dans la console claude.ai, accédez à [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code).44 Dans la console claude.ai, accédez à [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code).

45 45 

46 Si le lien vous redirige vers une page Admin Settings différente au lieu de la page Claude Code, votre compte n'a pas le rôle requis. Les rôles Admin et autres rôles non-Propriétaire ne peuvent pas afficher ou modifier les paramètres gérés, donc demandez à un Propriétaire ou Propriétaire principal de votre organisation de faire la modification. Consultez [Contrôle d'accès](#access-control).46 Si le lien vous redirige vers une page Organization settings différente au lieu de la page Claude Code, votre compte n'a pas le rôle requis. Les rôles Admin et autres rôles non-Propriétaire ne peuvent pas afficher ou modifier les paramètres gérés, donc demandez à un Propriétaire ou Propriétaire principal de votre organisation de faire la modification. Consultez [Contrôle d'accès](#access-control).

47 </Step>47 </Step>

48 48 

49 <Step title="Définir vos paramètres">49 <Step title="Définir vos paramètres">

sessions.md +1 −0

Details

292| [Nommer le répertoire `<project>` vous-même](#name-the-project-directory-yourself) | [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/fr/env-vars) | Variable d'environnement |292| [Nommer le répertoire `<project>` vous-même](#name-the-project-directory-yourself) | [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/fr/env-vars) | Variable d'environnement |

293| Modifier la rétention de 30 jours | [`cleanupPeriodDays`](/docs/fr/settings-reference#cleanupperioddays) | `settings.json` |293| Modifier la rétention de 30 jours | [`cleanupPeriodDays`](/docs/fr/settings-reference#cleanupperioddays) | `settings.json` |

294| Définir une limite d'âge pour les [transcriptions Claude Desktop et Cowork](/docs/fr/claude-directory#cleaned-up-automatically) | [`desktopSessionCleanupPeriodDays`](/docs/fr/settings-reference#desktopsessioncleanupperioddays) | Paramètres utilisateur, paramètres gérés, ou `--settings` |294| Définir une limite d'âge pour les [transcriptions Claude Desktop et Cowork](/docs/fr/claude-directory#cleaned-up-automatically) | [`desktopSessionCleanupPeriodDays`](/docs/fr/settings-reference#desktopsessioncleanupperioddays) | Paramètres utilisateur, paramètres gérés, ou `--settings` |

295| Limiter la taille que peut atteindre le fichier de transcription d'une session `-p` ou Agent SDK | [`CLAUDE_CODE_TRANSCRIPT_LOCAL_GC`](/docs/fr/env-vars) | Variable d'environnement |

295| Supprimer les écritures de transcription dans tous les modes | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/fr/env-vars) | Variable d'environnement |296| Supprimer les écritures de transcription dans tous les modes | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/fr/env-vars) | Variable d'environnement |

296| Supprimer les écritures pour une exécution non interactive | [`--no-session-persistence`](/docs/fr/cli-reference) | Drapeau CLI avec `claude -p` |297| Supprimer les écritures pour une exécution non interactive | [`--no-session-persistence`](/docs/fr/cli-reference) | Drapeau CLI avec `claude -p` |

297 298 

Details

990 990 

991Quand votre organisation déploie des paramètres gérés, Claude Code lit cette clé à partir de la source gérée uniquement et l'ignore dans vos autres fichiers.991Quand votre organisation déploie des paramètres gérés, Claude Code lit cette clé à partir de la source gérée uniquement et l'ignore dans vos autres fichiers.

992 992 

993Pour savoir comment cette clé s'applique aux vérifications de modèle au démarrage, consultez [Amazon Bedrock](/docs/fr/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) et [la plateforme Agent de Google Cloud](/docs/fr/google-vertex-ai#when-your-organization-enforces-a-model-allowlist).

994 

993* **Portée** : [`Tout fichier`](#scopes)995* **Portée** : [`Tout fichier`](#scopes)

994* **Type** : Booléen996* **Type** : Booléen

995 * `true` : quand **Par défaut** se résoudrait à un modèle en dehors de `availableModels`, Claude Code le résout au premier modèle disponible de la liste997 * `true` : quand **Par défaut** se résoudrait à un modèle en dehors de `availableModels`, Claude Code le résout au premier modèle disponible de la liste


3135* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/fr/sessions#name-the-project-directory-yourself), que Claude Code lit uniquement à partir de l'environnement de lancement, est ignorée de chaque fichier ; nécessite v2.1.234 ou ultérieur.3137* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/fr/sessions#name-the-project-directory-yourself), que Claude Code lit uniquement à partir de l'environnement de lancement, est ignorée de chaque fichier ; nécessite v2.1.234 ou ultérieur.

3136* [`CLAUDE_CODE_RESTRICTED`](/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, est ignorée de chaque fichier.3138* [`CLAUDE_CODE_RESTRICTED`](/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, est ignorée de chaque fichier.

3137* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, est ignorée de chaque fichier. La variable nécessite Claude Code v2.1.283 ou ultérieur.3139* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, est ignorée de chaque fichier. La variable nécessite Claude Code v2.1.283 ou ultérieur.

3138* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` et `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`](/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, sont ignorées de chaque fichier.3140* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`, `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` et `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT`](/docs/fr/env-vars#variables), que Claude Code lit uniquement à partir de l'environnement de lancement, sont ignorées de chaque fichier.

3139 3141 

3140<h3 id="filecheckpointingenabled">3142<h3 id="filecheckpointingenabled">

3141 `fileCheckpointingEnabled`3143 `fileCheckpointingEnabled`

skills.md +16 −3

Details

561 561 

562Par défaut, vous et Claude pouvez invoquer n'importe quelle compétence. Vous pouvez taper `/skill-name` pour l'invoquer directement, et Claude peut la charger automatiquement lorsqu'elle est pertinente pour votre conversation. Deux champs frontmatter vous permettent de restreindre ceci :562Par défaut, vous et Claude pouvez invoquer n'importe quelle compétence. Vous pouvez taper `/skill-name` pour l'invoquer directement, et Claude peut la charger automatiquement lorsqu'elle est pertinente pour votre conversation. Deux champs frontmatter vous permettent de restreindre ceci :

563 563 

564* **`disable-model-invocation: true`** : Seul vous pouvez invoquer la compétence. Utilisez ceci pour les flux de travail avec des effets secondaires ou que vous souhaitez contrôler le timing, comme `/commit`, `/deploy` ou `/send-slack-message`. Vous ne voulez pas que Claude décide de déployer parce que votre code semble prêt.564* **`disable-model-invocation: true`** : Claude ne peut pas invoquer le skill de lui-même. Utilisez ceci pour les workflows avec des effets secondaires ou dont vous souhaitez contrôler le timing, comme `/commit`, `/deploy` ou `/send-slack-message`. Vous ne voulez pas que Claude décide de déployer parce que votre code semble prêt.

565 565 

566* **`user-invocable: false`** : Seul Claude peut invoquer la compétence. Utilisez ceci pour les connaissances de base qui ne sont pas actionnables en tant que commande. Une compétence `legacy-system-context` explique comment fonctionne un ancien système. Claude devrait le savoir lorsqu'il est pertinent, mais `/legacy-system-context` n'est pas une action significative pour les utilisateurs.566* **`user-invocable: false`** : Seul Claude peut invoquer la compétence. Utilisez ceci pour les connaissances de base qui ne sont pas actionnables en tant que commande. Une compétence `legacy-system-context` explique comment fonctionne un ancien système. Claude devrait le savoir lorsqu'il est pertinent, mais `/legacy-system-context` n'est pas une action significative pour les utilisateurs.

567 567 

568Cet exemple crée une compétence de déploiement que seul vous pouvez déclencher. Si vous définissez `disable-model-invocation: true`, Claude ne peut pas exécuter la compétence automatiquement :568Cet exemple crée un skill de déploiement. Si vous définissez `disable-model-invocation: true`, Claude ne peut pas exécuter le skill automatiquement :

569 569 

570```yaml theme={null}570```yaml theme={null}

571---571---


589| Frontmatter | Vous pouvez invoquer | Claude peut invoquer | Quand chargé en contexte |589| Frontmatter | Vous pouvez invoquer | Claude peut invoquer | Quand chargé en contexte |

590| :- | :- | :- | :- |590| :- | :- | :- | :- |

591| (par défaut) | Oui | Oui | Description toujours en contexte, la compétence complète se charge lorsqu'elle est invoquée |591| (par défaut) | Oui | Oui | Description toujours en contexte, la compétence complète se charge lorsqu'elle est invoquée |

592| `disable-model-invocation: true` | Oui | Non | Description pas en contexte, la compétence complète se charge lorsque vous l'invoquez |592| `disable-model-invocation: true` | Oui | Pas de lui-même | Description pas en contexte, le skill complet se charge lorsqu'il est invoqué |

593| `user-invocable: false` | Non | Oui | Description toujours en contexte, la compétence complète se charge lorsqu'elle est invoquée |593| `user-invocable: false` | Non | Oui | Description toujours en contexte, la compétence complète se charge lorsqu'elle est invoquée |

594 594 

595<Note>595<Note>

596 Dans une session régulière, les descriptions de compétences sont chargées en contexte afin que Claude sache ce qui est disponible, mais le contenu complet de la compétence ne se charge que lorsqu'elle est invoquée. [Les sous-agents avec compétences préchargées](/docs/fr/sub-agents#preload-skills-into-subagents) fonctionnent différemment : le contenu complet de la compétence est injecté au démarrage.596 Dans une session régulière, les descriptions de compétences sont chargées en contexte afin que Claude sache ce qui est disponible, mais le contenu complet de la compétence ne se charge que lorsqu'elle est invoquée. [Les sous-agents avec compétences préchargées](/docs/fr/sub-agents#preload-skills-into-subagents) fonctionnent différemment : le contenu complet de la compétence est injecté au démarrage.

597</Note>597</Note>

598 598 

599<h4 id="where-you-write-the-skill’s-name">

600 Où écrire le nom du skill

601</h4>

602 

603Pour exécuter un skill directement, placez son nom au début de votre message. Après du texte ordinaire, le nom donne à Claude la permission d'exécuter le skill, mais ne l'exécute pas :

604 

605| Où | Exemple | Ce qui se passe |

606| :- | :- | :- |

607| Au début de votre message | `/deploy staging` | Claude Code exécute le skill directement |

608| Après du texte ordinaire, en tant que mot séparé sans ponctuation attachée | `go ahead and /deploy to staging` | Rien ne s'exécute directement. Le nom vaut permission pour ce message : Claude peut exécuter le skill pendant sa réponse et juge d'après votre formulation si vous le lui avez demandé |

609 

610Pour parler du skill sans autoriser son exécution, omettez la barre oblique.

611 

599<h3 id="skill-content-lifecycle">612<h3 id="skill-content-lifecycle">

600 Cycle de vie du contenu de la compétence613 Cycle de vie du contenu de la compétence

601</h3>614</h3>

sub-agents.md +1 −1

Details

632 632 

633Le contenu complet de chaque skill listé est injecté dans le contexte du sous-agent au démarrage. Ce champ contrôle quels skills sont préchargés, pas à quels skills le sous-agent peut accéder : sans lui, le sous-agent peut toujours découvrir et invoquer les skills de projet, utilisateur et plugin via l'outil Skill pendant l'exécution. Pour empêcher complètement un sous-agent d'invoquer des skills, omettez `Skill` de la liste [`tools`](#available-tools) ou ajoutez-le à `disallowedTools`.633Le contenu complet de chaque skill listé est injecté dans le contexte du sous-agent au démarrage. Ce champ contrôle quels skills sont préchargés, pas à quels skills le sous-agent peut accéder : sans lui, le sous-agent peut toujours découvrir et invoquer les skills de projet, utilisateur et plugin via l'outil Skill pendant l'exécution. Pour empêcher complètement un sous-agent d'invoquer des skills, omettez `Skill` de la liste [`tools`](#available-tools) ou ajoutez-le à `disallowedTools`.

634 634 

635Vous ne pouvez pas précharger les skills qui définissent [`disable-model-invocation: true`](/docs/fr/skills#control-who-invokes-a-skill), car le préchargement puise dans le même ensemble de skills que Claude peut invoquer. Cela inclut le skill `/verify` fourni : vous seul pouvez l'exécuter, donc il ne peut pas être préchargé non plus.635Vous ne pouvez pas précharger les skills qui définissent [`disable-model-invocation: true`](/docs/fr/skills#control-who-invokes-a-skill), car le préchargement puise dans le même ensemble de skills que Claude peut invoquer. Cela inclut le skill `/verify` fourni, que Claude ne peut pas exécuter de lui-même.

636 636 

637Si un skill listé est manquant ou désactivé, par exemple par la politique de votre organisation, Claude Code le saute et enregistre un avertissement dans le journal de débogage.637Si un skill listé est manquant ou désactivé, par exemple par la politique de votre organisation, Claude Code le saute et enregistre un avertissement dans le journal de débogage.

638 638 

Details

487 487 

488Claude Code lance PowerShell avec `-ExecutionPolicy Bypass` au niveau du processus uniquement, de sorte que les scripts `.ps1` et les importations de modules fonctionnent sur les installations Windows par défaut sans modifier la politique de la machine. Le contournement au niveau du processus ne remplace pas la stratégie de groupe `MachinePolicy` ou `UserPolicy`, de sorte que les politiques d'entreprise s'appliquent toujours. Pour respecter la politique d'exécution effective de la machine à la place, définissez `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1`.488Claude Code lance PowerShell avec `-ExecutionPolicy Bypass` au niveau du processus uniquement, de sorte que les scripts `.ps1` et les importations de modules fonctionnent sur les installations Windows par défaut sans modifier la politique de la machine. Le contournement au niveau du processus ne remplace pas la stratégie de groupe `MachinePolicy` ou `UserPolicy`, de sorte que les politiques d'entreprise s'appliquent toujours. Pour respecter la politique d'exécution effective de la machine à la place, définissez `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1`.

489 489 

490<h3 id="bash-deny-rules-also-turn-off-the-powershell-tool">

491 Les règles de refus Bash désactivent également l'outil PowerShell

492</h3>

493 

494Sous Windows avec Git Bash installé, refuser Bash désactive également l'outil PowerShell pour la session. Cela s'applique aux règles restreintes telles que `Bash(git push *)` comme à un `Bash` seul, ainsi qu'aux règles provenant de l'un de vos fichiers de paramètres ou de `--disallowedTools`. Claude Code agit ainsi car une règle `Bash` ne restreint pas l'outil PowerShell, qui possède [ses propres règles de permission](/docs/fr/permissions#powershell). Si PowerShell restait activé, Claude pourrait y exécuter ce que votre règle refuse dans Bash.

495 

496Pour conserver l'outil PowerShell activé en parallèle d'une règle de refus Bash, effectuez l'une des opérations suivantes :

497 

498* Définissez `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` dans votre environnement ou dans le bloc `env` d'un fichier de paramètres, comme indiqué dans [Activer l'outil PowerShell](#enable-the-powershell-tool).

499* Ajoutez une [règle de permission `PowerShell`](/docs/fr/permissions#powershell) restreinte à un fichier de paramètres, telle qu'une règle de refus `PowerShell(git push *)`.

500 

501Sans l'une de ces options, une règle de refus Bash restreinte laisse l'outil Bash disponible, et Claude Code désactive PowerShell sans avertissement. Une règle qui supprime entièrement l'outil Bash laisse Claude sans aucun outil shell pour la session.

502 

490<h3 id="shell-selection-in-settings-hooks-and-skills">503<h3 id="shell-selection-in-settings-hooks-and-skills">

491 Sélection du shell dans les paramètres, les hooks et les skills504 Sélection du shell dans les paramètres, les hooks et les skills

492</h3>505</h3>

Details

62La connexion à GitHub est une étape unique. Si vous utilisez déjà la CLI GitHub, vous pouvez [le faire depuis votre terminal](#connect-from-your-terminal) au lieu du navigateur.62La connexion à GitHub est une étape unique. Si vous utilisez déjà la CLI GitHub, vous pouvez [le faire depuis votre terminal](#connect-from-your-terminal) au lieu du navigateur.

63 63 

64<Note>64<Note>

65 Sur les plans Team et Enterprise, l'étape **Se connecter avec GitHub** ne fonctionne qu'après qu'un [Propriétaire](/docs/fr/server-managed-settings#access-control) de votre organisation Claude active le connecteur GitHub dans [**Paramètres d'administration > Connecteurs**](https://claude.ai/admin-settings/connectors). Jusqu'à ce moment, cette étape affiche « L'accès GitHub est requis pour Claude Code sur le web » au lieu d'un bouton de connexion. Une fois le connecteur activé, rechargez [claude.ai/code](https://claude.ai/code) et recommencez à partir de la première étape. Un deuxième bouton bascule, [Configuration web rapide](/docs/fr/claude-code-on-the-web#github-authentication-options) dans [**Paramètres d'administration > Claude Code**](https://claude.ai/admin-settings/claude-code), est optionnel : lorsqu'il est activé, `/web-setup` fonctionne et l'intégration crée l'environnement pour les membres.65 Sur les plans Team et Enterprise, l'étape **Se connecter avec GitHub** ne fonctionne qu'après qu'un [Propriétaire](/docs/fr/server-managed-settings#access-control) de votre organisation Claude active le connecteur GitHub dans [**Paramètres de l'organisation > Connecteurs**](https://claude.ai/admin-settings/connectors). Jusqu'à ce moment, cette étape affiche « L'accès GitHub est requis pour les sessions cloud Claude Code » au lieu d'un bouton de connexion. Une fois le connecteur activé, rechargez [claude.ai/code](https://claude.ai/code) et recommencez à partir de la première étape. Un deuxième bouton bascule, [Configuration rapide](/docs/fr/claude-code-on-the-web#quick-setup-for-team-and-enterprise) dans [**Paramètres de l'organisation > Claude Code**](https://claude.ai/admin-settings/claude-code), est optionnel : lorsqu'il est activé, `/web-setup` fonctionne et l'intégration crée l'environnement pour les membres.

66</Note>66</Note>

67 67 

68<Steps>68<Steps>


84 Un [environnement cloud](/docs/fr/cloud-environments) est la configuration enregistrée qui contrôle l'accès réseau que Claude a pendant les sessions et ce qui s'exécute au démarrage d'une session. Ce qui se passe après que vous connectiez GitHub dépend de votre plan :84 Un [environnement cloud](/docs/fr/cloud-environments) est la configuration enregistrée qui contrôle l'accès réseau que Claude a pendant les sessions et ce qui s'exécute au démarrage d'une session. Ce qui se passe après que vous connectiez GitHub dépend de votre plan :

85 85 

86 * **Pro et Max** : l'intégration crée un environnement nommé **Par défaut** pour vous.86 * **Pro et Max** : l'intégration crée un environnement nommé **Par défaut** pour vous.

87 * **Team et Enterprise** : l'intégration affiche un formulaire **Créez votre premier environnement cloud**. Laissez le nom prérempli et l'accès réseau inchangés et cliquez sur **Créer et terminer** pour créer l'environnement **Par défaut**. Si un Propriétaire a activé [Configuration web rapide](/docs/fr/claude-code-on-the-web#github-authentication-options), l'intégration crée **Par défaut** pour vous à la place.87 * **Team et Enterprise** : l'intégration affiche un formulaire **Créez votre premier environnement cloud**. Laissez le nom prérempli et l'accès réseau inchangés et cliquez sur **Créer et terminer** pour créer l'environnement **Par défaut**. Si un Propriétaire a activé [Configuration rapide](/docs/fr/claude-code-on-the-web#quick-setup-for-team-and-enterprise), l'intégration crée **Par défaut** pour vous à la place.

88 88 

89 **Par défaut** utilise l'accès réseau [`Trusted`](/docs/fr/cloud-environments#access-levels) : les sessions accèdent aux [registres de paquets courants](/docs/fr/cloud-environments#default-allowed-domains) et à d'autres domaines autorisés, et à rien d'autre via le réseau de la session. Consultez [Outils installés](/docs/fr/cloud-environments#installed-tools) pour voir ce qui est disponible sans aucune configuration.89 **Par défaut** utilise l'accès réseau [`Trusted`](/docs/fr/cloud-environments#access-levels) : les sessions accèdent aux [registres de paquets courants](/docs/fr/cloud-environments#default-allowed-domains) et à d'autres domaines autorisés, et à rien d'autre via le réseau de la session. Consultez [Outils installés](/docs/fr/cloud-environments#installed-tools) pour voir ce qui est disponible sans aucune configuration.

90 90 


96 Connecter depuis votre terminal96 Connecter depuis votre terminal

97</h3>97</h3>

98 98 

99Si vous utilisez déjà la CLI GitHub (`gh`), vous pouvez connecter GitHub pour les sessions cloud depuis votre terminal. Cela nécessite la [CLI Claude Code](/docs/fr/quickstart). Sur les plans Team et Enterprise, `/web-setup` n'est disponible qu'après qu'un Propriétaire active [Configuration web rapide](/docs/fr/claude-code-on-the-web#github-authentication-options).99Si vous utilisez déjà la CLI GitHub (`gh`), vous pouvez connecter GitHub pour les sessions cloud depuis votre terminal. Cela nécessite la [CLI Claude Code](/docs/fr/quickstart). Sur les plans Team et Enterprise, `/web-setup` n'est disponible qu'après qu'un Propriétaire active [Configuration rapide](/docs/fr/claude-code-on-the-web#quick-setup-for-team-and-enterprise).

100 100 

101Lorsque vous exécutez `/web-setup`, Claude Code lit le jeton que `gh auth token` affiche, vous demande de confirmer, et envoie le jeton à Anthropic. Anthropic le stocke chiffré avec votre compte claude.ai, et vos sessions cloud l'utilisent pour l'accès GitHub jusqu'à ce que vous [le supprimiez](#remove-the-web-setup-token). Une session cloud que vous démarrez vous-même peut alors accéder à n'importe quel référentiel que ce jeton peut accéder, sans installation de l'application Claude GitHub. Les threads dans un [projet](/docs/fr/claude-projects#set-up-github-access) ont toujours besoin de l'application Claude GitHub.101Lorsque vous exécutez `/web-setup`, Claude Code lit le jeton que `gh auth token` affiche, vous demande de confirmer, et envoie le jeton à Anthropic. Anthropic le stocke chiffré avec votre compte claude.ai, et vos sessions cloud l'utilisent pour l'accès GitHub jusqu'à ce que vous [le supprimiez](#remove-the-web-setup-token). Une session cloud que vous démarrez vous-même peut alors accéder à n'importe quel référentiel que ce jeton peut accéder, sans installation de l'application Claude GitHub. Les threads dans un [projet](/docs/fr/claude-projects#set-up-github-access) ont toujours besoin de l'application Claude GitHub.

102 102 


259 259 

260Si vous l'avez tapé à l'intérieur de Claude Code et le menu de commandes affiche `No commands match "/web-setup"`, ou que le soumettre retourne `Unknown command: /web-setup`, la commande est masquée parce qu'une exigence n'est pas satisfaite. La cause est généralement que vous êtes authentifié avec une clé API ou un fournisseur tiers au lieu d'un abonnement claude.ai. Exécutez `/login` pour vous connecter avec votre compte claude.ai.260Si vous l'avez tapé à l'intérieur de Claude Code et le menu de commandes affiche `No commands match "/web-setup"`, ou que le soumettre retourne `Unknown command: /web-setup`, la commande est masquée parce qu'une exigence n'est pas satisfaite. La cause est généralement que vous êtes authentifié avec une clé API ou un fournisseur tiers au lieu d'un abonnement claude.ai. Exécutez `/login` pour vous connecter avec votre compte claude.ai.

261 261 

262Sur les plans Team et Enterprise, la commande est masquée par défaut : le [commutateur de configuration web rapide](/docs/fr/claude-code-on-the-web#github-authentication-options) est désactivé jusqu'à ce qu'un propriétaire l'active. Pendant qu'il est désactivé, [connectez GitHub depuis le navigateur](#connect-github) à la place.262Sur les plans Team et Enterprise, la commande est masquée par défaut : le [commutateur de configuration rapide](/docs/fr/claude-code-on-the-web#quick-setup-for-team-and-enterprise) est désactivé jusqu'à ce qu'un propriétaire l'active. Pendant qu'il est désactivé, [connectez GitHub depuis le navigateur](#connect-github) à la place.

263 263 

264La commande est également masquée dans deux autres cas :264La commande est également masquée dans deux autres cas :

265 265