Documentation 2026-11-10 21:57 UTC to 2026-11-11 22:59 UTC

96| [Politique gérée CLAUDE.md](https://code.claude.com/docs/fr/memory.md#deploy-organization-wide-claude-md) | Instructions comportementales à l'échelle de l'organisation pour Claude plutôt qu'une règle appliquée par le client | Fichier au chemin de la politique gérée |96| [Politique gérée CLAUDE.md](https://code.claude.com/docs/fr/memory.md#deploy-organization-wide-claude-md) | Instructions comportementales à l'échelle de l'organisation pour Claude plutôt qu'une règle appliquée par le client | Fichier au chemin de la politique gérée |

97| [Contrôle du serveur MCP](https://code.claude.com/docs/fr/managed-mcp.md) | Restreindre les serveurs MCP que les utilisateurs peuvent ajouter ou connecter, déployer un ensemble fixe, ou fournir des serveurs distants à chaque utilisateur aux côtés des leurs | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, `managedMcpServers`, ou un fichier `managed-mcp.json` déployé |97| [Contrôle du serveur MCP](https://code.claude.com/docs/fr/managed-mcp.md) | Restreindre les serveurs MCP que les utilisateurs peuvent ajouter ou connecter, déployer un ensemble fixe, ou fournir des serveurs distants à chaque utilisateur aux côtés des leurs | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, `managedMcpServers`, ou un fichier `managed-mcp.json` déployé |

98| [Contrôle de la marketplace de plugins](https://code.claude.com/docs/fr/plugins/org.md#restrict-what-users-can-install) | Restreindre les sources de marketplace que les utilisateurs peuvent ajouter et à partir desquelles ils peuvent installer, et rejeter les flags CLI qui chargent des plugins, agents et serveurs MCP en dehors des sources prévues pour une seule exécution. Bloquer les [sources de plugin `command`](https://code.claude.com/docs/fr/plugins/marketplace-reference#command-plugin-source), et définir une liste d'autorisation des marketplaces dont les plugins peuvent être suggérés dans le terminal | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `disableCommandPluginSources`, `pluginSuggestionMarketplaces` |98| [Contrôle de la marketplace de plugins](https://code.claude.com/docs/fr/plugins/org.md#restrict-what-users-can-install) | Restreindre les sources de marketplace que les utilisateurs peuvent ajouter et à partir desquelles ils peuvent installer, et rejeter les flags CLI qui chargent des plugins, agents et serveurs MCP en dehors des sources prévues pour une seule exécution. Bloquer les [sources de plugin `command`](https://code.claude.com/docs/fr/plugins/marketplace-reference#command-plugin-source), et définir une liste d'autorisation des marketplaces dont les plugins peuvent être suggérés dans le terminal | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `disableCommandPluginSources`, `pluginSuggestionMarketplaces` |

99| [Verrouillage de la personnalisation](https://code.claude.com/docs/fr/settings-reference.md#strictpluginonlycustomization) | Bloquer les skills, agents, hooks et serveurs MCP provenant de sources utilisateur et projet, afin qu'ils ne proviennent que de plugins ou de paramètres gérés. Le verrouillage des skills arrête également les [skills que vos développeurs activent sur claude.ai](https://code.claude.com/docs/fr/skills.md#where-synced-skills-load) de se synchroniser | `strictPluginOnlyCustomization` |99| [Verrouillage de la personnalisation](https://code.claude.com/docs/fr/settings-reference.md#strictpluginonlycustomization) | Bloquer les skills, agents, hooks et serveurs MCP provenant de sources utilisateur et projet. Le verrouillage des skills arrête également la synchronisation des [skills que vos développeurs activent sur claude.ai](https://code.claude.com/docs/fr/skills.md#where-synced-skills-load) | `strictPluginOnlyCustomization` |

100| [Désactiver la synchronisation claude.ai](https://code.claude.com/docs/fr/settings-reference.md#syncclaudeaiskills) | Arrêter Claude Code de charger les [skills](https://code.claude.com/docs/fr/skills.md#how-synced-skills-behave) et [plugins](https://code.claude.com/docs/fr/plugins/loading.md#synced-plugins) que vos développeurs activent sur claude.ai. Si vous désactivez les Skills pour votre organisation sur claude.ai, Claude Code arrête la synchronisation des deux, et sur v2.1.273 ou ultérieur, il supprime également ceux qu'il a déjà synchronisés. Pour arrêter l'un ou l'autre sans désactiver les Skills, définissez sa clé sur `false` dans les paramètres gérés | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |100| [Désactiver la synchronisation claude.ai](https://code.claude.com/docs/fr/settings-reference.md#syncclaudeaiskills) | Arrêter Claude Code de charger les [skills](https://code.claude.com/docs/fr/skills.md#how-synced-skills-behave) et [plugins](https://code.claude.com/docs/fr/plugins/loading.md#synced-plugins) que vos développeurs activent sur claude.ai. Si vous désactivez les Skills pour votre organisation sur claude.ai, Claude Code arrête la synchronisation des deux, et sur v2.1.273 ou ultérieur, il supprime également ceux qu'il a déjà synchronisés. Pour arrêter l'un ou l'autre sans désactiver les Skills, définissez sa clé sur `false` dans les paramètres gérés | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |

101| [Restrictions des hooks](https://code.claude.com/docs/fr/settings-reference.md#allowmanagedhooksonly) | Restreindre les hooks qui s'exécutent et restreindre les URL des hooks HTTP ; consultez [ce qui s'exécute sous `allowManagedHooksOnly`](https://code.claude.com/docs/fr/settings-reference#what-runs-under-allowmanagedhooksonly) pour la liste complète des effets | `allowManagedHooksOnly`, `allowedHttpHookUrls` |101| [Restrictions des hooks](https://code.claude.com/docs/fr/settings-reference.md#allowmanagedhooksonly) | Restreindre les hooks qui s'exécutent et restreindre les URL des hooks HTTP ; consultez [ce qui s'exécute sous `allowManagedHooksOnly`](https://code.claude.com/docs/fr/settings-reference#what-runs-under-allowmanagedhooksonly) pour la liste complète des effets | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

102| [Application de la connexion](https://code.claude.com/docs/fr/settings-reference.md#forceloginmethod) | Restreindre la connexion à une méthode spécifique ou à une organisation Anthropic. La restriction de méthode s'applique sur l'extension VS Code, Agent SDK, `claude setup-token`, et `/install-github-app`, et l'écran de connexion interactif du terminal, accessible via `/login` ou l'intégration au premier lancement, présélectionne la méthode sans l'appliquer ; Claude Code vérifie l'organisation pour les connexions de compte claude.ai dans le terminal, l'extension VS Code et Agent SDK, et ne la vérifie pas pour les connexions Claude Console ou pour la connexion [gateway](https://code.claude.com/docs/fr/claude-apps-gateway). Avant v2.1.212, seules les connexions au terminal appliquaient l'une ou l'autre clé. Lorsqu'elle est définie, les sessions authentifiées par `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` sont bloquées au démarrage ; les sessions des fournisseurs cloud ne sont pas affectées sauf si l'une de ces informations d'identification, ou une clé API enregistrée par une connexion Claude Console antérieure, est également présente | `forceLoginMethod`, `forceLoginOrgUUID` |102| [Application de la connexion](https://code.claude.com/docs/fr/settings-reference.md#forceloginmethod) | Restreindre la connexion à une méthode spécifique ou à une organisation Anthropic. La restriction de méthode s'applique sur l'extension VS Code, Agent SDK, `claude setup-token`, et `/install-github-app`, et l'écran de connexion interactif du terminal, accessible via `/login` ou l'intégration au premier lancement, présélectionne la méthode sans l'appliquer ; Claude Code vérifie l'organisation pour les connexions de compte claude.ai dans le terminal, l'extension VS Code et Agent SDK, et ne la vérifie pas pour les connexions Claude Console ou pour la connexion [gateway](https://code.claude.com/docs/fr/claude-apps-gateway). Avant v2.1.212, seules les connexions au terminal appliquaient l'une ou l'autre clé. Lorsqu'elle est définie, les sessions authentifiées par `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` sont bloquées au démarrage ; les sessions des fournisseurs cloud ne sont pas affectées sauf si l'une de ces informations d'identification, ou une clé API enregistrée par une connexion Claude Console antérieure, est également présente | `forceLoginMethod`, `forceLoginOrgUUID` |

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> L'outil advisor est expérimental et nécessite l'API Anthropic. Il n'est pas disponible sur Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform ou Microsoft Foundry. Le comportement, la tarification et la disponibilité peuvent changer.11> L'outil advisor est expérimental et nécessite l'API Anthropic ou [Claude Platform on AWS](https://code.claude.com/docs/fr/claude-platform-on-aws.md). Sur Claude Platform on AWS, il nécessite Claude Code v2.1.300 ou une version ultérieure. Il n'est pas disponible sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Le comportement, la tarification et la disponibilité peuvent changer.

12 12 

13L'outil advisor permet à Claude de consulter un deuxième modèle, généralement plus puissant, aux moments clés pendant une tâche, par exemple avant de s'engager dans une approche, lorsqu'il est bloqué par une erreur récurrente, ou avant de déclarer une tâche terminée. L'advisor reçoit la conversation complète, y compris chaque appel d'outil et résultat, et retourne des conseils que Claude applique avant de continuer.13L'outil advisor permet à Claude de consulter un deuxième modèle, généralement plus puissant, aux moments clés pendant une tâche, par exemple avant de s'engager dans une approche, lorsqu'il est bloqué par une erreur récurrente, ou avant de déclarer une tâche terminée. L'advisor reçoit la conversation complète, y compris chaque appel d'outil et résultat, et retourne des conseils que Claude applique avant de continuer.

14 14 

174 174 

175## Exigences175## Exigences

176 176 

177L'outil advisor nécessite tous les éléments suivants :177* **Fournisseur** : l'API Anthropic ou [Claude Platform on AWS](https://code.claude.com/docs/fr/claude-platform-on-aws.md), et non Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Sur Claude Platform on AWS, l'advisor nécessite Claude Code v2.1.300 ou ultérieur.

178 178* **Passerelle LLM** : via une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) configurée avec `ANTHROPIC_BASE_URL`, la disponibilité dépend de si la passerelle transfère la requête intacte à l'API Anthropic. Si la passerelle ou son amont ne reconnaît pas l'outil advisor, consultez [Nouvelle tentative automatique et transfert d'erreur](https://code.claude.com/docs/fr/llm-gateway-protocol.md#automatic-retry-and-error-forwarding) pour voir comment Claude Code répond.

179* **API Anthropic uniquement** : l'advisor est un outil exécuté par le serveur. Il n'est pas disponible sur Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, ou Microsoft Foundry. Via une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) configurée avec `ANTHROPIC_BASE_URL`, la disponibilité dépend de si la passerelle transfère la requête intacte à l'API Anthropic. Si la passerelle ou son amont ne reconnaît pas l'outil advisor, consultez [Nouvelle tentative automatique et transfert d'erreur](https://code.claude.com/docs/fr/llm-gateway-protocol.md#automatic-retry-and-error-forwarding) pour voir comment Claude Code répond.

180* **Modèle principal supporté** : Fable, Opus 4.6 ou ultérieur, Sonnet 4.6 ou ultérieur, Haiku 4.5, ou Haiku 5.5. Voir [Choisir un modèle advisor](#choose-an-advisor-model) pour savoir quels advisors chacun accepte.179* **Modèle principal supporté** : Fable, Opus 4.6 ou ultérieur, Sonnet 4.6 ou ultérieur, Haiku 4.5, ou Haiku 5.5. Voir [Choisir un modèle advisor](#choose-an-advisor-model) pour savoir quels advisors chacun accepte.

181* **Récupération de feature flag** : Claude Code active l'advisor via un feature flag qu'il récupère auprès d'Anthropic. Dans une session où une variable qui désactive la récupération de flag est définie, comme `DISABLE_TELEMETRY`, l'advisor reste désactivé. Voir [Fonctionnalités nécessitant la récupération de feature flag](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching).180* **Récupération de feature flag** : sauf si vous utilisez Claude Platform on AWS, l'advisor nécessite un feature flag récupéré auprès d'Anthropic. Une session où est définie une variable qui désactive la récupération, comme `DISABLE_TELEMETRY`, ne dispose pas de ce flag. Pour vérifier votre session, consultez [quelles sessions ignorent la récupération ou démarrent sans le flag](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching).

182 181 

183## Désactiver l'advisor182## Désactiver l'advisor

184 183 

220 220 

221> [!NOTE]221> [!NOTE]

222>222>

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

224 224 

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

226 226 

227Une fois l'identité de l'utilisateur final attachée, ces événements deviennent une piste d'audit par utilisateur que vous pouvez transférer à une plateforme SIEM (Security Information and Event Management) :227Une fois l'identité de l'utilisateur final attachée, ces événements deviennent une piste d'audit par utilisateur que vous pouvez transférer à une plateforme SIEM (Security Information and Event Management) :

228 228 

229* `tool_decision` et `tool_result` : chaque appel d'outil, s'il a été autorisé ou refusé, et son résultat229* `tool_decision` et `tool_result` : chaque appel d'outil, s'il a été autorisé ou refusé, et son résultat

230* `safety_event` : la vérification qui a refusé un appel d'outil ou exigé une demande de permission pour celui-ci, comme une règle de permission ou le classifieur du mode auto. Certains appels [n'ont pas d'événement de sécurité](https://code.claude.com/docs/fr/monitoring-usage.md#calls-without-a-safety-event). Nécessite Claude Code v2.1.307 ou version ultérieure

231* `mcp_server_connection` : les connexions aux serveurs MCP et les échecs de connexion230* `mcp_server_connection` : les connexions aux serveurs MCP et les échecs de connexion

232* `permission_mode_changed` : les changements de mode de permission231* `permission_mode_changed` : les changements de mode de permission

233 232 

234Ces événements s'exportent en tant qu'enregistrements de journal nommés avec un préfixe `claude_code.`, comme `claude_code.safety_event`. Consultez [Audit des événements de sécurité](https://code.claude.com/docs/fr/monitoring-usage.md#audit-security-events) dans la référence Monitoring pour la liste complète des événements pertinents pour la sécurité et les attributs que chacun porte.233Ces événements s'exportent en tant qu'enregistrements de journal nommés avec un préfixe `claude_code.`, comme `claude_code.tool_decision`. Consultez [Audit des événements de sécurité](https://code.claude.com/docs/fr/monitoring-usage.md#audit-security-events) dans la référence Monitoring pour la liste complète des événements pertinents pour la sécurité et les attributs que chacun porte.

235 234 

236## Contrôler les données sensibles dans les exports235## Contrôler les données sensibles dans les exports

237 236 

240| Variable | Ajoute |239| Variable | Ajoute |

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

242| `OTEL_LOG_USER_PROMPTS=1` | Texte d'invite sur les événements `claude_code.user_prompt` et sur le span `claude_code.interaction` |241| `OTEL_LOG_USER_PROMPTS=1` | Texte d'invite sur les événements `claude_code.user_prompt` et sur le span `claude_code.interaction` |

243| `OTEL_LOG_TOOL_DETAILS=1` | Arguments d'entrée d'outil tels que les chemins de fichiers, les commandes shell et les modèles de recherche sur les événements `claude_code.tool_result`, et les noms réels d'agent, skill, plugin et serveur MCP sur les [métriques de coût et de tokens](https://code.claude.com/docs/fr/monitoring-usage.md#cost-counter). La règle intégrée que le classifieur du mode auto a désignée lorsqu'il a bloqué un appel, en tant que [`classifier_category`](https://code.claude.com/docs/fr/monitoring-usage#tool-decision-event) sur les événements `claude_code.tool_decision` et `claude_code.safety_event` |242| `OTEL_LOG_TOOL_DETAILS=1` | Arguments d'entrée d'outil tels que les chemins de fichiers, les commandes shell et les modèles de recherche sur les événements `claude_code.tool_result`, et les noms réels d'agent, skill, plugin et serveur MCP sur les [métriques de coût et de tokens](https://code.claude.com/docs/fr/monitoring-usage.md#cost-counter). La règle intégrée que le classifieur du mode auto a désignée lorsqu'il a bloqué un appel, en tant que [`classifier_category`](https://code.claude.com/docs/fr/monitoring-usage#tool-decision-event) sur les événements `claude_code.tool_decision` |

244| `OTEL_LOG_TOOL_CONTENT=1` | Un événement de span [`tool.output`](https://code.claude.com/docs/fr/monitoring-usage#tool-output-span-event) sur `claude_code.tool` avec contenus de fichiers, sortie Bash, et ce que les outils MCP, WebFetch et WebSearch retournent, tronqué à 60 Ko par défaut, configurable via `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, qui nécessite Claude Code v2.1.214 ou version ultérieure. Les résultats des outils MCP, WebFetch et WebSearch nécessitent Claude Code v2.1.283 ou version ultérieure. Nécessite que le [traçage](#read-agent-traces) soit activé. Les attributs de span portent le contenu d'outil sous [leurs propres portes](https://code.claude.com/docs/fr/monitoring-usage.md#new-context-gates) |243| `OTEL_LOG_TOOL_CONTENT=1` | Un événement de span [`tool.output`](https://code.claude.com/docs/fr/monitoring-usage#tool-output-span-event) sur `claude_code.tool` avec contenus de fichiers, sortie Bash, et ce que les outils MCP, WebFetch et WebSearch retournent, tronqué à 60 Ko par défaut, configurable via `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, qui nécessite Claude Code v2.1.214 ou version ultérieure. Les résultats des outils MCP, WebFetch et WebSearch nécessitent Claude Code v2.1.283 ou version ultérieure. Nécessite que le [traçage](#read-agent-traces) soit activé. Les attributs de span portent le contenu d'outil sous [leurs propres portes](https://code.claude.com/docs/fr/monitoring-usage.md#new-context-gates) |

245| `OTEL_LOG_RAW_API_BODIES` | Requête et réponse JSON complètes de l'API Anthropic Messages en tant qu'événements de journal `claude_code.api_request_body` et `claude_code.api_response_body`. Définissez sur `1` pour les corps en ligne tronqués à 60 Ko par défaut, ou `file:<dir>` pour les corps non tronqués sur disque avec un chemin `body_ref` dans l'événement. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configure la limite de troncature en ligne, et nécessite Claude Code v2.1.214 ou version ultérieure. Les corps incluent l'historique de conversation complet et le contenu de la réflexion étendue est masqué. L'activation de ceci implique le consentement à tout ce que les trois variables ci-dessus révèleraient |244| `OTEL_LOG_RAW_API_BODIES` | Requête et réponse JSON complètes de l'API Anthropic Messages en tant qu'événements de journal `claude_code.api_request_body` et `claude_code.api_response_body`. Définissez sur `1` pour les corps en ligne tronqués à 60 Ko par défaut, ou `file:<dir>` pour les corps non tronqués sur disque avec un chemin `body_ref` dans l'événement. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configure la limite de troncature en ligne, et nécessite Claude Code v2.1.214 ou version ultérieure. Les corps incluent l'historique de conversation complet et le contenu de la réflexion étendue est masqué. L'activation de ceci implique le consentement à tout ce que les trois variables ci-dessus révèleraient |

246 245 

1383| :- | :- | :- |1383| :- | :- | :- |

1384| `adaptive` | `type`, `display` | Claude décide de manière adaptative quand réfléchir |1384| `adaptive` | `type`, `display` | Claude décide de manière adaptative quand réfléchir |

1385| `enabled` | `type`, `budget_tokens`, `display` | Activer la réflexion avec un budget de tokens spécifique |1385| `enabled` | `type`, `budget_tokens`, `display` | Activer la réflexion avec un budget de tokens spécifique |

1386| `disabled` | `type` | Désactiver la réflexion |1386| `disabled` | `type` | Désactiver la réflexion [lorsque le modèle et le fournisseur le permettent](https://code.claude.com/docs/fr/model-config.md#where-you-cant-turn-thinking-off) |

1387 1387 

1388Le champ `display` optionnel contrôle si le texte de réflexion est retourné `"summarized"` ou `"omitted"`. Sur Claude Opus 4.7 et ultérieur, la valeur par défaut de l'API est `"omitted"`, donc définissez `"summarized"` pour recevoir le contenu de réflexion dans les sorties [`ThinkingBlock`](#thinkingblock). Sur les fournisseurs tels qu'Amazon Bedrock et Agent Platform de Google Cloud, Claude Code ne transmet pas `display` pour les modèles antérieurs qu'il reconnaît. Il s'agit d'Opus 4.6, Sonnet 4.6, Haiku 4.5 et des modèles antérieurs, qui utilisent leur valeur par défaut.1388Le champ `display` optionnel contrôle si le texte de réflexion est retourné `"summarized"` ou `"omitted"`. Sur Claude Opus 4.7 et ultérieur, la valeur par défaut de l'API est `"omitted"`, donc définissez `"summarized"` pour recevoir le contenu de réflexion dans les sorties [`ThinkingBlock`](#thinkingblock). Sur les fournisseurs tels qu'Amazon Bedrock et Agent Platform de Google Cloud, Claude Code ne transmet pas `display` pour les modèles antérieurs qu'il reconnaît. Il s'agit d'Opus 4.6, Sonnet 4.6, Haiku 4.5 et des modèles antérieurs, qui utilisent leur valeur par défaut.

1389 1389 

664| `rewindFiles(userMessageId, options?)` | Restaure les fichiers dans leur état au moment du message utilisateur spécifié. Transmettez `{ dryRun: true }` pour prévisualiser les modifications. Nécessite `enableFileCheckpointing: true`. Consultez [Checkpointing de fichiers](https://code.claude.com/docs/fr/agent-sdk/file-checkpointing.md) |664| `rewindFiles(userMessageId, options?)` | Restaure les fichiers dans leur état au moment du message utilisateur spécifié. Transmettez `{ dryRun: true }` pour prévisualiser les modifications. Nécessite `enableFileCheckpointing: true`. Consultez [Checkpointing de fichiers](https://code.claude.com/docs/fr/agent-sdk/file-checkpointing.md) |

665| `setPermissionMode()` | Modifie le mode de permission (disponible uniquement en mode d'entrée en streaming) |665| `setPermissionMode()` | Modifie le mode de permission (disponible uniquement en mode d'entrée en streaming) |

666| `setModel()` | Modifie le modèle (disponible uniquement en mode d'entrée en streaming). Transmettre `undefined` ou la chaîne `"default"` rétablit le [modèle par défaut de Claude Code](https://code.claude.com/docs/fr/model-config.md). Une session en mode `auto` [passe en mode `default`](https://code.claude.com/docs/fr/agent-sdk/permissions#auto-mode-auto) si le nouveau modèle ne prend pas en charge le mode auto |666| `setModel()` | Modifie le modèle (disponible uniquement en mode d'entrée en streaming). Transmettre `undefined` ou la chaîne `"default"` rétablit le [modèle par défaut de Claude Code](https://code.claude.com/docs/fr/model-config.md). Une session en mode `auto` [passe en mode `default`](https://code.claude.com/docs/fr/agent-sdk/permissions#auto-mode-auto) si le nouveau modèle ne prend pas en charge le mode auto |

667| `setMaxThinkingTokens()` | *Obsolète :* utilisez plutôt l'option `thinking`. Modifie le nombre maximal de tokens de réflexion. Transmettre `null` rétablit la réflexion à la valeur par défaut de la session : un remplacement effectué en cours de session est effacé, et la réflexion reste désactivée pour les sessions où elle l'est |667| `setMaxThinkingTokens()` | *Obsolète :* Utilisez plutôt l'option `thinking`. Modifie le nombre maximal de tokens de réflexion. Passez `null` pour annuler les appels précédents et restaurer l'option `thinking` ou `maxThinkingTokens` avec laquelle la session a démarré |

668| `applyFlagSettings(settings)` | Fusionne des paramètres dans la couche de paramètres de flag de la session à l'exécution (disponible uniquement en mode d'entrée en streaming). Consultez [`applyFlagSettings()`](#applyflagsettings) |668| `applyFlagSettings(settings)` | Fusionne des paramètres dans la couche de paramètres de flag de la session à l'exécution (disponible uniquement en mode d'entrée en streaming). Consultez [`applyFlagSettings()`](#applyflagsettings) |

669| `updateSettings(source, settings)` | Écrit une clé autorisée dans le fichier de paramètres locaux du projet ou dans votre fichier de paramètres utilisateur, afin que la valeur persiste pour les sessions ultérieures. Consultez [`updateSettings()`](#updatesettings). Nécessite le SDK TypeScript v0.3.257 ou ultérieur, qui intègre Claude Code v2.1.257 |669| `updateSettings(source, settings)` | Écrit une clé autorisée dans le fichier de paramètres locaux du projet ou dans votre fichier de paramètres utilisateur, afin que la valeur persiste pour les sessions ultérieures. Consultez [`updateSettings()`](#updatesettings). Nécessite le SDK TypeScript v0.3.257 ou ultérieur, qui intègre Claude Code v2.1.257 |

670| `initializationResult()` | Renvoie le résultat complet de l'initialisation, y compris les commandes prises en charge, les modèles, les informations de compte et la configuration du style de sortie |670| `initializationResult()` | Renvoie le résultat complet de l'initialisation, y compris les commandes prises en charge, les modèles, les informations de compte et la configuration du style de sortie |

5432type ThinkingConfig =5432type ThinkingConfig =

5433 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)5433 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)

5434 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget5434 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget

5435 | { type: "disabled" }; // No extended thinking5435 | { type: "disabled" }; // Turn thinking off where the model and provider allow it

5436```5436```

5437 5437 

5438Pour `disabled`, consultez [les cas où vous ne pouvez pas désactiver la réflexion](https://code.claude.com/docs/fr/model-config.md#where-you-cant-turn-thinking-off).

5439 

5438Le champ facultatif `display` détermine si le texte de réflexion est renvoyé sous la forme `"summarized"` ou `"omitted"`. Sur Claude Opus 4.7 et versions ultérieures, la valeur par défaut de l'API est `"omitted"` ; définissez donc `"summarized"` pour recevoir le contenu de réflexion dans les blocs `thinking`. Sur des fournisseurs comme Amazon Bedrock et Agent Platform de Google Cloud, Claude Code ne transmet pas `display` pour les modèles antérieurs qu'il reconnaît. Il s'agit d'Opus 4.6, Sonnet 4.6, Haiku 4.5 et des modèles antérieurs, qui utilisent leur valeur par défaut.5440Le champ facultatif `display` détermine si le texte de réflexion est renvoyé sous la forme `"summarized"` ou `"omitted"`. Sur Claude Opus 4.7 et versions ultérieures, la valeur par défaut de l'API est `"omitted"` ; définissez donc `"summarized"` pour recevoir le contenu de réflexion dans les blocs `thinking`. Sur des fournisseurs comme Amazon Bedrock et Agent Platform de Google Cloud, Claude Code ne transmet pas `display` pour les modèles antérieurs qu'il reconnaît. Il s'agit d'Opus 4.6, Sonnet 4.6, Haiku 4.5 et des modèles antérieurs, qui utilisent leur valeur par défaut.

5439 5441 

5440### `SpawnedProcess`5442### `SpawnedProcess`

169 169 

170Lorsque la liste est [groupée par répertoire](#organize-the-list), le résumé s'ouvre avec l'état de la session en tant que mot coloré, comme `Needs input · double jump or wall climb?`. Dans le groupement par état par défaut, l'en-tête du groupe nomme déjà l'état, la ligne affiche donc uniquement le résumé.170Lorsque la liste est [groupée par répertoire](#organize-the-list), le résumé s'ouvre avec l'état de la session en tant que mot coloré, comme `Needs input · double jump or wall climb?`. Dans le groupement par état par défaut, l'en-tête du groupe nomme déjà l'état, la ligne affiche donc uniquement le résumé.

171 171 

172Le résumé de fin de tour et chaque réécriture en cours de tour sont une courte requête de classe Haiku via votre fournisseur habituel, facturée et traitée selon les mêmes [conditions d'utilisation des données](https://code.claude.com/docs/fr/data-usage.md) que la session elle-même. Les mises à jour de 15 secondes entre les réécritures du modèle réutilisent la sortie de la session elle-même et n'envoient pas de requête. Sur un fournisseur tiers ou une passerelle sans modèle de classe Haiku configuré, la requête utilise le modèle principal de la session à la place ; définissez [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/fr/model-config#environment-variables) pour en choisir un.172#### Coût des résumés de lignes

173 

174Le résumé de fin de tour et chaque réécriture en cours de tour sont une courte requête via votre fournisseur habituel, facturée et traitée selon les mêmes [conditions d'utilisation des données](https://code.claude.com/docs/fr/data-usage.md) que la session elle-même. Sur un fournisseur tiers ou une passerelle, les résumés utilisent le modèle que vous définissez dans [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/fr/model-config#environment-variables). Si cette variable n'est pas définie, ils utilisent le modèle de votre fournisseur pour les tâches en arrière-plan : consultez [Amazon Bedrock](https://code.claude.com/docs/fr/amazon-bedrock.md#4-pin-model-versions), [Agent Platform de Google Cloud](https://code.claude.com/docs/fr/google-vertex-ai.md#5-pin-model-versions), [Microsoft Foundry](https://code.claude.com/docs/fr/microsoft-foundry.md#4-pin-model-versions) ou votre [passerelle](https://code.claude.com/docs/fr/llm-gateway-protocol.md#requests-and-defaults-by-connection-method).

173 175 

174### État de la pull request176### État de la pull request

175 177 

128 128 

129### Outils du navigateur en mode plan129### Outils du navigateur en mode plan

130 130 

131En [mode plan](https://code.claude.com/docs/fr/permission-modes.md#analyze-before-you-edit-with-plan-mode), une demande de permission apparaît avant que Claude n'enregistre un GIF, n'ouvre un nouvel onglet ou n'exécute un raccourci. Dans une session CLI interactive, si le [mode bypass permissions est disponible](https://code.claude.com/docs/fr/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) et que la [récupération des feature flags](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching) est désactivée, ces appels s'exécutent sans demande de permission.131En [mode plan](https://code.claude.com/docs/fr/permission-modes.md#analyze-before-you-edit-with-plan-mode), une demande de permission apparaît avant que Claude n'enregistre un GIF ou n'ouvre un nouvel onglet. Dans une session CLI interactive, si le [mode bypass permissions est disponible](https://code.claude.com/docs/fr/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) et que la [récupération des feature flags](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching) est désactivée, ces appels s'exécutent sans demande de permission.

132 132 

133Un appel `tabs_context_mcp` déclenche également une demande de permission lorsqu'il définit `createIfEmpty`, tout comme un appel `browser_batch` qui inclut l'une de ces actions.133Un appel `tabs_context_mcp` déclenche également une demande de permission lorsqu'il définit `createIfEmpty`, tout comme un appel `browser_batch` qui inclut l'une de ces actions.

134 134 

313>313>

314> `gatewayInternalNetworks` est destiné aux réseaux internes qui se trouvent être numérotés à partir d'un espace d'adressage public. Il ne rend pas sûre l'exposition d'une passerelle sur internet : une passerelle de confiance peut pousser des paramètres qui exécutent des commandes sur les machines des développeurs.314> `gatewayInternalNetworks` est destiné aux réseaux internes qui se trouvent être numérotés à partir d'un espace d'adressage public. Il ne rend pas sûre l'exposition d'une passerelle sur internet : une passerelle de confiance peut pousser des paramètres qui exécutent des commandes sur les machines des développeurs.

315>315>

316> Maintenez la passerelle inaccessible depuis l'extérieur de votre réseau grâce aux règles de votre pare-feu ou de votre load balancer. Définissez le paramètre [`access_control.allow_cidrs`](https://code.claude.com/docs/fr/claude-apps-gateway-config#http-tuning) de la passerelle sur les mêmes blocs que ceux que vous déclarez ici, afin que la passerelle elle-même refuse les clients venant d'ailleurs. Derrière un load balancer ou un ingress, définissez aussi `listen.trusted_proxies` sur ce frontal, car sinon la passerelle compare `allow_cidrs` à l'adresse du frontal plutôt qu'à celle du développeur.316> Maintenez la passerelle inaccessible depuis l'extérieur de votre réseau grâce aux règles de votre pare-feu ou de votre load balancer. Définissez le paramètre [`access_control.allow_cidrs`](https://code.claude.com/docs/fr/claude-apps-gateway-config#http-tuning) de la passerelle sur les mêmes blocs que ceux que vous déclarez ici. Si un load balancer ou un ingress [doit figurer dans `listen.trusted_proxies`](https://code.claude.com/docs/fr/claude-apps-gateway-config#listen), listez-le également à cet endroit, car sinon la passerelle compare `allow_cidrs` à l'adresse propre du frontal plutôt qu'à celle du développeur.

317 317 

318Ajoutez 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, de projet et gérés par le serveur.318Ajoutez 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, de projet et gérés par le serveur.

319 319 

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

60| `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. |60| `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. |

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

62| `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. |62| `trusted_proxies` | Non | CIDR ou IP des frontends auxquels faire confiance. Lorsqu'il est défini, la passerelle ne fait confiance à `X-Forwarded-For` que de la part de ces pairs et enregistre l'IP réelle du client pour la limitation de débit par IP et l'audit. |

63 

64N'indiquez un frontend dans `trusted_proxies` que si la dernière entrée `X-Forwarded-For` qu'il transmet n'a été écrite par aucun développeur. N'indiquez aucune adresse ni plage depuis laquelle les développeurs se connectent. Un frontend qui ajoute l'adresse de chaque connexion qu'il reçoit remplit cette condition. Un frontend qui transmet l'en-tête tel que les développeurs l'envoient ne la remplit pas.

65 

66Les entrées `X-Forwarded-For` écrites sous la forme `ipv4:port` ou `[ipv6]:port`, comme le font certains load balancers, sont lues sans le port. Une adresse IPv6 suivie d'un port sans crochets peut être lue comme une adresse différente ou ne pas être lue du tout. Désactivez l'option de port sur tout proxy qui écrit cette forme.

63 67 

64### `oidc`68### `oidc`

65 69 

1659 1663 

1660Les deux signaux utilisent l'adresse client telle que la passerelle la résout. Si un équilibreur de charge, une redirection de port ou un tunnel relaie le trafic et n'est pas listé dans `listen.trusted_proxies`, la passerelle voit l'adresse du relais, qui est généralement privée, de sorte que ni l'avertissement à l'exécution ni une liste d'autorisation privée ne détectent le trafic relayé par celui-ci.1664Les deux signaux utilisent l'adresse client telle que la passerelle la résout. Si un équilibreur de charge, une redirection de port ou un tunnel relaie le trafic et n'est pas listé dans `listen.trusted_proxies`, la passerelle voit l'adresse du relais, qui est généralement privée, de sorte que ni l'avertissement à l'exécution ni une liste d'autorisation privée ne détectent le trafic relayé par celui-ci.

1661 1665 

1662Derrière un tel front-end, définissez d'abord [`listen.trusted_proxies`](#listen) afin que la passerelle voie les adresses client réelles, et gardez dans tous les cas la passerelle et tout ce qui se trouve devant elle inaccessibles depuis l'Internet public.1666Si le relais [a sa place dans `listen.trusted_proxies`](#listen), listez-le à cet endroit. Dans tous les cas, gardez la passerelle et tout ce qui se trouve devant elle inaccessibles depuis l'internet public.

1663 1667 

1664### `load_test_mode`1668### `load_test_mode`

1665 1669 

131 131 

132La connexion est limitée en débit par adresse IP client, et les valeurs par défaut conviennent à une petite équipe. Chaque adresse obtient 30 démarrages de connexion et 10 soumissions de code toutes les 10 minutes. Un déploiement pour des milliers de développeurs peut atteindre ces limites le premier matin, pour l'une de deux raisons :132La connexion est limitée en débit par adresse IP client, et les valeurs par défaut conviennent à une petite équipe. Chaque adresse obtient 30 démarrages de connexion et 10 soumissions de code toutes les 10 minutes. Un déploiement pour des milliers de développeurs peut atteindre ces limites le premier matin, pour l'une de deux raisons :

133 133 

134* **La passerelle ne peut pas voir au-delà de votre équilibreur de charge.** Sans [`listen.trusted_proxies`](https://code.claude.com/docs/fr/claude-apps-gateway-config#listen), chaque développeur semble provenir de l'adresse de l'équilibreur de charge et partage une limite. Définissez-le avant toute autre chose. La passerelle enregistre un avertissement la première fois qu'elle ignore un en-tête `X-Forwarded-For`.134* **La passerelle ne peut pas voir au-delà de votre équilibreur de charge.** Sans [`listen.trusted_proxies`](https://code.claude.com/docs/fr/claude-apps-gateway-config#listen), chaque développeur semble provenir de l'adresse de l'équilibreur de charge et partage une seule limite. La passerelle consigne un avertissement la première fois qu'elle ignore un en-tête `X-Forwarded-For`. Si l'équilibreur de charge [a sa place dans `listen.trusted_proxies`](https://code.claude.com/docs/fr/claude-apps-gateway-config#listen), ajoutez-le à la liste avant de modifier quoi que ce soit d'autre. Si les développeurs partagent toujours une seule adresse, augmentez [`rate_limits`](https://code.claude.com/docs/fr/claude-apps-gateway-config#http-tuning).

135* **De nombreux développeurs partagent quelques adresses de sortie NAT ou VPN.** Ils partagent les limites de ces adresses même lorsque `trusted_proxies` est correct. Augmentez [`rate_limits`](https://code.claude.com/docs/fr/claude-apps-gateway-config#http-tuning) pour l'adapter.135* **De nombreux développeurs partagent quelques adresses de sortie NAT ou VPN.** Ils partagent les limites de ces adresses même lorsque `trusted_proxies` est correct. Augmentez [`rate_limits`](https://code.claude.com/docs/fr/claude-apps-gateway-config#http-tuning) pour l'adapter.

136 136 

137Pour dimensionner `max`, divisez les développeurs par les adresses de sortie qu'ils partagent. Estimez combien d'entre eux se connectent dans une période `window_seconds`, qui est 10 minutes par défaut. Puis doublez-le pour couvrir les tentatives et les développeurs qui se connectent à la fois à Claude Code et Claude Desktop.137Pour dimensionner `max`, divisez les développeurs par les adresses de sortie qu'ils partagent. Estimez combien d'entre eux se connectent dans une période `window_seconds`, qui est 10 minutes par défaut. Puis doublez-le pour couvrir les tentatives et les développeurs qui se connectent à la fois à Claude Code et Claude Desktop.

418| Le démarrage affiche `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | Le build de Claude Code installé est antérieur à la prise en charge de la passerelle | Demandez au développeur de mettre à jour Claude Code vers une version qui inclut la prise en charge de Cloud gateway |418| Le démarrage affiche `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | Le build de Claude Code installé est antérieur à la prise en charge de la passerelle | Demandez au développeur de mettre à jour Claude Code vers une version qui inclut la prise en charge de Cloud gateway |

419| Le démarrage se termine avec `Administrator policy requires a Cloud gateway sign-in on this machine` | L'environnement du développeur définit `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN`, ses paramètres configurent un [`apiKeyHelper`](https://code.claude.com/docs/fr/settings-reference#apikeyhelper), ou une clé API issue d'une ancienne connexion à la Claude Console est toujours enregistrée | Demandez au développeur de corriger chaque cas applicable : supprimer la variable, retirer l'entrée `apiKeyHelper`, ou exécuter `claude auth logout` pour supprimer la clé enregistrée. Une session qui sélectionne un fournisseur cloud avec `CLAUDE_CODE_USE_*` démarre alors sans connexion ; pour toutes les autres sessions, demandez-lui de lancer `claude` et de se connecter avec `/login`. Voir aussi [Administrator policy requires a Cloud gateway sign-in](https://code.claude.com/docs/fr/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in). |419| Le démarrage se termine avec `Administrator policy requires a Cloud gateway sign-in on this machine` | L'environnement du développeur définit `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN`, ses paramètres configurent un [`apiKeyHelper`](https://code.claude.com/docs/fr/settings-reference#apikeyhelper), ou une clé API issue d'une ancienne connexion à la Claude Console est toujours enregistrée | Demandez au développeur de corriger chaque cas applicable : supprimer la variable, retirer l'entrée `apiKeyHelper`, ou exécuter `claude auth logout` pour supprimer la clé enregistrée. Une session qui sélectionne un fournisseur cloud avec `CLAUDE_CODE_USE_*` démarre alors sans connexion ; pour toutes les autres sessions, demandez-lui de lancer `claude` et de se connecter avec `/login`. Voir aussi [Administrator policy requires a Cloud gateway sign-in](https://code.claude.com/docs/fr/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in). |

420| Le démarrage ou `/login` signale `Claude Code may not be enabled for your organization` après un 403 lors du chargement des paramètres gérés | La passerelle, ou un élément placé devant elle, a répondu 403 à la requête `/managed/settings`. La route de paramètres de la passerelle elle-même ne répond jamais 403. Ce statut provient des vérifications d'IP [`access_control`](https://code.claude.com/docs/fr/claude-apps-gateway-config#http-tuning) ou d'un proxy ou WAF placé devant la passerelle. Le log d'audit enregistre un refus lié à la vérification d'IP sous la forme `access.denied` avec la raison. Le développeur reste connecté. | Recherchez `access.denied` dans le log d'audit au moment de l'échec et corrigez les listes `access_control` ou le frontal, puis demandez au développeur de relancer `claude` |420| Le démarrage ou `/login` signale `Claude Code may not be enabled for your organization` après un 403 lors du chargement des paramètres gérés | La passerelle, ou un élément placé devant elle, a répondu 403 à la requête `/managed/settings`. La route de paramètres de la passerelle elle-même ne répond jamais 403. Ce statut provient des vérifications d'IP [`access_control`](https://code.claude.com/docs/fr/claude-apps-gateway-config#http-tuning) ou d'un proxy ou WAF placé devant la passerelle. Le log d'audit enregistre un refus lié à la vérification d'IP sous la forme `access.denied` avec la raison. Le développeur reste connecté. | Recherchez `access.denied` dans le log d'audit au moment de l'échec et corrigez les listes `access_control` ou le frontal, puis demandez au développeur de relancer `claude` |

421| `/login` dans la CLI : `The gateway is limiting sign-in attempts right now`, ou `Request failed with status code 429` sur les anciennes versions. La page `/device` peut afficher `Too many attempts` à des développeurs qui n'ont encore jamais essayé | La limite de débit de connexion par IP a été atteinte. Soit `listen.trusted_proxies` ne couvre pas le load balancer, si bien que tous les développeurs partagent son adresse, soit de nombreux développeurs partagent une même adresse de sortie NAT ou VPN. Les événements d'audit avec `result: rate_limited` affichent la ou les mêmes quelques valeurs `client_ip`. | Définissez d'abord `listen.trusted_proxies` sur les plages source du load balancer, puis augmentez `rate_limits` si les développeurs partagent encore des adresses. Voir [Déploiements à grande échelle](#large-rollouts). |421| `/login` dans la CLI : `The gateway is limiting sign-in attempts right now`, ou `Request failed with status code 429` sur les anciennes versions. La page `/device` peut afficher `Too many attempts` à des développeurs qui n'ont encore jamais essayé | La limite de débit de connexion par IP a été atteinte. Soit `listen.trusted_proxies` ne couvre pas le load balancer, si bien que tous les développeurs partagent son adresse, soit de nombreux développeurs partagent une même adresse de sortie NAT ou VPN. Les événements d'audit avec `result: rate_limited` affichent la ou les mêmes quelques valeurs `client_ip`. | Si le load balancer [a sa place dans `listen.trusted_proxies`](https://code.claude.com/docs/fr/claude-apps-gateway-config#listen), ajoutez-le d'abord à cette liste. Augmentez ensuite `rate_limits` si les développeurs partagent encore des adresses. Voir [Déploiements à grande échelle](#large-rollouts). |

422| `/login` dans la CLI : `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Le nom d'hôte de la passerelle se résout vers au moins une adresse IP publique. Claude Code vérifie chaque adresse résolue et exige qu'elles soient toutes privées. Une cause fréquente est un nom dual-stack dont une famille se résout vers une adresse publique, y compris les load balancers internes dual-stack d'AWS, qui renvoient des adresses AAAA dans des plages publiques. | Faites en sorte que le nom de la passerelle ne se résolve que vers des adresses privées sur les machines des développeurs. Pour un nom dual-stack, supprimez l'enregistrement de plage publique ou servez un nom DNS distinct, uniquement interne. Voir le [prérequis de réseau privé](https://code.claude.com/docs/fr/claude-apps-gateway#prerequisites). Si l'adresse fait partie d'un espace public que votre organisation possède et utilise en interne, [déclarez ce bloc](https://code.claude.com/docs/fr/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) à la place. |422| `/login` dans la CLI : `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Le nom d'hôte de la passerelle se résout vers au moins une adresse IP publique. Claude Code vérifie chaque adresse résolue et exige qu'elles soient toutes privées. Une cause fréquente est un nom dual-stack dont une famille se résout vers une adresse publique, y compris les load balancers internes dual-stack d'AWS, qui renvoient des adresses AAAA dans des plages publiques. | Faites en sorte que le nom de la passerelle ne se résolve que vers des adresses privées sur les machines des développeurs. Pour un nom dual-stack, supprimez l'enregistrement de plage publique ou servez un nom DNS distinct, uniquement interne. Voir le [prérequis de réseau privé](https://code.claude.com/docs/fr/claude-apps-gateway#prerequisites). Si l'adresse fait partie d'un espace public que votre organisation possède et utilise en interne, [déclarez ce bloc](https://code.claude.com/docs/fr/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) à la place. |

423| `/login` dans la CLI : `Gateway login would go through proxy <proxy>, which is not on a private network` | Un `HTTPS_PROXY` ou `HTTP_PROXY` s'applique à l'hôte de la passerelle et le nom d'hôte du proxy se résout vers une adresse publique. Un proxy dont l'hôte se résout uniquement vers des adresses privées est autorisé et ne déclenche pas cette erreur | Ajoutez l'hôte de la passerelle à `NO_PROXY` sur la machine du développeur pour que la connexion soit directe, ou utilisez un proxy dont le nom d'hôte se résout vers des adresses privées. Le message indique l'entrée `NO_PROXY` exacte à ajouter |423| `/login` dans la CLI : `Gateway login would go through proxy <proxy>, which is not on a private network` | Un `HTTPS_PROXY` ou `HTTP_PROXY` s'applique à l'hôte de la passerelle et le nom d'hôte du proxy se résout vers une adresse publique. Un proxy dont l'hôte se résout uniquement vers des adresses privées est autorisé et ne déclenche pas cette erreur | Ajoutez l'hôte de la passerelle à `NO_PROXY` sur la machine du développeur pour que la connexion soit directe, ou utilisez un proxy dont le nom d'hôte se résout vers des adresses privées. Le message indique l'entrée `NO_PROXY` exacte à ajouter |

424| `/login` dans la CLI : `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | La passerelle se trouve sur un bloc déclaré dans [`gatewayInternalNetworks`](https://code.claude.com/docs/fr/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), et la machine du développeur l'a atteinte depuis une adresse extérieure à ce bloc : un pool d'adresses VPN, un segment NAT de conteneur ou de WSL2, ou un réseau qui ne vous appartient pas | Demandez au développeur d'exécuter `/login` depuis l'OS hôte sur votre réseau. Si l'adresse affichée fait également partie de l'espace public propre à votre organisation, remplacez l'entrée de la passerelle par un bloc qui couvre les deux, jusqu'à `/8` ; une seconde entrée qui chevauche la première est refusée. Si aucun bloc ne couvre les deux, voir [Choisir une adresse pour la passerelle](#choose-an-address-for-the-gateway) |424| `/login` dans la CLI : `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | La passerelle se trouve sur un bloc déclaré dans [`gatewayInternalNetworks`](https://code.claude.com/docs/fr/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), et la machine du développeur l'a atteinte depuis une adresse extérieure à ce bloc : un pool d'adresses VPN, un segment NAT de conteneur ou de WSL2, ou un réseau qui ne vous appartient pas | Demandez au développeur d'exécuter `/login` depuis l'OS hôte sur votre réseau. Si l'adresse affichée fait également partie de l'espace public propre à votre organisation, remplacez l'entrée de la passerelle par un bloc qui couvre les deux, jusqu'à `/8` ; une seconde entrée qui chevauche la première est refusée. Si aucun bloc ne couvre les deux, voir [Choisir une adresse pour la passerelle](#choose-an-address-for-the-gateway) |

36 36 

37Chaque session cloud s'exécute dans un [environnement cloud](https://code.claude.com/docs/fr/cloud-environments.md), la configuration enregistrée qui contrôle l'accès réseau, les variables d'environnement et les scripts de configuration.37Chaque session cloud s'exécute dans un [environnement cloud](https://code.claude.com/docs/fr/cloud-environments.md), la configuration enregistrée qui contrôle l'accès réseau, les variables d'environnement et les scripts de configuration.

38 38 

39* **Votre premier environnement** : si vous n'en avez pas encore, l'intégration configure un environnement **Default** avec [accès réseau **Trusted**](https://code.claude.com/docs/fr/cloud-environments.md#access-levels), soit en le créant pour vous, soit en vous demandant de le créer. Consultez [L'environnement Default](https://code.claude.com/docs/fr/cloud-environments.md#the-default-environment) pour savoir lequel se produit sur votre plan39* **Votre premier environnement** : si vous n'en avez pas encore, l'intégration configure un environnement **Default** avec [accès réseau **Limited**](https://code.claude.com/docs/fr/cloud-environments.md#access-levels). Consultez [L'environnement Default](https://code.claude.com/docs/fr/cloud-environments.md#the-default-environment) pour savoir comment cela fonctionne sur votre plan

40* **Quel environnement une session utilise** : consultez [L'environnement Default](https://code.claude.com/docs/fr/cloud-environments.md#the-default-environment) pour savoir comment les sessions choisissent un environnement lorsque vous en avez plus d'un40* **Quel environnement une session utilise** : consultez [L'environnement Default](https://code.claude.com/docs/fr/cloud-environments.md#the-default-environment) pour savoir comment les sessions choisissent un environnement lorsque vous en avez plus d'un

41* **Modifier ce que les sessions peuvent atteindre ou exécuter au démarrage** : consultez [Configurer les environnements cloud](https://code.claude.com/docs/fr/cloud-environments.md)41* **Modifier ce que les sessions peuvent atteindre ou exécuter au démarrage** : consultez [Configurer les environnements cloud](https://code.claude.com/docs/fr/cloud-environments.md)

42* **Ce qui est installé sans aucune configuration** : consultez [Outils installés](https://code.claude.com/docs/fr/cloud-environments.md#installed-tools)42* **Ce qui est installé sans aucune configuration** : consultez [Outils installés](https://code.claude.com/docs/fr/cloud-environments.md#installed-tools)

146* **Mémoire automatique** : le balayage ne supprime pas les fichiers de mémoire dans le répertoire de [mémoire automatique](https://code.claude.com/docs/fr/memory.md#auto-memory) d'un projet, `projects/<project>/memory/`. Claude Code supprime ce répertoire uniquement s'il a été vide pendant toute la période de rétention. Avant v2.1.228, le balayage traitait les dossiers à l'intérieur du répertoire de mémoire comme des données de session et pouvait supprimer les anciens fichiers en dessous.146* **Mémoire automatique** : le balayage ne supprime pas les fichiers de mémoire dans le répertoire de [mémoire automatique](https://code.claude.com/docs/fr/memory.md#auto-memory) d'un projet, `projects/<project>/memory/`. Claude Code supprime ce répertoire uniquement s'il a été vide pendant toute la période de rétention. Avant v2.1.228, le balayage traitait les dossiers à l'intérieur du répertoire de mémoire comme des données de session et pouvait supprimer les anciens fichiers en dessous.

147* **Transcriptions Claude Desktop et Cowork** : Claude Code conserve la transcription d'une session que vous avez démarrée ou continuée le plus récemment dans Claude Desktop ou Cowork à tout âge. Pour donner à ces transcriptions une limite d'âge, définissez [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/fr/settings-reference#desktopsessioncleanupperioddays). Nécessite Claude Code v2.1.248 ou ultérieur ; les versions antérieures les suppriment après `cleanupPeriodDays`.147* **Transcriptions Claude Desktop et Cowork** : Claude Code conserve la transcription d'une session que vous avez démarrée ou continuée le plus récemment dans Claude Desktop ou Cowork à tout âge. Pour donner à ces transcriptions une limite d'âge, définissez [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/fr/settings-reference#desktopsessioncleanupperioddays). Nécessite Claude Code v2.1.248 ou ultérieur ; les versions antérieures les suppriment après `cleanupPeriodDays`.

148 148 

149 Claude Code supprime plutôt ces transcriptions après `cleanupPeriodDays` dans l'un ou l'autre de ces cas :149 Claude Code supprime plutôt ces transcriptions après `cleanupPeriodDays` dans des cas comme ceux-ci :

150 150 

151 * Les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) définissent `cleanupPeriodDays`151 * Les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) définissent `cleanupPeriodDays`

152 * La [configuration HIPAA s'applique à vos sessions](https://code.claude.com/docs/fr/hipaa-setup.md#check-how-developers-sign-in-and-connect)152 * La [configuration HIPAA s'applique à vos sessions](https://code.claude.com/docs/fr/hipaa-setup.md#check-how-developers-sign-in-and-connect)

170* **Linux** : `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, ou la même forme sous `$TMPDIR` lorsque votre système en définit un170* **Linux** : `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, ou la même forme sous `$TMPDIR` lorsque votre système en définit un

171* **Windows** : `%TEMP%\claude\<project>\<session-id>\scratchpad\`171* **Windows** : `%TEMP%\claude\<project>\<session-id>\scratchpad\`

172 172 

173`<project>` est le chemin de votre répertoire de travail avec chaque caractère autre que les lettres et les chiffres remplacé par `-`, par exemple `-Users-you-my-project`. Si vous définissez [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/fr/env-vars), l'arborescence se déplace sous ce répertoire à la place. Les hooks reçoivent le chemin de la session actuelle en tant que [`scratchpad_dir`](https://code.claude.com/docs/fr/hooks#common-input-fields).173`<project>` est le chemin de votre répertoire de travail avec chaque caractère autre que les lettres et les chiffres remplacé par `-`, par exemple `-Users-you-my-project`. Sous Windows, `<project>` est un hachage de 16 caractères de cette chaîne, par exemple `73295dabccd14c56`. Dans une session de l'application Desktop, il peut s'agir de la chaîne elle-même. Pour obtenir le chemin exact, demandez à Claude. Si vous définissez [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/fr/env-vars), l'arborescence se déplace sous ce répertoire à la place. Les hooks reçoivent le chemin de la session actuelle en tant que [`scratchpad_dir`](https://code.claude.com/docs/fr/hooks#common-input-fields).

174 174 

175Les fichiers du bloc-notes durent aussi longtemps que la transcription de la session : le [balayage de rétention](#cleaned-up-automatically) supprime le répertoire lorsqu'il supprime la transcription, et [`claude purge`](#clear-local-data) ne touche pas au répertoire temporaire. Parce que le répertoire se trouve sous l'emplacement temporaire du système, votre système d'exploitation peut également le supprimer, par exemple au redémarrage. Pour conserver quelque chose que Claude a écrit là, demandez à Claude de le déplacer dans votre projet.175Les fichiers du bloc-notes durent aussi longtemps que la transcription de la session : le [balayage de rétention](#cleaned-up-automatically) supprime le répertoire lorsqu'il supprime la transcription, et [`claude purge`](#clear-local-data) ne touche pas au répertoire temporaire. Parce que le répertoire se trouve sous l'emplacement temporaire du système, votre système d'exploitation peut également le supprimer, par exemple au redémarrage. Pour conserver quelque chose que Claude a écrit là, demandez à Claude de le déplacer dans votre projet.

176 176 

8 8 

9Claude Platform on AWS est l'API Claude exploitée par Anthropic avec l'authentification AWS, le contrôle d'accès IAM et la facturation AWS Marketplace. Les requêtes atteignent directement l'API d'Anthropic, vous bénéficiez donc des mêmes modèles et fonctionnalités API que l'[API Claude](https://platform.claude.com/docs) selon le même calendrier de publication. Vous vous authentifiez avec les identifiants AWS ou une clé API d'espace de travail, et vous payez via AWS Marketplace.9Claude Platform on AWS est l'API Claude exploitée par Anthropic avec l'authentification AWS, le contrôle d'accès IAM et la facturation AWS Marketplace. Les requêtes atteignent directement l'API d'Anthropic, vous bénéficiez donc des mêmes modèles et fonctionnalités API que l'[API Claude](https://platform.claude.com/docs) selon le même calendrier de publication. Vous vous authentifiez avec les identifiants AWS ou une clé API d'espace de travail, et vous payez via AWS Marketplace.

10 10 

11Les fonctionnalités côté client que Claude Code active via le service de drapeaux de fonctionnalités d'Anthropic sont désactivées par défaut, et l'[outil conseiller](https://code.claude.com/docs/fr/advisor.md) n'est pas disponible. Consultez la [matrice de disponibilité des fonctionnalités](https://code.claude.com/docs/fr/feature-availability.md#summary-by-provider) pour la liste complète.

12 

13Utilisez ce guide pour pointer Claude Code vers un espace de travail que vous avez déjà provisionné via Claude Platform on AWS. Pour l'abonnement AWS et la configuration de l'espace de travail qui précèdent cela, consultez la [documentation Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).11Utilisez ce guide pour pointer Claude Code vers un espace de travail que vous avez déjà provisionné via Claude Platform on AWS. Pour l'abonnement AWS et la configuration de l'espace de travail qui précèdent cela, consultez la [documentation Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).

14 12 

15> [!NOTE]13> [!NOTE]

16>14>

17> L'abonnement via AWS Marketplace provisionne une nouvelle organisation Anthropic liée à votre compte AWS. Cette organisation est distincte de toute organisation que vous avez déjà avec Anthropic, et les identifiants ne se transfèrent pas entre elles. Utilisez l'ID d'espace de travail et les clés API de l'organisation liée à AWS, et non d'un compte Claude Console préexistant.15> L'abonnement via AWS Marketplace provisionne une nouvelle organisation Anthropic liée à votre compte AWS. Cette organisation est distincte de toute organisation que vous avez déjà avec Anthropic, et les identifiants ne se transfèrent pas entre elles. Utilisez l'ID d'espace de travail et les clés API de l'organisation liée à AWS, et non d'un compte Claude Console préexistant.

18 16 

17Certaines fonctionnalités de Claude Code ne sont pas disponibles ou fonctionnent différemment sur Claude Platform on AWS. Consultez la [matrice de disponibilité des fonctionnalités](https://code.claude.com/docs/fr/feature-availability.md#summary-by-provider) et les [fonctionnalités qui nécessitent la récupération des feature flags](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching).

18 

19## Prérequis19## Prérequis

20 20 

21Avant de configurer Claude Code, vous avez besoin de :21Avant de configurer Claude Code, vous avez besoin de :

37 37 

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

39 39 

40* [Accès réseau **Trusted**](#access-levels) : les sessions atteignent les registres de paquets et autres [domaines autorisés](#default-allowed-domains), et rien d'autre via le réseau de la session.40* [Accès réseau **Limited**](#access-levels) : les sessions atteignent les registres de paquets et autres [domaines autorisés](#default-allowed-domains).

41* Aucune autre configuration : **Default** ne définit aucune variable d'environnement ou script de configuration, donc les sessions commencent avec juste les [outils pré-installés](#installed-tools).41* Aucune autre configuration : **Default** ne définit aucune variable d'environnement ou script de configuration, donc les sessions commencent avec juste les [outils pré-installés](#installed-tools).

42 42 

43Avec seulement **Default** disponible, chaque session s'exécute dedans. Quand vous avez plus d'un environnement, les sessions en choisissent un par surface :43Avec seulement **Default** disponible, chaque session s'exécute dedans. Quand vous avez plus d'un environnement, les sessions en choisissent un par surface :

198 198 

199## Accès réseau199## Accès réseau

200 200 

201Chaque environnement définit un niveau d'accès réseau, qui contrôle les connexions sortantes que ses sessions peuvent établir. Le niveau par défaut, **Trusted**, autorise les registres de paquets et autres [domaines autorisés](#default-allowed-domains) ; **Custom** utilise votre propre liste de domaines.201Chaque environnement définit un niveau d'accès réseau, qui contrôle les connexions sortantes que ses sessions peuvent établir. Un nouvel environnement démarre au niveau **Limited** avec **Allow package managers** coché, de sorte que ses sessions atteignent les registres de paquets et autres [domaines autorisés](#default-allowed-domains).

202 202 

203Pour modifier l'accès réseau d'un environnement, [ouvrez-le pour l'édition](#configure-your-environment) et utilisez le sélecteur **Network access** dans la boîte de dialogue. Un [environnement partagé](#organization-shared-environments) s'ouvre en lecture seule là, donc un propriétaire modifie son accès réseau à partir de la page **Cloud environments** dans les [paramètres d'administration](https://claude.ai/admin-settings) à la place. Le contrôle qui ouvre le sélecteur apparaît sur les surfaces de l'application listées sous [The Default environment](#the-default-environment) et dans l'[éditeur de tâches planifiées cloud](https://code.claude.com/docs/fr/routines.md#environments-and-network-access). Les environnements personnels n'ont pas de page séparée dans les paramètres de votre compte claude.ai.203Pour modifier l'accès réseau d'un environnement, [ouvrez-le pour l'édition](#configure-your-environment) et utilisez le sélecteur **Network access** dans la boîte de dialogue. Un [environnement partagé](#organization-shared-environments) s'ouvre en lecture seule là, donc un propriétaire modifie son accès réseau à partir de la page **Cloud environments** dans les [paramètres d'administration](https://claude.ai/admin-settings) à la place. Le contrôle qui ouvre le sélecteur apparaît sur les surfaces de l'application listées sous [The Default environment](#the-default-environment) et dans l'[éditeur de tâches planifiées cloud](https://code.claude.com/docs/fr/routines.md#environments-and-network-access). Les environnements personnels n'ont pas de page séparée dans les paramètres de votre compte claude.ai.

204 204 

210 210 

211### Niveaux d'accès211### Niveaux d'accès

212 212 

213Le champ **Network access** dans la [boîte de dialogue d'environnement](#configure-your-environment) prend l'un des quatre niveaux suivants :213Le champ **Network access** dans la [boîte de dialogue d'environnement](#configure-your-environment) prend l'un des trois niveaux suivants :

214 214 

215| Niveau | Connexions sortantes |215| Niveau | Connexions sortantes |

216| :- | :- |216| :- | :- |

217| **None** | Aucun accès réseau sortant via le réseau de la session |217| **None** | Aucun accès réseau sortant via le réseau de la session |

218| **Trusted** | [Domaines autorisés](#default-allowed-domains) uniquement : registres de paquets, GitHub, SDK cloud |218| **Limited** | La [liste d'autorisation par défaut](#default-allowed-domains) des registres de paquets, de GitHub et des SDK cloud tant que **Allow package managers** est coché, plus les [domaines que vous listez](#allow-specific-domains). Voir [à quoi ressemble une requête bloquée](https://code.claude.com/docs/fr/errors.md#host-not-allowed-in-a-cloud-session). |

219| **Full** | N'importe quel domaine |219| **Full** | N'importe quel domaine |

220| **Custom** | Votre propre liste d'autorisation, incluant optionnellement les domaines par défaut |

221 220 

222Quel que soit le niveau que vous choisissez, les sessions peuvent toujours atteindre ceux-ci, car chacun emprunte un chemin qui ne passe pas par la liste d'autorisation réseau de la session :221Quel que soit le niveau que vous choisissez, les sessions peuvent toujours atteindre ceux-ci, car chacun emprunte un chemin qui ne passe pas par la liste d'autorisation réseau de la session :

223 222 

226* Les hôtes que vous avez listés sur les [secrets réseau](#add-network-secrets) de l'environnement, sauf les [hôtes qui ne reçoivent jamais le secret](#requests-that-never-get-the-credential)225* Les hôtes que vous avez listés sur les [secrets réseau](#add-network-secrets) de l'environnement, sauf les [hôtes qui ne reçoivent jamais le secret](#requests-that-never-get-the-credential)

227* L'API Anthropic, pour les propres requêtes de Claude Code, même au niveau **None**, comme noté sous [Security and isolation](https://code.claude.com/docs/fr/claude-code-on-the-web.md#security-and-isolation)226* L'API Anthropic, pour les propres requêtes de Claude Code, même au niveau **None**, comme noté sous [Security and isolation](https://code.claude.com/docs/fr/claude-code-on-the-web.md#security-and-isolation)

228 227 

228Un environnement enregistré en tant que **Trusted** ou **Custom** continue d'atteindre les mêmes hôtes et s'ouvre ainsi :

229 

230* **Enregistré en tant que Trusted** : s'ouvre au niveau **Limited** avec **Allow package managers** coché

231* **Enregistré en tant que Custom** : s'ouvre au niveau **Limited** avec sa liste **Allowed domains** et **Allow package managers** tels que vous les avez définis, ou au niveau **Full** si la liste contenait un `*` seul

232 

229### Autoriser des domaines spécifiques233### Autoriser des domaines spécifiques

230 234 

231Pour autoriser des domaines qui ne figurent pas dans la liste Trusted, sélectionnez **Custom** dans les paramètres d'accès réseau de l'environnement, puis listez un domaine par ligne dans le champ **Allowed domains**. Cet exemple autorise trois hôtes qu'un projet interne pourrait nécessiter.235Pour autoriser des domaines qui ne figurent pas dans la [liste d'autorisation par défaut](#default-allowed-domains), sélectionnez **Limited** dans le sélecteur **Network access** de l'environnement, puis listez un domaine par ligne dans le champ **Allowed domains**. Un `*.` au début correspond à tous les sous-domaines. Cet exemple autorise trois hôtes qu'un projet interne pourrait nécessiter.

232 236 

233```text theme={null}237```text theme={null}

234api.example.com238api.example.com

236registry.example.com240registry.example.com

237```241```

238 242 

239Les sessions dans cet environnement peuvent maintenant atteindre `api.example.com`, n'importe quel sous-domaine de `internal.example.com`, et `registry.example.com`, et aucun autre domaine via le réseau de la session. Le [trafic GitHub](#github-proxy), le [trafic des connecteurs MCP](#network-access), et les requêtes vers les hôtes des [secrets réseau](#add-network-secrets) de l'environnement, autres que les [hôtes qui ne reçoivent jamais le secret](#requests-that-never-get-the-credential), ne passent pas par cette liste d'autorisation. Un `*.` au début correspond à tous les sous-domaines. Pour conserver également les [domaines Trusted](#default-allowed-domains), cochez **Also include default list of common package managers** ; laissez-le décoché pour autoriser uniquement ce que vous listez.243Tant que **Allow package managers** est coché, les sessions dans cet environnement atteignent la [liste d'autorisation par défaut](#default-allowed-domains) ainsi que les domaines que vous listez. Décochez la case pour exclure la liste d'autorisation par défaut. Le [trafic GitHub](#github-proxy), le [trafic des connecteurs MCP](#network-access), et les requêtes vers les hôtes des [secrets réseau](#add-network-secrets) de l'environnement, autres que les [hôtes qui ne reçoivent jamais le secret](#requests-that-never-get-the-credential), ne passent pas par cette liste d'autorisation.

240 244 

241Si votre organisation utilise les [artifacts](https://code.claude.com/docs/fr/artifacts.md#availability), vous n'avez pas besoin de `*.frame.claudeusercontent.com` dans la liste pour que les sessions les lisent. Lorsque la liste omet cet hôte, Claude Code lit le contenu des artifacts via la connexion de la session à Anthropic à la place. Conservez l'hôte dans une liste d'autorisation dans deux situations :245Si votre organisation utilise les [artifacts](https://code.claude.com/docs/fr/artifacts.md#availability), vous n'avez pas besoin de `*.frame.claudeusercontent.com` dans la liste pour que les sessions les lisent. Lorsque la liste omet cet hôte, Claude Code lit le contenu des artifacts via la connexion de la session à Anthropic à la place. Conservez l'hôte dans une liste d'autorisation dans deux situations :

242 246 

243* **Les sessions dans cet environnement ouvrent les artifacts publics d'une autre organisation** : Claude Code les récupère directement depuis l'hôte, donc ajoutez-le à cette liste.247* **Les sessions dans cet environnement ouvrent les artifacts publics d'une autre organisation** : Claude Code les récupère directement depuis l'hôte, donc ajoutez-le à cette liste.

244* **Vous configurez le CLI local ou un runner auto-hébergé** : conservez l'hôte dans cette liste d'autorisation. Voir [network access requirements](https://code.claude.com/docs/fr/network-config.md#network-access-requirements) et les [network requirements](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#network-requirements) auto-hébergées.248* **Vous configurez le CLI local ou un runner auto-hébergé** : conservez l'hôte dans cette liste d'autorisation. Voir [network access requirements](https://code.claude.com/docs/fr/network-config.md#network-access-requirements) et les [network requirements](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#network-requirements) auto-hébergées.

245 249 

246Chaque environnement a sa propre liste de domaines autorisés ; il n'y a pas de liste d'autorisation au niveau de l'organisation que les administrateurs peuvent pousser aux environnements de chaque membre. Aucun [paramètre géré par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md) n'ajoute de domaines à la liste d'autorisation réseau d'un environnement non plus. Pour donner à une équipe une liste standard, un propriétaire peut créer un [environnement partagé au niveau de l'organisation](#organization-shared-environments) avec un accès réseau **Custom** et cette liste.250Chaque environnement a sa propre liste de domaines autorisés ; il n'y a pas de liste d'autorisation au niveau de l'organisation que les administrateurs peuvent pousser aux environnements de chaque membre. Aucun [paramètre géré par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md) n'ajoute de domaines à la liste d'autorisation réseau d'un environnement non plus. Pour donner à une équipe une liste standard, un propriétaire peut créer un [environnement partagé au niveau de l'organisation](#organization-shared-environments) avec un accès réseau **Limited** et cette liste.

247 251 

248### Proxy GitHub252### Proxy GitHub

249 253 

255* **Portée du dépôt** : le proxy sert les requêtes API GitHub pour les dépôts attachés à la session. Une requête API pour un autre dépôt reçoit un 403 dont le message commence par `GitHub access to` et contient `is not enabled for this session`. Une archive source que vous récupérez via une URL `github.com/{owner}/{repo}/archive/` ou `codeload.github.com` reçoit ce même 403 lorsque le dépôt n'est pas attaché, même s'il est public.259* **Portée du dépôt** : le proxy sert les requêtes API GitHub pour les dépôts attachés à la session. Une requête API pour un autre dépôt reçoit un 403 dont le message commence par `GitHub access to` et contient `is not enabled for this session`. Une archive source que vous récupérez via une URL `github.com/{owner}/{repo}/archive/` ou `codeload.github.com` reçoit ce même 403 lorsque le dépôt n'est pas attaché, même s'il est public.

256* **Restrictions GraphQL** : le proxy rejette les requêtes vers l'endpoint GraphQL de GitHub avec un 403 dont le message commence par `GitHub GraphQL is not available from Claude Code sessions` et nomme la solution de repli REST, `gh api repos/{owner}/{repo}/...`. Les sous-commandes `gh` qui utilisent GraphQL, comme `gh pr` et `gh issue`, reçoivent le même 403. La restriction s'applique à chaque requête via le proxy quels que soient les identifiants que vous fournissez, donc un `GH_TOKEN` que vous définissez reçoit le même 403. Claude ne peut pas atteindre les API GitHub qui n'existent que dans GraphQL, comme Projects v2, via le proxy.260* **Restrictions GraphQL** : le proxy rejette les requêtes vers l'endpoint GraphQL de GitHub avec un 403 dont le message commence par `GitHub GraphQL is not available from Claude Code sessions` et nomme la solution de repli REST, `gh api repos/{owner}/{repo}/...`. Les sous-commandes `gh` qui utilisent GraphQL, comme `gh pr` et `gh issue`, reçoivent le même 403. La restriction s'applique à chaque requête via le proxy quels que soient les identifiants que vous fournissez, donc un `GH_TOKEN` que vous définissez reçoit le même 403. Claude ne peut pas atteindre les API GitHub qui n'existent que dans GraphQL, comme Projects v2, via le proxy.

257 261 

258Les fichiers validés des référentiels publics arrivent via `raw.githubusercontent.com`, que le [proxy de sécurité](#security-proxy) gère à la place. Ce domaine figure dans la liste [Trusted](#default-allowed-domains) par défaut, donc ces fichiers restent accessibles sauf si le [niveau d'accès](#access-levels) de l'environnement l'exclut.262Les fichiers validés des dépôts publics arrivent via `raw.githubusercontent.com`, que le [proxy de sécurité](#security-proxy) gère à la place. Ce domaine figure dans la [liste d'autorisation par défaut](#default-allowed-domains), donc ces fichiers restent accessibles tant que l'[accès réseau](#access-levels) de l'environnement autorise cette liste.

259 263 

260### Proxy de sécurité264### Proxy de sécurité

261 265 

391service redis-server start395service redis-server start

392```396```

393 397 

394Docker est disponible pour exécuter des services conteneurisés. Demandez à Claude d'exécuter `docker compose up` pour démarrer les services de votre projet. L'accès réseau pour extraire les images suit le [niveau d'accès](#access-levels) de votre environnement, et les [défauts Trusted](#default-allowed-domains) incluent Docker Hub et d'autres registres courants.398Docker est disponible pour exécuter des services conteneurisés. Demandez à Claude d'exécuter `docker compose up` pour démarrer les services de votre projet. L'accès réseau pour extraire les images suit le [niveau d'accès](#access-levels) de votre environnement, et la [liste d'autorisation par défaut](#default-allowed-domains) inclut Docker Hub et d'autres registres courants.

395 399 

396Si vos images sont grandes ou lentes à extraire, ajoutez `docker compose pull` ou `docker compose build` à votre [script de configuration](#setup-scripts). Le [cache d'environnement](#environment-caching) conserve les images extraites, donc chaque nouvelle session les a sur le disque. Le cache stocke seulement les fichiers, pas les processus en cours d'exécution, donc Claude démarre toujours les conteneurs à chaque session.400Si vos images sont grandes ou lentes à extraire, ajoutez `docker compose pull` ou `docker compose build` à votre [script de configuration](#setup-scripts). Le [cache d'environnement](#environment-caching) conserve les images extraites, donc chaque nouvelle session les a sur le disque. Le cache stocke seulement les fichiers, pas les processus en cours d'exécution, donc Claude démarre toujours les conteneurs à chaque session.

397 401 

445 449 

446* **Quitter zéro** : si le script quitte avec un code non nul, la session [ne parvient pas à démarrer](https://code.claude.com/docs/fr/web-quickstart.md#setup-script-failed) ou démarre sans ce que le script n'a pas réussi à installer. Ajoutez `|| true` aux commandes non critiques afin qu'une défaillance d'installation intermittente ne fasse pas échouer le script.450* **Quitter zéro** : si le script quitte avec un code non nul, la session [ne parvient pas à démarrer](https://code.claude.com/docs/fr/web-quickstart.md#setup-script-failed) ou démarre sans ce que le script n'a pas réussi à installer. Ajoutez `|| true` aux commandes non critiques afin qu'une défaillance d'installation intermittente ne fasse pas échouer le script.

447* **Terminer en cinq minutes** : gardez le temps d'exécution total du script sous environ cinq minutes afin que le [cache d'environnement](#environment-caching) puisse se construire. Quand la configuration prend plus de temps que cela, l'environnement n'est pas mis en cache. Exécutez les installations indépendantes en parallèle avec `&` et `wait`, et déplacez tout téléchargement unique qui ne rentre pas dans un crochet [SessionStart](#setup-scripts-vs-sessionstart-hooks) qui le lance en arrière-plan. Si les nouvelles sessions se figent ou échouent pendant la configuration, consultez [Les nouvelles sessions se figent ou expirent pendant la configuration](https://code.claude.com/docs/fr/web-quickstart.md#new-sessions-hang-or-time-out-during-setup).451* **Terminer en cinq minutes** : gardez le temps d'exécution total du script sous environ cinq minutes afin que le [cache d'environnement](#environment-caching) puisse se construire. Quand la configuration prend plus de temps que cela, l'environnement n'est pas mis en cache. Exécutez les installations indépendantes en parallèle avec `&` et `wait`, et déplacez tout téléchargement unique qui ne rentre pas dans un crochet [SessionStart](#setup-scripts-vs-sessionstart-hooks) qui le lance en arrière-plan. Si les nouvelles sessions se figent ou échouent pendant la configuration, consultez [Les nouvelles sessions se figent ou expirent pendant la configuration](https://code.claude.com/docs/fr/web-quickstart.md#new-sessions-hang-or-time-out-during-setup).

448* **Accès réseau pour les installations** : les installations de paquets doivent atteindre les registres. Le niveau **Trusted** par défaut couvre les [registres de paquets courants](#default-allowed-domains) incluant npm, PyPI, RubyGems et crates.io ; avec un accès réseau **None**, les installations échouent.452* **Accès réseau pour les installations** : les installations de paquets doivent atteindre les registres. Le niveau **Limited** par défaut, avec **Allow package managers** coché, couvre les [registres de paquets courants](#default-allowed-domains) incluant npm, PyPI, RubyGems et crates.io. Avec un accès réseau **None**, les installations échouent.

449* **Les variables de l'environnement ne sont pas encore définies** : le script s'exécute avant que la session ne définisse les [variables d'environnement](#set-environment-variables) de l'environnement. Définissez toute valeur dont le script a besoin dans le script lui-même.453* **Les variables de l'environnement ne sont pas encore définies** : le script s'exécute avant que la session ne définisse les [variables d'environnement](#set-environment-variables) de l'environnement. Définissez toute valeur dont le script a besoin dans le script lui-même.

450 454 

451### Mise en cache d'environnement455### Mise en cache d'environnement

541* **Un dépôt par session** : dans un environnement hébergé par Anthropic, une session avec plusieurs dépôts ne charge pas les hooks du `.claude/settings.json` d'aucun dépôt, donc un hook SessionStart que vous définissez là ne s'exécute pas. Installez les dépendances pour ces sessions avec un [script de configuration](#setup-scripts) à la place. Pour un environnement auto-hébergé, consultez [les paramètres de quel dépôt s'appliquent](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories).545* **Un dépôt par session** : dans un environnement hébergé par Anthropic, une session avec plusieurs dépôts ne charge pas les hooks du `.claude/settings.json` d'aucun dépôt, donc un hook SessionStart que vous définissez là ne s'exécute pas. Installez les dépendances pour ces sessions avec un [script de configuration](#setup-scripts) à la place. Pour un environnement auto-hébergé, consultez [les paramètres de quel dépôt s'appliquent](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories).

542* **Pas dans les threads cloud d'un projet** : un thread cloud dans un [projet](https://code.claude.com/docs/fr/claude-projects.md#what-threads-pick-up-from-your-repositories) n'exécute pas les hooks du `.claude/settings.json` d'un dépôt, quel que soit le nombre de dépôts. Dans un environnement hébergé par Anthropic, installez les dépendances pour les threads avec un [script de configuration](#setup-scripts). Dans un environnement auto-hébergé, utilisez plutôt un hook dans les [paramètres de l'hôte d'exécuteur](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories).546* **Pas dans les threads cloud d'un projet** : un thread cloud dans un [projet](https://code.claude.com/docs/fr/claude-projects.md#what-threads-pick-up-from-your-repositories) n'exécute pas les hooks du `.claude/settings.json` d'un dépôt, quel que soit le nombre de dépôts. Dans un environnement hébergé par Anthropic, installez les dépendances pour les threads avec un [script de configuration](#setup-scripts). Dans un environnement auto-hébergé, utilisez plutôt un hook dans les [paramètres de l'hôte d'exécuteur](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories).

543* **Pas de limitation au cloud uniquement** : les crochets s'exécutent dans les sessions locales et cloud. Pour ignorer l'exécution locale, quittez tôt sauf si la variable d'environnement `CLAUDE_CODE_REMOTE` est `true`, de la même manière que le [script d'installation de dépendances](#install-dependencies-with-a-sessionstart-hook) le fait.547* **Pas de limitation au cloud uniquement** : les crochets s'exécutent dans les sessions locales et cloud. Pour ignorer l'exécution locale, quittez tôt sauf si la variable d'environnement `CLAUDE_CODE_REMOTE` est `true`, de la même manière que le [script d'installation de dépendances](#install-dependencies-with-a-sessionstart-hook) le fait.

544* **Nécessite un accès réseau** : les commandes d'installation doivent atteindre les registres de paquets. Si votre environnement utilise un accès réseau **None**, ces crochets échouent. La [liste d'autorisation par défaut](#default-allowed-domains) sous **Trusted** couvre npm, PyPI, RubyGems et crates.io.548* **Nécessite un accès réseau** : les commandes d'installation doivent atteindre les registres de paquets. Si votre environnement utilise un accès réseau **None**, ces hooks échouent. Avec le niveau **Limited** par défaut et **Allow package managers** coché, la [liste d'autorisation par défaut](#default-allowed-domains) couvre npm, PyPI, RubyGems et crates.io.

545* **Compatibilité proxy** : dans les environnements hébergés par Anthropic, tout le trafic sortant passe par un [proxy de sécurité](#security-proxy), et certains gestionnaires de paquets ne fonctionnent pas correctement avec lui ; Bun est un exemple connu. Dans un [environnement auto-hébergé](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#default-deny-egress), le trafic sortant va via votre propre limite réseau à la place.549* **Compatibilité proxy** : dans les environnements hébergés par Anthropic, tout le trafic sortant passe par un [proxy de sécurité](#security-proxy), et certains gestionnaires de paquets ne fonctionnent pas correctement avec lui ; Bun est un exemple connu. Dans un [environnement auto-hébergé](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#default-deny-egress), le trafic sortant va via votre propre limite réseau à la place.

546* **Ajoute une latence de démarrage** : les hooks s'exécutent chaque fois qu'une session démarre ou reprend, contrairement aux scripts de configuration qui bénéficient de la [mise en cache d'environnement](#environment-caching). Gardez les scripts d'installation rapides en ignorant le travail déjà effectué, de la même manière que le [script d'installation de dépendances](#install-dependencies-with-a-sessionstart-hook) le fait.550* **Ajoute une latence de démarrage** : les hooks s'exécutent chaque fois qu'une session démarre ou reprend, contrairement aux scripts de configuration qui bénéficient de la [mise en cache d'environnement](#environment-caching). Gardez les scripts d'installation rapides en ignorant le travail déjà effectué, de la même manière que le [script d'installation de dépendances](#install-dependencies-with-a-sessionstart-hook) le fait.

547 551 

549 553 

550## Domaines autorisés par défaut554## Domaines autorisés par défaut

551 555 

552Avec un accès réseau **Trusted**, les sessions peuvent atteindre les domaines suivants par défaut. Les domaines marqués avec `*` indiquent une correspondance de sous-domaine générique, donc `*.gcr.io` autorise n'importe quel sous-domaine de `gcr.io`.556Lorsque l'option **Allow package managers** est cochée sous l'accès réseau **Limited**, comme c'est le cas dans un nouvel environnement, les sessions peuvent atteindre les domaines suivants. Les domaines marqués avec `*` indiquent une correspondance de sous-domaine générique, donc `*.gcr.io` autorise n'importe quel sous-domaine de `gcr.io`.

553 557 

554> [accordion] Services Anthropic558> [accordion] Services Anthropic

555>559>

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

66| `/cd <path>` | Déplacer cette session vers un nouveau répertoire de travail, en conservant la conversation. Saisissez un chemin partiel pour voir les suggestions de répertoires correspondants ; appuyez sur `Tab` pour en accepter une. Pour savoir ce que Claude Code applique depuis le nouveau répertoire dès que vous vous déplacez, et en quoi `/cd` diffère de `/add-dir`, consultez [Déplacer la session vers un autre répertoire](https://code.claude.com/docs/fr/permissions.md#move-the-session-to-another-directory) |66| `/cd <path>` | Déplacer cette session vers un nouveau répertoire de travail, en conservant la conversation. Saisissez un chemin partiel pour voir les suggestions de répertoires correspondants ; appuyez sur `Tab` pour en accepter une. Pour savoir ce que Claude Code applique depuis le nouveau répertoire dès que vous vous déplacez, et en quoi `/cd` diffère de `/add-dir`, consultez [Déplacer la session vers un autre répertoire](https://code.claude.com/docs/fr/permissions.md#move-the-session-to-another-directory) |

67| `/chrome` | Configurer les paramètres de [Claude in Chrome](https://code.claude.com/docs/fr/chrome.md) |67| `/chrome` | Configurer les paramètres de [Claude in Chrome](https://code.claude.com/docs/fr/chrome.md) |

68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Charger la documentation de référence de l'[API Claude](https://platform.claude.com/docs/en/api/overview) et de [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) pour le langage de votre projet. S'active aussi automatiquement lorsque votre code importe `anthropic` ou `@anthropic-ai/sdk`. Pour savoir ce que fait chaque sous-commande et la version qu'elle nécessite, consultez [Travailler sur des projets utilisant l'API Claude](https://code.claude.com/docs/fr/skills.md#work-on-claude-api-projects) |68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|latency-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Charger la documentation de référence de l'[API Claude](https://platform.claude.com/docs/en/api/overview) et de [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) pour le langage de votre projet. S'active aussi automatiquement lorsque votre code importe `anthropic` ou `@anthropic-ai/sdk`. Pour savoir ce que fait chaque sous-commande et la version qu'elle nécessite, consultez [Travailler sur des projets utilisant l'API Claude](https://code.claude.com/docs/fr/skills.md#work-on-claude-api-projects) |

69| `/claude-in-chrome [task]` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Demander à Claude d'effectuer une tâche dans votre navigateur, comme tester une page, remplir un formulaire ou lire les logs de la console, via [Claude in Chrome](https://code.claude.com/docs/fr/chrome.md). Disponible lorsque l'intégration Chrome est activée pour la session, par exemple avec `claude --chrome`, ou lorsque Claude Code peut proposer d'[installer l'extension](https://code.claude.com/docs/fr/chrome.md#install-the-extension-when-claude-asks) |69| `/claude-in-chrome [task]` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Demander à Claude d'effectuer une tâche dans votre navigateur, comme tester une page, remplir un formulaire ou lire les logs de la console, via [Claude in Chrome](https://code.claude.com/docs/fr/chrome.md). Disponible lorsque l'intégration Chrome est activée pour la session, par exemple avec `claude --chrome`, ou lorsque Claude Code peut proposer d'[installer l'extension](https://code.claude.com/docs/fr/chrome.md#install-the-extension-when-claude-asks) |

70| `/clear [name]` | Démarrer une nouvelle conversation avec un contexte vide. Passez un nom pour étiqueter la conversation précédente dans le sélecteur `/resume`. Pour libérer du contexte tout en poursuivant la même conversation, utilisez plutôt `/compact`. Reprenez la conversation précédente avec `/resume`, ou, dans le même processus Claude Code, restaurez-la depuis [l'entrée de session précédente du menu de rembobinage](https://code.claude.com/docs/fr/checkpointing.md#rewind-past-a-cleared-conversation). Alias : `/reset`, `/new` |70| `/clear [name]` | Démarrer une nouvelle conversation avec un contexte vide. Passez un nom pour étiqueter la conversation précédente dans le sélecteur `/resume`. Pour libérer du contexte tout en poursuivant la même conversation, utilisez plutôt `/compact`. Reprenez la conversation précédente avec `/resume`, ou, dans le même processus Claude Code, restaurez-la depuis [l'entrée de session précédente du menu de rembobinage](https://code.claude.com/docs/fr/checkpointing.md#rewind-past-a-cleared-conversation). Alias : `/reset`, `/new` |

71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Examiner le diff actuel, ou un numéro de PR, une branche ou un chemin que vous passez, à la recherche de bugs de correction. Selon votre modèle et votre niveau d'effort, la revue couvre aussi les opportunités de nettoyage. Passez `--fix` pour que Claude applique les résultats, `--comment` pour les publier sur la PR GitHub ou la merge request GitLab, ou `ultra` pour lancer une [revue cloud](https://code.claude.com/docs/fr/ultrareview.md) approfondie. La publication sur une merge request GitLab nécessite Claude Code v2.1.257 ou ultérieure. Avec `ultra` sur une PR cible `github.com`, passez `--post` pour présélectionner la [publication des résultats finaux sur la PR](https://code.claude.com/docs/fr/ultrareview.md#post-findings-to-the-pull-request) dans la boîte de dialogue de lancement ; `--post` nécessite Claude Code v2.1.227 ou ultérieure. Consultez [Effectuer une revue locale avec `/code-review`](https://code.claude.com/docs/fr/code-review-local) pour les niveaux d'effort, le ciblage et le lien avec `/simplify`. Alias : `/review` |71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Examiner le diff actuel, ou un numéro de PR, une branche ou un chemin que vous passez, à la recherche de bugs de correction. Selon votre modèle et votre niveau d'effort, la revue couvre aussi les opportunités de nettoyage. Passez `--fix` pour que Claude applique les résultats, `--comment` pour les publier sur la PR GitHub ou la merge request GitLab, ou `ultra` pour lancer une [revue cloud](https://code.claude.com/docs/fr/ultrareview.md) approfondie. La publication sur une merge request GitLab nécessite Claude Code v2.1.257 ou ultérieure. Avec `ultra` sur une PR cible `github.com`, passez `--post` pour présélectionner la [publication des résultats finaux sur la PR](https://code.claude.com/docs/fr/ultrareview.md#post-findings-to-the-pull-request) dans la boîte de dialogue de lancement ; `--post` nécessite Claude Code v2.1.227 ou ultérieure. Consultez [Effectuer une revue locale avec `/code-review`](https://code.claude.com/docs/fr/code-review-local) pour les niveaux d'effort, le ciblage et le lien avec `/simplify`. Alias : `/review` |

466claude --worktree feature-auth466claude --worktree feature-auth

467```467```

468 468 

469Exécutez la même commande avec un nom différent dans un deuxième terminal pour démarrer une session parallèle isolée. Dans un référentiel sans commits, la commande échoue avec `Failed to resolve base branch "HEAD": git rev-parse failed`. Consultez [Worktrees](https://code.claude.com/docs/fr/worktrees.md) pour le nettoyage, `.worktreeinclude` et le support VCS non-git. Pour surveiller les sessions parallèles à partir d'un seul écran au lieu de terminaux séparés, consultez [agents en arrière-plan](https://code.claude.com/docs/fr/agent-view.md).469Exécutez la même commande avec un nom différent dans un deuxième terminal pour démarrer une session parallèle isolée. Consultez [Worktrees](https://code.claude.com/docs/fr/worktrees.md) pour le nettoyage, `.worktreeinclude` et le support VCS non-git. Pour surveiller les sessions parallèles à partir d'un seul écran au lieu de terminaux séparés, consultez [agents en arrière-plan](https://code.claude.com/docs/fr/agent-view.md).

470 470 

471## Planifier avant de modifier471## Planifier avant de modifier

472 472 

19 19 

20## Ce qui survit à la compaction20## Ce qui survit à la compaction

21 21 

22Quand une longue session se compacte, Claude Code résume l'historique de la conversation pour l'adapter à la fenêtre de contexte. À partir de la v2.1.198, la requête de résumé hérite de la configuration de [réflexion étendue](https://code.claude.com/docs/fr/model-config.md#extended-thinking) de votre session, de sorte qu'elle raisonne avec la réflexion activée quand votre session l'a activée et reste désactivée sinon. La réflexion affecte uniquement la façon dont le résumé est produit ; vos paramètres de session restent inchangés après. Ce qui arrive à chaque type de contenu dépend de la façon dont il a été chargé :22Quand une longue session se compacte, Claude Code résume l'historique de la conversation pour l'adapter à la fenêtre de contexte.

23 23 

24| Mécanisme | Après compaction |24| Mécanisme | Après compaction |

25| :- | :- |25| :- | :- |

243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Définissez sur `1` pour désactiver les [skills](https://code.claude.com/docs/fr/skills.md) 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`](https://code.claude.com/docs/fr/settings-reference#disablebundledskills) |243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Définissez sur `1` pour désactiver les [skills](https://code.claude.com/docs/fr/skills.md) 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`](https://code.claude.com/docs/fr/settings-reference#disablebundledskills) |

244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Pour les hôtes qui intègrent Claude Code et fournissent leurs propres instructions de navigation. Définissez sur `1` pour conserver les outils de navigateur [Claude in Chrome](https://code.claude.com/docs/fr/chrome.md) tout en omettant la section Chrome du prompt système et le [skill fourni](https://code.claude.com/docs/fr/skills.md#bundled-skills) `/claude-in-chrome`. Dans VS Code, l'extension en v2.1.314 ou ultérieure exclut aussi les instructions Claude in Chrome des messages d'une session. Nécessite Claude Code v2.1.257 ou ultérieur |244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Pour les hôtes qui intègrent Claude Code et fournissent leurs propres instructions de navigation. Définissez sur `1` pour conserver les outils de navigateur [Claude in Chrome](https://code.claude.com/docs/fr/chrome.md) tout en omettant la section Chrome du prompt système et le [skill fourni](https://code.claude.com/docs/fr/skills.md#bundled-skills) `/claude-in-chrome`. Dans VS Code, l'extension en v2.1.314 ou ultérieure exclut aussi les instructions Claude in Chrome des messages d'une session. Nécessite Claude Code v2.1.257 ou ultérieur |

245| `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 |245| `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 |

246| `CLAUDE_CODE_DISABLE_CRON` | Définissez sur `1` pour désactiver les [tâches planifiées à l'échelle de la session](https://code.claude.com/docs/fr/scheduled-tasks.md). 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 milieu de session |246| `CLAUDE_CODE_DISABLE_CRON` | Définissez sur `1` pour désactiver les [tâches planifiées limitées à la session](https://code.claude.com/docs/fr/scheduled-tasks.md#disable-scheduled-tasks). Le skill `/loop` et `CronCreate` deviennent indisponibles et toutes les tâches déjà planifiées cessent de se déclencher, y compris les tâches déjà en cours d'exécution au milieu de la session |

247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Définissez sur `1` pour désactiver la [limite de temps et les refus](https://code.claude.com/docs/fr/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes) des modes `auto` et `bypassPermissions` sur les suppressions de chemins critiques. Ces suppressions sont alors transmises au classifieur en mode `auto`, et font l'objet d'une demande sans limite de temps en mode `bypassPermissions` partout où Claude Code peut en afficher une. 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 |247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Définissez sur `1` pour désactiver la [limite de temps et les refus](https://code.claude.com/docs/fr/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes) des modes `auto` et `bypassPermissions` sur les suppressions de chemins critiques. Ces suppressions sont alors transmises au classifieur en mode `auto`, et font l'objet d'une demande sans limite de temps en mode `bypassPermissions` partout où Claude Code peut en afficher une. 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 |

248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Définissez sur `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 cette option 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](https://code.claude.com/docs/fr/llm-gateway-protocol.md#disable-pre-release-capabilities) liste ce que la variable supprime, y compris la [recherche d'outils MCP](https://code.claude.com/docs/fr/mcp.md#scale-with-mcp-tool-search), et ce que Claude Code continue d'envoyer |248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Définissez sur `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 cette option 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](https://code.claude.com/docs/fr/llm-gateway-protocol.md#disable-pre-release-capabilities) liste ce que la variable supprime, y compris la [recherche d'outils MCP](https://code.claude.com/docs/fr/mcp.md#scale-with-mcp-tool-search), et ce que Claude Code continue d'envoyer |

249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Définissez sur `1` pour désactiver les [sous-agents Explore et Plan](https://code.claude.com/docs/fr/sub-agents.md#built-in-subagents) intégrés. Claude explore alors avec ses outils de recherche ou le sous-agent général, et le [mode plan](https://code.claude.com/docs/fr/permission-modes.md#analyze-before-you-edit-with-plan-mode) lit directement les fichiers 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 |249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Définissez sur `1` pour désactiver les [sous-agents Explore et Plan](https://code.claude.com/docs/fr/sub-agents.md#built-in-subagents) intégrés. Claude explore alors avec ses outils de recherche ou le sous-agent général, et le [mode plan](https://code.claude.com/docs/fr/permission-modes.md#analyze-before-you-edit-with-plan-mode) lit directement les fichiers 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 |

250| `CLAUDE_CODE_DISABLE_FAST_MODE` | Définissez sur `1` pour désactiver le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) |250| `CLAUDE_CODE_DISABLE_FAST_MODE` | Définissez sur `1` pour désactiver le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) |

251| `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` | Définissez sur `1` pour désactiver la récupération des feature flags. Nécessite Claude Code v2.1.319 ou ultérieur. Lorsque cette variable est définie, [Remote Control](https://code.claude.com/docs/fr/remote-control.md#requirements) et les autres [fonctionnalités qui nécessitent la récupération des feature flags](#features-that-need-feature-flag-fetching) sont indisponibles. La journalisation des événements de télémétrie reste active, sauf si `DISABLE_TELEMETRY` est également définie. L'ancien nom, `DISABLE_GROWTHBOOK`, fonctionne toujours, et c'est le seul que lisent les versions v2.1.124 à v2.1.318 |

251| `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 aussi 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 plutôt que de les désactiver complètement, utilisez le paramètre [`feedbackSurveyRate`](https://code.claude.com/docs/fr/settings-reference#feedbacksurveyrate). Consultez [Enquêtes de qualité de session](https://code.claude.com/docs/fr/data-usage.md#session-quality-surveys) |252| `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 aussi 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 plutôt que de les désactiver complètement, utilisez le paramètre [`feedbackSurveyRate`](https://code.claude.com/docs/fr/settings-reference#feedbacksurveyrate). Consultez [Enquêtes de qualité de session](https://code.claude.com/docs/fr/data-usage.md#session-quality-surveys) |

252| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Définissez sur `1` pour désactiver le [checkpointing](https://code.claude.com/docs/fr/checkpointing.md) des fichiers. La commande `/rewind` ne pourra pas restaurer les modifications de code. Remplace le paramètre [`fileCheckpointingEnabled`](https://code.claude.com/docs/fr/settings-reference#filecheckpointingenabled) |253| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Définissez sur `1` pour désactiver le [checkpointing](https://code.claude.com/docs/fr/checkpointing.md) des fichiers. La commande `/rewind` ne pourra pas restaurer les modifications de code. Remplace le paramètre [`fileCheckpointingEnabled`](https://code.claude.com/docs/fr/settings-reference#filecheckpointingenabled) |

253| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | Définissez sur `1` pour empêcher Claude Code de développer les [mentions `@`](https://code.claude.com/docs/fr/common-workflows#reference-files-and-directories) de fichiers et de répertoires. Claude reçoit à la place les chemins mentionnés avec une note l'invitant à les lire à l'aide de ses outils de fichiers. Ignoré dans les [paramètres de projet et locaux](https://code.claude.com/docs/fr/settings-reference.md#variables-claude-code-ignores-in-env). Nécessite Claude Code v2.1.299 ou ultérieur |254| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | Définissez sur `1` pour empêcher Claude Code de développer les [mentions `@`](https://code.claude.com/docs/fr/common-workflows#reference-files-and-directories) de fichiers et de répertoires. Claude reçoit à la place les chemins mentionnés avec une note l'invitant à les lire à l'aide de ses outils de fichiers. Ignoré dans les [paramètres de projet et locaux](https://code.claude.com/docs/fr/settings-reference.md#variables-claude-code-ignores-in-env). Nécessite Claude Code v2.1.299 ou ultérieur |

451| `DISABLE_ERROR_REPORTING` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour refuser le signalement des erreurs. **La définir sur `0` ou `false` désactive quand même le signalement**, contrairement à la plupart des variables on/off ; supprimez la variable pour réactiver le signalement des erreurs |452| `DISABLE_ERROR_REPORTING` | Définissez sur n'importe quelle valeur non vide, comme `1`, pour refuser le signalement des erreurs. **La définir sur `0` ou `false` désactive quand même le signalement**, contrairement à la plupart des variables on/off ; supprimez la variable pour réactiver le signalement des erreurs |

452| `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 |453| `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 |

453| `DISABLE_FEEDBACK_COMMAND` | Définissez sur `1` pour désactiver la commande `/feedback` et les [retours rédigés par Claude](https://code.claude.com/docs/fr/tools-reference.md#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`, de sorte que la commande était désactivée sous tous ses noms. L'ancien nom `DISABLE_BUG_COMMAND` est également accepté |454| `DISABLE_FEEDBACK_COMMAND` | Définissez sur `1` pour désactiver la commande `/feedback` et les [retours rédigés par Claude](https://code.claude.com/docs/fr/tools-reference.md#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`, de sorte que la commande était désactivée sous tous ses noms. L'ancien nom `DISABLE_BUG_COMMAND` est également accepté |

454| `DISABLE_GROWTHBOOK` | Définissez sur `1` ou `true` pour désactiver la récupération des feature flags et utiliser les valeurs par défaut du code pour chaque flag. Cela rend [Remote Control](https://code.claude.com/docs/fr/remote-control.md#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éfinie |455| `DISABLE_GROWTHBOOK` | Définissez sur `1` pour désactiver la [récupération des feature flags](#features-that-need-feature-flag-fetching). Nécessite Claude Code v2.1.124 ou ultérieur. Remplacée par `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`, qui nécessite la v2.1.319 ou ultérieure : utilisez ce nouveau nom, sauf si une machine en v2.1.318 ou antérieure lit la configuration. Ce nom-ci fonctionne toujours |

455| `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 |456| `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 |

456| `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, Google Cloud's Agent Platform ou Microsoft Foundry) |457| `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, Google Cloud's Agent Platform ou Microsoft Foundry) |

457| `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) |458| `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) |

569 570 

570Claude 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 :571Claude 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 :

571 572 

572* 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ération573* Une session dans laquelle vous définissez `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`, `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

573* Une session sur un [fournisseur tiers](https://code.claude.com/docs/fr/third-party-integrations.md), 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`574* Une session sur un [fournisseur tiers](https://code.claude.com/docs/fr/third-party-integrations.md), 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`

574* Une session de [passerelle des applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway)575* Une session de [passerelle des applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway)

575 576 

576Lorsque la récupération est désactivée, vous ne pouvez pas :577Lorsque la récupération est désactivée, vous ne pouvez pas :

577 578 

578* Utiliser [Remote Control](https://code.claude.com/docs/fr/remote-control.md) 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](https://code.claude.com/docs/fr/remote-control.md#requirements)579* Utiliser [Remote Control](https://code.claude.com/docs/fr/remote-control.md) lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](#variables) est défini. Pour `DISABLE_TELEMETRY` et `DO_NOT_TRACK`, consultez les [prérequis de Remote Control](https://code.claude.com/docs/fr/remote-control.md#requirements)

579* [Envoyer des messages à des sessions au-delà de cette machine](https://code.claude.com/docs/fr/cross-session-messaging.md#message-sessions-on-other-machines) lorsque [Remote Control](https://code.claude.com/docs/fr/remote-control.md#requirements) n'est pas disponible. La messagerie entre sessions sur cette machine fonctionne lorsque la récupération est désactivée580* [Envoyer des messages à des sessions au-delà de cette machine](https://code.claude.com/docs/fr/cross-session-messaging.md#message-sessions-on-other-machines) lorsque [Remote Control](https://code.claude.com/docs/fr/remote-control.md#requirements) n'est pas disponible. La messagerie entre sessions sur cette machine fonctionne lorsque la récupération est désactivée

580* Exécuter [`claude import` ou la commande `/import`](https://code.claude.com/docs/fr/cli-reference#cli-commands)581* Exécuter [`claude import` ou la commande `/import`](https://code.claude.com/docs/fr/cli-reference#cli-commands)

581* Exécuter [`/skill-doctor`](https://code.claude.com/docs/fr/skills#find-unused-skills) ou ouvrir son rapport dans l'onglet **Stats** de `/plugin`582* Exécuter [`/skill-doctor`](https://code.claude.com/docs/fr/skills#find-unused-skills) ou ouvrir son rapport dans l'onglet **Stats** de `/plugin`

582* Exécuter [`/restart`](https://code.claude.com/docs/fr/commands) avec les forfaits Pro, Max et Ultra583* Exécuter [`/restart`](https://code.claude.com/docs/fr/commands) avec les forfaits Pro, Max et Ultra

583* Synchroniser les [skills](https://code.claude.com/docs/fr/skills.md#where-synced-skills-load) et les [plugins](https://code.claude.com/docs/fr/plugins/loading.md#synced-plugins) activés pour votre compte claude.ai dans vos sessions de terminal584* Synchroniser les [skills](https://code.claude.com/docs/fr/skills.md#where-synced-skills-load) et les [plugins](https://code.claude.com/docs/fr/plugins/loading.md#synced-plugins) activés pour votre compte claude.ai dans vos sessions de terminal

584* Activer le [mod You should know](https://code.claude.com/docs/fr/interactive-mode.md#you-should-know-suggestions)585* Activer le [mod You should know](https://code.claude.com/docs/fr/interactive-mode.md#you-should-know-suggestions)

585* Utiliser [l'outil advisor](https://code.claude.com/docs/fr/advisor.md#requirements)586* Utiliser [l'outil advisor](https://code.claude.com/docs/fr/advisor.md#requirements), sauf sur Claude Platform on AWS avec Claude Code v2.1.300 ou version ultérieure

586* Utiliser les [tâches MCP](https://code.claude.com/docs/fr/mcp.md#mcp-tasks-that-run-on-the-server)587* Utiliser les [tâches MCP](https://code.claude.com/docs/fr/mcp.md#mcp-tasks-that-run-on-the-server)

587* Lire les [commentaires sur un artefact](https://code.claude.com/docs/fr/artifacts.md#collect-comments-on-an-artifact) ou y répondre588* Lire les [commentaires sur un artefact](https://code.claude.com/docs/fr/artifacts.md#collect-comments-on-an-artifact) ou y répondre

588* Demander à Claude de lire [l'artefact public d'une autre organisation](https://code.claude.com/docs/fr/artifacts.md#read-an-artifact-shared-with-you)589* Demander à Claude de lire [l'artefact public d'une autre organisation](https://code.claude.com/docs/fr/artifacts.md#read-an-artifact-shared-with-you)

562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/fr/env-vars) | 500 | Délai initial en millisecondes du backoff entre les nouvelles tentatives d'une requête que l'API rejette avec une erreur de surcharge `529`. Augmentez-le, jusqu'à 32000, pour répartir les nouvelles tentatives sur une période plus longue lorsque l'API est à pleine capacité. Sans effet lorsque `CLAUDE_CODE_RETRY_WATCHDOG` est défini sur `1`, ou lorsque la requête rejetée a été envoyée en [mode rapide](https://code.claude.com/docs/fr/fast-mode.md#handle-rate-limits). Nécessite Claude Code v2.1.292 ou ultérieur. |562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/fr/env-vars) | 500 | Délai initial en millisecondes du backoff entre les nouvelles tentatives d'une requête que l'API rejette avec une erreur de surcharge `529`. Augmentez-le, jusqu'à 32000, pour répartir les nouvelles tentatives sur une période plus longue lorsque l'API est à pleine capacité. Sans effet lorsque `CLAUDE_CODE_RETRY_WATCHDOG` est défini sur `1`, ou lorsque la requête rejetée a été envoyée en [mode rapide](https://code.claude.com/docs/fr/fast-mode.md#handle-rate-limits). Nécessite Claude Code v2.1.292 ou ultérieur. |

563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/fr/env-vars) | 32000 | Plafond en millisecondes du backoff entre les nouvelles tentatives d'une requête que l'API rejette avec une erreur de surcharge `529`. Augmentez-le, jusqu'à 64000, pour que les nouvelles tentatives ultérieures continuent de s'espacer lorsque l'API est à pleine capacité. Sans effet lorsque `CLAUDE_CODE_RETRY_WATCHDOG` est défini sur `1`, ou lorsque la requête rejetée a été envoyée en [mode rapide](https://code.claude.com/docs/fr/fast-mode.md#handle-rate-limits). Nécessite Claude Code v2.1.296 ou ultérieur. |563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/fr/env-vars) | 32000 | Plafond en millisecondes du backoff entre les nouvelles tentatives d'une requête que l'API rejette avec une erreur de surcharge `529`. Augmentez-le, jusqu'à 64000, pour que les nouvelles tentatives ultérieures continuent de s'espacer lorsque l'API est à pleine capacité. Sans effet lorsque `CLAUDE_CODE_RETRY_WATCHDOG` est défini sur `1`, ou lorsque la requête rejetée a été envoyée en [mode rapide](https://code.claude.com/docs/fr/fast-mode.md#handle-rate-limits). Nécessite Claude Code v2.1.296 ou ultérieur. |

564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/fr/env-vars) | 600000 | Délai en millisecondes dont dispose chaque tentative de requête pour recevoir ses en-têtes de réponse. Il ne limite pas la durée d'une réponse en streaming au-delà. Augmentez-le pour les réseaux lents ou les proxys. Pour savoir comment il plafonne le délai de premier octet, voir [No response from API](#no-response-from-api). |564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/fr/env-vars) | 600000 | Délai en millisecondes dont dispose chaque tentative de requête pour recevoir ses en-têtes de réponse. Il ne limite pas la durée d'une réponse en streaming au-delà. Augmentez-le pour les réseaux lents ou les proxys. Pour savoir comment il plafonne le délai de premier octet, voir [No response from API](#no-response-from-api). |

565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/fr/env-vars) | non défini | Limite du nombre de renvois d'une [requête sans streaming](#streaming-response-ended-before-any-complete-data-was-received) qui expire. Une fois la limite atteinte, la requête échoue. Une réponse de Claude dont la génération dure plus longtemps que le délai d'expiration expire de nouveau à chaque renvoi ; définissez donc un nombre faible tel que `0` pour échouer plus tôt. Chaque tentative sans streaming expire après 300 secondes dans une session locale, ou après `API_TIMEOUT_MS` lorsque vous définissez une valeur positive. Nécessite Claude Code v2.1.285 ou ultérieur. |565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/fr/env-vars) | non défini | Limite du nombre de renvois d'une [requête sans streaming](#streaming-response-ended-before-any-complete-data-was-received) qui expire. Une fois la limite atteinte, la requête échoue. Une réponse de Claude dont la génération dure plus longtemps que le délai d'expiration expire de nouveau à chaque renvoi ; définissez donc un nombre faible tel que `0` pour échouer plus tôt. Pour le délai d'expiration de chaque tentative, voir [Durée d'attente d'une tentative sans streaming](#how-long-a-non-streaming-attempt-waits). Nécessite Claude Code v2.1.285 ou ultérieur. |

566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/fr/env-vars) | non défini | Délai en millisecondes pour le premier octet de réponse d'une requête en streaming. Nécessite Claude Code v2.1.242 ou ultérieur. Pour savoir comment Claude Code choisit le délai lorsque ceci n'est pas défini, voir [No response from API](#no-response-from-api). |566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/fr/env-vars) | non défini | Délai en millisecondes pour le premier octet de réponse d'une requête en streaming. Nécessite Claude Code v2.1.242 ou ultérieur. Pour savoir comment Claude Code choisit le délai lorsque ceci n'est pas défini, voir [No response from API](#no-response-from-api). |

567 567 

568#### Durée d'attente d'une tentative sans streaming

569 

570Une tentative sans streaming se termine à l'échéance de son délai d'expiration de requête ou de son délai d'inactivité du corps, selon celui qui survient en premier :

571 

572* **Délai d'expiration de requête** : `API_TIMEOUT_MS` lorsque vous définissez une valeur positive, sinon 300 secondes dans une session locale.

573* **[Délai d'inactivité du corps](https://code.claude.com/docs/fr/network-config.md#streaming-idle-watchdogs)** : 5 à 6 minutes sans réponse, quelle que soit la valeur élevée que vous donnez à `API_TIMEOUT_MS`, là où il s'exécute et où vous ne l'avez pas désactivé.

574 

568## Erreurs serveur575## Erreurs serveur

569 576 

570La plupart de ces erreurs proviennent du fournisseur d'inférence : le service Anthropic sur l'API Anthropic, et le service derrière l'endpoint de ce fournisseur sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, ou une passerelle personnalisée. [Le mode auto ne peut pas déterminer la sécurité d'une action](#auto-mode-cannot-determine-the-safety-of-an-action) et [L'agent s'est arrêté prématurément en raison d'une erreur API](#agent-terminated-early-due-to-an-api-error) couvrent également les causes de votre côté, comme un compte Amazon Bedrock qui ne peut pas invoquer le modèle du classifieur ou un sous-agent qui a atteint une limite d'utilisation.577La plupart de ces erreurs proviennent du fournisseur d'inférence : le service Anthropic sur l'API Anthropic, et le service derrière l'endpoint de ce fournisseur sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, ou une passerelle personnalisée. [Le mode auto ne peut pas déterminer la sécurité d'une action](#auto-mode-cannot-determine-the-safety-of-an-action) et [L'agent s'est arrêté prématurément en raison d'une erreur API](#agent-terminated-early-due-to-an-api-error) couvrent également les causes de votre côté, comme un compte Amazon Bedrock qui ne peut pas invoquer le modèle du classifieur ou un sous-agent qui a atteint une limite d'utilisation.

2212Cette erreur n'est pas un problème réseau côté client. Les sessions cloud et les [tâches planifiées cloud](https://code.claude.com/docs/fr/routines.md) s'exécutent à l'intérieur d'une VM en sandbox dont le trafic sortant via le réseau de la session est filtré selon la liste d'autorisation de l'[environnement cloud](https://code.claude.com/docs/fr/cloud-environments.md) :2219Cette erreur n'est pas un problème réseau côté client. Les sessions cloud et les [tâches planifiées cloud](https://code.claude.com/docs/fr/routines.md) s'exécutent à l'intérieur d'une VM en sandbox dont le trafic sortant via le réseau de la session est filtré selon la liste d'autorisation de l'[environnement cloud](https://code.claude.com/docs/fr/cloud-environments.md) :

2213 2220 

2214* **Trafic GitHub et des connecteurs** : les [opérations GitHub](https://code.claude.com/docs/fr/cloud-environments.md#github-proxy) et le trafic des connecteurs MCP utilisent des canaux séparés, c'est pourquoi ils peuvent continuer à fonctionner tandis que d'autres hôtes sont bloqués2221* **Trafic GitHub et des connecteurs** : les [opérations GitHub](https://code.claude.com/docs/fr/cloud-environments.md#github-proxy) et le trafic des connecteurs MCP utilisent des canaux séparés, c'est pourquoi ils peuvent continuer à fonctionner tandis que d'autres hôtes sont bloqués

2215* **Environnement par défaut** : l'environnement **Default** utilise l'accès **Trusted**, qui permet la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains) des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants et bloque les autres domaines sur ce chemin2222* **Environnement par défaut** : l'environnement **Default** utilise l'accès **Limited** avec **Allow package managers** coché. Ses sessions atteignent la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains) des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants.

2216 2223 

2217**À faire :**2224**À faire :**

2218 2225 

2219Ces étapes modifient l'un de vos propres environnements. Un [environnement partagé par l'organisation](https://code.claude.com/docs/fr/cloud-environments.md#organization-shared-environments) s'ouvre en lecture seule dans le sélecteur, donc demandez à un propriétaire de modifier son accès réseau à partir de la page **Cloud environments** dans les [paramètres d'administration](https://claude.ai/admin-settings).2226Ces étapes modifient l'un de vos propres environnements. Un [environnement partagé par l'organisation](https://code.claude.com/docs/fr/cloud-environments.md#organization-shared-environments) s'ouvre en lecture seule dans le sélecteur, donc demandez à un propriétaire de modifier son accès réseau à partir de la page **Cloud environments** dans les [paramètres d'administration](https://claude.ai/admin-settings).

2220 2227 

2221* Ouvrez votre environnement pour l'édition, soit à partir du [formulaire de la tâche planifiée cloud](https://code.claude.com/docs/fr/routines.md#environments-and-network-access), soit à partir du [sélecteur d'environnement](https://code.claude.com/docs/fr/cloud-environments.md#configure-your-environment) où vous démarrez les sessions cloud.2228* Ouvrez votre environnement pour l'édition, soit à partir du [formulaire de la tâche planifiée cloud](https://code.claude.com/docs/fr/routines.md#environments-and-network-access), soit à partir du [sélecteur d'environnement](https://code.claude.com/docs/fr/cloud-environments.md#configure-your-environment) où vous démarrez les sessions cloud.

2222* Dans la boîte de dialogue **Edit cloud environment**, changez **Network access** de **Trusted** à **Custom**, puis ajoutez le domaine bloqué à **Allowed domains**. Entrez un domaine par ligne. Cochez **Also include default list of common package managers** pour conserver la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains) aux côtés de vos domaines personnalisés. Sélectionnez **Full** à la place si vous voulez un accès sans restriction.2229* Dans la boîte de dialogue **Edit cloud environment**, sélectionnez **Limited** sous **Network access**, puis ajoutez le domaine bloqué à **Allowed domains**. Entrez un domaine par ligne. Cochez **Allow package managers** pour autoriser la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains) aux côtés de vos propres domaines. Sélectionnez **Full** à la place si vous voulez un accès sans restriction.

2223* Cliquez sur **Save changes**. La prochaine exécution utilise la liste d'autorisation mise à jour. Pour une session cloud qui est déjà ouverte, consultez [quand une modification d'accès réseau atteint les sessions existantes](https://code.claude.com/docs/fr/cloud-environments.md#network-access).2230* Cliquez sur **Save changes**. La prochaine exécution utilise la liste d'autorisation mise à jour. Pour une session cloud qui est déjà ouverte, consultez [quand une modification d'accès réseau atteint les sessions existantes](https://code.claude.com/docs/fr/cloud-environments.md#network-access).

2224 2231 

2225Consultez [Accès réseau](https://code.claude.com/docs/fr/cloud-environments.md#network-access) pour les niveaux d'accès et la liste d'autorisation par défaut. Les sessions CLI locales ne sont pas affectées par cette politique.2232Consultez [Accès réseau](https://code.claude.com/docs/fr/cloud-environments.md#network-access) pour les niveaux d'accès et la liste d'autorisation par défaut. Les sessions CLI locales ne sont pas affectées par cette politique.

2342**À faire :**2349**À faire :**

2343 2350 

2344* **Non connecté** : le message continue par `: not signed in. Run /login, then retry.` Exécutez `/login`, puis envoyez à nouveau2351* **Non connecté** : le message continue par `: not signed in. Run /login, then retry.` Exécutez `/login`, puis envoyez à nouveau

2345* **Refus de votre organisation** : par exemple `: Feedback has not been enabled for your organization.` ou `: Feedback collection is not available for organizations with custom data retention policies.` Si le message ajoute `To report a bug, open an issue`, faites-le sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). `/feedback` peut ensuite répondre qu'il est [désactivé par la politique de votre organisation](#feedback-is-disabled-by-your-organizations-policy) pendant sept jours. Un brouillon en file d'attente y reste et [expire toujours selon le calendrier prévu](https://code.claude.com/docs/fr/tools-reference.md#discard-or-keep-a-draft)2352* **Refus de votre organisation** : par exemple `: Feedback has not been enabled for your organization.` ou `: Feedback collection is not available for organizations with custom data retention policies.` `/feedback` peut ensuite répondre qu'il est [désactivé par la politique de votre organisation](#feedback-is-disabled-by-your-organizations-policy) pendant sept jours. Un brouillon en file d'attente y reste et [expire toujours selon le calendrier prévu](https://code.claude.com/docs/fr/tools-reference.md#discard-or-keep-a-draft)

2346* **Identifiants refusés** : le message continue par `: the sign-in this session uses is not allowed to send feedback` ou `: the server did not accept the credentials this session uses`. Exécutez `/status` à l'invite de Claude Code pour voir quelle connexion, quel jeton ou quelle clé API cette session envoie2353* **Identifiants refusés** : le message continue par `: the sign-in this session uses is not allowed to send feedback` ou `: the server did not accept the credentials this session uses`. Exécutez `/status` à l'invite de Claude Code pour voir quelle connexion, quel jeton ou quelle clé API cette session envoie

2347* **`(request timed out)` ou `(couldn't reach the service)` juste après `Couldn't send feedback`** : envoyez à nouveau le rapport ou le brouillon en file d'attente. La boîte de dialogue conserve votre texte, et le message d'un brouillon en file d'attente indique `The draft is still queued.` Si d'autres requêtes échouent aussi, vérifiez votre connexion réseau et consultez [Impossible de se connecter à l'API](#unable-to-connect-to-api). Si cela continue d'échouer, déposez le rapport sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2354* **`(request timed out)` ou `(couldn't reach the service)` juste après `Couldn't send feedback`** : envoyez à nouveau le rapport ou le brouillon en file d'attente. La boîte de dialogue conserve votre texte, et le message d'un brouillon en file d'attente indique `The draft is still queued.` Si d'autres requêtes échouent aussi, vérifiez votre connexion réseau et consultez [Impossible de se connecter à l'API](#unable-to-connect-to-api). Si cela continue d'échouer, déposez le rapport sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)

2348* **`(server returned <status>)`, ou aucune raison, juste après `Couldn't send feedback`** : le statut est le code de réponse du service. Le message propre du service le suit lorsqu'il en a envoyé un, comme dans `(server returned 403: Access Forbidden)`. Si cela continue d'échouer, déposez le rapport sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2355* **`(server returned <status>)`, ou aucune raison, juste après `Couldn't send feedback`** : le statut est le code de réponse du service. Le message propre du service le suit lorsqu'il en a envoyé un, comme dans `(server returned 403: Access Forbidden)`. Si cela continue d'échouer, déposez le rapport sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)

3492* **`Error: Workspace not trusted. <folder> is your home directory`** : comme la confiance pour votre répertoire personnel n'est jamais enregistrée, exécuter d'abord `claude` à cet endroit ne peut pas aider. Exécutez plutôt `claude ultrareview` depuis un répertoire de projet, après y avoir exécuté `claude` une fois pour accepter la boîte de dialogue de confiance, ou ajoutez `--trust-workspace`.3499* **`Error: Workspace not trusted. <folder> is your home directory`** : comme la confiance pour votre répertoire personnel n'est jamais enregistrée, exécuter d'abord `claude` à cet endroit ne peut pas aider. Exécutez plutôt `claude ultrareview` depuis un répertoire de projet, après y avoir exécuté `claude` une fois pour accepter la boîte de dialogue de confiance, ou ajoutez `--trust-workspace`.

3493* **`No answer in time.` suivi de `Error: Workspace not trusted`** : la question `Trust <folder>? [y/N]` est restée sans réponse pendant 5 minutes. Exécutez de nouveau `claude ultrareview` et répondez-y.3500* **`No answer in time.` suivi de `Error: Workspace not trusted`** : la question `Trust <folder>? [y/N]` est restée sans réponse pendant 5 minutes. Exécutez de nouveau `claude ultrareview` et répondez-y.

3494* **`Ultrareview did not start: <folder> is not trusted`** : vous avez refusé à la question `Trust <folder>? [y/N]`, par exemple en répondant `n` ou en appuyant sur Enter. Pour démarrer la revue, exécutez de nouveau `claude ultrareview` et répondez `y`.3501* **`Ultrareview did not start: <folder> is not trusted`** : vous avez refusé à la question `Trust <folder>? [y/N]`, par exemple en répondant `n` ou en appuyant sur Enter. Pour démarrer la revue, exécutez de nouveau `claude ultrareview` et répondez `y`.

3495* **``Ultrareview did not start: `--trust-workspace` takes no value``** : quelque chose d'autre qu'un flag suit `--trust-workspace`, comme un numéro de PR ou `false`. Si vous ne faites pas confiance au dossier, omettez le flag. Pour lui faire confiance pour cette exécution, placez le numéro de PR ou la branche de base avant le flag : `claude ultrareview 1234 --trust-workspace`.3502* **``Ultrareview did not start: `--trust-workspace` takes no value``** : autre chose qu'un flag suit `--trust-workspace`, comme un numéro de PR ou `false`. Si vous ne faites pas confiance au dossier, omettez le flag. Pour lui faire confiance pour cette exécution, placez le numéro de PR ou la branche de base avant le flag : `claude ultrareview 1234 --trust-workspace`.

3496 3503 

3497Avant la v2.1.309, `claude ultrareview` n'acceptait pas `--trust-workspace`.3504Avant la v2.1.309, `claude ultrareview` n'acceptait pas `--trust-workspace`.

3498 3505 

3557 3564 

3558* Vous n'avez pas démarré de session depuis l'installation, donc Claude Code n'a pas encore récupéré le flag. Le premier `claude import` peut afficher ce message même lorsque la fonctionnalité vous est disponible.3565* Vous n'avez pas démarré de session depuis l'installation, donc Claude Code n'a pas encore récupéré le flag. Le premier `claude import` peut afficher ce message même lorsque la fonctionnalité vous est disponible.

3559* Vous utilisez Claude Code via Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry ou Claude Platform on AWS, ou via une [passerelle Claude apps](https://code.claude.com/docs/fr/claude-apps-gateway#availability-and-limitations). Claude Code ne récupère pas les feature flags dans ces sessions, donc `claude import` reste indisponible.3566* Vous utilisez Claude Code via Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry ou Claude Platform on AWS, ou via une [passerelle Claude apps](https://code.claude.com/docs/fr/claude-apps-gateway#availability-and-limitations). Claude Code ne récupère pas les feature flags dans ces sessions, donc `claude import` reste indisponible.

3560* Vous avez défini `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` ou [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/fr/env-vars), qui désactivent la récupération des feature flags, donc `claude import` reste indisponible.3567* Vous avez défini `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/fr/env-vars#variables), `DISABLE_GROWTHBOOK` ou [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/fr/env-vars), qui désactivent la récupération des feature flags, donc `claude import` reste indisponible.

3561 3568 

3562**Marche à suivre :**3569**Marche à suivre :**

3563 3570 

3800Des messages apparentés surviennent avant même l'exécution de la commande :3807Des messages apparentés surviennent avant même l'exécution de la commande :

3801 3808 

3802* `Shell command permission check failed for pattern "..."` : la vérification de permission de la commande ne l'a pas autorisée. [Vérifications de permission sur les commandes injectées](https://code.claude.com/docs/fr/skills.md#permission-checks-on-injected-commands) explique quels résultats interrompent l'invocation dans chaque mode de permission et comment pré-approuver une commande avec `allowed-tools`3809* `Shell command permission check failed for pattern "..."` : la vérification de permission de la commande ne l'a pas autorisée. [Vérifications de permission sur les commandes injectées](https://code.claude.com/docs/fr/skills.md#permission-checks-on-injected-commands) explique quels résultats interrompent l'invocation dans chaque mode de permission et comment pré-approuver une commande avec `allowed-tools`

3803* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` : le frontmatter du skill exige bash sur une machine qui ne l'a pas. Installez Git for Windows ou modifiez le frontmatter en `shell: powershell`. Consultez [Comment les commandes injectées s'exécutent](https://code.claude.com/docs/fr/skills.md#how-injected-commands-run)3810* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` : le frontmatter du skill exige bash sur une machine qui n'en dispose pas. Installez Git for Windows ou modifiez le frontmatter en `shell: powershell`. Consultez [Comment s'exécutent les commandes injectées](https://code.claude.com/docs/fr/skills.md#how-injected-commands-run)

3804 3811 

3805**Marche à suivre :**3812**Marche à suivre :**

3806 3813 

3953 3960 

3954* **Vous n'avez pas passé de branche de base** : Claude Code a effectué la comparaison avec la branche par défaut du dépôt et suggère de passer explicitement votre branche de base, comme dans l'exemple ci-dessus3961* **Vous n'avez pas passé de branche de base** : Claude Code a effectué la comparaison avec la branche par défaut du dépôt et suggère de passer explicitement votre branche de base, comme dans l'exemple ci-dessus

3955* **Vous avez passé une branche de base déjà présente dans votre clone** : l'indication est ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3962* **Vous avez passé une branche de base déjà présente dans votre clone** : l'indication est ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3956* **Vous avez passé une branche de base absente de votre clone** : Claude Code l'a récupérée depuis origin avant de comparer. L'indication est ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)`` ; lorsque Claude Code ne peut pas déterminer si votre clone est superficiel, il suggère plutôt `git fetch --unshallow origin`. Avant la v2.1.221, l'indication suggérait `git fetch --unshallow origin` pour chaque branche de base récupérée, et sur un clone complet cette commande échoue avec `fatal: --unshallow on a complete repository does not make sense`.3963* **Vous avez passé une branche de base absente de votre clone** : Claude Code l'a récupérée depuis origin avant la comparaison. L'indication est ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)`` ; lorsque Claude Code ne peut pas déterminer si votre clone est superficiel (shallow), il suggère plutôt `git fetch --unshallow origin`. Avant la v2.1.221, l'indication suggérait `git fetch --unshallow origin` pour chaque branche de base récupérée, et sur un clone complet cette commande échoue avec `fatal: --unshallow on a complete repository does not make sense`.

3957 3964 

3958**Que faire :**3965**Que faire :**

3959 3966 

6615 6622 

6616**2. Mettre à jour chaque hôte qui partage le répertoire personnel**6623**2. Mettre à jour chaque hôte qui partage le répertoire personnel**

6617 6624 

6618Si plusieurs hôtes partagent ce répertoire personnel, mettez d'abord à jour Claude Code sur chaque hôte vers la version que le message nomme ou une version ultérieure. Une version plus ancienne peut réécrire un `.config.json` déplacé.6625Si plusieurs hôtes partagent ce répertoire personnel, mettez d'abord à jour Claude Code sur chaque hôte vers la version que le message nomme ou une version ultérieure.

6619 6626 

6620**3. Arrêter Claude Code**6627**3. Arrêter Claude Code**

6621 6628 

112 <td>✓</td>112 <td>✓</td>

113 <td>✓</td>113 <td>✓</td>

114 <td>✗</td>114 <td>✗</td>

115 <td>✗</td>115 <td>✓ (Claude Code v2.1.300 ou version ultérieure)</td>

116 <td>✗</td>116 <td>✗</td>

117 <td>✗</td>117 <td>✗</td>

118 </tr>118 </tr>

221 221 

222> [!NOTE]222> [!NOTE]

223>223>

224> Si vous vous authentifiez via une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway), la disponibilité des fonctionnalités correspond au fournisseur sous-jacent vers lequel la passerelle transfère, sauf pour les fonctionnalités que Claude Code désactive lui-même. Chaque fois que `ANTHROPIC_BASE_URL` pointe vers un hôte autre que `api.anthropic.com`, Claude Code désactive des fonctionnalités telles que [Remote Control](https://code.claude.com/docs/fr/remote-control.md#requirements) et [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md#platform-availability), quelle que soit la passerelle transfère. Certaines fonctionnalités exclusives à Anthropic telles que l'[Advisor](https://code.claude.com/docs/fr/advisor.md) ne fonctionnent que si la passerelle transfère les demandes intactes à l'API Anthropic.224> Si vous vous authentifiez via une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway), la disponibilité des fonctionnalités correspond au fournisseur sous-jacent vers lequel la passerelle transfère, sauf pour les fonctionnalités que Claude Code désactive lui-même. Chaque fois que `ANTHROPIC_BASE_URL` pointe vers un hôte autre que `api.anthropic.com`, Claude Code désactive des fonctionnalités telles que [Remote Control](https://code.claude.com/docs/fr/remote-control.md#requirements) et les [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md#platform-availability), quoi que transfère la passerelle. Certaines fonctionnalités, telles que l'[Advisor](https://code.claude.com/docs/fr/advisor.md#requirements), ne fonctionnent que si la passerelle transfère les requêtes intactes.

225>225>

226> Pour connaître les différences entre les demandes que Claude Code envoie entre une passerelle au format Amazon Bedrock ou Agent Platform, une passerelle `ANTHROPIC_BASE_URL` et une connexion à une passerelle d'applications Claude, consultez [comportement du client par méthode de connexion](https://code.claude.com/docs/fr/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior).226> Pour connaître les différences entre les demandes que Claude Code envoie entre une passerelle au format Amazon Bedrock ou Agent Platform, une passerelle `ANTHROPIC_BASE_URL` et une connexion à une passerelle d'applications Claude, consultez [comportement du client par méthode de connexion](https://code.claude.com/docs/fr/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior).

227 227 

244 244 

245> [tab] Claude Platform sur AWS245> [tab] Claude Platform sur AWS

246>246>

247> **Non disponible :** toutes les [fonctionnalités qui nécessitent un abonnement Claude](#features-that-require-a-claude-subscription), plus [fast mode](https://code.claude.com/docs/fr/fast-mode.md), [Advisor](https://code.claude.com/docs/fr/advisor.md), [Channels](https://code.claude.com/docs/fr/channels.md), [GitHub Actions](https://code.claude.com/docs/fr/github-actions.md), le [tableau de bord analytique](https://code.claude.com/docs/fr/analytics.md), les [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md) et les [commandes `/design-sync` et `/import`](https://code.claude.com/docs/fr/commands#all-commands).247> **Non disponible :** toutes les [fonctionnalités qui nécessitent un abonnement Claude](#features-that-require-a-claude-subscription), plus [fast mode](https://code.claude.com/docs/fr/fast-mode.md), [Channels](https://code.claude.com/docs/fr/channels.md), [GitHub Actions](https://code.claude.com/docs/fr/github-actions.md), le [tableau de bord analytique](https://code.claude.com/docs/fr/analytics.md), les [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md) et les [commandes `/design-sync` et `/import`](https://code.claude.com/docs/fr/commands#all-commands).

248>248>

249> **Disponible là où Amazon Bedrock ne l'est pas :** [web search](https://code.claude.com/docs/fr/tools-reference.md#websearch-tool-behavior).249> **Disponible ici, mais pas sur Amazon Bedrock :** [web search](https://code.claude.com/docs/fr/tools-reference.md#websearch-tool-behavior), ainsi que l'[Advisor](https://code.claude.com/docs/fr/advisor.md) dans Claude Code v2.1.300 ou version ultérieure.

250>250>

251> **Support partiel :**251> **Support partiel :**

252>252>

54 54 

55### Auto mode55### Auto mode

56 56 

57Un [mode de permission](#permission-mode) où un modèle classifieur distinct examine les actions à votre place, de sorte que Claude Code exécute la plupart d'entre elles sans vous demander. Claude Code vous demande toujours avant les actions qui correspondent à vos règles ask explicites. Le classifieur bloque l'escalade de portée, l'infrastructure non fiable et l'[injection de prompt](#prompt-injection). Les résultats des outils sont retirés de ce qu'il voit, de sorte que le contenu hostile dans un fichier ou une page web ne peut pas le manipuler directement.57Un [mode de permission](#permission-mode) où un modèle classifieur distinct examine les actions à votre place, de sorte que Claude Code exécute la plupart d'entre elles sans vous demander. Claude Code vous demande toujours avant les actions qui correspondent à vos règles ask explicites. Le classifieur bloque l'escalade de portée, l'infrastructure non fiable et l'[injection de prompt](#prompt-injection).

58 58 

59* **Claude Code v2.1.283 ou ultérieur** : le mode auto est le [mode de permission de démarrage intégré](https://code.claude.com/docs/fr/permission-modes.md#which-mode-a-session-starts-in) pour les sessions interactives dans le terminal et VS Code59* **Claude Code v2.1.283 ou ultérieur** : le mode auto est le [mode de permission de démarrage intégré](https://code.claude.com/docs/fr/permission-modes.md#which-mode-a-session-starts-in) pour les sessions interactives dans le terminal et VS Code

60* **Versions antérieures** : le mode auto est le mode de permission de démarrage intégré uniquement sur les plans Pro, Max, Ultra et Team60* **Versions antérieures** : le mode auto est le mode de permission de démarrage intégré uniquement sur les plans Pro, Max, Ultra et Team

261 261 

262### Prompt injection262### Prompt injection

263 263 

264Des instructions malveillantes intégrées dans un fichier, une page web ou un résultat d'outil, qui tentent de pousser Claude vers des actions que vous n'avez jamais demandées. Les défenses de Claude Code comprennent le système de permissions, la détection d'injection de commande et la vérification de confiance. Le [mode auto](#auto-mode) ajoute une sonde côté serveur qui analyse les résultats d'outils à la recherche de contenu suspect, ainsi qu'un classifieur qui examine les actions en ignorant les résultats d'outils, de sorte que le texte injecté ne peut pas le manipuler directement.264Des instructions malveillantes intégrées dans un fichier, une page web ou un résultat d'outil, qui tentent de pousser Claude vers des actions que vous n'avez jamais demandées. Les défenses de Claude Code comprennent le système de permissions, la détection d'injection de commande et la vérification de confiance. En [mode auto](#auto-mode), une sonde côté serveur analyse les résultats d'outils à la recherche de contenu suspect, et un classifieur examine les actions.

265 265 

266En savoir plus : [Se protéger contre l'injection de prompt](https://code.claude.com/docs/fr/security.md#protect-against-prompt-injection)266En savoir plus : [Se protéger contre l'injection de prompt](https://code.claude.com/docs/fr/security.md#protect-against-prompt-injection)

267 267 

2341 2341 

2342#### Annoter un résultat pour le classifieur du mode auto2342#### Annoter un résultat pour le classifieur du mode auto

2343 2343 

2344Renvoyez `classifierContext` pour envoyer une courte note sur le résultat de l'appel d'outil au classifieur du [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode) plutôt qu'à Claude. Le classifieur [ne reçoit jamais les résultats des outils eux-mêmes](https://code.claude.com/docs/fr/permission-modes.md#how-the-classifier-evaluates-actions), ce champ est donc le moyen pris en charge pour lui indiquer quelque chose sur ce qu'un appel a renvoyé avant qu'il n'examine les actions suivantes. Ce champ nécessite Claude Code v2.1.236 ou une version ultérieure.2344Renvoyez `classifierContext` pour envoyer une courte note sur le résultat de l'appel d'outil au classifieur du [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode) plutôt qu'à Claude. La note sert à l'examen des actions ultérieures par le classifieur. Le champ nécessite Claude Code v2.1.236 ou une version ultérieure.

2345 2345 

2346L'exemple ci-dessous indique au classifieur d'où provient la sortie d'une requête :2346L'exemple ci-dessous indique au classifieur d'où provient la sortie d'une requête :

2347 2347 

47 47 

48Tandis qu'une [variable de credential de passerelle](https://code.claude.com/docs/fr/llm-gateway-connect.md#set-the-credential-variable) ou `apiKeyHelper` est active, les requêtes portent cette credential à la place de la connexion d'abonnement claude.ai d'un développeur, et les limites d'utilisation de l'abonnement ne s'appliquent pas à celles-ci. Claude Code conserve une connexion claude.ai sauvegardée sur la machine mais ne l'envoie pas avec ces requêtes. Ce trafic est facturé par token à celui qui possède la credential que la passerelle transfère, tel que le compte Anthropic Console de votre organisation, ou votre compte Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry quand la passerelle achemine là.48Tandis qu'une [variable de credential de passerelle](https://code.claude.com/docs/fr/llm-gateway-connect.md#set-the-credential-variable) ou `apiKeyHelper` est active, les requêtes portent cette credential à la place de la connexion d'abonnement claude.ai d'un développeur, et les limites d'utilisation de l'abonnement ne s'appliquent pas à celles-ci. Claude Code conserve une connexion claude.ai sauvegardée sur la machine mais ne l'envoie pas avec ces requêtes. Ce trafic est facturé par token à celui qui possède la credential que la passerelle transfère, tel que le compte Anthropic Console de votre organisation, ou votre compte Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry quand la passerelle achemine là.

49 49 

50[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/fr/llm-gateway-connect#set-the-base-url-and-credential) est la variable qui pointe Claude Code vers la passerelle. Définir uniquement cette variable, sans credential de passerelle, ne remplace pas l'abonnement. Les requêtes acheminent toujours via la passerelle, mais une connexion claude.ai sauvegardée reste la credential active, donc ses limites d'utilisation et sa facturation s'appliquent. Les passerelles qui transmettent ce trafic à Anthropic doivent transférer la capacité OAuth dans `anthropic-beta` ; consultez la [référence des en-têtes de requête](https://code.claude.com/docs/fr/llm-gateway-protocol.md#request-headers).50[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/fr/llm-gateway-connect#set-the-base-url-and-credential) est la variable qui pointe Claude Code vers la passerelle. Définir uniquement cette variable, sans credential de passerelle, ne remplace pas l'abonnement. Les requêtes acheminent toujours via la passerelle, mais une connexion claude.ai sauvegardée reste la credential active, donc ses limites d'utilisation et sa facturation s'appliquent. Les passerelles qui transmettent ce trafic à Anthropic doivent transférer `Authorization` et la capacité OAuth dans `anthropic-beta` ; consultez la [référence des en-têtes de requête](https://code.claude.com/docs/fr/llm-gateway-protocol.md#request-headers).

51 51 

52## Pages connexes52## Pages connexes

53 53 

40 40 

41| Format | Sélectionné par | Points de terminaison | Transférer inchangé |41| Format | Sélectionné par | Points de terminaison | Transférer inchangé |

42| :- | :- | :- | :- |42| :- | :- | :- | :- |

43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (optionnel) | En-têtes de requête `anthropic-beta` et `anthropic-version` |43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (optionnel) | En-têtes de requête `anthropic-beta` et `anthropic-version`, ainsi que `Authorization` quand une [connexion claude.ai](#request-headers) authentifie la requête auprès d'Anthropic |

44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` avec `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens` (optionnel) | Champs du corps de requête `anthropic_beta` et `anthropic_version` |44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` avec `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens` (optionnel) | Champs du corps de requête `anthropic_beta` et `anthropic_version` |

45| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` avec `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (optionnel) | En-têtes de requête `anthropic-beta` et `anthropic-version`, et le champ du corps de requête `anthropic_version` |45| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` avec `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (optionnel) | En-têtes de requête `anthropic-beta` et `anthropic-version`, et le champ du corps de requête `anthropic_version` |

46 46 

115 115 

116## En-têtes de requête116## En-têtes de requête

117 117 

118Claude Code inclut ces en-têtes sur les requêtes API. Les noms d'en-têtes ne sont pas sensibles à la casse sur le fil. Transmettez `anthropic-version` et `anthropic-beta` inchangés, plus `anthropic-workspace-id` lorsque l'amont est la [Claude Platform on AWS](https://code.claude.com/docs/fr/claude-platform-on-aws.md) ; le reste, la passerelle peut le consommer pour le routage, l'attribution et le suivi, et n'a pas besoin de le transmettre.118Claude Code inclut ces en-têtes sur les requêtes API. Les noms d'en-têtes ne sont pas sensibles à la casse sur le fil. Transmettez `anthropic-version` et `anthropic-beta` inchangés, plus `anthropic-workspace-id` lorsque l'amont est la [Claude Platform on AWS](https://code.claude.com/docs/fr/claude-platform-on-aws.md). Transmettez également `Authorization` lorsque votre passerelle s'authentifie auprès d'Anthropic avec la connexion claude.ai du développeur et non avec une clé qui lui est propre. Le reste, la passerelle peut le consommer pour le routage, l'attribution et le suivi, et n'a pas besoin de le transmettre.

119 119 

120| En-tête | Description |120| En-tête | Description |

121| :- | :- |121| :- | :- |

122| `Authorization`, `x-api-key` | L'identifiant de passerelle du développeur, dans un ou les deux en-têtes selon la [variable d'identifiant](https://code.claude.com/docs/fr/llm-gateway-connect.md#set-the-credential-variable) qu'il définit |122| `Authorization`, `x-api-key` | Les identifiants de passerelle du développeur, dans un ou les deux en-têtes selon la [variable d'identifiants](https://code.claude.com/docs/fr/llm-gateway-connect.md#set-the-credential-variable) qu'il définit. Avec une connexion claude.ai et sans identifiants de passerelle, `Authorization` porte le jeton de la connexion |

123| `anthropic-version` | Version de l'API, actuellement `2023-06-01`. Les requêtes au format Amazon Bedrock et Agent Platform de Google Cloud portent également le champ de corps `anthropic_version`, dont la valeur est la chaîne de dialecte du fournisseur, pas la valeur de cet en-tête |123| `anthropic-version` | Version de l'API, actuellement `2023-06-01`. Les requêtes au format Amazon Bedrock et Agent Platform de Google Cloud portent également le champ de corps `anthropic_version`, dont la valeur est la chaîne de dialecte du fournisseur, pas la valeur de cet en-tête |

124| `anthropic-beta` | Valeurs de capacité séparées par des virgules pour la requête. Transmettez l'en-tête verbatim ; ne mettez pas en liste blanche les valeurs individuelles, car l'ensemble change avec les versions de Claude Code. Lorsque le développeur s'authentifie avec une connexion claude.ai, ce qui est possible lorsque `ANTHROPIC_BASE_URL` est défini sans variable d'identifiant de passerelle, cet en-tête porte également une capacité OAuth que l'amont exige, et la supprimer échoue ces requêtes avec `401` |124| `anthropic-beta` | Valeurs de capacité séparées par des virgules pour la requête. Transmettez l'en-tête verbatim ; ne mettez pas en liste blanche les valeurs individuelles, car l'ensemble change avec les versions de Claude Code. Lorsque le développeur s'authentifie avec une connexion claude.ai, ce qui est possible lorsque `ANTHROPIC_BASE_URL` est défini sans variable d'identifiant de passerelle, cet en-tête porte également une capacité OAuth que l'amont exige, et la supprimer échoue ces requêtes avec `401` |

125| `x-claude-code-session-id` | Un identifiant unique pour la session Claude Code actuelle. Utilisez-le pour agréger toutes les requêtes d'une session sans analyser les corps de requête |125| `x-claude-code-session-id` | Un identifiant unique pour la session Claude Code actuelle. Utilisez-le pour agréger toutes les requêtes d'une session sans analyser les corps de requête |

52* **Contrôles de livraison** : [`policyHelper`](https://code.claude.com/docs/fr/settings-reference#policyhelper), [`wslInheritsWindowsSettings`](https://code.claude.com/docs/fr/settings-reference#wslinheritswindowssettings), et [`managedSourcesBehavior`](https://code.claude.com/docs/fr/settings-reference#managedsourcesbehavior)52* **Contrôles de livraison** : [`policyHelper`](https://code.claude.com/docs/fr/settings-reference#policyhelper), [`wslInheritsWindowsSettings`](https://code.claude.com/docs/fr/settings-reference#wslinheritswindowssettings), et [`managedSourcesBehavior`](https://code.claude.com/docs/fr/settings-reference#managedsourcesbehavior)

53* **Clés de connexion à la passerelle** : [`forceLoginGatewayUrl`](https://code.claude.com/docs/fr/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/fr/settings-reference#gatewayinternalnetworks), et la valeur `"gateway"` de [`forceLoginMethod`](https://code.claude.com/docs/fr/settings-reference#forceloginmethod)53* **Clés de connexion à la passerelle** : [`forceLoginGatewayUrl`](https://code.claude.com/docs/fr/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/fr/settings-reference#gatewayinternalnetworks), et la valeur `"gateway"` de [`forceLoginMethod`](https://code.claude.com/docs/fr/settings-reference#forceloginmethod)

54 54 

55Un fichier de paramètres gérés, un profil MDM, ou la console claude.ai applique une politique à tous ceux qu'il atteint. Pour donner à un groupe de développeurs une politique différente, déployez un fichier ou un profil différent à ce groupe ; la console claude.ai [ne peut pas encore cibler un groupe](https://code.claude.com/docs/fr/server-managed-settings.md#current-limitations), tandis qu'une [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway) auto-hébergée livre les paramètres gérés par groupe IdP.55Avec un fichier de paramètres gérés ou un profil MDM, tous ceux qu'il atteint reçoivent une même politique. Pour donner à un groupe de développeurs une politique différente, déployez un fichier ou un profil différent à ce groupe. Avec un forfait Enterprise, vous pouvez également [attribuer à chaque groupe sa propre configuration](https://code.claude.com/docs/fr/server-managed-settings.md#give-groups-different-settings) dans les paramètres gérés par le serveur. Une [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway) auto-hébergée livre les paramètres gérés par groupe IdP.

56 56 

57Quand plus d'un mécanisme livre une politique à la même machine, Claude Code utilise par défaut l'un et ignore les autres. [Comment Claude Code combine les sources gérées](#how-claude-code-combines-managed-sources) donne l'ordre et l'opt-in qui s'applique à chaque source.57Quand plus d'un mécanisme livre une politique à la même machine, Claude Code utilise par défaut l'un et ignore les autres. [Comment Claude Code combine les sources gérées](#how-claude-code-combines-managed-sources) donne l'ordre et l'opt-in qui s'applique à chaque source.

58 58 

163 163 

164La forme en ligne définit la variable pour ce seul lancement dans Bash ou Zsh. Pour la garder activée pour chaque session, ajoutez-la au bloc `env` dans `~/.claude/settings.json` comme indiqué dans [Définir les variables d'environnement](https://code.claude.com/docs/fr/env-vars.md#set-environment-variables).164La forme en ligne définit la variable pour ce seul lancement dans Bash ou Zsh. Pour la garder activée pour chaque session, ajoutez-la au bloc `env` dans `~/.claude/settings.json` comme indiqué dans [Définir les variables d'environnement](https://code.claude.com/docs/fr/env-vars.md#set-environment-variables).

165 165 

166Cela charge `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` et `CLAUDE.local.md` à partir du répertoire supplémentaire. `CLAUDE.local.md` est ignoré si vous excluez `local` de [`--setting-sources`](https://code.claude.com/docs/fr/cli-reference).166Avec la variable définie, Claude Code charge les fichiers `CLAUDE.md`, `.claude/CLAUDE.md`, `CLAUDE.local.md` et `.claude/rules/*.md` du répertoire supplémentaire, à l'exception des règles qui définissent un [champ `paths`](#path-specific-rules). `CLAUDE.local.md` est ignoré si vous excluez `local` de [`--setting-sources`](https://code.claude.com/docs/fr/cli-reference).

167 167 

168### Organiser les règles avec `.claude/rules/`168### Organiser les règles avec `.claude/rules/`

169 169 

168 168 

169Consultez [Model is not a recognized model id](https://code.claude.com/docs/fr/errors.md#model-is-not-a-recognized-model-id) et [Model not found](https://code.claude.com/docs/fr/errors.md#model-not-found) pour les messages.169Consultez [Model is not a recognized model id](https://code.claude.com/docs/fr/errors.md#model-is-not-a-recognized-model-id) et [Model not found](https://code.claude.com/docs/fr/errors.md#model-not-found) pour les messages.

170 170 

171Si vous définissez le modèle avec le flag `--model`, la variable d'environnement `ANTHROPIC_MODEL`, ou le paramètre `model`, Claude Code ne rejette pas à l'avance une valeur mal orthographiée. La session démarre, et la première requête produit [There's an issue with the selected model](https://code.claude.com/docs/fr/errors.md#theres-an-issue-with-the-selected-model). Sur l'API Anthropic, une valeur qui ne commence pas par `claude-` et dont l'orthographe est proche d'un nom ou d'un alias de modèle peut également produire un [avertissement au démarrage qui le suggère](#fix-a-mistyped-model-name).171Si vous définissez le modèle avec le flag `--model`, la variable d'environnement `ANTHROPIC_MODEL`, ou le paramètre `model`, Claude Code ne rejette pas à l'avance une valeur mal orthographiée. La session démarre, et la première requête produit [There's an issue with the selected model](https://code.claude.com/docs/fr/errors.md#theres-an-issue-with-the-selected-model). Sur l'API Anthropic, vous pouvez voir un [avertissement qui suggère le nom le plus proche](#fix-a-mistyped-model-name) si l'orthographe de la valeur est proche d'un nom ou d'un alias de modèle et qu'elle ne commence pas par `claude-`.

172 172 

173Lorsque le modèle demandé a une date de retrait programmée ou est automatiquement remappé à une version plus récente, Claude Code affiche un avertissement qui nomme le modèle demandé. Les sessions interactives l'affichent comme un avis de démarrage. À partir de v2.1.182, le même avertissement est écrit sur stderr en [mode non interactif](https://code.claude.com/docs/fr/headless.md) lors de l'utilisation du format de sortie texte par défaut. La vérification couvre également un `model` défini dans [frontmatter de sous-agent](https://code.claude.com/docs/fr/sub-agents.md). L'avertissement stderr est supprimé pour `--output-format json` et `stream-json` ; lisez le modèle réel à partir du champ `modelUsage` du [message de résultat](https://code.claude.com/docs/fr/headless.md#get-structured-output) à la place.173Lorsque le modèle demandé a une date de retrait programmée ou est automatiquement remappé à une version plus récente, Claude Code affiche un avertissement qui nomme le modèle demandé. Les sessions interactives l'affichent comme un avis de démarrage. À partir de v2.1.182, le même avertissement est écrit sur stderr en [mode non interactif](https://code.claude.com/docs/fr/headless.md) lors de l'utilisation du format de sortie texte par défaut. La vérification couvre également un `model` défini dans [frontmatter de sous-agent](https://code.claude.com/docs/fr/sub-agents.md). L'avertissement stderr est supprimé pour `--output-format json` et `stream-json` ; lisez le modèle réel à partir du champ `modelUsage` du [message de résultat](https://code.claude.com/docs/fr/headless.md#get-structured-output) à la place.

174 174 

195}195}

196```196```

197 197 

198#### Corriger un nom de modèle mal orthographié

199 

200L'un ou l'autre de ces avertissements signifie que Claude Code ne reconnaît pas l'ID de modèle que vous avez défini, et que l'orthographe de cet ID est proche d'un nom ou d'un alias de modèle qu'il reconnaît :

201 

202```text theme={null}

203⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

204Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

205```

206 

207* **Vous avez mal orthographié l'ID** : remplacez-le par la suggestion [partout où vous définissez le modèle](#setting-your-model)

208* **L'ID est intentionnel** : laissez-le tel quel. La session l'envoie tel que vous l'avez écrit. Si la fenêtre de contexte que Claude Code suppose pour celui-ci est incorrecte, [corrigez la fenêtre](#correct-the-window-for-a-gateway-or-custom-model-id)

209 

198#### Définir un modèle par défaut pour les nouvelles sessions210#### Définir un modèle par défaut pour les nouvelles sessions

199 211 

200Définissez `ANTHROPIC_DEFAULT_MODEL=<alias|name>` pour choisir le modèle sur lequel vos sessions démarrent par défaut. Nécessite Claude Code v2.1.236 ou ultérieur.212Définissez `ANTHROPIC_DEFAULT_MODEL=<alias|name>` pour choisir le modèle sur lequel vos sessions démarrent par défaut. Nécessite Claude Code v2.1.236 ou ultérieur.

772| :- | :- |784| :- | :- |

773| Basculer pour la session en cours | Appuyez sur `Option+T` sous macOS ou `Alt+T` sous Windows et Linux |785| Basculer pour la session en cours | Appuyez sur `Option+T` sous macOS ou `Alt+T` sous Windows et Linux |

774| Définir la valeur par défaut globale | Exécutez `/config` et basculez le mode réflexion. Enregistré sous `alwaysThinkingEnabled` dans `~/.claude/settings.json` |786| Définir la valeur par défaut globale | Exécutez `/config` et basculez le mode réflexion. Enregistré sous `alwaysThinkingEnabled` dans `~/.claude/settings.json` |

775| Désactiver via une variable d'environnement | Définissez [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/fr/env-vars), qui désactive la réflexion sur l'API Anthropic sauf sur Opus 5.5, Sonnet 5.5, Haiku 5.5 et les modèles Fable. Sur les [fournisseurs tiers](https://code.claude.com/docs/fr/third-party-integrations.md), Claude Code omet plutôt le paramètre `thinking`, et les modèles à raisonnement adaptatif peuvent encore réfléchir |787| Désactiver via une variable d'environnement | Définissez [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/fr/env-vars) |

788 

789Claude Code réduit l'affichage de la réflexion par défaut. Appuyez sur `Ctrl+O` pour basculer le mode verbeux et voir le raisonnement en texte italique gris. Les sessions interactives sur l'API Anthropic reçoivent par défaut des blocs de réflexion expurgés ; définissez donc [`showThinkingSummaries: true`](https://code.claude.com/docs/fr/settings-reference#showthinkingsummaries) dans les paramètres si vous souhaitez que les résumés complets soient disponibles lorsque vous les développez. Tous les tokens de réflexion générés vous sont facturés, même lorsqu'ils sont réduits ou expurgés.

790 

791#### Où vous ne pouvez pas désactiver la réflexion

776 792 

777Vous ne pouvez pas désactiver la réflexion sur Opus 5.5, Sonnet 5.5, Haiku 5.5 ou les modèles Fable. Le bouton de la session et la ligne de `/config` affichent `Thinking can't be turned off` pour ces modèles au lieu de proposer l'interrupteur, et un `alwaysThinkingEnabled: false` ou un `MAX_THINKING_TOKENS=0` enregistré n'y a aucun effet. Sur ces modèles, le modèle décide à chaque étape de la quantité de réflexion en fonction du niveau d'effort. Le paramètre enregistré s'applique de nouveau lorsque vous passez à un modèle qui l'accepte.793Vous ne pouvez pas désactiver la réflexion sur Opus 5.5, Sonnet 5.5, Haiku 5.5 ou les modèles Fable. Le bouton de la session et la ligne de `/config` affichent `Thinking can't be turned off` pour ces modèles au lieu de proposer l'interrupteur, et un `alwaysThinkingEnabled: false` ou un `MAX_THINKING_TOKENS=0` enregistré n'y a aucun effet. Sur ces modèles, le modèle décide à chaque étape de la quantité de réflexion en fonction du niveau d'effort. Le paramètre enregistré s'applique de nouveau lorsque vous passez à un modèle qui l'accepte.

778 794 

779Claude Code réduit l'affichage de la réflexion par défaut. Appuyez sur `Ctrl+O` pour basculer le mode verbeux et voir le raisonnement en texte italique gris. Les sessions interactives sur l'API Anthropic reçoivent par défaut des blocs de réflexion expurgés ; définissez donc `showThinkingSummaries: true` dans les [paramètres](https://code.claude.com/docs/fr/settings.md) si vous souhaitez que les résumés complets soient disponibles lorsque vous les développez. Tous les tokens de réflexion générés vous sont facturés, même lorsqu'ils sont réduits ou expurgés.795Pour arrêter ou réduire la réflexion, suivez l'étape correspondant à votre fournisseur :

796 

797* **API Anthropic** : vous pouvez désactiver la réflexion sur des modèles comme `claude-opus-5`, `claude-sonnet-5` et `claude-haiku-4-5`. Les [alias](#model-aliases) comme `sonnet` sélectionnent des modèles sur lesquels ce n'est pas possible ; [définissez donc le modèle](#setting-your-model) par son identifiant.

798* **[Fournisseurs tiers](https://code.claude.com/docs/fr/third-party-integrations.md)** : sur des fournisseurs comme Amazon Bedrock et Microsoft Foundry, les modèles dotés du [raisonnement adaptatif](#adaptive-reasoning-and-fixed-thinking-budgets) peuvent encore réfléchir même lorsque la réflexion est désactivée. [Abaissez le niveau d'effort](#set-the-effort-level) pour réduire la réflexion.

780 799 

781### Contexte étendu800### Contexte étendu

782 801 

900 919 

901Une fois que Claude Code reconnaît l'ID ou utilise la fenêtre que vous lui avez indiquée, l'avertissement n'apparaît plus lorsque vous démarrez une session sur cet ID.920Une fois que Claude Code reconnaît l'ID ou utilise la fenêtre que vous lui avez indiquée, l'avertissement n'apparaît plus lorsque vous démarrez une session sur cet ID.

902 921 

903#### Corriger un nom de modèle mal saisi

904 

905L'un ou l'autre de ces avertissements signifie que Claude Code ne reconnaît pas l'ID de modèle que vous avez défini, et que cet ID est très proche d'un nom ou d'un alias de modèle qu'il reconnaît :

906 

907```text theme={null}

908⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

909Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

910```

911 

912* **Vous avez mal saisi l'ID** : remplacez-le par la suggestion [là où vous définissez le modèle](#setting-your-model)

913* **L'ID est intentionnel** : laissez-le tel quel. La session l'envoie tel que vous l'avez écrit. Si la fenêtre de contexte que Claude Code suppose pour celui-ci est incorrecte, [corrigez la fenêtre](#correct-the-window-for-a-gateway-or-custom-model-id)

914 

915#### À quels ID s'applique `CLAUDE_CODE_MAX_CONTEXT_TOKENS`922#### À quels ID s'applique `CLAUDE_CODE_MAX_CONTEXT_TOKENS`

916 923 

917Sur une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) ou un autre déploiement personnalisé, Claude Code peut supposer une fenêtre de contexte pour l'ID de modèle qui diffère de la fenêtre réelle du modèle, qu'il résolve ou non l'ID en un modèle Claude. Définissez [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/fr/env-vars) à la fenêtre que Claude Code devrait supposer à la place.924Sur une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) ou un autre déploiement personnalisé, Claude Code peut supposer une fenêtre de contexte pour l'ID de modèle qui diffère de la fenêtre réelle du modèle, qu'il résolve ou non l'ID en un modèle Claude. Définissez [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/fr/env-vars) à la fenêtre que Claude Code devrait supposer à la place.

710* `skill.name` : skill actif pour la requête, défini par l'outil Skill ou par une commande `/`, ou hérité par un sous-agent lancé. Les noms des skills intégrés, fournis, définis par l'utilisateur et issus de plugins de la marketplace officielle apparaissent tels quels. Les noms des skills de plugins tiers sont remplacés par `"third-party"`. Absent lorsqu'aucun skill n'est actif.710* `skill.name` : skill actif pour la requête, défini par l'outil Skill ou par une commande `/`, ou hérité par un sous-agent lancé. Les noms des skills intégrés, fournis, définis par l'utilisateur et issus de plugins de la marketplace officielle apparaissent tels quels. Les noms des skills de plugins tiers sont remplacés par `"third-party"`. Absent lorsqu'aucun skill n'est actif.

711* `plugin.name` : plugin propriétaire lorsque le skill ou le sous-agent actif est fourni par un plugin. Les noms des plugins de la marketplace officielle apparaissent tels quels. Les noms des plugins tiers sont remplacés par `"third-party"`. Absent lorsque ni le skill ni le sous-agent n'a de plugin propriétaire.711* `plugin.name` : plugin propriétaire lorsque le skill ou le sous-agent actif est fourni par un plugin. Les noms des plugins de la marketplace officielle apparaissent tels quels. Les noms des plugins tiers sont remplacés par `"third-party"`. Absent lorsque ni le skill ni le sous-agent n'a de plugin propriétaire.

712* `marketplace.name` : marketplace depuis laquelle le plugin propriétaire a été installé. Émis uniquement pour les plugins de la marketplace officielle, même lorsque `OTEL_LOG_TOOL_DETAILS=1` est défini. Absent sinon.712* `marketplace.name` : marketplace depuis laquelle le plugin propriétaire a été installé. Émis uniquement pour les plugins de la marketplace officielle, même lorsque `OTEL_LOG_TOOL_DETAILS=1` est défini. Absent sinon.

713* `mcp_server.name` : serveur MCP dont cette requête a consommé le résultat d'outil. Les noms des serveurs intégrés, relayés par claude.ai et du registre officiel apparaissent tels quels. Les noms des serveurs configurés par l'utilisateur sont remplacés par `"custom"`. Absent lorsque la requête n'a consommé aucun résultat d'outil MCP. Avant la v2.1.222, Claude Code définissait cet attribut sur chaque requête suivant un appel d'outil MCP, et pas uniquement sur les requêtes ayant consommé un résultat d'outil ; les tableaux de bord qui l'agrègent affichent donc une baisse après la mise à jour.713* `mcp_server.name` : Serveur MCP dont le résultat d'outil a été consommé par cette requête. Les noms des serveurs intégrés, relayés par claude.ai et du registre officiel apparaissent tels quels. Les noms des serveurs configurés par l'utilisateur sont remplacés par `"custom"`. Absent lorsque la requête n'a consommé aucun résultat d'outil MCP. Avant la v2.1.222, Claude Code définissait cet attribut sur chaque requête suivant un appel d'outil MCP, et pas seulement sur les requêtes ayant consommé un résultat d'outil ; les tableaux de bord qui l'agrègent affichent donc une baisse après la mise à niveau.

714* `mcp_tool.name` : outil MCP dont cette requête a consommé le résultat, avec le même comportement de masquage et de version que `mcp_server.name`. Absent lorsque la requête n'a consommé aucun résultat d'outil MCP.714 * À partir de la v2.1.312, le nom d'un serveur distant doté d'une URL fixe et déclaré par un plugin de la marketplace officielle d'Anthropic apparaît également tel quel, sous la forme `plugin_<plugin>_<server>`. Ce nom est remplacé par `"custom"` lorsque la copie de marketplace du plugin ne provient pas de la source enregistrée d'Anthropic, par exemple une copie montée depuis un répertoire seed dans une session cloud.

715* `mcp_tool.name` : Outil MCP dont le résultat a été consommé par cette requête, avec le même comportement de masquage et de version que `mcp_server.name`, sauf qu'il peut valoir `"custom"` lorsque `mcp_server.name` affiche un nom `plugin_<plugin>_<server>`. Absent lorsque la requête n'a consommé aucun résultat d'outil MCP.

715 716 

716#### Compteur de tokens717#### Compteur de tokens

717 718 

998 * Une autorisation pour le reste de la session, accordée lors d'une demande de permission antérieure dans la même session CLI interactive999 * Une autorisation pour le reste de la session, accordée lors d'une demande de permission antérieure dans la même session CLI interactive

999 * Le caractère intrinsèquement sûr de l'outil1000 * Le caractère intrinsèquement sûr de l'outil

1000 1001 

1001 La valeur `source` n'indique pas laquelle de ces sources a correspondu. Pour savoir laquelle a refusé un appel, recherchez l'[événement de sécurité](#safety-event) ayant le même `tool_use_id` et lisez ses attributs `category` et `rule_source`. Certains appels refusés [n'ont pas d'événement de sécurité](#calls-without-a-safety-event).1002 La valeur `source` n'indique pas laquelle de ces sources a correspondu. Lorsque `classifier_verdict` est présent, il donne le résultat du classifieur qui a décidé de l'appel. Aucun attribut de `tool_decision` ne nomme la règle de permission ou le paramètre qui a refusé l'appel.

1002 1003 

1003 Claude Code signale également `"config"` lorsque la demande de permission elle-même échoue. Par exemple, cette demande échoue lorsque le callback [`canUseTool`](https://code.claude.com/docs/fr/agent-sdk/typescript#canusetool) de l'Agent SDK ou l'outil [`--permission-prompt-tool`](https://code.claude.com/docs/fr/cli-reference#cli-flags) renvoie un résultat invalide, ou lorsque le flux d'entrée se ferme pendant que la demande est en attente.1004 Claude Code signale également `"config"` lorsque la demande de permission elle-même échoue. Par exemple, cette demande échoue lorsque le callback [`canUseTool`](https://code.claude.com/docs/fr/agent-sdk/typescript#canusetool) de l'Agent SDK ou l'outil [`--permission-prompt-tool`](https://code.claude.com/docs/fr/cli-reference#cli-flags) renvoie un résultat invalide, ou lorsque le flux d'entrée se ferme pendant que la demande est en attente.

1004 * `"hook"` : un hook `PreToolUse` ou `PermissionRequest` a renvoyé la décision.1005 * `"hook"` : un hook `PreToolUse` ou `PermissionRequest` a renvoyé la décision.

1046 1047 

1047#### Événement de sécurité1048#### Événement de sécurité

1048 1049 

1049Journalisé lorsqu'une vérification refuse un appel d'outil ou exige une demande de permission, à l'exception des [appels sans événement de sécurité](#calls-without-a-safety-event). Également journalisé lorsque le [proxy réseau du sandbox](https://code.claude.com/docs/fr/sandboxing.md#network-isolation) refuse une connexion ou une requête, et lorsqu'un hook bloque un résultat. Nécessite Claude Code v2.1.307 ou ultérieur.1050Claude Code a cessé d'envoyer `claude_code.safety_event` :

1051 

1052* **v2.1.312 et ultérieures** : ces versions n'envoient pas l'événement, et aucun paramètre ne l'active

1053* **v2.1.307 à v2.1.311** : une session cesse d'envoyer l'événement lors de sa prochaine actualisation des feature flags. Une session qui ne [récupère pas les feature flags](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching), par exemple sur Amazon Bedrock, Agent Platform de Google Cloud ou Microsoft Foundry, peut continuer à l'envoyer.

1054 

1055Pour voir les appels d'outils refusés, interrogez les événements [`tool_decision`](#tool-decision-event), qui indiquent qu'un appel a été refusé, mais pas toujours quelle vérification l'a refusé.

1056 

1057Les détails présentés ici décrivent les événements des versions v2.1.307 à v2.1.311, dans lesquelles un événement de sécurité enregistre des [cas](#safety-event-categories) tels que ceux-ci :

1058 

1059* Une vérification refuse un appel d'outil ou exige une demande de permission, sauf pour les [appels sans événement de sécurité](#calls-without-a-safety-event)

1060* Le [proxy réseau du sandbox](https://code.claude.com/docs/fr/sandboxing.md#network-isolation) refuse une connexion ou une requête

1061* Un hook bloque un résultat ou la fin d'un tour

1050 1062 

1051L'événement est exporté avec les autres événements et ne dispose d'aucun paramètre distinct. Les attributs propres à l'événement ne contiennent aucun texte de commande, chemin de fichier, nom d'hôte, ni nom de serveur ou d'outil MCP. L'enregistrement comporte également les [attributs standard](#standard-attributes) présents sur chaque événement, qui peuvent inclure `workspace.host_paths` et les [attributs de dépôt](#repository-attributes). Pour voir la commande ou l'outil MCP à l'origine d'un événement, définissez `OTEL_LOG_TOOL_DETAILS=1` et lisez `tool_parameters` sur l'événement `tool_decision` correspondant.1063L'événement est exporté avec les autres événements et ne dispose d'aucun paramètre distinct. Les attributs propres à l'événement ne contiennent aucun texte de commande, chemin de fichier, nom d'hôte, ni nom de serveur ou d'outil MCP. L'enregistrement comporte également les [attributs standard](#standard-attributes) présents sur chaque événement, qui peuvent inclure `workspace.host_paths` et les [attributs de dépôt](#repository-attributes). Pour voir la commande ou l'outil MCP à l'origine d'un événement, définissez `OTEL_LOG_TOOL_DETAILS=1` et lisez `tool_parameters` sur l'événement `tool_decision` correspondant.

1052 1064 

1663 1675 

1664### Mapper les questions de sécurité aux événements1676### Mapper les questions de sécurité aux événements

1665 1677 

1678Les lignes concernant `safety_event` s'appliquent uniquement à une session en version v2.1.307 à v2.1.311 qui [envoie encore l'événement](#safety-event).

1679 

1666Lors de la création de règles de détection, recherchez le signal que vous souhaitez surveiller et interrogez votre backend pour l'événement correspondant et les attributs :1680Lors de la création de règles de détection, recherchez le signal que vous souhaitez surveiller et interrogez votre backend pour l'événement correspondant et les attributs :

1667 1681 

1668| Signal | Événement | Attributs clés |1682| Signal | Événement | Attributs clés |

1672| Le classifieur du mode auto a autorisé ou bloqué un appel d'outil, ou Claude Code a refusé l'appel sans verdict du classifieur | [`tool_decision`](#tool-decision-event) lorsque `classifier_verdict` est présent. Pour un refus sans verdict, `classifier_verdict` vaut `"no_verdict"` ou `"unavailable"` | `classifier_verdict`, `permission_mode`, `tool_name` ; `classifier_category` lorsque vous définissez `OTEL_LOG_TOOL_DETAILS=1` |1686| Le classifieur du mode auto a autorisé ou bloqué un appel d'outil, ou Claude Code a refusé l'appel sans verdict du classifieur | [`tool_decision`](#tool-decision-event) lorsque `classifier_verdict` est présent. Pour un refus sans verdict, `classifier_verdict` vaut `"no_verdict"` ou `"unavailable"` | `classifier_verdict`, `permission_mode`, `tool_name` ; `classifier_category` lorsque vous définissez `OTEL_LOG_TOOL_DETAILS=1` |

1673| Escalade du mode de permission | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |1687| Escalade du mode de permission | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |

1674| Mode de permission dans lequel chaque appel d'outil a été vérifié, y compris les appels effectués par les sous-agents | [`tool_decision`](#tool-decision-event) | `permission_mode`, `session.id` |1688| Mode de permission dans lequel chaque appel d'outil a été vérifié, y compris les appels effectués par les sous-agents | [`tool_decision`](#tool-decision-event) | `permission_mode`, `session.id` |

1675| Hook de politique a bloqué une action | `hook_execution_complete` | `hook_event`, `num_blocking` |1689| Hook de politique a bloqué une action | `hook_execution_complete`, qui n'est lié ni à un appel ni à `tool_use_id` | `hook_event`, `num_blocking` |

1676| Quel appel d'outil un hook a refusé, et quel résultat ou quelle fin de tour un hook a bloqué | [`safety_event`](#safety-event) lorsque `category` vaut `"hook"` et `decision` vaut `"reject"` pour un appel refusé, ou lorsque `category` vaut `"hook_review"` pour un résultat ou une fin de tour bloqués | `category`, `decision`, `hook_event` ; `tool_use_id` pour un appel d'outil |1690| Appel d'outil qu'un hook a refusé | [`tool_decision`](#tool-decision-event) lorsque `decision` vaut `"reject"` et `source` vaut `"hook"` | `decision`, `source`, `tool_use_id` |

1691| Quel résultat ou quelle fin de tour un hook a bloqué | [`safety_event`](#safety-event) lorsque `category` vaut `"hook_review"` | `category`, `hook_event` ; `tool_use_id` pour un appel d'outil |

1677| Le proxy réseau du sandbox a refusé une connexion ou une requête provenant d'une commande Bash ou PowerShell | [`safety_event`](#safety-event) lorsque `sandbox_violation_count` est présent et ne vaut pas `"0"` | `sandbox_violation_count`, `category`, `sandbox_enabled`, `tool_use_id` |1692| Le proxy réseau du sandbox a refusé une connexion ou une requête provenant d'une commande Bash ou PowerShell | [`safety_event`](#safety-event) lorsque `sandbox_violation_count` est présent et ne vaut pas `"0"` | `sandbox_violation_count`, `category`, `sandbox_enabled`, `tool_use_id` |

1678| Connexion, déconnexion et défaillance d'authentification | `auth` | `action`, `success`, `error_category` |1693| Connexion, déconnexion et défaillance d'authentification | `auth` | `action`, `success`, `error_category` |

1679| Connexion du serveur MCP ou défaillance | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |1694| Connexion du serveur MCP ou défaillance | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |

25 25 

26Le mode qui examine chaque action s'appelle **Manual** dans la CLI, dans `claude --help`, dans les extensions VS Code et JetBrains, ainsi que dans l'application de bureau. Sa valeur de configuration est `default`, et c'est celle qu'utilisent les hooks et les intégrations SDK. La CLI accepte `manual` comme alias partout où vous saisissez la valeur, par exemple `claude --permission-mode manual` ou `"defaultMode": "manual"`.26Le mode qui examine chaque action s'appelle **Manual** dans la CLI, dans `claude --help`, dans les extensions VS Code et JetBrains, ainsi que dans l'application de bureau. Sa valeur de configuration est `default`, et c'est celle qu'utilisent les hooks et les intégrations SDK. La CLI accepte `manual` comme alias partout où vous saisissez la valeur, par exemple `claude --permission-mode manual` ou `"defaultMode": "manual"`.

27 27 

28Les écritures dans des [chemins protégés](#protected-paths) ne sont jamais approuvées automatiquement, sauf en mode `bypassPermissions` et dans les sessions en mode plan où les permissions de contournement sont disponibles, c'est-à-dire les sessions de terminal interactives démarrées d'une manière qui [place `bypassPermissions` dans le cycle des modes](#switch-permission-modes).28Chaque mode applique sa propre règle aux écritures dans des [chemins protégés](#protected-paths).

29 29 

30Les modes définissent la base. Ajoutez des [règles de permission](https://code.claude.com/docs/fr/permissions.md#manage-permissions) par-dessus pour pré-approuver ou bloquer des outils spécifiques. Les règles de refus bloquent dans tous les modes, y compris `bypassPermissions`. Les règles de refus et de demande ne s'appliquent pas à [`EndConversation`](https://code.claude.com/docs/fr/tools-reference#endconversation-tool-behavior) tant que Claude dispose encore d'au moins un autre outil qu'il peut appeler. Les règles d'autorisation n'ont aucun effet en mode `bypassPermissions`.30Les modes définissent la base. Ajoutez des [règles de permission](https://code.claude.com/docs/fr/permissions.md#manage-permissions) par-dessus pour pré-approuver ou bloquer des outils spécifiques. Les règles de refus bloquent dans tous les modes, y compris `bypassPermissions`. Les règles de refus et de demande ne s'appliquent pas à [`EndConversation`](https://code.claude.com/docs/fr/tools-reference#endconversation-tool-behavior) tant que Claude dispose encore d'au moins un autre outil qu'il peut appeler. Les règles d'autorisation n'ont aucun effet en mode `bypassPermissions`.

31 31 

484* Ouverture d'une pull request vers un dépôt ou une organisation différents, fork avec `gh repo fork` ou push vers un dépôt tiers, à moins que vous n'ayez nommé cette cible externe484* Ouverture d'une pull request vers un dépôt ou une organisation différents, fork avec `gh repo fork` ou push vers un dépôt tiers, à moins que vous n'ayez nommé cette cible externe

485* Contenu issu d'un magasin local sensible, ou d'un fichier dont le nom, le chemin ou le type le marque comme sensible, entrant dans un commit, un push, un texte de PR ou d'issue, un gist ou un paste, ou une publication de paquet, à moins que vous n'ayez nommé à la fois la source et la destination. Les transcriptions de session et les journaux de conversation, les dossiers cachés d'identifiants et de configuration comme les clés SSH, les identifiants cloud, les profils de navigateur et l'historique du shell, ainsi que les exportations de données utilisateur comptent tous, et le fait que le dépôt soit privé ne lève pas le blocage485* Contenu issu d'un magasin local sensible, ou d'un fichier dont le nom, le chemin ou le type le marque comme sensible, entrant dans un commit, un push, un texte de PR ou d'issue, un gist ou un paste, ou une publication de paquet, à moins que vous n'ayez nommé à la fois la source et la destination. Les transcriptions de session et les journaux de conversation, les dossiers cachés d'identifiants et de configuration comme les clés SSH, les identifiants cloud, les profils de navigateur et l'historique du shell, ainsi que les exportations de données utilisateur comptent tous, et le fait que le dépôt soit privé ne lève pas le blocage

486* Écriture dans les transcriptions de session Claude Code, les fichiers d'historique `.jsonl` sous `~/.claude/projects/` ou votre répertoire de configuration configuré, directement ou via une commande shell. La règle couvre également les lignes de métadonnées que Claude Code ajoute à chaque entrée de transcription pour ses propres vérifications. La lecture d'une transcription n'est pas bloquée486* Écriture dans les transcriptions de session Claude Code, les fichiers d'historique `.jsonl` sous `~/.claude/projects/` ou votre répertoire de configuration configuré, directement ou via une commande shell. La règle couvre également les lignes de métadonnées que Claude Code ajoute à chaque entrée de transcription pour ses propres vérifications. La lecture d'une transcription n'est pas bloquée

487* Une suppression forcée récursive comme `rm -rf "$VAR"` ou `Remove-Item -Recurse -Force $dir` dont la cible est une variable shell qui n'est assignée nulle part dans la conversation que le classificateur voit, ou un glob enraciné dans une telle variable. La valeur provenait uniquement d'une sortie de commande antérieure, que le classificateur ne reçoit jamais, donc le classificateur ne peut pas vérifier la cible de suppression par rapport aux autres règles de suppression. Le blocage est levé quand vous nommez le chemin exact en cours de suppression, ou quand Claude réexécute la suppression avec le chemin littéral résolu écrit dans la commande. Les suppressions dont le classificateur peut résoudre la cible ne sont pas affectées.487* Une suppression forcée récursive comme `rm -rf "$VAR"` ou `Remove-Item -Recurse -Force $dir` dont la cible est une variable shell qui n'est pas assignée dans la conversation que le classificateur voit, ou un glob enraciné dans une telle variable. Sans cette assignation, le classificateur ne peut pas savoir ce que la commande supprimerait.

488 488 

489 Un glob directement sous la variable, comme dans `rm -rf "$VAR"/*`, est plutôt un [chemin critique](#critical-paths). Les cibles `Remove-Item` qui sont un `*` seul ou se terminent par `/*` ou `\*` n'atteignent jamais le classificateur : Claude Code les [refuse directement](#remove-item-in-powershell).489 Le blocage est levé quand vous nommez le chemin exact en cours de suppression, ou quand Claude réexécute la suppression avec le chemin littéral résolu écrit dans la commande. Les suppressions dont le classificateur peut résoudre la cible ne sont pas affectées.

490 

491 Un glob directement sous la variable, comme dans `rm -rf "$VAR"/*`, est plutôt un [chemin critique](#critical-paths). Pour une cible `Remove-Item` qui est un `*` seul ou se termine par `/*` ou `\*`, voir [Remove-Item dans PowerShell](#remove-item-in-powershell) : Claude Code refuse directement cette commande.

490 492 

491Plusieurs de ces catégories dépendent d'entrées [d'environnement](https://code.claude.com/docs/fr/auto-mode-config.md#define-trusted-infrastructure), comme les cibles distantes sensibles et les portées IaC protégées, que vous pouvez restreindre à des noms concrets.493Plusieurs de ces catégories dépendent d'entrées [d'environnement](https://code.claude.com/docs/fr/auto-mode-config.md#define-trusted-infrastructure), comme les cibles distantes sensibles et les portées IaC protégées, que vous pouvez restreindre à des noms concrets.

492 494 

730 732 

731## Chemins protégés733## Chemins protégés

732 734 

733Les écritures vers un petit ensemble de chemins ne sont jamais approuvées automatiquement, sauf en mode `bypassPermissions` et dans les sessions de terminal interactif en mode plan avec les [autorisations de contournement](#skip-all-checks-with-bypasspermissions-mode) disponibles. Cela empêche la corruption accidentelle de l'état du référentiel et de la configuration propre de Claude.735Un petit ensemble de chemins contient l'état du dépôt et la configuration propre de Claude ; chaque mode applique donc sa propre règle aux écritures vers ces chemins :

734 736 

735| Mode | Écritures de chemins protégés |737| Mode | Écritures de chemins protégés |

736| :- | :- |738| :- | :- |

737| `default`, `acceptEdits` | Demandé |739| `default`, `acceptEdits` | Demandé |

738| `plan` | Autorisé dans les sessions de terminal interactif avec les [autorisations de contournement](#skip-all-checks-with-bypasspermissions-mode) disponibles. Sinon, acheminé vers le classificateur quand le [mode auto](#eliminate-prompts-with-auto-mode) est disponible pendant la planification, et demandé quand il ne l'est pas |740| `plan` | Autorisé dans les sessions de terminal interactif avec les [autorisations de contournement](#skip-all-checks-with-bypasspermissions-mode) disponibles. Sinon, acheminé vers le classificateur quand le [mode auto](#eliminate-prompts-with-auto-mode) est disponible pendant la planification, et demandé quand il ne l'est pas |

739| `auto` | Acheminé vers le classificateur |741| `auto` | Acheminé vers le classificateur, qui décide |

740| `dontAsk` | Refusé |742| `dontAsk` | Refusé |

741| `bypassPermissions` | Autorisé |743| `bypassPermissions` | Autorisé |

742 744 

185| `disableSideloadFlags` | Rejette `--plugin-dir`, `--plugin-url`, `--agents`, l'option `plugins` de l'Agent SDK et les dossiers nommés dans la variable [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/fr/env-vars#variables) au démarrage, ainsi que `--mcp-config`, sauf si chaque serveur qu'il contient est une entrée in-process `type: "sdk"`. Refuse les dossiers de plugins qu'une application Agent SDK ajoute en cours de session avec [`addPlugins`](https://code.claude.com/docs/fr/agent-sdk/typescript#load-more-plugin-folders-with-addplugins) | Ne restreint pas `.mcp.json`, `claude mcp add` ou les serveurs fournis par le SDK. Associez-le à [`allowedMcpServers`](https://code.claude.com/docs/fr/managed-mcp) |185| `disableSideloadFlags` | Rejette `--plugin-dir`, `--plugin-url`, `--agents`, l'option `plugins` de l'Agent SDK et les dossiers nommés dans la variable [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/fr/env-vars#variables) au démarrage, ainsi que `--mcp-config`, sauf si chaque serveur qu'il contient est une entrée in-process `type: "sdk"`. Refuse les dossiers de plugins qu'une application Agent SDK ajoute en cours de session avec [`addPlugins`](https://code.claude.com/docs/fr/agent-sdk/typescript#load-more-plugin-folders-with-addplugins) | Ne restreint pas `.mcp.json`, `claude mcp add` ou les serveurs fournis par le SDK. Associez-le à [`allowedMcpServers`](https://code.claude.com/docs/fr/managed-mcp) |

186| `disableCommandPluginSources` | Bloque les plugins avec une source `command` de l'installation, de la mise à jour ou du chargement. Une source `command` est celle dont le répertoire de plugins est produit en exécutant une commande sur la machine. Quand non défini, il prend la valeur de `allowManagedHooksOnly` | N'affecte pas les autres types de sources |186| `disableCommandPluginSources` | Bloque les plugins avec une source `command` de l'installation, de la mise à jour ou du chargement. Une source `command` est celle dont le répertoire de plugins est produit en exécutant une commande sur la machine. Quand non défini, il prend la valeur de `allowManagedHooksOnly` | N'affecte pas les autres types de sources |

187| `allowManagedHooksOnly` | Restreint les hooks qui s'exécutent. Voir [`allowManagedHooksOnly`](https://code.claude.com/docs/fr/settings-reference#allowmanagedhooksonly) | Ne fait confiance pas aux hooks des plugins que les utilisateurs activent eux-mêmes |187| `allowManagedHooksOnly` | Restreint les hooks qui s'exécutent. Voir [`allowManagedHooksOnly`](https://code.claude.com/docs/fr/settings-reference#allowmanagedhooksonly) | Ne fait confiance pas aux hooks des plugins que les utilisateurs activent eux-mêmes |

188| `strictPluginOnlyCustomization` | Bloque les skills, les agents, les hooks et les serveurs MCP qui ne proviennent pas d'un plugin, des paramètres gérés ou des éléments intégrés de Claude Code. Empêche également le chargement des [plugins du répertoire de skills](#keep-skills-directory-plugins-loading). Définissez `true` pour couvrir les quatre types, ou un tableau de valeurs `skills`, `agents`, `hooks` et `mcp` telles que `["skills", "hooks"]` pour en couvrir certains | Ne restreint pas les plugins que les utilisateurs installent. Associez-le à `strictKnownMarketplaces` |188| `strictPluginOnlyCustomization` | Bloque les skills, les agents, les hooks et les serveurs MCP provenant des sources utilisateur et projet. Empêche également le chargement des [plugins du répertoire de skills](#keep-skills-directory-plugins-loading). Définissez `true` pour couvrir les quatre types, ou un tableau de valeurs `skills`, `agents`, `hooks` et `mcp` telles que `["skills", "hooks"]` pour en couvrir certains | Ne restreint pas les plugins que les utilisateurs installent et ne rejette pas les flags CLI qui chargent en sideloading des plugins, des agents et des serveurs MCP. Associez-le à `strictKnownMarketplaces` et `disableSideloadFlags` |

189| `pluginSuggestionMarketplaces` | Marketplaces dont les plugins peuvent apparaître comme suggestions d'installation dans le terminal. Voir [Recommander des plugins](#recommend-plugins) | N'affecte pas les conseils intégrés |189| `pluginSuggestionMarketplaces` | Marketplaces dont les plugins peuvent apparaître comme suggestions d'installation dans le terminal. Voir [Recommander des plugins](#recommend-plugins) | N'affecte pas les conseils intégrés |

190| `pluginTrustMessage` | Ajoute votre texte à l'avertissement de confiance que `/plugin` affiche avant l'installation d'un plugin | Ne change pas le texte de l'avertissement lui-même |190| `pluginTrustMessage` | Ajoute votre texte à l'avertissement de confiance que `/plugin` affiche avant l'installation d'un plugin | Ne change pas le texte de l'avertissement lui-même |

191| `allowedChannelPlugins` | Remplace la liste par défaut des plugins autorisés à envoyer des messages de canal. Nécessite `channelsEnabled: true` | Voir [Restreindre les plugins de canal qui peuvent s'exécuter](https://code.claude.com/docs/fr/channels.md#restrict-which-channel-plugins-can-run) |191| `allowedChannelPlugins` | Remplace la liste par défaut des plugins autorisés à envoyer des messages de canal. Nécessite `channelsEnabled: true` | Voir [Restreindre les plugins de canal qui peuvent s'exécuter](https://code.claude.com/docs/fr/channels.md#restrict-which-channel-plugins-can-run) |

336 336 

337### Assigner les canaux de version aux groupes d'utilisateurs337### Assigner les canaux de version aux groupes d'utilisateurs

338 338 

339Pour exécuter des canaux stables et d'accès anticipé, hébergez deux marketplaces qui pointent vers différents refs des mêmes plugins. Ensuite, donnez à chaque groupe d'utilisateurs son propre marketplace via soit des paramètres gérés par le point de terminaison séparés, soit une politique de passerelle. Les paramètres gérés par le serveur de la console d'administration [s'appliquent à chaque utilisateur de votre organisation](https://code.claude.com/docs/fr/server-managed-settings.md#current-limitations), donc ils ne peuvent pas assigner des paramètres différents à différents groupes.339Pour exécuter des canaux stables et d'accès anticipé, hébergez deux marketplaces qui pointent vers différents refs des mêmes plugins. Ensuite, donnez à chaque groupe d'utilisateurs sa propre marketplace via des paramètres gérés par le point de terminaison séparés ou une politique de passerelle. Avec un forfait Enterprise, vous pouvez également utiliser les paramètres gérés par le serveur depuis la console d'administration.

340 340 

341* Déployez des [paramètres gérés par le point de terminaison](https://code.claude.com/docs/fr/managed-settings.md#delivery-mechanisms) séparés, tels qu'un fichier de paramètres gérés ou un profil MDM, sur les appareils de chaque groupe. Pour vérifier si le fichier ou le profil par groupe s'applique sur un appareil qui a également une source au niveau de l'organisation, voir [Comment Claude Code combine les sources gérées](https://code.claude.com/docs/fr/managed-settings.md#precedence-within-the-managed-tier).341* Déployez des [paramètres gérés par le point de terminaison](https://code.claude.com/docs/fr/managed-settings.md#delivery-mechanisms) séparés, tels qu'un fichier de paramètres gérés ou un profil MDM, sur les appareils de chaque groupe. Pour vérifier si le fichier ou le profil par groupe s'applique sur un appareil qui a également une source au niveau de l'organisation, voir [Comment Claude Code combine les sources gérées](https://code.claude.com/docs/fr/managed-settings.md#precedence-within-the-managed-tier).

342* Définissez une [politique de passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway-config.md#managed) par groupe. Par défaut, la passerelle applique la première politique dont la règle de correspondance correspond à un utilisateur, donc ordonnez les politiques pour que chaque utilisateur atteigne la politique de son groupe. La map `extraKnownMarketplaces` de cette politique ne fusionne pas avec celle d'une autre politique, donc listez-y chaque marketplace dont le groupe a besoin, pas seulement son marketplace de canal.342* Définissez une [politique de passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway-config.md#managed) par groupe. Par défaut, la passerelle applique la première politique dont la règle de correspondance correspond à un utilisateur, donc ordonnez les politiques pour que chaque utilisateur atteigne la politique de son groupe. La map `extraKnownMarketplaces` de cette politique ne fusionne pas avec celle d'une autre politique, donc listez-y chaque marketplace dont le groupe a besoin, pas seulement son marketplace de canal.

343* Avec un forfait Enterprise, [donnez à chaque groupe sa propre configuration](https://code.claude.com/docs/fr/server-managed-settings.md#give-groups-different-settings) dans la console d'administration. La configuration d'un groupe ne fusionne pas avec celle de l'ensemble de l'organisation, donc placez chaque paramètre dont le groupe a besoin dans la configuration propre au groupe, y compris chaque marketplace.

343 344 

344Avec l'un ou l'autre mécanisme, le groupe stable reçoit cette configuration :345Avec n'importe lequel de ces mécanismes, le groupe stable reçoit ce paramètre :

345 346 

346```json theme={null}347```json theme={null}

347{348{

383 384 

384Ces demandes des examens de sécurité n'ont pas de clé dédiée dans le schéma de paramètres actuel. Les contrôles existants les plus proches sont :385Ces demandes des examens de sécurité n'ont pas de clé dédiée dans le schéma de paramètres actuel. Les contrôles existants les plus proches sont :

385 386 

386* **Ciblage par utilisateur ou par groupe** : chaque clé de plugin s'applique à chaque utilisateur qui reçoit les paramètres. Les paramètres gérés par le serveur livrent une configuration par organisation. Pour une politique par groupe, utilisez des paramètres gérés par le point de terminaison séparés ou des politiques de passerelle, comme sous [Assigner les canaux de version aux groupes d'utilisateurs](#assign-release-channels-to-user-groups).387* **Ciblage par utilisateur ou par groupe** : chaque clé de plugin s'applique à chaque utilisateur qui reçoit les paramètres. Pour une politique par groupe, fournissez à chaque groupe ses propres paramètres, comme sous [Assigner les canaux de version aux groupes d'utilisateurs](#assign-release-channels-to-user-groups).

387* **Restreindre les entrées à l'intérieur d'un marketplace autorisé** : la liste blanche correspond aux sources de marketplace. Pour bloquer un plugin d'un marketplace autorisé, définissez-le sur `false` dans `enabledPlugins` géré.388* **Restreindre les entrées à l'intérieur d'un marketplace autorisé** : la liste blanche correspond aux sources de marketplace. Pour bloquer un plugin d'un marketplace autorisé, définissez-le sur `false` dans `enabledPlugins` géré.

388* **Masquer `/plugin`** : aucune clé ne désactive la commande. L'équivalent le plus proche combine une liste blanche nommant uniquement votre marketplace, des entrées `enabledPlugins` gérées pour les plugins que vous fournissez, et `disableSideloadFlags`.389* **Masquer `/plugin`** : aucune clé ne désactive la commande. L'équivalent le plus proche combine une liste blanche nommant uniquement votre marketplace, des entrées `enabledPlugins` gérées pour les plugins que vous fournissez, et `disableSideloadFlags`.

389* **Contrôler `--plugin-dir` via la liste blanche** : la liste blanche ne couvre pas `--plugin-dir`. `disableSideloadFlags` le fait.390* **Contrôler `--plugin-dir` via la liste blanche** : la liste blanche ne couvre pas `--plugin-dir`. `disableSideloadFlags` le fait.

31>31>

32> **macOS, Linux, WSL :**32> **macOS, Linux, WSL :**

33>33>

34> ```bash theme={null}34> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

35> curl -fsSL https://claude.ai/install.sh | bash35> curl -fsSL https://claude.ai/install.sh | bash

36> ```36> ```

37>37>

39>39>

40> **Windows PowerShell :**40> **Windows PowerShell :**

41>41>

42> ```powershell theme={null}42> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

43> irm https://claude.ai/install.ps1 | iex43> irm https://claude.ai/install.ps1 | iex

44> ```44> ```

45>45>

46> **Windows CMD :**46> **Windows CMD :**

47>47>

48> ```batch theme={null}48> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50> ```50> ```

51>51>

63 63 

64> [tab] Homebrew64> [tab] Homebrew

65>65>

66> ```bash theme={null}66> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

67> brew install --cask claude-code67> brew install --cask claude-code

68> ```68> ```

69>69>

75 75 

76> [tab] WinGet76> [tab] WinGet

77>77>

78> ```powershell theme={null}78> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

79> winget install Anthropic.ClaudeCode79> winget install Anthropic.ClaudeCode

80> ```80> ```

81>81>

257 257 

258| Commande | Ce qu'elle fait | Exemple |258| Commande | Ce qu'elle fait | Exemple |

259| - | - | - |259| - | - | - |

260| `/clear` | Effacer l'historique des conversations | `/clear` |260| `/clear` | Démarrer une nouvelle conversation. Reprendre la précédente avec `/resume`. | `/clear` |

261| `/help` | Afficher les commandes disponibles | `/help` |261| `/help` | Afficher les commandes disponibles | `/help` |

262| `/exit` ou Ctrl+D deux fois | Quitter Claude Code | `/exit` |262| `/exit` ou Ctrl+D deux fois | Quitter Claude Code | `/exit` |

263 263 

33 * Vous pointez [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/fr/env-vars) vers un hôte autre que `api.anthropic.com`, tel qu'une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) ou un proxy. Déconfigurez la variable pour utiliser Remote Control.33 * Vous pointez [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/fr/env-vars) vers un hôte autre que `api.anthropic.com`, tel qu'une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) ou un proxy. Déconfigurez la variable pour utiliser Remote Control.

34 * Vous vous connectez via une passerelle [Claude apps gateway](https://code.claude.com/docs/fr/claude-apps-gateway) d'entreprise.34 * Vous vous connectez via une passerelle [Claude apps gateway](https://code.claude.com/docs/fr/claude-apps-gateway) d'entreprise.

35* **Évaluation des drapeaux de fonctionnalité** : si vous définissez une [variable d'environnement qui désactive l'évaluation des drapeaux de fonctionnalité](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching), la disponibilité de Remote Control dépend de celle-ci :35* **Évaluation des drapeaux de fonctionnalité** : si vous définissez une [variable d'environnement qui désactive l'évaluation des drapeaux de fonctionnalité](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching), la disponibilité de Remote Control dépend de celle-ci :

36 * Si vous définissez `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK`, Remote Control n'est pas disponible. Déconfigurez la variable partout où elle est définie, dans votre environnement shell ou dans le bloc `env` d'un [fichier `settings.json`](https://code.claude.com/docs/fr/settings-reference#all-settings), pour utiliser Remote Control.36 * Si vous définissez `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/fr/env-vars#variables), Remote Control n'est pas disponible. Déconfigurez la variable partout où elle est définie, dans votre environnement shell ou dans le bloc `env` d'un [fichier `settings.json`](https://code.claude.com/docs/fr/settings-reference#all-settings), pour utiliser Remote Control.

37 * Si vous définissez uniquement `DISABLE_TELEMETRY` ou `DO_NOT_TRACK`, Remote Control reste disponible sauf si votre organisation exige des [appareils de confiance](#trusted-devices). Si c'est le cas, déconfigurez la variable pour utiliser Remote Control. L'utilisation de Remote Control avec l'une ou l'autre de ces variables définies nécessite Claude Code v2.1.283 ou version ultérieure, ou v2.1.304 ou version ultérieure dans l'application Claude Desktop.37 * Si vous définissez uniquement `DISABLE_TELEMETRY` ou `DO_NOT_TRACK`, Remote Control reste disponible sauf si votre organisation exige des [appareils de confiance](#trusted-devices). Si c'est le cas, déconfigurez la variable pour utiliser Remote Control. L'utilisation de Remote Control avec l'une ou l'autre de ces variables définies nécessite Claude Code v2.1.283 ou version ultérieure, ou v2.1.304 ou version ultérieure dans l'application Claude Desktop.

38* **Confiance de l'espace de travail** : dans un répertoire que vous n'avez pas encore approuvé, `claude remote-control` affiche ce que l'approbation active et demande `Trust <directory>? [y/N]` avant de démarrer. Répondre `y` enregistre le choix, sauf dans votre répertoire personnel, où la confiance n'est jamais enregistrée et la question revient à chaque exécution. Lorsque son entrée ou sa sortie standard n'est pas un terminal, la commande ne peut pas demander et se termine avec une erreur [`Workspace not trusted`](https://code.claude.com/docs/fr/errors#workspace-not-trusted-when-starting-remote-control).38* **Confiance de l'espace de travail** : dans un répertoire que vous n'avez pas encore approuvé, `claude remote-control` affiche ce que l'approbation active et demande `Trust <directory>? [y/N]` avant de démarrer. Répondre `y` enregistre le choix, sauf dans votre répertoire personnel, où la confiance n'est jamais enregistrée et la question revient à chaque exécution. Lorsque son entrée ou sa sortie standard n'est pas un terminal, la commande ne peut pas demander et se termine avec une erreur [`Workspace not trusted`](https://code.claude.com/docs/fr/errors#workspace-not-trusted-when-starting-remote-control).

39 39 

217 217 

218#### Connexion automatique avec `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` défini218#### Connexion automatique avec `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` défini

219 219 

220Lorsque seul `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, vos sessions ne se connectent pas automatiquement via la valeur par défaut définie par l'administrateur de votre organisation ni via la valeur par défaut de Claude Code. Si un autre élément rend Remote Control indisponible pour vous, comme `DISABLE_GROWTHBOOK` ou une passerelle LLM, commencez plutôt par la section [Prérequis](#requirements).220Lorsque seul `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, vos sessions ne se connectent pas automatiquement via la valeur par défaut définie par l'administrateur de votre organisation ni via la valeur par défaut de Claude Code. Si un autre élément rend Remote Control indisponible pour vous, comme [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/fr/env-vars#variables) ou une passerelle LLM, commencez plutôt par la section [Prérequis](#requirements).

221 221 

222Avant d'activer la connexion automatique alors que seul `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, vérifiez que votre version de Claude Code satisfait l'[exigence relative à ces variables](#requirements). Vérifiez ensuite si votre organisation exige les [Trusted Devices](#trusted-devices) :222Avant d'activer la connexion automatique alors que seul `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, vérifiez que votre version de Claude Code satisfait l'[exigence relative à ces variables](#requirements). Vérifiez ensuite si votre organisation exige les [Trusted Devices](#trusted-devices) :

223 223 

458 458 

459Une [variable d'environnement](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching) qui désactive l'évaluation des feature-flags est définie, et le message complet nomme la variable que Claude Code a trouvée. Sur les versions antérieures à 2.1.154, la même configuration produit « Remote Control is not yet enabled for your account » à la place. Ce qu'il faut faire dépend de la variable que le message nomme :459Une [variable d'environnement](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching) qui désactive l'évaluation des feature-flags est définie, et le message complet nomme la variable que Claude Code a trouvée. Sur les versions antérieures à 2.1.154, la même configuration produit « Remote Control is not yet enabled for your account » à la place. Ce qu'il faut faire dépend de la variable que le message nomme :

460 460 

461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK`** : supprimez la variable partout où elle est définie, dans votre environnement shell ou dans le bloc `env` d'un [fichier `settings.json`](https://code.claude.com/docs/fr/settings-reference#all-settings).461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` ou `DISABLE_GROWTHBOOK`** : supprimez la variable partout où elle est définie, dans votre environnement shell ou dans le bloc `env` d'un [fichier `settings.json`](https://code.claude.com/docs/fr/settings-reference#all-settings).

462* **`DISABLE_TELEMETRY` ou `DO_NOT_TRACK`** : sur un plan Pro, Max, Ultra, Team ou Enterprise avec `DISABLE_GROWTHBOOK` non défini, Remote Control reste disponible lorsque ces variables sont définies, sauf si votre organisation exige [Trusted Devices](#trusted-devices). Si c'est le cas, supprimez la variable partout où elle est définie pour utiliser Remote Control. De la v2.1.154 à la v2.1.282, vous voyez ce message lorsque l'une ou l'autre variable est définie ; mettez donc à jour Claude Code vers une version qui satisfait à l'[exigence relative à ces variables](#requirements).462* **`DISABLE_TELEMETRY` ou `DO_NOT_TRACK`** : sur un plan Pro, Max, Ultra, Team ou Enterprise avec `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` et `DISABLE_GROWTHBOOK` non définis, Remote Control reste disponible lorsque ces variables sont définies, sauf si votre organisation exige [Trusted Devices](#trusted-devices). Si c'est le cas, supprimez la variable partout où elle est définie pour utiliser Remote Control. De la v2.1.154 à la v2.1.282, vous voyez ce message lorsque l'une ou l'autre variable est définie ; mettez donc à jour Claude Code vers une version qui satisfait à l'[exigence relative à ces variables](#requirements).

463 463 

464### « Remote Control is only available when using Claude via api.anthropic.com »464### « Remote Control is only available when using Claude via api.anthropic.com »

465 465 

111* **Environment variables** : fournissez des valeurs que Claude peut utiliser pendant chaque exécution. Elles sont [visibles par quiconque utilise l'environnement](https://code.claude.com/docs/fr/cloud-environments.md#what-carries-over-from-your-setup), donc dans un environnement hébergé par Anthropic, stockez plutôt les clés des API que Claude appelle pendant une exécution en tant que [secrets réseau](https://code.claude.com/docs/fr/cloud-environments.md#add-network-secrets). Cette section liste également les requêtes qui ne reçoivent jamais de secret111* **Environment variables** : fournissez des valeurs que Claude peut utiliser pendant chaque exécution. Elles sont [visibles par quiconque utilise l'environnement](https://code.claude.com/docs/fr/cloud-environments.md#what-carries-over-from-your-setup), donc dans un environnement hébergé par Anthropic, stockez plutôt les clés des API que Claude appelle pendant une exécution en tant que [secrets réseau](https://code.claude.com/docs/fr/cloud-environments.md#add-network-secrets). Cette section liste également les requêtes qui ne reçoivent jamais de secret

112* **Setup script** : installez les dépendances et les outils dont la tâche a besoin. Le résultat est [mis en cache](https://code.claude.com/docs/fr/cloud-environments.md#environment-caching), de sorte que le script ne se réexécute pas à chaque session112* **Setup script** : installez les dépendances et les outils dont la tâche a besoin. Le résultat est [mis en cache](https://code.claude.com/docs/fr/cloud-environments.md#environment-caching), de sorte que le script ne se réexécute pas à chaque session

113 113 

114Un environnement **Default** est fourni avec un accès réseau **Trusted**, qui n'autorise que la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains) des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants à travers le réseau de la session. Les connecteurs que vous ajoutez à la tâche atteignent leurs services via les serveurs d'Anthropic, ils n'ont donc pas besoin de modifications de la liste d'autorisation.114Un environnement **Default** est fourni avec un accès réseau **Limited** et l'option **Allow package managers** cochée. Ses exécutions atteignent la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains) : registres de paquets, API de fournisseurs cloud, registres de conteneurs et domaines de développement courants. Les connecteurs que vous ajoutez à la tâche atteignent leurs services via les serveurs d'Anthropic, ils n'ont donc pas besoin de modifications de la liste d'autorisation.

115 115 

116Si votre tâche doit atteindre directement vos propres services, ou un domaine en dehors de cette liste, modifiez l'[accès réseau](https://code.claude.com/docs/fr/cloud-environments.md#network-access) de l'environnement avant l'exécution. Pour utiliser un environnement distinct, [créez-en un](https://code.claude.com/docs/fr/cloud-environments.md#configure-your-environment) d'abord.116Si votre tâche doit atteindre directement vos propres services, ou un domaine en dehors de cette liste, modifiez l'[accès réseau](https://code.claude.com/docs/fr/cloud-environments.md#network-access) de l'environnement avant l'exécution. Pour utiliser un environnement distinct, [créez-en un](https://code.claude.com/docs/fr/cloud-environments.md#configure-your-environment) d'abord.

117 117 

431 431 

432Chaque tâche planifiée utilise un [environnement cloud](https://code.claude.com/docs/fr/cloud-environments.md) qui contrôle l'accès réseau, les variables d'environnement et les scripts de configuration. La tâche hérite de la politique réseau de l'environnement à chaque exécution.432Chaque tâche planifiée utilise un [environnement cloud](https://code.claude.com/docs/fr/cloud-environments.md) qui contrôle l'accès réseau, les variables d'environnement et les scripts de configuration. La tâche hérite de la politique réseau de l'environnement à chaque exécution.

433 433 

434L'environnement **Default** utilise l'accès réseau **Trusted**, qui n'autorise que la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains) à travers le réseau de la session. Les requêtes sur ce chemin vers des hôtes en dehors de la liste d'autorisation échouent avec `403` et `x-deny-reason: host_not_allowed`. Le trafic des connecteurs MCP est acheminé via les serveurs d'Anthropic plutôt que par ce chemin, de sorte que les connecteurs que vous ajoutez à la tâche fonctionnent sans ajouter leurs hôtes aux **Allowed domains**. Supprimez les connecteurs dont vous n'avez pas besoin sous [Connecteurs](#connectors).434L'environnement **Default** utilise l'accès **Limited** avec **Allow package managers** coché, de sorte que ses exécutions atteignent la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains). Une requête vers un hôte bloqué échoue avec `403` et `x-deny-reason: host_not_allowed`. Le trafic des connecteurs MCP est acheminé via les serveurs d'Anthropic, de sorte que les connecteurs que vous ajoutez à la tâche fonctionnent sans ajouter leurs hôtes aux **Allowed domains**. Supprimez les connecteurs dont vous n'avez pas besoin sous [Connecteurs](#connectors).

435 435 

436Pour autoriser des domaines supplémentaires sur l'un de vos propres environnements, suivez ces étapes. Un [environnement partagé par l'organisation](https://code.claude.com/docs/fr/cloud-environments.md#organization-shared-environments) s'ouvre ici en lecture seule ; c'est donc un propriétaire qui modifie son accès réseau depuis la page **Cloud environments** des [paramètres d'administration](https://claude.ai/admin-settings).436Pour autoriser des domaines supplémentaires sur l'un de vos propres environnements, suivez ces étapes. Un [environnement partagé par l'organisation](https://code.claude.com/docs/fr/cloud-environments.md#organization-shared-environments) s'ouvre ici en lecture seule ; c'est donc un propriétaire qui modifie son accès réseau depuis la page **Cloud environments** des [paramètres d'administration](https://claude.ai/admin-settings).

437 437 

447 447 

448Survolez l'environnement dans la liste et cliquez sur l'icône de paramètres qui apparaît à droite.448Survolez l'environnement dans la liste et cliquez sur l'icône de paramètres qui apparaît à droite.

449 449 

450**4. Modifier le niveau d'accès réseau**450**4. Ajouter les domaines**

451 451 

452Dans la boîte de dialogue **Edit cloud environment**, passez **Network access** sur **Custom** et saisissez vos domaines dans **Allowed domains**. Cochez **Also include default list of common package managers** pour conserver la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains) en plus de vos domaines personnalisés. Sélectionnez plutôt **Full** pour un accès sans restriction.452Dans la boîte de dialogue **Edit cloud environment**, sélectionnez **Limited** sous **Network access** et saisissez vos domaines dans **Allowed domains**. Cochez **Allow package managers** pour autoriser la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains) en plus de vos propres domaines. Sélectionnez plutôt **Full** pour un accès sans restriction.

453 453 

454**5. Enregistrer**454**5. Enregistrer**

455 455 

6 6 

7> Comparez les options de sandbox Claude Code : l'outil Bash sandboxé intégré, le runtime sandbox, les dev containers, Docker et les machines virtuelles. Choisissez l'isolation appropriée pour votre modèle de menace.7> Comparez les options de sandbox Claude Code : l'outil Bash sandboxé intégré, le runtime sandbox, les dev containers, Docker et les machines virtuelles. Choisissez l'isolation appropriée pour votre modèle de menace.

8 8 

9L'isolation de Claude Code limite ce qu'une session peut lire, écrire et atteindre sur le réseau. Cela importe surtout lorsque vous laissez Claude travailler avec moins d'invites de permission, l'exécutez sans surveillance ou le pointez vers du code en lequel vous n'avez pas entièrement confiance.9L'isolation de Claude Code limite ce qu'une session peut lire, écrire et atteindre sur le réseau. Cela importe surtout lorsque vous laissez Claude travailler avec moins de demandes de permission ou l'exécutez sans surveillance.

10 10 

11Claude Code peut s'exécuter dans plusieurs types d'environnements isolés, allant d'un sandbox léger par commande à une machine virtuelle entièrement séparée. Cette page compare ces options selon ce qu'elles isolent et ce qu'elles nécessitent, vous aide à en choisir une pour votre modèle de menace et montre comment appliquer ce choix dans toute une organisation.11Claude Code peut s'exécuter dans plusieurs types d'environnements isolés, allant d'un sandbox léger par commande à une machine virtuelle entièrement séparée. Cette page compare ces options selon ce qu'elles isolent et ce qu'elles nécessitent, vous aide à en choisir une pour votre modèle de menace et montre comment appliquer ce choix dans toute une organisation.

12 12 

44| Réduire les invites de permission pendant le travail quotidien sur votre propre machine | L'[outil Bash sandboxé](https://code.claude.com/docs/fr/sandboxing.md), configuré avec `/sandbox` |44| Réduire les invites de permission pendant le travail quotidien sur votre propre machine | L'[outil Bash sandboxé](https://code.claude.com/docs/fr/sandboxing.md), configuré avec `/sandbox` |

45| Laisser Claude travailler sans surveillance avec `--dangerously-skip-permissions` ou en mode auto | Le [dev container](https://code.claude.com/docs/fr/devcontainer.md) préconfiguré, n'importe quel conteneur ou VM, ou le [runtime sandbox](#sandbox-runtime) |45| Laisser Claude travailler sans surveillance avec `--dangerously-skip-permissions` ou en mode auto | Le [dev container](https://code.claude.com/docs/fr/devcontainer.md) préconfiguré, n'importe quel conteneur ou VM, ou le [runtime sandbox](#sandbox-runtime) |

46| Isoler les serveurs MCP et les hooks ainsi que Bash, sans Docker | Le runtime sandbox |46| Isoler les serveurs MCP et les hooks ainsi que Bash, sans Docker | Le runtime sandbox |

47| Travailler sur un référentiel non fiable | Une machine virtuelle dédiée, ou une [session cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md) si vous avez un abonnement Claude ; GitHub n'est pas requis lorsque vous lancez avec `claude --cloud` |

48| Standardiser un environnement sandboxé dans une équipe | Le [dev container](https://code.claude.com/docs/fr/devcontainer.md) préconfiguré, copié dans votre référentiel |47| Standardiser un environnement sandboxé dans une équipe | Le [dev container](https://code.claude.com/docs/fr/devcontainer.md) préconfiguré, copié dans votre référentiel |

49| Utiliser Claude Code à partir d'un appareil sans configuration locale | Une [session cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md), qui nécessite un abonnement Claude, et un compte GitHub connecté pour cloner un dépôt GitHub |48| Utiliser Claude Code à partir d'un appareil sans configuration locale | Une [session cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md), qui nécessite un abonnement Claude, et un compte GitHub connecté pour cloner un dépôt GitHub |

50| Exiger l'isolation pour chaque développeur de votre organisation | [Appliquer l'isolation dans une organisation](#enforce-isolation-across-an-organization) |49| Exiger l'isolation pour chaque développeur de votre organisation | [Appliquer l'isolation dans une organisation](#enforce-isolation-across-an-organization) |

157 156 

158## Machine virtuelle157## Machine virtuelle

159 158 

160Une machine virtuelle dédiée fournit la séparation la plus forte, avec son propre noyau et, dans les déploiements cloud ou microVM, son propre matériel virtualisé. Les options incluent les instances cloud, les hyperviseurs locaux et les microVMs tels que Firecracker. Utilisez cette approche lorsque vous évaluez du code non fiable, lorsque votre politique de sécurité nécessite une séparation au niveau du noyau entre l'agent et l'hôte, ou lorsqu'aucune approche au niveau de l'hôte ne répond à vos exigences de conformité.159Une machine virtuelle dédiée fournit la séparation la plus forte, avec son propre noyau et, dans les déploiements cloud ou microVM, son propre matériel virtualisé. Les options incluent les instances cloud, les hyperviseurs locaux et les microVMs tels que Firecracker. Utilisez cette approche lorsque votre politique de sécurité nécessite une séparation au niveau du noyau entre l'agent et l'hôte, ou lorsqu'aucune approche au niveau de l'hôte ne répond à vos exigences de conformité.

161 160 

162[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) fournit une microVM avec son propre daemon Docker et synchronisation d'espace de travail, qui peut exécuter Claude Code sur n'importe quel hôte avec Docker Sandboxes installé. C'est un produit gratuit et autonome de Docker qui ne nécessite pas Docker Desktop.161[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) fournit une microVM avec son propre daemon Docker et synchronisation d'espace de travail, qui peut exécuter Claude Code sur n'importe quel hôte avec Docker Sandboxes installé. C'est un produit gratuit et autonome de Docker qui ne nécessite pas Docker Desktop.

163 162 

739 739 

740Le sandbox ne s'exécute pas sur Windows natif, donc avec `failIfUnavailable` défini, Claude Code se ferme au démarrage sur ces machines. Si votre flotte inclut des hôtes Windows, vous pouvez :740Le sandbox ne s'exécute pas sur Windows natif, donc avec `failIfUnavailable` défini, Claude Code se ferme au démarrage sur ces machines. Si votre flotte inclut des hôtes Windows, vous pouvez :

741 741 

742* **Livrer la configuration par système d'exploitation** : déployez-la via votre MDM ou en tant que [fichier de paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md#delivery-mechanisms) uniquement sur les machines macOS et Linux. Les [paramètres gérés par serveur](https://code.claude.com/docs/fr/server-managed-settings.md#current-limitations) s'appliquent à tous les utilisateurs de l'organisation742* **Livrer la configuration par système d'exploitation** : déployez-la via votre MDM ou en tant que [fichier de paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md#delivery-mechanisms) uniquement sur les machines macOS et Linux. Les [paramètres gérés par serveur](https://code.claude.com/docs/fr/server-managed-settings.md#give-groups-different-settings) suivent le membre, pas l'appareil.

743* **Déplacer les utilisateurs Windows vers un environnement pris en charge** : demandez-leur d'exécuter Claude Code à l'intérieur de WSL2 ou d'un conteneur743* **Déplacer les utilisateurs Windows vers un environnement pris en charge** : demandez-leur d'exécuter Claude Code à l'intérieur de WSL2 ou d'un conteneur

744 744 

745### Empêcher les développeurs d'élargir la politique745### Empêcher les développeurs d'élargir la politique

92* s'occuper de la demande de fusion de la branche actuelle : examiner les commentaires, les exécutions CI échouées, les conflits de fusion92* s'occuper de la demande de fusion de la branche actuelle : examiner les commentaires, les exécutions CI échouées, les conflits de fusion

93* exécuter des passes de nettoyage telles que la chasse aux bogues ou la simplification quand rien d'autre n'est en attente93* exécuter des passes de nettoyage telles que la chasse aux bogues ou la simplification quand rien d'autre n'est en attente

94 94 

95Claude ne lance pas de nouvelles initiatives en dehors de cette portée, et les actions irréversibles telles que pousser ou supprimer ne procèdent que lorsqu'elles continuent quelque chose que la transcription a déjà autorisé.95Chaque exécution passe par les [vérifications de permissions](https://code.claude.com/docs/fr/permissions.md) de votre session avant de pousser ou de supprimer quoi que ce soit.

96 

97Un `/loop` nu exécute ce prompt à un [intervalle choisi dynamiquement](#let-claude-choose-the-interval) :

96 98 

97```text theme={null}99```text theme={null}

98/loop100/loop

99```101```

100 102 

101Un `/loop` nu exécute ce prompt à un [intervalle choisi dynamiquement](#let-claude-choose-the-interval). Ajoutez un intervalle, par exemple `/loop 15m`, pour l'exécuter selon un calendrier fixe à la place. Pour remplacer le prompt intégré par le vôtre, consultez [Personnaliser le prompt par défaut avec loop.md](#customize-the-default-prompt-with-loop-md).103Ajoutez un intervalle, par exemple `/loop 15m`, pour l'exécuter selon un calendrier fixe à la place. Pour remplacer le prompt intégré par votre propre prompt par défaut, consultez [Personnaliser le prompt par défaut avec loop.md](#customize-the-default-prompt-with-loop-md).

102 104 

103### Personnaliser le prompt par défaut avec loop.md105### Personnaliser le prompt par défaut avec loop.md

104 106 

227 229 

228## Désactiver les tâches planifiées limitées à la session230## Désactiver les tâches planifiées limitées à la session

229 231 

230Définissez `CLAUDE_CODE_DISABLE_CRON=1` dans votre environnement pour désactiver complètement le planificateur. Les outils cron et `/loop` deviennent indisponibles, et toutes les tâches déjà planifiées cessent de s'exécuter. Consultez [Variables d'environnement](https://code.claude.com/docs/fr/env-vars.md) pour la liste complète des drapeaux de désactivation.232Définissez `CLAUDE_CODE_DISABLE_CRON=1` dans votre environnement pour désactiver complètement le planificateur. `CronCreate` et `/loop` deviennent indisponibles, et toutes les tâches déjà planifiées cessent de s'exécuter. Tant que le fichier `.claude/scheduled_tasks.json` du projet contient des tâches, `CronList` et `CronDelete` restent disponibles, de sorte que vous pouvez toujours demander à Claude de les lister ou de les annuler. Consultez [Variables d'environnement](https://code.claude.com/docs/fr/env-vars.md) pour la liste complète des flags de désactivation.

231 233 

232## Limitations234## Limitations

233 235 

183 183 

184* **Un dépôt vers lequel la session envoie les résultats** : le runner fait échouer la session et, en cas de sortie non nulle, affiche à l'utilisateur la fin du stderr du script. Écrivez la raison dans stderr sur une seule ligne courte, écrivez-la en dernier, puis terminez avec un code non nul. N'affichez pas de secrets dans stderr, et supprimez `set -x` avant de déployer le hook.184* **Un dépôt vers lequel la session envoie les résultats** : le runner fait échouer la session et, en cas de sortie non nulle, affiche à l'utilisateur la fin du stderr du script. Écrivez la raison dans stderr sur une seule ligne courte, écrivez-la en dernier, puis terminez avec un code non nul. N'affichez pas de secrets dans stderr, et supprimez `set -x` avant de déployer le hook.

185 185 

186 Si le message git `couldn't find remote ref` apparaît dans environ les 4 derniers Ko du stderr du hook, le runner signale plutôt une branche supprimée. Le message d'erreur de la session indique alors que la branche n'existe plus sur le remote et demande à l'utilisateur de la restaurer. Si cette branche existe, voir [Une session échoue avec `no longer exists on the remote` ou `couldn't find remote ref`](https://code.claude.com/docs/fr/self-hosted-environments-deploy#no-longer-exists-on-the-remote).186 Si le message git `couldn't find remote ref` apparaît dans environ les 4 derniers Ko du stderr du hook, le runner signale plutôt une branche manquante. Si cette branche existe, voir [Une session échoue avec `couldn't be found in the remote repository` ou `couldn't find remote ref`](https://code.claude.com/docs/fr/self-hosted-environments-deploy#no-longer-exists-on-the-remote).

187* **Un dépôt que la session lit uniquement**, comme un dépôt ajouté à une session en cours d'exécution : le runner l'ignore et continue avec les dépôts restants. Le runner publie une étape `Skipped` dans la session et supprime ce que le hook a laissé au chemin de checkout.187* **Un dépôt que la session lit uniquement**, comme un dépôt ajouté à une session en cours d'exécution : le runner l'ignore et continue avec les dépôts restants. Le runner publie une étape `Skipped` dans la session et supprime ce que le hook a laissé au chemin de checkout.

188 188 

189 Lorsque l'étape `Skipped` mentionne le hook de checkout, trouvez le détail de l'échec sur la ligne `[runner:warn] checkout hook failed` dans le log du runner. Lorsque l'étape indique qu'une ref source `no longer exists on remote`, voir [Une session échoue avec `no longer exists on the remote` ou `couldn't find remote ref`](https://code.claude.com/docs/fr/self-hosted-environments-deploy#no-longer-exists-on-the-remote). Si l'omission laisse la session sans aucun dépôt, le runner fait quand même échouer la session.189 Lorsque l'étape `Skipped` mentionne le hook de checkout, trouvez le détail de l'échec sur la ligne `[runner:warn] checkout hook failed` dans le log du runner. Lorsque l'étape indique qu'une ref source `no longer exists on remote`, voir [Une session échoue avec `couldn't be found in the remote repository` ou `couldn't find remote ref`](https://code.claude.com/docs/fr/self-hosted-environments-deploy#no-longer-exists-on-the-remote). Si l'omission laisse la session sans aucun dépôt, le runner fait quand même échouer la session.

190 190 

191Lorsque le hook réussit, le runner supprime le chemin de checkout après la fin de la session.191Lorsque le hook réussit, le runner supprime le chemin de checkout après la fin de la session.

192 192 

638 638 

639* Le [fichier MCP géré](https://code.claude.com/docs/fr/managed-mcp.md) de portée entreprise, à son chemin système standard : `/etc/claude-code/managed-mcp.json` sur les hôtes de runner Linux, `/Library/Application Support/ClaudeCode/managed-mcp.json` sur les hôtes macOS. Utilisez-le pour les parcs verrouillés où seuls les serveurs listés par un administrateur peuvent être chargés. Consultez [le contrôle exclusif avec managed-mcp.json](https://code.claude.com/docs/fr/managed-mcp.md#exclusive-control-with-managed-mcp-json) pour les règles de priorité. Lorsque ce fichier est présent sur l'hôte du runner, Claude Code ignore les serveurs MCP que le plan de contrôle d'Anthropic fournit à une session, y compris les connecteurs claude.ai, et les nomme dans un avertissement sur la sortie stderr du processus enfant de la session, que le runner enregistre au niveau de log `debug`. Avant la v2.1.229, ces sessions se terminaient au démarrage avec `You cannot dynamically configure MCP servers when an enterprise MCP config is present`.639* Le [fichier MCP géré](https://code.claude.com/docs/fr/managed-mcp.md) de portée entreprise, à son chemin système standard : `/etc/claude-code/managed-mcp.json` sur les hôtes de runner Linux, `/Library/Application Support/ClaudeCode/managed-mcp.json` sur les hôtes macOS. Utilisez-le pour les parcs verrouillés où seuls les serveurs listés par un administrateur peuvent être chargés. Consultez [le contrôle exclusif avec managed-mcp.json](https://code.claude.com/docs/fr/managed-mcp.md#exclusive-control-with-managed-mcp-json) pour les règles de priorité. Lorsque ce fichier est présent sur l'hôte du runner, Claude Code ignore les serveurs MCP que le plan de contrôle d'Anthropic fournit à une session, y compris les connecteurs claude.ai, et les nomme dans un avertissement sur la sortie stderr du processus enfant de la session, que le runner enregistre au niveau de log `debug`. Avant la v2.1.229, ces sessions se terminaient au démarrage avec `You cannot dynamically configure MCP servers when an enterprise MCP config is present`.

640* La clé [`managedMcpServers`](https://code.claude.com/docs/fr/settings-reference#managedmcpservers) dans les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) sur l'hôte du runner : elle fournit des serveurs HTTP et SSE sans prendre le contrôle exclusif, de sorte que les serveurs des autres sources sont toujours chargés. Nécessite Claude Code v2.1.259 ou une version ultérieure.640* La clé [`managedMcpServers`](https://code.claude.com/docs/fr/settings-reference#managedmcpservers) dans les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) sur l'hôte du runner : elle fournit des serveurs HTTP et SSE sans prendre le contrôle exclusif, de sorte que les serveurs des autres sources sont toujours chargés. Nécessite Claude Code v2.1.259 ou une version ultérieure.

641* `<repo>/.mcp.json` : portée projet. En dehors d'un fil de [projet](https://code.claude.com/docs/fr/claude-projects.md#what-threads-pick-up-from-your-repositories), faites un commit du fichier dans le dépôt ; ses serveurs sont approuvés automatiquement dans les sessions cloud. Dans une session comportant plusieurs dépôts, [le fichier d'un seul dépôt au plus est chargé](#repository-settings-in-sessions-with-several-repositories).641* `<repo>/.mcp.json` : portée projet. En dehors d'un fil de [projet](https://code.claude.com/docs/fr/claude-projects.md#what-threads-pick-up-from-your-repositories), faites un commit du fichier dans le dépôt ; ses serveurs sont approuvés automatiquement dans les sessions cloud. Dans une session comportant plusieurs dépôts, [le fichier d'un seul dépôt au plus est chargé](#repository-settings-in-sessions-with-several-repositories). Avec [`--trust-workspace false`](https://code.claude.com/docs/fr/self-hosted-environments-reference#runner-cli-flags), les sessions ignorent les serveurs de ce fichier, sauf si des paramètres que le dépôt ne commite pas les approuvent, comme [`enabledMcpjsonServers`](https://code.claude.com/docs/fr/settings-reference#enabledmcpjsonservers) dans le fichier `~/.claude/settings.json` de l'hôte. Nécessite Claude Code v2.1.319 ou une version ultérieure.

642* Un fichier [`--mcp-config`](https://code.claude.com/docs/fr/cli-reference#cli-flags) passé par votre script wrapper : ajoutez le flag après `"$@"`, comme dans `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`. Pour que les serveurs de ce fichier continuent de fonctionner lorsque les serveurs fournis à la session sont mis à jour en cours de session, faites en sorte que votre wrapper transmette l'[environnement complet](#wrapper-scripts) au processus enfant, comme le fait `exec`. Avant la v2.1.299, les serveurs stdio, HTTP et SSE de ce fichier s'arrêtaient à la première mise à jour de ce type qui ne les nommait pas.642* Un fichier [`--mcp-config`](https://code.claude.com/docs/fr/cli-reference#cli-flags) passé par votre script wrapper : ajoutez le flag après `"$@"`, comme dans `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`. Pour que les serveurs de ce fichier continuent de fonctionner lorsque les serveurs fournis à la session sont mis à jour en cours de session, faites en sorte que votre wrapper transmette l'[environnement complet](#wrapper-scripts) au processus enfant, comme le fait `exec`. Avant la v2.1.299, les serveurs stdio, HTTP et SSE de ce fichier s'arrêtaient à la première mise à jour de ce type qui ne les nommait pas.

643 643 

644Lorsque la fourniture des connecteurs est activée pour votre organisation, le plan de contrôle d'Anthropic fournit les connecteurs que vous avez configurés sur claude.ai aux sessions créées de manière interactive, via une configuration MCP fournie par le serveur et acheminée par `api.anthropic.com`. Les sessions créées par programmation, comme les [dispatches via la CLI](https://code.claude.com/docs/fr/self-hosted-environments-testing.md#run-the-test-loop), ne bénéficient pas de la fourniture des connecteurs ; fournissez-leur plutôt des serveurs MCP via l'une des autres sources listées dans cette section. Le jeton OAuth du processus enfant ne comporte pas de scope permettant de récupérer directement les connecteurs ; le processus enfant ne tente donc pas lui-même cette récupération : la fourniture est pilotée par le serveur.644Lorsque la fourniture des connecteurs est activée pour votre organisation, le plan de contrôle d'Anthropic fournit les connecteurs que vous avez configurés sur claude.ai aux sessions créées de manière interactive, via une configuration MCP fournie par le serveur et acheminée par `api.anthropic.com`. Les sessions créées par programmation, comme les [dispatches via la CLI](https://code.claude.com/docs/fr/self-hosted-environments-testing.md#run-the-test-loop), ne bénéficient pas de la fourniture des connecteurs ; fournissez-leur plutôt des serveurs MCP via l'une des autres sources listées dans cette section. Le jeton OAuth du processus enfant ne comporte pas de scope permettant de récupérer directement les connecteurs ; le processus enfant ne tente donc pas lui-même cette récupération : la fourniture est pilotée par le serveur.

916 916 

917Dans toute autre session avec plusieurs dépôts, Claude Code lit les paramètres du projet à partir du répertoire dans lequel la session démarre, donc le `.claude/settings.json` d'au plus un dépôt prend effet comme paramètres du projet. Un hook défini dans le fichier d'un autre dépôt ne s'exécute pas, une règle de refus qui s'y trouve ne s'applique pas, et son `env` n'est pas défini.917Dans toute autre session avec plusieurs dépôts, Claude Code lit les paramètres du projet à partir du répertoire dans lequel la session démarre, donc le `.claude/settings.json` d'au plus un dépôt prend effet comme paramètres du projet. Un hook défini dans le fichier d'un autre dépôt ne s'exécute pas, une règle de refus qui s'y trouve ne s'applique pas, et son `env` n'est pas défini.

918 918 

919* **`--capacity 1`, la valeur par défaut, avec le checkout intégré** : la session démarre dans le premier dépôt de sa liste de dépôts. Le `.claude/settings.json` de ce dépôt prend effet comme paramètres du projet et son `.mcp.json` se charge, contrairement à ceux des autres dépôts.919* **`--capacity 1`, la valeur par défaut, avec le checkout intégré** : la session démarre dans le premier dépôt de sa liste de dépôts. Le `.claude/settings.json` de ce dépôt prend effet comme paramètres du projet et son [`.mcp.json`](#mcp-servers) se charge, contrairement à ceux des autres dépôts.

920* **Un `--capacity` supérieur à un, ou un [hook `checkout`](#checkout)** : la session démarre dans un répertoire propre à la session qui contient les checkouts. Aucun `.claude/settings.json` de dépôt ne prend effet comme paramètres du projet, aucun `.mcp.json` de dépôt ne se charge, et [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/fr/hooks#reference-scripts-by-path) dans une commande de hook correspond à ce répertoire, et non à un checkout.920* **Un `--capacity` supérieur à un, ou un [hook `checkout`](#checkout)** : la session démarre dans un répertoire propre à la session qui contient les checkouts. Aucun `.claude/settings.json` de dépôt ne prend effet comme paramètres du projet, aucun `.mcp.json` de dépôt ne se charge, et [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/fr/hooks#reference-scripts-by-path) dans une commande de hook correspond à ce répertoire, et non à un checkout.

921 921 

922Le `CLAUDE.md` de chaque dépôt se charge quel que soit l'endroit où la session démarre. En dehors d'un fil de projet, ses skills se chargent aussi. Le runner transmet chaque dépôt à Claude Code comme [répertoire supplémentaire](https://code.claude.com/docs/fr/permissions.md#additional-directories-grant-file-access-not-configuration), donc Claude Code lit aussi les clés `enabledPlugins` et `extraKnownMarketplaces` du `.claude/settings.json` de chaque dépôt.922Le `CLAUDE.md` de chaque dépôt se charge quel que soit l'endroit où la session démarre. En dehors d'un fil de projet, ses skills se chargent aussi. Le runner transmet chaque dépôt à Claude Code comme [répertoire supplémentaire](https://code.claude.com/docs/fr/permissions.md#additional-directories-grant-file-access-not-configuration), donc Claude Code lit aussi les clés `enabledPlugins` et `extraKnownMarketplaces` du `.claude/settings.json` de chaque dépôt.

916* **Le runner journalise des lignes `Poll failed` contenant `rejecting the malformed poll response`** : le runner a reçu une réponse d'interrogation de travail dont le corps n'est pas le JSON attendu de la file d'attente. L'une des causes possibles est un proxy d'interception ou un portail captif qui répond avec sa propre page. Si le runner se connecte via un proxy, configurez le proxy pour qu'il transmette sans modification les réponses de `api.anthropic.com`.916* **Le runner journalise des lignes `Poll failed` contenant `rejecting the malformed poll response`** : le runner a reçu une réponse d'interrogation de travail dont le corps n'est pas le JSON attendu de la file d'attente. L'une des causes possibles est un proxy d'interception ou un portail captif qui répond avec sa propre page. Si le runner se connecte via un proxy, configurez le proxy pour qu'il transmette sans modification les réponses de `api.anthropic.com`.

917 917 

918 Le runner rejette la réponse malformée, la comptabilise sous le type `transport` de la [métrique](https://code.claude.com/docs/fr/self-hosted-environments-reference.md#prometheus-metrics) `claude_code_self_hosted_runner_poll_errors_total` et réessaie selon le calendrier des interrogations échouées décrit dans [Cycle de vie des sessions](https://code.claude.com/docs/fr/self-hosted-environments#session-lifecycle). Le runner continue de servir ses sessions actives. Avant la v2.1.246, le runner interprétait une telle réponse comme une file de travail vide, ce qui pouvait mettre fin à ses sessions actives ou provoquer son arrêt.918 Le runner rejette la réponse malformée, la comptabilise sous le type `transport` de la [métrique](https://code.claude.com/docs/fr/self-hosted-environments-reference.md#prometheus-metrics) `claude_code_self_hosted_runner_poll_errors_total` et réessaie selon le calendrier des interrogations échouées décrit dans [Cycle de vie des sessions](https://code.claude.com/docs/fr/self-hosted-environments#session-lifecycle). Le runner continue de servir ses sessions actives. Avant la v2.1.246, le runner interprétait une telle réponse comme une file de travail vide, ce qui pouvait mettre fin à ses sessions actives ou provoquer son arrêt.

919* **Une session échoue avec `no longer exists on the remote` ou `couldn't find remote ref`** : le runner interprète le message `couldn't find remote ref` de git comme une branche supprimée. La branche peut pourtant toujours exister. Cherchez-la sur votre hôte git, sous le nom exact figurant dans le message, puis vérifiez chaque cause qui correspond :919* **Une session échoue avec `couldn't be found in the remote repository` ou `couldn't find remote ref`** : cherchez la branche sur votre hôte git. Recherchez exactement le nom figurant dans le message.

920 920 

921 * **La branche a disparu** : restaurez-la, comme le demande le message.921 L'erreur de la session contient `Retrying will fail the same way until you fix the missing branch described below.` Lorsque l'erreur nomme la branche, le texte sous `Last output before exit:` est le suivant :

922 

923 ```text theme={null}

924 The branch '<ref>' couldn't be found in the remote repository <repo>. If it was never pushed, push it. If it was deleted after a merge, restore it from its pull request. Then send a new message, or start a new session from a branch that has been pushed. (couldn't find remote ref)

925 ```

926 

927 * **La branche ne se trouve pas sur l'hôte** : poussez-la si elle n'a jamais été poussée, ou restaurez-la depuis sa pull request si elle a été supprimée après une fusion.

922 * **La branche existe et vous n'administrez pas le runner** : envoyez le message complet à l'administrateur du runner et indiquez-lui que la branche existe.928 * **La branche existe et vous n'administrez pas le runner** : envoyez le message complet à l'administrateur du runner et indiquez-lui que la branche existe.

923 * **La branche existe et le runner dispose d'un hook `checkout`** : une commande git de votre hook peut afficher `couldn't find remote ref` sur stderr avant que le hook ne se termine avec un code non nul. Trouvez cette commande, et corrigez la ref qu'elle demande ou le dépôt distant depuis lequel elle effectue le fetch. Le runner transmet à votre hook la révision demandée par la session via [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/fr/self-hosted-environments-configuration#checkout).929 * **La branche existe et le runner dispose d'un hook `checkout`** : une commande git de votre hook peut afficher `couldn't find remote ref` sur stderr avant que le hook ne se termine avec un code non nul. Trouvez cette commande, et corrigez la ref qu'elle demande ou le dépôt distant depuis lequel elle effectue le fetch. Le runner transmet à votre hook la révision demandée par la session via [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/fr/self-hosted-environments-configuration#checkout).

924 * **La branche existe et le runner n'a pas de hook `checkout`** : le runner récupère lui-même la branche. Si un [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks) s'applique au dépôt, vérifiez que l'hôte vers lequel il réécrit possède la branche sous le même nom, et poussez-y la branche si ce n'est pas le cas.930 * **La branche existe et le runner n'a pas de hook `checkout`** : le runner récupère lui-même la branche. Si un [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks) s'applique au dépôt, vérifiez que l'hôte vers lequel il réécrit possède la branche sous le même nom, et poussez-y la branche si ce n'est pas le cas.

925 * **La branche existe et le runner est antérieur à la v2.1.301** : mettez à niveau le runner comme décrit dans [Épingler la version](#pin-the-version), afin qu'un autre échec affiche sa propre erreur. Avant la v2.1.301, d'autres échecs dont la sortie d'erreur contenait `couldn't find remote ref` étaient également signalés comme une branche supprimée.931 * **La branche existe et le runner est antérieur à la v2.1.301** : mettez à niveau le runner comme décrit dans [Épingler la version](#pin-the-version), afin qu'un autre échec affiche sa propre erreur. Avant la v2.1.301, d'autres échecs dont la sortie d'erreur contenait `couldn't find remote ref` étaient également signalés comme une branche supprimée.

926 932 

927 Une fois le runner mis à niveau ou la cause corrigée, réessayez la session ou démarrez-en une nouvelle. Si aucune de ces vérifications ne révèle la cause, [signalez un problème](#report-an-issue).933 Une fois le runner mis à niveau ou la cause corrigée, envoyez un nouveau message à la session, ou démarrez une nouvelle session à partir d'une branche qui a été poussée. Si aucune de ces vérifications ne révèle la cause, [signalez un problème](#report-an-issue). Avant la v2.1.314, le message indiquait que la branche `no longer exists on the remote`. Suivez les mêmes vérifications pour ce message.

928 934 

929 Pour la source vers laquelle la session pousse ses résultats, une branche supprimée fait échouer la session. Pour une source git que la session ne fait que lire, le runner ignore cette source et continue avec les autres. Le runner fait échouer la session lorsque l'ignorer la laisserait sans aucun dépôt. Avant la v2.1.228, une telle session démarrait dans un répertoire vide.935 Pour la source vers laquelle la session pousse ses résultats, une branche supprimée fait échouer la session. Pour une source git que la session ne fait que lire, le runner ignore cette source et continue avec les autres. Le runner fait échouer la session lorsque l'ignorer la laisserait sans aucun dépôt. Avant la v2.1.228, une telle session démarrait dans un répertoire vide.

930* **Claude Tag ne publie parfois pas sa réponse dans Slack** : le rappel de réponse est un [hook fourni par le plan de contrôle](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled). Vérifiez avec `claude --version` que le runner exécute Claude Code v2.1.229 ou ultérieure, car les runners plus anciens ignorent les hooks fournis ; vérifiez que `python3 --version` réussit dans l'image du runner, car les hooks exécutent `python3` ; et vérifiez qu'aucun fichier de paramètres ne désactive les hooks, qu'il s'agisse de `disableAllHooks` dans `managed-settings.json`, dans le `~/.claude/settings.json` de l'utilisateur du runner, ou dans le `.claude/settings.json` ou le `.claude/settings.local.json` du dépôt, ou encore de `allowManagedHooksOnly` ou d'un [`strictPluginOnlyCustomization`](https://code.claude.com/docs/fr/settings-reference#strictpluginonlycustomization) couvrant les hooks dans les paramètres gérés.936* **Claude Tag ne publie parfois pas sa réponse dans Slack** : le rappel de réponse est un [hook fourni par le plan de contrôle](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled). Vérifiez avec `claude --version` que le runner exécute Claude Code v2.1.229 ou ultérieure, car les runners plus anciens ignorent les hooks fournis ; vérifiez que `python3 --version` réussit dans l'image du runner, car les hooks exécutent `python3` ; et vérifiez qu'aucun fichier de paramètres ne désactive les hooks, qu'il s'agisse de `disableAllHooks` dans `managed-settings.json`, dans le `~/.claude/settings.json` de l'utilisateur du runner, ou dans le `.claude/settings.json` ou le `.claude/settings.local.json` du dépôt, ou encore de `allowManagedHooksOnly` ou d'un [`strictPluginOnlyCustomization`](https://code.claude.com/docs/fr/settings-reference#strictpluginonlycustomization) couvrant les hooks dans les paramètres gérés.

125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | Combien de temps le runner attend après qu'une session atteigne sa limite `--kill-session-after-min`, pour qu'un tour en cours se termine ou que la libération se termine, avant de terminer la session |125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | Combien de temps le runner attend après qu'une session atteigne sa limite `--kill-session-after-min`, pour qu'un tour en cours se termine ou que la libération se termine, avant de terminer la session |

126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | Limite supérieure du temps pendant lequel le runner compte une session comme occupée pour le drainage `--drain-wait-sec` après la fin d'un tour, tandis que le processus de la session signale la fin du tour à Anthropic. `0` ou une valeur inutilisable revient à la valeur par défaut, donc la retenue ne peut pas être désactivée. Nécessite Claude Code v2.1.275 ou ultérieur. |126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | Limite supérieure du temps pendant lequel le runner compte une session comme occupée pour le drainage `--drain-wait-sec` après la fin d'un tour, tandis que le processus de la session signale la fin du tour à Anthropic. `0` ou une valeur inutilisable revient à la valeur par défaut, donc la retenue ne peut pas être désactivée. Nécessite Claude Code v2.1.275 ou ultérieur. |

127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | Combien de temps le runner attend que le système d'exploitation livre `SIGKILL` à un enfant bloqué dans les E/S non interruptibles avant de se terminer lui-même. Plancher à `--post-session-hook-timeout-sec` plus 15 secondes, et 30 de plus quand `--push-outcome-on-release` est défini, donc le minimum effectif est 75 secondes aux valeurs par défaut. |127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | Combien de temps le runner attend que le système d'exploitation livre `SIGKILL` à un enfant bloqué dans les E/S non interruptibles avant de se terminer lui-même. Plancher à `--post-session-hook-timeout-sec` plus 15 secondes, et 30 de plus quand `--push-outcome-on-release` est défini, donc le minimum effectif est 75 secondes aux valeurs par défaut. |

128| `CLAUDE_RUNNER_DISABLE_RENEWAL_WARNING` | non défini | Quand `1`, le runner ne publie pas `The server has refused to renew this session's access to the model` dans une session. Après chaque refus, il attend le prochain renouvellement planifié pour redemander. Nécessite Claude Code v2.1.319 ou ultérieur. |

128| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | Profondeur de récupération git pour les clones frais. Définir un entier positif, ou `full` ou `0` pour une récupération complète. Pour un clone déjà présent dans l'espace de travail, consultez [Réutiliser un checkout préchauffé](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout). |129| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | Profondeur de récupération git pour les clones frais. Définir un entier positif, ou `full` ou `0` pour une récupération complète. Pour un clone déjà présent dans l'espace de travail, consultez [Réutiliser un checkout préchauffé](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout). |

129| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | Durée en millisecondes, par tentative, pendant laquelle une récupération git peut attendre ses premières données tant que les indicateurs de progression du serveur git lui-même continuent d'augmenter, par exemple lorsque le serveur prépare le pack d'un dépôt volumineux. `0` ou `off` désactive cette attente : une telle récupération est alors interrompue après deux minutes sans données. Tout autre nombre entier est borné entre `120000` et `1800000`, soit 2 à 30 minutes. Nécessite Claude Code v2.1.295 ou ultérieur. |130| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | Durée en millisecondes, par tentative, pendant laquelle une récupération git peut attendre ses premières données tant que les indicateurs de progression du serveur git lui-même continuent d'augmenter, par exemple lorsque le serveur prépare le pack d'un dépôt volumineux. `0` ou `off` désactive cette attente : une telle récupération est alors interrompue après deux minutes sans données. Tout autre nombre entier est borné entre `120000` et `1800000`, soit 2 à 30 minutes. Nécessite Claude Code v2.1.295 ou ultérieur. |

130| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | non défini | Quand `1`, ignorer la vérification de présence `.git` après l'exécution d'un hook `checkout`. Définir ceci quand votre hook matérialise une source non-git. |131| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | non défini | Quand `1`, ignorer la vérification de présence `.git` après l'exécution d'un hook `checkout`. Définir ceci quand votre hook matérialise une source non-git. |

135 136 

136Les enfants de session envoient la télémétrie opérationnelle à Anthropic sauf si vous la désactivez. Aucun code ou contenu de dépôt n'est envoyé. Définir les variables de télémétrie sur le processus du runner ; le runner les réaffirme après l'application des variables d'environnement fournies par le serveur, donc le paramètre de l'opérateur a toujours la priorité.137Les enfants de session envoient la télémétrie opérationnelle à Anthropic sauf si vous la désactivez. Aucun code ou contenu de dépôt n'est envoyé. Définir les variables de télémétrie sur le processus du runner ; le runner les réaffirme après l'application des variables d'environnement fournies par le serveur, donc le paramètre de l'opérateur a toujours la priorité.

137 138 

138Un contrôle est spécifique aux environnements auto-hébergés : `CLAUDE_CODE_BYOC_ENABLE_DATADOG=1` opte pour les métriques opérationnelles Datadog, qui sont désactivées par défaut dans les environnements auto-hébergés. Les contrôles de télémétrie Claude Code généraux, `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_ERROR_REPORTING` et `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, s'appliquent aux enfants de session comme documenté dans la [référence des variables d'environnement](https://code.claude.com/docs/fr/env-vars.md). `DISABLE_GROWTHBOOK` est connexe mais différent : définir `DISABLE_GROWTHBOOK=1` désactive la récupération des drapeaux de fonctionnalité, et la télémétrie reste activée sauf si `DISABLE_TELEMETRY` est également défini.139Un contrôle est spécifique aux environnements auto-hébergés : `CLAUDE_CODE_BYOC_ENABLE_DATADOG=1` opte pour les métriques opérationnelles Datadog, qui sont désactivées par défaut dans les environnements auto-hébergés. Les contrôles de télémétrie Claude Code généraux, `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_ERROR_REPORTING` et `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, s'appliquent aux enfants de session comme documenté dans la [référence des variables d'environnement](https://code.claude.com/docs/fr/env-vars.md). [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/fr/env-vars#variables) est connexe mais différent : définir `CLAUDE_CODE_DISABLE_FEATURE_FLAGS=1` désactive la récupération des drapeaux de fonctionnalité, et la télémétrie reste activée sauf si `DISABLE_TELEMETRY` est également défini. `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` nécessite Claude Code v2.1.319 ou une version ultérieure.

139 140 

140`CLAUDE_CODE_ENABLE_TELEMETRY` n'est pas connexe : il active l'export OpenTelemetry vers votre propre collecteur, comme décrit dans [Surveillance](https://code.claude.com/docs/fr/monitoring-usage.md), et ne contrôle pas l'analytique d'Anthropic.141`CLAUDE_CODE_ENABLE_TELEMETRY` n'est pas connexe : il active l'export OpenTelemetry vers votre propre collecteur, comme décrit dans [Surveillance](https://code.claude.com/docs/fr/monitoring-usage.md), et ne contrôle pas l'analytique d'Anthropic.

141 142 

108 108 

109Dans une session en cours, `/status` affiche la même ligne après une récupération échouée, et pour certaines causes de récupération ignorée, comme une variable de fournisseur tiers ou une `ANTHROPIC_BASE_URL` personnalisée exportée dans le shell de l'utilisateur.109Dans une session en cours, `/status` affiche la même ligne après une récupération échouée, et pour certaines causes de récupération ignorée, comme une variable de fournisseur tiers ou une `ANTHROPIC_BASE_URL` personnalisée exportée dans le shell de l'utilisateur.

110 110 

111### Attribuer des paramètres différents aux groupes

112 

113Avec un forfait Enterprise, vous pouvez attribuer à chaque groupe de membres sa propre configuration au lieu d'une configuration unique pour toute l'organisation. Si [HIPAA est activé](https://code.claude.com/docs/fr/hipaa-setup.md) pour votre organisation, les configurations par groupe ne sont pas encore disponibles. Chaque groupe doit déjà exister, soit synchronisé depuis votre fournisseur d'identité via SCIM, soit en tant que groupe personnalisé que vous gérez dans la console d'administration.

114 

115Chaque membre reçoit au plus une configuration, identique sur tous ses appareils :

116 

117* **Un membre d'un groupe doté d'une configuration** : la configuration la mieux classée parmi ses groupes

118* **Toute autre personne**, y compris un membre dont le seul groupe doté d'une configuration a été supprimé : la configuration par défaut, si vous en définissez une

119 

120Les configurations ne fusionnent ni entre elles ni avec la configuration de l'organisation, chacune doit donc contenir tous les paramètres que vous souhaitez attribuer à ce groupe. Pour appliquer une restriction à tous les membres, placez-la dans chaque configuration de groupe et dans la configuration par défaut.

121 

122Les membres continuent de recevoir la configuration de l'organisation jusqu'à la dernière de ces étapes, ce qui vous permet de tout configurer et tester au préalable :

123 

124**1. Ajouter une configuration pour chaque groupe**

125 

126Dans [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code), cliquez sur **Add configuration**, sélectionnez le groupe et choisissez un point de départ. Pour assouplir la politique d'un groupe, choisissez un groupe synchronisé par votre fournisseur d'identité, afin que personne ne puisse s'y ajouter dans la console d'administration.

127 

128Pour conserver ce dont les membres disposent aujourd'hui et modifier quelques paramètres, partez d'une copie de la configuration de votre organisation. Modifiez la configuration et enregistrez-la.

129 

130**2. Définir la configuration par défaut**

131 

132Cliquez sur **Set** dans **Everyone else** et ajoutez le JSON destiné aux membres qui ne correspondent à aucune configuration de groupe. Pour leur laisser ce dont ils disposent aujourd'hui, collez la configuration de votre organisation. Si vous ignorez cette étape, leurs sessions locales ne reçoivent aucun paramètre géré par le serveur, et les [paramètres gérés sur le poste](https://code.claude.com/docs/fr/managed-settings.md#delivery-mechanisms) éventuellement présents sur l'appareil s'appliquent toujours.

133 

134**3. Classer les groupes**

135 

136Faites glisser les configurations pour les ordonner. Un membre de plusieurs groupes reçoit uniquement la configuration la mieux classée ; placez donc vos groupes les plus restrictifs ou les plus spécifiques en haut.

137 

138**4. Vérifier qui reçoit quoi**

139 

140Sous **Check effective settings** en bas de la page, recherchez un membre pour voir quelle configuration il recevrait. Vérifiez un membre de chaque groupe, un membre de plusieurs groupes et un membre qui ne correspond à aucune configuration de groupe.

141 

142**5. Passer au mode par groupe**

143 

144Cliquez sur **Switch to group-based configurations** dans la bannière en haut de la page et confirmez. Les membres reçoivent leurs configurations dans l'heure environ, à l'exception des [clés qui ne s'appliquent qu'au prochain lancement](#fetch-and-caching-behavior). Pour revenir en arrière, repassez au mode à l'échelle de l'organisation depuis la même bannière : la configuration de l'organisation s'applique de nouveau, si vous en avez une, et vos configurations de groupe sont conservées.

145 

146Les limites de modèles d'un groupe ne s'appliquent que dans les sessions locales. Les sessions cloud et les sessions Cowork distantes utilisent la liste [`availableModels`](https://code.claude.com/docs/fr/model-config#restrict-model-selection) de la configuration par défaut. Si vous ne définissez pas de configuration par défaut, elle provient de la configuration de votre organisation, même après le passage au mode par groupe. Si vous omettez cette clé dans la configuration par défaut, les membres ne sont pas limités par cette liste dans ces sessions.

147 

148Si vous utilisez la configuration d'un groupe pour définir la destination des requêtes API, cela ne s'applique qu'à Claude Code, et non aux autres outils qui appellent l'API.

149 

111### Contrôle d'accès150### Contrôle d'accès

112 151 

113Les rôles suivants peuvent gérer les paramètres gérés par le serveur :152Les rôles suivants peuvent gérer les paramètres gérés par le serveur :

115* **Propriétaire principal**154* **Propriétaire principal**

116* **Propriétaire**155* **Propriétaire**

117 156 

118Limitez l'accès au personnel de confiance, car les modifications de paramètres s'appliquent à tous les utilisateurs de l'organisation.157Limitez l'accès au personnel de confiance, car les modifications de paramètres peuvent s'appliquer à tous les utilisateurs de l'organisation.

119 158 

120### Paramètres réservés à la gestion159### Paramètres réservés à la gestion

121 160 

125 164 

126Les paramètres gérés par le serveur ont les limitations suivantes :165Les paramètres gérés par le serveur ont les limitations suivantes :

127 166 

128* Les paramètres s'appliquent uniformément à tous les utilisateurs de l'organisation. Les configurations par groupe ne sont pas encore prises en charge.167* Avec un forfait Team, les paramètres s'appliquent uniformément à tous les utilisateurs de l'organisation. Les [configurations par groupe](#give-groups-different-settings) nécessitent un forfait Enterprise.

129* Un fichier [`managed-mcp.json`](https://code.claude.com/docs/fr/managed-mcp) ne peut pas être distribué via les paramètres gérés par le serveur. Livrez plutôt les clés de politique `allowedMcpServers` et `deniedMcpServers` à la place. Dans Claude Code v2.1.259 ou version ultérieure, vous pouvez également fournir des serveurs distants avec [`managedMcpServers`](https://code.claude.com/docs/fr/managed-mcp#provide-servers-through-managed-settings), qui accepte uniquement les serveurs `http` et `sse` et ne prend pas le contrôle exclusif de la même manière que le fichier.168* Un fichier [`managed-mcp.json`](https://code.claude.com/docs/fr/managed-mcp) ne peut pas être distribué via les paramètres gérés par le serveur. Livrez plutôt les clés de politique `allowedMcpServers` et `deniedMcpServers` à la place. Dans Claude Code v2.1.259 ou version ultérieure, vous pouvez également fournir des serveurs distants avec [`managedMcpServers`](https://code.claude.com/docs/fr/managed-mcp#provide-servers-through-managed-settings), qui accepte uniquement les serveurs `http` et `sse` et ne prend pas le contrôle exclusif de la même manière que le fichier.

130 169 

131 Claude Code lit un fichier `managed-mcp.json` déployé à son [chemin système](https://code.claude.com/docs/fr/managed-mcp.md#exclusive-control-with-managed-mcp-json) séparément du niveau des paramètres gérés, donc le fichier s'applique toujours lorsque les paramètres gérés par le serveur sont en vigueur.170 Claude Code lit un fichier `managed-mcp.json` déployé à son [chemin système](https://code.claude.com/docs/fr/managed-mcp.md#exclusive-control-with-managed-mcp-json) séparément du niveau des paramètres gérés, donc le fichier s'applique toujours lorsque les paramètres gérés par le serveur sont en vigueur.

245* `cleanupPeriodDays` raccourcit la rétention des transcriptions de session et autres données locales à sept jours245* `cleanupPeriodDays` raccourcit la rétention des transcriptions de session et autres données locales à sept jours

246* `companyAnnouncements` affiche un message au démarrage246* `companyAnnouncements` affiche un message au démarrage

247 247 

248Les administrateurs déploient un fichier comme celui-ci en tant que `managed-settings.json`, ou le même JSON via MDM ou [paramètres gérés par serveur](https://code.claude.com/docs/fr/server-managed-settings.md). Un fichier déployé s'applique à chaque machine ou compte qu'il atteint. Pour donner à un groupe des valeurs différentes, déployez un fichier ou un profil différent à ce groupe, car [les paramètres gérés par serveur ne supportent pas encore la politique par groupe](https://code.claude.com/docs/fr/server-managed-settings.md#current-limitations).248Les administrateurs déploient un fichier comme celui-ci en tant que `managed-settings.json`, ou le même JSON via MDM ou [paramètres gérés par serveur](https://code.claude.com/docs/fr/server-managed-settings.md). Un fichier déployé s'applique à chaque machine ou compte qu'il atteint. Pour donner à un groupe des valeurs différentes, déployez un fichier ou un profil différent à ce groupe. Avec un forfait Enterprise, vous pouvez plutôt [donner au groupe sa propre configuration](https://code.claude.com/docs/fr/server-managed-settings.md#give-groups-different-settings) dans les paramètres gérés par serveur.

249 249 

250> [tab] Fichier de paramètres copiable250> [tab] Fichier de paramètres copiable

251>251>

91| `managed-agents-secure [<agent-id>]` | Lisez les paramètres d'un Agent géré et indiquez en quoi ils sont conformes au guide [Sécuriser votre déploiement d'Agents gérés](https://platform.claude.com/docs/en/managed-agents/secure-deployment) ou s'en écartent. Nécessite la [CLI `ant`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart) | v2.1.304 ou version ultérieure |91| `managed-agents-secure [<agent-id>]` | Lisez les paramètres d'un Agent géré et indiquez en quoi ils sont conformes au guide [Sécuriser votre déploiement d'Agents gérés](https://platform.claude.com/docs/en/managed-agents/secure-deployment) ou s'en écartent. Nécessite la [CLI `ant`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart) | v2.1.304 ou version ultérieure |

92| `prompt-audit` | Signalez les instructions écrites pour les modèles plus anciens dans vos invites, compétences et descriptions d'outils et proposez des corrections sous forme de diff | v2.1.221 ou version ultérieure |92| `prompt-audit` | Signalez les instructions écrites pour les modèles plus anciens dans vos invites, compétences et descriptions d'outils et proposez des corrections sous forme de diff | v2.1.221 ou version ultérieure |

93| `cost-optimize` | Profilez où va la dépense Claude API de votre projet et proposez des économies à partir d'options telles que la mise en cache des invites, la réduction des tokens d'entrée et de sortie inutiles, le traitement par lots, l'effort et le choix du modèle, une modification à la fois | v2.1.247 ou version ultérieure |93| `cost-optimize` | Profilez où va la dépense Claude API de votre projet et proposez des économies à partir d'options telles que la mise en cache des invites, la réduction des tokens d'entrée et de sortie inutiles, le traitement par lots, l'effort et le choix du modèle, une modification à la fois | v2.1.247 ou version ultérieure |

94| `latency-optimize` | Identifiez où passe le temps dans votre code Claude API existant et proposez des modifications qui réduisent le temps d'attente des utilisateurs | v2.1.319 ou version ultérieure |

94| `build-eval` | Construisez un ensemble d'évaluation pour votre application alimentée par Claude | v2.1.259 ou version ultérieure |95| `build-eval` | Construisez un ensemble d'évaluation pour votre application alimentée par Claude | v2.1.259 ou version ultérieure |

95| `hillclimb` | Améliorez itérativement votre application par rapport à une évaluation existante | v2.1.259 ou version ultérieure |96| `hillclimb` | Améliorez itérativement votre application par rapport à une évaluation existante | v2.1.259 ou version ultérieure |

96| `preserved-thinking-migration` | Trouvez les modifications que votre intégration apporte aux tours antérieurs, à son invite système ou à sa liste d'outils qui invalident les blocs de [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking), mesurez combien de raisonnement chacun supprime et proposez des corrections une à la fois, en remessurant après chaque modification | v2.1.282 ou version ultérieure |97| `preserved-thinking-migration` | Trouvez les modifications que votre intégration apporte aux tours antérieurs, à son invite système ou à sa liste d'outils qui invalident les blocs de [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking), mesurez combien de raisonnement chacun supprime et proposez des corrections une à la fois, en remessurant après chaque modification | v2.1.282 ou version ultérieure |

197La limite de temps est comptée à partir du moment où la commande entre en arrière-plan :197La limite de temps est comptée à partir du moment où la commande entre en arrière-plan :

198 198 

199* Une commande que Claude démarre en arrière-plan obtient 30 minutes, ou le `timeout` que Claude transmet avec `run_in_background`, jusqu'à un maximum de 2 heures199* Une commande que Claude démarre en arrière-plan obtient 30 minutes, ou le `timeout` que Claude transmet avec `run_in_background`, jusqu'à un maximum de 2 heures

200* Une commande qui démarre au premier plan puis passe en arrière-plan, par exemple à son délai d'expiration, obtient 30 minutes à partir du passage200* Une commande qui démarre au premier plan puis passe en arrière-plan à son délai d'expiration obtient 30 minutes à partir du passage

201 201 

202Dans une exécution avec le flag `-p` dont vous transmettez le prompt sous forme de texte plutôt qu'avec `--input-format stream-json`, les deux valeurs par défaut sont de 10 minutes au lieu de 30, car l'exécution [attend les commandes en arrière-plan après son résultat](https://code.claude.com/docs/fr/headless.md#background-tasks-at-exit).202Dans une exécution avec le flag `-p` dont vous transmettez le prompt sous forme de texte plutôt qu'avec `--input-format stream-json`, les deux valeurs par défaut sont de 10 minutes au lieu de 30, car l'exécution [attend les commandes en arrière-plan après son résultat](https://code.claude.com/docs/fr/headless.md#background-tasks-at-exit).

203 203 

399 399 

400Si le rechargement a interrompu Claude au milieu d'une étape, Claude poursuit cette étape lorsque la conversation revient, et une notification dans le chat signale cette reprise. Nécessite Claude Code v2.1.274 ou une version ultérieure. Si l'étape a été interrompue il y a plus d'une heure ou si la session est ouverte ailleurs, la conversation revient plutôt à l'état inactif.400Si le rechargement a interrompu Claude au milieu d'une étape, Claude poursuit cette étape lorsque la conversation revient, et une notification dans le chat signale cette reprise. Nécessite Claude Code v2.1.274 ou une version ultérieure. Si l'étape a été interrompue il y a plus d'une heure ou si la session est ouverte ailleurs, la conversation revient plutôt à l'état inactif.

401 401 

402Lorsqu'une notification dans le chat contient `plan mode is now off, so Claude did not continue on its own`, l'étape a été interrompue en mode plan. Pour continuer à planifier, sélectionnez **Plan** dans l'indicateur de mode avant d'envoyer votre prochain message.

403 

402#### Désactiver la reprise après un rechargement404#### Désactiver la reprise après un rechargement

403 405 

404Pour empêcher Claude de poursuivre une étape interrompue après un rechargement, ouvrez le [paramètre Continue After Reload](vscode://settings/claudeCode.continueAfterReload) et décochez-le.406Pour empêcher Claude de poursuivre une étape interrompue après un rechargement, ouvrez le [paramètre Continue After Reload](vscode://settings/claudeCode.continueAfterReload) et décochez-le.